Proyecto Rust

plaintext

Help me get started with Tuist. Follow the setup at:
https://tuist.dev/en/docs/guides/get-started/rust-project

Requisitos previos#

Un proyecto Rust compilado con Cargo.
La CLI de Tuist y una cuenta de Tuist.

Tuist funciona con tu proyecto Cargo existente. No necesitas añadir ninguna dependencia de Rust ni cambiar la forma en que se compila tu proyecto.

Conectar el proyecto#

Instala la CLI de Tuist y Rust. Crea un proyecto en el dashboard con Cargo (Rust) como sistema de compilación. Añade un tuist.toml en la raíz de tu repositorio:

toml

project = "account/project"
# url = "https://your-tuist-server.example.com"

Inicia sesión con tuist auth login, luego ejecuta tus comandos habituales de Cargo a través de Tuist. En CI, configura TUIST_TOKEN con un token de proyecto. También puedes configurar TUIST_PROJECT en lugar de añadir un archivo de configuración, y TUIST_URL si utilizas un servidor autoalojado.

bash

tuist cargo build --workspace
tuist cargo check --all-targets
tuist cargo test --workspace

Usa los mismos argumentos que normalmente pasas a Cargo, incluyendo features, toolchains y filtros de tests. Cargo mantiene su salida y código de salida habituales, incluso si Tuist no puede subir un informe.

Sigue escribiendo Cargo#

Con los wrappers de comandos de mise activados, añade esto a mise.toml:

toml

[wrappers.cargo]
command = "tuist"
args = ["cargo"]

Ejecuta mise reshim después de añadir el wrapper. Luego podrás usar cargo build, cargo check y cargo test como de costumbre. Mise los ejecuta a través de Tuist por ti.

Coding agents

Esto es útil cuando trabajas con agentes de programación: pueden seguir ejecutando cargo build y cargo test sin que haya que recordarles añadir el prefijo tuist.

Caché de compilación#

tuist cargo build almacena en caché automáticamente las bibliotecas hoja del registro elegibles, tanto localmente como a través de la caché remota de Kura. No se necesita ninguna herramienta adicional ni configuración de caché. La caché es experimental y aún no cubre todas las compilaciones ni la reutilización entre diferentes rutas de checkout. Consulta la caché de Rust para ver las compilaciones compatibles, la autenticación y cómo verificar la reutilización.

Análisis de compilaciones#

Abre Compilaciones en el dashboard para ver cuánto tardan tus compilaciones y comparar las compilaciones locales con las de CI. Selecciona una compilación para encontrar los crates que más tardaron en compilarse e inspeccionar sus advertencias y errores.

Los tiempos del compilador corresponden a los crates, no a los archivos fuente individuales. Consulta Análisis de compilaciones de Rust para obtener más información sobre cómo leer un informe de compilación.

Análisis de tests#

Ejecuta tus tests como de costumbre:

bash

tuist cargo test --workspace

Abre Tests en el dashboard para ver los tests aprobados, fallidos e ignorados, incluidos los doctests. Cargo informa de las duraciones de las suites, pero libtest estable no expone los tiempos por test.

Para ejecutar solo doctests:

bash

tuist cargo test --doc

Lee más en Análisis de tests de Rust y Tests inestables de Rust.