Various functions are available for calling a Python object.
Each converts its arguments to a convention supported by the called object –
either *tp_call* or vectorcall.
-In order to do as litle conversion as possible, pick one that best fits
+In order to do as little conversion as possible, pick one that best fits
the format of data you have available.
The following table summarizes the available functions;
* The :ref:`Isolated Configuration <init-isolated-conf>` can be used to embed
Python into an application. It isolates Python from the system. For example,
environments variables are ignored, the LC_CTYPE locale is left unchanged and
- no signal handler is registred.
+ no signal handler is registered.
The :c:func:`Py_RunMain` function can be used to write a customized Python
program.
* Otherwise, use the :term:`locale encoding`:
``nl_langinfo(CODESET)`` result.
- At Python statup, the encoding name is normalized to the Python codec
+ At Python startup, the encoding name is normalized to the Python codec
name. For example, ``"ANSI_X3.4-1968"`` is replaced with ``"ascii"``.
See also the :c:member:`~PyConfig.filesystem_errors` member.
For technical reasons, a generator used directly as a context manager
would not work correctly. When, as is most common, a generator is used as
an iterator run to completion, no closing is needed. When it is, wrap
-it as "contextlib.closing(generator)" in the 'with' statment.
+it as "contextlib.closing(generator)" in the 'with' statement.
Why are colons required for the if/while/def/class statements?
If source contains a null character ('\0'), :exc:`ValueError` is raised.
.. warning::
- Note that succesfully parsing souce code into an AST object doesn't
+ Note that successfully parsing source code into an AST object doesn't
guarantee that the source code provided is valid Python code that can
be executed as the compilation step can raise further :exc:`SyntaxError`
exceptions. For instance, the source ``return 42`` generates a valid
This version does not allow the digit 0 (zero) to the letter O (oh) and digit
1 (one) to either the letter I (eye) or letter L (el) mappings, all these
characters are included in the Extended Hex Alphabet and are not
- interchangable.
+ interchangeable.
.. versionadded:: 3.10
of the stack and sets the ``f_lasti`` attribute of the frame with that value.
Then pops the next exception from the stack uses it to restore the current exception.
Finally it re-raises the originally popped exception.
- Used in excpetion handler cleanup.
+ Used in exception handler cleanup.
.. versionadded:: 3.11
---------------
-Utilites and Decorators
------------------------
+Utilities and Decorators
+------------------------
.. class:: auto
*openhook* parameter to :func:`fileinput.input` or :class:`FileInput()`. The
hook must be a function that takes two arguments, *filename* and *mode*, and
returns an accordingly opened file-like object. If *encoding* and/or *errors*
-are specified, they will be passed to the hook as aditional keyword arguments.
+are specified, they will be passed to the hook as additional keyword arguments.
This module provides a :func:`hook_compressed` to support compressed files.
The following function is the primary interface of this module:
Package distributions
---------------------
-A convience method to resolve the distribution or
+A convenience method to resolve the distribution or
distributions (in the case of a namespace package) for top-level
Python packages or modules::
Context manager catching :class:`threading.Thread` exception using
:func:`threading.excepthook`.
- Attributes set when an exception is catched:
+ Attributes set when an exception is caught:
* ``exc_type``
* ``exc_value``
.. function:: unlink(filename)
Call :func:`os.unlink` on *filename*. On Windows platforms, this is
- wrapped with a wait loop that checks for the existence fo the file.
+ wrapped with a wait loop that checks for the existence of the file.
:mod:`test.support.import_helper` --- Utilities for import tests
.. note::
A future version of Python may stop setting this attribute by default.
- To guard against this potential change, preferrably read from the
+ To guard against this potential change, preferably read from the
:attr:`__spec__` attribute instead or use
``getattr(module, "__loader__", None)`` if you explicitly need to use
this attribute.
.. note::
A future version of Python may stop setting this attribute by default.
- To guard against this potential change, preferrably read from the
+ To guard against this potential change, preferably read from the
:attr:`__spec__` attribute instead or use
``getattr(module, "__package__", None)`` if you explicitly need to use
this attribute.
``__file__`` is optional (if set, value must be a string). It indicates
the pathname of the file from which the module was loaded (if
- loaded from a file), or the pathname of the shared libray file
+ loaded from a file), or the pathname of the shared library file
for extension modules loaded dynamically from a shared library.
It might be missing for certain types of modules, such as C
modules that are statically linked into the interpreter, and the
"""Tool to remove comments from given lines.
It yields empty lines in place of comments, so line numbers are
- still meaningfull.
+ still meaningful.
"""
in_multiline_comment = False
for line in lines:
* ``-X no_debug_ranges`` disables the inclusion of the tables mapping extra
location information (end line, start column offset and end column offset)
to every instruction in code objects. This is useful when smaller code
- objects and pyc files are desired as well as supressing the extra visual
+ objects and pyc files are desired as well as suppressing the extra visual
location indicators when the interpreter displays tracebacks. See also
:envvar:`PYTHONNODEBUGRANGES`.
* ``-X frozen_modules`` determines whether or not frozen modules are
If this variable is set, it disables the inclusion of the tables mapping
extra location information (end line, start column offset and end column
offset) to every instruction in code objects. This is useful when smaller
- code objects and pyc files are desired as well as supressing the extra visual
+ code objects and pyc files are desired as well as suppressing the extra visual
location indicators when the interpreter displays tracebacks.
.. versionadded:: 3.11
File "<stdin>", line 1, in <module>
AttributeError: module 'sys' has no attribute '__file__'
-Other C extensions are built as dynamic libraires, like the ``_asyncio`` module.
+Other C extensions are built as dynamic libraries, like the ``_asyncio`` module.
They are built with the ``Py_BUILD_CORE_MODULE`` macro defined.
Example on Linux x86-64::
* Currently Python accepts numeric literals immediately followed by keywords,
for example ``0in x``, ``1or x``, ``0if 1else 2``. It allows confusing
- and ambigious expressions like ``[0x1for x in y]`` (which can be
+ and ambiguous expressions like ``[0x1for x in y]`` (which can be
interpreted as ``[0x1 for x in y]`` or ``[0x1f or x in y]``). Starting in
this release, a deprecation warning is raised if the numeric literal is
immediately followed by one of keywords :keyword:`and`, :keyword:`else`,
if the *globals* dictionary has no ``"__builtins__"`` key, rather than using
``{"None": None}`` as builtins: same behavior as :func:`eval` and
:func:`exec` functions. Defining a function with ``def function(...): ...``
- in Python is not affected, globals cannot be overriden with this syntax: it
+ in Python is not affected, globals cannot be overridden with this syntax: it
also inherits the current builtins.
(Contributed by Victor Stinner in :issue:`42990`.)
projects / thirdparty / Python / cpython.git / commitdiff
