{"categories":[{"label":"Documentation","url":"https://skillfed.io/packages/category/documentation/2"}],"enrichment":{"capability":"Runs linters, formatters, and other command-line tools against code blocks embedded in documentation files (reStructuredText, Markdown, MyST, MDX, Djot, Norg).","skillfed_tags":["documentation-testing","code-validation","cli-tool"],"use_cases":["Validate that Python code examples in your README actually pass type checking with mypy or ruff.","Ensure shell script snippets in documentation pass linting tools like shellcheck before release.","Run formatters (ruff format, gofmt) on code blocks to keep examples style-consistent with your codebase.","Test interactive Python sessions (pycon blocks) by stripping prompts, running linters, and restoring them.","Integrate into pre-commit hooks to catch broken documentation examples on every commit.","Verify code blocks across multiple documentation formats (Sphinx, MyST, plain Markdown) in a single pass."],"what_it_does":"doccmd is a command-line tool that extracts code blocks from documentation files and runs external commands (linters, formatters, type checkers) against them. It works with reStructuredText, Markdown, MyST, MDX, Djot, and Norg files, automatically handling language detection and code block extraction so you can validate that the code examples in your documentation actually work and conform to your project's standards.\n\nThe tool preserves line numbers in error output by padding code blocks before execution, and can strip Python REPL prompts (>>>) when processing interactive console examples. It's designed to integrate into CI/CD pipelines and pre-commit hooks, letting you catch broken or outdated code examples before they reach users. Dependencies include click for CLI scaffolding, beartype for runtime type validation, and dulwich for version control operations.","worth_installing":"Yes. The package is actively maintained, has no known vulnerabilities, uses a permissive MIT license, and solves a real problem\u2014keeping documentation code examples in sync with your actual codebase standards. Low install friction and broad format support make it a practical choice for projects that care about documentation quality. Install it if you maintain documentation with embedded code examples and want automated validation."},"id":"doccmd","links":{"html":"https://skillfed.io/packages/doccmd","md":"https://skillfed.io/packages/doccmd.md","pypi":"https://pypi.org/project/doccmd/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2026-07-19","license_spdx":"MIT","license_treatment":"permissive","name":"doccmd","python_support":"supports_current","summary":"Run commands against code blocks in reStructuredText and Markdown files."},"popularity":{"monthly_downloads":175991,"position":10255,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"2026.7.19"}