Mailman 3 June 2018 - Python-checkins

bpo-27500: Fix static version of getaddrinfo to resolve IPv6 (GH-7993)
by Miss Islington (bot) June 29, 2018

June 29, 2018

https://github.com/python/cpython/commit/3ed44141216aa1d2d8dd7d170c2dc216a6… commit: 3ed44141216aa1d2d8dd7d170c2dc216a6e718b6 branch: 3.7 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: GitHub <noreply(a)github.com> date: 2018-06-28T19:16:48-07:00 summary: bpo-27500: Fix static version of getaddrinfo to resolve IPv6 (GH-7993) (cherry picked from commit d904c238ca3551750cb97d15d827c3e525970867) Co-authored-by: Yury Selivanov <yury(a)… [View More]magic.io> files: A Misc/NEWS.d/next/Library/2018-06-28-13-00-12.bpo-27500._s1gZ5.rst M Lib/asyncio/base_events.py M Lib/test/test_asyncio/test_base_events.py diff --git a/Lib/asyncio/base_events.py b/Lib/asyncio/base_events.py index 6b4756ad0882..dc0ca3f02b9b 100644 --- a/Lib/asyncio/base_events.py +++ b/Lib/asyncio/base_events.py @@ -61,6 +61,8 @@ _FATAL_ERROR_IGNORE = (BrokenPipeError, ConnectionResetError, ConnectionAbortedError) +_HAS_IPv6 = hasattr(socket, 'AF_INET6') + def _format_handle(handle): cb = handle._callback @@ -123,7 +125,7 @@ def _ipaddr_info(host, port, family, type, proto): if family == socket.AF_UNSPEC: afs = [socket.AF_INET] - if hasattr(socket, 'AF_INET6'): + if _HAS_IPv6: afs.append(socket.AF_INET6) else: afs = [family] @@ -139,7 +141,10 @@ def _ipaddr_info(host, port, family, type, proto): try: socket.inet_pton(af, host) # The host has already been resolved. - return af, type, proto, '', (host, port) + if _HAS_IPv6 and af == socket.AF_INET6: + return af, type, proto, '', (host, port, 0, 0) + else: + return af, type, proto, '', (host, port) except OSError: pass @@ -1309,7 +1314,6 @@ def _check_sendfile_params(self, sock, file, offset, count): raise ValueError( 'host/port and sock can not be specified at the same time') - AF_INET6 = getattr(socket, 'AF_INET6', 0) if reuse_address is None: reuse_address = os.name == 'posix' and sys.platform != 'cygwin' sockets = [] @@ -1349,7 +1353,9 @@ def _check_sendfile_params(self, sock, file, offset, count): # Disable IPv4/IPv6 dual stack support (enabled by # default on Linux) which makes a single socket # listen on both address families. - if af == AF_INET6 and hasattr(socket, 'IPPROTO_IPV6'): + if (_HAS_IPv6 and + af == socket.AF_INET6 and + hasattr(socket, 'IPPROTO_IPV6')): sock.setsockopt(socket.IPPROTO_IPV6, socket.IPV6_V6ONLY, True) diff --git a/Lib/test/test_asyncio/test_base_events.py b/Lib/test/test_asyncio/test_base_events.py index 11e9465d3921..8733ac0f566c 100644 --- a/Lib/test/test_asyncio/test_base_events.py +++ b/Lib/test/test_asyncio/test_base_events.py @@ -93,11 +93,11 @@ def test_ipaddr_info(self): base_events._ipaddr_info('1.2.3.4', 1, INET6, STREAM, TCP)) self.assertEqual( - (INET6, STREAM, TCP, '', ('::3', 1)), + (INET6, STREAM, TCP, '', ('::3', 1, 0, 0)), base_events._ipaddr_info('::3', 1, INET6, STREAM, TCP)) self.assertEqual( - (INET6, STREAM, TCP, '', ('::3', 1)), + (INET6, STREAM, TCP, '', ('::3', 1, 0, 0)), base_events._ipaddr_info('::3', 1, UNSPEC, STREAM, TCP)) # IPv6 address with family IPv4. @@ -1073,6 +1073,26 @@ def test_create_server_stream_bittype(self): srv.close() self.loop.run_until_complete(srv.wait_closed()) + @unittest.skipUnless(hasattr(socket, 'AF_INET6'), 'no IPv6 support') + def test_create_server_ipv6(self): + async def main(): + srv = await asyncio.start_server( + lambda: None, '::1', 0, loop=self.loop) + try: + self.assertGreater(len(srv.sockets), 0) + finally: + srv.close() + await srv.wait_closed() + + try: + self.loop.run_until_complete(main()) + except OSError as ex: + if (hasattr(errno, 'EADDRNOTAVAIL') and + ex.errno == errno.EADDRNOTAVAIL): + self.skipTest('failed to bind to ::1') + else: + raise + def test_create_datagram_endpoint_wrong_sock(self): sock = socket.socket(socket.AF_INET) with sock: diff --git a/Misc/NEWS.d/next/Library/2018-06-28-13-00-12.bpo-27500._s1gZ5.rst b/Misc/NEWS.d/next/Library/2018-06-28-13-00-12.bpo-27500._s1gZ5.rst new file mode 100644 index 000000000000..4762e2795643 --- /dev/null +++ b/Misc/NEWS.d/next/Library/2018-06-28-13-00-12.bpo-27500._s1gZ5.rst @@ -0,0 +1 @@ +Fix getaddrinfo to resolve IPv6 addresses correctly. [View Less]

