docvet 1.6: JSON Output, LSP Server, and Pre-Commit Hooks

[Alberto-Codes]

The biggest release since 1.0 — docvet went from a CLI tool to a platform you can integrate everywhere.

What shipped

JSON output — docvet check --all --format json gives you structured, machine-readable results. Pipe findings into dashboards, custom tooling, or CI scripts that need programmatic access to docstring quality data.

LSP server — docvet lsp provides real-time docstring diagnostics in your editor. Based on pygls, works with any LSP client — VS Code, Neovim, Helix, Sublime Text. Findings appear as inline warnings as you type.

Pre-commit hook — add docvet to your .pre-commit-config.yaml and catch docstring issues before they hit the repo. Zero configuration needed.

Claude Code plugin — .claude/settings.local.json integration with pre-built hooks for Claude Code users.

Positional file arguments — docvet check path/to/file.py on all subcommands. No more --files flag needed for quick single-file checks.

Cross-platform CI — test matrix across Ubuntu, macOS, and Windows on Python 3.12 and 3.13.

Documentation

• "How to Fix" guidance on all rule pages with before/after examples
• AGENTS.md for AI agent discovery (Copilot, Claude Code, Cursor)
• CONTRIBUTING.md with development setup and architecture overview

Try it

pip install docvet
docvet check --all --format json

Docs · PyPI · Changelog