Packages
A flake8 extension that detects poorly named variables by flagging single-letter names, overly generic names like 'result' or 'value', and names that shadow Python builtins.
Install it if your team values explicit variable naming; skip it if you prefer flexibility in naming conventions or use a different linter.
Sphinx extension that automatically generates documentation for pydantic models and settings, integrating pydantic's field metadata (defaults, aliases, constraints) directly into Sphinx autodoc output.
A Sphinx theme that extends PyData Sphinx Theme with NVIDIA branding and styling for documentation projects.
However, the proprietary license is restrictive—verify that your project qualifies as a 'NVIDIA product or service' before committing.
Provides custom Python property decorators for defining required properties, writable properties with computed defaults, and cached properties that compute values on demand.
Maps each value in a JSON document to its source location (line, column, character position) and JSON Pointer path, enabling precise error reporting and source-aware JSON processing.
A flake8 extension that enforces a configurable order for class attributes, methods, and nested elements, and detects class-level logic that should be in `__init__`.
However, verify compatibility with your current flake8 version before adopting.
A flake8 extension that enforces function-level code quality rules: function length, argument count, return statement count, and function purity.
Install it if you want automated checks for function complexity; skip it if your team prefers manual review or uses a different linter.
Calculates cognitive complexity scores for Python functions by analyzing their abstract syntax tree, measuring how difficult code is to understand based on control flow, nesting, recursion, and logical operations.
However, consider it a read-only tool: expect no bug fixes, security patches, or feature updates.
A flake8 extension that detects overly complex expressions in Python code and reports them as style violations, with configurable thresholds and optional Django ORM query exemption.
Install it if your team values expression readability and wants automated enforcement; the low friction and active maintenance make it a safe addition to any flake8…
Trogon auto-generates a terminal user interface (TUI) for Click command-line applications, letting users interact with CLI options through a visual menu instead of typing commands.
A flake8 plugin that flags type annotations exceeding configurable complexity thresholds, measuring nesting depth and element count to encourage simpler, more readable type hints.
Install it if your team values readable, maintainable type hints.
Exhale automatically generates C++ API documentation by running Doxygen, parsing its XML output with BeautifulSoup and lxml, and publishing class, file, and page hierarchies as reStructuredText documents within Sphinx.
However, dormant maintenance (last release 2024-01-21) and the documented limitation to small-to-medium projects are real constraints—verify compatibility with your…
Generates RSS 2.0 and JSON Feed 1.1 feeds for MkDocs sites, extracting publication dates from git history and page metadata.
A flake8 extension that checks Python code for cognitive complexity, flagging functions that exceed a configurable threshold (default 7) to help identify overly complex logic.
Generates API documentation for Python 3+ projects automatically from source code and docstrings, supporting multiple docstring formats and type annotations.
Adds an include directive to Python-Markdown that lets you embed the contents of other files into Markdown documents, with support for line-range selection and heading-depth adjustment.
A Sphinx extension that automatically redirects requests for non-existent or renamed documentation pages to their current locations, resolving chains of redirects transparently.
A Sphinx extension that adds roles for linking to issues, pull requests, commits, and user profiles in your documentation, with built-in support for GitHub and configurable support for other issue trackers.
Install it if you maintain a project with a public issue tracker and want to reference issues in your docs.
Shibuya is a Sphinx documentation theme that renders HTML documentation with a modern, responsive design and built-in light/dark mode support.
A Sphinx theme that applies the visual style and layout of the official Python documentation to your own Sphinx-based docs.
A Sphinx extension that injects custom favicon link tags into HTML documentation, supporting multiple formats and rel attributes configured directly in conf.py.
However, maintenance is aging (last release 183 days ago), so verify compatibility with your current Sphinx version before relying on it for production builds.
Generates HTML documentation for register address spaces from compiled SystemRDL register descriptions, converting hardware register models into browsable web documentation.
Install it if you work with SystemRDL register models and need to generate documentation.
A MkDocs plugin that scans Markdown files for TODO, NOTE, and PLACEHOLDER annotations and automatically generates an organized task list.
However, note that maintenance is aging (last release over a year ago), so consider whether you're comfortable with a package that may not receive rapid updates.
Measures docstring coverage in Python source code by scanning for missing docstrings in functions, classes, methods, and modules, then reports statistics and identifies gaps.
However, maintenance is dormant (last release May 2024, no commits for 829 days), so verify compatibility with your Python version before relying on it for critical…
A Sphinx extension that renders JSON Schema definitions inline or from external files directly into documentation, with support for JSON Pointer notation, cross-references, and reStructuredText markup.
However, the abandoned maintenance status and archived repository mean no future bug fixes or Sphinx compatibility updates are guaranteed.
Extracts comments from source code files across multiple programming languages, returning structured comment objects with text, line number, and multiline status.
A Sphinx theme that applies Bootstrap CSS and JavaScript to documentation, offering responsive design, configurable navigation, and support for Bootswatch color schemes.
Loads Sphinx documentation configuration from pyproject.toml instead of keeping it all in conf.py, using PEP 621 project metadata and custom tool settings.
A Sphinx extension that automatically injects a Towncrier-generated changelog draft into documentation, displaying unreleased project version fragments.
However, note that it is still alpha-stage software (version 0.5.0a0), so expect potential API changes.
Provides the core build and CLI infrastructure for JupyterLite, a browser-based Jupyter environment that runs in the browser without a server.
Install only if you need the build toolchain; end users of JupyterLite sites do not need this package.
Inspect, search, and manipulate Sphinx objects.inv inventory files from the command line or Python API, enabling precise cross-reference discovery and inventory editing.
Install it if you write Sphinx documentation or manage documentation builds.
Generates UVM (Universal Verification Methodology) register models in SystemVerilog from compiled SystemRDL register descriptions, enabling automated hardware verification testbench creation.
A modern, responsive Sphinx documentation theme based on VuePress that renders Sphinx projects with a contemporary design using Vue.js and Stylus.
However, install only if you can tolerate dormant maintenance: the 874-day gap since the last release and the author's public call for maintainers mean bug fixes and…
Sphinx-doc extensions and command-line tools that extract documentation from C/C++ source file comments for structured doc generation.
The AGPL-3.0-or-later license requires careful review if you plan to redistribute or modify the package, but poses no barrier to using it as a documentation tool in…
A ProperDocs plugin that allows placing the properdocs.yml configuration file in the same directory as your documentation files, rather than requiring it to be in a separate parent directory.
citeproc-py processes Citation Style Language (CSL) stylesheets to generate formatted citations and bibliographies in plain text, reStructuredText, and HTML from structured reference data.
However, check the list of unimplemented CSL features (disambiguation, et-al rules, collapsing) against your requirements—if you need those features, you may hit…
Provides Sphinx themes styled for Pallets project documentation (Flask, Jinja, Werkzeug, Click), enabling consistent visual presentation across related projects.
Install only if you intend to use one of the four named themes; it adds no value for unrelated Sphinx projects.
Adds a cleaner block-level syntax to Markdown for creating highlighted admonition blocks (callouts) that degrade gracefully in vanilla renderers.
blockdiag generates block-diagram images from a dot-like text specification format, supporting multilingual node labels and multiple output formats.
pydoctor generates API documentation from Python source code through static analysis, supporting multiple docstring formats including epytext, reStructuredText, Google, and Numpy styles.