1 0

bpo-27500: Fix static version of getaddrinfo to resolve IPv6 (GH-7993)
by Yury Selivanov June 29, 2018

June 29, 2018

https://github.com/python/cpython/commit/d904c238ca3551750cb97d15d827c3e525… commit: d904c238ca3551750cb97d15d827c3e525970867 branch: master author: Yury Selivanov <yury(a)magic.io> committer: GitHub <noreply(a)github.com> date: 2018-06-28T21:59:32-04:00 summary: bpo-27500: Fix static version of getaddrinfo to resolve IPv6 (GH-7993) files: A Misc/NEWS.d/next/Library/2018-06-28-13-00-12.bpo-27500._s1gZ5.rst M Lib/asyncio/base_events.py M Lib/test/test_asyncio/test_base_events.py … [View More]diff --git a/Lib/asyncio/base_events.py b/Lib/asyncio/base_events.py index 6b4756ad0882..dc0ca3f02b9b 100644 --- a/Lib/asyncio/base_events.py +++ b/Lib/asyncio/base_events.py @@ -61,6 +61,8 @@ _FATAL_ERROR_IGNORE = (BrokenPipeError, ConnectionResetError, ConnectionAbortedError) +_HAS_IPv6 = hasattr(socket, 'AF_INET6') + def _format_handle(handle): cb = handle._callback @@ -123,7 +125,7 @@ def _ipaddr_info(host, port, family, type, proto): if family == socket.AF_UNSPEC: afs = [socket.AF_INET] - if hasattr(socket, 'AF_INET6'): + if _HAS_IPv6: afs.append(socket.AF_INET6) else: afs = [family] @@ -139,7 +141,10 @@ def _ipaddr_info(host, port, family, type, proto): try: socket.inet_pton(af, host) # The host has already been resolved. - return af, type, proto, '', (host, port) + if _HAS_IPv6 and af == socket.AF_INET6: + return af, type, proto, '', (host, port, 0, 0) + else: + return af, type, proto, '', (host, port) except OSError: pass @@ -1309,7 +1314,6 @@ def _check_sendfile_params(self, sock, file, offset, count): raise ValueError( 'host/port and sock can not be specified at the same time') - AF_INET6 = getattr(socket, 'AF_INET6', 0) if reuse_address is None: reuse_address = os.name == 'posix' and sys.platform != 'cygwin' sockets = [] @@ -1349,7 +1353,9 @@ def _check_sendfile_params(self, sock, file, offset, count): # Disable IPv4/IPv6 dual stack support (enabled by # default on Linux) which makes a single socket # listen on both address families. - if af == AF_INET6 and hasattr(socket, 'IPPROTO_IPV6'): + if (_HAS_IPv6 and + af == socket.AF_INET6 and + hasattr(socket, 'IPPROTO_IPV6')): sock.setsockopt(socket.IPPROTO_IPV6, socket.IPV6_V6ONLY, True) diff --git a/Lib/test/test_asyncio/test_base_events.py b/Lib/test/test_asyncio/test_base_events.py index e333950e1e1c..bda8cc6e3a82 100644 --- a/Lib/test/test_asyncio/test_base_events.py +++ b/Lib/test/test_asyncio/test_base_events.py @@ -97,11 +97,11 @@ def test_ipaddr_info(self): base_events._ipaddr_info('1.2.3.4', 1, INET6, STREAM, TCP)) self.assertEqual( - (INET6, STREAM, TCP, '', ('::3', 1)), + (INET6, STREAM, TCP, '', ('::3', 1, 0, 0)), base_events._ipaddr_info('::3', 1, INET6, STREAM, TCP)) self.assertEqual( - (INET6, STREAM, TCP, '', ('::3', 1)), + (INET6, STREAM, TCP, '', ('::3', 1, 0, 0)), base_events._ipaddr_info('::3', 1, UNSPEC, STREAM, TCP)) # IPv6 address with family IPv4. @@ -1077,6 +1077,26 @@ def test_create_server_stream_bittype(self): srv.close() self.loop.run_until_complete(srv.wait_closed()) + @unittest.skipUnless(hasattr(socket, 'AF_INET6'), 'no IPv6 support') + def test_create_server_ipv6(self): + async def main(): + srv = await asyncio.start_server( + lambda: None, '::1', 0, loop=self.loop) + try: + self.assertGreater(len(srv.sockets), 0) + finally: + srv.close() + await srv.wait_closed() + + try: + self.loop.run_until_complete(main()) + except OSError as ex: + if (hasattr(errno, 'EADDRNOTAVAIL') and + ex.errno == errno.EADDRNOTAVAIL): + self.skipTest('failed to bind to ::1') + else: + raise + def test_create_datagram_endpoint_wrong_sock(self): sock = socket.socket(socket.AF_INET) with sock: diff --git a/Misc/NEWS.d/next/Library/2018-06-28-13-00-12.bpo-27500._s1gZ5.rst b/Misc/NEWS.d/next/Library/2018-06-28-13-00-12.bpo-27500._s1gZ5.rst new file mode 100644 index 000000000000..4762e2795643 --- /dev/null +++ b/Misc/NEWS.d/next/Library/2018-06-28-13-00-12.bpo-27500._s1gZ5.rst @@ -0,0 +1 @@ +Fix getaddrinfo to resolve IPv6 addresses correctly. [View Less]

