rsloop 0.1.5__tar.gz → 0.1.7__tar.gz

rsloop-0.1.7/.github/workflows/tests.yml

@@ -0,0 +1,58 @@
+name: Tests
+
+on:
+  workflow_dispatch:
+    inputs:
+      python_versions:
+        description: "Space-separated Python versions to test"
+        required: false
+        type: string
+      build_mode:
+        description: "Build profile to use with maturin develop"
+        required: true
+        default: release
+        type: choice
+        options:
+          - release
+          - debug
+
+permissions:
+  contents: read
+
+jobs:
+  test-supported-pythons:
+    name: supported-pythons
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Set up Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: 1.94.0
+
+      - name: Cache Cargo registry and target
+        uses: Swatinem/rust-cache@v2
+
+      - name: Run tests across supported Python versions
+        shell: bash
+        env:
+          RSLOOP_PYTHON_VERSIONS: ${{ inputs.python_versions }}
+        run: |
+          args=()
+          if [[ "${{ inputs.build_mode }}" == "debug" ]]; then
+            args+=(--debug)
+          fi
+          scripts/test-supported-pythons.sh "${args[@]}"

{rsloop-0.1.5 → rsloop-0.1.7}/Cargo.lock

@@ -374,7 +374,7 @@ dependencies = [
  "crossbeam-queue",
  "flume",
  "futures-util",
- "io-uring",
+ "io-uring 0.7.11",
  "io_uring_buf_ring",
  "libc",
  "once_cell",
@@ -878,6 +878,16 @@ dependencies = [
  "str_stack",
 ]
 
+[[package]]
+name = "io-uring"
+version = "0.6.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "595a0399f411a508feb2ec1e970a4a30c249351e30208960d58298de8660b0e5"
+dependencies = [
+ "bitflags 1.3.2",
+ "libc",
+]
+
 [[package]]
 name = "io-uring"
 version = "0.7.11"
@@ -896,7 +906,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1838759bb8c2f24cf05a35429d83145c4aa6af43f8ad38477295e12a7320a80e"
 dependencies = [
  "bytes",
- "io-uring",
+ "io-uring 0.7.11",
  "rustix",
 ]
 
@@ -1035,6 +1045,18 @@ dependencies = [
  "adler2",
 ]
 
+[[package]]
+name = "mio"
+version = "1.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a69bcab0ad47271a0234d9422b131806bf3968021e5dc9328caf2d4cd58557fc"
+dependencies = [
+ "libc",
+ "log",
+ "wasi",
+ "windows-sys 0.61.2",
+]
+
 [[package]]
 name = "nix"
 version = "0.26.4"
@@ -1090,6 +1112,12 @@ version = "1.21.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
 
+[[package]]
+name = "oneshot"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cfe21416a02c693fb9f980befcb230ecc70b0b3d1cc4abf88b9675c4c1457f0c"
+
 [[package]]
 name = "openssl-probe"
 version = "0.2.1"
@@ -1346,7 +1374,7 @@ dependencies = [
 
 [[package]]
 name = "rsloop"
-version = "0.1.5"
+version = "0.1.7"
 dependencies = [
  "async-std",
  "compio",
@@ -1362,6 +1390,8 @@ dependencies = [
  "rustls-pemfile",
  "signal-hook",
  "socket2",
+ "tokio",
+ "vibeio",
  "windows-sys 0.61.2",
 ]
 
@@ -1729,6 +1759,16 @@ dependencies = [
  "cfg-if",
 ]
 
+[[package]]
+name = "tokio"
+version = "1.50.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "27ad5e34374e03cfffefc301becb44e9dc3c17584f414349ebe29ed26661822d"
+dependencies = [
+ "bytes",
+ "pin-project-lite",
+]
+
 [[package]]
 name = "tracing"
 version = "0.1.44"
@@ -1824,6 +1864,23 @@ version = "0.9.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "0b928f33d975fc6ad9f86c8f283853ad26bdd5b10b7f1542aa2fa15e2289105a"
 
+[[package]]
+name = "vibeio"
+version = "0.2.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "78dce705a708cacdd5822824342a8843abcceb9619e7079dc0e97b77dcc4ce1c"
+dependencies = [
+ "crossbeam-queue",
+ "futures-util",
+ "io-uring 0.6.4",
+ "libc",
+ "mio",
+ "oneshot",
+ "slab",
+ "tokio",
+ "windows-sys 0.61.2",
+]
+
 [[package]]
 name = "wasi"
 version = "0.11.1+wasi-snapshot-preview1"

{rsloop-0.1.5 → rsloop-0.1.7}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "rsloop"
-version = "0.1.5"
+version = "0.1.7"
 edition = "2021"
 description = "An event loop for asyncio written in Rust"
 license = "Apache-2.0"
@@ -33,6 +33,8 @@ signal-hook = "0.4"
 socket2 = "0.6"
 
 [target.'cfg(windows)'.dependencies]
+tokio = { version = "1", default-features = false, features = ["io-util"] }
+vibeio = { version = "0.2.5", default-features = false }
 windows-sys = { version = "0.61", features = ["Win32_Foundation", "Win32_Networking_WinSock", "Win32_System_Pipes", "Win32_System_Threading"] }
 
 [build-dependencies]

{rsloop-0.1.5 → rsloop-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rsloop
-Version: 0.1.5
+Version: 0.1.7
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
@@ -23,7 +23,7 @@ License-File: LICENSE
 Summary: An event loop for asyncio written in Rust
 Keywords: asyncio,event-loop,pyo3,python,rust
 Home-Page: https://github.com/RustedBytes/rsloop
-Author: RustedBytes
+Author: Yehor Smoliakov <egorsmkv@gmail.com>
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
 Project-URL: Homepage, https://github.com/RustedBytes/rsloop
@@ -49,7 +49,7 @@ coroutines still run on the thread that calls `run_forever()` or
 The package exposes:
 
 - a native extension module at `rsloop._loop`
-- a Python wrapper in `python/rsloop/__init__.py`
+- a Python wrapper in [`python/rsloop/__init__.py`](./python/rsloop/__init__.py)
 - `rsloop.Loop`, `rsloop.new_event_loop()`, and `rsloop.run(...)`
 
 Repository metadata currently targets Python `>=3.8`. The packaged project now
@@ -100,7 +100,7 @@ finally:
 
 Importing `rsloop` also patches `asyncio.set_event_loop()` so Python 3.8 can
 accept an `rsloop.Loop` instance, matching the behavior exercised by
-`tests/test_run.py`.
+[`tests/test_run.py`](./tests/test_run.py).
 
 ## Verified Surface Area
 
@@ -177,8 +177,9 @@ The native fast-stream path is used only when:
 
 Otherwise `rsloop` falls back to the stdlib `asyncio.streams` helpers.
 
-The implementation lives in `src/fast_streams.rs` and is backed by the lower
-level transport code in `src/stream_transport.rs`.
+The implementation lives in [`src/fast_streams.rs`](./src/fast_streams.rs) and
+is backed by the lower level transport code in
+[`src/stream_transport.rs`](./src/stream_transport.rs).
 
 ## Runtime Model
 
@@ -197,29 +198,15 @@ model, but has not finished eliminating every helper thread yet.
 
 These gaps are visible in the current implementation.
 
-- Stream transport flow control is partial:
-  `pause_reading()` and `resume_reading()` work, but
-  `get_write_buffer_size()` returns `0`,
-  `get_write_buffer_limits()` returns `(0, 0)`, and
-  `set_write_buffer_limits()` is a no-op.
-- Several compatibility parameters are currently accepted only to preserve API
-  shape, not to provide full behavior:
-  `happy_eyeballs_delay`, `interleave`, `all_errors`,
-  `ssl_shutdown_timeout`, and
-  `shutdown_default_executor(timeout=...)`.
 - TLS uses a `rustls` backend with a narrower compatibility surface than
   CPython's OpenSSL-backed `ssl` module. In particular, encrypted private keys
   are not supported yet, and the fast-stream monkeypatch still falls back to
   stdlib helpers whenever `ssl` is enabled. TLS transport internals also still
   use helper-thread paths instead of the newer runtime-thread `compio` socket
   path.
-- Subprocess support is intentionally incomplete:
-  `preexec_fn` is unsupported, and text mode is rejected for
-  `asyncio.create_subprocess_exec()` /
-  `asyncio.create_subprocess_shell()` when using the stdlib subprocess stream
-  protocol.
-- Low-level subprocess transport APIs do support text decoding when used with a
-  custom subprocess protocol.
+- Subprocess support still has one notable gap:
+  `preexec_fn` remains unsupported because running arbitrary Python between
+  `fork()` and `exec()` is unsafe in this runtime model.
 - Unix-specific APIs remain Unix-specific:
   `create_unix_server`, `create_unix_connection`,
   `add_signal_handler`, `remove_signal_handler`.
@@ -253,9 +240,9 @@ Build release wheels into `dist/wheels`:
 scripts/build-wheels.sh
 ```
 
-That script currently defaults to CPython `3.8 3.9 3.10 3.11 3.12 3.13 3.14`
-plus free-threaded `3.14t`, and uses `uv python install` / `uv python find` to
-locate interpreters.
+[`scripts/build-wheels.sh`](./scripts/build-wheels.sh) currently defaults to
+CPython `3.8 3.9 3.10 3.11 3.12 3.13 3.14` plus free-threaded `3.14t`, and
+uses `uv python install` / `uv python find` to locate interpreters.
 
 ## Profiling
 
@@ -304,12 +291,19 @@ uv run python examples/04_unix_and_accepted_socket.py
 uv run python examples/05_pipes_signals_subprocesses.py
 ```
 
+Example files:
+[`examples/01_basics.py`](./examples/01_basics.py),
+[`examples/02_fd_and_sockets.py`](./examples/02_fd_and_sockets.py),
+[`examples/03_streams.py`](./examples/03_streams.py),
+[`examples/04_unix_and_accepted_socket.py`](./examples/04_unix_and_accepted_socket.py),
+[`examples/05_pipes_signals_subprocesses.py`](./examples/05_pipes_signals_subprocesses.py).
+
 The repository also includes:
 
-- `demo/fastapi_service.py` for running the same FastAPI app on stdlib
-  `asyncio`, `uvloop`, or `rsloop`
-- `benchmarks/compare_event_loops.py` for callback, task, and TCP stream
-  comparisons
+- [`demo/fastapi_service.py`](./demo/fastapi_service.py) for running the same
+  FastAPI app on stdlib `asyncio`, `uvloop`, or `rsloop`
+- [`benchmarks/compare_event_loops.py`](./benchmarks/compare_event_loops.py)
+  for callback, task, and TCP stream comparisons
 
 ## Benchmark
 
@@ -318,6 +312,42 @@ uv run --with maturin maturin develop --release
 uv run --with uvloop python benchmarks/compare_event_loops.py
 ```
 
-See `benchmarks/README.md` for workload details and extra flags, and
-`demo/README.md` for the FastAPI loop comparison demo.
+An example output from that script on Linux with CPython 3.14.0:
+
+```
+callbacks (200,000 ops)
+loop           median_s       best_s      ops_per_s   vs_fastest
+rsloop         0.041608     0.040585      4,806,807        1.00x
+uvloop         0.087539     0.086690      2,284,707        2.10x
+asyncio        0.229563     0.221348        871,222        5.52x
+
+tasks (50,000 ops)
+loop           median_s       best_s      ops_per_s   vs_fastest
+uvloop         0.084425     0.083497        592,239        1.00x
+rsloop         0.091845     0.090982        544,397        1.09x
+asyncio        0.138782     0.137716        360,276        1.64x
+tcp_streams mode: rsloop native fast streams
+
+tcp_streams (5,000 ops)
+loop           median_s       best_s      ops_per_s   vs_fastest
+rsloop         0.119483     0.118451         41,847        1.00x
+uvloop         0.119582     0.116446         41,812        1.00x
+asyncio        0.138408     0.134438         36,125        1.16x
+```
+
+See [`benchmarks/README.md`](./benchmarks/README.md) for workload details and
+extra flags, and [`demo/README.md`](./demo/README.md) for the FastAPI loop
+comparison demo.
+
+## Acknowledgements
+
+`rsloop` builds on the Python `asyncio` model and is implemented with
+[PyO3](https://pyo3.rs/) on the Rust side. The runtime and I/O work in the
+current implementation rely in part on
+[compio](https://github.com/compio-rs/compio).
+
+## License
+
+This project is licensed under the Apache License, Version 2.0. See
+[`LICENSE`](./LICENSE) for the full text.
 

{rsloop-0.1.5 → rsloop-0.1.7}/README.md

@@ -17,7 +17,7 @@ coroutines still run on the thread that calls `run_forever()` or
 The package exposes:
 
 - a native extension module at `rsloop._loop`
-- a Python wrapper in `python/rsloop/__init__.py`
+- a Python wrapper in [`python/rsloop/__init__.py`](./python/rsloop/__init__.py)
 - `rsloop.Loop`, `rsloop.new_event_loop()`, and `rsloop.run(...)`
 
 Repository metadata currently targets Python `>=3.8`. The packaged project now
@@ -68,7 +68,7 @@ finally:
 
 Importing `rsloop` also patches `asyncio.set_event_loop()` so Python 3.8 can
 accept an `rsloop.Loop` instance, matching the behavior exercised by
-`tests/test_run.py`.
+[`tests/test_run.py`](./tests/test_run.py).
 
 ## Verified Surface Area
 
@@ -145,8 +145,9 @@ The native fast-stream path is used only when:
 
 Otherwise `rsloop` falls back to the stdlib `asyncio.streams` helpers.
 
-The implementation lives in `src/fast_streams.rs` and is backed by the lower
-level transport code in `src/stream_transport.rs`.
+The implementation lives in [`src/fast_streams.rs`](./src/fast_streams.rs) and
+is backed by the lower level transport code in
+[`src/stream_transport.rs`](./src/stream_transport.rs).
 
 ## Runtime Model
 
@@ -165,29 +166,15 @@ model, but has not finished eliminating every helper thread yet.
 
 These gaps are visible in the current implementation.
 
-- Stream transport flow control is partial:
-  `pause_reading()` and `resume_reading()` work, but
-  `get_write_buffer_size()` returns `0`,
-  `get_write_buffer_limits()` returns `(0, 0)`, and
-  `set_write_buffer_limits()` is a no-op.
-- Several compatibility parameters are currently accepted only to preserve API
-  shape, not to provide full behavior:
-  `happy_eyeballs_delay`, `interleave`, `all_errors`,
-  `ssl_shutdown_timeout`, and
-  `shutdown_default_executor(timeout=...)`.
 - TLS uses a `rustls` backend with a narrower compatibility surface than
   CPython's OpenSSL-backed `ssl` module. In particular, encrypted private keys
   are not supported yet, and the fast-stream monkeypatch still falls back to
   stdlib helpers whenever `ssl` is enabled. TLS transport internals also still
   use helper-thread paths instead of the newer runtime-thread `compio` socket
   path.
-- Subprocess support is intentionally incomplete:
-  `preexec_fn` is unsupported, and text mode is rejected for
-  `asyncio.create_subprocess_exec()` /
-  `asyncio.create_subprocess_shell()` when using the stdlib subprocess stream
-  protocol.
-- Low-level subprocess transport APIs do support text decoding when used with a
-  custom subprocess protocol.
+- Subprocess support still has one notable gap:
+  `preexec_fn` remains unsupported because running arbitrary Python between
+  `fork()` and `exec()` is unsafe in this runtime model.
 - Unix-specific APIs remain Unix-specific:
   `create_unix_server`, `create_unix_connection`,
   `add_signal_handler`, `remove_signal_handler`.
@@ -221,9 +208,9 @@ Build release wheels into `dist/wheels`:
 scripts/build-wheels.sh
 ```
 
-That script currently defaults to CPython `3.8 3.9 3.10 3.11 3.12 3.13 3.14`
-plus free-threaded `3.14t`, and uses `uv python install` / `uv python find` to
-locate interpreters.
+[`scripts/build-wheels.sh`](./scripts/build-wheels.sh) currently defaults to
+CPython `3.8 3.9 3.10 3.11 3.12 3.13 3.14` plus free-threaded `3.14t`, and
+uses `uv python install` / `uv python find` to locate interpreters.
 
 ## Profiling
 
@@ -272,12 +259,19 @@ uv run python examples/04_unix_and_accepted_socket.py
 uv run python examples/05_pipes_signals_subprocesses.py
 ```
 
+Example files:
+[`examples/01_basics.py`](./examples/01_basics.py),
+[`examples/02_fd_and_sockets.py`](./examples/02_fd_and_sockets.py),
+[`examples/03_streams.py`](./examples/03_streams.py),
+[`examples/04_unix_and_accepted_socket.py`](./examples/04_unix_and_accepted_socket.py),
+[`examples/05_pipes_signals_subprocesses.py`](./examples/05_pipes_signals_subprocesses.py).
+
 The repository also includes:
 
-- `demo/fastapi_service.py` for running the same FastAPI app on stdlib
-  `asyncio`, `uvloop`, or `rsloop`
-- `benchmarks/compare_event_loops.py` for callback, task, and TCP stream
-  comparisons
+- [`demo/fastapi_service.py`](./demo/fastapi_service.py) for running the same
+  FastAPI app on stdlib `asyncio`, `uvloop`, or `rsloop`
+- [`benchmarks/compare_event_loops.py`](./benchmarks/compare_event_loops.py)
+  for callback, task, and TCP stream comparisons
 
 ## Benchmark
 
@@ -286,5 +280,41 @@ uv run --with maturin maturin develop --release
 uv run --with uvloop python benchmarks/compare_event_loops.py
 ```
 
-See `benchmarks/README.md` for workload details and extra flags, and
-`demo/README.md` for the FastAPI loop comparison demo.
+An example output from that script on Linux with CPython 3.14.0:
+
+```
+callbacks (200,000 ops)
+loop           median_s       best_s      ops_per_s   vs_fastest
+rsloop         0.041608     0.040585      4,806,807        1.00x
+uvloop         0.087539     0.086690      2,284,707        2.10x
+asyncio        0.229563     0.221348        871,222        5.52x
+
+tasks (50,000 ops)
+loop           median_s       best_s      ops_per_s   vs_fastest
+uvloop         0.084425     0.083497        592,239        1.00x
+rsloop         0.091845     0.090982        544,397        1.09x
+asyncio        0.138782     0.137716        360,276        1.64x
+tcp_streams mode: rsloop native fast streams
+
+tcp_streams (5,000 ops)
+loop           median_s       best_s      ops_per_s   vs_fastest
+rsloop         0.119483     0.118451         41,847        1.00x
+uvloop         0.119582     0.116446         41,812        1.00x
+asyncio        0.138408     0.134438         36,125        1.16x
+```
+
+See [`benchmarks/README.md`](./benchmarks/README.md) for workload details and
+extra flags, and [`demo/README.md`](./demo/README.md) for the FastAPI loop
+comparison demo.
+
+## Acknowledgements
+
+`rsloop` builds on the Python `asyncio` model and is implemented with
+[PyO3](https://pyo3.rs/) on the Rust side. The runtime and I/O work in the
+current implementation rely in part on
+[compio](https://github.com/compio-rs/compio).
+
+## License
+
+This project is licensed under the Apache License, Version 2.0. See
+[`LICENSE`](./LICENSE) for the full text.

{rsloop-0.1.5 → rsloop-0.1.7}/benchmarks/README.md

@@ -13,6 +13,8 @@ uv run --with maturin maturin develop --release
 uv run --with uvloop python benchmarks/compare_event_loops.py
 ```
 
+Benchmark runner: [`benchmarks/compare_event_loops.py`](./compare_event_loops.py)
+
 The Rust prototype should be installed in release mode before benchmarking.
 Using the default debug build will heavily skew the comparison against
 `asyncio` and `uvloop`.
@@ -42,7 +44,7 @@ uv run --with uvloop python benchmarks/compare_event_loops.py \
 ```
 
 This writes one SVG per workload, such as
-`benchmarks/profiles/rsloop-callbacks.svg`, before the warmup and measured
+[`benchmarks/profiles/rsloop-callbacks.svg`](./profiles/rsloop-callbacks.svg), before the warmup and measured
 passes.
 
 The runner executes each loop/workload in a fresh subprocess and reports: