docs/library: Add xrefs to "stream" dictionary entry for many modules.

pull/1/head
Paul Sokolovsky 2017-12-04 18:36:20 +02:00
parent 75d3c046da
commit 3ff7040c8a
11 changed files with 17 additions and 17 deletions

View File

@ -5,7 +5,7 @@
:synopsis: simple BTree database :synopsis: simple BTree database
The ``btree`` module implements a simple key-value database using external The ``btree`` module implements a simple key-value database using external
storage (disk files, or in general case, a random-access stream). Keys are storage (disk files, or in general case, a random-access `stream`). Keys are
stored sorted in the database, and besides efficient retrieval by a key stored sorted in the database, and besides efficient retrieval by a key
value, a database also supports efficient ordered range scans (retrieval value, a database also supports efficient ordered range scans (retrieval
of values with the keys in a given range). On the application interface of values with the keys in a given range). On the application interface

View File

@ -24,7 +24,7 @@ are supported.
WiPy/CC3200: Bits can be 5, 6, 7, 8. Stop can be 1 or 2. WiPy/CC3200: Bits can be 5, 6, 7, 8. Stop can be 1 or 2.
A UART object acts like a stream object and reading and writing is done A UART object acts like a `stream` object and reading and writing is done
using the standard stream methods:: using the standard stream methods::
uart.read(10) # read 10 characters, returns a bytes object uart.read(10) # read 10 characters, returns a bytes object

View File

@ -23,7 +23,7 @@ UART objects can be created and initialised using::
*Note:* with parity=None, only 8 and 9 bits are supported. With parity enabled, *Note:* with parity=None, only 8 and 9 bits are supported. With parity enabled,
only 7 and 8 bits are supported. only 7 and 8 bits are supported.
A UART object acts like a stream object and reading and writing is done A UART object acts like a `stream` object and reading and writing is done
using the standard stream methods:: using the standard stream methods::
uart.read(10) # read 10 characters, returns a bytes object uart.read(10) # read 10 characters, returns a bytes object

View File

@ -4,7 +4,7 @@
class USB_VCP -- USB virtual comm port class USB_VCP -- USB virtual comm port
====================================== ======================================
The USB_VCP class allows creation of an object representing the USB The USB_VCP class allows creation of a `stream`-like object representing the USB
virtual comm port. It can be used to read and write data over USB to virtual comm port. It can be used to read and write data over USB to
the connected host. the connected host.
@ -47,7 +47,7 @@ Methods
Read at most ``nbytes`` from the serial device and return them as a Read at most ``nbytes`` from the serial device and return them as a
bytes object. If ``nbytes`` is not specified then the method reads bytes object. If ``nbytes`` is not specified then the method reads
all available bytes from the serial device. all available bytes from the serial device.
USB_VCP stream implicitly works in non-blocking mode, USB_VCP `stream` implicitly works in non-blocking mode,
so if no pending data available, this method will return immediately so if no pending data available, this method will return immediately
with ``None`` value. with ``None`` value.

View File

@ -104,15 +104,15 @@ Constants
.. data:: stderr .. data:: stderr
Standard error stream. Standard error `stream`.
.. data:: stdin .. data:: stdin
Standard input stream. Standard input `stream`.
.. data:: stdout .. data:: stdout
Standard output stream. Standard output `stream`.
.. data:: version .. data:: version

View File

@ -6,7 +6,7 @@
|see_cpython_module| :mod:`python:io`. |see_cpython_module| :mod:`python:io`.
This module contains additional types of stream (file-like) objects This module contains additional types of `stream` (file-like) objects
and helper functions. and helper functions.
Conceptual hierarchy Conceptual hierarchy

View File

@ -91,7 +91,7 @@ Functions
.. function:: dupterm(stream_object, index=0) .. function:: dupterm(stream_object, index=0)
Duplicate or switch the MicroPython terminal (the REPL) on the given stream-like Duplicate or switch the MicroPython terminal (the REPL) on the given `stream`-like
object. The *stream_object* argument must implement the ``readinto()`` and object. The *stream_object* argument must implement the ``readinto()`` and
``write()`` methods. The stream should be in non-blocking mode and ``write()`` methods. The stream should be in non-blocking mode and
``readinto()`` should return ``None`` if there is no data available for reading. ``readinto()`` should return ``None`` if there is no data available for reading.

