stove/rougail-output-json
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

feat: add doc

Browse source
This commit is contained in:
egarette@silique.fr 2025-12-23 21:38:51 +01:00
parent 33835d0947
commit 62268cb09c
6 changed files with 75 additions and 24 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
README.fr.md Normal file
View file

@ -0,0 +1,20 @@
---
gitea: none
include_toc: true
---
[🇬🇧 (EN)](README.md) - [🇫🇷 (FR)](README.fr.md)
## Configuration de rougail-json
> [!NOTE]
>
> **Chemin** : json\
> *`désactivé`*\
> **Désactivé** : si json n'est pas présent dans "[Sélection pour sortie](#step.output)"
| Variable | Description | Valeur par défaut | Type |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------|-------------------------------|---------------------------------------------------------------------------------------------------|
| **<a id="json.mandatory" name="json.mandatory">json.mandatory</a>**<br/>**Ligne de commande** : <br/>•&nbsp;--json.mandatory<br/>•&nbsp;--json.no-mandatory<br/>**Variable d'environnement** : JSON.MANDATORY | Tester les variables obligatoires avant de l&#x27;afficher en json. | si "cli.read_write" est false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `obligatoire` |
| **<a id="json.get" name="json.get">json.get</a>**<br/>**Ligne de commande** : --json.get<br/>**Variable d'environnement** : JSON.GET | Récupère la valeur pour une variable ou une famille. | | [`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) |

20
README.md
View file

@ -1,2 +1,20 @@
# rougail-output-json ---
gitea: none
include_toc: true
---
[🇬🇧 (EN)](README.md) - [🇫🇷 (FR)](README.fr.md)
## Configuration rougail-json
> [!NOTE]
>
> **Path**: json\
> *`disabled`*\
> **Disabled**: if json is not set in "[Select for output](#step.output)"
| Variable | Description | Default value | Type |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------|------------------------------|-------------------------------------------------------------------------------------------------|
| **<a id="json.mandatory" name="json.mandatory">json.mandatory</a>**<br/>**Command line**: <br/>•&nbsp;--json.mandatory<br/>•&nbsp;--json.no-mandatory<br/>**Environment variable**: JSON.MANDATORY | Test mandatories variables before display in json. | if "cli.read_write" is false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` |
| **<a id="json.get" name="json.get">json.get</a>**<br/>**Command line**: --json.get<br/>**Environment variable**: JSON.GET | Get value for a variable or a family. | | [`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) |

24
locale/fr/LC_MESSAGES/rougail_output_json.po
View file

@ -5,8 +5,8 @@
msgid "" msgid ""
msgstr "" msgstr ""
"Project-Id-Version: \n" "Project-Id-Version: \n"
"POT-Creation-Date: 2025-10-05 21:25+0200\n" "POT-Creation-Date: 2025-12-23 21:36+0100\n"
"PO-Revision-Date: 2025-10-05 21:26+0200\n" "PO-Revision-Date: 2025-12-23 21:37+0100\n"
"Last-Translator: \n" "Last-Translator: \n"
"Language-Team: \n" "Language-Team: \n"
"Language: fr\n" "Language: fr\n"
@ -14,21 +14,21 @@ msgstr ""
"Content-Type: text/plain; charset=UTF-8\n" "Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n" "Content-Transfer-Encoding: 8bit\n"
"Generated-By: pygettext.py 1.5\n" "Generated-By: pygettext.py 1.5\n"
"X-Generator: Poedit 3.7\n" "X-Generator: Poedit 3.8\n"
#: src/rougail/output_json/__init__.py:48 #: src/rougail/output_json/__init__.py:50
msgid "the \"step.output\" is not set to \"{0}\"" msgid "the \"step.output\" is not set to \"{0}\""
msgstr "\"step.output\" n'est pas mis à \"{0}\"" msgstr "\"step.output\" n'est pas mis à \"{0}\""
#: src/rougail/output_json/__init__.py:105 #: src/rougail/output_json/__init__.py:111
msgid "Error in config: {0}" msgid "Error in config: {0}"
msgstr "Erreur dans la configuration : {0}" msgstr "Erreur dans la configuration : {0}"
#: src/rougail/output_json/__init__.py:115 #: src/rougail/output_json/__init__.py:121
msgid "The following variables are mandatory but have no value:" msgid "The following variables are mandatory but have no value:"
msgstr "Les variables suivantes sont obligatoire mais n'ont pas de valeur :" msgstr "Les variables suivantes sont obligatoire mais n'ont pas de valeur :"
#: src/rougail/output_json/__init__.py:125 #: src/rougail/output_json/__init__.py:131
msgid "The following variables are inaccessible but are empty and mandatory :" msgid "The following variables are inaccessible but are empty and mandatory :"
msgstr "Les variables suivantes sont inaccessibles mais sont vides et obligatoires :" msgstr "Les variables suivantes sont inaccessibles mais sont vides et obligatoires :"
@ -36,11 +36,19 @@ msgstr "Les variables suivantes sont inaccessibles mais sont vides et obligatoir
msgid "configuration rougail-json" msgid "configuration rougail-json"
msgstr "configuration de rougail-json" msgstr "configuration de rougail-json"
#: src/rougail/output_json/config.py:34
msgid "if json is not set in \"step.output\""
msgstr "si json n'est pas présent dans \"step.output\""
#: src/rougail/output_json/config.py:37 #: src/rougail/output_json/config.py:37
msgid "test mandatories variables before display in json" msgid "test mandatories variables before display in json"
msgstr "tester les variables obligatoires avant de l'afficher en json" msgstr "tester les variables obligatoires avant de l'afficher en json"
#: src/rougail/output_json/config.py:48 #: src/rougail/output_json/config.py:42
msgid "if \"cli.read_write\" is false"
msgstr "si \"cli.read_write\" est false"
#: src/rougail/output_json/config.py:45
msgid "get value for a variable or a family" msgid "get value for a variable or a family"
msgstr "récupère la valeur pour une variable ou une famille" msgstr "récupère la valeur pour une variable ou une famille"

