Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

gh-95451: Update docs for wasm32-emscripten and -wasi platforms (GH-95452) 

Co-authored-by: Éric <merwok@netwok.org>
Co-authored-by: Michael Droettboom <mdboom@gmail.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
This commit is contained in:
Christian Heimes 2022-08-02 21:00:41 +02:00 committed by GitHub
parent 75a6441718
commit e3b6ff19aa
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
46 changed files with 322 additions and 105 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
Doc/includes/wasm-notavail.rst Normal file
View File

@ -0,0 +1,7 @@
.. include for modules that don't work on WASM
.. availability:: not Emscripten, not WASI.
This module does not work or is not available on WebAssembly platforms
``wasm32-emscripten`` and ``wasm32-wasi``. See
:ref:`wasm-availability` for more information.

1
Doc/library/asynchat.rst
View File

@ -34,6 +34,7 @@ Typically an :class:`asyncore.dispatcher` server channel generates new
:class:`asynchat.async_chat` channel objects as it receives incoming
connection requests.
.. include:: ../includes/wasm-notavail.rst
.. class:: async_chat()

1
Doc/library/asyncio.rst
View File

@ -56,6 +56,7 @@ Additionally, there are **low-level** APIs for
* :ref:`bridge <asyncio-futures>` callback-based libraries and code
with async/await syntax.
.. include:: ../includes/wasm-notavail.rst
.. We use the "rubric" directive here to avoid creating
the "Reference" subsection in the TOC.

2
Doc/library/asyncore.rst
View File

@ -28,6 +28,8 @@
This module provides the basic infrastructure for writing asynchronous socket
service clients and servers.
.. include:: ../includes/wasm-notavail.rst
There are only two ways to have a program on a single processor do "more than
one thing at a time." Multi-threaded programming is the simplest and most
popular way to do it, but there is another very different technique, that lets

1
Doc/library/cgi.rst
View File

@ -37,6 +37,7 @@ size of a POST request. POST requests larger than this size will result in a
:exc:`ValueError` being raised during parsing. The default value of this
variable is ``0``, meaning the request size is unlimited.
.. include:: ../includes/wasm-notavail.rst
Introduction
------------

1
Doc/library/compileall.rst
View File

@ -14,6 +14,7 @@ This module can be used to create the cached byte-code files at library
installation time, which makes them available for use even by users who don't
have write permission to the library directories.
.. include:: ../includes/wasm-notavail.rst
Command-line use
----------------

1
Doc/library/concurrent.futures.rst
View File

@ -19,6 +19,7 @@ The asynchronous execution can be performed with threads, using
:class:`ProcessPoolExecutor`. Both implement the same interface, which is
defined by the abstract :class:`Executor` class.
.. include:: ../includes/wasm-notavail.rst
Executor Objects
----------------

2
Doc/library/crypt.rst
View File

@ -38,6 +38,8 @@ this module.
.. availability:: Unix, not VxWorks.
.. include:: ../includes/wasm-notavail.rst
Hashing Methods
---------------

1
Doc/library/ensurepip.rst
View File

@ -36,6 +36,7 @@ when creating a virtual environment) or after explicitly uninstalling
:pep:`453`: Explicit bootstrapping of pip in Python installations
The original rationale and specification for this module.
.. include:: ../includes/wasm-notavail.rst
Command line interface
----------------------

2
Doc/library/fcntl.rst
View File

@ -18,6 +18,8 @@ interface to the :c:func:`fcntl` and :c:func:`ioctl` Unix routines. For a
complete description of these calls, see :manpage:`fcntl(2)` and
:manpage:`ioctl(2)` Unix manual pages.
.. include:: ../includes/wasm-notavail.rst
All functions in this module take a file descriptor *fd* as their first
argument. This can be an integer file descriptor, such as returned by
``sys.stdin.fileno()``, or an :class:`io.IOBase` object, such as ``sys.stdin``

2
Doc/library/ftplib.rst
View File

@ -21,6 +21,8 @@ as mirroring other FTP servers. It is also used by the module
The default encoding is UTF-8, following :rfc:`2640`.
.. include:: ../includes/wasm-notavail.rst
Here's a sample session using the :mod:`ftplib` module::
>>> from ftplib import FTP

3
Doc/library/getpass.rst
View File

@ -12,8 +12,9 @@
--------------
The :mod:`getpass` module provides two functions:
.. include:: ../includes/wasm-notavail.rst
The :mod:`getpass` module provides two functions:
.. function:: getpass(prompt='Password: ', stream=None)

2
Doc/library/grp.rst
View File

@ -10,6 +10,8 @@
This module provides access to the Unix group database. It is available on all
Unix versions.
.. include:: ../includes/wasm-notavail.rst
Group database entries are reported as a tuple-like object, whose attributes
correspond to the members of the ``group`` structure (Attribute field below, see
``<grp.h>``):

2
Doc/library/http.client.rst
View File

@ -28,6 +28,8 @@ HTTPS protocols. It is normally not used directly --- the module
HTTPS support is only available if Python was compiled with SSL support
(through the :mod:`ssl` module).
.. include:: ../includes/wasm-notavail.rst
The module provides the following classes:

2
Doc/library/http.server.rst
View File

@ -22,6 +22,8 @@ This module defines classes for implementing HTTP servers.
:mod:`http.server` is not recommended for production. It only implements
:ref:`basic security checks <http.server-security>`.
.. include:: ../includes/wasm-notavail.rst
One class, :class:`HTTPServer`, is a :class:`socketserver.TCPServer` subclass.
It creates and listens at the HTTP socket, dispatching the requests to a
handler. Code to create and run the server looks like this::

2
Doc/library/imaplib.rst
View File

@ -26,6 +26,8 @@ implement a large subset of the IMAP4rev1 client protocol as defined in
:rfc:`2060`. It is backward compatible with IMAP4 (:rfc:`1730`) servers, but
note that the ``STATUS`` command is not supported in IMAP4.
.. include:: ../includes/wasm-notavail.rst
Three classes are provided by the :mod:`imaplib` module, :class:`IMAP4` is the
base class:

