fastar 0.2.0__cp312-cp312-macosx_11_0_arm64.whl

fastar/__init__.py

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

fastar/__init__.pyi

@@ -0,0 +1,128 @@
+from typing import Literal, overload
+from typing_extensions import Self
+from pathlib import Path
+from os import PathLike
+
+class ArchiveWriter:
+    """A tar archive writer that supports compressed and uncompressed formats."""
+
+    @classmethod
+    def open(
+        cls, path: str | Path | PathLike[str], mode: Literal["w", "w:gz"] = "w:gz"
+    ) -> Self:
+        """
+        Open a tar archive for writing.
+
+        Args:
+            path: Path to the archive file to create
+            mode: Write mode - 'w' for uncompressed, 'w:gz' for gzip compressed (default)
+
+        Returns:
+            An ArchiveWriter instance
+
+        Raises:
+            RuntimeError: If an unsupported mode is provided
+        """
+
+    def add(
+        self,
+        path: str | Path | PathLike[str],
+        arcname: str | None = None,
+        recursive: bool = True,
+        dereference: bool = False,
+    ) -> None:
+        """
+        Add a file or directory to the archive.
+
+        Args:
+            path: Path to the file or directory to add
+            arcname: Name to use in the archive (defaults to the filename)
+            recursive: If True and path is a directory, add all contents recursively
+            dereference: If True, add the target of symlinks instead of the symlink itself
+
+        Raises:
+            RuntimeError: If the archive is closed or the path doesn't exist
+        """
+
+    def close(self) -> None:
+        """
+        Close the archive and flush all pending writes.
+
+        Raises:
+            RuntimeError: If there's an error flushing the writer
+        """
+
+    def __enter__(self) -> Self:
+        """Enter the context manager."""
+
+    def __exit__(self, exc_type, exc_value, traceback) -> bool:
+        """Exit the context manager, closing the archive."""
+
+class ArchiveReader:
+    """A tar archive reader that supports compressed and uncompressed formats."""
+
+    @classmethod
+    def open(
+        cls, path: str | Path | PathLike[str], mode: Literal["r", "r:gz"] = "r:gz"
+    ) -> Self:
+        """
+        Open a tar archive for reading.
+
+        Args:
+            path: Path to the archive file to read
+            mode: Read mode - 'r' for uncompressed, 'r:gz' for gzip compressed (default)
+
+        Returns:
+            An ArchiveReader instance
+
+        Raises:
+            RuntimeError: If an unsupported mode is provided
+            IOError: If the file cannot be opened
+        """
+
+    def extract(self, to: str | Path | PathLike[str]) -> None:
+        """
+        Extract all contents of the archive to the specified directory.
+
+        Args:
+            to: Destination directory path
+
+        Raises:
+            RuntimeError: If the archive is closed
+            IOError: If extraction fails
+        """
+
+    def close(self) -> None:
+        """Close the archive."""
+
+    def __enter__(self) -> Self:
+        """Enter the context manager."""
+
+    def __exit__(self, exc_type, exc_value, traceback) -> bool:
+        """Exit the context manager, closing the archive."""
+
+@overload
+def open(path: str | Path | PathLike[str], mode: Literal["w", "w:gz"]) -> ArchiveWriter:
+    """
+    Open a tar archive for writing.
+
+    Args:
+        path: Path to the archive file to create
+        mode: Write mode - 'w' for uncompressed, 'w:gz' for gzip compressed
+
+    Returns:
+        An ArchiveWriter instance
+    """
+
+@overload
+def open(path: str | Path | PathLike[str], mode: Literal["r", "r:gz"]) -> ArchiveReader:
+    """
+    Open a tar archive for reading.
+
+    Args:
+        path: Path to the archive file to read
+        mode: Read mode - 'r' for uncompressed, 'r:gz' for gzip compressed
+
+    Returns:
+        An ArchiveReader instance
+    """

fastar-0.2.0.dist-info/METADATA

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: fastar
+Version: 0.2.0
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+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 :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+License-File: LICENSE
+Summary: High-level bindings for the Rust tar crate
+Author-email: Jonathan Ehwald <github@ehwald.info>
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: homepage, https://github.com/DoctorJohn/fastar
+Project-URL: repository, https://github.com/DoctorJohn/fastar
+Project-URL: documentation, https://github.com/DoctorJohn/fastar
+
+# Fastar
+
+[![Versions][versions-image]][versions-url]
+[![PyPI][pypi-image]][pypi-url]
+[![Downloads][downloads-image]][downloads-url]
+[![License][license-image]][license-url]
+
+[versions-image]: https://img.shields.io/pypi/pyversions/fastar
+[versions-url]: https://github.com/DoctorJohn/fastar/blob/main/pyproject.toml
+[pypi-image]: https://img.shields.io/pypi/v/fastar
+[pypi-url]: https://pypi.org/project/fastar/
+[downloads-image]: https://img.shields.io/pypi/dm/fastar
+[downloads-url]: https://pypi.org/project/fastar/
+[license-image]: https://img.shields.io/pypi/l/fastar
+[license-url]: https://github.com/DoctorJohn/fastar/blob/main/LICENSE
+
+High-level bindings for the Rust [tar](https://crates.io/crates/tar) crate.
+
+## Installation
+
+```sh
+pip install fastar
+```
+
+## Usage
+
+```python
+import fastar
+from pathlib import Path
+
+
+some_file = Path('file.txt')
+some_file.write_text('Hello, Fastar!')
+
+
+with fastar.open('archive.tar', 'w') as archive:
+    archive.add(some_file)
+
+
+with fastar.open('archive.tar', 'r') as archive:
+    archive.extract(Path("extracted/"))
+
+
+extracted_file = Path('extracted/file.txt')
+print(extracted_file.read_text())  # Hello, Fastar!
+```
+
+## Development
+
+1. Install dependencies into a virtual env: `uv sync`
+2. Make changes to the code and tests
+3. Build the package: `uv run maturin develop`
+4. Run the tests: `uv run pytest`
+

fastar-0.2.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+fastar-0.2.0.dist-info/METADATA,sha256=wo4Mqaa5FAdt40s7FyalyHOcd5F4RKWhx0R5G9gE_7o,2637
+fastar-0.2.0.dist-info/WHEEL,sha256=nw13728gRokCivwI6SCanennWBgDOflh2lHvovMwAi8,104
+fastar-0.2.0.dist-info/licenses/LICENSE,sha256=rYGQpMiiUoV5IPve_SRv0E-Ci8BMj0TaNs5jSu3d6xo,1054
+fastar/__init__.py,sha256=mU2iZJ--coorw9PWKBK1JbU9C_N5EqCZQ-b7YvPFBWw,107
+fastar/__init__.pyi,sha256=DWpgf68qq1JbG8AmYn7FTkvyawIF1oVloZ5UhrQZ1Zw,3677
+fastar/fastar.cpython-312-darwin.so,sha256=UU_yLeX4q4A2Obt4ahfI6YFa1teSAWmbcKHQC_FJIZs,837184
+fastar/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fastar-0.2.0.dist-info/RECORD,,

fastar-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.9.6)
+Root-Is-Purelib: false
+Tag: cp312-cp312-macosx_11_0_arm64

fastar-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 Jonathan Ehwald
+
+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.