20
locale/rougail_output_json.pot
View file

@ -5,7 +5,7 @@
msgid "" msgid ""
msgstr "" msgstr ""
"Project-Id-Version: PACKAGE VERSION\n" "Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2025-10-05 21:26+0200\n" "POT-Creation-Date: 2025-12-23 21:38+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n" "Language-Team: LANGUAGE <LL@li.org>\n"
@ -15,19 +15,19 @@ msgstr ""
"Generated-By: pygettext.py 1.5\n" "Generated-By: pygettext.py 1.5\n"
#: src/rougail/output_json/__init__.py:48 #: src/rougail/output_json/__init__.py:50
msgid "the \"step.output\" is not set to \"{0}\"" msgid "the \"step.output\" is not set to \"{0}\""
msgstr "" msgstr ""
#: src/rougail/output_json/__init__.py:105 #: src/rougail/output_json/__init__.py:111
msgid "Error in config: {0}" msgid "Error in config: {0}"
msgstr "" msgstr ""
#: src/rougail/output_json/__init__.py:115 #: src/rougail/output_json/__init__.py:121
msgid "The following variables are mandatory but have no value:" msgid "The following variables are mandatory but have no value:"
msgstr "" msgstr ""
#: src/rougail/output_json/__init__.py:125 #: src/rougail/output_json/__init__.py:131
msgid "The following variables are inaccessible but are empty and mandatory :" msgid "The following variables are inaccessible but are empty and mandatory :"
msgstr "" msgstr ""
@ -35,11 +35,19 @@ msgstr ""
msgid "configuration rougail-json" msgid "configuration rougail-json"
msgstr "" msgstr ""
#: src/rougail/output_json/config.py:34
msgid "if json is not set in \"step.output\""
msgstr ""
#: src/rougail/output_json/config.py:37 #: src/rougail/output_json/config.py:37
msgid "test mandatories variables before display in json" msgid "test mandatories variables before display in json"
msgstr "" msgstr ""
#: src/rougail/output_json/config.py:48 #: src/rougail/output_json/config.py:42
msgid "if \"cli.read_write\" is false"
msgstr ""
#: src/rougail/output_json/config.py:45
msgid "get value for a variable or a family" msgid "get value for a variable or a family"
msgstr "" msgstr ""

15
src/rougail/output_json/config.py
View file

@ -28,21 +28,18 @@ def get_rougail_config(
json: json:
description: {_('configuration rougail-json')} description: {_('configuration rougail-json')}
disabled: disabled:
jinja: | jinja: |-
{{% if step.output is propertyerror or step.output != 'json' %}} {{{{ step.output is propertyerror or step.output != 'json' }}}}
disabled return_type: boolean
{{% endif %}} description: {_('if json is not set in "step.output"')}
mandatory: mandatory:
description: {_('test mandatories variables before display in json')} description: {_('test mandatories variables before display in json')}
type: boolean type: boolean
default: default:
jinja: |- jinja: |-
{{% if cli.read_write is defined and cli.read_write %}} {{{{ cli.read_write is not defined or not cli.read_write }}}}
false description: {_('if "cli.read_write" is false')}
{{% else %}}
true
{{% endif %}}
get: get:
description: {_('get value for a variable or a family')} description: {_('get value for a variable or a family')}

BIN
src/rougail/output_json/locale/fr/LC_MESSAGES/rougail_output_json.mo
View file

Binary file not shown.