1 0

Update 2.7 doc templates for 3.7.0 (GH-7996)
by Ned Deily June 28, 2018

June 28, 2018

https://github.com/python/cpython/commit/11ba050986b96701f72f1356d22adde8c7… commit: 11ba050986b96701f72f1356d22adde8c7dbf211 branch: 2.7 author: Ned Deily <nad(a)python.org> committer: GitHub <noreply(a)github.com> date: 2018-06-28T15:20:35-04:00 summary: Update 2.7 doc templates for 3.7.0 (GH-7996) files: M Doc/tools/static/switchers.js M Doc/tools/templates/indexsidebar.html diff --git a/Doc/tools/static/switchers.js b/Doc/tools/static/switchers.js index 8e0c5ea0092a..… [View More]

1 0

bpo-31546: Fix input hook integration (GH-7978)
by Steve Dower June 28, 2018

June 28, 2018

https://github.com/python/cpython/commit/9d92524c11def666a78ff57a9603a9ad61… commit: 9d92524c11def666a78ff57a9603a9ad6142418a branch: 3.7 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: Steve Dower <steve.dower(a)microsoft.com> date: 2018-06-28T10:48:37-07:00 summary: bpo-31546: Fix input hook integration (GH-7978) (cherry picked from commit 9b9d58f0d88b338eb8d2ae0da5cd91d60d1b0e39) Co-authored-by: Thomas A Caswell <tcaswell(a)gmail.… [View More]

1 0

bpo-31546: Fix input hook integration (GH-7978)
by Miss Islington (bot) June 28, 2018

June 28, 2018

