torrust/torrust-linting

ملف torrust

آخر نشاط مصدر مسجل: ١١ مارس ٢٠٢٦ في ١٠:٤٢

آخر تحديث لفهرس SkillsMP: ١٧ أكتوبر ٢٠٢٦ في ٠٠:٠٩

skills مجمعة: ١

نجوم GitHub: ٢
تفرعات GitHub: ١

ملف README للمستودع

مصدر ملف README للمستودع: README.md

قراءة الملف الأصلي

عرض ملف README كاملًا

# 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).

جارٍ تحميل ملف README للمستودع…

Skills في هذا المستودع

مطوّرو البرمجيات

١ فئات مهنية · 100% مصنفة

skill

المهنة

الوصف

آخر تحديث

publish-rust-crate

مطوّرو البرمجيات

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.

لغة النص الأصلي: الإنجليزية

2026-03-11

عرض ١ من أصل ١ skills مجمعة.

التثبيت بمساعدة مساعد ذكي

انسخ هذا الطلب إلى المساعد الذكي الذي تستخدمه.

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