RepoRamp
Python Codebase Intelligence
Scan. Understand. Improve.
RepoRamp is a command-line tool that helps developers understand the structure of a Python codebase. It scans Python modules, maps internal imports, detects dependency cycles, flags selected code-quality issues, and generates Markdown and JSON reports.
Features
- Python module discovery — scans Python files while excluding common virtual environments, caches, and build directories.
- Import and dependency analysis — identifies relationships between modules in a project.
- Circular dependency detection — reports dependency cycles in the internal module graph.
- Code-quality checks — reports selected structural issues:
QR001: empty modulesQR002: modules with many internal dependenciesQR003: dependency cycles
- Markdown and JSON reports — keep a human-readable architecture overview and machine-readable analysis output.
- Command-line interface — run the analyzer from the project you want to inspect.
Installation
Requires Python 3.10 or newer.
python -m pip install reporamp
Quick start
Open a terminal in the Python project you want to analyze, then run:
cd path/to/your-project
reporamp analyze .
To choose an output location:
reporamp analyze . --output reporamp-report
See all supported options:
reporamp analyze --help
Check the installed version:
reporamp version
RepoRamp generates Markdown and JSON architecture reports. Use the Markdown report for a quick overview and the JSON report for tooling or further analysis.
Example report
An analysis report can include:
- Number of Python modules analyzed
- Internal dependency count
- Standard-library and third-party imports
- Unresolved imports
- Dependency cycles
- Module imports, classes, and functions
- Code-quality findings and suggestions
Quality rules
| Rule | What it checks |
|---|---|
QR001 |
Empty Python modules |
QR002 |
Modules with more outgoing internal dependencies than the configured threshold |
QR003 |
Circular dependencies in the module graph |
These checks are structural signals to help guide code review; they do not replace tests, linting, or human judgment.
Development
Clone the repository and install the project in editable mode with its development dependencies:
git clone https://github.com/launchforgedev/Repo-Ramp.git
cd Repo-Ramp
python -m pip install -e ".[dev]"
Run the tests:
pytest
Current scope
RepoRamp currently focuses on static structural analysis of Python projects. AI-powered analysis is not part of the current release.
Contributing
Issues, bug reports, and pull requests are welcome. Please include a clear description of the change and tests for new behavior where practical.
License
RepoRamp is released under the MIT License. See LICENSE.
Links
Metadata
Release files for reporamp 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| reporamp-0.1.1.tar.gz | 707.7 kB | Without provenance | Details for reporamp-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| reporamp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for reporamp-0.1.1-py3-none-any.whl |
Total release size: 721.0 kB
Release files / reporamp-0.1.1.tar.gz
| Download URL | reporamp-0.1.1.tar.gz |
|---|---|
| Size | 707.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
74b14961683cbeeca5e1ff338610414915e6dd575dfabdb39369329faf633b6c
|
|
BLAKE2b-256 checksum How to use checksums |
804702b11bda5b1d6476004b00847dee215103171748ddb1c329949e0ed9400c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.0
|
Release files / reporamp-0.1.1-py3-none-any.whl
| Download URL | reporamp-0.1.1-py3-none-any.whl |
|---|---|
| Size | 13.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f6606d5e4bcffb85793198bb4f9c4179f48757d5ee27f2c15372a32749b9a4d3
|
|
BLAKE2b-256 checksum How to use checksums |
cad2a5f879811032def6db6c7153d3d2d2d112a40239ae7c8ff67e7edd90a247
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.0
|
Security for reporamp 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.