https://github.com/python/cpython/commit/0ebd1bc94a941a5044e26de946c1100d65… commit: 0ebd1bc94a941a5044e26de946c1100d652dfe46 branch: 3.6 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: GitHub <noreply(a)github.com> date: 2018-06-28T10:47:54-07:00 summary: bpo-31546: Fix input hook integration (GH-7978) (cherry picked from commit 9b9d58f0d88b338eb8d2ae0da5cd91d60d1b0e39) Co-authored-by: Thomas A Caswell <tcaswell(a)gmail.com> … [View More]

1 0

bpo-33985: Implement ContextVar.name attribute. (GH-7980)
by Miss Islington (bot) June 28, 2018

June 28, 2018

https://github.com/python/cpython/commit/4c20d2bf5daaaa174260558c71052b73d7… commit: 4c20d2bf5daaaa174260558c71052b73d73b6c34 branch: 3.7 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: GitHub <noreply(a)github.com> date: 2018-06-28T10:39:54-07:00 summary: bpo-33985: Implement ContextVar.name attribute. (GH-7980) (cherry picked from commit 41cb0baea96a80360971908a0bd79d9d40dd5e44) Co-authored-by: Yury Selivanov <yury(a)magic.io> … [View More]files: A Misc/NEWS.d/next/Core and Builtins/2018-06-27-18-56-41.bpo-33985.ILJ3Af.rst M Doc/library/contextvars.rst M Lib/test/test_context.py M Python/context.c diff --git a/Doc/library/contextvars.rst b/Doc/library/contextvars.rst index 9c7ea2bdb7b6..8805661c456e 100644 --- a/Doc/library/contextvars.rst +++ b/Doc/library/contextvars.rst @@ -48,6 +48,8 @@ Context Variables The name of the variable. This is a read-only property. + .. versionadded:: 3.7.1 + .. method:: get([default]) Return a value for the context variable for the current context. diff --git a/Lib/test/test_context.py b/Lib/test/test_context.py index 74d05fc5c412..efd7319a23ae 100644 --- a/Lib/test/test_context.py +++ b/Lib/test/test_context.py @@ -30,8 +30,13 @@ def test_context_var_new_1(self): with self.assertRaisesRegex(TypeError, 'must be a str'): contextvars.ContextVar(1) - c = contextvars.ContextVar('a') - self.assertNotEqual(hash(c), hash('a')) + c = contextvars.ContextVar('aaa') + self.assertEqual(c.name, 'aaa') + + with self.assertRaises(AttributeError): + c.name = 'bbb' + + self.assertNotEqual(hash(c), hash('aaa')) def test_context_var_new_2(self): self.assertIsNone(contextvars.ContextVar[int]) diff --git a/Misc/NEWS.d/next/Core and Builtins/2018-06-27-18-56-41.bpo-33985.ILJ3Af.rst b/Misc/NEWS.d/next/Core and Builtins/2018-06-27-18-56-41.bpo-33985.ILJ3Af.rst new file mode 100644 index 000000000000..07c8f9078686 --- /dev/null +++ b/Misc/NEWS.d/next/Core and Builtins/2018-06-27-18-56-41.bpo-33985.ILJ3Af.rst @@ -0,0 +1 @@ +Implement contextvars.ContextVar.name attribute. diff --git a/Python/context.c b/Python/context.c index b727748ee739..8ee048ccdd5c 100644 --- a/Python/context.c +++ b/Python/context.c @@ -940,6 +940,10 @@ contextvar_cls_getitem(PyObject *self, PyObject *args) Py_RETURN_NONE; } +static PyMemberDef PyContextVar_members[] = { + {"name", T_OBJECT, offsetof(PyContextVar, var_name), READONLY}, + {NULL} +}; static PyMethodDef PyContextVar_methods[] = { _CONTEXTVARS_CONTEXTVAR_GET_METHODDEF @@ -955,6 +959,7 @@ PyTypeObject PyContextVar_Type = { "ContextVar", sizeof(PyContextVar), .tp_methods = PyContextVar_methods, + .tp_members = PyContextVar_members, .tp_dealloc = (destructor)contextvar_tp_dealloc, .tp_getattro = PyObject_GenericGetAttr, .tp_flags = Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_GC, [View Less]

1 0

