fix(content:cargo): move positions of topics

Author: SergioRibera

content/4.cargo/1.format.md

@@ -16,8 +16,6 @@ Una de las mayores fortalezas de Rust es su énfasis en la claridad y legibilida
 
 En este artículo, exploraremos cómo usar `cargo fmt` para formatear tu código, configurarlo según tus necesidades, y automatizar su uso en pipelines como GitHub Actions y GitLab CI/CD. Además, explicaremos cómo instalarlo en caso de que no esté disponible en tu entorno.
 
----
-
 ### ¿Qué es `cargo fmt` y por qué es útil?
 
 `cargo fmt` es el comando de Cargo que ejecuta `rustfmt`, el formateador oficial de Rust. Esta herramienta reformatea tu código siguiendo las convenciones oficiales de estilo de Rust, lo que asegura:
@@ -28,8 +26,6 @@ En este artículo, exploraremos cómo usar `cargo fmt` para formatear tu código
 
 Además, es particularmente útil en entornos colaborativos y automatizaciones, como pipelines de integración continua (CI), donde puedes validar automáticamente que el código esté correctamente formateado antes de aceptar cambios.
 
----
-
 ### Instalación y Configuración Inicial
 
 #### Instalación de `rustfmt`
@@ -52,8 +48,6 @@ cargo fmt --version
 
 Esto debería mostrar la versión instalada de `rustfmt`.
 
----
-
 ### Uso Básico de `cargo fmt`
 
 Para formatear todo tu proyecto, simplemente ejecuta:
@@ -70,8 +64,6 @@ cargo fmt --check
 
 El modo `--check` es especialmente útil en pipelines de CI para validar que el código esté correctamente formateado antes de fusionar cambios.
 
----
-
 ### Configuración de `rustfmt`
 
 Puedes personalizar `rustfmt` mediante un archivo de configuración llamado `rustfmt.toml`. Este archivo puede colocarse en la raíz de tu proyecto y permite ajustar varias opciones de estilo.
@@ -97,8 +89,6 @@ config-path = "rustfmt.toml"
 
 Esto garantiza que `cargo fmt` use la configuración personalizada, incluso si el archivo `rustfmt.toml` está en una ubicación no estándar.
 
----
-
 ### Integración de `cargo fmt` en Pipelines de CI
 
 #### Usando GitHub Actions
@@ -157,8 +147,6 @@ format_check:
 
 Este trabajo valida el formato en los cambios propuestos (merge requests) y en la rama principal.
 
