From 6562977b6a026761071df890854ac71d446bb3b1 Mon Sep 17 00:00:00 2001 From: Serhiy Storchaka Date: Thu, 9 Jun 2016 16:30:29 +0300 Subject: Issue #26282: PyArg_ParseTupleAndKeywords() and Argument Clinic now support positional-only and keyword parameters in the same function. --- Doc/glossary.rst | 2 ++ 1 file changed, 2 insertions(+) (limited to 'Doc/glossary.rst') diff --git a/Doc/glossary.rst b/Doc/glossary.rst index e7bcb6aecb..b4f3089699 100644 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@ -718,6 +718,8 @@ Glossary def func(foo, bar=None): ... + .. _positional-only_parameter: + * :dfn:`positional-only`: specifies an argument that can be supplied only by position. Python has no syntax for defining positional-only parameters. However, some built-in functions have positional-only -- cgit v1.2.1 From 7fd350e789b7fc82243df2efda7d1f42f30ad7fb Mon Sep 17 00:00:00 2001 From: Brett Cannon Date: Fri, 24 Jun 2016 12:21:47 -0700 Subject: Issue #27186: Define what a "path-like object" is. Thanks to Dusty Phillips for the initial patch. --- Doc/glossary.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) (limited to 'Doc/glossary.rst') diff --git a/Doc/glossary.rst b/Doc/glossary.rst index 43af006a47..fe175951c8 100644 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@ -778,6 +778,16 @@ Glossary One of the default :term:`meta path finders ` which searches an :term:`import path` for modules. + path-like object + An object representing a file system path. A path-like object is either + a :class:`str` or :class:`bytes` object representing a path, or an object + implementing the :class:`os.PathLike` protocol. An object that supports + the :class:`os.PathLike` protocol can be converted to a :class:`str` or + :class:`bytes` file system path by calling the :func:`os.fspath` function; + :func:`os.fsdecode` and :func:`os.fsencode` can be used to guarantee a + :class:`str` or :class:`bytes` result instead, respectively. Introduced + by :pep:`519`. + portion A set of files in a single directory (possibly stored in a zip file) that contribute to a namespace package, as defined in :pep:`420`. -- cgit v1.2.1 From 4ddc501dcb6bd5f6d02140cc9edf0453799ce6d9 Mon Sep 17 00:00:00 2001 From: Brett Cannon Date: Fri, 8 Jul 2016 10:46:21 -0700 Subject: Issue #27285: Document the deprecation of the pyvenv script. As part of the update, the documentation was updated to normalize around the term "virtual environment" instead of relying too heavily on "venv" for the same meaning and leading to inconsistent usage of either. Thanks to Steve Piercy for the patch. --- Doc/glossary.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'Doc/glossary.rst') diff --git a/Doc/glossary.rst b/Doc/glossary.rst index fe175951c8..3d05c14186 100644 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@ -970,7 +970,7 @@ Glossary without interfering with the behaviour of other Python applications running on the same system. - See also :ref:`scripts-pyvenv`. + See also :mod:`venv`. virtual machine A computer defined entirely in software. Python's virtual machine -- cgit v1.2.1 From b164476aaf77ceffac36ddbbdc7f4df90fbfebd3 Mon Sep 17 00:00:00 2001 From: Yury Selivanov Date: Thu, 8 Sep 2016 20:50:03 -0700 Subject: Issue #27985: Implement PEP 526 -- Syntax for Variable Annotations. Patch by Ivan Levkivskyi. --- Doc/glossary.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) (limited to 'Doc/glossary.rst') diff --git a/Doc/glossary.rst b/Doc/glossary.rst index 3d05c14186..f80b6df212 100644 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@ -964,6 +964,18 @@ Glossary ``'\r'``. See :pep:`278` and :pep:`3116`, as well as :func:`bytes.splitlines` for an additional use. + variable annotation + A type metadata value associated with a module global variable or + a class attribute. Its syntax is explained in section :ref:`annassign`. + Annotations are stored in the :attr:`__annotations__` special + attribute of a class or module object and can be accessed using + :func:`typing.get_type_hints`. + + Python itself does not assign any particular meaning to variable + annotations. They are intended to be interpreted by third-party libraries + or type checking tools. See :pep:`526`, :pep:`484` which describe + some of their potential uses. + virtual environment A cooperatively isolated runtime environment that allows Python users and applications to install and upgrade Python distribution packages -- cgit v1.2.1 From 69c7c787341074d465e03a8c0e55ffe9cc1ce8c2 Mon Sep 17 00:00:00 2001 From: Yury Selivanov Date: Thu, 15 Dec 2016 17:36:05 -0500 Subject: Issue #28091: Document PEP 525 & PEP 530. Patch by Eric Appelt. (grafted from 78c8f450b84ca1864123ec487d363eb151f61a4a) --- Doc/glossary.rst | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) (limited to 'Doc/glossary.rst') diff --git a/Doc/glossary.rst b/Doc/glossary.rst index f80b6df212..41ee3d83b3 100644 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@ -74,6 +74,34 @@ Glossary :keyword:`async with` statement by defining :meth:`__aenter__` and :meth:`__aexit__` methods. Introduced by :pep:`492`. + asynchronous generator + A function which returns an :term:`asynchronous generator iterator`. It + looks like a coroutine function defined with :keyword:`async def` except + that it contains :keyword:`yield` expressions for producing a series of + values usable in an :keyword:`async for` loop. + + Usually refers to a asynchronous generator function, but may refer to an + *asynchronous generator iterator* in some contexts. In cases where the + intended meaning isn't clear, using the full terms avoids ambiguity. + + An asynchronous generator function may contain :keyword:`await` + expressions as well as :keyword:`async for`, and :keyword:`async with` + statements. + + asynchronous generator iterator + An object created by a :term:`asynchronous generator` function. + + This is an :term:`asynchronous iterator` which when called using the + :meth:`__anext__` method returns an awaitable object which will execute + that the body of the asynchronous generator function until the + next :keyword:`yield` expression. + + Each :keyword:`yield` temporarily suspends processing, remembering the + location execution state (including local variables and pending + try-statements). When the *asynchronous generator iterator* effectively + resumes with another awaitable returned by :meth:`__anext__`, it + picks-up where it left-off. See :pep:`492` and :pep:`525`. + asynchronous iterable An object, that can be used in an :keyword:`async for` statement. Must return an :term:`asynchronous iterator` from its -- cgit v1.2.1