bpo-33985: Implement ContextVar.name attribute. (GH-7980)
by Yury Selivanov June 28, 2018

June 28, 2018

https://github.com/python/cpython/commit/41cb0baea96a80360971908a0bd79d9d40… commit: 41cb0baea96a80360971908a0bd79d9d40dd5e44 branch: master author: Yury Selivanov <yury(a)magic.io> committer: GitHub <noreply(a)github.com> date: 2018-06-28T13:20:29-04:00 summary: bpo-33985: Implement ContextVar.name attribute. (GH-7980) files: A Misc/NEWS.d/next/Core and Builtins/2018-06-27-18-56-41.bpo-33985.ILJ3Af.rst M Doc/library/contextvars.rst M Lib/test/test_context.py M Python/context.c … [View More]diff --git a/Doc/library/contextvars.rst b/Doc/library/contextvars.rst index 9c7ea2bdb7b6..8805661c456e 100644 --- a/Doc/library/contextvars.rst +++ b/Doc/library/contextvars.rst @@ -48,6 +48,8 @@ Context Variables The name of the variable. This is a read-only property. + .. versionadded:: 3.7.1 + .. method:: get([default]) Return a value for the context variable for the current context. diff --git a/Lib/test/test_context.py b/Lib/test/test_context.py index 74d05fc5c412..efd7319a23ae 100644 --- a/Lib/test/test_context.py +++ b/Lib/test/test_context.py @@ -30,8 +30,13 @@ def test_context_var_new_1(self): with self.assertRaisesRegex(TypeError, 'must be a str'): contextvars.ContextVar(1) - c = contextvars.ContextVar('a') - self.assertNotEqual(hash(c), hash('a')) + c = contextvars.ContextVar('aaa') + self.assertEqual(c.name, 'aaa') + + with self.assertRaises(AttributeError): + c.name = 'bbb' + + self.assertNotEqual(hash(c), hash('aaa')) def test_context_var_new_2(self): self.assertIsNone(contextvars.ContextVar[int]) diff --git a/Misc/NEWS.d/next/Core and Builtins/2018-06-27-18-56-41.bpo-33985.ILJ3Af.rst b/Misc/NEWS.d/next/Core and Builtins/2018-06-27-18-56-41.bpo-33985.ILJ3Af.rst new file mode 100644 index 000000000000..07c8f9078686 --- /dev/null +++ b/Misc/NEWS.d/next/Core and Builtins/2018-06-27-18-56-41.bpo-33985.ILJ3Af.rst @@ -0,0 +1 @@ +Implement contextvars.ContextVar.name attribute. diff --git a/Python/context.c b/Python/context.c index b727748ee739..8ee048ccdd5c 100644 --- a/Python/context.c +++ b/Python/context.c @@ -940,6 +940,10 @@ contextvar_cls_getitem(PyObject *self, PyObject *args) Py_RETURN_NONE; } +static PyMemberDef PyContextVar_members[] = { + {"name", T_OBJECT, offsetof(PyContextVar, var_name), READONLY}, + {NULL} +}; static PyMethodDef PyContextVar_methods[] = { _CONTEXTVARS_CONTEXTVAR_GET_METHODDEF @@ -955,6 +959,7 @@ PyTypeObject PyContextVar_Type = { "ContextVar", sizeof(PyContextVar), .tp_methods = PyContextVar_methods, + .tp_members = PyContextVar_members, .tp_dealloc = (destructor)contextvar_tp_dealloc, .tp_getattro = PyObject_GenericGetAttr, .tp_flags = Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_GC, [View Less]

1 0

bpo-31546: Fix input hook integration (GH-7978)
by Steve Dower June 28, 2018

June 28, 2018

https://github.com/python/cpython/commit/9b9d58f0d88b338eb8d2ae0da5cd91d60d… commit: 9b9d58f0d88b338eb8d2ae0da5cd91d60d1b0e39 branch: master author: Thomas A Caswell <tcaswell(a)gmail.com> committer: Steve Dower <steve.dower(a)microsoft.com> date: 2018-06-28T09:29:44-07:00 summary: bpo-31546: Fix input hook integration (GH-7978) files: A Misc/NEWS.d/next/Windows/2018-06-27-23-33-54.bpo-31546.zJlap-.rst M Parser/myreadline.c diff --git a/Misc/NEWS.d/next/Windows/2018-06-27-23-33-… [View More]