55
Doc/library/intro.rst
View File

@ -64,3 +64,58 @@ Notes on availability
libc version, then both conditions must hold. For example a feature with note
*Availability: Linux >= 3.17 with glibc >= 2.27* requires both Linux 3.17 or
newer and glibc 2.27 or newer.
.. _wasm-availability:
WebAssembly platforms
---------------------
The `WebAssembly`_ platforms ``wasm32-emscripten`` (`Emscripten`_) and
``wasm32-wasi`` (`WASI`_) provide a subset of POSIX APIs. WebAssembly runtimes
and browsers are sandboxed and have limited access to the host and external
resources. Any Python standard library module that uses processes, threading,
networking, signals, or other forms of inter-process communication (IPC), is
either not available or may not work as on other Unix-like systems. File I/O,
file system, and Unix permission-related functions are restricted, too.
Emscripten does not permit blocking I/O. Other blocking operations like
:func:`~time.sleep` block the browser event loop.
The properties and behavior of Python on WebAssembly platforms depend on the
`Emscripten`_-SDK or `WASI`_-SDK version, WASM runtimes (browser, NodeJS,
`wasmtime`_), and Python build time flags. WebAssembly, Emscripten, and WASI
are evolving standards; some features like networking may be
supported in the future.
For Python in the browser, users should consider `Pyodide`_ or `PyScript`_.
PyScript is built on top of Pyodide, which itself is built on top of
CPython and Emscripten. Pyodide provides access to browsers' JavaScript and
DOM APIs as well as limited networking capabilities with JavaScript's
``XMLHttpRequest`` and ``Fetch`` APIs.
* Process-related APIs are not available or always fail with an error. That
includes APIs that spawn new processes (:func:`~os.fork`,
:func:`~os.execve`), wait for processes (:func:`~os.waitpid`), send signals
(:func:`~os.kill`), or otherwise interact with processes. The
:mod:`subprocess` is importable but does not work.
* The :mod:`socket` module is available, but is limited and behaves
differently from other platforms. On Emscripten, sockets are always
non-blocking and require additional JavaScript code and helpers on the
server to proxy TCP through WebSockets; see `Emscripten Networking`_
for more information. WASI snapshot preview 1 only permits sockets from an
existing file descriptor.
* Some functions are stubs that either don't do anything and always return
hardcoded values.
* Functions related to file descriptors, file permissions, file ownership, and
links are limited and don't support some operations. For example, WASI does
not permit symlinks with absolute file names.
.. _WebAssembly: https://webassembly.org/
.. _Emscripten: https://emscripten.org/
.. _Emscripten Networking: https://emscripten.org/docs/porting/networking.html>
.. _WASI: https://wasi.dev/
.. _wasmtime: https://wasmtime.dev/
.. _Pyodide: https://pyodide.org/
.. _PyScript: https://pyscript.net/

2
Doc/library/mmap.rst
View File

@ -6,6 +6,8 @@
--------------
.. include:: ../includes/wasm-notavail.rst
Memory-mapped file objects behave like both :class:`bytearray` and like
:term:`file objects <file object>`. You can use mmap objects in most places
where :class:`bytearray` are expected; for example, you can use the :mod:`re`

2
Doc/library/multiprocessing.rst
View File

@ -8,6 +8,8 @@
--------------
.. include:: ../includes/wasm-notavail.rst
Introduction
------------

2
Doc/library/nis.rst
View File

@ -21,6 +21,8 @@ central administration of several hosts.
Because NIS exists only on Unix systems, this module is only available for Unix.
.. include:: ../includes/wasm-notavail.rst
The :mod:`nis` module defines the following functions:

2
Doc/library/nntplib.rst
View File

@ -38,6 +38,8 @@ the Network News Transfer Protocol. It can be used to implement a news reader
or poster, or automated news processors. It is compatible with :rfc:`3977`
as well as the older :rfc:`977` and :rfc:`2980`.
.. include:: ../includes/wasm-notavail.rst
Here are two small examples of how it can be used. To list some statistics
about a newsgroup and print the subjects of the last 10 articles::

229
Doc/library/os.rst
View File

