NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #4106 most downloaded on PyPI
A Python docstring linter that checks arguments, returns, yields, and raises sections
Latest stable
0.12.0
Last release 25 days ago
28 Oct 2026
Ships unpredictably
gaps range from 1 weeks to 6 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
98 releases · first in 2023
Drag across the ruler to compare, or tap a release to open it.
Update dependency to fix return section parsing by @jsh9 in https://github.com/jsh9/pydoclint/pull/90
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.3.5...0.3.6
Ignore underscore args when checking args by @jsh9 in https://github.com/jsh9/pydoclint/pull/89
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.3.4...0.3.5
Your coding agent can read these notes before it upgrades. Set up the MCP server →
_,
__, ___, ...) in the arguments in the function signatureDon't check type hints for DOC103 by @jsh9 in https://github.com/jsh9/pydoclint/pull/86
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.3.3...0.3.4
Baseline integration by @Egorrko in https://github.com/jsh9/pydoclint/pull/83
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.3.2...0.3.3
--generate-baseline True Generate baseline content, and write it to a
file specified from --baseline option path.--baseline <PATH> Specify path to file with baseline content.--config option, the default value is now pyproject.toml.Make flake8 dependency optional by @jsh9 in https://github.com/jsh9/pydoclint/pull/82
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.3.1...0.3.2
flake8 an optional dependencyDo not require Yields section if yielding None by @jsh9 in https://github.com/jsh9/pydoclint/pull/80
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.3.0...0.3.1
--require-yield-section-when-yielding-nothing (defaulting
to False). When it's False, we don't need a "Yields" section when a
function yields None (https://github.com/jsh9/pydoclint/issues/79)Stop enforcing Generator when a function yields things by @jsh9 in https://github.com/jsh9/pydoclint/pull/77
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.2.4...0.3.0
A bug with unparsing yield types
A bug with yields type checking
DOC403 code logicBetter handling of backslash in docstring by @jsh9 in https://github.com/jsh9/pydoclint/pull/74
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.2.1...0.2.2
Improved
\) in docstrings
(https://github.com/jsh9/pydoclint/issues/73)Full diff
Better handling of backticks in type hints by @jsh9 in https://github.com/jsh9/pydoclint/pull/72
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.2.0...0.2.1
Improved
Full diff
Add checking of yield types by @jsh9 in https://github.com/jsh9/pydoclint/pull/69
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.1.9...0.2.0
DOC404Generator/Iterator and the
yield/return statements, as well as a corresponding violation: DOC405
(https://github.com/jsh9/pydoclint/issues/68)Fix union return type (Google style) by @jsh9 in https://github.com/jsh9/pydoclint/pull/67
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.1.8...0.1.9
int | str) in
Google-style docstrings cannot be correctly parsed
(https://github.com/jsh9/pydoclint/issues/66)Update broken URL on DOC103 notes by @jsh9 in https://github.com/jsh9/pydoclint/pull/62
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.1.7...0.1.8
DOC103 notes
(https://github.com/jsh9/pydoclint/issues/61)Handle syntax errors in type hints by @jsh9 in https://github.com/jsh9/pydoclint/pull/60
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.1.6...0.1.7
Don't require a returns section for NoReturn by @llucax in https://github.com/jsh9/pydoclint/pull/57
NoReturn by @llucax in https://github.com/jsh9/pydoclint/pull/57Full Changelog: https://github.com/jsh9/pydoclint/compare/0.1.5...0.1.6
NoReturn type annotation
(https://github.com/jsh9/pydoclint/issues/55)Improve type hint comparison algorithm by @jsh9 in https://github.com/jsh9/pydoclint/pull/58
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.1.4...0.1.5
Create doc site for pydoclint by @jsh9 in https://github.com/jsh9/pydoclint/pull/47
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.1.3...0.1.4
Parse '--check-return-types' in flake8 plugin by @JenSte in https://github.com/jsh9/pydoclint/pull/52
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.1.2...0.1.3
--check-return-types option to flake8 plugin
(https://github.com/jsh9/pydoclint/pull/52)Fix outdate wording in type-hints-in-xxx by @jsh9 in https://github.com/jsh9/pydoclint/pull/51
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.1.1...0.1.2
--type-hints-in-docstring and
--type-hints-in-signature (https://github.com/jsh9/pydoclint/issues/50)Fix parsing of 'sphinx' as style argument by @JenSte in https://github.com/jsh9/pydoclint/pull/48
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.1.0...0.1.1
Add support for Sphinx docstring style by @jsh9 in https://github.com/jsh9/pydoclint/pull/46
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.0.16...0.1.0
Fix incorrect tuple annotation detection by @jsh9 in https://github.com/jsh9/pydoclint/pull/45
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.0.15...0.0.16
Fix false positive DOC402 by @jsh9 in https://github.com/jsh9/pydoclint/pull/41
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.0.14...0.0.15
DOC402 when yield statements are in a block within
a nested function (https://github.com/jsh9/pydoclint/pull/42)return and raise statements are in a block
within a nested function (https://github.com/jsh9/pydoclint/pull/42)Properly deal with quotes in return annotations by @jsh9 in https://github.com/jsh9/pydoclint/pull/39
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.0.13...0.0.14
Fix false positives in abstract methods by @jsh9 in https://github.com/jsh9/pydoclint/pull/35
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.0.12...0.0.13
Fix false positive D203 when returning None by @jsh9 in https://github.com/jsh9/pydoclint/pull/34
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.0.11...0.0.12
--require-return-section-when-returning-None is False, the docstring
has no return section, and the return annotation is None
(https://github.com/jsh9/pydoclint/pull/34)Check consistency in return types by @jsh9 in https://github.com/jsh9/pydoclint/pull/33
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.0.10...0.0.11
Fix bug in type hint checking by @jsh9 in https://github.com/jsh9/pydoclint/pull/29
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.0.9...0.0.10
Link darglint2 in README. by @real-yfprojects in https://github.com/jsh9/pydoclint/pull/24
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.0.8...0.0.9
--check-type-hint option with two new options:
--type-hints-in-docstring and --type-hints-in-signature
(https://github.com/jsh9/pydoclint/issues/19)Add CLI option --version to show version info by @m472 in https://github.com/jsh9/pydoclint/pull/17
--version to show version info by @m472 in https://github.com/jsh9/pydoclint/pull/17Full Changelog: https://github.com/jsh9/pydoclint/compare/0.0.7...0.0.8
--version to show the current version of pydoclint
(https://github.com/jsh9/pydoclint/pull/17)Fixed a bug (https://github.com/jsh9/pydoclint/issues/16) where re-raising an exception was not handled properly
A typo in DOC103 error message that resulted in an invalid URL
DOC103 error message that resulted in an invalid URLAllow no return section in docstring by @jsh9 in https://github.com/jsh9/pydoclint/pull/10
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.0.4...0.0.5
None (https://github.com/jsh9/pydoclint/issues/6)@property as its last decorator no longer need to have a
return section in the docstring (https://github.com/jsh9/pydoclint/pull/13)A new violation, DOC001, for errors in parsing docstrings (PR https://github.com/jsh9/pydoclint/pull/8)
DOC001, for errors in parsing docstrings (PR https://github.com/jsh9/pydoclint/pull/8)__init__() methods to have docstring (and when
users activate this option, check arguments and "Raises" in the docstring
of __init__() instead of in the class docstring) (PR https://github.com/jsh9/pydoclint/pull/7)Callable[[int], str] (64f6250f03b74677852c7163c6ca91023c073da0)Support Google-style docstring by @jsh9 in https://github.com/jsh9/pydoclint/pull/5
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.0.2...0.0.3
Add support for star arguments by @jsh9 in https://github.com/jsh9/pydoclint/pull/2
Full Changelog: https://github.com/jsh9/pydoclint/compare/0.0.1...0.0.2
Initial release
Initial release
One column per quarter.