View File

@ -7,7 +7,7 @@
|see_cpython_module| :mod:`python:select`. |see_cpython_module| :mod:`python:select`.
This module provides functions to efficiently wait for events on multiple This module provides functions to efficiently wait for events on multiple
streams (select streams which are ready for operations). `streams <stream>` (select streams which are ready for operations).
Functions Functions
--------- ---------
@ -33,7 +33,7 @@ Methods
.. method:: poll.register(obj[, eventmask]) .. method:: poll.register(obj[, eventmask])
Register *obj* for polling. *eventmask* is logical OR of: Register `stream` *obj* for polling. *eventmask* is logical OR of:
* `uselect.POLLIN` - data available for reading * `uselect.POLLIN` - data available for reading
* `uselect.POLLOUT` - more data can be written * `uselect.POLLOUT` - more data can be written

View File

@ -12,7 +12,7 @@ This module provides access to the BSD socket interface.
.. admonition:: Difference to CPython .. admonition:: Difference to CPython
:class: attention :class: attention
For efficiency and consistency, socket objects in MicroPython implement a stream For efficiency and consistency, socket objects in MicroPython implement a `stream`
(file-like) interface directly. In CPython, you need to convert a socket to (file-like) interface directly. In CPython, you need to convert a socket to
a file-like object using `makefile()` method. This method is still supported a file-like object using `makefile()` method. This method is still supported
by MicroPython (but is a no-op), so where compatibility with CPython matters, by MicroPython (but is a no-op), so where compatibility with CPython matters,
@ -248,7 +248,7 @@ Methods
Not every `MicroPython port` supports this method. A more portable and Not every `MicroPython port` supports this method. A more portable and
generic solution is to use `uselect.poll` object. This allows to wait on generic solution is to use `uselect.poll` object. This allows to wait on
multiple objects at the same time (and not just on sockets, but on generic multiple objects at the same time (and not just on sockets, but on generic
stream objects which support polling). Example:: `stream` objects which support polling). Example::
# Instead of: # Instead of:
s.settimeout(1.0) # time in seconds s.settimeout(1.0) # time in seconds

View File

@ -15,9 +15,9 @@ Functions
.. function:: ussl.wrap_socket(sock, server_side=False, keyfile=None, certfile=None, cert_reqs=CERT_NONE, ca_certs=None) .. function:: ussl.wrap_socket(sock, server_side=False, keyfile=None, certfile=None, cert_reqs=CERT_NONE, ca_certs=None)
Takes a stream *sock* (usually usocket.socket instance of ``SOCK_STREAM`` type), Takes a `stream` *sock* (usually usocket.socket instance of ``SOCK_STREAM`` type),
and returns an instance of ssl.SSLSocket, which wraps the underlying stream in and returns an instance of ssl.SSLSocket, which wraps the underlying stream in
an SSL context. Returned object has the usual stream interface methods like an SSL context. Returned object has the usual `stream` interface methods like
`read()`, `write()`, etc. In MicroPython, the returned object does not expose `read()`, `write()`, etc. In MicroPython, the returned object does not expose
socket interface and methods like `recv()`, `send()`. In particular, a socket interface and methods like `recv()`, `send()`. In particular, a
server-side SSL socket should be created from a normal socket returned from server-side SSL socket should be created from a normal socket returned from

View File

@ -25,7 +25,7 @@ Functions
.. class:: DecompIO(stream, wbits=0) .. class:: DecompIO(stream, wbits=0)
Create a stream wrapper which allows transparent decompression of Create a `stream` wrapper which allows transparent decompression of
compressed data in another *stream*. This allows to process compressed compressed data in another *stream*. This allows to process compressed
streams with data larger than available heap size. In addition to streams with data larger than available heap size. In addition to
values described in :func:`decompress`, *wbits* may take values values described in :func:`decompress`, *wbits* may take values