QGit - Quick Git Operations
QGit is a powerful Git operations automation tool that provides enhanced Git workflow management, repository visualization, and security scanning capabilities.
Requirements
System Requirements
- Python 3.13.2
- Git 2.20 or higher
- OpenGL support (for visualization features)
- SQLite 3.x (included with Python)
Platform Support
- Linux (Primary support)
- macOS (Full support with platform-specific optimizations)
- Windows (Basic support)
Hardware Requirements
- Minimum 4GB RAM
- OpenGL-capable graphics card for visualization features
- 100MB free disk space
Installation
Option 1: Using setup.py (Recommended)
- Clone the repository:
git clone https://github.com/griffincancode/qgit.git
cd qgit
- Install using setup.py:
python setup.py install
This will:
- Install all required dependencies
- Set up the QGit environment
- Create system-wide executable links
- Configure Git integration
- Set up logging and cache directories
Option 2: Manual Installation
- Clone the repository:
git clone https://github.com/griffincancode/qgit.git
cd qgit
- Create and activate a virtual environment:
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
- Install dependencies:
pip install -r requirements.txt
Optional Dependencies
For enhanced features, install optional dependencies:
pip install "pillow>=10.1.0,<11.0.0" "rich>=13.7.0,<14.0.0" "tqdm>=4.66.1,<5.0.0"
Development Setup
For development work, install additional tools:
pip install -r requirements.txt
pip install "black>=23.11.0,<24.0.0" "flake8>=6.1.0,<7.0.0" "mypy>=1.7.0,<2.0.0" "isort>=5.12.0,<6.0.0" "pytest>=7.4.3,<8.0.0" "pytest-asyncio>=0.23.0,<1.0.0" "pytest-cov>=4.1.0,<5.0.0"
Platform-Specific Notes
macOS
On macOS, you might need to:
- Install XQuartz for OpenGL support: https://www.xquartz.org
- Use
--userflag during installation:
python setup.py install --user
Linux
Ensure OpenGL development libraries are installed:
# Ubuntu/Debian
sudo apt-get install python3-opengl
# Fedora
sudo dnf install python3-opengl
Windows
On Windows:
- Ensure you have the latest graphics drivers installed
- Install Visual C++ Build Tools if required
- Consider using Windows Subsystem for Linux (WSL) for best experience
Troubleshooting
If you encounter OpenGL-related issues:
- Update your graphics drivers
- Ensure OpenGL support is properly installed
- Try running in a different terminal
- On macOS, restart your machine after installing XQuartz
For other issues, check the logs in:
- Linux/macOS:
~/.qgit/logs/ - Windows:
%USERPROFILE%\.qgit\logs\
License
This project is licensed under the MIT License - see the LICENSE file for details.
Metadata
Release files for qgit 1.1.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| qgit-1.1.5.tar.gz | 109.9 kB | Without provenance | Details for qgit-1.1.5.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| qgit-1.1.5-py3-none-any.whl | Python 3 | none | any | Details for qgit-1.1.5-py3-none-any.whl |
Total release size: 222.4 kB
Release files / qgit-1.1.5.tar.gz
| Download URL | qgit-1.1.5.tar.gz |
|---|---|
| Size | 109.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0c9307da81ef5c653c0234b1ce684633ddeb0c8f5f6be1f5dfe7040231a63f8f
|
|
BLAKE2b-256 checksum How to use checksums |
c72f19411a0fcd6f437e8475699bcf9d84408b4a7f8a8e07742272d76824148d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.0
|
Release files / qgit-1.1.5-py3-none-any.whl
| Download URL | qgit-1.1.5-py3-none-any.whl |
|---|---|
| Size | 112.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
40c00d1f1206b410659e92f86761ec63090596e72ba0a212d033a26917008d57
|
|
BLAKE2b-256 checksum How to use checksums |
1d5380205d72a28b5fccee5b70a3affc4b73fc378c65dc31267355990ccf6cd6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.0
|
Security for qgit 1.1.5
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.