wexample-helpers-git 0.2.0__tar.gz → 6.1.0__tar.gz

{wexample_helpers_git-0.2.0 → wexample_helpers_git-6.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-helpers-git
-Version: 0.2.0
+Version: 6.1.0
 Summary: Some python basic helpers for git.
 Author-Email: weeger <contact@wexample.com>
 License: MIT
@@ -12,7 +12,7 @@ Requires-Python: >=3.10
 Requires-Dist: attrs>=23.1.0
 Requires-Dist: cattrs>=23.1.0
 Requires-Dist: gitpython
-Requires-Dist: wexample-helpers>=2.0.0
+Requires-Dist: wexample-helpers>=6.7.0
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
@@ -20,6 +20,127 @@ Description-Content-Type: text/markdown
 
 # helpers_git
 
+Version: 6.1.0
+
+Some python basic helpers for git.
+
+## Table of Contents
+
+- [Tests](#tests)
+- [Suite Integration](#suite-integration)
+- [Dependencies](#dependencies)
+- [Versioning](#versioning)
+- [License](#license)
+- [Suite Integration](#suite-integration)
+- [Suite Signature](#suite-signature)
+- [Introduction](#introduction)
+- [Roadmap](#roadmap)
+- [Status Compatibility](#status-compatibility)
+- [Useful Links](#useful-links)
+- [Migration Notes](#migration-notes)
+
+## Tests
+
+This project uses `pytest` for testing and `pytest-cov` for code coverage analysis.
+
+### Installation
+
+First, install the required testing dependencies:
+```bash
+.venv/bin/python -m pip install pytest pytest-cov
+```
+
+### Basic Usage
+
+Run all tests with coverage:
+```bash
+.venv/bin/python -m pytest --cov --cov-report=html
+```
+
+### Common Commands
+```bash
+# Run tests with coverage for a specific module
+.venv/bin/python -m pytest --cov=your_module
+
+# Show which lines are not covered
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing
+
+# Generate an HTML coverage report
+.venv/bin/python -m pytest --cov=your_module --cov-report=html
+
+# Combine terminal and HTML reports
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing --cov-report=html
+
+# Run specific test file with coverage
+.venv/bin/python -m pytest tests/test_file.py --cov=your_module --cov-report=term-missing
+```
+
+### Viewing HTML Reports
+
+After generating an HTML report, open `htmlcov/index.html` in your browser to view detailed line-by-line coverage information.
+
+### Coverage Threshold
+
+To enforce a minimum coverage percentage:
+```bash
+.venv/bin/python -m pytest --cov=your_module --cov-fail-under=80
+```
+
+This will cause the test suite to fail if coverage drops below 80%.
+
+## Integration in the Suite
+
+This package is part of the Wexample Suite — a collection of high-quality, modular tools designed to work seamlessly together across multiple languages and environments.
+
+### Related Packages
+
+The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
+
+Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
+
+## Dependencies
+
+- attrs: >=23.1.0
+- cattrs: >=23.1.0
+- gitpython: 
+- wexample-helpers: >=6.7.0
+
+## Versioning & Compatibility Policy
+
+Wexample packages follow **Semantic Versioning** (SemVer):
+
+- **MAJOR**: Breaking changes
+- **MINOR**: New features, backward compatible
+- **PATCH**: Bug fixes, backward compatible
+
+We maintain backward compatibility within major versions and provide clear migration guides for breaking changes.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+Free to use in both personal and commercial projects.
+
+## Integration in the Suite
+
+This package is part of the Wexample Suite — a collection of high-quality, modular tools designed to work seamlessly together across multiple languages and environments.
+
+### Related Packages
+
+The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
+
+Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
+
+# About us
+
+[Wexample](https://wexample.com) stands as a cornerstone of the digital ecosystem — a collective of seasoned engineers, researchers, and creators driven by a relentless pursuit of technological excellence. More than a media platform, it has grown into a vibrant community where innovation meets craftsmanship, and where every line of code reflects a commitment to clarity, durability, and shared intelligence.
+
+This packages suite embodies this spirit. Trusted by professionals and enthusiasts alike, it delivers a consistent, high-quality foundation for modern development — open, elegant, and battle-tested. Its reputation is built on years of collaboration, refinement, and rigorous attention to detail, making it a natural choice for those who demand both robustness and beauty in their tools.
+
+Wexample cultivates a culture of mastery. Each package, each contribution carries the mark of a community that values precision, ethics, and innovation — a community proud to shape the future of digital craftsmanship.
+
+# helpers_git
+
 Version: 0.2.0
 
 Some python basic helpers for git.
@@ -170,3 +291,33 @@ See the [project roadmap](https://github.com/wexample/python-helpers_git/issues)
 When upgrading between major versions, refer to the migration guides in the documentation.
 
 Breaking changes are clearly documented with upgrade paths and examples.
+
+## Known Limitations & Roadmap
+
+Current limitations and planned features are tracked in the GitHub issues.
+
+See the [project roadmap](https://github.com/wexample/python-helpers_git/issues) for upcoming features and improvements.
+
+## Status & Compatibility
+
+**Maturity**: Production-ready
+
+**Python Support**: >=3.10
+
+**OS Support**: Linux, macOS, Windows
+
+**Status**: Actively maintained
+
+## Useful Links
+
+- **Homepage**: https://github.com/wexample/python-helpers-git
+- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
+- **Issue Tracker**: https://github.com/wexample/python-helpers-git/issues
+- **Discussions**: https://github.com/wexample/python-helpers-git/discussions
+- **PyPI**: [pypi.org/project/helpers_git](https://pypi.org/project/helpers_git/)
+
+## Migration Notes
+
+When upgrading between major versions, refer to the migration guides in the documentation.
+
+Breaking changes are clearly documented with upgrade paths and examples.

{wexample_helpers_git-0.2.0 → wexample_helpers_git-6.1.0}/README.md

@@ -1,5 +1,126 @@
 # helpers_git
 
+Version: 6.1.0
+
+Some python basic helpers for git.
+
+## Table of Contents
+
+- [Tests](#tests)
+- [Suite Integration](#suite-integration)
+- [Dependencies](#dependencies)
+- [Versioning](#versioning)
+- [License](#license)
+- [Suite Integration](#suite-integration)
+- [Suite Signature](#suite-signature)
+- [Introduction](#introduction)
+- [Roadmap](#roadmap)
+- [Status Compatibility](#status-compatibility)
+- [Useful Links](#useful-links)
+- [Migration Notes](#migration-notes)
+
+## Tests
+
+This project uses `pytest` for testing and `pytest-cov` for code coverage analysis.
+
+### Installation
+
+First, install the required testing dependencies:
+```bash
+.venv/bin/python -m pip install pytest pytest-cov
+```
+
+### Basic Usage
+
+Run all tests with coverage:
+```bash
+.venv/bin/python -m pytest --cov --cov-report=html
+```
+
+### Common Commands
+```bash
+# Run tests with coverage for a specific module
+.venv/bin/python -m pytest --cov=your_module
+
+# Show which lines are not covered
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing
+
+# Generate an HTML coverage report
+.venv/bin/python -m pytest --cov=your_module --cov-report=html
+
+# Combine terminal and HTML reports
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing --cov-report=html
+
+# Run specific test file with coverage
+.venv/bin/python -m pytest tests/test_file.py --cov=your_module --cov-report=term-missing
+```
+
+### Viewing HTML Reports
+
+After generating an HTML report, open `htmlcov/index.html` in your browser to view detailed line-by-line coverage information.
+
+### Coverage Threshold
+
+To enforce a minimum coverage percentage:
+```bash
+.venv/bin/python -m pytest --cov=your_module --cov-fail-under=80
+```
+
+This will cause the test suite to fail if coverage drops below 80%.
+
+## Integration in the Suite
+
+This package is part of the Wexample Suite — a collection of high-quality, modular tools designed to work seamlessly together across multiple languages and environments.
+
+### Related Packages
+
+The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
+
+Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
+
+## Dependencies
+
+- attrs: >=23.1.0
+- cattrs: >=23.1.0
+- gitpython: 
+- wexample-helpers: >=6.7.0
+
+## Versioning & Compatibility Policy
+
+Wexample packages follow **Semantic Versioning** (SemVer):
+
+- **MAJOR**: Breaking changes
+- **MINOR**: New features, backward compatible
+- **PATCH**: Bug fixes, backward compatible
+
+We maintain backward compatibility within major versions and provide clear migration guides for breaking changes.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+Free to use in both personal and commercial projects.
+
+## Integration in the Suite
+
+This package is part of the Wexample Suite — a collection of high-quality, modular tools designed to work seamlessly together across multiple languages and environments.
+
+### Related Packages
+
+The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
+
+Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
+
+# About us
+
+[Wexample](https://wexample.com) stands as a cornerstone of the digital ecosystem — a collective of seasoned engineers, researchers, and creators driven by a relentless pursuit of technological excellence. More than a media platform, it has grown into a vibrant community where innovation meets craftsmanship, and where every line of code reflects a commitment to clarity, durability, and shared intelligence.
+
+This packages suite embodies this spirit. Trusted by professionals and enthusiasts alike, it delivers a consistent, high-quality foundation for modern development — open, elegant, and battle-tested. Its reputation is built on years of collaboration, refinement, and rigorous attention to detail, making it a natural choice for those who demand both robustness and beauty in their tools.
+
+Wexample cultivates a culture of mastery. Each package, each contribution carries the mark of a community that values precision, ethics, and innovation — a community proud to shape the future of digital craftsmanship.
+
+# helpers_git
+
 Version: 0.2.0
 
 Some python basic helpers for git.
@@ -150,3 +271,33 @@ See the [project roadmap](https://github.com/wexample/python-helpers_git/issues)
 When upgrading between major versions, refer to the migration guides in the documentation.
 
 Breaking changes are clearly documented with upgrade paths and examples.
+
+## Known Limitations & Roadmap
+
+Current limitations and planned features are tracked in the GitHub issues.
+
+See the [project roadmap](https://github.com/wexample/python-helpers_git/issues) for upcoming features and improvements.
+
+## Status & Compatibility
+
+**Maturity**: Production-ready
+
+**Python Support**: >=3.10
+
+**OS Support**: Linux, macOS, Windows
+
+**Status**: Actively maintained
+
+## Useful Links
+
+- **Homepage**: https://github.com/wexample/python-helpers-git
+- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
+- **Issue Tracker**: https://github.com/wexample/python-helpers-git/issues
+- **Discussions**: https://github.com/wexample/python-helpers-git/discussions
+- **PyPI**: [pypi.org/project/helpers_git](https://pypi.org/project/helpers_git/)
+
+## Migration Notes
+
+When upgrading between major versions, refer to the migration guides in the documentation.
+
+Breaking changes are clearly documented with upgrade paths and examples.

{wexample_helpers_git-0.2.0 → wexample_helpers_git-6.1.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-helpers-git"
-version = "0.2.0"
+version = "6.1.0"
 description = "Some python basic helpers for git."
 authors = [
     { name = "weeger", email = "contact@wexample.com" },
@@ -21,7 +21,7 @@ dependencies = [
     "attrs>=23.1.0",
     "cattrs>=23.1.0",
     "gitpython",
-    "wexample-helpers>=2.0.0",
+    "wexample-helpers>=6.7.0",
 ]
 
 [project.readme]

{wexample_helpers_git-0.2.0 → wexample_helpers_git-6.1.0}/src/wexample_helpers_git/helpers/git.py

@@ -77,7 +77,6 @@ def git_ensure_upstream(
     Returns the upstream (e.g., "origin/main").
     """
     from wexample_helpers.helpers.file import file_resolve_path
-    from wexample_helpers.helpers.shell import shell_run
 
     cwd_resolved = file_resolve_path(cwd)
     branch = git_current_branch(cwd=cwd_resolved, inherit_stdio=False)
@@ -96,8 +95,8 @@ def git_ensure_upstream(
             upstream = f"{default_remote}/{branch}"
         except Exception:
             # Remote branch likely does not exist yet; create it and set upstream in one go.
-            shell_run(
-                ["git", "push", "-u", default_remote, branch],
+            git_run(
+                ["push", "-u", default_remote, branch],
                 inherit_stdio=inherit_stdio,
                 cwd=cwd_resolved,
                 retries=3,
@@ -235,10 +234,9 @@ def git_pull_rebase_autostash(
 ) -> None:
     """Pull latest changes with rebase and autostash to preserve local modifications."""
     from wexample_helpers.helpers.file import file_resolve_path
-    from wexample_helpers.helpers.shell import shell_run
 
-    shell_run(
-        ["git", "pull", "--rebase", "--autostash"],
+    git_run(
+        ["pull", "--rebase", "--autostash"],
         inherit_stdio=inherit_stdio,
         cwd=file_resolve_path(cwd),
         retries=3,
@@ -336,10 +334,9 @@ def git_push_tag(
 ) -> ShellResult:
     """Push a specific tag to the remote."""
     from wexample_helpers.helpers.file import file_resolve_path
-    from wexample_helpers.helpers.shell import shell_run
 
-    return shell_run(
-        ["git", "push", (remote or "origin"), tag],
+    return git_run(
+        ["push", (remote or "origin"), tag],
         inherit_stdio=inherit_stdio,
         cwd=file_resolve_path(cwd),
         retries=3,
@@ -378,7 +375,7 @@ def git_set_upstream(
             "git",
             "branch",
             "--set-upstream-to",
-            f"{(remote or "origin")}/{branch}",
+            f"{(remote or 'origin')}/{branch}",
             branch,
         ],
         inherit_stdio=inherit_stdio,