{"categories":[{"label":"Markup","url":"https://skillfed.io/packages/category/text-processing-markup"}],"enrichment":{"capability":"Lints reStructuredText documents for structural errors and returns a list of violations with line numbers, severity levels, and messages.","skillfed_tags":["documentation-validation","cli-tool"],"use_cases":["Validate README.rst and other documentation files before pushing to PyPI or a repository","Integrate linting into CI/CD pipelines to catch reStructuredText errors early","Check documentation consistency in projects using Sphinx or docutils","Programmatically lint reST content in build scripts or documentation generators","Detect title underlines, hyperlink issues, and lexer problems that would fail on PyPI"],"what_it_does":"restructuredtext-lint checks reStructuredText files for structural violations before they are uploaded to PyPI or deployed. It wraps docutils parsing and exposes both a Python API (lint() and lint_file() functions) and a command-line tool (rst-lint) that report errors with line numbers, severity levels, and descriptive messages. Each error includes metadata like source file, error type (INFO/WARNING/ERROR/SEVERE), and the full context where the problem occurred.\n\nThe package was created to catch reST formatting issues locally rather than discovering them after publishing. It supports prepending content via rst_prolog for testing with substitutions, filtering by error severity, and output in text or JSON format. Custom directives and roles can be registered via docutils' extension mechanism, though Sphinx-specific customizations require manual registration due to parser differences.","worth_installing":"Yes, if you work with reStructuredText documentation or publish to PyPI. The tool solves a real problem\u2014catching formatting errors before upload\u2014with low install friction and no security vulnerabilities. The aging maintenance status (264 days since release) is a minor concern for a stable linter, but the unarchived repository and active last commit suggest it is not abandoned. Install if you need local validation; skip if you only use Markdown or have no reStructuredText workflow."},"id":"restructuredtext-lint","links":{"html":"https://skillfed.io/packages/restructuredtext-lint","md":"https://skillfed.io/packages/restructuredtext-lint.md","pypi":"https://pypi.org/project/restructuredtext-lint/"},"maintenance":{"status":"aging"},"meta":{"latest_release":"2025-11-23","license_spdx":null,"license_treatment":"permissive","name":"restructuredtext-lint","python_support":"unspecified","summary":"reStructuredText linter"},"popularity":{"monthly_downloads":17086205,"position":1133,"tier":"top_5000"},"security":{"n_vulnerabilities":0},"version":"2.0.2"}