rsloop 0.1.2__tar.gz → 0.1.3__tar.gz

{rsloop-0.1.2 → rsloop-0.1.3}/.github/workflows/wheels.yml

@@ -20,6 +20,13 @@ jobs:
           - os_name: linux
             runner: ubuntu-latest
             rust_target: x86_64-unknown-linux-gnu
+          - os_name: windows-amd64
+            runner: windows-latest
+            rust_target: x86_64-pc-windows-msvc
+          - os_name: windows-arm64
+            runner: windows-11-arm
+            rust_target: aarch64-pc-windows-msvc
+            python_versions: "3.11 3.12 3.13 3.14 3.14t"
           - os_name: macos-intel
             runner: macos-15-intel
             rust_target: x86_64-apple-darwin
@@ -50,6 +57,9 @@ jobs:
         uses: Swatinem/rust-cache@v2
 
       - name: Build wheels
+        shell: bash
+        env:
+          RSLOOP_PYTHON_VERSIONS: ${{ matrix.python_versions }}
         run: scripts/build-wheels.sh --out dist --target "${{ matrix.rust_target }}"
 
       - name: Upload wheel artifacts

{rsloop-0.1.2 → rsloop-0.1.3}/.gitignore

@@ -5,8 +5,9 @@ dist/
 tmp/
 
 *.so
+*.pyd
 
-python/uvloop_rust_impl/_loop
+python/rsloop/_loop*
 
 benchmarks/profiles*
 benchmarks/compare_event_loops.results.json

{rsloop-0.1.2 → rsloop-0.1.3}/Cargo.lock

