codexp

CodeXP (Code Explorer)

A CLI tool to analyze Python packages and visualize their structure and dependencies in the terminal.

Features

• Package Structure Analysis 📦

  • Identifies entry points
  • Lists all modules in the package
  • Shows top-level symbols and their definitions

• Dependency Analysis 🔍

  • Maps internal imports between package modules
  • Tracks external package dependencies
  • Shows import locations with source code context

• Symbol Usage Tracking 🎯

  • Traces both internal and external symbol usage
  • Shows where symbols are defined and used
  • Provides source code context for each usage

• Flexible Output 📊

  • Rich terminal visualization with syntax highlighting
  • JSON output for programmatic analysis

Installation

pip install codexp

Usage

codexp <source_directory> [options]

Arguments:
  source_directory    Directory containing source code to analyze

Options:
  --no-line-info, -n    Hide file and line information
  --json, -j           Output results in JSON format
  --help               Show help message and exit

Examples

# Analyze current directory with visual output
codexp .

# Analyze without line information
codexp ./my_package --no-line-info

# Get JSON output for programmatic use
codexp ./my_package --json > analysis.json

The default output provides a rich terminal visualization with syntax highlighting and tree-style formatting. For programmatic analysis, use the --json flag to get structured data output.

License

MIT License - see the LICENSE file for details.