Skip to content

gh-124621: Emscripten: Add support for async input devices #136822

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Jul 19, 2025

Conversation

hoodmane
Copy link
Contributor

@hoodmane hoodmane commented Jul 19, 2025

This is useful for implementing proper input(). It requires the JavaScript engine to support the wasm JSPI spec which is now stage 4. It is supported on Chrome since version 137 and on Firefox and node behind a flag.

We override the __wasi_fd_read() syscall with our own variant that checks for a readAsync operation. If it has it, we use our own async variant of fd_read(), otherwise we use the original fd_read(). We also add a variant of FS.createDevice() called FS.createAsyncInputDevice().

Finally, if JSPI is available, we wrap the main() symbol with WebAssembly.promising() so that we can stack switch from fd_read(). If JSPI is not available, attempting to read from an AsyncInputDevice will raise an OSError.

@hoodmane
Copy link
Contributor Author

!buildbot emscripten

@bedevere-bot
Copy link

🤖 New build scheduled with the buildbot fleet by @hoodmane for commit 3d573d5 🤖

Results will be shown at:

https://buildbot.python.org/all/#/grid?branch=refs%2Fpull%2F136822%2Fmerge

The command will test the builders whose names match following regular expression: emscripten

The builders matched are:

  • WASM Emscripten PR

hoodmane added 3 commits July 19, 2025 16:25
This is useful for implementing proper `input()`. It requires the
JavaScript engine to support the wasm JSPI spec which is now stage 4.
It is supported on Chrome since version 137 and on Firefox and node
behind a flag.

We override the `__wasi_fd_read()` syscall with our own variant that
checks for a readAsync operation. If it has it, we use our own async
variant of `fd_read()`, otherwise we use the original `fd_read()`.
We also add a variant of `FS.createDevice()` called
`FS.createAsyncInputDevice()`.

Finally, if JSPI is available, we wrap the `main()` symbol with
`WebAssembly.promising()` so that we can stack switch from `fd_read()`.
If JSPI is not available, attempting to read from an AsyncInputDevice
will raise an `OSError`.
@hoodmane hoodmane force-pushed the emscripten-async-input-device branch from 3d573d5 to 7d0e709 Compare July 19, 2025 14:26
@hoodmane hoodmane changed the title gh-136810: Emscripten: Add support for async input devices gh-124621: Emscripten: Add support for async input devices Jul 19, 2025
@ambv ambv merged commit 7ae4749 into python:main Jul 19, 2025
40 checks passed
@hoodmane
Copy link
Contributor Author

Oops this caused some test failures. Fix incoming.

hoodmane added a commit to hoodmane/cpython that referenced this pull request Jul 19, 2025
…handling

Introduced in pythonGH-136822. If the fd is already closed,
`SYSCALLS.getStreamFromFD()` throws an error. We need to catch it and
discard it. The `__wasi_fd_read_orig()` fallback will use it to set errno.
hoodmane added a commit to hoodmane/cpython that referenced this pull request Jul 19, 2025
…handling

Introduced in pythonGH-136822. If the fd is already closed,
`SYSCALLS.getStreamFromFD()` throws an error. We need to catch it and
discard it. The `__wasi_fd_read_orig()` fallback will use it to set errno.
hoodmane added a commit to hoodmane/cpython that referenced this pull request Jul 19, 2025
…handling

Introduced in pythonGH-136822. If the fd is already closed,
`SYSCALLS.getStreamFromFD()` throws an error. We need to catch it and
discard it. The `__wasi_fd_read_orig()` fallback will use it to set errno.
hoodmane added a commit to hoodmane/cpython that referenced this pull request Jul 19, 2025
…handling

Introduced in pythonGH-136822. If the fd is already closed,
`SYSCALLS.getStreamFromFD()` throws an error. We need to catch it and
discard it. The `__wasi_fd_read_orig()` fallback will use it to set errno.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants