Skip to main content

AI-powered Git patch assistant with HTML report generation.

Project description

PatchMind Banner

🧠 PatchMind

Run PatchMind Report PyPI - Version License: Apache-2.0 GitHub stars


PatchMind is a modular Python CLI tool for Git repositories that generates smart, visual HTML reports.
It captures patch-level diffs, tree views, file history timelines, risk scoring, and more — all locally.

No cloud. No bloat. Just clean insight.


🚀 Key Features

  • 🔍 Detects file-level and line-level changes across commits
  • 🌳 Tree-based visualization of modified paths
  • 📅 File timeline view with authorship and metadata
  • ⚠️ Risk and impact scoring per file
  • 👤 Inline blame summaries
  • 📄 Clean, standalone HTML output
  • ⚙️ Fully CLI-driven — automate in CI/CD

📸 Sample Output

PatchMind HTML Report Sample


📦 Installation

Install from PyPI:

pip install patchmind

Or install manually:

git clone https://github.com/Darkstar420/patchmind.git
cd patchmind
pip install -r requirements.txt

🧪 Usage

Generate an HTML report from the root of any Git repo:

python cli/main.py --report

The output will be saved as patchmind_report.html in the project root.


📂 Project Layout

patchmind/
├── cli/               # CLI entrypoint
├── core/              # Core analysis engine
├── tests/             # Unit tests
├── docs/              # Sample reports and images
├── config.yaml        # Config (optional)
├── requirements.txt
└── README.md

🧪 Run Tests

pytest -q

Unit tests live in tests/ and validate key functionality, including mock Git data and report rendering.


💡 Why Use PatchMind?

✅ No setup required – run it instantly ✅ See what's changing, where, and why ✅ Stay ahead of technical debt ✅ Built for devs who want insight — not overhead


📄 License

Licensed under the Apache 2.0 License — free to use, modify, and distribute.


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

patchmind-0.1.5.tar.gz (1.7 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

patchmind-0.1.5-py3-none-any.whl (16.2 kB view details)

Uploaded Python 3

File details

Details for the file patchmind-0.1.5.tar.gz.

File metadata

  • Download URL: patchmind-0.1.5.tar.gz
  • Upload date:
  • Size: 1.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for patchmind-0.1.5.tar.gz
Algorithm Hash digest
SHA256 c48c6138be969178e7c5c19fb91359eaba9e4470415a30c084225d5356e55de0
MD5 6f10ba23ea46da4d456ed690bdfb16ea
BLAKE2b-256 ddd55864e227a96410df6c7eebb143253136a028fae54b51836a294a997eeb2b

See more details on using hashes here.

Provenance

The following attestation bundles were made for patchmind-0.1.5.tar.gz:

Publisher: publish.yml on Darkstar420/patchmind

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file patchmind-0.1.5-py3-none-any.whl.

File metadata

  • Download URL: patchmind-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 16.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for patchmind-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 ea0cf5957eb04b078484550ef1df931b389fea208614ea6adc2dfe29ec4c727f
MD5 57c4881bb624bd974adf4707034e91fe
BLAKE2b-256 28bc5eaf4edaede6549959ecd78cbc3a163082d47919fe6fb4e5019e699f8556

See more details on using hashes here.

Provenance

The following attestation bundles were made for patchmind-0.1.5-py3-none-any.whl:

Publisher: publish.yml on Darkstar420/patchmind

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page