gitpure 1.0.8__cp315-cp315-win_amd64.whl

gitpure/__init__.py

@@ -0,0 +1,5 @@
+from .gitpure import *
+
+__doc__ = gitpure.__doc__
+if hasattr(gitpure, "__all__"):
+    __all__ = gitpure.__all__

gitpure/__init__.pyi

@@ -0,0 +1,109 @@
+"""
+Type stubs for gitpure - A pure git Python module implemented in Rust.
+"""
+
+from pathlib import Path
+from typing import Type
+
+
+class Commit:
+    """Lightweight representation of a git commit."""
+
+    @property
+    def hexsha(self) -> str:
+        """Hexadecimal object id of the commit."""
+        ...
+
+
+class Head:
+    """A named reference to a commit, mirroring GitPython's Head."""
+
+    @property
+    def name(self) -> str:
+        """The short name of the head (branch)."""
+        ...
+
+    @property
+    def commit(self) -> Commit | None:
+        """The commit the head points to, if available."""
+        ...
+
+
+class Tag:
+    """A tag reference with optional peeled commit."""
+
+    @property
+    def name(self) -> str:
+        """The short name of the tag."""
+        ...
+
+    @property
+    def commit(self) -> Commit | None:
+        """The commit the tag ultimately refers to, if available."""
+        ...
+
+class Repo:
+    """A git repository wrapper using gix (gitoxide)."""
+
+    @property
+    def git_dir(self) -> Path:
+        """
+        Path to the .git directory of the repository.
+
+        Returns:
+            The absolute path to the .git directory as a pathlib.Path object
+        """
+        ...
+
+    @property
+    def branches(self) -> list[Head]:
+        """Return all local branches as Head objects."""
+        ...
+
+    @property
+    def working_tree_dir(self) -> Path | None:
+        """Return the working tree directory of the repository, if it exists."""
+        ...
+
+    @property
+    def is_bare(self) -> bool:
+        """Whether the repository is bare (has no working tree)."""
+        ...
+
+    @property
+    def active_branch(self) -> Head | None:
+        """Current active branch as a Head object, if available."""
+        ...
+
+    @property
+    def head(self) -> Head | None:
+        """HEAD reference as a Head object, if available."""
+        ...
+
+    @property
+    def heads(self) -> list[Head]:
+        """Return all local heads (branches) in the repository."""
+        ...
+
+    @property
+    def tags(self) -> list[Tag]:
+        """Return all tags in the repository."""
+        ...
+
+    @classmethod
+    def clone_from(cls: Type["Repo"], url: str, to_path: str, bare: bool = False) -> "Repo":
+        """
+        Clone a repository from a URL to a local path.
+
+        Args:
+            url: The URL of the repository to clone
+            to_path: The local path where the repository should be cloned
+            bare: Whether to create a bare repository (default: False)
+
+        Returns:
+            A new Repo instance representing the cloned repository
+
+        Raises:
+            RuntimeError: If the clone operation fails
+        """
+        ...

