Version: 0.0.96
Some python basic helpers for git.
- Status Compatibility
- Api Reference
- Tests
- Code Quality
- Versioning
- Changelog
- Migration Notes
- Roadmap
- Security
- Privacy
- Support
- Contribution Guidelines
- Maintainers
- License
- Useful Links
- Suite Integration
- Compatibility Matrix
- Dependencies
- Suite Signature
Maturity: Production-ready
Python Support: >=3.10
OS Support: Linux, macOS, Windows
Status: Actively maintained
Full API documentation is available in the source code docstrings.
Key modules and classes are documented with type hints for better IDE support.
This project uses pytest for testing and pytest-cov for code coverage analysis.
First, install the required testing dependencies:
.venv/bin/python -m pip install pytest pytest-covRun all tests with coverage:
.venv/bin/python -m pytest --cov --cov-report=html# 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-missingAfter generating an HTML report, open htmlcov/index.html in your browser to view detailed line-by-line coverage information.
To enforce a minimum coverage percentage:
.venv/bin/python -m pytest --cov=your_module --cov-fail-under=80This will cause the test suite to fail if coverage drops below 80%.
All the suite packages follow strict quality standards:
- Type hints: Full type coverage with mypy validation
- Code formatting: Enforced with black and isort
- Linting: Comprehensive checks with custom scripts and tools
- Testing: High test coverage requirements
These standards ensure reliability and maintainability across the suite.
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.
See CHANGELOG.md for detailed version history and release notes.
Major changes are documented with migration guides when applicable.
When upgrading between major versions, refer to the migration guides in the documentation.
Breaking changes are clearly documented with upgrade paths and examples.
Current limitations and planned features are tracked in the GitHub issues.
See the project roadmap for upcoming features and improvements.
If you discover a security vulnerability, please email contact@wexample.com.
Do not open public issues for security vulnerabilities.
We take security seriously and will respond promptly to verified reports.
This package does not collect any telemetry or usage data.
Your privacy is respected — no data is transmitted to external services.
- GitHub Issues: Bug reports and feature requests
- GitHub Discussions: Questions and community support
- Documentation: Comprehensive guides and API reference
- Email: contact@wexample.com for general inquiries
Community support is available through GitHub Discussions.
We welcome contributions to the Wexample suite!
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- Submit a pull request
Maintained by the Wexample team and community contributors.
See CONTRIBUTORS.md for the full list of contributors.
This project is licensed under the MIT License - see the LICENSE file for details.
Free to use in both personal and commercial projects.
- Homepage: https://github.com/wexample/python-helpers-git
- Documentation: 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/wexample-helpers-git
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.
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 for the complete package ecosystem.
This package is part of the Wexample suite and is compatible with other suite packages.
Refer to each package's documentation for specific version compatibility requirements.
- attrs: >=23.1.0
- cattrs: >=23.1.0
- gitpython:
- wexample-helpers: ==0.0.88
Wexample 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.