Metadata-Version: 2.4
Name: aerofs
Version: 4.0.7
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
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 :: Rust
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Framework :: AsyncIO
Requires-Dist: pytest>=7.0 ; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21 ; extra == 'dev'
Requires-Dist: pytest-cov>=4.0 ; extra == 'dev'
Provides-Extra: dev
License-File: LICENSE
Summary: High-Performance Asynchronous File I/O for Python, powered by Rust
Keywords: async,file,io,rust,tokio,performance
Author-email: ohmyarthur <cp@hylcyn.xyz>
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Project-URL: Homepage, https://github.com/ohmyarthur/aerofs
Project-URL: Repository, https://github.com/ohmyarthur/aerofs
Project-URL: Issues, https://github.com/ohmyarthur/aerofs/issues

# aerofs

<div align="center">
  <p><strong>High-Performance Asynchronous File I/O for Python</strong></p>
  <p>Powered by Rust, Tokio, and PyO3.</p>

  <p>
    <a href="https://pypi.org/project/aerofs/"><img src="https://img.shields.io/pypi/v/aerofs.svg" alt="PyPI"></a>
    <a href="https://github.com/ohmyarthur/aerofs/actions"><img src="https://github.com/ohmyarthur/aerofs/workflows/Release/badge.svg" alt="Release"></a>
    <a href="https://opensource.org/licenses/Apache-2.0"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License"></a>
  </p>
</div>

---

**aerofs** brings the power of Rust's asynchronous I/O to Python. By leveraging `tokio` and `PyO3`, it provides a non-blocking, thread-safe, and highly performant filesystem interface for `asyncio` applications.

> **Full documentation at the [Documentation Site](https://ohmyarthur.github.io/aerofs/).**

## Installation

```shell
pip install aerofs
```

## Quick Start
```python
import aerofs
import asyncio

async def main():
    async with aerofs.open('hello.txt', 'w') as f:
        await f.write('Hello via Rust!')

    async with aerofs.open('hello.txt', 'r') as f:
        print(await f.read())

if __name__ == "__main__":
    asyncio.run(main())
```

## Documentation

Guides and API references are available in the `docs/` directory or online:

- [Getting Started](https://ohmyarthur.github.io/aerofs/guide/getting-started.html)
- [File Operations](https://ohmyarthur.github.io/aerofs/guide/file-operations.html)

## License

Apache 2.0 License.