1 0

bpo-32996: Enhancements to What's New based on feedback (GH-7988)
by Miss Islington (bot) June 28, 2018

June 28, 2018

https://github.com/python/cpython/commit/48dc7527e32512a27a58107477926719ea… commit: 48dc7527e32512a27a58107477926719ea4c589b branch: 3.7 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: GitHub <noreply(a)github.com> date: 2018-06-28T09:14:52-07:00 summary: bpo-32996: Enhancements to What's New based on feedback (GH-7988) (cherry picked from commit 4d26c8a177d8ada440b3cfdfb1d0423ab5ca81a7) Co-authored-by: Elvis Pranskevichus <elvis(a)… [View More]magic.io> files: M Doc/whatsnew/3.7.rst diff --git a/Doc/whatsnew/3.7.rst b/Doc/whatsnew/3.7.rst index a04b15ccecf8..53fbe185a3ad 100644 --- a/Doc/whatsnew/3.7.rst +++ b/Doc/whatsnew/3.7.rst @@ -320,7 +320,8 @@ PEP 562: Customization of Access to Module Attributes ----------------------------------------------------- Python 3.7 allows defining :meth:`__getattr__` on modules and will call -it whenever a module attribute is otherwise not found. +it whenever a module attribute is otherwise not found. Defining +:meth:`__dir__` on modules is now also allowed. A typical example of where this may be useful is module attribute deprecation and lazy loading. @@ -336,8 +337,11 @@ and lazy loading. PEP 564: New Time Functions With Nanosecond Resolution ------------------------------------------------------ -:pep:`564` adds six new "nanosecond" variants of existing functions -to the :mod:`time` module: +The resolution of clocks in modern systems can exceed the limited precision +of a floating point number returned by the :func:`time.time` function +and its variants. To avoid loss of precision, :pep:`564` adds six new +"nanosecond" variants of the existing timer functions to the :mod:`time` +module: * :func:`time.clock_gettime_ns` * :func:`time.clock_settime_ns` @@ -346,12 +350,11 @@ to the :mod:`time` module: * :func:`time.process_time_ns` * :func:`time.time_ns` -The new functions are similar in function to the existing functions -without the ``_ns`` suffix. They differ by returning nanoseconds as -integers instead of fractional seconds. +The new functions return the number of nanoseconds as an integer value. -On Linux and Windows the resolution of :func:`time.time_ns` is 3 times -better than that of :func:`time.time`. +`Measurements <https://www.python.org/dev/peps/pep-0564/#annex-clocks-resolution-in-python>`_ +show that on Linux and Windows the resolution of :func:`time.time_ns` is +approximately 3 times better than that of :func:`time.time`. .. seealso:: @@ -418,19 +421,6 @@ fixed. PEP written and implemented by Ivan Levkivskyi -.. _whatsnew37-devmode: - -Development Runtime Mode: -X dev --------------------------------- - -The new :option:`-X` ``dev`` command line option or the new -:envvar:`PYTHONDEVMODE` environment variable can be used to enable -CPython's *development mode*. When in development mode, CPython performs -additional runtime checks which are too expensive to be enabled by default. -See :option:`-X` ``dev`` documentation for the full description of the effects -of this mode. - - .. _whatsnew37-pep552: PEP 552: Hash-based .pyc Files @@ -460,6 +450,11 @@ keeping ``.pyc`` files up-to-date. See :ref:`pyc-invalidation` for more information. +.. seealso:: + + :pep:`552` -- Deterministic pycs + PEP written and implemented by Benjamin Peterson + .. _whatsnew37-pep545: @@ -482,6 +477,19 @@ Three new translations have been added: Victor Stinner. +.. _whatsnew37-devmode: + +Development Runtime Mode: -X dev +-------------------------------- + +The new :option:`-X` ``dev`` command line option or the new +:envvar:`PYTHONDEVMODE` environment variable can be used to enable +CPython's *development mode*. When in development mode, CPython performs +additional runtime checks that are too expensive to be enabled by default. +See :option:`-X` ``dev`` documentation for the full description of the effects +of this mode. + + Other Language Changes ====================== [View Less]

