Skip to content

Generate Obsidian-style markdown documentation from any Python project. Explore your codebase as a knowledge graph.

License

Notifications You must be signed in to change notification settings

divengine/pyvault

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Divengine Python Vault

PyPI version Downloads Downloads MIT licensed

pyvault is a Python-powered documentation generator that transforms any Python project into a structured Obsidian vault.

It extracts all classes, functions, and modules, maps their relationships, and builds a fully browseable knowledge graph of the codebase.

PyVault Screenshot


Features

  • Parses your Python project using Python’s ast module
  • Extracts:
    • 📦 Modules (.py files)
    • 🧩 Functions and methods
    • 🏷️ Classes (including inheritance, methods, and properties)
    • 🔗 Function calls between elements (uses)
  • Generates Markdown files for all entities, with proper nesting
  • Preserves the original folder structure
  • Uses Obsidian-style [[wiki links]] to interconnect everything

Obsidian Graph Example

Usage

Option 1: Clone and run

git clone https://github.com/divengine/pyvault.git
cd pyvault
python divengine/pyvault/core.py /your_project/ /vault_output/

Option 2: Install via pip

pip install divengine-pyvault
pyvault /your_project/ /vault_output/

To make sure you always get the latest version, use:

pip install --upgrade divengine-pyvault

Output Example

After running, the tool generates an Obsidian vault like this:

vault_output/
├── module_a.md
├── module_b/
│   ├── imports.md
│   └── MyClass/
│       ├── method_one.md
│       └── method_two.md

Each .md file includes:

  • File or object name
  • Location in the source project
  • Extracted arguments
  • Docstrings (if any)
  • Relationships (uses, inheritance, etc.)

License

MIT License © Divengine Software Solutions

About

Generate Obsidian-style markdown documentation from any Python project. Explore your codebase as a knowledge graph.

Resources

License

Stars

Watchers

Forks

Languages