torrust/torrust-linting

Última actividad de origen registrada: 11 de marzo de 2026 a las 10:42

Catálogo de SkillsMP actualizado: 5 de noviembre de 2026 a las 19:57

skills recopiladas: 1

Estrellas en GitHub: 2
Forks en GitHub: 1

Instalar con un asistente de IA

Copia este prompt en el asistente de IA que estés usando.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/torrust/torrust-linting.

README del repositorio

Archivo de origen del README: README.md

Leer el README original

Mostrar README completo

# Torrust Linting [![Linting](https://github.com/torrust/torrust-linting/actions/workflows/linting.yml/badge.svg)](https://github.com/torrust/torrust-linting/actions/workflows/linting.yml) A unified linting library and CLI for Torrust projects. Provides a single binary that runs all project linters consistently across the organization. ## Features - **Multiple Linters**: Markdown, local Markdown links, YAML, TOML, Rust (clippy + rustfmt), shell scripts, and spell checking - **CLI Ready**: Pre-built CLI binary (`linter`) with subcommands for each linter - **Library**: Use individual linter functions in your own Rust code or build a custom CLI - **Extensible**: Easy to add new linters - **Auto-install**: Automatically installs missing tools (npm-based, system package manager) ## Usage ### As a binary Run the `linter` binary directly: ```sh cargo run # Run all linters (default) cargo run -- markdown # Run markdown linter cargo run -- lychee # Check local Markdown links and fragments offline cargo run -- yaml # Run YAML linter cargo run -- toml # Run TOML linter cargo run -- cspell # Run CSpell spell checker cargo run -- clippy # Run Rust clippy linter cargo run -- rustfmt # Run Rust formatter check cargo run -- shellcheck # Run ShellCheck linter cargo run -- all # Run all linters ``` ### As a library dependency Add to your `Cargo.toml`: ```toml [dependencies] torrust-linting = "0.2.0" ``` #### Option 1: Use the complete CLI (easiest) ```rust use anyhow::Result; fn main() -> Result<()> { torrust_linting::run_cli() } ``` #### Option 2: Custom CLI implementation ```rust use anyhow::Result; use clap::Parser; use torrust_linting::{Cli, execute_command, init_tracing}; fn main() -> Result<()> { init_tracing(); let cli = Cli::parse(); execute_command(cli.command.as_ref())?; Ok(()) } ``` #### Option 3: Use individual linters programmatically ```rust use anyhow::Result; use torrust_linting::{run_rustfmt_linter, run_clippy_linter, run_all_linters}; fn main() -> Result<()> { run_rustfmt_linter()?; run_clippy_linter()?; // Or run everything at once: run_all_linters()?; Ok(()) } ``` See the [`examples/`](examples/) directory for more usage patterns. ## External tools required Some linters delegate to external tools. The library will attempt to install missing tools automatically, but you can also install them manually: | Linter | Tool | Install | | ----------- | --------------------------- | ------------------------------------------------ | | Markdown | `markdownlint` | `npm install -g markdownlint-cli` | | Local links | `lychee` | `cargo install lychee` | | YAML | `yamllint` | `apt install yamllint` / `pip3 install yamllint` | | TOML | `taplo` | `cargo install taplo-cli --locked` | | Spell check | `cspell` | `npm install -g cspell` | | Shell | `shellcheck` | `apt install shellcheck` | | Rust | `cargo clippy`, `cargo fmt` | bundled with `rustup` | ## Configuration files expected in the project root The linters read configuration from well-known files in the working directory: | File | Used by | | -------------------- | ------------ | | `.markdownlint.json` | markdownlint | | `lychee.toml` | lychee | | `.yamllint-ci.yml` | yamllint | | `.taplo.toml` | taplo | | `cspell.json` | cspell | `linter lychee` always passes Lychee's `--offline` flag. This makes normal linting deterministic: it checks only local Markdown links. Configure local fragment checking and repository-specific exclusions in `lychee.toml`; use the Lychee executable directly from a separately configured, advisory scheduled workflow when checking external URLs. ## License Copyright (c) 2026 Torrust. See [LICENSE](LICENSE).

Cargando el README del repositorio…

Skills en este repositorio

Desarrolladores de software

1 categorías ocupacionales · 100% clasificado

skill

ocupación

descripción

actualizado

publish-rust-crate

Desarrolladores de software

Publishes a new version of the torrust-linting crate to crates.io. Use this skill when the user asks to release a new version, publish the package, cut a release, bump the version, or prepare a crates.io release for this project.

Idioma del texto original: inglés

2026-03-11

Mostrando 1 de 1 skills recopiladas.