Skip to main content

RepoRamp logo

RepoRamp

Python Codebase Intelligence
Scan. Understand. Improve.

PyPI version Python versions MIT license

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 modules
    • QR002: modules with many internal dependencies
    • QR003: 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.

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)

Source distribution for reporamp 0.1.1
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)

Table of built distributions (wheels) for reporamp 0.1.1
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page