Changed code to support older Python versions

2025-12-01 23:27:09 +01:00 · 2025-12-01 23:27:09 +01:00 · 582458cdd0
commit 582458cdd0
parent eb92d2d36f
5027 changed files with 794942 additions and 4 deletions
--- a/venv/lib/python3.11/site-packages/fastar-0.8.0.dist-info/METADATA
+++ b/venv/lib/python3.11/site-packages/fastar-0.8.0.dist-info/METADATA
@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: fastar
+Version: 0.8.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.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 :: 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.8
+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]
+[![CodSpeed][codspeed-image]][codspeed-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://pypistats.org/packages/fastar
+[license-image]: https://img.shields.io/pypi/l/fastar
+[license-url]: https://github.com/DoctorJohn/fastar/blob/main/LICENSE
+[codspeed-image]: https://img.shields.io/endpoint?url=https://codspeed.io/badge.json
+[codspeed-url]: https://codspeed.io/DoctorJohn/fastar
+
+The `fastar` library wraps the Rust [tar](https://crates.io/crates/tar), [flate2](https://crates.io/crates/flate2), and [zstd](https://crates.io/crates/zstd) crates, providing a high-performance way to work with compressed and uncompressed tar archives in Python.
+
+## Installation
+
+```sh
+pip install fastar
+```
+
+## Usage
+
+This section shows basic examples of how to create and extract tar archives using Fastar. For more usage examples, please refer directly to the test cases in the [tests](https://github.com/DoctorJohn/fastar/tree/main/tests) directory.
+
+```python
+import fastar
+from pathlib import Path
+
+
+input_file = Path("file.txt")
+input_file.write_text("Hello, Fastar!")
+
+
+with fastar.open("archive.tar", "w") as archive:
+    archive.append(input_file)
+
+
+with fastar.open("archive.tar", "r") as archive:
+    archive.unpack("output/")
+
+
+unpacked_file = Path("output/file.txt")
+print(unpacked_file.read_text())  # Hello, Fastar!
+```
+
+### Opening Modes
+
+The `fastar.open` method supports the following modes:
+
+| Mode          | Action        | Compression               |
+| ------------- | ------------- | ------------------------- |
+| `"w"`         | Write         | None                      |
+| `"w:gz"`      | Write         | Gzip                      |
+| `"w:zst"`     | Write         | Zstandard                 |
+| `"r"`         | Read          | Automatically detected    |
+| `"r:"`        | Read          | None                      |
+| `"r:gz"`      | Read          | Gzip                      |
+| `"r:zst"`     | Read          | Zstandard                 |
+
+## 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`
+