gitpure-1.0.8.dist-info/METADATA

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: gitpure
+Version: 1.0.8
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Version Control
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Typing :: Typed
+Requires-Dist: pytest ; extra == 'test'
+Requires-Dist: gitpython>=3.1 ; extra == 'test'
+Provides-Extra: test
+License-File: LICENSE
+Summary: A Python git library implemented in Rust using gitoxide
+Keywords: git,python,rust,gitoxide,version-control
+Home-Page: https://github.com/cmeister2/gitpure
+Author-email: Max Dymond <cmeister2@gmail.com>
+Maintainer-email: Max Dymond <cmeister2@gmail.com>
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Bug Reports, https://github.com/cmeister2/gitpure/issues
+Project-URL: Documentation, https://github.com/cmeister2/gitpure
+Project-URL: Homepage, https://github.com/cmeister2/gitpure
+Project-URL: Repository, https://github.com/cmeister2/gitpure
+Project-URL: Source Code, https://github.com/cmeister2/gitpure
+
+# gitpure
+
+[![CI](https://github.com/cmeister2/gitpure/actions/workflows/CI.yml/badge.svg)](https://github.com/cmeister2/gitpure/actions/workflows/CI.yml)
+[![PyPI version](https://badge.fury.io/py/gitpure.svg)](https://badge.fury.io/py/gitpure)
+[![Python versions](https://img.shields.io/pypi/pyversions/gitpure.svg)](https://pypi.org/project/gitpure/)
+
+A pure git Python library implemented in Rust using [gitoxide](https://github.com/Byron/gitoxide). This library provides fast and memory-efficient git operations through Python bindings.
+
+## Features
+
+- **Fast**: Built with Rust and gitoxide for optimal performance
+- **Memory efficient**: Leverages Rust's memory management
+- **Cross-platform**: Works on Linux, macOS, and Windows
+- **Pure Python interface**: Easy to use Python API
+- **Safe**: Thread-safe operations with Rust's ownership model
+
+## Installation
+
+Install from PyPI:
+
+```bash
+pip install gitpure
+```
+
+## Quick Start
+
+```python
+import gitpure
+
+# Clone a repository (with worktree)
+repo = gitpure.Repo.clone_from("https://github.com/user/repo.git", "/path/to/local/repo")
+
+# Clone a bare repository
+bare_repo = gitpure.Repo.clone_from("https://github.com/user/repo.git", "/path/to/bare/repo", bare=True)
+
+# Get the git directory path
+git_dir = repo.git_dir
+print(f"Git directory: {git_dir}")
+```
+
+## Development
+
+### Prerequisites
+
+- Python 3.8+
+- Rust 1.70+
+- maturin
+
+### Building from Source
+
+```bash
+# Clone the repository
+git clone https://github.com/cmeister2/gitpure.git
+cd gitpure
+
+# Create a virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+# Install maturin
+pip install maturin
+
+# Build and install in development mode
+maturin develop
+
+# Or build wheel
+maturin build --release
+```
+
+### Running Tests
+
+```bash
+# Install test dependencies
+pip install pytest
+
+# Run tests
+pytest tests/
+```
+
+## Release process
+
+Releases are fully automated with [semantic-release](https://semantic-release.gitbook.io/). The pipeline will:
+
+1. Inspect the commit history on `main` using Conventional Commits to determine the next semantic version.
+2. Prepare the Rust crate, using the next version (or a dev version if available).
+3. Build wheels and source distributions with `maturin` and attach them to the GitHub release.
+4. Publish the distribution artifacts to PyPI.
+
+To keep releases working you must:
+
+- Continue to write commits that follow the Conventional Commits specification (`feat:`, `fix:`, etc.).
+
+You can trigger a release by merging changes into `main`.
+
+## Architecture
+
+gitpure is built on top of:
+
+- **[gitoxide](https://github.com/Byron/gitoxide)**: A pure Rust implementation of git
+- **[PyO3](https://github.com/PyO3/pyo3)**: Python bindings for Rust
+- **[maturin](https://github.com/PyO3/maturin)**: Build tool for Python extensions written in Rust
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
+
+### Development Setup
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes
+4. Add tests for your changes
+5. Ensure all tests pass (`pytest`)
+6. Commit your changes (`git commit -m 'Add some amazing feature'`)
+7. Push to the branch (`git push origin feature/amazing-feature`)
+8. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+

gitpure-1.0.8.dist-info/RECORD

@@ -0,0 +1,9 @@
+gitpure/__init__.py,sha256=pBX_EzrNHWBjqJHS3q15EG7uggKwK8bhi32dp_4klIM,111
+gitpure/__init__.pyi,sha256=cBiocFctPS_yhSJvWZWgHe4b6j8SpEmnmz1glQyUt-0,2801
+gitpure/gitpure.cp315-win_amd64.pyd,sha256=qdv736bZASd0fK0AJ8xcWcUfyZaN2PI3OjllSQaDO2c,10696704
+gitpure/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gitpure-1.0.8.dist-info/METADATA,sha256=i_QFZZjQH3ofBbDt-ck0mB0ebsvHwssPaIeAz2OEkSo,5424
+gitpure-1.0.8.dist-info/WHEEL,sha256=1_h6kx0k2_JFDbRzyfVOsGEcPlSNf1uBTnmW3MNufiU,97
+gitpure-1.0.8.dist-info/licenses/LICENSE,sha256=SIJEt25LmxzShXdFNpvEiVhLAyVzfsdiRMhNU3U8DNo,1086
+gitpure-1.0.8.dist-info/sboms/gitpure.cyclonedx.json,sha256=p4uG6vJ_NER0QCNn96ZemuzidrBjPdpFweIycGs2V2o,300973
+gitpure-1.0.8.dist-info/RECORD,,

gitpure-1.0.8.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.15.0)
+Root-Is-Purelib: false
+Tag: cp315-cp315-win_amd64

gitpure-1.0.8.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Max Dymond
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.