agentic-pydoc 0.1.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- agentic_pydoc-0.1.0/.gitignore +14 -0
- agentic_pydoc-0.1.0/.python-version +1 -0
- agentic_pydoc-0.1.0/AGENTS.md +9 -0
- agentic_pydoc-0.1.0/CONTEXT.md +8 -0
- agentic_pydoc-0.1.0/PKG-INFO +71 -0
- agentic_pydoc-0.1.0/README.md +61 -0
- agentic_pydoc-0.1.0/docs/API_REFERENCE.md +2156 -0
- agentic_pydoc-0.1.0/docs/agents/domain.md +19 -0
- agentic_pydoc-0.1.0/docs/agents/issue-tracker.md +20 -0
- agentic_pydoc-0.1.0/docs/incremental-indexing.md +43 -0
- agentic_pydoc-0.1.0/pyproject.toml +29 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/__init__.py +6 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/analyzers/__init__.py +0 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/analyzers/behavior.py +64 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/analyzers/calls.py +66 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/analyzers/imports.py +48 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/analyzers/inheritance.py +69 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/analyzers/symbols.py +181 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/analyzers/tests.py +43 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/cli.py +253 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/config.py +116 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/diff.py +397 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/discovery.py +38 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/generators/__init__.py +48 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/generators/base.py +226 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/generators/markdown.py +28 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/generators/mdx.py +28 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/git.py +336 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/history.py +109 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/indexer.py +430 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/models.py +437 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/navigation.py +581 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/project_detection.py +319 -0
- agentic_pydoc-0.1.0/src/agentic_pydoc/storage.py +414 -0
- agentic_pydoc-0.1.0/tests/test_analyzers.py +71 -0
- agentic_pydoc-0.1.0/tests/test_config_and_discovery.py +29 -0
- agentic_pydoc-0.1.0/tests/test_diff.py +348 -0
- agentic_pydoc-0.1.0/tests/test_history.py +223 -0
- agentic_pydoc-0.1.0/tests/test_incremental_indexing.py +164 -0
- agentic_pydoc-0.1.0/tests/test_indexer_and_generators.py +41 -0
- agentic_pydoc-0.1.0/tests/test_knowledge_model.py +235 -0
- agentic_pydoc-0.1.0/tests/test_markdown_output.py +155 -0
- agentic_pydoc-0.1.0/tests/test_models.py +22 -0
- agentic_pydoc-0.1.0/tests/test_navigation.py +194 -0
- agentic_pydoc-0.1.0/tests/test_packaging_cli.py +46 -0
- agentic_pydoc-0.1.0/tests/test_project_detection.py +64 -0
- agentic_pydoc-0.1.0/tests/test_rendering.py +459 -0
- agentic_pydoc-0.1.0/tests/test_storage.py +192 -0
- agentic_pydoc-0.1.0/tests_functions/test_behavior.py +17 -0
- agentic_pydoc-0.1.0/tests_functions/test_call.py +17 -0
- agentic_pydoc-0.1.0/tests_functions/test_config.py +7 -0
- agentic_pydoc-0.1.0/tests_functions/test_discovery.py +23 -0
- agentic_pydoc-0.1.0/tests_functions/test_imports.py +11 -0
- agentic_pydoc-0.1.0/tests_functions/test_index.py +14 -0
- agentic_pydoc-0.1.0/tests_functions/test_project_detection.py +6 -0
- agentic_pydoc-0.1.0/tests_functions/test_render.py +24 -0
- agentic_pydoc-0.1.0/tests_functions/test_symbols.py +20 -0
- agentic_pydoc-0.1.0/uv.lock +255 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
3.14
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
## Agent skills
|
|
2
|
+
|
|
3
|
+
### Issue tracker
|
|
4
|
+
|
|
5
|
+
Issues live as markdown files under `.scratch/<feature>/`. See `docs/agents/issue-tracker.md`.
|
|
6
|
+
|
|
7
|
+
### Domain docs
|
|
8
|
+
|
|
9
|
+
This repository uses a single-context layout with `CONTEXT.md` and `docs/adr/`. See `docs/agents/domain.md`.
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# Context
|
|
2
|
+
|
|
3
|
+
## Vocabulary
|
|
4
|
+
|
|
5
|
+
- **Project root**: the directory whose metadata and source layout are being inspected.
|
|
6
|
+
- **Source root**: a directory placed on the import path that contains Python packages or modules.
|
|
7
|
+
- **Detected root**: a source root together with the evidence, confidence, and relative path produced by discovery.
|
|
8
|
+
- **Filesystem heuristic**: a fallback observation of Python structure on disk, used when packaging metadata is insufficient.
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: agentic-pydoc
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: Python codebase intelligence and documentation for AI agents.
|
|
5
|
+
License: MIT
|
|
6
|
+
Requires-Python: >=3.13
|
|
7
|
+
Requires-Dist: pydantic>=2.13.4
|
|
8
|
+
Requires-Dist: typer>=0.16.0
|
|
9
|
+
Description-Content-Type: text/markdown
|
|
10
|
+
|
|
11
|
+
# agentic-pydoc
|
|
12
|
+
|
|
13
|
+
Static Python codebase intelligence and documentation for AI agents.
|
|
14
|
+
|
|
15
|
+
## Installation
|
|
16
|
+
|
|
17
|
+
Requires Python 3.13+.
|
|
18
|
+
|
|
19
|
+
Install as an isolated tool (recommended):
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
uv tool install agentic-pydoc
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
Or with pipx:
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
python -m pip install --user pipx
|
|
29
|
+
python -m pipx ensurepath
|
|
30
|
+
pipx install agentic-pydoc
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
Then verify the install from any directory:
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
agentic-pydoc --help
|
|
37
|
+
agentic-pydoc --version
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## Development
|
|
41
|
+
|
|
42
|
+
Contributors clone the repository and sync the environment instead:
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
git clone <repository-url>
|
|
46
|
+
cd agentic-pydoc
|
|
47
|
+
uv sync
|
|
48
|
+
uv run agentic-pydoc --help
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## Commands
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
uv run agentic-pydoc scan
|
|
55
|
+
uv run agentic-pydoc update
|
|
56
|
+
uv run agentic-pydoc check
|
|
57
|
+
uv run agentic-pydoc history
|
|
58
|
+
uv run agentic-pydoc show sql_model.repositories.base.BaseRepository
|
|
59
|
+
uv run agentic-pydoc callers sql_model.repositories.base.BaseRepository.create
|
|
60
|
+
uv run agentic-pydoc callees sql_model.repositories.base.BaseRepository.create
|
|
61
|
+
uv run agentic-pydoc deps sql_model.repositories.base.BaseRepository
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
The tool generates `docs/reference/index.json` and MDX pages under
|
|
65
|
+
`docs/reference/`.
|
|
66
|
+
|
|
67
|
+
See the complete [API reference](docs/API_REFERENCE.md) for the CLI,
|
|
68
|
+
configuration, Python models, analyzers, index schema, and generators.
|
|
69
|
+
|
|
70
|
+
See [incremental indexing architecture](docs/incremental-indexing.md) for scan
|
|
71
|
+
baselines, Git updates, persistence, cache, and static-analysis limits.
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# agentic-pydoc
|
|
2
|
+
|
|
3
|
+
Static Python codebase intelligence and documentation for AI agents.
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
Requires Python 3.13+.
|
|
8
|
+
|
|
9
|
+
Install as an isolated tool (recommended):
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
uv tool install agentic-pydoc
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Or with pipx:
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
python -m pip install --user pipx
|
|
19
|
+
python -m pipx ensurepath
|
|
20
|
+
pipx install agentic-pydoc
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Then verify the install from any directory:
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
agentic-pydoc --help
|
|
27
|
+
agentic-pydoc --version
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## Development
|
|
31
|
+
|
|
32
|
+
Contributors clone the repository and sync the environment instead:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
git clone <repository-url>
|
|
36
|
+
cd agentic-pydoc
|
|
37
|
+
uv sync
|
|
38
|
+
uv run agentic-pydoc --help
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
## Commands
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
uv run agentic-pydoc scan
|
|
45
|
+
uv run agentic-pydoc update
|
|
46
|
+
uv run agentic-pydoc check
|
|
47
|
+
uv run agentic-pydoc history
|
|
48
|
+
uv run agentic-pydoc show sql_model.repositories.base.BaseRepository
|
|
49
|
+
uv run agentic-pydoc callers sql_model.repositories.base.BaseRepository.create
|
|
50
|
+
uv run agentic-pydoc callees sql_model.repositories.base.BaseRepository.create
|
|
51
|
+
uv run agentic-pydoc deps sql_model.repositories.base.BaseRepository
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
The tool generates `docs/reference/index.json` and MDX pages under
|
|
55
|
+
`docs/reference/`.
|
|
56
|
+
|
|
57
|
+
See the complete [API reference](docs/API_REFERENCE.md) for the CLI,
|
|
58
|
+
configuration, Python models, analyzers, index schema, and generators.
|
|
59
|
+
|
|
60
|
+
See [incremental indexing architecture](docs/incremental-indexing.md) for scan
|
|
61
|
+
baselines, Git updates, persistence, cache, and static-analysis limits.
|