Metadata-Version: 2.4
Name: rougail.user_data_environment
Version: 1.0.0
Summary: Rougail user_data environment
Author-email: Emmanuel Garette <gnunux@gnunux.info>
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Classifier: License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Natural Language :: English
Classifier: Natural Language :: French
License-File: LICENSE
Requires-Dist: rougail >= 1.2.0,<2
Project-URL: Home, https://forge.cloud.silique.fr/stove/rougail-user-data-environment

---
gitea: none
include_toc: true
---
[🇬🇧 (EN)](README.md) - [🇫🇷 (FR)](README.fr.md)

## Load user data from environment variables

> [!NOTE]
> 
> Variable values can be defined directly from an environment variable.\
> \
> Environnement variable names begin with a prefix (by default ROUGAIL_) followed by the variable path in uppercase, for example: ROUGAIL_MY_VARIABLE. If you are using namespaces, the prefix is the name of the namespace in uppercase.\
> \
> Note that variable paths can contain dots ("."), which are not permitted everywhere. To avoid any issues, use the `env` command, for example: `env ROUGAIL_MY_FAMILY.MY_VARIABLE=1 rougail`.\
> \
> For values, there is no difference between a number and a letter (they can be enclosed in quotes or not). However, booleans are True or False. The separator for multiple variables is a comma.\
> **Path**: environment\
> *`disabled`*\
> **Disabled**: if environment is not set in "[select for user data](#step.user_data)".

| Variable                                                                                                                                                                                                                                                                              | Description                                                                                                                                                                                                                                                          | Default value   | Type                                                                                            | Validator                            |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------|-------------------------------------------------------------------------------------------------|--------------------------------------|
| **<a id="environment.default_environment_name" name="environment.default_environment_name">environment.default_environment_name</a>**<br/>**Command line**: <br/>--environment.default_environment_name<br/>**Environment variable**: ROUGAILCLI_ENVIRONMENT.DEFAULT_ENVIRONMENT_NAME | Name of the default environment prefix.                                                                                                                                                                                                                              | ROUGAIL         | [`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory`  | Should only use uppercase character. |
| **<a id="environment.custom_separator" name="environment.custom_separator">environment.custom_separator</a>**<br/>**Command line**: <br/>--environment.custom_separator<br/>**Environment variable**: ROUGAILCLI_ENVIRONMENT.CUSTOM_SEPARATOR                                         | Replace the separator character &quot;.&quot; in path by an other.<br/>The character dot (&quot;.&quot;) may not be allowed in the environment variable name. Note that the variable name with dots is always available in addition to the name with this character. |                 | [`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types)              |                                      |
| **<a id="environment.with_secrets" name="environment.with_secrets">environment.with_secrets</a>**<br/>**Command line**: <br/>•&nbsp;--environment.with_secrets<br/>•&nbsp;--environment.no-with_secrets<br/>**Environment variable**: ROUGAILCLI_ENVIRONMENT.WITH_SECRETS             | Environnement variables may contain secrets.                                                                                                                                                                                                                         | true            | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` |                                      |