----
-
 ### Buenas Prácticas y Recomendaciones
 
 1. **Formatea antes de hacer commits:** Integra `cargo fmt` en tus hooks de pre-commit con herramientas como [pre-commit](https://pre-commit.com/). Esto asegura que todos los commits tengan un formato limpio.
@@ -169,8 +157,6 @@ Este trabajo valida el formato en los cambios propuestos (merge requests) y en l
 
 4. **Evita excepciones innecesarias:** Aunque puedes personalizar el formato, es mejor adherirse a las reglas predeterminadas, ya que son el estándar en la comunidad Rust.
 
----
-
 ### Conclusión
 
 `cargo fmt` es una herramienta esencial en el ecosistema Rust para garantizar un código limpio, legible y consistente. Su facilidad de uso, combinada con la capacidad de personalización y la integración en pipelines, lo hace indispensable para proyectos de cualquier escala. A medida que trabajes en proyectos colaborativos, adoptar `cargo fmt` no solo te ahorrará tiempo, sino que también mejorará la calidad general del código. ¡Haz que `cargo fmt` sea parte de tu flujo de trabajo y lleva tus proyectos al siguiente nivel! 🚀

content/4.cargo/2.modules.md

@@ -16,8 +16,6 @@ data:
 
 Cuando desarrollamos en Rust, mantener el código organizado es esencial para la escalabilidad y la mantenibilidad. Rust ofrece un sistema de módulos flexible que nos ayuda a dividir el código en componentes más manejables. En este artículo exploraremos cómo crear y gestionar módulos, controlar su visibilidad, y estructurar proyectos de manera eficiente, abordando las prácticas más recomendadas en la comunidad.
 
----
-
 ## Introducción a los módulos
 
 Los módulos en Rust agrupan código relacionado bajo un espacio de nombres, permitiendo:
@@ -28,8 +26,6 @@ Los módulos en Rust agrupan código relacionado bajo un espacio de nombres, per
 
 Un módulo puede contener funciones, estructuras, enumeraciones, constantes e incluso otros módulos.
 
----
-
 ## Crear y gestionar módulos
 
 ### Módulos en el mismo archivo
@@ -98,8 +94,6 @@ pub mod add;
 pub mod multiply;
 ```
 
----
-
 ## Control de visibilidad
 
 Por defecto, los módulos y sus elementos son privados. Para hacerlos accesibles, usa `pub`.
@@ -128,8 +122,6 @@ fn main() {
 }
 ```
 
----
-
 ## Estructuración recomendada para proyectos Rust
 
 La organización de un proyecto depende de su propósito. Aquí hay patrones comunes:
@@ -222,8 +214,6 @@ src/
     └── tool2.rs
 ```
 
----
-
 ## Puntos de entrada: `main.rs` y `lib.rs`
 
 ### `main.rs`
@@ -256,24 +246,18 @@ fn main() {
 }
 ```
 
----
-
 ## Buenas prácticas y convenciones
 
 1. **Divide y vencerás:** Usa módulos para separar responsabilidades.
 2. **Restricción de visibilidad:** Haz públicos solo los elementos necesarios.
 3. **Nombres consistentes:** Usa nombres descriptivos para módulos y archivos.
 4. **Centraliza lo común:** Mueve funciones reutilizables a `lib.rs`.
 
----
-
 ## Configuraciones adicionales para módulos
 
 - **Agrupación lógica:** Usa directorios para módulos con múltiples submódulos.
 - **Macros compartidas:** Crea un módulo separado para macros reutilizables, por ejemplo, `src/macros.rs`.
 
----
-
 ## Conclusión
 
 Organizar proyectos con módulos en Rust no solo mejora la claridad del código, sino que también facilita su escalabilidad. Ya sea que trabajes en un ejecutable, una biblioteca o ambos, seguir estas prácticas te ayudará a mantener un código limpio, reutilizable y fácil de entender. ¡Experimenta con estas técnicas y lleva tus proyectos al siguiente nivel! 🚀

content/4.cargo/3.workspaces.md

@@ -15,8 +15,6 @@ data:
 
 A medida que los proyectos en Rust crecen, mantenerlos organizados y eficientes puede volverse un desafío. Aquí es donde los **workspaces** entran en juego. Un workspace te permite gestionar múltiples crates en un mismo proyecto, promoviendo la modularidad, el rendimiento y la mantenibilidad. En este artículo, exploraremos cómo estructurar y aprovechar al máximo los workspaces en Rust.
 
----
-
 ## ¿Qué es un workspace?
 
 Un workspace en Rust es un grupo de crates que comparten configuraciones y dependencias comunes. Los workspaces permiten:
@@ -25,8 +23,6 @@ Un workspace en Rust es un grupo de crates que comparten configuraciones y depen
 - **Eficiencia en la compilación:** Aprovecha la compilación incremental para crates compartidos.
 - **Gestión centralizada:** Simplifica la administración de dependencias y configuraciones.
 
----
-
 ## Estructura típica de un workspace
 
 Un workspace suele tener una estructura similar a esta:
@@ -56,8 +52,6 @@ my_project/
 2. **Directorio `crates/`:** Es una convención común agrupar los crates dentro de un subdirectorio. No es obligatorio, pero mejora la organización.
 3. **Subcrates:** Cada crate tiene su propio `Cargo.toml` y código fuente en `src/`.
 
----
-
 ## Configuración de un workspace
 
 ### Archivo `Cargo.toml` raíz
@@ -85,8 +79,6 @@ log = "0.4"
 
 Esto hace que todas las crates del workspace tengan acceso a estas dependencias sin necesidad de declararlas individualmente.
 
----
-
 ## ¿Cuándo dividir un proyecto en workspaces?
 
 Separar un proyecto en múltiples crates dentro de un workspace tiene sentido cuando:
@@ -96,8 +88,6 @@ Separar un proyecto en múltiples crates dentro de un workspace tiene sentido cu
 3. **Diferentes responsabilidades:** Por ejemplo, separar el frontend y el backend de una aplicación.
 4. **Optimización de la compilación:** Dividir un proyecto en crates permite que solo las partes modificadas se recompilen.
 
----
-
 ## Mejores prácticas para organizar workspaces
 
 ### 1. Usa la convención `crates/`
@@ -123,8 +113,6 @@ pub use log::*;
 
 Esto reduce la duplicación y mejora el tiempo de compilación.
 
----
-
 ## Gestión de dependencias compartidas
 
 ### Usar `[workspace.dependencies]`
@@ -148,8 +136,6 @@ authors = ["Tu Nombre"]
 license = "MIT"
 ```
 
----
-
 ## Comandos comunes en un workspace
 
 ### 1. Afectar un crate específico
@@ -188,8 +174,6 @@ Si el workspace contiene múltiples ejecutables, selecciona cuál ejecutar:
 cargo run -p crate_c
 ```
 
----
-
 ## Automatización y pruebas en workspaces
 
 ### Pruebas
@@ -215,8 +199,6 @@ cargo bench
 cargo bench -p crate_b
 ```
 
----
-
 ## Conclusión
 
 Los workspaces de Rust son una herramienta poderosa para organizar y gestionar proyectos grandes y complejos. Adoptar estrategias como la reutilización de código modular, el uso de dependencias compartidas y la separación lógica de responsabilidades no solo mejora la mantenibilidad, sino que también optimiza los tiempos de compilación y la claridad del proyecto. Con una buena planificación, los workspaces pueden ser el pilar de cualquier proyecto Rust escalable y eficiente.

content/4.cargo/index.md

@@ -19,8 +19,6 @@ data:
 
 Una de las razones por las que Rust se ha convertido en un lenguaje popular es su ecosistema robusto y bien integrado. En el corazón de este ecosistema está **Cargo**, la herramienta oficial para gestionar proyectos en Rust. Cargo no solo se encarga de la construcción de tus proyectos, sino también de la gestión de dependencias, pruebas, y mucho más. Este artículo explora los comandos y características más importantes de Cargo, ayudándote a aprovechar al máximo esta poderosa herramienta.
 
----
-
 ### ¿Qué es Cargo?
 
 Cargo es el administrador de paquetes y herramienta de construcción para Rust. Es comparable a herramientas como `npm` en JavaScript o `pip` en Python, pero con un alcance más amplio. Cargo simplifica tareas esenciales como:
@@ -33,8 +31,6 @@ Cargo es el administrador de paquetes y herramienta de construcción para Rust.
 
 Cuando inicias un proyecto en Rust con `cargo new`, Cargo crea una estructura de directorios estándar que incluye un archivo llamado `Cargo.toml`. Este archivo es el corazón de la configuración del proyecto, donde defines tus dependencias, características, y opciones de compilación.
 
----
-
 ### Construcción de Proyectos con `cargo build`
 
 El comando más básico es `cargo build`, que compila tu proyecto. Al ejecutarlo, Cargo genera los binarios en el directorio `target/debug` por defecto. Si necesitas una compilación optimizada para producción, puedes usar la opción `--release`:
@@ -45,8 +41,6 @@ cargo build --release
 
 Esto genera el binario en `target/release` con optimizaciones avanzadas, pero a costa de tiempos de compilación más largos. Es ideal para el código que se ejecutará en entornos de producción.
 
----
-
 ### Agregando y Eliminando Dependencias
 
 Una de las características más útiles de Cargo es la facilidad con la que puedes manejar dependencias. Con el comando `cargo add` del plugin [cargo-edit](https://github.com/killercup/cargo-edit), puedes agregar dependencias rápidamente:
@@ -79,8 +73,6 @@ cargo remove serde
 
 Esto actualiza automáticamente tu `Cargo.toml` y elimina la dependencia.
 
----
-
 ### Pruebas con `cargo test`
 
 Rust incorpora un sistema de pruebas potente, y Cargo facilita ejecutarlas con `cargo test`. Este comando compila y ejecuta las pruebas definidas en tu proyecto, incluyendo las funciones marcadas con `#[test]`. Cargo incluso configura un entorno de pruebas especial para garantizar consistencia.
@@ -97,8 +89,6 @@ Si necesitas pruebas más detalladas, puedes usar la opción `--nocapture` para
 cargo test -- --nocapture
 ```
 
----
-
 ### Benchmarks con `cargo bench`
 
 Rust también soporta benchmarking, aunque esta funcionalidad requiere habilitar el feature `bench` en el archivo `Cargo.toml`. Una vez configurado, puedes usar:
@@ -109,8 +99,6 @@ cargo bench
 
 Esto ejecuta tus benchmarks usando la biblioteca estándar `test` y genera resultados detallados sobre el rendimiento.
 
----
-
 ### Características Avanzadas con Flags
 
 Cargo incluye una serie de opciones para personalizar cómo se compila y configura tu proyecto. Algunas de las más útiles incluyen:
@@ -142,8 +130,6 @@ Cargo incluye una serie de opciones para personalizar cómo se compila y configu
 
    Esto requiere la instalación del toolchain correspondiente con `rustup`.
 
----
-
 ### Más Allá de los Comandos Básicos
 
 Además de los comandos principales, Cargo incluye otras herramientas que vale la pena explorar:
@@ -172,17 +158,13 @@ Además de los comandos principales, Cargo incluye otras herramientas que vale l
   cargo check
   ```
 
----
-
 ### Recomendaciones y Consejos
 
 1. **Organiza tus dependencias:** Usa `[dependencies]`, `[dev-dependencies]` y `[build-dependencies]` adecuadamente para mantener un `Cargo.toml` limpio y claro.
 2. **Habilita solo las características necesarias:** Minimiza el uso de características opcionales para reducir el tamaño del binario y mejorar los tiempos de compilación.
 3. **Prueba siempre con `--release`:** Antes de desplegar, verifica que tu proyecto funciona correctamente en modo optimizado.
 4. **Explora las herramientas de la comunidad:** Crates como `cargo-watch` pueden mejorar tu flujo de trabajo al reconstruir automáticamente tu proyecto cuando detecta cambios.
 
----
-
 ### Conclusión
 
 Cargo no es solo una herramienta; es el eje central del desarrollo en Rust. Desde la gestión de dependencias hasta la construcción de proyectos optimizados, Cargo simplifica y potencia tu flujo de trabajo. Conocer sus comandos y opciones avanzadas te permitirá aprovechar al máximo el ecosistema Rust, escribiendo código más eficiente, seguro y fácil de mantener. ¡Explora las posibilidades que Cargo tiene para ofrecer y haz que tus proyectos brillen! 🚀