docwrap 0.1.0__tar.gz → 0.3.0__tar.gz

{docwrap-0.1.0 → docwrap-0.3.0}/.gitignore

@@ -24,6 +24,7 @@ ENV/
 *.spec
 
 # Unit test / coverage reports
+.hypothesis/
 htmlcov/
 .tox/
 .nox/

{docwrap-0.1.0 → docwrap-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: docwrap
-Version: 0.1.0
+Version: 0.3.0
 Summary: Wrap Python docstrings with support for Google, NumPy, and Sphinx styles
 Project-URL: Documentation, https://github.com/dactylo/docwrap/tree/main/docs
 Project-URL: Homepage, https://github.com/dactylo/docwrap
@@ -19,24 +19,22 @@ Description-Content-Type: text/markdown
 
 # docwrap
 
-[![CI](https://github.com/dactylo/docwrap/actions/workflows/ci.yml/badge.svg)](https://github.com/dactylo/docwrap/actions/workflows/ci.yml)
-
-Docwrap applies configurable formatting rules to Python docstrings. It makes wrapping and layout
+docwrap applies configurable formatting rules to Python docstrings. It makes wrapping and layout
 deterministic, with controls for line length, paragraph reflow, and summary placement. It supports
 Google, NumPy, and Sphinx/reST conventions.
 
 Run `docwrap` to see which docstrings would change across your project:
 
-![docwrap summary of six Python files, with 10 of 32 docstrings requiring wrapping](images/docwrap-summary.png)
+![docwrap summary of six Python files, with 10 of 32 docstrings requiring wrapping](https://raw.githubusercontent.com/dactylo/docwrap/v0.3.0/images/docwrap-summary.png)
 
 Then use `docwrap --preview` to compare the original and proposed formatting. For example, using
 the default 79-column limit:
 
-![docwrap preview showing prose and an argument description before and after reflow](images/docwrap-preview.png)
+![docwrap preview showing prose and an argument description before and after reflow](https://raw.githubusercontent.com/dactylo/docwrap/v0.3.0/images/docwrap-preview.png)
 
 ## Installation
 
-Docwrap requires CPython 3.13 or later. From a checkout, install the command with
+docwrap requires CPython 3.13 or later. From a checkout, install the command with
 [uv](https://docs.astral.sh/uv/):
 
 ```bash
@@ -78,17 +76,17 @@ line-length = 88
 ```
 
 Configuration is discovered from each file's `pyproject.toml`. The
-[wrapping policy guide](docs/design.md#choosing-a-wrapping-policy) explains the tradeoffs between
-reflowing prose and preserving authored layout. See the [CLI reference](docs/cli.md) for output
+[wrapping policy guide](https://github.com/dactylo/docwrap/blob/v0.3.0/docs/design.md#choosing-a-wrapping-policy) explains the tradeoffs between
+reflowing prose and preserving authored layout. See the [CLI reference](https://github.com/dactylo/docwrap/blob/v0.3.0/docs/cli.md) for output
 modes, configuration precedence, and advanced options.
 
 ## Integrations and library use
 
 A local [pre-commit](https://pre-commit.com/) hook can run docwrap when you commit. See the
-[pre-commit setup](docs/hook.md#pre-commit) for a writing hook and its report-only variant. Agent
+[pre-commit setup](https://github.com/dactylo/docwrap/blob/v0.3.0/docs/hook.md#pre-commit) for a writing hook and its report-only variant. Agent
 hooks for Claude Code, Codex, and Antigravity can run before commits or after edits. Their
 installation, host settings, commit behavior, and composition limits are in the
-[agent hook guide](docs/hook.md).
+[agent hook guide](https://github.com/dactylo/docwrap/blob/v0.3.0/docs/hook.md).
 
 For Python callers, `wrap_source()` returns rewritten source, `check()` reports whether it would
 change, and `wrap_source_report()` supplies structured results:
@@ -101,26 +99,33 @@ result = docwrap.check(source)
 wrapped = docwrap.wrap_source(source)
 ```
 
-See the [library reference](docs/library.md) for file operations, configuration, result types, and
+See the [library reference](https://github.com/dactylo/docwrap/blob/v0.3.0/docs/library.md) for file operations, configuration, result types, and
 safety skips.
 
 ## Documentation
 
-- [CLI reference](docs/cli.md): commands, output, configuration, and exit codes.
-- [Agent hook guide](docs/hook.md): setup, commit handling, and host responses.
-- [Incremental mode](docs/incremental.md): wrap only changed files or definitions.
-- [Library reference](docs/library.md): supported Python API and result contracts.
-- [Concepts and safety](docs/design.md): styles, wrapping choices, and preservation rules.
-- [Platform compatibility](docs/platform.md): supported environments and file behavior.
+| If you want to...                                      | Read                                       |
+| ------------------------------------------------------ | ------------------------------------------ |
+| Look up commands, output, configuration, or exit codes | [CLI reference](https://github.com/dactylo/docwrap/blob/v0.3.0/docs/cli.md)               |
+| Set up agent hooks, commit handling, or host responses | [Agent hook guide](https://github.com/dactylo/docwrap/blob/v0.3.0/docs/hook.md)           |
+| Wrap only changed files or definitions                 | [Incremental mode](https://github.com/dactylo/docwrap/blob/v0.3.0/docs/incremental.md)    |
+| Call docwrap from Python                               | [Library reference](https://github.com/dactylo/docwrap/blob/v0.3.0/docs/library.md)       |
+| Choose a style and understand what docwrap preserves   | [Concepts and safety](https://github.com/dactylo/docwrap/blob/v0.3.0/docs/design.md)      |
+| Check supported environments and file behavior         | [Platform compatibility](https://github.com/dactylo/docwrap/blob/v0.3.0/docs/platform.md) |
 
 ## Development
 
-See the [development guide](docs/development.md) for pinned CI dependencies and lock updates.
+See the [development guide](https://github.com/dactylo/docwrap/blob/v0.3.0/docs/development.md) for pinned CI dependencies and lock updates.
+
+Run `make setup` with uv 0.13.6 to create the pinned `.venv` before project commands.
+`make install` and `make reinstall` install only the CLI through uv.
 
-From the checkout, run `make check` for repository checks. Run `make format` to apply the
-repository's formatters. The Makefile also provides `make install`, `make reinstall`, and
-`make test`; install targets use uv.
+```bash
+make quality # read-only quality checks
+make check   # quality checks and one full test run
+make format  # apply repository formatters
+```
 
 ## License
 
-Docwrap is available under the [MIT License](LICENSE).
+docwrap is available under the [MIT License](https://github.com/dactylo/docwrap/blob/v0.3.0/LICENSE).

{docwrap-0.1.0 → docwrap-0.3.0}/README.md

@@ -1,8 +1,6 @@
 # docwrap
 
-[![CI](https://github.com/dactylo/docwrap/actions/workflows/ci.yml/badge.svg)](https://github.com/dactylo/docwrap/actions/workflows/ci.yml)
-
-Docwrap applies configurable formatting rules to Python docstrings. It makes wrapping and layout
+docwrap applies configurable formatting rules to Python docstrings. It makes wrapping and layout
 deterministic, with controls for line length, paragraph reflow, and summary placement. It supports
 Google, NumPy, and Sphinx/reST conventions.
 
@@ -17,7 +15,7 @@ the default 79-column limit:
 
 ## Installation
 
-Docwrap requires CPython 3.13 or later. From a checkout, install the command with
+docwrap requires CPython 3.13 or later. From a checkout, install the command with
 [uv](https://docs.astral.sh/uv/):
 
 ```bash
@@ -87,21 +85,28 @@ safety skips.
 
 ## Documentation
 
-- [CLI reference](docs/cli.md): commands, output, configuration, and exit codes.
-- [Agent hook guide](docs/hook.md): setup, commit handling, and host responses.
-- [Incremental mode](docs/incremental.md): wrap only changed files or definitions.
-- [Library reference](docs/library.md): supported Python API and result contracts.
-- [Concepts and safety](docs/design.md): styles, wrapping choices, and preservation rules.
-- [Platform compatibility](docs/platform.md): supported environments and file behavior.
+| If you want to...                                      | Read                                       |
+| ------------------------------------------------------ | ------------------------------------------ |
+| Look up commands, output, configuration, or exit codes | [CLI reference](docs/cli.md)               |
+| Set up agent hooks, commit handling, or host responses | [Agent hook guide](docs/hook.md)           |
+| Wrap only changed files or definitions                 | [Incremental mode](docs/incremental.md)    |
+| Call docwrap from Python                               | [Library reference](docs/library.md)       |
+| Choose a style and understand what docwrap preserves   | [Concepts and safety](docs/design.md)      |
+| Check supported environments and file behavior         | [Platform compatibility](docs/platform.md) |
 
 ## Development
 
 See the [development guide](docs/development.md) for pinned CI dependencies and lock updates.
 
-From the checkout, run `make check` for repository checks. Run `make format` to apply the
-repository's formatters. The Makefile also provides `make install`, `make reinstall`, and
-`make test`; install targets use uv.
+Run `make setup` with uv 0.13.6 to create the pinned `.venv` before project commands.
+`make install` and `make reinstall` install only the CLI through uv.
+
+```bash
+make quality # read-only quality checks
+make check   # quality checks and one full test run
+make format  # apply repository formatters
+```
 
 ## License
 
-Docwrap is available under the [MIT License](LICENSE).
+docwrap is available under the [MIT License](LICENSE).

{docwrap-0.1.0 → docwrap-0.3.0}/_build.py

@@ -12,6 +12,17 @@ class PluginMetadataHook(MetadataHookInterface):
 
     @override
     def update(self, metadata: dict[str, object]) -> None:
+        """Replace distribution entry points with the bundled plugin registrations.
+
+        Args:
+            metadata: Distribution metadata to update in place.
+
+        Raises:
+            OSError: If a plugin manifest cannot be read.
+            tomllib.TOMLDecodeError: If a plugin manifest is invalid TOML.
+            ValueError: If two plugins register the same entry-point group and
+                name.
+        """
         metadata['entry-points'] = _plugin_entry_points(Path(self.root))
 
 

docwrap-0.3.0/plugins/agy/_docwrap/_adapter.py

@@ -0,0 +1,5 @@
+"""Translate Antigravity hook events for docwrap."""
+
+from docwrap._vendor.hookfront._agy import AntigravityAdapter
+
+__all__ = ['AntigravityAdapter']

docwrap-0.3.0/plugins/agy/tests/test_agy_adapter.py

@@ -0,0 +1,50 @@
+# pyright: reportPrivateUsage=false
+
+import json
+import shlex
+from pathlib import Path
+
+import pytest
+
+from docwrap._hook_front import _TOOL, _build_hook_parser
+from docwrap._vendor.hookfront._loader import load_adapter
+
+_ROOT = Path(__file__).resolve().parents[3]
+
+
+@pytest.mark.usefixtures('registered_hosts')
+def test_native_manifest_command_loads_this_adapter() -> None:
+    argv = shlex.split('docwrap hook --agent agy --event PreToolUse')
+    args = _build_hook_parser().parse_args(argv[2:])
+    adapter = load_adapter(_TOOL, args.agent)
+    assert adapter.name == 'agy'
+    assert args.event == 'PreToolUse'
+    assert adapter.requires_event
+
+
+def test_native_manifest_is_unchanged() -> None:
+    assert json.loads((_ROOT / 'plugins' / 'agy' / 'hooks.json').read_text(encoding='utf-8')) == {
+        'docwrap': {
+            'PreToolUse': [
+                {
+                    'matcher': 'run_command',
+                    'hooks': [
+                        {
+                            'type': 'command',
+                            'command': 'docwrap hook --agent agy --event PreToolUse',
+                        }
+                    ],
+                }
+            ]
+        }
+    }
+
+
+def test_native_plugin_identity_and_layout() -> None:
+    plugin = json.loads((_ROOT / 'plugins' / 'agy' / 'plugin.json').read_text(encoding='utf-8'))
+    assert set(plugin) == {'$schema', 'name', 'description'}
+    assert plugin['$schema'] == 'https://antigravity.google/schemas/v1/plugin.json'
+    assert plugin['name'] == 'docwrap-agy'
+    assert isinstance(plugin['description'], str)
+    assert plugin['description'].strip()
+    assert not (_ROOT / 'plugins' / 'agy' / 'hooks').exists()

{docwrap-0.1.0 → docwrap-0.3.0}/plugins/claude/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "docwrap",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Install the docwrap commit-time docstring wrapping hook for Claude Code.",
   "author": {
     "name": "docwrap contributors"

docwrap-0.3.0/plugins/claude/_docwrap/_adapter.py

@@ -0,0 +1,5 @@
+"""Translate Claude Code hook events for docwrap."""
+
+from docwrap._vendor.hookfront._claude import ClaudeAdapter
+
+__all__ = ['ClaudeAdapter']

docwrap-0.3.0/plugins/claude/tests/test_claude_adapter.py

@@ -0,0 +1,129 @@
+# pyright: reportPrivateUsage=false
+
+import json
+import shlex
+from pathlib import Path
+from typing import Literal
+
+import pytest
+
+from docwrap._hook_front import _TOOL, _build_hook_parser
+from docwrap._hook_front import _run_hook as run_hook
+from docwrap._vendor.hookfront._loader import load_adapter
+from tests.helpers import decode_text, git_commit_all, run_setup
+
+_ROOT = Path(__file__).resolve().parents[3]
+
+
+class TestClaudeAdapter:
+    @pytest.mark.usefixtures('example_hosts')
+    @pytest.mark.parametrize('host', ['claude', 'example'])
+    @pytest.mark.parametrize(
+        ('command', 'outcome'),
+        [
+            pytest.param('ls', 'unrelated', id='unrelated'),
+            pytest.param('git commit --future-option -m x', 'denied', id='denied'),
+            pytest.param('git commit -m x', 'wrapped', id='supported'),
+        ],
+    )
+    def test_hook_decisions_preserve_adapter_independence(
+        self,
+        tmp_path: Path,
+        capsys: pytest.CaptureFixture[str],
+        host: str,
+        command: str,
+        outcome: Literal['unrelated', 'denied', 'wrapped'],
+    ) -> None:
+        run_setup(['git', 'init'], cwd=tmp_path)
+        run_setup(['git', 'config', 'docwrap.hook', 'true'], cwd=tmp_path)
+        (tmp_path / 'pyproject.toml').write_text(
+            '[tool.docwrap]\nline-length = 40\nfill-style = "greedy"\n', encoding='utf-8'
+        )
+        target = tmp_path / 'sample.py'
+        target.write_text('pass\n', encoding='utf-8')
+        git_commit_all(tmp_path)
+        source = (
+            'def f():\n    """Summary.\n\n'
+            '    one two three four five six seven eight nine ten eleven twelve\n'
+            '    """\n'
+        )
+        target.write_text(source, encoding='utf-8')
+        run_setup(['git', 'add', 'sample.py'], cwd=tmp_path)
+        payload = json.dumps(
+            _payload('PreToolUse', 'Bash', {'command': command}) | {'cwd': str(tmp_path)}
+        )
+
+        status = run_hook(payload, host=host)
+
+        captured = capsys.readouterr()
+        expected_decision = 'deny' if outcome == 'denied' else None
+        assert (status, _decision(captured.out)) == (0, expected_decision)
+        if expected_decision == 'deny':
+            assert 'unsupported commit command' in captured.err
+        else:
+            assert captured.err == ''
+        expected = (
+            'def f():\n    """Summary.\n\n'
+            '    one two three four five six seven\n'
+            '    eight nine ten eleven twelve\n'
+            '    """\n'
+            if outcome == 'wrapped'
+            else source
+        )
+        staged = run_setup(['git', 'show', ':sample.py'], cwd=tmp_path)
+        assert decode_text(staged.stdout) == expected
+        assert target.read_text(encoding='utf-8') == expected
+
+
+def _decision(stdout: str) -> str | None:
+    if not stdout:
+        return None
+    data = json.loads(stdout)
+    if 'systemMessage' in data:
+        return None
+    if 'hookSpecificOutput' in data:
+        return str(data['hookSpecificOutput']['permissionDecision'])
+    return str(data['example']['decision'])
+
+
+def _payload(event: str, tool: str, tool_input: dict[str, object]) -> dict[str, object]:
+    return {'hook_event_name': event, 'tool_name': tool, 'tool_input': tool_input, 'cwd': '/r'}
+
+
+@pytest.mark.usefixtures('registered_hosts')
+def test_native_manifest_command_loads_this_adapter() -> None:
+    argv = shlex.split('docwrap hook --agent claude')
+    args = _build_hook_parser().parse_args(argv[2:])
+    adapter = load_adapter(_TOOL, args.agent)
+    assert adapter.name == 'claude'
+    assert args.event is None
+    assert not adapter.requires_event
+
+
+def test_native_manifest_is_unchanged() -> None:
+    manifest = _ROOT / 'plugins' / 'claude' / 'hooks' / 'hooks.json'
+    assert json.loads(manifest.read_text(encoding='utf-8')) == {
+        'hooks': {
+            'PreToolUse': [
+                {
+                    'matcher': '^Bash$',
+                    'hooks': [{'type': 'command', 'command': 'docwrap hook --agent claude'}],
+                }
+            ]
+        }
+    }
+
+
+def test_native_plugin_identity_and_marketplace_source() -> None:
+    plugin = json.loads(
+        (_ROOT / 'plugins' / 'claude' / '.claude-plugin' / 'plugin.json').read_text(
+            encoding='utf-8'
+        )
+    )
+    marketplace = json.loads(
+        (_ROOT / '.claude-plugin' / 'marketplace.json').read_text(encoding='utf-8')
+    )
+    assert plugin['name'] == 'docwrap'
+    assert marketplace['plugins'][0]['source'] == './plugins/claude'
+    assert not (_ROOT / 'plugins' / 'claude' / 'hooks.json').exists()
+    assert not (_ROOT / 'plugins' / 'claude' / '.codex-plugin').exists()

{docwrap-0.1.0 → docwrap-0.3.0}/plugins/codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "docwrap",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Install the docwrap commit-time docstring wrapping hook for Codex.",
   "author": {
     "name": "docwrap contributors"

docwrap-0.3.0/plugins/codex/_docwrap/_adapter.py

@@ -0,0 +1,5 @@
+"""Translate Codex hook events for docwrap."""
+
+from docwrap._vendor.hookfront._codex import CodexAdapter
+
+__all__ = ['CodexAdapter']

docwrap-0.3.0/plugins/codex/tests/test_codex_adapter.py

@@ -0,0 +1,50 @@
+# pyright: reportPrivateUsage=false
+
+import json
+import shlex
+from pathlib import Path
+
+import pytest
+
+from docwrap._hook_front import _TOOL, _build_hook_parser
+from docwrap._vendor.hookfront._loader import load_adapter
+
+_ROOT = Path(__file__).resolve().parents[3]
+
+
+@pytest.mark.usefixtures('registered_hosts')
+def test_native_manifest_command_loads_this_adapter() -> None:
+    argv = shlex.split('docwrap hook --agent codex')
+    args = _build_hook_parser().parse_args(argv[2:])
+    adapter = load_adapter(_TOOL, args.agent)
+    assert adapter.name == 'codex'
+    assert args.event is None
+    assert not adapter.requires_event
+
+
+def test_native_manifest_is_unchanged() -> None:
+    manifest = _ROOT / 'plugins' / 'codex' / 'hooks' / 'hooks.json'
+    assert json.loads(manifest.read_text(encoding='utf-8')) == {
+        'hooks': {
+            'PreToolUse': [
+                {
+                    'matcher': '^Bash$',
+                    'hooks': [{'type': 'command', 'command': 'docwrap hook --agent codex'}],
+                }
+            ]
+        }
+    }
+
+
+def test_native_plugin_identity_and_marketplace_source() -> None:
+    plugin = json.loads(
+        (_ROOT / 'plugins' / 'codex' / '.codex-plugin' / 'plugin.json').read_text(encoding='utf-8')
+    )
+    marketplace = json.loads(
+        (_ROOT / '.agents' / 'plugins' / 'marketplace.json').read_text(encoding='utf-8')
+    )
+    assert plugin['name'] == 'docwrap'
+    assert 'hooks' not in plugin
+    assert marketplace['plugins'][0]['source'] == {'source': 'local', 'path': './plugins/codex'}
+    assert not (_ROOT / 'plugins' / 'codex' / 'hooks.json').exists()
+    assert not (_ROOT / 'plugins' / 'codex' / '.claude-plugin').exists()

{docwrap-0.1.0 → docwrap-0.3.0}/pyproject.toml

@@ -3,16 +3,15 @@
 # ==========================================================
 [build-system]
 build-backend = "hatchling.build"
-requires = [ "editables~=0.3", "hatchling>=1.27" ]
+requires = [ "editables~=0.3", "hatch-fancy-pypi-readme>=25.1", "hatchling>=1.27" ]
 
 # ==========================================================
 # Project Metadata
 # ==========================================================
 [project]
 name = "docwrap"
-version = "0.1.0"
+version = "0.3.0"
 description = "Wrap Python docstrings with support for Google, NumPy, and Sphinx styles"
-readme = "README.md"
 keywords = [ "docstring", "formatter", "google", "numpy", "sphinx", "wrap" ]
 license = "MIT"
 license-files = [ "LICENSE" ]
@@ -24,12 +23,12 @@ classifiers = [
   "Programming Language :: Python :: 3.15",
   "Typing :: Typed",
 ]
-dynamic = [ "entry-points" ]
+dynamic = [ "entry-points", "readme" ]
 urls.Documentation = "https://github.com/dactylo/docwrap/tree/main/docs"
 urls.Homepage = "https://github.com/dactylo/docwrap"
 urls.Issues = "https://github.com/dactylo/docwrap/issues"
 urls.Repository = "https://github.com/dactylo/docwrap"
-scripts.docwrap = "docwrap._cli:main"
+scripts.docwrap = "docwrap._main:main"
 
 [dependency-groups]
 dev = [
@@ -45,9 +44,11 @@ dev = [
   "pyright",
   "ruff",
   "vulture",
+  "zizmor",
   { include-group = "test" },
 ]
 test = [
+  "hypothesis",
   "pytest",
   "pytest-xdist>=3.2",
 ]
@@ -59,9 +60,22 @@ ci-build = [
 [tool.hatch]
 metadata.hooks.custom.path = "_build.py"
 build.targets.wheel.include = [ "/plugins/*/_docwrap/", "/src/docwrap/" ]
-build.targets.sdist.include = [ "/_build.py", "/plugins", "/src" ]
+build.targets.sdist.include = [ "/README.md", "/_build.py", "/plugins", "/src" ]
 build.targets.wheel.sources = [ "src" ]
 
+[tool.hatch.metadata.hooks.fancy-pypi-readme]
+content-type = "text/markdown"
+fragments = [ { path = "README.md" } ]
+
+# Keep checkout links relative; package links target this release.
+[[tool.hatch.metadata.hooks.fancy-pypi-readme.substitutions]]
+pattern = '(!\[[^\]\n]*\]\()(?![A-Za-z][A-Za-z0-9+.-]*:|[/#])(?:\./)?([^\s)]+)(\))'
+replacement = '\1https://raw.githubusercontent.com/dactylo/docwrap/v$HFPR_VERSION/\2\3'
+
+[[tool.hatch.metadata.hooks.fancy-pypi-readme.substitutions]]
+pattern = '(?<!!)(\[[^\]\n]+\]\()(?![A-Za-z][A-Za-z0-9+.-]*:|[/#])(?:\./)?([^\s)]+)(\))'
+replacement = '\1https://github.com/dactylo/docwrap/blob/v$HFPR_VERSION/\2\3'
+
 [tool.uv]
 # CI supplies the native Taplo CLI; its Python package lacks Linux/Windows ARM wheels.
 exclude-dependencies = [
@@ -81,26 +95,17 @@ lint.select = [ "ALL" ]
 lint.ignore = [
   "COM812", # Conflicts with the Ruff formatter
   "CPY001", # Copyright notices are not required
-  "D203",   # Conflicts with the Google docstring convention
-  "D213",   # Conflicts with the Google docstring convention
   "EM101",  # Exception must not use string literal
   "EM102",  # Exception must not use f-string literal
   "FBT001", # Boolean positional arg in function definition
   "FBT002", # Boolean default value in function definition
-  "ISC001", # Implicit string concatenation
   "Q000",   # Conflicts with the Ruff formatter
-  "Q001",   # Conflicts with the Ruff formatter
-  "Q002",   # Conflicts with the Ruff formatter
   "Q003",   # Conflicts with the Ruff formatter
   "T201",   # print() found
   "TRY003", # Avoid specifying long messages outside exception class
 ]
-# Same-file private-member collaboration follows the module privacy boundary.
-lint.per-file-ignores."src/docwrap/_grammar.py" = [ "SLF001" ]
-lint.per-file-ignores."src/docwrap/_shellparse.py" = [ "SLF001" ]
 lint.per-file-ignores."{tests,plugins/*/tests}/**/*.py" = [
   "D",       # No docstrings required in tests
-  "PLC2701", # Tests intentionally import private implementation symbols
   "PLR2004", # Allow magic values in tests
   "S101",    # Allow asserts in tests
   "S603",    # Allow subprocess calls in tests
@@ -116,17 +121,12 @@ lint.pydocstyle.convention = "google"
 [tool.vulture]
 ignore_names = [
   "_enable_hook",
-  "_enable_wrap_summary",
-  "_isolate_git_config",  # Autouse pytest fixture
-  "commenters",
+  "_isolate_git_config", # Autouse pytest fixture
   "median",
   "p75",
   "p90",
   "p95",
   "p99",
-  "sphinx_field",
-  "whitespace_split",
-  "wordchars",
 ]
 
 [tool.pyproject-fmt]
@@ -137,6 +137,8 @@ max_supported_python = "3.15"
 # ==========================================================
 [tool.pyright]
 pythonVersion = "3.13"  # Keep in sync with tool.ruff.target-version
+venv = ".venv"  # Created by make setup
+venvPath = "."
 typeCheckingMode = "strict"
 extraPaths = [ ".", "src" ]
 executionEnvironments = [
@@ -152,6 +154,7 @@ ini_options.testpaths = [ "plugins", "tests" ]
 ini_options.pythonpath = [ ".", "src" ]
 ini_options.addopts = [ "-q", "--strict-markers", "--tb=short" ]
 ini_options.markers = [ "slow: marks tests as slow (deselect with '-m \"not slow\"')" ]
+ini_options.faulthandler_timeout = 300
 
 # ==========================================================
 # Mdformat Configuration (Requires mdformat-pyproject)