2025-11-04 19:22:03 +01:00
- [Summary ](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/branch/1.1/README.md )
2025-11-04 19:22:16 +01:00
- [[tutorial v1.1_030] A variable with type "boolean"](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_030/README.md) ([diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_030~1..v1.1_030))
2025-11-04 19:22:03 +01:00
2025-11-04 19:22:16 +01:00
# [tutorial v1.1_031)] Copy HTTP manual proxy to HTTPS manual proxy
2025-11-04 19:22:03 +01:00
2025-11-04 19:22:16 +01:00
[View the diff ](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_031~1..v1.1_031 )
2025-11-04 19:22:03 +01:00
2025-11-04 19:22:02 +01:00
## Screenshot
< img src = "firefox.png" width = 50% height = 50% alt = "Firefox Proxy setting" / >
## Structure
2025-11-04 19:22:03 +01:00
### firefox/00-proxy.yml
```yml
%YAML 1.2
---
version: 1.1
2025-11-04 19:22:04 +01:00
2025-11-04 19:22:06 +01:00
proxy_mode:
description: Configure Proxy Access to the Internet
choices:
- No proxy
- Auto-detect proxy settings for this network
- Use system proxy settings
- Manual proxy configuration
- Automatic proxy configuration URL
default: No proxy
2025-11-04 19:22:03 +01:00
...
```
2025-11-04 19:22:07 +01:00
### firefox/10-manual.yml
2025-11-04 19:22:04 +01:00
```yml
2025-11-04 19:22:07 +01:00
%YAML 1.2
2025-11-04 19:22:04 +01:00
---
2025-11-04 19:22:07 +01:00
version: 1.1
2025-11-04 19:22:04 +01:00
2025-11-04 19:22:13 +01:00
manual:
description: Manual proxy configuration
2025-11-04 19:22:14 +01:00
disabled:
variable: _.proxy_mode
when_not: Manual proxy configuration
2025-11-04 19:22:08 +01:00
2025-11-04 19:22:09 +01:00
http_proxy: # HTTP Proxy
2025-11-04 19:22:10 +01:00
address:
description: HTTP address
type: domainname
2025-11-04 19:22:11 +01:00
params:
allow_ip: true
2025-11-04 19:22:12 +01:00
port:
description: HTTP Port
type: port
default: 8080
2025-11-04 19:22:07 +01:00
...
2025-11-04 19:22:04 +01:00
2025-11-04 19:22:15 +01:00
```
### firefox/20-manual.yml
```yml
%YAML 1.2
---
version: 1.1
manual:
use_for_https: true # Also use this proxy for HTTPS
2025-11-04 19:22:16 +01:00
https_proxy: # HTTPS Proxy
address:
description: HTTPS address
type: domainname
params:
allow_ip: true
port:
description: HTTPS Port
type: port
default: 8080
2025-11-04 19:22:15 +01:00
...
2025-11-04 19:22:04 +01:00
```
2025-11-04 19:22:07 +01:00
### Let's generate the documentation
2025-11-04 19:22:04 +01:00
```console
2025-11-04 19:22:16 +01:00
foo@bar:~$ git switch --detach v1.1_031
2025-11-04 19:22:07 +01:00
foo@bar:~$ rougail -m firefox/ -o doc -do github
2025-11-04 19:22:04 +01:00
```
2025-11-04 19:22:07 +01:00
| Variable | Description |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **proxy_mode** < br /> [`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | Configure Proxy Access to the Internet.< br /> **Choices**: < br /> - No proxy ** ← (default)**< br /> - Auto-detect proxy settings for this network< br /> - Use system proxy settings< br /> - Manual proxy configuration< br /> - Automatic proxy configuration URL |
2025-11-04 19:22:04 +01:00
2025-11-04 19:22:14 +01:00
#### Manual proxy configuration
**manual**
*`disabled`*
**Disabled**: when the variable "proxy_mode" hasn't the value "Manual proxy configuration"
##### HTTP Proxy
**manual.http_proxy**
| Variable | Description |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **manual.http_proxy.address** < br /> [`domainname`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | HTTP address.< br /> **Validator**: the domain name can be an IP |
| **manual.http_proxy.port** < br /> [`port`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | HTTP Port.< br /> **Validators**: < br /> - well-known ports (1 to 1023) are allowed< br /> - registred ports (1024 to 49151) are allowed< br /> - private ports (greater than 49152) are allowed< br /> **Default**: 8080 |
2025-11-04 19:22:15 +01:00
| Variable | Description |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **manual.use_for_https** < br /> [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | Also use this proxy for HTTPS.< br /> **Default**: true |
2025-11-04 19:22:16 +01:00
##### HTTPS Proxy
**manual.https_proxy**
| Variable | Description |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **manual.https_proxy.address** < br /> [`domainname`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | HTTPS address.< br /> **Validator**: the domain name can be an IP |
| **manual.https_proxy.port** < br /> [`port`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | HTTPS Port.< br /> **Validators**: < br /> - well-known ports (1 to 1023) are allowed< br /> - registred ports (1024 to 49151) are allowed< br /> - private ports (greater than 49152) are allowed< br /> **Default**: 8080 |
2025-11-04 19:22:09 +01:00
### Let's generate the changelog
```console
2025-11-04 19:22:16 +01:00
foo@bar:~$ git switch --detach v1.1_031
2025-11-04 19:22:09 +01:00
foo@bar:~$ rougail -m firefox/ -o doc --doc.contents changelog -do github
```
2025-11-04 19:22:16 +01:00
#### New variables
2025-11-04 19:22:14 +01:00
2025-11-04 19:22:16 +01:00
| Variable | Description |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **manual.https_proxy.address** < br /> [`domainname`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | HTTPS address.< br /> **Validator**: the domain name can be an IP |
| **manual.https_proxy.port** < br /> [`port`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | HTTPS Port.< br /> **Validators**: < br /> - well-known ports (1 to 1023) are allowed< br /> - registred ports (1024 to 49151) are allowed< br /> - private ports (greater than 49152) are allowed< br /> **Default**: 8080 |
2025-11-04 19:22:09 +01:00
## User datas
### Example 1
#### config/01/config.yaml
```yml
---
```
#### Output
```console
2025-11-04 19:22:16 +01:00
foo@bar:~$ git switch --detach v1.1_031
2025-11-04 19:22:09 +01:00
foo@bar:~$ rougail -m firefox/ -u yaml -ff config/01/config.yaml
```
2025-11-04 19:22:13 +01:00
< pre > ╭─────── Caption ────────╮
│ Variable < span style = "color: #ffd700 " > Default value</ span > │
╰────────────────────────╯
Variables:
< span style = "color: #5c5cff " > ┗━━ </ span > 📓 Configure Proxy Access to the Internet: < span style = "color: #ffd700 " > No proxy</ span >
2025-11-04 19:22:09 +01:00
< / pre >
### Example 2
#### config/02/config.yaml
```yml
---
2025-11-04 19:22:15 +01:00
proxy_mode: No proxy
2025-11-04 19:22:09 +01:00
```
#### Output
```console
2025-11-04 19:22:16 +01:00
foo@bar:~$ git switch --detach v1.1_031
2025-11-04 19:22:09 +01:00
foo@bar:~$ rougail -m firefox/ -u yaml -ff config/02/config.yaml
```
2025-11-04 19:22:15 +01:00
< pre > ╭────────────── Caption ───────────────╮
│ Variable Modified value │
│ (< span style = "color: #00aa00 " > ⏳ Original default value</ span > ) │
╰──────────────────────────────────────╯
Variables:
< span style = "color: #5c5cff " > ┗━━ </ span > 📓 Configure Proxy Access to the Internet: No proxy ◀ loaded from the YAML file "config/02/config.yaml" (⏳ < span style = "color: #00aa00 " > No proxy</ span > )
2025-11-04 19:22:09 +01:00
< / pre >
### Example 3
#### config/03/config.yaml
```yml
---
proxy_mode: Manual proxy configuration
```
#### Output
```console
2025-11-04 19:22:16 +01:00
foo@bar:~$ git switch --detach v1.1_031
2025-11-04 19:22:09 +01:00
foo@bar:~$ rougail -m firefox/ -u yaml -ff config/03/config.yaml
```
2025-11-04 19:22:15 +01:00
< pre >< span style = "font-weight: bold; color: #ff0000 " > 🛑 ERRORS</ span >
< span style = "color: #ff0000 " > ┗━━ </ span > The following variables are mandatory but have no value:
< span style = "color: #ff0000 " > </ span >< span style = "color: #ff0000 " > ┗━━ </ span > Manual proxy configuration
2025-11-04 19:22:16 +01:00
< span style = "color: #ff0000 " > </ span >< span style = "color: #ff0000 " > </ span >< span style = "color: #ff0000 " > ┣━━ </ span > HTTP Proxy
< span style = "color: #ff0000 " > </ span >< span style = "color: #ff0000 " > </ span >< span style = "color: #ff0000 " > ┃ </ span >< span style = "color: #ff0000 " > ┗━━ </ span > HTTP address
< span style = "color: #ff0000 " > </ span >< span style = "color: #ff0000 " > </ span >< span style = "color: #ff0000 " > ┗━━ </ span > HTTPS Proxy
< span style = "color: #ff0000 " > </ span >< span style = "color: #ff0000 " > </ span >< span style = "color: #ff0000 " > </ span >< span style = "color: #ff0000 " > ┗━━ </ span > HTTPS address
2025-11-04 19:22:09 +01:00
< / pre >
### Example 4
#### config/04/config.yaml
```yml
---
2025-11-04 19:22:15 +01:00
proxy_mode: foo
2025-11-04 19:22:09 +01:00
```
#### Output
```console
2025-11-04 19:22:16 +01:00
foo@bar:~$ git switch --detach v1.1_031
2025-11-04 19:22:09 +01:00
foo@bar:~$ rougail -m firefox/ -u yaml -ff config/04/config.yaml
```
2025-11-04 19:22:15 +01:00
< pre >< span style = "font-weight: bold; color: #ffff00 " > 🔔 WARNINGS</ span >
< span style = "color: #ffff00 " > ┗━━ </ span > the value "foo" is an invalid choice for "proxy_mode" (Configure Proxy Access to the Internet), only "Auto-detect proxy settings for this network", "Automatic proxy configuration URL", "Manual proxy
< span style = "color: #ffff00 " > </ span > configuration", "No proxy" and "Use system proxy settings" are allowed, it will be ignored when loading from the YAML file "config/04/config.yaml"
╭─────── Caption ────────╮
│ Variable < span style = "color: #ffd700 " > Default value</ span > │
╰────────────────────────╯
2025-11-04 19:22:09 +01:00
Variables:
2025-11-04 19:22:15 +01:00
< span style = "color: #5c5cff " > ┗━━ </ span > 📓 Configure Proxy Access to the Internet: < span style = "color: #ffd700 " > No proxy</ span >
2025-11-04 19:22:09 +01:00
< / pre >
### Example 5
#### config/05/config.yaml
```yml
---
2025-11-04 19:22:15 +01:00
proxy_mode: 1
2025-11-04 19:22:09 +01:00
```
#### Output
```console
2025-11-04 19:22:16 +01:00
foo@bar:~$ git switch --detach v1.1_031
2025-11-04 19:22:09 +01:00
foo@bar:~$ rougail -m firefox/ -u yaml -ff config/05/config.yaml
```
< pre >< span style = "font-weight: bold; color: #ffff00 " > 🔔 WARNINGS</ span >
2025-11-04 19:22:15 +01:00
< span style = "color: #ffff00 " > ┗━━ </ span > the value "1" is an invalid choice for "proxy_mode" (Configure Proxy Access to the Internet), only "Auto-detect proxy settings for this network", "Automatic proxy configuration URL", "Manual proxy
< span style = "color: #ffff00 " > </ span > configuration", "No proxy" and "Use system proxy settings" are allowed, it will be ignored when loading from the YAML file "config/05/config.yaml"
╭─────── Caption ────────╮
│ Variable < span style = "color: #ffd700 " > Default value</ span > │
╰────────────────────────╯
2025-11-04 19:22:09 +01:00
Variables:
2025-11-04 19:22:15 +01:00
< span style = "color: #5c5cff " > ┗━━ </ span > 📓 Configure Proxy Access to the Internet: < span style = "color: #ffd700 " > No proxy</ span >
2025-11-04 19:22:09 +01:00
< / pre >
2025-11-04 19:22:04 +01:00
2025-11-04 19:22:16 +01:00
- [[tutorial v1.1_032] An hidden family](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_032/README.md) ([diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_032~1..v1.1_032))