@ -34,6 +34,14 @@ Notes on the availability of these functions:
* On VxWorks, os.popen, os.fork, os.execv and os.spawn*p* are not supported.
* On WebAssembly platforms ``wasm32-emscripten`` and ``wasm32-wasi``, large
parts of the :mod:`os` module are not available or behave differently. API
related to processes (e.g. :func:`~os.fork`, :func:`~os.execve`), signals
(e.g. :func:`~os.kill`, :func:`~os.wait`), and resources
(e.g. :func:`~os.nice`) are not available. Others like :func:`~os.getuid`
and :func:`~os.getpid` are emulated or stubs.
.. note::
All functions in this module raise :exc:`OSError` (or subclasses thereof) in
@ -165,7 +173,7 @@ process and user.
Return the filename corresponding to the controlling terminal of the process.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. data:: environ
@ -337,7 +345,7 @@ process and user.
Return the effective group id of the current process. This corresponds to the
"set id" bit on the file being executed in the current process.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: geteuid()
@ -346,7 +354,7 @@ process and user.
Return the current process's effective user id.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: getgid()
@ -357,6 +365,9 @@ process and user.
.. availability:: Unix.
The function is a stub on Emscripten and WASI, see
:ref:`wasm-availability` for more information.
.. function:: getgrouplist(user, group)
@ -365,7 +376,7 @@ process and user.
field from the password record for *user*, because that group ID will
otherwise be potentially omitted.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.3
@ -374,7 +385,7 @@ process and user.
Return list of supplemental group ids associated with the current process.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. note::
@ -402,7 +413,7 @@ process and user.
falls back to ``pwd.getpwuid(os.getuid())[0]`` to get the login name of the
current real user id.
.. availability:: Unix, Windows.
.. availability:: Unix, Windows, not Emscripten, not WASI.
.. function:: getpgid(pid)
@ -410,7 +421,7 @@ process and user.
Return the process group id of the process with process id *pid*. If *pid* is 0,
the process group id of the current process is returned.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: getpgrp()
@ -418,7 +429,7 @@ process and user.
Return the id of the current process group.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: getpid()
@ -427,6 +438,8 @@ process and user.
Return the current process id.
The function is a stub on Emscripten and WASI, see
:ref:`wasm-availability` for more information.
.. function:: getppid()
@ -436,7 +449,7 @@ process and user.
the id returned is the one of the init process (1), on Windows it is still
the same id, which may be already reused by another process.
.. availability:: Unix, Windows.
.. availability:: Unix, Windows, not Emscripten, not WASI.
.. versionchanged:: 3.2
Added support for Windows.
@ -454,7 +467,7 @@ process and user.
(respectively) the calling process, the process group of the calling process,
or the real user ID of the calling process.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.3
@ -465,7 +478,7 @@ process and user.
Parameters for the :func:`getpriority` and :func:`setpriority` functions.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.3
@ -475,7 +488,7 @@ process and user.
Return a tuple (ruid, euid, suid) denoting the current process's
real, effective, and saved user ids.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.2
@ -485,7 +498,7 @@ process and user.
Return a tuple (rgid, egid, sgid) denoting the current process's
real, effective, and saved group ids.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.2
@ -498,6 +511,9 @@ process and user.
.. availability:: Unix.
The function is a stub on Emscripten and WASI, see
:ref:`wasm-availability` for more information.
.. function:: initgroups(username, gid)
@ -505,7 +521,7 @@ process and user.
the groups of which the specified username is a member, plus the specified
group id.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.2
@ -539,21 +555,21 @@ process and user.
Set the current process's effective group id.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: seteuid(euid)
Set the current process's effective user id.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: setgid(gid)
Set the current process' group id.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: setgroups(groups)
@ -562,7 +578,7 @@ process and user.
*groups*. *groups* must be a sequence, and each element must be an integer
identifying a group. This operation is typically available only to the superuser.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. note:: On macOS, the length of *groups* may not exceed the
system-defined maximum number of effective group ids, typically 16.
@ -574,7 +590,7 @@ process and user.
Call the system call :c:func:`setpgrp` or ``setpgrp(0, 0)`` depending on
which version is implemented (if any). See the Unix manual for the semantics.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: setpgid(pid, pgrp)
@ -583,7 +599,7 @@ process and user.
process with id *pid* to the process group with id *pgrp*. See the Unix manual
for the semantics.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: setpriority(which, who, priority)
@ -600,7 +616,7 @@ process and user.
*priority* is a value in the range -20 to 19. The default priority is 0;
lower priorities cause more favorable scheduling.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.3
@ -609,14 +625,14 @@ process and user.
Set the current process's real and effective group ids.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: setresgid(rgid, egid, sgid)
Set the current process's real, effective, and saved group ids.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.2
@ -625,7 +641,7 @@ process and user.
Set the current process's real, effective, and saved user ids.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.2
@ -634,21 +650,21 @@ process and user.
Set the current process's real and effective user ids.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: getsid(pid)
Call the system call :c:func:`getsid`. See the Unix manual for the semantics.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: setsid()
Call the system call :c:func:`setsid`. See the Unix manual for the semantics.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: setuid(uid)
@ -657,7 +673,7 @@ process and user.
Set the current process's user id.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. placed in this section since it relates to errno.... a little weak
@ -680,6 +696,9 @@ process and user.
Set the current numeric umask and return the previous umask.
The function is a stub on Emscripten and WASI, see
:ref:`wasm-availability` for more information.
.. function:: uname()
@ -850,6 +869,8 @@ as internal buffering of data.
2: stderr), the new file descriptor is :ref:`inheritable
<fd_inheritance>`.
.. availability:: not WASI.
.. versionchanged:: 3.4
The new file descriptor is now non-inheritable.
@ -861,6 +882,8 @@ as internal buffering of data.
<fd_inheritance>` by default or non-inheritable if *inheritable*
is ``False``.
.. availability:: not WASI.
.. versionchanged:: 3.4
Add the optional *inheritable* parameter.
@ -878,6 +901,9 @@ as internal buffering of data.
.. availability:: Unix.
The function is limited on Emscripten and WASI, see
:ref:`wasm-availability` for more information.
.. function:: fchown(fd, uid, gid)
@ -890,6 +916,9 @@ as internal buffering of data.
.. availability:: Unix.
The function is limited on Emscripten and WASI, see
:ref:`wasm-availability` for more information.
.. function:: fdatasync(fd)
@ -978,6 +1007,9 @@ as internal buffering of data.
.. availability:: Unix.
The function is limited on Emscripten and WASI, see
:ref:`wasm-availability` for more information.
.. versionadded:: 3.5
@ -1020,7 +1052,7 @@ as internal buffering of data.
Make the calling process a session leader; make the tty the controlling tty,
the stdin, the stdout, and the stderr of the calling process; close fd.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.11
@ -1164,7 +1196,7 @@ or `the MSDN <https://msdn.microsoft.com/en-us/library/z0kc8e3z.aspx>`_ on Windo
descriptors are :ref:`non-inheritable <fd_inheritance>`. For a (slightly) more
portable approach, use the :mod:`pty` module.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionchanged:: 3.4
The new file descriptors are now non-inheritable.
@ -1190,7 +1222,7 @@ or `the MSDN <https://msdn.microsoft.com/en-us/library/z0kc8e3z.aspx>`_ on Windo
Return a pair of file descriptors ``(r, w)`` usable for reading and writing,
respectively.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.3
@ -1200,7 +1232,7 @@ or `the MSDN <https://msdn.microsoft.com/en-us/library/z0kc8e3z.aspx>`_ on Windo
Ensures that enough disk space is allocated for the file specified by *fd*
starting from *offset* and continuing for *len* bytes.
.. availability:: Unix.
.. availability:: Unix, not Emscripten.
.. versionadded:: 3.3
@ -1427,7 +1459,7 @@ or `the MSDN <https://msdn.microsoft.com/en-us/library/z0kc8e3z.aspx>`_ on Windo
Cross-platform applications should not use *headers*, *trailers* and *flags*
arguments.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. note::
@ -1449,6 +1481,9 @@ or `the MSDN <https://msdn.microsoft.com/en-us/library/z0kc8e3z.aspx>`_ on Windo
.. availability:: Unix.
The function is limited on Emscripten and WASI, see
:ref:`wasm-availability` for more information.
.. versionadded:: 3.5
@ -1459,7 +1494,7 @@ or `the MSDN <https://msdn.microsoft.com/en-us/library/z0kc8e3z.aspx>`_ on Windo
Parameters to the :func:`sendfile` function, if the implementation supports
them.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.3
@ -1468,7 +1503,7 @@ or `the MSDN <https://msdn.microsoft.com/en-us/library/z0kc8e3z.aspx>`_ on Windo
Parameter to the :func:`sendfile` function, if the implementation supports
it. The data won't be cached in the virtual memory and will be freed afterwards.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.11
@ -1529,7 +1564,7 @@ or `the MSDN <https://msdn.microsoft.com/en-us/library/z0kc8e3z.aspx>`_ on Windo
Return the process group associated with the terminal given by *fd* (an open
file descriptor as returned by :func:`os.open`).
.. availability:: Unix.
.. availability:: Unix, not WASI.
.. function:: tcsetpgrp(fd, pg)
@ -1537,7 +1572,7 @@ or `the MSDN <https://msdn.microsoft.com/en-us/library/z0kc8e3z.aspx>`_ on Windo
Set the process group associated with the terminal given by *fd* (an open file
descriptor as returned by :func:`os.open`) to *pg*.
.. availability:: Unix.
.. availability:: Unix, not WASI.
.. function:: ttyname(fd)
@ -1645,6 +1680,9 @@ Using the :mod:`subprocess` module, all file descriptors except standard
streams are closed, and inheritable handles are only inherited if the
*close_fds* parameter is ``False``.
On WebAssembly platforms ``wasm32-emscripten`` and ``wasm32-wasi``, the file
descriptor cannot be modified.
.. function:: get_inheritable(fd)
Get the "inheritable" flag of the specified file descriptor (a boolean).
@ -1829,7 +1867,7 @@ features:
.. audit-event:: os.chflags path,flags os.chflags
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.3
The *follow_symlinks* argument.
@ -1874,6 +1912,9 @@ features:
read-only flag with it (via the ``stat.S_IWRITE`` and ``stat.S_IREAD``
constants or a corresponding integer value). All other bits are ignored.
The function is limited on Emscripten and WASI, see
:ref:`wasm-availability` for more information.
.. audit-event:: os.chmod path,mode,dir_fd os.chmod
.. versionadded:: 3.3
@ -1900,6 +1941,9 @@ features:
.. availability:: Unix.
The function is limited on Emscripten and WASI, see
:ref:`wasm-availability` for more information.
.. versionadded:: 3.3
Added support for specifying *path* as an open file descriptor,
and the *dir_fd* and *follow_symlinks* arguments.
@ -1912,7 +1956,7 @@ features:
Change the root directory of the current process to *path*.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionchanged:: 3.6
Accepts a :term:`path-like object`.
@ -1952,7 +1996,7 @@ features:
.. audit-event:: os.chflags path,flags os.lchflags
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionchanged:: 3.6
Accepts a :term:`path-like object`.
@ -2169,7 +2213,7 @@ features:
FIFO for reading, and the client opens it for writing. Note that :func:`mkfifo`
doesn't open the FIFO --- it just creates the rendezvous point.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.3
The *dir_fd* argument.
@ -2191,7 +2235,7 @@ features:
This function can also support :ref:`paths relative to directory descriptors
<dir_fd>`.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.3
The *dir_fd* argument.
@ -3059,6 +3103,9 @@ features:
.. availability:: Unix, Windows.
The function is limited on Emscripten and WASI, see
:ref:`wasm-availability` for more information.
.. versionchanged:: 3.2
Added support for Windows 6.0 (Vista) symbolic links.
@ -3670,7 +3717,7 @@ to be ignored.
.. audit-event:: os.exec path,args,env os.execl
.. availability:: Unix, Windows.
.. availability:: Unix, Windows, not Emscripten, not WASI.
.. versionadded:: 3.3
Added support for specifying *path* as an open file descriptor
@ -3713,49 +3760,49 @@ written in Python, such as a mail server's external command delivery program.
Exit code that means the command was used incorrectly, such as when the wrong
number of arguments are given.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. data:: EX_DATAERR
Exit code that means the input data was incorrect.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. data:: EX_NOINPUT
Exit code that means an input file did not exist or was not readable.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. data:: EX_NOUSER
Exit code that means a specified user did not exist.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. data:: EX_NOHOST
Exit code that means a specified host did not exist.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. data:: EX_UNAVAILABLE
Exit code that means that a required service is unavailable.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. data:: EX_SOFTWARE
Exit code that means an internal software error was detected.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. data:: EX_OSERR
@ -3763,7 +3810,7 @@ written in Python, such as a mail server's external command delivery program.
Exit code that means an operating system error was detected, such as the
inability to fork or create a pipe.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. data:: EX_OSFILE
@ -3771,21 +3818,21 @@ written in Python, such as a mail server's external command delivery program.
Exit code that means some system file did not exist, could not be opened, or had
some other kind of error.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. data:: EX_CANTCREAT
Exit code that means a user specified output file could not be created.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. data:: EX_IOERR
Exit code that means that an error occurred while doing I/O on some file.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. data:: EX_TEMPFAIL
@ -3794,7 +3841,7 @@ written in Python, such as a mail server's external command delivery program.
that may not really be an error, such as a network connection that couldn't be
made during a retryable operation.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. data:: EX_PROTOCOL
@ -3802,7 +3849,7 @@ written in Python, such as a mail server's external command delivery program.
Exit code that means that a protocol exchange was illegal, invalid, or not
understood.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. data:: EX_NOPERM
@ -3810,21 +3857,21 @@ written in Python, such as a mail server's external command delivery program.
Exit code that means that there were insufficient permissions to perform the
operation (but not intended for file system problems).
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. data:: EX_CONFIG
Exit code that means that some kind of configuration error occurred.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. data:: EX_NOTFOUND
Exit code that means something like "an entry was not found".
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: fork()
@ -3845,7 +3892,7 @@ written in Python, such as a mail server's external command delivery program.
See :mod:`ssl` for applications that use the SSL module with fork().
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: forkpty()
@ -3862,7 +3909,7 @@ written in Python, such as a mail server's external command delivery program.
Calling ``forkpty()`` in a subinterpreter is no longer supported
(:exc:`RuntimeError` is raised).
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: kill(pid, sig)
@ -3886,6 +3933,8 @@ written in Python, such as a mail server's external command delivery program.
.. audit-event:: os.kill pid,sig os.kill
.. availability:: Unix, Windows, not Emscripten, not WASI.
.. versionadded:: 3.2
Windows support.
@ -3900,14 +3949,14 @@ written in Python, such as a mail server's external command delivery program.
.. audit-event:: os.killpg pgid,sig os.killpg
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: nice(increment)
Add *increment* to the process's "niceness". Return the new niceness.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: pidfd_open(pid, flags=0)
@ -3937,7 +3986,7 @@ written in Python, such as a mail server's external command delivery program.
Lock program segments into memory. The value of *op* (defined in
``<sys/lock.h>``) determines which segments are locked.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: popen(cmd, mode='r', buffering=-1)
@ -3969,6 +4018,8 @@ written in Python, such as a mail server's external command delivery program.
documentation for more powerful ways to manage and communicate with
subprocesses.
.. availability:: not Emscripten, not WASI.
.. note::
The :ref:`Python UTF-8 Mode <utf8-mode>` affects encodings used
for *cmd* and pipe contents.
@ -4062,7 +4113,7 @@ written in Python, such as a mail server's external command delivery program.
.. versionadded:: 3.8
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: posix_spawnp(path, argv, env, *, file_actions=None, \
setpgroup=None, resetids=False, setsid=False, setsigmask=(), \
@ -4078,7 +4129,7 @@ written in Python, such as a mail server's external command delivery program.
.. versionadded:: 3.8
.. availability:: POSIX
.. availability:: POSIX, not Emscripten, not WASI.
See :func:`posix_spawn` documentation.
@ -4111,7 +4162,7 @@ written in Python, such as a mail server's external command delivery program.
There is no way to unregister a function.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.7
@ -4180,7 +4231,7 @@ written in Python, such as a mail server's external command delivery program.
.. audit-event:: os.spawn mode,path,args,env os.spawnl
.. availability:: Unix, Windows.
.. availability:: Unix, Windows, not Emscripten, not WASI.
:func:`spawnlp`, :func:`spawnlpe`, :func:`spawnvp`
and :func:`spawnvpe` are not available on Windows. :func:`spawnle` and
@ -4304,7 +4355,7 @@ written in Python, such as a mail server's external command delivery program.
.. audit-event:: os.system command os.system
.. availability:: Unix, Windows.
.. availability:: Unix, Windows, not Emscripten, not WASI.
.. function:: times()
@ -4345,7 +4396,7 @@ written in Python, such as a mail server's external command delivery program.
:func:`waitstatus_to_exitcode` can be used to convert the exit status into an
exit code.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. seealso::
@ -4366,7 +4417,7 @@ written in Python, such as a mail server's external command delivery program.
:attr:`si_code` or ``None`` if :data:`WNOHANG` is specified and there are no
children in a waitable state.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.3
@ -4377,7 +4428,7 @@ written in Python, such as a mail server's external command delivery program.
These are the possible values for *idtype* in :func:`waitid`. They affect
how *id* is interpreted.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.3
@ -4397,7 +4448,7 @@ written in Python, such as a mail server's external command delivery program.
Flags that can be used in *options* in :func:`waitid` that specify what
child signal to wait for.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.3
@ -4412,7 +4463,7 @@ written in Python, such as a mail server's external command delivery program.
These are the possible values for :attr:`si_code` in the result returned by
:func:`waitid`.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. versionadded:: 3.3
@ -4450,6 +4501,8 @@ written in Python, such as a mail server's external command delivery program.
:func:`waitstatus_to_exitcode` can be used to convert the exit status into an
exit code.
.. availability:: Unix, not Emscripten, not WASI.
.. versionchanged:: 3.5
If the system call is interrupted and the signal handler does not raise an
exception, the function now retries the system call instead of raising an
@ -4468,7 +4521,7 @@ written in Python, such as a mail server's external command delivery program.
:func:`waitstatus_to_exitcode` can be used to convert the exit status into an
exitcode.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: wait4(pid, options)
@ -4482,7 +4535,7 @@ written in Python, such as a mail server's external command delivery program.
:func:`waitstatus_to_exitcode` can be used to convert the exit status into an
exitcode.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: waitstatus_to_exitcode(status)
@ -4512,6 +4565,8 @@ written in Python, such as a mail server's external command delivery program.
:func:`WIFEXITED`, :func:`WEXITSTATUS`, :func:`WIFSIGNALED`,
:func:`WTERMSIG`, :func:`WIFSTOPPED`, :func:`WSTOPSIG` functions.
.. availability:: Unix, Windows, not Emscripten, not WASI.
.. versionadded:: 3.9
@ -4520,7 +4575,7 @@ written in Python, such as a mail server's external command delivery program.
The option for :func:`waitpid` to return immediately if no child process status
is available immediately. The function returns ``(0, 0)`` in this case.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. data:: WCONTINUED
@ -4528,7 +4583,7 @@ written in Python, such as a mail server's external command delivery program.
This option causes child processes to be reported if they have been continued
from a job control stop since their status was last reported.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
Some Unix systems.
@ -4538,7 +4593,7 @@ written in Python, such as a mail server's external command delivery program.
This option causes child processes to be reported if they have been stopped but
their current state has not been reported since they were stopped.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
The following functions take a process status code as returned by
@ -4552,7 +4607,7 @@ used to determine the disposition of a process.
This function should be employed only if :func:`WIFSIGNALED` is true.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: WIFCONTINUED(status)
@ -4563,7 +4618,7 @@ used to determine the disposition of a process.
See :data:`WCONTINUED` option.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: WIFSTOPPED(status)
@ -4575,14 +4630,14 @@ used to determine the disposition of a process.
done using :data:`WUNTRACED` option or when the process is being traced (see
:manpage:`ptrace(2)`).
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: WIFSIGNALED(status)
Return ``True`` if the process was terminated by a signal, otherwise return
``False``.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: WIFEXITED(status)
@ -4591,7 +4646,7 @@ used to determine the disposition of a process.
by calling ``exit()`` or ``_exit()``, or by returning from ``main()``;
otherwise return ``False``.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: WEXITSTATUS(status)
@ -4600,7 +4655,7 @@ used to determine the disposition of a process.
This function should be employed only if :func:`WIFEXITED` is true.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: WSTOPSIG(status)
@ -4609,7 +4664,7 @@ used to determine the disposition of a process.
This function should be employed only if :func:`WIFSTOPPED` is true.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
.. function:: WTERMSIG(status)
@ -4618,7 +4673,7 @@ used to determine the disposition of a process.
This function should be employed only if :func:`WIFSIGNALED` is true.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
Interface to the scheduler

2
Doc/library/poplib.rst
View File

@ -28,6 +28,8 @@ quality of POP3 servers varies widely, and too many are quite poor. If your
mailserver supports IMAP, you would be better off using the
:class:`imaplib.IMAP4` class, as IMAP servers tend to be better implemented.
.. include:: ../includes/wasm-notavail.rst
The :mod:`poplib` module provides two classes:

2
Doc/library/pwd.rst
View File

@ -10,6 +10,8 @@
This module provides access to the Unix user account and password database. It
is available on all Unix versions.
.. include:: ../includes/wasm-notavail.rst
Password database entries are reported as a tuple-like object, whose attributes
correspond to the members of the ``passwd`` structure (Attribute field below,
see ``<pwd.h>``):

2
Doc/library/resource.rst
View File

@ -13,6 +13,8 @@
This module provides basic mechanisms for measuring and controlling system
resources utilized by a program.
.. include:: ../includes/wasm-notavail.rst
Symbolic constants are used to specify particular system resources and to
request usage information about either the current process or its children.

1
Doc/library/select.rst
View File

@ -22,6 +22,7 @@ it was last read.
encouraged to use the :mod:`selectors` module instead, unless they want
precise control over the OS-level primitives used.
.. include:: ../includes/wasm-notavail.rst
The module defines the following:

1
Doc/library/selectors.rst
View File

@ -38,6 +38,7 @@ users.
:mod:`select`
Low-level I/O multiplexing module.
.. include:: ../includes/wasm-notavail.rst
Classes
-------

3
Doc/library/signal.rst
View File

@ -24,6 +24,9 @@ explicitly reset (Python emulates the BSD style interface regardless of the
underlying implementation), with the exception of the handler for
:const:`SIGCHLD`, which follows the underlying implementation.
On WebAssembly platforms ``wasm32-emscripten`` and ``wasm32-wasi``, signals
are emulated and therefore behave differently. Several functions and signals
are not available on these platforms.
Execution of Python signal handlers
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

1
Doc/library/smtpd.rst
View File

@ -31,6 +31,7 @@ interaction behaviour with SMTP clients.
The code supports :RFC:`5321`, plus the :rfc:`1870` SIZE and :rfc:`6531`
SMTPUTF8 extensions.
.. include:: ../includes/wasm-notavail.rst
SMTPServer Objects
------------------

1
Doc/library/smtplib.rst
View File

@ -19,6 +19,7 @@ to send mail to any internet machine with an SMTP or ESMTP listener daemon. For
details of SMTP and ESMTP operation, consult :rfc:`821` (Simple Mail Transfer
Protocol) and :rfc:`1869` (SMTP Service Extensions).
.. include:: ../includes/wasm-notavail.rst
.. class:: SMTP(host='', port=0, local_hostname=None[, timeout], source_address=None)

55
Doc/library/socket.rst
View File

@ -16,6 +16,9 @@ all modern Unix systems, Windows, MacOS, and probably additional platforms.
Some behavior may be platform dependent, since calls are made to the operating
system socket APIs.
.. include:: ../includes/wasm-notavail.rst
.. index:: object: socket
The Python interface is a straightforward transliteration of the Unix system
@ -918,6 +921,8 @@ The :mod:`socket` module also offers various network-related services:
.. audit-event:: socket.gethostbyname hostname socket.gethostbyname
.. availability:: not WASI.
.. function:: gethostbyname_ex(hostname)
@ -932,6 +937,8 @@ The :mod:`socket` module also offers various network-related services:
.. audit-event:: socket.gethostbyname hostname socket.gethostbyname_ex
.. availability:: not WASI.
.. function:: gethostname()
@ -943,6 +950,8 @@ The :mod:`socket` module also offers various network-related services:
Note: :func:`gethostname` doesn't always return the fully qualified domain
name; use :func:`getfqdn` for that.
.. availability:: not WASI.
.. function:: gethostbyaddr(ip_address)
@ -956,6 +965,8 @@ The :mod:`socket` module also offers various network-related services:
.. audit-event:: socket.gethostbyaddr ip_address socket.gethostbyaddr
.. availability:: not WASI.
.. function:: getnameinfo(sockaddr, flags)
@ -971,6 +982,9 @@ The :mod:`socket` module also offers various network-related services:
.. audit-event:: socket.getnameinfo sockaddr socket.getnameinfo
.. availability:: not WASI.
.. function:: getprotobyname(protocolname)
Translate an internet protocol name (for example, ``'icmp'``) to a constant
@ -979,6 +993,8 @@ The :mod:`socket` module also offers various network-related services:
(:const:`SOCK_RAW`); for the normal socket modes, the correct protocol is chosen
automatically if the protocol is omitted or zero.
.. availability:: not WASI.
.. function:: getservbyname(servicename[, protocolname])
@ -988,6 +1004,8 @@ The :mod:`socket` module also offers various network-related services:
.. audit-event:: socket.getservbyname servicename,protocolname socket.getservbyname
.. availability:: not WASI.
.. function:: getservbyport(port[, protocolname])
@ -997,6 +1015,8 @@ The :mod:`socket` module also offers various network-related services:
.. audit-event:: socket.getservbyport port,protocolname socket.getservbyport
.. availability:: not WASI.
.. function:: ntohl(x)
@ -1130,7 +1150,7 @@ The :mod:`socket` module also offers various network-related services:
buffer. Raises :exc:`OverflowError` if *length* is outside the
permissible range of values.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
Most Unix platforms.
@ -1153,7 +1173,7 @@ The :mod:`socket` module also offers various network-related services:
amount of ancillary data that can be received, since additional
data may be able to fit into the padding area.
.. availability:: Unix.
.. availability:: Unix, not Emscripten, not WASI.
most Unix platforms.
@ -1193,7 +1213,7 @@ The :mod:`socket` module also offers various network-related services:
(index int, name string) tuples.
:exc:`OSError` if the system call fails.
.. availability:: Unix, Windows.
.. availability:: Unix, Windows, not Emscripten, not WASI.
.. versionadded:: 3.3
@ -1220,7 +1240,7 @@ The :mod:`socket` module also offers various network-related services:
interface name.
:exc:`OSError` if no interface with the given name exists.
.. availability:: Unix, Windows.
.. availability:: Unix, Windows, not Emscripten, not WASI.
.. versionadded:: 3.3
@ -1237,7 +1257,7 @@ The :mod:`socket` module also offers various network-related services:
interface index number.
:exc:`OSError` if no interface with the given index exists.
.. availability:: Unix, Windows.
.. availability:: Unix, Windows, not Emscripten, not WASI.
.. versionadded:: 3.3
@ -1254,7 +1274,7 @@ The :mod:`socket` module also offers various network-related services:
The *fds* parameter is a sequence of file descriptors.
Consult :meth:`sendmsg` for the documentation of these parameters.
.. availability:: Unix.
.. availability:: Unix, Windows, not Emscripten, not WASI.
Unix platforms supporting :meth:`~socket.sendmsg`
and :const:`SCM_RIGHTS` mechanism.
@ -1268,7 +1288,7 @@ The :mod:`socket` module also offers various network-related services:
Return ``(msg, list(fds), flags, addr)``.
Consult :meth:`recvmsg` for the documentation of these parameters.
.. availability:: Unix.
.. availability:: Unix, Windows, not Emscripten, not WASI.
Unix platforms supporting :meth:`~socket.sendmsg`
and :const:`SCM_RIGHTS` mechanism.
@ -1319,6 +1339,9 @@ to sockets.
.. audit-event:: socket.bind self,address socket.socket.bind
.. availability:: not WASI.
.. method:: socket.close()
Mark the socket closed. The underlying system resource (e.g. a file
@ -1363,6 +1386,8 @@ to sockets.
signal, the signal handler doesn't raise an exception and the socket is
blocking or has a timeout (see the :pep:`475` for the rationale).
.. availability:: not WASI.
.. method:: socket.connect_ex(address)
@ -1375,6 +1400,8 @@ to sockets.
.. audit-event:: socket.connect self,address socket.socket.connect_ex
.. availability:: not WASI.
.. method:: socket.detach()
Put the socket object into closed state without actually closing the
@ -1393,6 +1420,8 @@ to sockets.
.. versionchanged:: 3.4
The socket is now non-inheritable.
.. availability:: not WASI.
.. method:: socket.fileno()
@ -1438,6 +1467,8 @@ to sockets.
contents of the buffer (see the optional built-in module :mod:`struct` for a way
to decode C structures encoded as byte strings).
.. availability:: not WASI.
.. method:: socket.getblocking()
@ -1481,9 +1512,12 @@ to sockets.
unaccepted connections that the system will allow before refusing new
connections. If not specified, a default reasonable value is chosen.
.. availability:: not WASI.
.. versionchanged:: 3.5
The *backlog* parameter is now optional.
.. method:: socket.makefile(mode='r', buffering=None, *, encoding=None, \
errors=None, newline=None)
@ -1758,7 +1792,7 @@ to sockets.
def send_fds(sock, msg, fds):
return sock.sendmsg([msg], [(socket.SOL_SOCKET, socket.SCM_RIGHTS, array.array("i", fds))])
.. availability:: Unix.
.. availability:: Unix, not WASI.
Most Unix platforms.
@ -1854,13 +1888,14 @@ to sockets.
*optlen* argument is required. It's equivalent to call :c:func:`setsockopt` C
function with ``optval=NULL`` and ``optlen=optlen``.
.. versionchanged:: 3.5
Writable :term:`bytes-like object` is now accepted.
.. versionchanged:: 3.6
setsockopt(level, optname, None, optlen: int) form added.
.. availability:: not WASI.
.. method:: socket.shutdown(how)
@ -1869,6 +1904,8 @@ to sockets.
are disallowed. If *how* is :const:`SHUT_RDWR`, further sends and receives are
disallowed.
.. availability:: not WASI.
.. method:: socket.share(process_id)

2
Doc/library/socketserver.rst
View File

@ -10,6 +10,8 @@
The :mod:`socketserver` module simplifies the task of writing network servers.
.. include:: ../includes/wasm-notavail.rst
There are four basic concrete server classes:

2
Doc/library/spwd.rst
View File

@ -15,6 +15,8 @@
This module provides access to the Unix shadow password database. It is
available on various Unix versions.
.. include:: ../includes/wasm-notavail.rst
You must have enough privileges to access the shadow password database (this
usually means you have to be root).

1
Doc/library/ssl.rst
View File

@ -33,6 +33,7 @@ probably additional platforms, as long as OpenSSL is installed on that platform.
may lead to a false sense of security, as the default settings of the
ssl module are not necessarily appropriate for your application.
.. include:: ../includes/wasm-notavail.rst
This section documents the objects and functions in the ``ssl`` module; for more
general information about TLS, SSL, and certificates, the reader is referred to

1
Doc/library/subprocess.rst
View File

@ -25,6 +25,7 @@ modules and functions can be found in the following sections.
:pep:`324` -- PEP proposing the subprocess module
.. include:: ../includes/wasm-notavail.rst
Using the :mod:`subprocess` Module
----------------------------------

2
Doc/library/syslog.rst
View File

@ -15,6 +15,8 @@ This module wraps the system ``syslog`` family of routines. A pure Python
library that can speak to a syslog server is available in the
:mod:`logging.handlers` module as :class:`SysLogHandler`.
.. include:: ../includes/wasm-notavail.rst
The module defines the following functions:

1
Doc/library/telnetlib.rst
View File

@ -30,6 +30,7 @@ SE (Subnegotiation End), NOP (No Operation), DM (Data Mark), BRK (Break), IP
(Interrupt process), AO (Abort output), AYT (Are You There), EC (Erase
Character), EL (Erase Line), GA (Go Ahead), SB (Subnegotiation Begin).
.. include:: ../includes/wasm-notavail.rst
.. class:: Telnet(host=None, port=0[, timeout])

1
Doc/library/threading.rst
View File

@ -33,6 +33,7 @@ level :mod:`_thread` module. See also the :mod:`queue` module.
However, threading is still an appropriate model if you want to run
multiple I/O-bound tasks simultaneously.
.. include:: ../includes/wasm-notavail.rst
This module defines the following functions:

1
Doc/library/urllib.request.rst
View File

@ -21,6 +21,7 @@ authentication, redirections, cookies and more.
The `Requests package <https://requests.readthedocs.io/en/master/>`_
is recommended for a higher-level HTTP client interface.
.. include:: ../includes/wasm-notavail.rst
The :mod:`urllib.request` module defines the following functions:

1
Doc/library/venv.rst
View File

@ -29,6 +29,7 @@ See :pep:`405` for more information about Python virtual environments.
`Python Packaging User Guide: Creating and using virtual environments
<https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/#creating-a-virtual-environment>`__
.. include:: ../includes/wasm-notavail.rst
Creating virtual environments
-----------------------------

2
Doc/library/webbrowser.rst
View File

@ -41,6 +41,8 @@ naturally, mutually exclusive. Usage example::
python -m webbrowser -t "https://www.python.org"
.. include:: ../includes/wasm-notavail.rst
The following exception is defined:

2
Doc/library/xmlrpc.client.rst
View File

@ -32,6 +32,8 @@ between conformable Python objects and XML on the wire.
For HTTPS URIs, :mod:`xmlrpc.client` now performs all the necessary
certificate and hostname checks by default.
.. include:: ../includes/wasm-notavail.rst
.. class:: ServerProxy(uri, transport=None, encoding=None, verbose=False, \
allow_none=False, use_datetime=False, \
use_builtin_types=False, *, headers=(), context=None)

1
Doc/library/xmlrpc.server.rst
View File

@ -23,6 +23,7 @@ servers written in Python. Servers can either be free standing, using
constructed data. If you need to parse untrusted or unauthenticated data see
:ref:`xml-vulnerabilities`.
.. include:: ../includes/wasm-notavail.rst
.. class:: SimpleXMLRPCServer(addr, requestHandler=SimpleXMLRPCRequestHandler,\
logRequests=True, allow_none=False, encoding=None,\

1
Doc/library/zoneinfo.rst
View File

@ -27,6 +27,7 @@ first-party `tzdata`_ package available on PyPI.
First-party package maintained by the CPython core developers to supply
time zone data via PyPI.
.. include:: ../includes/wasm-notavail.rst
Using ``ZoneInfo``
------------------

14
Doc/tools/extensions/pyspecific.py
View File

@ -143,11 +143,11 @@ class Availability(Directive):
known_platforms = frozenset({
"AIX", "Android", "BSD", "DragonFlyBSD", "Emscripten", "FreeBSD",
"Linux", "NetBSD", "OpenBSD", "POSIX", "Solaris", "Unix", "VxWorks",
"WASI", "Windows", "macOS",
# libc
"BSD libc", "glibc", "musl",
# POSIX platforms with pthreads
"pthreads",
"WASI", "Windows", "macOS",
# libc
"BSD libc", "glibc", "musl",
# POSIX platforms with pthreads
"pthreads",
})
def run(self):
@ -159,9 +159,7 @@ class Availability(Directive):
n, m = self.state.inline_text(self.arguments[0], self.lineno)
pnode.extend(n + m)
if self.content:
content = " " + " ".join(self.content)
n, m = self.state.inline_text(content, self.content_offset)
pnode.extend(n + m)
self.state.nested_parse(self.content, self.content_offset, pnode)
self.parse_platforms()

3
Misc/NEWS.d/next/Documentation/2022-07-29-23-02-19.gh-issue-95451.-tgB93.rst Normal file
View File

@ -0,0 +1,3 @@
Update library documentation with
:ref:`availability information <wasm-availability>`
on WebAssembly platforms ``wasm32-emscripten`` and ``wasm32-wasi``.