{"categories":[{"label":"Quality Assurance","url":"https://skillfed.io/packages/category/software-development-quality-assurance/3"}],"enrichment":{"capability":"Automatically formats Python docstrings to comply with PEP 8 and PEP 257 recommendations, with support for multiple style guides and configurable strictness.","skillfed_tags":["code-quality","docstring-formatting","pep-compliance"],"use_cases":["Enforce consistent docstring formatting across a team or open-source project without manual review.","Integrate into CI/CD pipelines via pre-commit hooks to catch docstring style violations before merge.","Reformat legacy codebases to meet modern PEP 257 standards in bulk.","Configure project-specific docstring rules in pyproject.toml and apply them uniformly.","Use as a linting step alongside pylint to maintain documentation quality."],"what_it_does":"Pydocstringformatter is a command-line tool that reads Python source files and automatically reformats their docstrings to align with PEP 8 and PEP 257 style guidelines. It was created by contributors to the pylint project to address gaps in existing formatters, with a design philosophy that makes some of the more contentious PEP requirements optional rather than mandatory.\n\nThe tool handles common docstring issues: fixing quote styles, capitalizing summaries, normalizing whitespace, enforcing period terminators, and aligning multi-line docstrings. It supports multiple style guides simultaneously (e.g., pep257 and numpydoc), reads configuration from pyproject.toml, and integrates with pre-commit workflows. With zero runtime dependencies and active maintenance, it's designed as a lightweight addition to Python development toolchains.","worth_installing":"Yes. The package is actively maintained, has no dependencies, requires only Python 3.11+, carries no known vulnerabilities, and solves a real problem in code quality enforcement. Install it if your team wants automated, configurable docstring formatting aligned with PEP standards."},"id":"pydocstringformatter","links":{"html":"https://skillfed.io/packages/pydocstringformatter","md":"https://skillfed.io/packages/pydocstringformatter.md","pypi":"https://pypi.org/project/pydocstringformatter/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2026-07-04","license_spdx":null,"license_treatment":"permissive","name":"pydocstringformatter","python_support":"supports_current","summary":"A tool to automatically format Python docstrings that tries to follow recommendations from PEP 8 and PEP 257."},"popularity":{"monthly_downloads":172192,"position":10345,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"1.0.0"}