Metadata-Version: 2.4
Name: one-ring-core
Version: 0.2.1
Summary: Low-level io_uring wrapper for Python: ring management, IO operations, and typed results
Project-URL: Homepage, https://github.com/otto-sellerstam/one-ring
Project-URL: Repository, https://github.com/otto-sellerstam/one-ring
Project-URL: Issues, https://github.com/otto-sellerstam/one-ring/issues
Author-email: Otto Sellerstam <ottosellerstam@gmail.com>
License: MIT
Keywords: async,io,io_uring,linux
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: System :: Networking
Classifier: Typing :: Typed
Requires-Python: >=3.14
Requires-Dist: structlog>=24.0
Description-Content-Type: text/markdown

# one-ring-core

Low-level [io_uring](https://kernel.dk/io_uring.pdf) wrapper for Python.

Part of the [one-ring](https://github.com/otto-sellerstam/one-ring) project.

## What it provides

- **Ring management** - initialize, submit, and consume io_uring submission/completion queues
- **Typed IO operations** - file open/read/write/close, socket create/bind/listen/accept/send/recv, timeouts
- **Result types** - structured completion events with user data, result codes, and flags

## Requirements

- **Linux** with `io_uring` support (kernel 6.7+ for full socket support)
- **Python 3.14+**

## Installation

```bash
uv add one-ring-core
```

## License

MIT
