python-code-graph 0.1.2

Generate code graphs for Python projects

Python Code Graph Generator

Generate comprehensive code graphs for Python projects. This tool analyzes your Python codebase and creates a detailed JSON representation of its structure, dependencies, and relationships.

Features

• 📊 Creates detailed code graphs for Python projects
• 🔍 Analyzes functions, classes, variables, and imports
• ⚡ Parallel processing for large codebases
• 💾 Caching for improved performance
• 🧩 Similar format to JavaScript/TypeScript code-graph-generator

Installation

pip install python-code-graph

Quick Start

from python_code_graph import create_code_graph

code_graph = create_code_graph(
    directory_path=".Path/to/my_project",
    output_json_path="output.json"
)

CLI USES

Basic options

python-code-graph /path/to/your/project -o output.json

Advance Options

python-code-graph [-h] [-o OUTPUT] [-n NAME] [-c CONCURRENCY] [-e EXCLUDE] [--no-cache] [--cache-dir CACHE_DIR] [-d] directory

Arguments:

directory: Directory containing Python files to analyze -o, --output: Output JSON file path (default: [project_name]_code_graph.json) -n, --name: Project name (default: directory name) -c, --concurrency: Number of parallel workers (default: 4) -e, --exclude: Patterns to exclude (can be specified multiple times) --no-cache: Disable caching --cache-dir: Directory to store cache files -d, --debug: Enable debug logging

Output Format

{
  "name": "project-name",
  "packages": [
    {
      "name": "package-name",
      "files": [
        {
          "path": "file/path.py",
          "types": [...],
          "variables": [...],
          "functions": [
            {
              "name": "function_name",
              "referencedIn": ["file/path.py"],
              "fileName": "path.py",
              "startLine": 10,
              "length": 5,
              "dependencies": [...],
              "types": [],
              "callsTo": ["other_function"]
            }
          ],
          "dependencies": [...],
          "exports": [...],
          "detailedDependencies": [...]
        }
      ],
      "dependencies": [],
      "exports": []
    }
  ]
}

More on Responce Format

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.