rust-config-tree 0.1.3

Recursive include tree utilities for layered configuration files.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

# Scripts

[English](README.md) | [中文](README.zh.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Español](README.es.md) | [Português](README.pt.md) | [Svenska](README.sv.md) | [Suomi](README.fi.md) | [Nederlands](README.nl.md)

Ejecuta los scripts desde la raíz del repositorio.

`mdbook build` desde la raíz del repositorio construye el manual inglés
predeterminado. Usa `scripts/publish-pages.sh` para construir todos los idiomas
de GitHub Pages.

## `publish-pages.sh`

Construye todos los manuales mdBook por idioma en `target/mdbook`.

```bash
scripts/publish-pages.sh
```

GitHub Pages se despliega mediante `.github/workflows/pages.yml` después de que
los cambios se envían a `main`.

## `publish-crate.sh`

Ejecuta las comprobaciones de publicación del crate y realiza
`cargo publish --dry-run` por defecto. Si `package.version` ya existe en
crates.io, el script incrementa automáticamente la versión patch.

```bash
scripts/publish-crate.sh
```

Incrementa un componente de versión distinto cuando la versión actual ya
existe:

```bash
scripts/publish-crate.sh --bump minor
scripts/publish-crate.sh --bump major
```

Publica en crates.io:

```bash
scripts/publish-crate.sh --execute
```

El script requiere un árbol git limpio antes de publicar. Usa `--no-bump` para
fallar en lugar de incrementar automáticamente una versión existente.

Los pasos de publicación se reintentan ante fallos transitorios de red de
crates.io/index. Ajusta el comportamiento de reintentos con variables de
entorno:

```bash
PUBLISH_ATTEMPTS=8 PUBLISH_RETRY_DELAY=15 scripts/publish-crate.sh
```

## `release.sh`

Ejecuta el flujo completo de release:

1. Construir el artefacto mdBook Pages.
2. Ejecutar comprobaciones Rust.
3. Crear commit y hacer push del código.
4. Esperar el workflow de GitHub Pages.
5. Publicar el crate.

El modo por defecto es una ejecución dry run:

```bash
scripts/release.sh
```

Ejecuta el release completo:

```bash
scripts/release.sh --execute --message "Release 0.1.3"
```

El script de release completo prepara la versión del crate antes del commit, de
modo que el incremento de versión queda incluido en el commit de release.

Omite la espera del workflow de Pages:

```bash
scripts/release.sh --execute --no-wait-pages
```