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.
accidents.)
-.. function:: print([object, ...][, sep=' '][, end='\n'][, file=sys.stdout])
+.. function:: print([object, ...][, sep=' '][, end='\\n'][, file=sys.stdout])
Print *object*\(s) to the stream *file*, separated by *sep* and followed by
*end*. *sep*, *end* and *file*, if present, must be given as keyword
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)
.. method:: Condition.notify()
- Wake up a thread waiting on this condition, if any. Wait until notified or until
- a timeout occurs. If the calling thread has not acquired the lock when this
- method is called, a :exc:`RuntimeError` is raised.
+ Wake up a thread waiting on this condition, if any. If the calling thread
+ has not acquired the lock when this method is called, a :exc:`RuntimeError`
+ is raised.
- This method wakes up one of the threads waiting for the condition variable, if
- any are waiting; it is a no-op if no threads are waiting.
+ This method wakes up one of the threads waiting for the condition variable,
+ if any are waiting; it is a no-op if no threads are waiting.
The current implementation wakes up exactly one thread, if any are waiting.
However, it's not safe to rely on this behavior. A future, optimized
.. 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
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: