Metadata-Version: 2.4
Name: jps-git-repo-utils
Version: 0.4.0
Summary: Collection of utility Pythhon scripts to manage code repositories.
Author-email: Jaideep Sundaram <jai.python3@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/jai-python3/jps-git-repo-utils
Project-URL: Repository, https://github.com/jai-python3/jps-git-repo-utils
Project-URL: Issues, https://github.com/jai-python3/jps-git-repo-utils/issues
Keywords: code-repository,git,gitflow,version-control
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.12.3
Requires-Dist: openpyxl~=3.1.5
Provides-Extra: dev
Requires-Dist: flake8<8.0.0,>=7.1.1; extra == "dev"
Requires-Dist: black==24.10.0; extra == "dev"
Requires-Dist: isort==5.13.2; extra == "dev"
Requires-Dist: mypy==1.13.0; extra == "dev"
Requires-Dist: pydocstyle==6.3.0; extra == "dev"
Requires-Dist: darglint==1.8.1; extra == "dev"
Requires-Dist: flake8-docstrings==1.7.0; extra == "dev"
Requires-Dist: bandit==1.7.10; extra == "dev"
Requires-Dist: vulture==2.11; extra == "dev"
Requires-Dist: autoflake==2.3.1; extra == "dev"
Requires-Dist: flynt==1.0.1; extra == "dev"
Requires-Dist: flake8-bugbear==24.8.19; extra == "dev"
Requires-Dist: flake8-comprehensions==3.15.0; extra == "dev"
Requires-Dist: flake8-simplify==0.21.0; extra == "dev"
Requires-Dist: pep8-naming==0.14.0; extra == "dev"
Requires-Dist: pytest==8.3.3; extra == "dev"
Requires-Dist: pytest-cov==5.0.0; extra == "dev"
Requires-Dist: pytest-git==1.8.0; extra == "dev"
Requires-Dist: build==1.2.2.post1; extra == "dev"
Requires-Dist: twine==5.1.1; extra == "dev"
Requires-Dist: pre-commit==4.0.1; extra == "dev"
Requires-Dist: codecov==2.1.13; extra == "dev"
Requires-Dist: pandas==2.2.3; extra == "dev"
Requires-Dist: openpyxl==3.1.5; extra == "dev"
Requires-Dist: bump-my-version>=1.0.1; extra == "dev"
Requires-Dist: git-changelog>=2.7.0; extra == "dev"
Dynamic: license-file

# jps-git-repo-utils

![Build](https://github.com/jai-python3/jps-git-repo-utils/actions/workflows/test.yml/badge.svg)
![Publish to PyPI](https://github.com/jai-python3/jps-git-repo-utils/actions/workflows/publish-to-pypi.yml/badge.svg)
[![codecov](https://codecov.io/gh/jai-python3/jps-git-repo-utils/branch/main/graph/badge.svg)](https://codecov.io/gh/jai-python3/jps-git-repo-utils)

---

## 🧭 Overview

**jps-git-repo-utils** is a collection of Python-based utility scripts designed to manage and standardize code repositories.  
These tools simplify common administrative tasks such as enforcing naming conventions, auditing branch
structures, generating repository history reports, and synchronizing version metadata.

### ✨ Key Features

- Automated enforcement of branch naming conventions (`feature/`, `bugfix/`, `hotfix/`, `release/`, etc.)
- Repository cleanup and archival of inactive branches
- Consistent versioning and repository metadata management
- Repository history generation with per-branch summaries and event classification
- Integration with Jira and CI/CD pipelines for reporting and audit purposes
- Robust testing framework using **pytest** with 100% reproducible local runs

---

## 🧩 Included Utilities

| Script | Description |
|--------|--------------|
| `standardize_branches.py` | Standardizes branch names, prefixes, and folders (feature, bugfix, hotfix, release). |
| `audit_repository.py` | Audits repository metadata, tags, and release consistency. |
| `repo_history.py` | Generates detailed repository history reports with per-branch summaries, tag events, and merge timelines. |

---

## 💻 Example Commands

```bash
# Standardize branch naming across a repo
python -m scripts.standardize_branches --repo /path/to/repository

# Generate a full repository history report
python -m scripts.repo_history --global-tags
```

To explore command options:

```bash
jps-git-repo-utils-standardize --help
jps-git-repo-utils-audit --help
jps-git-repo-utils-history --help
```

---

## ⚙️ Installation

```bash
make install
```

---

## 🧪 Development Workflow

```bash
make fix && make format && make lint
make test
```

## Recent Additions

- Comprehensive pytest suite for `repo_history.py`
- Dummy Git repository fixtures for isolated test execution
- 6 passing tests and 1 intentionally skipped (network-dependent)

---

## 📦 Packaging and Distribution

This project follows semantic versioning and uses GitHub Actions for continuous integration,  
PyPI publishing, and test coverage reporting via **Codecov**.

---

## 📜 License

MIT License © Jaideep Sundaram
