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 6c753a4467
6 changed files with 82 additions and 28 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)
## Export de la configuration au format 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 "[La configuration dans l&#x27;état de sortie est dans mode lecture-écriture](#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** : <br/>--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)
## Export configuration to JSON format
> [!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 "[Configuration in output step is in read_write mode](#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**: <br/>--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) |

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

@ -5,8 +5,8 @@
msgid ""
msgstr ""
"Project-Id-Version: \n"
"POT-Creation-Date: 2025-10-05 21:25+0200\n"
"PO-Revision-Date: 2025-10-05 21:26+0200\n"
"POT-Creation-Date: 2025-12-24 09:15+0100\n"
"PO-Revision-Date: 2025-12-24 09:17+0100\n"
"Last-Translator: \n"
"Language-Team: \n"
"Language: fr\n"
@ -14,36 +14,47 @@ msgstr ""
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\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}\""
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}"
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:"
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 :"
msgstr "Les variables suivantes sont inaccessibles mais sont vides et obligatoires :"
#: src/rougail/output_json/config.py:29
msgid "configuration rougail-json"
msgstr "configuration de rougail-json"
msgid "Export configuration to JSON format"
msgstr "Export de la configuration au format 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
msgid "test mandatories variables before display in 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"
msgstr "récupère la valeur pour une variable ou une famille"
#~ msgid "configuration rougail-json"
#~ msgstr "configuration de rougail-json"
#~ msgid "display variables available in read_write mode"
#~ msgstr "affiche les variables valables en mode lecture écriture"

22
locale/rougail_output_json.pot
View file

@ -5,7 +5,7 @@
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2025-10-05 21:26+0200\n"
"POT-Creation-Date: 2025-12-24 09:17+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
@ -15,31 +15,39 @@ msgstr ""
"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}\""
msgstr ""
#: src/rougail/output_json/__init__.py:105
#: src/rougail/output_json/__init__.py:111
msgid "Error in config: {0}"
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:"
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 :"
msgstr ""
#: src/rougail/output_json/config.py:29
msgid "configuration rougail-json"
msgid "Export configuration to JSON format"
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
msgid "test mandatories variables before display in json"
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"
msgstr ""

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

@ -26,23 +26,20 @@ def get_rougail_config(
) -> dict:
options = f"""
json:
description: {_('configuration rougail-json')}
description: {_('Export configuration to JSON format')}
disabled:
jinja: |
{{% if step.output is propertyerror or step.output != 'json' %}}
disabled
{{% endif %}}
jinja: |-
{{{{ step.output is propertyerror or step.output != 'json' }}}}
return_type: boolean
description: {_('if json is not set in "step.output"')}
mandatory:
description: {_('test mandatories variables before display in json')}
type: boolean
default:
jinja: |-
{{% if cli.read_write is defined and cli.read_write %}}
false
{{% else %}}
true
{{% endif %}}
{{{{ cli.read_write is not defined or not cli.read_write }}}}
description: {_('if "cli.read_write" is false')}
get:
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.