{"categories":[{"label":"Utilities","url":"https://skillfed.io/packages/category/utilities/11"},{"label":"Documentation","url":"https://skillfed.io/packages/category/documentation/2"},{"label":"Sphinx","url":"https://skillfed.io/packages/category/documentation-sphinx"},{"label":"Documentation","url":"https://skillfed.io/packages/category/software-development-documentation"}],"enrichment":{"capability":"Automatically formats reStructuredText in files and Python docstrings to a consistent style, similar to how Black formats Python code.","skillfed_tags":["code-formatter","docstring-linter","sphinx"],"use_cases":["Enforce consistent docstring formatting across a Python project's codebase automatically.","Integrate docstring formatting into pre-commit hooks to catch style issues before commit.","Format standalone reStructuredText files (e.g., documentation, README files) to match project conventions.","Run as a daemon service to format docstrings on-demand via HTTP in editor plugins or CI pipelines.","Migrate existing docstrings to a standardized format without manual editing."],"what_it_does":"docstrfmt is a command-line tool that automatically formats reStructuredText markup and Python docstrings to a consistent, opinionated style. It draws inspiration from Black and rstfmt, aiming to reduce style discussions and manual formatting work by enforcing a single reasonable format. The tool reads Python files or raw reStructuredText and rewrites docstrings and markup according to its rules, with configurable line length that defaults to Black's 88 characters or can be read from pyproject.toml.\n\nThe package depends on Black, libcst, docutils, Sphinx, and related utilities to parse and reformat the text. It runs as a command-line tool or optionally as an HTTP daemon (docstrfmtd) to avoid repeated startup costs. Currently in beta, it covers most common reStructuredText constructs but acknowledges gaps in coverage for less common syntax.","worth_installing":"Yes, if you work with reStructuredText or Sphinx-style docstrings and want automated, opinionated formatting. The low install friction, active maintenance, permissive license, and zero known vulnerabilities make it a safe choice. The beta status and acknowledged gaps in construct coverage are worth noting if you rely on advanced reStructuredText features, but for typical docstrings and markup it is stable and ready to use."},"id":"docstrfmt","links":{"html":"https://skillfed.io/packages/docstrfmt","md":"https://skillfed.io/packages/docstrfmt.md","pypi":"https://pypi.org/project/docstrfmt/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2026-06-21","license_spdx":null,"license_treatment":"permissive","name":"docstrfmt","python_support":"supports_current","summary":"docstrfmt: A formatter for Sphinx flavored reStructuredText."},"popularity":{"monthly_downloads":81877,"position":14194,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"2.2.0"}