We're happy to announce the release of docstub v0.6.0 on 2025-11-04!
Enhancement
- Add the new experimental
--workersoption todocstub runto generate stub files in parallel. This can reduce runtime significantly for projects with many files. For now, multiprocessing has to be explicitly enabled by requesting a number of workers (#110). - Highlight help messages (invoked with
-hor--help) of the command line interface with colors and reformat. This should improve the readability (#109). - Don't color output if the environment variable
NO_COLOR=1is set (#109). - Support using types from the standard library module
typesdirectly without requiring configuration or imports for them (#106). - Provide file and line context in warnings that are emitted while parsing doctypes (#108).
- Add the short command line option
-gas an alternative todocstub run --group-errors(#109). - Hide additional debug information behind "verbosity 3" (
-vvv). This makes the option-vva bit more usable. Also use a more generally visible ANSI color for debug information (bright_black) (#104).
Performance
- Speed-up how fast docstub's command line displays help text with the
-hor--helpoption (#112).
Bug Fixes
- Ensure that warnings are raised for partially documented signatures. Previously, no warning was raised for untyped parameters when at least one parameter was annotated (#107).
- Ensure that docstub still returns a non-zero exit code when it is run with output completely disabled (
-qq). The same applies when running docstub with--quiet --fail-on-warnings(#110). - Ensure that warnings are raised for undocumented parameters and attributes. Previously, no warning was raised for parameters and attributes when at least that were mentioned in a docstring, but didn't have a doctype (#111).
Contributors
1 author(s) added to this release (alphabetically):
- Lars Grüter (@lagru)