inspackage 0.1.1

Useful tool for general inspection about some python package.

📦 Inspackage

Inspackage is a CLI tool designed to inspect Python packages with ease. It provides an interactive, hierarchical tree view of your project's structure, allowing you to dive deep into files to visualize classes, methods, variables, and properties directly from your terminal.

Built with Typer and Textual.

---

✨ Features

• 🗂 Interactive Tree View: Navigate through folders and files using a rich TUI (Text User Interface).
• 🔍 Deep Inspection: Don't just stop at the file level. Inspect the internals of your Python files:
  • Classes & Constructors
  • Methods & Properties
  • Global Variables & Constants
• ⚡ Fast & Lightweight: optimized for quick navigation of large codebases.

🚀 Installation

You can install inspackage directly from PyPI:

pip install inspackage

💻 Usage

To inspect a package or directory, simply run the inspackage command followed by the path you want to analyze.

Basic Usage:

# Inspect the current directory
inspackage .

# Inspect the package on current venv
inspackage <package-name>

# Inspect a specific package path
inspackage --dir /path/to/python/project

The basic inspection runs on Interactive Mode, here you can

• Use the Arrow Keys to navigate the tree.
• Press Enter or Space to expand/collapse directories or file details.
• Press Q to quit or D to toggle display between dark/light mode.

Other ways to use this tool:

# Inspection printed as a static data on console
inspackage --static <package-name>

# Save inspection as a json file
inspackage --save <package-name>

# To check all comands
inspackage --help

🛠 Development

This project uses Poetry for dependency management and packaging.

# Clone the repository:
git clone [https://github.com/xslyr/inspackage.git](https://github.com/xslyr/inspackage.git)
cd inspackage

# Install dependencies:
poetry install

To Run locally use:

poetry run inspackage .

To run tasks, lint and ruff you can use pre-configured taskipy actions

task test
task lint
task ruff

🤝 Contributing

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

Fork the project

Create your feature branch (git checkout -b feature/AmazingFeature)

Commit your changes (git commit -m 'Add some AmazingFeature')

Push to the branch (git push origin feature/AmazingFeature)

Open a Pull Request

📄 License

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