rougail-tutorials/README.md

• Summary
• [tutorial v1.1_000] Creating a structure file (diff)

[tutorial v1.1_001] Let’s add our first variable

Read the tutorial "Let’s add our first variable" in the documentation

Screenshot

Clone and install

To test this tutorial, you need to download this repository and install Rougail:

git clone -b 1.1 https://forge.cloud.silique.fr/stove/rougail-tutorials.git
cd rougail-tutorials
python -m venv venv_rougail
. venv_rougail/bin/activate
pip install rougail-cli rougail-output-exporter rougail-output-doc rougail-user-data-yaml

Then switch to the tutorial page:

git switch --detach v1.1_001

Structure

.
└── firefox
    └── 00-proxy.yml

Contents of the firefox/00-proxy.yml file

%YAML 1.2
---
version: 1.1

proxy_mode:
...

---

Let's generate the documentation

rougail -m firefox/ -o doc

Variable
proxy_mode string mandatory

---

Let's generate the changelog

rougail -m firefox/ -o doc --doc.contents changelog --doc.changelog.previous_json_file previous.yml

New variable

Variable
proxy_mode string mandatory

---

User datas

Example 1

config/01/config.yml

---

---

Output

rougail -m firefox/ -u yaml -yf config/01/config.yml

Caution

• proxy_mode: 🛑 mandatory variable but has no value

---

Output in read write mode

rougail -m firefox/ -u yaml -yf config/01/config.yml --cli.read_write

Note

Caption:

• Variable
• Default value

Variables:

• 📓 proxy_mode: null

---

Example 2

config/02/config.yml

---
proxy_mode: No proxy

---

Output

rougail -m firefox/ -u yaml -yf config/02/config.yml

Note

Caption:

• Variable
• Modified value

Variables:

• 📓 proxy_mode: No proxy ← loaded from the YAML file "config/02/config.yml"

---

Example 3

config/03/config.yml

---
proxy_mode: 1

---

Output

rougail -m firefox/ -u yaml -yf config/03/config.yml

Caution

• proxy_mode
  • 🔔 the value "1" is an invalid string, it's not a string, it will be ignored when loading from the YAML file "config/03/config.yml"
  • 🛑 mandatory variable but has no value

---

Output when invalid user data is an error

rougail -m firefox/ -u yaml -yf config/03/config.yml --cli.invalid_user_data_error

Caution

• proxy_mode
  • 🛑 the value "1" is an invalid string, it's not a string, it has been loading from the YAML file "config/03/config.yml"
  • 🛑 mandatory variable but has no value

---

• [tutorial v1.1_002] Describe the variable (diff)