@@ -943,7 +943,7 @@ dependencies = [
 
 [[package]]
 name = "rsloop"
-version = "0.1.1"
+version = "0.1.3"
 dependencies = [
  "crossbeam-channel",
  "futures",
@@ -954,6 +954,7 @@ dependencies = [
  "pyo3-build-config",
  "signal-hook",
  "socket2",
+ "windows-sys",
 ]
 
 [[package]]
@@ -1043,9 +1044,9 @@ checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"
 
 [[package]]
 name = "signal-hook"
-version = "0.3.18"
+version = "0.4.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d881a16cf4426aa584979d30bd82cb33429027e42122b169753d6ef1085ed6e2"
+checksum = "3b57709da74f9ff9f4a27dce9526eec25ca8407c45a7887243b031a58935fb8e"
 dependencies = [
  "libc",
  "signal-hook-registry",

{rsloop-0.1.2 → rsloop-0.1.3}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "rsloop"
-version = "0.1.1"
+version = "0.1.3"
 edition = "2021"
 description = "An event loop for asyncio written in Rust"
 license = "Apache-2.0"
@@ -24,9 +24,12 @@ libc = "0.2"
 pprof = { version = "0.15.0", default-features = false, features = ["flamegraph"], optional = true }
 pyo3 = { version = "0.28", features = ["extension-module"] }
 pyo3-async-runtimes = { version = "0.28", features = ["async-std-runtime"] }
-signal-hook = "0.3"
+signal-hook = "0.4"
 socket2 = "0.6"
 
+[target.'cfg(windows)'.dependencies]
+windows-sys = { version = "0.61", features = ["Win32_Foundation", "Win32_Networking_WinSock", "Win32_System_Pipes", "Win32_System_Threading"] }
+
 [build-dependencies]
 pyo3-build-config = "0.28"
 

rsloop-0.1.3/PKG-INFO

@@ -0,0 +1,303 @@
+Metadata-Version: 2.4
+Name: rsloop
+Version: 0.1.3
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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 :: Rust
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: System :: Networking
+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
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/RustedBytes/rsloop
+Project-URL: Issues, https://github.com/RustedBytes/rsloop/issues
+Project-URL: Repository, https://github.com/RustedBytes/rsloop
+
+<img src="./rsloop.png" alt="rsloop logo" align="center">
+
+# An event loop for asyncio written in Rust
+
+[![PyPI - Version](https://img.shields.io/pypi/v/rsloop)](https://pypi.org/project/rsloop/)
+[![PyPI Downloads](https://static.pepy.tech/personalized-badge/rsloop?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/rsloop)
+
+`rsloop` is a PyO3-based `asyncio` event loop implemented in Rust.
+
+Each `rsloop.Loop` owns a dedicated Rust runtime thread for loop coordination
+and I/O work. Python callbacks, tasks, and coroutines still run on the thread
+that calls `run_forever()` or `run_until_complete()` (usually the main Python
+thread).
+
+The package exposes:
+
+- a native extension module at `rsloop._loop`
+- a Python wrapper in `python/rsloop/__init__.py`
+- `rsloop.Loop`, `rsloop.new_event_loop()`, and `rsloop.run(...)`
+
+Repository metadata currently targets Python `>=3.8`. The packaged project now
+supports the core event-loop surface on Linux, macOS, and Windows, including
+Windows pipe transports and subprocess workflows.
+
+## Install
+
+From PyPI:
+
+```bash
+pip install rsloop
+```
+
+With `uv`:
+
+```bash
+uv add rsloop
+```
+
+## Usage
+
+Simple entry point:
+
+```python
+import rsloop
+
+async def main():
+    ...
+
+rsloop.run(main())
+```
+
+Manual loop creation also works:
+
+```python
+import asyncio
+import rsloop
+
+loop = rsloop.new_event_loop()
+asyncio.set_event_loop(loop)
+try:
+    loop.run_until_complete(...)
+finally:
+    asyncio.set_event_loop(None)
+    loop.close()
+```
+
+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`.
+
+## Verified Surface Area
+
+The current codebase implements these user-facing areas.
+
+Loop lifecycle and scheduling:
+
+- `run_forever`, `run_until_complete`, `stop`, `close`
+- `time`, `is_running`, `is_closed`
+- `get_debug`, `set_debug`
+- `call_soon`, `call_soon_threadsafe`, `call_later`, `call_at`
+- returned `Handle` and `TimerHandle` objects with `cancel()` / `cancelled()`
+
+Tasks, futures, and execution helpers:
+
+- `create_future`, `create_task`
+- `set_task_factory`, `get_task_factory`
+- `set_exception_handler`, `get_exception_handler`,
+  `call_exception_handler`, `default_exception_handler`
+- `set_default_executor`, `run_in_executor`
+- `shutdown_asyncgens`, `shutdown_default_executor`
+- callback execution under captured `contextvars.Context`
+- `asyncio.get_running_loop()` support while running on `rsloop`
+- `rsloop.run(...)` helper, with `asyncio.run(..., loop_factory=...)`
+  integration on Python 3.12+
+
+I/O and networking:
+
+- `add_reader`, `remove_reader`, `add_writer`, `remove_writer`
+- `sock_recv`, `sock_recv_into`, `sock_sendall`, `sock_accept`, `sock_connect`
+- `getaddrinfo`, `getnameinfo`
+- `create_server`, `create_connection`
+- `create_unix_server`, `create_unix_connection`
+- `connect_accepted_socket`
+- returned `Server` objects with `close()`, `is_serving()`, `get_loop()`,
+  and `sockets()`
+- returned `StreamTransport` objects with `write()`, `writelines()`, `close()`,
+  `abort()`, `is_closing()`, `write_eof()`, `can_write_eof()`,
+  `get_extra_info()`, `get_protocol()`, `set_protocol()`,
+  `pause_reading()`, `resume_reading()`, `is_reading()`
+
+Pipes, subprocesses, and signals:
+
+- `connect_read_pipe`, `connect_write_pipe`
+- `subprocess_exec`, `subprocess_shell`
+- returned `ProcessTransport` and `ProcessPipeTransport` objects
+- higher-level compatibility with `asyncio.create_subprocess_exec()` and
+  `asyncio.create_subprocess_shell()`
+- Unix subprocess options including `cwd`, `env`, `executable`, `pass_fds`,
+  `start_new_session`, `process_group`, `user`, `group`, `extra_groups`,
+  `umask`, and `restore_signals`
+- `add_signal_handler`, `remove_signal_handler`
+
+Profiling:
+
+- `profile(...)`, `profiler_running()`, `start_profiler()`, `stop_profiler()`
+
+## Fast Streams
+
+Importing `rsloop` patches `asyncio.open_connection()` and
+`asyncio.start_server()` by default.
+
+That import-time behavior is controlled by `RSLOOP_USE_FAST_STREAMS` and can be
+disabled with:
+
+```bash
+export RSLOOP_USE_FAST_STREAMS=0
+```
+
+The native fast-stream path is used only when:
+
+- the running loop is an `rsloop.Loop`
+- `ssl` is unset or `None`
+
+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`.
+
+## Current Limitations
+
+These gaps are visible in the current implementation.
+
+- TLS is not implemented.
+- `start_tls()` is stubbed.
+- `ssl=...` is rejected for `create_server`, `create_connection`,
+  `create_unix_server`, `create_unix_connection`, and
+  `connect_accepted_socket`.
+- 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:
+  `server_hostname`, `happy_eyeballs_delay`, `interleave`, `all_errors`,
+  `ssl_handshake_timeout`, `ssl_shutdown_timeout`, and
+  `shutdown_default_executor(timeout=...)`.
+- 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.
+- Unix-specific APIs remain Unix-specific:
+  `create_unix_server`, `create_unix_connection`,
+  `add_signal_handler`, `remove_signal_handler`.
+- Platform-specific limitations still apply:
+  Unix socket APIs and Unix signal handlers remain Unix-only, and several
+  subprocess options such as `pass_fds`, `user`, `group`, and `umask` are
+  still specific to Unix process spawning.
+
+## Build
+
+Quick check:
+
+```bash
+cargo check
+```
+
+Release build and editable install:
+
+```bash
+cargo build --release
+uv run --with maturin maturin develop --release
+```
+
+Build release wheels into `dist/wheels`:
+
+```bash
+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.
+
+## Profiling
+
+Profiling is behind the Cargo feature `profiler` and is disabled by default.
+Build or install with that feature first:
+
+```bash
+cargo build --release --features profiler
+uv run --with maturin maturin develop --release --features profiler
+```
+
+Then wrap the code you want to inspect:
+
+```python
+import rsloop
+
+with rsloop.profile("rsloop-flamegraph.svg", frequency=999):
+    rsloop.run(main())
+```
+
+Or manage the session manually:
+
+```python
+import rsloop
+
+rsloop.start_profiler(frequency=999)
+try:
+    rsloop.run(main())
+finally:
+    rsloop.stop_profiler("rsloop-flamegraph.svg")
+```
+
+Only `format="flamegraph"` is currently implemented. If the extension was built
+without `--features profiler`, `profile()` and `start_profiler()` raise a
+runtime error.
+
+## Examples
+
+Run the repository examples from the project root:
+
+```bash
+uv run python examples/01_basics.py
+uv run python examples/02_fd_and_sockets.py
+uv run python examples/03_streams.py
+uv run python examples/04_unix_and_accepted_socket.py
+uv run python 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
+
+## Benchmark
+
+```bash
+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.
+

rsloop-0.1.3/README.md

@@ -0,0 +1,270 @@
+<img src="./rsloop.png" alt="rsloop logo" align="center">
+
+# An event loop for asyncio written in Rust
+
+[![PyPI - Version](https://img.shields.io/pypi/v/rsloop)](https://pypi.org/project/rsloop/)
+[![PyPI Downloads](https://static.pepy.tech/personalized-badge/rsloop?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/rsloop)
+
+`rsloop` is a PyO3-based `asyncio` event loop implemented in Rust.
+
+Each `rsloop.Loop` owns a dedicated Rust runtime thread for loop coordination
+and I/O work. Python callbacks, tasks, and coroutines still run on the thread
+that calls `run_forever()` or `run_until_complete()` (usually the main Python
+thread).
+
+The package exposes:
+
+- a native extension module at `rsloop._loop`
+- a Python wrapper in `python/rsloop/__init__.py`
+- `rsloop.Loop`, `rsloop.new_event_loop()`, and `rsloop.run(...)`
+
+Repository metadata currently targets Python `>=3.8`. The packaged project now
+supports the core event-loop surface on Linux, macOS, and Windows, including
+Windows pipe transports and subprocess workflows.
+
+## Install
+
+From PyPI:
+
+```bash
+pip install rsloop
+```
+
+With `uv`:
+
+```bash
+uv add rsloop
+```
+
+## Usage
+
+Simple entry point:
+
+```python
+import rsloop
+
+async def main():
+    ...
+
+rsloop.run(main())
+```
+
+Manual loop creation also works:
+
+```python
+import asyncio
+import rsloop
+
+loop = rsloop.new_event_loop()
+asyncio.set_event_loop(loop)
+try:
+    loop.run_until_complete(...)
+finally:
+    asyncio.set_event_loop(None)
+    loop.close()
+```
+
+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`.
+
+## Verified Surface Area
+
+The current codebase implements these user-facing areas.
+
+Loop lifecycle and scheduling:
+
+- `run_forever`, `run_until_complete`, `stop`, `close`
+- `time`, `is_running`, `is_closed`
+- `get_debug`, `set_debug`
+- `call_soon`, `call_soon_threadsafe`, `call_later`, `call_at`
+- returned `Handle` and `TimerHandle` objects with `cancel()` / `cancelled()`
+
+Tasks, futures, and execution helpers:
+
+- `create_future`, `create_task`
+- `set_task_factory`, `get_task_factory`
+- `set_exception_handler`, `get_exception_handler`,
+  `call_exception_handler`, `default_exception_handler`
+- `set_default_executor`, `run_in_executor`
+- `shutdown_asyncgens`, `shutdown_default_executor`
+- callback execution under captured `contextvars.Context`
+- `asyncio.get_running_loop()` support while running on `rsloop`
+- `rsloop.run(...)` helper, with `asyncio.run(..., loop_factory=...)`
+  integration on Python 3.12+
+
+I/O and networking:
+
+- `add_reader`, `remove_reader`, `add_writer`, `remove_writer`
+- `sock_recv`, `sock_recv_into`, `sock_sendall`, `sock_accept`, `sock_connect`
+- `getaddrinfo`, `getnameinfo`
+- `create_server`, `create_connection`
+- `create_unix_server`, `create_unix_connection`
+- `connect_accepted_socket`
+- returned `Server` objects with `close()`, `is_serving()`, `get_loop()`,
+  and `sockets()`
+- returned `StreamTransport` objects with `write()`, `writelines()`, `close()`,
+  `abort()`, `is_closing()`, `write_eof()`, `can_write_eof()`,
+  `get_extra_info()`, `get_protocol()`, `set_protocol()`,
+  `pause_reading()`, `resume_reading()`, `is_reading()`
+
+Pipes, subprocesses, and signals:
+
+- `connect_read_pipe`, `connect_write_pipe`
+- `subprocess_exec`, `subprocess_shell`
+- returned `ProcessTransport` and `ProcessPipeTransport` objects
+- higher-level compatibility with `asyncio.create_subprocess_exec()` and
+  `asyncio.create_subprocess_shell()`
+- Unix subprocess options including `cwd`, `env`, `executable`, `pass_fds`,
+  `start_new_session`, `process_group`, `user`, `group`, `extra_groups`,
+  `umask`, and `restore_signals`
+- `add_signal_handler`, `remove_signal_handler`
+
+Profiling:
+
+- `profile(...)`, `profiler_running()`, `start_profiler()`, `stop_profiler()`
+
+## Fast Streams
+
+Importing `rsloop` patches `asyncio.open_connection()` and
+`asyncio.start_server()` by default.
+
+That import-time behavior is controlled by `RSLOOP_USE_FAST_STREAMS` and can be
+disabled with:
+
+```bash
+export RSLOOP_USE_FAST_STREAMS=0
+```
+
+The native fast-stream path is used only when:
+
+- the running loop is an `rsloop.Loop`
+- `ssl` is unset or `None`
+
+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`.
+
+## Current Limitations
+
+These gaps are visible in the current implementation.
+
+- TLS is not implemented.
+- `start_tls()` is stubbed.
+- `ssl=...` is rejected for `create_server`, `create_connection`,
+  `create_unix_server`, `create_unix_connection`, and
+  `connect_accepted_socket`.
+- 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:
+  `server_hostname`, `happy_eyeballs_delay`, `interleave`, `all_errors`,
+  `ssl_handshake_timeout`, `ssl_shutdown_timeout`, and
+  `shutdown_default_executor(timeout=...)`.
+- 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.
+- Unix-specific APIs remain Unix-specific:
+  `create_unix_server`, `create_unix_connection`,
+  `add_signal_handler`, `remove_signal_handler`.
+- Platform-specific limitations still apply:
+  Unix socket APIs and Unix signal handlers remain Unix-only, and several
+  subprocess options such as `pass_fds`, `user`, `group`, and `umask` are
+  still specific to Unix process spawning.
+
+## Build
+
+Quick check:
+
+```bash
+cargo check
+```
+
+Release build and editable install:
+
+```bash
+cargo build --release
+uv run --with maturin maturin develop --release
+```
+
+Build release wheels into `dist/wheels`:
+
+```bash
+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.
+
+## Profiling
+
+Profiling is behind the Cargo feature `profiler` and is disabled by default.
+Build or install with that feature first:
+
+```bash
+cargo build --release --features profiler
+uv run --with maturin maturin develop --release --features profiler
+```
+
+Then wrap the code you want to inspect:
+
+```python
+import rsloop
+
+with rsloop.profile("rsloop-flamegraph.svg", frequency=999):
+    rsloop.run(main())
+```
+
+Or manage the session manually:
+
+```python
+import rsloop
+
+rsloop.start_profiler(frequency=999)
+try:
+    rsloop.run(main())
+finally:
+    rsloop.stop_profiler("rsloop-flamegraph.svg")
+```
+
+Only `format="flamegraph"` is currently implemented. If the extension was built
+without `--features profiler`, `profile()` and `start_profiler()` raise a
+runtime error.
+
+## Examples
+
+Run the repository examples from the project root:
+
+```bash
+uv run python examples/01_basics.py
+uv run python examples/02_fd_and_sockets.py
+uv run python examples/03_streams.py
+uv run python examples/04_unix_and_accepted_socket.py
+uv run python 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
+
+## Benchmark
+
+```bash
+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.