return _logger
_logger = logging.getLogger('distributing')
-_logger.propogate = 0
+_logger.propagate = 0
_formatter = logging.Formatter(util.DEFAULT_LOGGING_FORMAT)
_handler = logging.StreamHandler()
No feature description will ever be deleted from :mod:`__future__`.
+.. seealso::
+
+ :ref:`future`
+ How the compiler treats future imports.
If the contents of *fp* are encoded with an ASCII based encoding other than
UTF-8 (e.g. latin-1), then an appropriate *encoding* name must be specified.
Encodings that are not ASCII based (such as UCS-2) are not allowed, and
- should be wrapped with ``codecs.getreader(fp)(encoding)``, or simply decoded
+ should be wrapped with ``codecs.getreader(encoding)(fp)``, or simply decoded
to a :class:`unicode` object and passed to :func:`loads`.
*object_hook* is an optional function that will be called with the result of
.. note::
- The file-like object is read-only and provides the following methods:
- :meth:`read`, :meth:`readline`, :meth:`readlines`, :meth:`seek`, :meth:`tell`.
+ The file-like object is read-only. It provides the methods
+ :meth:`read`, :meth:`readline`, :meth:`readlines`, :meth:`seek`, :meth:`tell`,
+ and :meth:`close`, and also supports iteration over its lines.
.. method:: TarFile.add(name, arcname=None, recursive=True, exclude=None)
.. function:: screensize(canvwidth=None, canvheight=None, bg=None)
- :param canvwidth: positive integer, new width of canvas in pixels :param
- canvheight: positive integer, new height of canvas in pixels :param bg:
- colorstring or color-tuple, new background color
+ :param canvwidth: positive integer, new width of canvas in pixels
+ :param canvheight: positive integer, new height of canvas in pixels
+ :param bg: colorstring or color-tuple, new background color
If no arguments are given, return current (canvaswidth, canvasheight). Else
resize the canvas the turtles are drawing on. Do not alter the drawing
assert_(expr[, msg])
failUnless(expr[, msg])
- Signal a test failure if *expr* is false; the explanation for the error
+ Signal a test failure if *expr* is false; the explanation for the failure
will be *msg* if given, otherwise it will be :const:`None`.
.. deprecated:: 3.1
a future statement, it will be in effect in the interactive session started
after the script is executed.
+.. seealso::
+
+ :pep:`236` - Back to the __future__
+ The original proposal for the __future__ mechanism.
+
.. _global: