qgit


Nameqgit JSON
Version 1.0.7 PyPI version JSON
download
home_pageNone
SummaryA powerful Git operations automation tool that provides enhanced Git workflow management, repository visualization, and security scanning capabilities.
upload_time2025-03-20 14:24:54
maintainerNone
docs_urlNone
authorNone
requires_python>=3.12.0
licenseNone
keywords automation development git repository security tools visualization workflow
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 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)

1. Clone the repository:
```bash
git clone https://github.com/griffincancode/qgit.git
cd qgit
```

2. Install using setup.py:
```bash
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

1. Clone the repository:
```bash
git clone https://github.com/griffincancode/qgit.git
cd qgit
```

2. Create and activate a virtual environment:
```bash
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
```

3. Install dependencies:
```bash
pip install -r requirements.txt
```

### Optional Dependencies

For enhanced features, install optional dependencies:
```bash
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:
```bash
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:
1. Install XQuartz for OpenGL support: https://www.xquartz.org
2. Use `--user` flag during installation:
```bash
python setup.py install --user
```

### Linux

Ensure OpenGL development libraries are installed:
```bash
# Ubuntu/Debian
sudo apt-get install python3-opengl
# Fedora
sudo dnf install python3-opengl
```

### Windows

On Windows:
1. Ensure you have the latest graphics drivers installed
2. Install Visual C++ Build Tools if required
3. Consider using Windows Subsystem for Linux (WSL) for best experience

## Troubleshooting

If you encounter OpenGL-related issues:
1. Update your graphics drivers
2. Ensure OpenGL support is properly installed
3. Try running in a different terminal
4. 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. 
            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "qgit",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.12.0",
    "maintainer_email": "Griffin <griffin@griffin-code.com>",
    "keywords": "automation, development, git, repository, security, tools, visualization, workflow",
    "author": null,
    "author_email": "Griffin <griffin@griffin-code.com>",
    "download_url": "https://files.pythonhosted.org/packages/15/4a/d86f22d628761352f4ae5e6d746619e043c18e3a3ab1903703430c65b3d3/qgit-1.0.7.tar.gz",
    "platform": null,
    "description": "# QGit - Quick Git Operations\n\nQGit is a powerful Git operations automation tool that provides enhanced Git workflow management, repository visualization, and security scanning capabilities.\n\n## Requirements\n\n### System Requirements\n\n- Python 3.13.2\n- Git 2.20 or higher\n- OpenGL support (for visualization features)\n- SQLite 3.x (included with Python)\n\n### Platform Support\n\n- Linux (Primary support)\n- macOS (Full support with platform-specific optimizations)\n- Windows (Basic support)\n\n### Hardware Requirements\n\n- Minimum 4GB RAM\n- OpenGL-capable graphics card for visualization features\n- 100MB free disk space\n\n## Installation\n\n### Option 1: Using setup.py (Recommended)\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/griffincancode/qgit.git\ncd qgit\n```\n\n2. Install using setup.py:\n```bash\npython setup.py install\n```\n\nThis will:\n- Install all required dependencies\n- Set up the QGit environment\n- Create system-wide executable links\n- Configure Git integration\n- Set up logging and cache directories\n\n### Option 2: Manual Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/griffincancode/qgit.git\ncd qgit\n```\n\n2. Create and activate a virtual environment:\n```bash\npython -m venv venv\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\n```\n\n3. Install dependencies:\n```bash\npip install -r requirements.txt\n```\n\n### Optional Dependencies\n\nFor enhanced features, install optional dependencies:\n```bash\npip install \"pillow>=10.1.0,<11.0.0\" \"rich>=13.7.0,<14.0.0\" \"tqdm>=4.66.1,<5.0.0\"\n```\n\n## Development Setup\n\nFor development work, install additional tools:\n```bash\npip install -r requirements.txt\npip 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\"\n```\n\n## Platform-Specific Notes\n\n### macOS\n\nOn macOS, you might need to:\n1. Install XQuartz for OpenGL support: https://www.xquartz.org\n2. Use `--user` flag during installation:\n```bash\npython setup.py install --user\n```\n\n### Linux\n\nEnsure OpenGL development libraries are installed:\n```bash\n# Ubuntu/Debian\nsudo apt-get install python3-opengl\n# Fedora\nsudo dnf install python3-opengl\n```\n\n### Windows\n\nOn Windows:\n1. Ensure you have the latest graphics drivers installed\n2. Install Visual C++ Build Tools if required\n3. Consider using Windows Subsystem for Linux (WSL) for best experience\n\n## Troubleshooting\n\nIf you encounter OpenGL-related issues:\n1. Update your graphics drivers\n2. Ensure OpenGL support is properly installed\n3. Try running in a different terminal\n4. On macOS, restart your machine after installing XQuartz\n\nFor other issues, check the logs in:\n- Linux/macOS: `~/.qgit/logs/`\n- Windows: `%USERPROFILE%\\.qgit\\logs\\`\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details. ",
    "bugtrack_url": null,
    "license": null,
    "summary": "A powerful Git operations automation tool that provides enhanced Git workflow management, repository visualization, and security scanning capabilities.",
    "version": "1.0.7",
    "project_urls": {
        "Documentation": "https://github.com/griffincancode/qgit#readme",
        "Homepage": "https://github.com/griffincancode/qgit",
        "Issues": "https://github.com/griffincancode/qgit/issues",
        "Repository": "https://github.com/griffincancode/qgit.git"
    },
    "split_keywords": [
        "automation",
        " development",
        " git",
        " repository",
        " security",
        " tools",
        " visualization",
        " workflow"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "708c5426ebb81bbd2640ff62a78f1852339d00d86057de9a1763e801736e63ee",
                "md5": "27970ae734455af9b9731aeb7319ae90",
                "sha256": "2a1c4e424ec3dead24d8ed0700627aa6f6c1d80abdbc2a0d52b1b1f6408266a7"
            },
            "downloads": -1,
            "filename": "qgit-1.0.7-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "27970ae734455af9b9731aeb7319ae90",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.12.0",
            "size": 106880,
            "upload_time": "2025-03-20T14:24:53",
            "upload_time_iso_8601": "2025-03-20T14:24:53.430904Z",
            "url": "https://files.pythonhosted.org/packages/70/8c/5426ebb81bbd2640ff62a78f1852339d00d86057de9a1763e801736e63ee/qgit-1.0.7-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "154ad86f22d628761352f4ae5e6d746619e043c18e3a3ab1903703430c65b3d3",
                "md5": "d46a18eaf965b91c470bcdc95d91034c",
                "sha256": "94ab75e8aa0e600eb6ab22e40fbce65be96fc067a58ca252c47c4b70368aae10"
            },
            "downloads": -1,
            "filename": "qgit-1.0.7.tar.gz",
            "has_sig": false,
            "md5_digest": "d46a18eaf965b91c470bcdc95d91034c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.12.0",
            "size": 95681,
            "upload_time": "2025-03-20T14:24:54",
            "upload_time_iso_8601": "2025-03-20T14:24:54.913688Z",
            "url": "https://files.pythonhosted.org/packages/15/4a/d86f22d628761352f4ae5e6d746619e043c18e3a3ab1903703430c65b3d3/qgit-1.0.7.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-03-20 14:24:54",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "griffincancode",
    "github_project": "qgit#readme",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "qgit"
}
        
Elapsed time: 0.58927s