1 0

bpo-32996: Enhancements to What's New based on feedback (GH-7988)
by Yury Selivanov June 28, 2018

June 28, 2018

https://github.com/python/cpython/commit/4d26c8a177d8ada440b3cfdfb1d0423ab5… commit: 4d26c8a177d8ada440b3cfdfb1d0423ab5ca81a7 branch: master author: Elvis Pranskevichus <elvis(a)magic.io> committer: Yury Selivanov <yury(a)magic.io> date: 2018-06-28T11:57:37-04:00 summary: bpo-32996: Enhancements to What's New based on feedback (GH-7988) files: M Doc/whatsnew/3.7.rst diff --git a/Doc/whatsnew/3.7.rst b/Doc/whatsnew/3.7.rst index a04b15ccecf8..53fbe185a3ad 100644 --- a/Doc/whatsnew/… [View More]3.7.rst +++ b/Doc/whatsnew/3.7.rst @@ -320,7 +320,8 @@ PEP 562: Customization of Access to Module Attributes ----------------------------------------------------- Python 3.7 allows defining :meth:`__getattr__` on modules and will call -it whenever a module attribute is otherwise not found. +it whenever a module attribute is otherwise not found. Defining +:meth:`__dir__` on modules is now also allowed. A typical example of where this may be useful is module attribute deprecation and lazy loading. @@ -336,8 +337,11 @@ and lazy loading. PEP 564: New Time Functions With Nanosecond Resolution ------------------------------------------------------ -:pep:`564` adds six new "nanosecond" variants of existing functions -to the :mod:`time` module: +The resolution of clocks in modern systems can exceed the limited precision +of a floating point number returned by the :func:`time.time` function +and its variants. To avoid loss of precision, :pep:`564` adds six new +"nanosecond" variants of the existing timer functions to the :mod:`time` +module: * :func:`time.clock_gettime_ns` * :func:`time.clock_settime_ns` @@ -346,12 +350,11 @@ to the :mod:`time` module: * :func:`time.process_time_ns` * :func:`time.time_ns` -The new functions are similar in function to the existing functions -without the ``_ns`` suffix. They differ by returning nanoseconds as -integers instead of fractional seconds. +The new functions return the number of nanoseconds as an integer value. -On Linux and Windows the resolution of :func:`time.time_ns` is 3 times -better than that of :func:`time.time`. +`Measurements <https://www.python.org/dev/peps/pep-0564/#annex-clocks-resolution-in-python>`_ +show that on Linux and Windows the resolution of :func:`time.time_ns` is +approximately 3 times better than that of :func:`time.time`. .. seealso:: @@ -418,19 +421,6 @@ fixed. PEP written and implemented by Ivan Levkivskyi -.. _whatsnew37-devmode: - -Development Runtime Mode: -X dev --------------------------------- - -The new :option:`-X` ``dev`` command line option or the new -:envvar:`PYTHONDEVMODE` environment variable can be used to enable -CPython's *development mode*. When in development mode, CPython performs -additional runtime checks which are too expensive to be enabled by default. -See :option:`-X` ``dev`` documentation for the full description of the effects -of this mode. - - .. _whatsnew37-pep552: PEP 552: Hash-based .pyc Files @@ -460,6 +450,11 @@ keeping ``.pyc`` files up-to-date. See :ref:`pyc-invalidation` for more information. +.. seealso:: + + :pep:`552` -- Deterministic pycs + PEP written and implemented by Benjamin Peterson + .. _whatsnew37-pep545: @@ -482,6 +477,19 @@ Three new translations have been added: Victor Stinner. +.. _whatsnew37-devmode: + +Development Runtime Mode: -X dev +-------------------------------- + +The new :option:`-X` ``dev`` command line option or the new +:envvar:`PYTHONDEVMODE` environment variable can be used to enable +CPython's *development mode*. When in development mode, CPython performs +additional runtime checks that are too expensive to be enabled by default. +See :option:`-X` ``dev`` documentation for the full description of the effects +of this mode. + + Other Language Changes ====================== [View Less]

1 0