Qué hay de nuevo en Python 3.6
******************************

Editors:
   Elvis Pranskevichus <elvis@magic.io>, Yury Selivanov
   <yury@magic.io>

This article explains the new features in Python 3.6, compared to 3.5.
Python 3.6 was released on December 23, 2016.  See the changelog for a
full list of changes.

Ver también: **PEP 494** - Programa de lanzamiento de Python 3.6


Resumen: aspectos destacados de la versión
==========================================

Nuevas funciones de sintaxis:

* PEP 498, literales de cadena formateados.

* PEP 515, guiones bajos en literales numéricos.

* PEP 526, sintaxis para anotaciones variables.

* PEP 525, generadores asincrónicos.

* PEP 530: comprensiones asincrónicas.

Nuevos módulos de biblioteca:

* "secrets": PEP 506 -- Adding A Secrets Module To The Standard
  Library.

Mejoras en la implementación de CPython:

* El tipo dict se ha vuelto a implementar para utilizar un more
  compact representation basado en a proposal by Raymond Hettinger y
  similar al PyPy dict implementation. Esto dio como resultado que los
  diccionarios usaran entre un 20% y un 25% menos de memoria en
  comparación con Python 3.5.

* La personalización de la creación de clases se ha simplificado con
  el new protocol.

* El orden de definición de atributo de clase es now preserved.

* El orden de los elementos en "**kwargs" ahora corresponds to the
  order en el que se pasaron argumentos de palabras clave a la
  función.

* Se han agregado DTrace y SystemTap probing support.

* La nueva variable de entorno PYTHONMALLOC ahora se puede utilizar
  para depurar la asignación de memoria del intérprete y los errores
  de acceso.

Mejoras significativas en la biblioteca estándar:

* El módulo "asyncio" ha recibido nuevas funciones, mejoras
  significativas de rendimiento y usabilidad, y una buena cantidad de
  correcciones de errores. A partir de Python 3.6, el módulo "asyncio"
  ya no es provisional y su API se considera estable.

* Se ha implementado un nuevo file system path protocol para admitir
  *path-like objects*. Todas las funciones de biblioteca estándar que
  operan en rutas se han actualizado para trabajar con el nuevo
  protocolo.

* El módulo "datetime" ha ganado soporte para Local Time
  Disambiguation.

* El módulo "typing" recibió varios improvements.

* El módulo "tracemalloc" se ha rediseñado significativamente y ahora
  se utiliza para proporcionar una mejor salida para
  "ResourceWarning", así como para proporcionar un mejor diagnóstico
  de errores de asignación de memoria. Consulte PYTHONMALLOC section
  para obtener más información.

Mejoras de seguridad:

* Se ha agregado el nuevo módulo "secrets" para simplificar la
  generación de números pseudoaleatorios criptográficamente fuertes
  adecuados para administrar secretos como autenticación de cuentas,
  tokens y similares.

* En Linux, "os.urandom()" ahora se bloquea hasta que se inicializa el
  grupo de entropía aleatoria del sistema para aumentar la seguridad.
  Consulte el **PEP 524** para conocer la justificación.

* Los módulos "hashlib" y "ssl" ahora son compatibles con OpenSSL
  1.1.0.

* Se han mejorado la configuración predeterminada y el conjunto de
  funciones del módulo "ssl".

* El módulo "hashlib" recibió soporte para los algoritmos hash BLAKE2,
  SHA-3 y SHAKE y la función de derivación de claves "scrypt()".

Mejoras de Windows:

* PEP 528 y PEP 529, el sistema de archivos de Windows y la
  codificación de la consola cambiaron a UTF-8.

* El lanzador "py.exe", cuando se usa de forma interactiva, ya no
  prefiere Python 2 sobre Python 3 cuando el usuario no especifica una
  versión (a través de argumentos de línea de comando o un archivo de
  configuración). El manejo de las líneas shebang permanece sin
  cambios - "python" se refiere a Python 2 en ese caso.

* "python.exe" y "pythonw.exe" se han marcado como con reconocimiento
  de ruta larga, lo que significa que es posible que ya no se aplique
  el límite de ruta de 260 caracteres. Consulte removing the MAX_PATH
  limitation para obtener más detalles.

* Se puede agregar un archivo "._pth" para forzar el modo aislado y
  especificar completamente todas las rutas de búsqueda para evitar
  búsquedas en el registro y el entorno. Consulte la documentación
  para obtener más información.

* Un archivo "python36.zip" ahora funciona como un punto de referencia
  para inferir "PYTHONHOME". Consulte la documentación para obtener
  más información.


Nuevas características
======================


PEP 498: Literales de cadena formateados
----------------------------------------

**PEP 498** introduce un nuevo tipo de cadenas literales: *f-strings*
o formatted string literals.

Los literales de cadena formateados tienen el prefijo "'f'" y son
similares a las cadenas de formato aceptadas por "str.format()".
Contienen campos de reemplazo rodeados por llaves. Los campos de
reemplazo son expresiones, que se evalúan en tiempo de ejecución y
luego se formatean usando el protocolo "format()":

   >>> name = "Fred"
   >>> f"He said his name is {name}."
   'He said his name is Fred.'
   >>> width = 10
   >>> precision = 4
   >>> value = decimal.Decimal("12.34567")
   >>> f"result: {value:{width}.{precision}}"  # nested fields
   'result:      12.35'

Ver también:

  **PEP 498** - Interpolación de cadenas literal.
     PEP escrito e implementado por Eric V. Smith.

  Feature documentation.


PEP 526: Sintaxis para anotaciones de variables
-----------------------------------------------

**PEP 484** introdujo el estándar para anotaciones de tipo de
parámetros de función, también conocido como sugerencias de tipo. Este
PEP agrega sintaxis a Python para anotar los tipos de variables,
incluidas las variables de clase y las variables de instancia:

   primes: List[int] = []

   captain: str  # Note: no initial value!

   class Starship:
       stats: Dict[str, int] = {}

Al igual que para las anotaciones de funciones, el intérprete de
Python no asigna ningún significado particular a las anotaciones de
variables y solo las almacena en el atributo "__annotations__" de una
clase o módulo.

A diferencia de las declaraciones de variables en lenguajes tipados
estáticamente, el objetivo de la sintaxis de anotación es proporcionar
una manera fácil de especificar metadatos de tipo estructurado para
herramientas y bibliotecas de terceros a través del árbol de sintaxis
abstracta y el atributo "__annotations__".

Ver también:

  **PEP 526**: sintaxis para anotaciones de variables.
     PEP escrito por Ryan Gonzalez, Philip House, Ivan Levkivskyi,
     Lisa Roach y Guido van Rossum. Implementado por Ivan Levkivskyi.

  Herramientas que utilizan o utilizarán la nueva sintaxis: mypy,
  pytype, PyCharm, etc.


PEP 515: subrayados en literales numéricos
------------------------------------------

**PEP 515** agrega la capacidad de usar guiones bajos en literales
numéricos para mejorar la legibilidad. Por ejemplo:

   >>> 1_000_000_000_000_000
   1000000000000000
   >>> 0x_FF_FF_FF_FF
   4294967295

Se permiten guiones bajos simples entre dígitos y después de cualquier
especificador de base. No se permiten guiones bajos al principio, al
final o múltiples en una fila.

El lenguaje string formatting ahora también admite la opción "'_'"
para indicar el uso de un guión bajo como separador de miles para los
tipos de presentación de punto flotante y para el tipo de presentación
de enteros "'d'". Para los tipos de presentación de enteros "'b'",
"'o'", "'x'" y "'X'", se insertarán guiones bajos cada 4 dígitos:

   >>> '{:_}'.format(1000000)
   '1_000_000'
   >>> '{:_x}'.format(0xFFFFFFFF)
   'ffff_ffff'

Ver también:

  **PEP 515** - Guiones bajos en literales numéricos
     PEP escrito por Georg Brandl y Serhiy Storchaka.


PEP 525: Generadores asíncronos
-------------------------------

**PEP 492** introdujo soporte para corrutinas nativas y sintaxis
"async" / "await" para Python 3.5. Una limitación notable de la
implementación de Python 3.5 es que no fue posible usar "await" y
"yield" en el mismo cuerpo de función. En Python 3.6 se eliminó esta
restricción, lo que permite definir *asynchronous generators*

   async def ticker(delay, to):
       """Yield numbers from 0 to *to* every *delay* seconds."""
       for i in range(to):
           yield i
           await asyncio.sleep(delay)

La nueva sintaxis permite un código más rápido y conciso.

Ver también:

  **PEP 525** - Generadores asincrónicos
     PEP escrito e implementado por Yury Selivanov.


PEP 530: Comprensiones asincrónicas
-----------------------------------

**PEP 530** agrega soporte para usar "async for" en listas, conjuntos,
dict comprensiones y expresiones generadoras:

   result = [i async for i in aiter() if i % 2]

Además, las expresiones "await" son compatibles con todo tipo de
comprensiones:

   result = [await fun() for fun in funcs if await condition()]

Ver también:

  **PEP 530** - Comprensiones asincrónicas
     PEP escrito e implementado por Yury Selivanov.


PEP 487: personalización más sencilla de la creación de clases
--------------------------------------------------------------

Ahora es posible personalizar la creación de subclases sin utilizar
una metaclase. El nuevo método de clase "__init_subclass__" se llamará
en la clase base siempre que se cree una nueva subclase:

   class PluginBase:
       subclasses = []

       def __init_subclass__(cls, **kwargs):
           super().__init_subclass__(**kwargs)
           cls.subclasses.append(cls)

   class Plugin1(PluginBase):
       pass

   class Plugin2(PluginBase):
       pass

Para permitir que las llamadas "super()" sin argumentos funcionen
correctamente desde las implementaciones "__init_subclass__()", las
metaclases personalizadas deben garantizar que la nueva entrada del
espacio de nombres "__classcell__" se propague a "type.__new__" (como
se describe en Creando el objeto de clase).

Ver también:

  **PEP 487**: personalización más sencilla de la creación de clases
     PEP escrito e implementado por Martin Teichmann.

  Feature documentation


PEP 487: Mejoras en el protocolo descriptor
-------------------------------------------

**PEP 487** amplía el protocolo descriptor para incluir el nuevo
método opcional "__set_name__()". Siempre que se defina una nueva
clase, se llamará al nuevo método en todos los descriptores incluidos
en la definición, proporcionándoles una referencia a la clase que se
está definiendo y el nombre dado al descriptor dentro del espacio de
nombres de la clase. En otras palabras, las instancias de descriptores
ahora pueden conocer el nombre de atributo del descriptor en la clase
propietaria:

   class IntField:
       def __get__(self, instance, owner):
           return instance.__dict__[self.name]

       def __set__(self, instance, value):
           if not isinstance(value, int):
               raise ValueError(f'expecting integer in {self.name}')
           instance.__dict__[self.name] = value

       # this is the new initializer:
       def __set_name__(self, owner, name):
           self.name = name

   class Model:
       int_field = IntField()

Ver también:

  **PEP 487**: personalización más sencilla de la creación de clases
     PEP escrito e implementado por Martin Teichmann.

  Feature documentation


PEP 519: Agregar un protocolo de ruta del sistema de archivos
-------------------------------------------------------------

Históricamente, las rutas del sistema de archivos se han representado
como objetos "str" o "bytes". Esto ha llevado a las personas que
escriben códigos que operan en las rutas del sistema de archivos a
asumir que dichos objetos son solo uno de esos dos tipos (un "int" que
representa un descriptor de archivo no cuenta, ya que no es una ruta
de archivo). Desafortunadamente, esa suposición evita que las
representaciones de objetos alternativos de las rutas del sistema de
archivos como "pathlib" funcionen con código preexistente, incluida la
biblioteca estándar de Python.

Para solucionar esta situación, se ha definido una nueva interfaz
representada por "os.PathLike". Al implementar el método
"__fspath__()", un objeto indica que representa una ruta. Entonces, un
objeto puede proporcionar una representación de bajo nivel de una ruta
del sistema de archivos como un objeto "str" o "bytes". Esto significa
que un objeto se considera *path-like* si implementa "os.PathLike" o
es un objeto "str" o "bytes" que representa una ruta del sistema de
archivos. El código puede usar "os.fspath()", "os.fsdecode()" o
"os.fsencode()" para obtener explícitamente una representación "str" y
/ o "bytes" de un objeto similar a una ruta.

La función "open()" incorporada se ha actualizado para aceptar objetos
"os.PathLike", al igual que todas las funciones relevantes en los
módulos "os" y "os.path", y la mayoría de las otras funciones y clases
en la biblioteca estándar. La clase "os.DirEntry" y las clases
relevantes en "pathlib" también se han actualizado para implementar
"os.PathLike".

La esperanza es que la actualización de las funciones fundamentales
para operar en las rutas del sistema de archivos conducirá a un código
de terceros para admitir implícitamente todos los *path-like objects*
sin ningún cambio de código, o al menos muy mínimos (por ejemplo,
llamar a "os.fspath()" al comienzo del código antes de operar en un
objeto similar a una ruta).

A continuación, se muestran algunos ejemplos de cómo la nueva interfaz
permite que "pathlib.Path" se utilice de manera más fácil y
transparente con código preexistente:

   >>> import pathlib
   >>> with open(pathlib.Path("README")) as f:
   ...     contents = f.read()
   ...
   >>> import os.path
   >>> os.path.splitext(pathlib.Path("some_file.txt"))
   ('some_file', '.txt')
   >>> os.path.join("/a/b", pathlib.Path("c"))
   '/a/b/c'
   >>> import os
   >>> os.fspath(pathlib.Path("some_file.txt"))
   'some_file.txt'

(Implementado por Brett Cannon, Ethan Furman, Dusty Phillips y Jelle
Zijlstra).

Ver también:

  **PEP 519**: adición de un protocolo de ruta del sistema de archivos
     PEP escrito por Brett Cannon y Koos Zevenhoven.


PEP 495: desambiguación de la hora local
----------------------------------------

En la mayoría de las ubicaciones del mundo, ha habido y habrá
ocasiones en las que los relojes locales se retrasaron. En esos
horarios, se introducen intervalos en los que los relojes locales
marcan la misma hora dos veces en el mismo día. En estas situaciones,
la información mostrada en un reloj local (o almacenada en una
instancia de fecha y hora de Python) es insuficiente para identificar
un momento particular en el tiempo.

**PEP 495** agrega el nuevo atributo *fold* a las instancias de las
clases "datetime.datetime" y "datetime.time" para diferenciar entre
dos momentos en el tiempo en los que las horas locales son las mismas:

   >>> u0 = datetime(2016, 11, 6, 4, tzinfo=timezone.utc)
   >>> for i in range(4):
   ...     u = u0 + i*HOUR
   ...     t = u.astimezone(Eastern)
   ...     print(u.time(), 'UTC =', t.time(), t.tzname(), t.fold)
   ...
   04:00:00 UTC = 00:00:00 EDT 0
   05:00:00 UTC = 01:00:00 EDT 0
   06:00:00 UTC = 01:00:00 EST 1
   07:00:00 UTC = 02:00:00 EST 0

Los valores del atributo "fold" tienen el valor "0" para todas las
instancias excepto aquellas que representan el segundo momento
(cronológicamente) en el tiempo en un caso ambiguo.

Ver también:

  **PEP 495** - Desambiguación de hora local
     PEP escrito por Alexander Belopolsky y Tim Peters, implementación
     por Alexander Belopolsky.


PEP 529: cambie la codificación del sistema de archivos de Windows a UTF-8
--------------------------------------------------------------------------

La representación de las rutas del sistema de archivos se realiza
mejor con str (Unicode) en lugar de bytes. Sin embargo, hay algunas
situaciones en las que el uso de bytes es suficiente y correcto.

Antes de Python 3.6, se podían producir pérdidas de datos al utilizar
rutas de bytes en Windows. Con este cambio, ahora se admite el uso de
bytes para representar rutas en Windows, siempre que esos bytes estén
codificados con la codificación devuelta por
"sys.getfilesystemencoding()", que ahora tiene como valor
predeterminado "'utf-8'".

Applications that do not use str to represent paths should use
"os.fsencode()" and "os.fsdecode()" to ensure their bytes are
correctly encoded. To revert to the previous behaviour, set
"PYTHONLEGACYWINDOWSFSENCODING" or call
"sys._enablelegacywindowsfsencoding()".

Consulte **PEP 529** para obtener más información y una discusión
sobre las modificaciones de código que pueden ser necesarias.


PEP 528: cambie la codificación de la consola de Windows a UTF-8
----------------------------------------------------------------

La consola predeterminada en Windows ahora aceptará todos los
caracteres Unicode y proporcionará objetos str leídos correctamente al
código Python. "sys.stdin", "sys.stdout" y "sys.stderr" ahora tienen
la codificación utf-8 por defecto.

Este cambio solo se aplica cuando se usa una consola interactiva y no
cuando se redirigen archivos o canalizaciones. Para volver al
comportamiento anterior para el uso de la consola interactiva,
configure "PYTHONLEGACYWINDOWSSTDIO".

Ver también:

  **PEP 528**: cambie la codificación de la consola de Windows a UTF-8
     PEP escrito e implementado por Steve Dower.


PEP 520: Conservación del orden de definición de atributos de clase
-------------------------------------------------------------------

Los atributos del cuerpo de una definición de clase tienen un orden
natural: el mismo orden en el que aparecen los nombres en el código
fuente. Este orden ahora se conserva en el atributo "__dict__" de la
nueva clase.

Además, el espacio de nombres de clase *execution* predeterminado
efectivo (devuelto desde type.__prepare__()) ahora es una asignación
que conserva el orden de inserción.

Ver también:

  **PEP 520** - Conservación del orden de definición de atributos de
  clase
     PEP escrito e implementado por Eric Snow.


PEP 468: Conservación del orden de los argumentos de las palabras clave
-----------------------------------------------------------------------

Ahora se garantiza que "**kwargs" en una firma de función es un mapeo
que conserva el orden de inserción.

Ver también:

  **PEP 468** - Conservación del orden de los argumentos de las
  palabras clave
     PEP escrito e implementado por Eric Snow.


Nueva implementación de dict
----------------------------

El tipo dict ahora usa una representación "compacta" basada en a
proposal by Raymond Hettinger que era first implemented by PyPy. El
uso de memoria del nuevo "dict()" es entre un 20% y un 25% menor en
comparación con Python 3.5.

El aspecto de conservación del orden de esta nueva implementación se
considera un detalle de implementación y no se debe confiar en él
(esto puede cambiar en el futuro, pero se desea tener esta nueva
implementación de dict en el idioma para algunas versiones antes de
cambiar la especificación del idioma para exigir la semántica de
preservación del orden para todas las implementaciones de Python
actuales y futuras; esto también ayuda a preservar la compatibilidad
con versiones anteriores del lenguaje donde el orden de iteración
aleatorio todavía está vigente, por ejemplo, Python 3.5).

(Contribuido por INADA Naoki en bpo-27350. Idea originally suggested
by Raymond Hettinger.)


PEP 523: Agregar una API de evaluación de marcos a CPython
----------------------------------------------------------

Si bien Python proporciona un amplio soporte para personalizar cómo se
ejecuta el código, un lugar en el que no lo ha hecho es en la
evaluación de objetos de marco. Si quisiera alguna forma de
interceptar la evaluación de marcos en Python, realmente no había
ninguna forma sin manipular directamente los punteros de función para
las funciones definidas.

**PEP 523** cambia esto al proporcionar una API para hacer que la
evaluación de tramas se pueda conectar en el nivel C. Esto permitirá
que herramientas como depuradores y JIT intercepten la evaluación del
marco antes de que comience la ejecución del código Python. Esto
permite el uso de implementaciones de evaluación alternativas para el
código Python, seguimiento de la evaluación del marco, etc.

Esta API no forma parte de la API C limitada y está marcada como
privada para indicar que se espera que el uso de esta API sea limitado
y solo se aplique a casos de uso muy selectos y de bajo nivel. La
semántica de la API cambiará con Python según sea necesario.

Ver también:

  **PEP 523**: agregar una API de evaluación de marcos a CPython
     PEP escrito por Brett Cannon y Dino Viehland.


Variable de entorno PYTHONMALLOC
--------------------------------

La nueva variable de entorno "PYTHONMALLOC" permite configurar los
asignadores de memoria e instalar Python ganchos de depuración.

Ahora es posible instalar enlaces de depuración en asignadores de
memoria de Python en Python compilado en modo de lanzamiento usando
"PYTHONMALLOC=debug". Efectos de los ganchos de depuración:

* La memoria recién asignada se llena con el byte "0xCB"

* La memoria liberada se llena con el byte "0xDB"

* Detecta violaciones de la API de asignación de memoria de Python.
  Por ejemplo, "PyObject_Free()" llamó a un bloque de memoria asignado
  por "PyMem_Malloc()".

* Detectar escrituras antes del inicio de un búfer (subdesbordamientos
  del búfer)

* Detectar escrituras después del final de un búfer (desbordes de
  búfer)

* Verifique que *GIL* se mantenga cuando se llamen las funciones de
  asignador de los dominios "PYMEM_DOMAIN_OBJ" (por ejemplo:
  "PyObject_Malloc()") y "PYMEM_DOMAIN_MEM" (por ejemplo:
  "PyMem_Malloc()").

Verificar si el GIL se mantiene también es una nueva característica de
Python 3.6.

Consulte la función "PyMem_SetupDebugHooks()" para ver los enlaces de
depuración en los asignadores de memoria de Python.

Ahora también es posible forzar el uso del asignador "malloc()" de la
biblioteca C para todas las asignaciones de memoria de Python usando
"PYTHONMALLOC=malloc". Esto es útil cuando se utilizan depuradores de
memoria externa como Valgrind en un Python compilado en modo de
lanzamiento.

En caso de error, los ganchos de depuración en los asignadores de
memoria de Python ahora usan el módulo "tracemalloc" para obtener el
rastreo donde se asignó un bloque de memoria.

Ejemplo de error fatal en el desbordamiento del búfer usando
"python3.6 -X tracemalloc=5" (almacenar 5 cuadros en trazas):

   Debug memory block at address p=0x7fbcd41666f8: API 'o'
       4 bytes originally requested
       The 7 pad bytes at p-7 are FORBIDDENBYTE, as expected.
       The 8 pad bytes at tail=0x7fbcd41666fc are not all FORBIDDENBYTE (0xfb):
           at tail+0: 0x02 *** OUCH
           at tail+1: 0xfb
           at tail+2: 0xfb
           at tail+3: 0xfb
           at tail+4: 0xfb
           at tail+5: 0xfb
           at tail+6: 0xfb
           at tail+7: 0xfb
       The block was made by call #1233329 to debug malloc/realloc.
       Data at p: 1a 2b 30 00

   Memory block allocated at (most recent call first):
     File "test/test_bytes.py", line 323
     File "unittest/case.py", line 600
     File "unittest/case.py", line 648
     File "unittest/suite.py", line 122
     File "unittest/suite.py", line 84

   Fatal Python error: bad trailing pad byte

   Current thread 0x00007fbcdbd32700 (most recent call first):
     File "test/test_bytes.py", line 323 in test_hex
     File "unittest/case.py", line 600 in run
     File "unittest/case.py", line 648 in __call__
     File "unittest/suite.py", line 122 in run
     File "unittest/suite.py", line 84 in __call__
     File "unittest/suite.py", line 122 in run
     File "unittest/suite.py", line 84 in __call__
     ...

(Contribución de Victor Stinner en bpo-26516 y :issue:` 26564`.)


Soporte de sondeo DTrace y SystemTap
------------------------------------

Python ahora se puede construir "--with-dtrace" que habilita
marcadores estáticos para los siguientes eventos en el intérprete:

* función llamada / retorno

* recogida de basura iniciada / finalizada

* línea de código ejecutada.

Esto se puede utilizar para instrumentar intérpretes en ejecución en
producción, sin la necesidad de volver a compilar debug builds
específico o proporcionar código de depuración / perfilado específico
de la aplicación.

Más detalles en Instrumentación de CPython con DTrace y SystemTap.

La implementación actual se prueba en Linux y macOS. Es posible que se
agreguen marcadores adicionales en el futuro.

(Contribuido por Łukasz Langa en bpo-21590, basado en parches de Jesús
Cea Avión, David Malcolm y Nikhil Benesch.)


Otros cambios de idioma
=======================

Algunos cambios más pequeños realizados en el lenguaje central de
Python son:

* Una declaración "global" o "nonlocal" ahora debe aparecer
  textualmente antes del primer uso del nombre afectado en el mismo
  ámbito. Anteriormente, este era un "SyntaxWarning".

* It is now possible to set a special method to "None" to indicate
  that the corresponding operation is not available. For example, if a
  class sets "__iter__()" to "None", the class is not iterable.
  (Contributed by Andrew Barnert and Ivan Levkivskyi in bpo-25958.)

* Las secuencias largas de líneas de rastreo repetidas ahora se
  abrevian como ""[Previous line repeated {count} more times]""
  (consulte rastrear para ver un ejemplo). (Contribución de Emanuel
  Barry en bpo-26823.)

* Importar ahora lanza la nueva excepción "ModuleNotFoundError"
  (subclase de "ImportError") cuando no puede encontrar un módulo. El
  código que actualmente busca ImportError (en try-except) seguirá
  funcionando. (Contribución de Eric Snow en bpo-15767.)

* Los métodos de clase que se basan en "super()" de argumento cero
  ahora funcionarán correctamente cuando se llamen desde métodos de
  metaclase durante la creación de la clase. (Contribución de Martin
  Teichmann en bpo-23722.)


Nuevos módulos
==============


misterios
---------

El objetivo principal del nuevo módulo "secrets" es proporcionar una
forma obvia de generar de manera confiable valores pseudoaleatorios
criptográficamente fuertes adecuados para administrar secretos, como
autenticación de cuentas, tokens y similares.

Advertencia:

  Tenga en cuenta que los generadores pseudoaleatorios del módulo
  "random" deben usarse con fines de seguridad. Use "secrets" en
  Python 3.6+ y "os.urandom()" en Python 3.5 y versiones anteriores.

Ver también:

  **PEP 506**: adición de un módulo de secretos a la biblioteca
  estándar
     PEP escrito e implementado por Steven D'Aprano.


Módulos mejorados
=================


formación
---------

Los iteradores agotados de "array.array" ahora permanecerán agotados
incluso si se extiende la matriz iterada. Esto es consistente con el
comportamiento de otras secuencias mutables.

Contribuido por Serhiy Storchaka en bpo-26492.


ast
---

Se ha agregado el nuevo nodo "ast.Constant" AST. Puede ser utilizado
por optimizadores AST externos con el propósito de plegado constante.

Contribuido por Victor Stinner en bpo-26146.


asyncio
-------

A partir de Python 3.6, el módulo "asyncio" ya no es provisional y su
API se considera estable.

Cambios notables en el módulo "asyncio" desde Python 3.5.0 (todos
retroportados a 3.5.x debido al estado provisional):

* La función "get_event_loop()" se ha cambiado para devolver siempre
  el bucle que se está ejecutando actualmente cuando se llama desde
  corrutinas y devoluciones de llamada. (Contribuido por Yury
  Selivanov en bpo-28613.)

* La función "ensure_future()" y todas las funciones que la utilizan,
  como "loop.run_until_complete()", ahora aceptan todo tipo de
  *awaitable objects*. (Contribuido por Yury Selivanov.)

* Nueva función "run_coroutine_threadsafe()" para enviar corrutinas a
  bucles de eventos de otros hilos. (Contribución de Vincent Michel.)

* Nuevo método "Transport.is_closing()" para comprobar si el
  transporte está cerrando o está cerrado. (Contribuido por Yury
  Selivanov.)

* El método "loop.create_server()" ahora puede aceptar una lista de
  hosts. (Contribuido por Yann Sionneau.)

* Nuevo método "loop.create_future()" para crear objetos Future. Esto
  permite implementaciones alternativas de bucle de eventos, como
  uvloop, para proporcionar una implementación "asyncio.Future" más
  rápida. (Contribuido por Yury Selivanov en bpo-27041.)

* Nuevo método "loop.get_exception_handler()" para obtener el
  controlador de excepciones actual. (Contribuido por Yury Selivanov
  en bpo-27040.)

* Nuevo método "StreamReader.readuntil()" para leer datos de la
  secuencia hasta que aparezca una secuencia de bytes de separación.
  (Contribuido por Mark Korenberg.)

* Se ha mejorado el rendimiento de "StreamReader.readexactly()".
  (Contribuido por Mark Korenberg en bpo-28370.)

* El método "loop.getaddrinfo()" está optimizado para evitar llamar a
  la función "getaddrinfo" del sistema si la dirección ya está
  resuelta. (Contribuido por A. Jesse Jiryu Davis.)

* El método "loop.stop()" se ha cambiado para detener el bucle
  inmediatamente después de la iteración actual. Se descartarán todas
  las devoluciones de llamada nuevas programadas como resultado de la
  última iteración. (Contribuido por Guido van Rossum en bpo-25593.)

* "Future.set_exception" will now raise "TypeError" when passed an
  instance of the "StopIteration" exception. (Contributed by Chris
  Angelico in bpo-26221.)

* Nuevo método "loop.connect_accepted_socket()" para ser usado por
  servidores que aceptan conexiones fuera de asyncio, pero que usan
  asyncio para manejarlas. (Contribuido por Jim Fulton en bpo-27392.)

* El indicador "TCP_NODELAY" ahora está configurado para todos los
  transportes TCP de forma predeterminada. (Contribuido por Yury
  Selivanov en bpo-27456.)

* Nuevo "loop.shutdown_asyncgens()" para cerrar correctamente los
  generadores asincrónicos pendientes antes de cerrar el ciclo.
  (Contribuido por Yury Selivanov en bpo-28003.)

* Las clases "Future" y "Task" ahora tienen una implementación C
  optimizada que hace que el código asyncio sea hasta un 30% más
  rápido. (Contribuido por Yury Selivanov e INADA Naoki en bpo-26081 y
  bpo-28544.)


binascii
--------

La función "b2a_base64()" ahora acepta un argumento de palabra clave
*newline* opcional para controlar si el carácter de nueva línea se
agrega al valor de retorno. (Contribuido por Victor Stinner en
bpo-25357.)


cmath
-----

Se ha agregado la nueva constante "cmath.tau" (*τ*). (Contribuido por
Lisa Roach en bpo-12345, consulte **PEP 628** para obtener más
detalles).

Nuevas constantes: "cmath.inf" y "cmath.nan" para que coincidan con
"math.inf" y "math.nan", y también "cmath.infj" y "cmath.nanj" para
que coincidan con el formato utilizado por la repetición compleja.
(Contribuido por Mark Dickinson en bpo-23229.)


colecciones
-----------

Se ha agregado la nueva clase base abstracta "Collection" para
representar clases de contenedores iterables de tamaño. (Contribuido
por Ivan Levkivskyi, documentos de Neil Girdhar en bpo-27598.)

The new "Reversible" abstract base class represents iterable classes
that also provide the "__reversed__()" method. (Contributed by Ivan
Levkivskyi in bpo-25987.)

La nueva clase base abstracta "AsyncGenerator" representa generadores
asincrónicos. (Contribuido por Yury Selivanov en bpo-28720.)

La función "namedtuple()" ahora acepta un argumento de palabra clave
opcional *module*, que, cuando se especifica, se utiliza para el
atributo "__module__" de la clase de tupla nombrada que se devuelve.
(Contribuido por Raymond Hettinger en bpo-17941).

Los argumentos *verbose* and *rename* para "namedtuple()" ahora son
solo palabras clave. (Contribuido por Raymond Hettinger en bpo-25628.)

Las instancias de "collections.deque" recursivas ahora se pueden
eliminar. (Contribuido por Serhiy Storchaka en bpo-26482.)


concurrent.futures
------------------

El constructor de la clase "ThreadPoolExecutor" ahora acepta un
argumento *thread_name_prefix* opcional para que sea posible
personalizar los nombres de los subprocesos creados por el grupo.
(Contribuido por Gregory P. Smith en bpo-27664.)


contextlib
----------

La clase "contextlib.AbstractContextManager" fue agregada para proveer
una clase abstracta para gestores de contexto. Provee una
implementación por defecto sensible para *__enter__()* que retorna
"self" y deja un método abstracto *__exit__()*. Se ha agregado una
clase coincidente al módulo "typing" como "typing.ContextManager".
(Contribuido por Brett Cannon en bpo-25609.)


fecha y hora
------------

The "datetime" and "time" classes have the new "fold" attribute used
to disambiguate local time when necessary.  Many functions in the
"datetime" have been updated to support local time disambiguation. See
Local Time Disambiguation section for more information. (Contributed
by Alexander Belopolsky in bpo-24773.)

Los métodos "datetime.strftime()" y "date.strftime()" ahora admiten
las directivas de fecha ISO 8601 "%G", "%u" y "%V". (Contribuido por
Ashley Anderson en bpo-12006.)

La función "datetime.isoformat()" ahora acepta un argumento *timespec*
opcional que especifica el número de componentes adicionales del valor
de tiempo a incluir. (Contribuido por Alessandro Cucci y Alexander
Belopolsky en bpo-19475.)

El "datetime.combine()" ahora acepta un argumento *tzinfo* opcional.
(Contribuido por Alexander Belopolsky en bpo-27661.)


decimal
-------

Nuevo método "Decimal.as_integer_ratio()" que devuelve un par "(n, d)"
de enteros que representan la instancia "Decimal" dada como una
fracción, en términos más bajos y con un denominador positivo:

   >>> Decimal('-3.14').as_integer_ratio()
   (-157, 50)

(Contribuido por Stefan Krah y Mark Dickinson en bpo-25928.)


distutils
---------

El atributo "default_format" se ha eliminado de
"distutils.command.sdist.sdist" y el atributo "formats" tiene como
valor predeterminado "['gztar']". Aunque no se prevé, es posible que
sea necesario adaptar cualquier código que dependa de la presencia de
"default_format". Consulte bpo-27819 para obtener más detalles.


email
-----

La nueva API de correo electrónico, habilitada a través de la palabra
clave *policy* para varios constructores, ya no es provisional. La
documentación de "email" se ha reorganizado y reescrito para centrarse
en la nueva API, conservando la documentación anterior para la API
heredada. (Contribuido por R. David Murray en bpo-24277.)

Las clases "email.mime" ahora aceptan todas una palabra clave *policy*
opcional. (Contribuido por Berker Peksag en bpo-27331.)

El "DecodedGenerator" ahora admite la palabra clave *policy*.

Hay un nuevo atributo "policy", "message_factory", que controla qué
clase se usa por defecto cuando el analizador crea nuevos objetos de
mensaje. Para la política "email.policy.compat32", es "Message", para
las nuevas políticas es "EmailMessage". (Contribuido por R. David
Murray en bpo-20476.)


codificaciones
--------------

En Windows, se agregó la codificación "'oem'" para usar "CP_OEMCP" y
el alias "'ansi'" para la codificación "'mbcs'" existente, que usa la
página de códigos "CP_ACP". (Contribuido por Steve Dower en
bpo-27959.)


enumeración
-----------

Two new enumeration base classes have been added to the "enum" module:
"Flag" and "IntFlag".  Both are used to define constants that can be
combined using the bitwise operators. (Contributed by Ethan Furman in
bpo-23591.)

Many standard library modules have been updated to use the "IntFlag"
class for their constants.

El nuevo valor de "enum.auto" se puede utilizar para asignar valores a
los miembros de enumeración automáticamente:

   >>> from enum import Enum, auto
   >>> class Color(Enum):
   ...     red = auto()
   ...     blue = auto()
   ...     green = auto()
   ...
   >>> list(Color)
   [<Color.red: 1>, <Color.blue: 2>, <Color.green: 3>]


manipulador de faltas
---------------------

En Windows, el módulo "faulthandler" ahora instala un controlador para
las excepciones de Windows: consulte "faulthandler.enable()".
(Contribuido por Victor Stinner en bpo-23848.)


entrada de archivo
------------------

"hook_encoded()" ahora admite el argumento *errors*. (Contribuido por
Joseph Hackman en bpo-25788.)


hashlib
-------

"hashlib" es compatible con OpenSSL 1.1.0. La versión mínima
recomendada es 1.0.2. (Contribuido por Christian Heimes en bpo-26470.)

Se agregaron funciones hash BLAKE2 al módulo. "blake2b()" y
"blake2s()" siempre están disponibles y admiten el conjunto completo
de funciones de BLAKE2. (Contribuido por Christian Heimes en bpo-26798
basado en código de Dmitry Chestnykh y Samuel Neves. Documentación
escrita por Dmitry Chestnykh.)

Se agregaron las funciones hash SHA-3 "sha3_224()", "sha3_256()",
"sha3_384()", "sha3_512()" y las funciones hash SHAKE "shake_128()" y
"shake_256()". (Contribuido por Christian Heimes en bpo-16113. Paquete
de código Keccak por Guido Bertoni, Joan Daemen, Michaël Peeters,
Gilles Van Assche y Ronny Van Keer.)

La función de derivación de claves basada en contraseña "scrypt()"
ahora está disponible con OpenSSL 1.1.0 y versiones posteriores.
(Contribuido por Christian Heimes en bpo-27928.)


http.client
-----------

"HTTPConnection.request()" y "endheaders()" ahora admiten cuerpos de
solicitud de codificación fragmentados. (Contribuido por Demian Brecht
y Rolf Krahl en bpo-12319.)


idlelib y IDLE
--------------

El paquete idlelib se está modernizando y refactorizando para que IDLE
se vea y funcione mejor y para que el código sea más fácil de
entender, probar y mejorar. Parte de hacer que IDLE se vea mejor,
especialmente en Linux y Mac, es usar widgets ttk, principalmente en
los cuadros de diálogo. Como resultado, IDLE ya no se ejecuta con tcl
/ tk 8.4. Ahora requiere tcl / tk 8.5 o 8.6. Recomendamos ejecutar la
última versión de cualquiera.

La 'modernización' incluye el cambio de nombre y la consolidación de
módulos idlelib. El cambio de nombre de archivos con nombres en
mayúsculas parciales es similar al cambio de nombre de, por ejemplo,
Tkinter y TkFont a tkinter y tkinter.font en 3.0. Como resultado, las
importaciones de archivos idlelib que funcionaban en 3.5 normalmente
no funcionarán en 3.6. Se necesitará al menos un cambio de nombre de
módulo (ver idlelib / README.txt), a veces más. (Los cambios de nombre
aportados por Al Swiegart y Terry Reedy en bpo-24225. La mayoría de
los parches idlelib desde entonces han sido y serán parte del
proceso).

En compensación, el resultado final será que algunas clases de idlelib
serán más fáciles de usar, con mejores API y cadenas de documentación
que las expliquen. Se agregará información útil adicional a idlelib
cuando esté disponible.

Nuevo en 3.6.2:

Varias correcciones para autocompletar. (Contribuido por Louie Lu en
bpo-15786.)

Nuevo en 3.6.3:

El Explorador de módulos (en el menú Archivo, antes llamado Explorador
de clases), ahora muestra funciones y clases anidadas además de
funciones y clases de nivel superior. (Contribuido por Guilherme Polo,
Cheryl Sabella y Terry Jan Reedy en bpo-1612262.)

Las funciones IDLE implementadas anteriormente como extensiones se han
vuelto a implementar como funciones normales. Su configuración se ha
movido de la pestaña Extensiones a otras pestañas de diálogo.
(Contribuido por Charles Wohlganger y Terry Jan Reedy en bpo-27099.)

El cuadro de diálogo Configuración (Opciones, Configurar IDLE) se ha
reescrito parcialmente para mejorar tanto la apariencia como la
función. (Contribuido por Cheryl Sabella y Terry Jan Reedy en varios
números).

Nuevo en 3.6.4:

La muestra de fuente ahora incluye una selección de caracteres no
latinos para que los usuarios puedan ver mejor el efecto de
seleccionar una fuente en particular. (Contribuido por Terry Jan Reedy
en bpo-13802.) La muestra se puede editar para incluir otros
caracteres. (Contribuido por Serhiy Storchaka en bpo-31860.)

Nuevo en 3.6.6:

Se revisó la opción de contexto del código del editor. El cuadro
muestra todas las líneas de contexto hasta las líneas máximas. Al
hacer clic en una línea de contexto, el editor salta a esa línea. Los
colores de contexto para temas personalizados se agregan a la pestaña
Destacados del cuadro de diálogo Configuración. (Contribuido por
Cheryl Sabella y Terry Jan Reedy en bpo-33642, bpo-33768 y bpo-33679.)

En Windows, una nueva llamada a la API le dice a Windows que tk escala
para DPI. En Windows 8.1+ o 10, con las propiedades de compatibilidad
de DPI del binario de Python sin cambios y una resolución de monitor
superior a 96 DPI, esto debería hacer que el texto y las líneas sean
más nítidos. De lo contrario, no debería tener ningún efecto.
(Contribuido por Terry Jan Reedy en bpo-33656.)

Nuevo en 3.6.7:

La salida sobre N líneas (50 por defecto) se reduce a un botón. N se
puede cambiar en la sección PyShell de la página General del cuadro de
diálogo Configuración. Se pueden comprimir menos líneas, pero
posiblemente más largas, haciendo clic derecho en la salida. La salida
comprimida se puede expandir en su lugar haciendo doble clic en el
botón o en el portapapeles o en una ventana separada haciendo clic
derecho en el botón. (Contribuido por Tal Einat en bpo-1529353.)


importlib
---------

Importar ahora lanza la nueva excepción "ModuleNotFoundError"
(subclase de "ImportError") cuando no puede encontrar un módulo.
Codifique que las comprobaciones actuales para "ImportError" (en try-
except) seguirán funcionando. (Contribuido por Eric Snow en
bpo-15767.)

"importlib.util.LazyLoader" ahora llama a "create_module()" en el
cargador envuelto, eliminando la restricción de que
"importlib.machinery.BuiltinImporter" y
"importlib.machinery.ExtensionFileLoader" no se pueden usar con
"importlib.util.LazyLoader".

"importlib.util.cache_from_source()",
"importlib.util.source_from_cache()" y
"importlib.util.spec_from_file_location()" ahora aceptan un *path-like
object*.


inspeccionar
------------

La función "inspect.signature()" ahora reporta los parámetros ".0"
implícitos generados por el compilador para los alcances de
comprensión y expresión del generador como si fueran parámetros solo
posicionales llamados "implicit0". (Contribuido por Jelle Zijlstra en
bpo-19611.)

To reduce code churn when upgrading from Python 2.7 and the legacy
"inspect.getargspec()" API, the previously documented deprecation of
"inspect.getfullargspec()" has been reversed. While this function is
convenient for single/source Python 2/3 code bases, the richer
"inspect.signature()" interface remains the recommended approach for
new code. (Contributed by Nick Coghlan in bpo-27172)


json
----

"json.load()" y "json.loads()" ahora admiten entrada binaria. El JSON
codificado debe representarse mediante UTF-8, UTF-16 o UTF-32.
(Contribuido por Serhiy Storchaka en bpo-17909.)


logging
-------

Se agregó el nuevo método "WatchedFileHandler.reopenIfNeeded()" para
agregar la capacidad de verificar si es necesario volver a abrir el
archivo de registro. (Contribuido por Marian Horban en bpo-24884.)


math
----

La constante tau (*τ*) se ha agregado a los módulos "math" y "cmath".
(Contribuido por Lisa Roach en bpo-12345, consulte **PEP 628** para
obtener más detalles).


multiprocesamiento
------------------

Proxy Objects devuelto por "multiprocessing.Manager()" ahora se puede
anidar. (Contribuido por Davin Potts en bpo-6766.)


os
--

Consulte el resumen de PEP 519 para obtener detalles sobre cómo los
módulos "os" y "os.path" ahora admiten *path-like objects*.

"scandir()" ahora admite rutas "bytes" en Windows.

A new "close()" method allows explicitly closing a "scandir()"
iterator.  The "scandir()" iterator now supports the *context manager*
protocol.  If a "scandir()" iterator is neither exhausted nor
explicitly closed a "ResourceWarning" will be emitted in its
destructor. (Contributed by Serhiy Storchaka in bpo-25994.)

En Linux, "os.urandom()" ahora se bloquea hasta que se inicializa el
grupo de entropía aleatoria del sistema para aumentar la seguridad.
Consulte el **PEP 524** para conocer la justificación.

El syscall de Linux "getrandom()" (obtener bytes aleatorios) ahora se
expone como la nueva función "os.getrandom()". (Contribuido por Victor
Stinner, parte del **PEP 524**)


pathlib
-------

"pathlib" ahora es compatible con *path-like objects*. (Contribuido
por Brett Cannon en bpo-27186.)

Consulte el resumen de PEP 519 para obtener más detalles.


pdb
---

El constructor de la clase "Pdb" tiene un nuevo argumento *readrc*
opcional para controlar si se deben leer los archivos ".pdbrc".


pepinillo
---------

Los objetos que necesitan que se llame a "__new__" con argumentos de
palabras clave ahora se pueden seleccionar utilizando pickle protocols
anterior a la versión del protocolo 4. La versión 4 del protocolo ya
es compatible con este caso. (Contribuido por Serhiy Storchaka en
bpo-24164.)


pepinillos
----------

"pickletools.dis()" ahora genera el índice de memo implícito para el
código de operación "MEMOIZE". (Contribuido por Serhiy Storchaka en
bpo-25382).


pydoc
-----

El módulo "pydoc" ha aprendido a respetar la variable de entorno
"MANPAGER". (Contribuido por Matthias Klose en bpo-8637.)

"help()" y "pydoc" ahora pueden enumerar campos de tupla con nombre en
el orden en que se definieron en lugar de alfabéticamente.
(Contribuido por Raymond Hettinger en bpo-24879.)


aleatorio
---------

La nueva función "choices()" devuelve una lista de elementos de tamaño
especificado de la población dada con pesos opcionales. (Contribuido
por Raymond Hettinger en bpo-18844.)


re
--

Se agregó soporte para lapsos de modificadores en expresiones
regulares. Ejemplos: "'(?i:p)ython'" coincide con "'python'" y
"'Python'", pero no con "'PYTHON'"; "'(?i)g(?-i:v)r'" coincide con
"'GvR'" y "'gvr'", pero no con "'GVR'". (Contribuido por Serhiy
Storchaka en bpo-433028.)

Se puede acceder a los grupos de objetos coincidentes mediante
"__getitem__", que es equivalente a "group()". Entonces "mo['name']"
ahora es equivalente a "mo.group('name')". (Contribuido por Eric Smith
en bpo-24454.)

Los objetos "Match" ahora admiten "index-like objects" como índices de
grupo. (Contribuido por Jeroen Demeyer y Xiang Zhang en bpo-27177.)


readline
--------

Se agregó "set_auto_history()" para habilitar o deshabilitar la
adición automática de entradas a la lista del historial. (Contribuido
por Tyler Crompton en bpo-26870.)


rlcompleter
-----------

Los nombres de atributos privados y especiales ahora se omiten a menos
que el prefijo comience con guiones bajos. Se agrega un espacio o dos
puntos después de algunas palabras clave completadas. (Contribuido por
Serhiy Storchaka en bpo-25011 y bpo-25209.)


shlex
-----

El "shlex" tiene mucho improved shell compatibility a través del nuevo
argumento *punctuation_chars* para controlar qué caracteres se tratan
como puntuación. (Contribuido por Vinay Sajip en bpo-1521950.)


sitio
-----

Al especificar rutas para agregar a "sys.path" en un archivo ".pth",
ahora puede especificar rutas de archivos sobre directorios (por
ejemplo, archivos zip). (Contribuido por Wolfgang Langner en
bpo-26587).


sqlite3
-------

"sqlite3.Cursor.lastrowid" ahora admite la declaración "REPLACE".
(Contribuido por Alex LordThorsen en bpo-16864.)


enchufe
-------

La función "ioctl()" ahora admite el código de control
"SIO_LOOPBACK_FAST_PATH". (Contribución de Daniel Stokes en
bpo-26536).

Las constantes "getsockopt()" "SO_DOMAIN", "SO_PROTOCOL", "SO_PEERSEC"
y "SO_PASSSEC" ahora son compatibles. (Contribuido por Christian
Heimes en bpo-26907.)

El "setsockopt()" ahora admite el formulario "setsockopt(level,
optname, None, optlen: int)". (Contribuido por Christian Heimes en
bpo-27744.)

El módulo de socket ahora admite la familia de direcciones "AF_ALG"
para interactuar con la API de cifrado del kernel de Linux. Se
agregaron "ALG_*", "SOL_ALG" y "sendmsg_afalg()". (Contribución de
Christian Heimes en bpo-27744 con el apoyo de Victor Stinner).

Se agregaron las nuevas constantes de Linux "TCP_USER_TIMEOUT" y
"TCP_CONGESTION". (Contribuido por Omar Sandoval, bpo-26273).


servidor de sockets
-------------------

Los servidores basados en el módulo "socketserver", incluidos los
definidos en "http.server", "xmlrpc.server" y "wsgiref.simple_server",
ahora admiten el protocolo *context manager*. (Contribuido por Aviv
Palivoda en bpo-26404.)

The "wfile" attribute of "StreamRequestHandler" classes now implements
the "io.BufferedIOBase" writable interface.  In particular, calling
"write()" is now guaranteed to send the data in full.  (Contributed by
Martin Panter in bpo-26721.)


ssl
---

"ssl" es compatible con OpenSSL 1.1.0. La versión mínima recomendada
es 1.0.2. (Contribuido por Christian Heimes en bpo-26470.)

Se ha eliminado 3DES de los conjuntos de cifrado predeterminados y se
han agregado conjuntos de cifrado ChaCha20 Poly1305. (Contribuido por
Christian Heimes en bpo-27850 y bpo-27766.)

"SSLContext" tiene una mejor configuración predeterminada para
opciones y cifrados. (Contribuido por Christian Heimes en bpo-28043.)

La sesión SSL se puede copiar de una conexión del lado del cliente a
otra con la nueva clase "SSLSession". La reanudación de la sesión de
TLS puede acelerar el apretón de manos inicial, reducir la latencia y
mejorar el rendimiento (Contribuido por Christian Heimes en bpo-19500
basado en un borrador de Alex Warhawk).

El nuevo método "get_ciphers()" se puede utilizar para obtener una
lista de cifrados habilitados en orden de prioridad de cifrado.

All constants and flags have been converted to "IntEnum" and
"IntFlag". (Contributed by Christian Heimes in bpo-28025.)

Se agregaron protocolos TLS específicos del lado del servidor y del
cliente para "SSLContext". (Contribuido por Christian Heimes en
bpo-28085.)

Se agregó "ssl.SSLContext.post_handshake_auth" para habilitar y
"ssl.SSLSocket.verify_client_post_handshake()" para iniciar la
autenticación posterior al protocolo de enlace TLS 1.3. (Contribuido
por Christian Heimes en gh-78851.)


Estadísticas
------------

Se ha agregado una nueva función "harmonic_mean()". (Contribuido por
Steven D'Aprano en bpo-27181.)


estructura
----------

"struct" ahora admite flotadores de media precisión IEEE 754 a través
del especificador de formato "'e'". (Contribuido por Eli Stevens, Mark
Dickinson en bpo-11734.)


subproceso
----------

El destructor "subprocess.Popen" ahora emite una advertencia
"ResourceWarning" si el proceso hijo todavía se está ejecutando.
Utilice el protocolo del administrador de contexto ("with proc: ...")
o llame explícitamente al método "wait()" para leer el estado de
salida del proceso hijo. (Contribuido por Victor Stinner en
bpo-26741.)

El constructor "subprocess.Popen" y todas las funciones que le pasan
argumentos ahora aceptan argumentos *encoding* y *errors*.
Especificando alguno de ellos activará el modo texto para *stdin*,
*stdout* y *stderr*. (Contribuido por Steve Dower en bpo-6135.)


sys
---

La nueva función "getfilesystemencodeerrors()" devuelve el nombre del
modo de error utilizado para convertir entre nombres de archivo
Unicode y nombres de archivo en bytes. (Contribuido por Steve Dower en
bpo-27781.)

En Windows, el valor de retorno de la función "getwindowsversion()"
ahora incluye el campo *platform_version* que contiene la versión
principal precisa, la versión secundaria y el número de compilación
del sistema operativo actual, en lugar de la versión que se está
emulando para el proceso (contribución de Steve Dower en bpo-27932 .)


telnetlib
---------

"telnetlib.Telnet" es ahora un administrador de contexto (contribución
de Stéphane Wirtel en bpo-25485).


tiempo
------

The "struct_time" attributes "tm_gmtoff" and "tm_zone" are now
available on all platforms.


cronométralo
------------

Se ha agregado el nuevo método de conveniencia "Timer.autorange()"
para llamar a "Timer.timeit()" repetidamente para que el tiempo de
ejecución total sea mayor o igual a 200 milisegundos. (Contribuido por
Steven D'Aprano en bpo-6422.)

"timeit" ahora advierte cuando hay una variación sustancial (4x) entre
el mejor y el peor momento. (Contribuido por Serhiy Storchaka en
bpo-23552.)


tkinter
-------

Added methods "Variable.trace_add()", "Variable.trace_remove()" and
"trace_info()" in the "tkinter.Variable" class.  They replace old
methods "trace_variable()", "trace()", "trace_vdelete()" and
"trace_vinfo()" that use obsolete Tcl commands and might not work in
future versions of Tcl. (Contributed by Serhiy Storchaka in
bpo-22115).


rastrear
--------

Tanto el módulo de rastreo como la pantalla de excepción incorporada
del intérprete ahora abrevian largas secuencias de líneas repetidas en
los rastreos como se muestra en el siguiente ejemplo:

   >>> def f(): f()
   ...
   >>> f()
   Traceback (most recent call last):
     File "<stdin>", line 1, in <module>
     File "<stdin>", line 1, in f
     File "<stdin>", line 1, in f
     File "<stdin>", line 1, in f
     [Previous line repeated 995 more times]
   RecursionError: maximum recursion depth exceeded

(Contribuido por Emanuel Barry en bpo-26823.)


tracemalloc
-----------

El módulo "tracemalloc" ahora admite el seguimiento de asignaciones de
memoria en varios espacios de direcciones diferentes.

Se ha agregado la nueva clase de filtro "DomainFilter" para filtrar
los rastros de bloques por su espacio de direcciones (dominio).

(Contribuido por Victor Stinner en bpo-26588.)


mecanografía
------------

Dado que el módulo "typing" es *provisional*, todos los cambios
introducidos en Python 3.6 también se han actualizado a Python 3.5.x.

El módulo "typing" tiene un soporte mucho mejor para los alias de tipo
genérico. Por ejemplo, "Dict[str, Tuple[S, T]]" ahora es una anotación
de tipo válida. (Contribuido por Guido van Rossum en Github #195.)

Se ha agregado la clase "typing.ContextManager" para representar
"contextlib.AbstractContextManager". (Contribuido por Brett Cannon en
bpo-25609.)

Se ha agregado la clase "typing.Collection" para representar
"collections.abc.Collection". (Contribuido por Ivan Levkivskyi en
bpo-27598.)

Se ha agregado la construcción de tipo "typing.ClassVar" para marcar
las variables de clase. Como se introdujo en **PEP 526**, una
anotación de variable envuelta en ClassVar indica que un atributo dado
está destinado a ser utilizado como una variable de clase y no debe
establecerse en instancias de esa clase. (Contribuido por Ivan
Levkivskyi en Github #280.)

Una nueva constante "TYPE_CHECKING" que se supone que es "True" por
los verificadores de tipo estático, pero es "False" en tiempo de
ejecución. (Contribuido por Guido van Rossum en Github #230.)

Se ha agregado una nueva función auxiliar "NewType()" para crear tipos
distintos ligeros para anotaciones:

   from typing import NewType

   UserId = NewType('UserId', int)
   some_id = UserId(524313)

El verificador de tipo estático tratará el nuevo tipo como si fuera
una subclase del tipo original. (Contribuido por Ivan Levkivskyi en
Github #189.)


unicodedata
-----------

El módulo "unicodedata" ahora usa datos de Unicode 9.0.0. (Contribuido
por Benjamin Peterson).


unittest.mock
-------------

La clase "Mock" tiene las siguientes mejoras:

* Dos nuevos métodos, "Mock.assert_called()" y
  "Mock.assert_called_once()" para verificar si se llamó al objeto
  simulado. (Contribuido por Amit Saha en bpo-26323.)

* El método "Mock.reset_mock()" ahora tiene dos argumentos opcionales
  de solo palabras clave: *return_value* and *side_effect*.
  (Contribuido por Kushal Das en bpo-21271.)


urllib.request
--------------

If a HTTP request has a file or iterable body (other than a bytes
object) but no "Content-Length" header, rather than throwing an error,
"AbstractHTTPHandler" now falls back to use chunked transfer encoding.
(Contributed by Demian Brecht and Rolf Krahl in bpo-12319.)


urllib.robotparser
------------------

"RobotFileParser" ahora admite las extensiones "Crawl-delay" y
"Request-rate". (Contribuido por Nikolay Bogoychev en bpo-16099.)


venv
----

"venv" acepta un nuevo parámetro "--prompt". Este parámetro
proporciona un prefijo alternativo para el entorno virtual. (Propuesto
por Łukasz Balcerzak y portado a 3.6 por Stéphane Wirtel en
bpo-22829.)


advertencias
------------

A new optional *source* parameter has been added to the
"warnings.warn_explicit()" function: the destroyed object which
emitted a "ResourceWarning". A *source* attribute has also been added
to "warnings.WarningMessage" (contributed by Victor Stinner in
bpo-26568 and bpo-26567).

Cuando se registra una advertencia "ResourceWarning", el módulo
"tracemalloc" ahora se usa para intentar recuperar el rastreo donde se
asignó el objeto destruido.

Ejemplo con el script "example.py":

   import warnings

   def func():
       return open(__file__)

   f = func()
   f = None

Salida del comando "python3.6 -Wd -X tracemalloc=5 example.py":

   example.py:7: ResourceWarning: unclosed file <_io.TextIOWrapper name='example.py' mode='r' encoding='UTF-8'>
     f = None
   Object allocated at (most recent call first):
     File "example.py", lineno 4
       return open(__file__)
     File "example.py", lineno 6
       f = func()

El rastreo "Objeto asignado en" es nuevo y solo se muestra si
"tracemalloc" está rastreando asignaciones de memoria de Python y si
el módulo "warnings" ya fue importado.


winreg
------

Se agregó el tipo entero de 64 bits "REG_QWORD". (Contribuido por
Clement Rouault en bpo-23026.)


winsonido
---------

Se permite que los argumentos de palabras clave se pasen a "Beep",
"MessageBeep" y "PlaySound" (bpo-27982).


xmlrpc.client
-------------

El módulo "xmlrpc.client" ahora admite la descomposición de tipos de
datos adicionales utilizados por la implementación Apache XML-RPC para
números y "None". (Contribuido por Serhiy Storchaka en bpo-26885.)


archivo zip
-----------

Un nuevo método de clase "ZipInfo.from_file()" permite crear una
instancia "ZipInfo" a partir de un archivo del sistema de archivos. Se
puede usar un nuevo método "ZipInfo.is_dir()" para verificar si la
instancia "ZipInfo" representa un directorio. (Contribuido por Thomas
Kluyver en bpo-26039.)

El método "ZipFile.open()" ahora se puede utilizar para escribir datos
en un archivo ZIP, así como para extraer datos. (Contribuido por
Thomas Kluyver en bpo-26039.)


zlib
----

Las funciones "compress()" y "decompress()" ahora aceptan argumentos
de palabras clave. (Contribuido por Aviv Palivoda en bpo-26243 y Xiang
Zhang en bpo-16764 respectivamente).


Optimizaciones
==============

* El intérprete de Python ahora usa un código de palabra de 16 bits en
  lugar de un código de bytes, lo que hizo posible una serie de
  optimizaciones de código de operación. (Contribuido por Demur Rumed
  con aportes y reseñas de Serhiy Storchaka y Victor Stinner en
  bpo-26647 y bpo-28050.)

* La clase "asyncio.Future" ahora tiene una implementación C
  optimizada. (Contribuido por Yury Selivanov e INADA Naoki en
  bpo-26081.)

* La clase "asyncio.Task" ahora tiene una implementación C optimizada.
  (Contribuido por Yury Selivanov en bpo-28544.)

* Varias mejoras de implementación en el módulo "typing" (como el
  almacenamiento en caché de tipos genéricos) permiten mejoras de
  rendimiento hasta 30 veces mayores y una huella de memoria reducida.

* El decodificador ASCII ahora es hasta 60 veces más rápido para los
  controladores de errores "surrogateescape", "ignore" y "replace"
  (Contribuido por Victor Stinner en bpo-24870).

* Los codificadores ASCII y Latin1 ahora son hasta 3 veces más rápidos
  para el controlador de errores "surrogateescape" (Contribuido por
  Victor Stinner en bpo-25227).

* El codificador UTF-8 ahora es hasta 75 veces más rápido para los
  controladores de errores "ignore", "replace", "surrogateescape",
  "surrogatepass" (Contribuido por Victor Stinner en bpo-25267).

* El decodificador UTF-8 ahora es hasta 15 veces más rápido para los
  controladores de errores "ignore", "replace" y "surrogateescape"
  (Contribuido por Victor Stinner en bpo-25301).

* "bytes % args" ahora es hasta 2 veces más rápido. (Contribuido por
  Victor Stinner en bpo-25349).

* "bytearray % args" es ahora entre 2,5 y 5 veces más rápido.
  (Contribuido por Victor Stinner en bpo-25399).

* Optimice "bytes.fromhex()" y "bytearray.fromhex()": ahora son entre
  2 y 3,5 veces más rápidos. (Contribuido por Victor Stinner en
  bpo-25401).

* Optimice "bytes.replace(b'', b'.')" y "bytearray.replace(b'',
  b'.')": hasta un 80% más rápido. (Contribuido por Josh Snider en
  bpo-26574).

* Las funciones de asignación del dominio "PyMem_Malloc()"
  ("PYMEM_DOMAIN_MEM") ahora utilizan la función pymalloc memory
  allocator en lugar de la función "malloc()" de la biblioteca C. El
  asignador pymalloc está optimizado para objetos más pequeños o
  iguales a 512 bytes con una vida útil corta, y utiliza "malloc()"
  para bloques de memoria más grandes. (Contribuido por Victor Stinner
  en bpo-26249).

* "pickle.load()" y "pickle.loads()" ahora son hasta un 10% más
  rápidos al deserializar muchos objetos pequeños (contribución de
  Victor Stinner en bpo-27056).

* Pasar *keyword arguments* a una función tiene una sobrecarga en
  comparación con pasar *positional arguments*. Ahora, en las
  funciones de extensión implementadas con el uso de Argument Clinic,
  esta sobrecarga se reduce significativamente. (Contribuido por
  Serhiy Storchaka en bpo-27574).

* Funciones "glob()" y "iglob()" optimizadas en el módulo "glob";
  ahora son unas 3 a 6 veces más rápidas. (Contribuido por Serhiy
  Storchaka en bpo-25596).

* Globbing optimizado en "pathlib" mediante "os.scandir()"; ahora es
  alrededor de 1,5 a 4 veces más rápido. (Contribuido por Serhiy
  Storchaka en bpo-26032).

* Se ha mejorado significativamente el rendimiento de análisis,
  iteración y copia profunda de "xml.etree.ElementTree". (Contribuido
  por Serhiy Storchaka en bpo-25638, bpo-25873 y bpo-25869.)

* La creación de instancias de "fractions.Fraction" a partir de
  flotantes y decimales es ahora de 2 a 3 veces más rápida.
  (Contribuido por Serhiy Storchaka en bpo-25971.)


Cambios en la API de Build y C
==============================

* Python ahora requiere algo de compatibilidad con C99 en la cadena de
  herramientas para compilarse. En particular, Python ahora usa macros
  y tipos de enteros estándar en lugar de macros personalizadas como
  "PY_LONG_LONG". Para obtener más información, consulte **PEP 7** y
  bpo-17884.

* La compilación cruzada de CPython con el NDK de Android y el nivel
  de API de Android establecido en 21 (Android 5.0 Lollipop) o
  superior se ejecuta correctamente. Si bien Android aún no es una
  plataforma compatible, el conjunto de pruebas de Python se ejecuta
  en el emulador de Android con solo alrededor de 16 fallas en las
  pruebas. Consulte el meta-problema de Android bpo-26865.

* Se ha agregado el indicador de configuración "--enable-
  optimizations". Activarlo activará optimizaciones costosas como PGO.
  (Parche original de Alecsandru Patrascu de Intel en bpo-26359.)

* Ahora se debe mantener *GIL* cuando se llaman las funciones de
  asignador de los dominios "PYMEM_DOMAIN_OBJ" (por ejemplo:
  "PyObject_Malloc()") y "PYMEM_DOMAIN_MEM" (por ejemplo:
  "PyMem_Malloc()").

* Nueva API "Py_FinalizeEx()" que indica si fallaron los datos
  almacenados en búfer. (Contribuido por Martin Panter en bpo-5319.)

* "PyArg_ParseTupleAndKeywords()" ahora es compatible con positional-
  only parameters. Los parámetros solo posicionales se definen
  mediante nombres vacíos. (Contribuido por Serhiy Storchaka en
  bpo-26282).

* El método "PyTraceback_Print" ahora abrevia secuencias largas de
  líneas repetidas como ""[Previous line repeated {count} more
  times]"". (Contribuido por Emanuel Barry en bpo-26823.)

* La nueva función "PyErr_SetImportErrorSubclass()" permite
  especificar una subclase de "ImportError" para aumentar.
  (Contribuido por Eric Snow en bpo-15767.)

* La nueva función "PyErr_ResourceWarning()" se puede utilizar para
  generar un "ResourceWarning" que proporcione la fuente de la
  asignación de recursos. (Contribuido por Victor Stinner en
  bpo-26567.)

* La nueva función "PyOS_FSPath()" devuelve la representación del
  sistema de archivos de un *path-like object*. (Contribuido por Brett
  Cannon en bpo-27186.)

* Las funciones "PyUnicode_FSConverter()" y "PyUnicode_FSDecoder()"
  ahora aceptarán *path-like objects*.


Otras mejoras
=============

* Cuando "--version" (forma corta: "-V") se suministra dos veces,
  Python imprime "sys.version" para obtener información detallada.

     $ ./python -VV
     Python 3.6.0b4+ (3.6:223967b49e49+, Nov 21 2016, 20:55:04)
     [GCC 4.2.1 Compatible Apple LLVM 8.0.0 (clang-800.0.42.1)]


Obsoleto
========


Nuevas palabras clave
---------------------

No se recomienda el uso de "async" y "await" como nombres de variable,
clase, función o módulo. Introducidos por **PEP 492** en Python 3.5,
se convertirán en palabras clave adecuadas en Python 3.7. A partir de
Python 3.6, el uso de "async" o "await" como nombres lanzará un
"DeprecationWarning".


Comportamiento de Python obsoleto
---------------------------------

Al generar la excepción "StopIteration" dentro de un generador, ahora
se lanzará un "DeprecationWarning" y se activará un "RuntimeError" en
Python 3.7. Consulte PEP 479: Cambiar el gestor de StopIteration
dentro de generadores para obtener más detalles.

The "__aiter__()" method is now expected to return an asynchronous
iterator directly instead of returning an awaitable as previously.
Doing the former will trigger a "DeprecationWarning".  Backward
compatibility will be removed in Python 3.7. (Contributed by Yury
Selivanov in bpo-27243.)

Un par de caracteres de barra invertida que no es una secuencia de
escape válida ahora genera un "DeprecationWarning". Aunque
eventualmente se convertirá en un "SyntaxError", no será así para
varias versiones de Python. (Contribuido por Emanuel Barry en
bpo-27364.)

Al realizar una importación relativa, recurrir a "__name__" y
"__path__" desde el módulo de llamada cuando "__spec__" o
"__package__" no están definidos ahora genera un "ImportWarning".
(Contribuido por Rose Ames en bpo-25791.)


Módulos, funciones y métodos de Python obsoletos
------------------------------------------------


asynchat
~~~~~~~~

El "asynchat" ha quedado obsoleto en favor del "asyncio". (Contribuido
por Mariatta en bpo-25002.)


asyncore
~~~~~~~~

El "asyncore" ha quedado obsoleto en favor del "asyncio". (Contribuido
por Mariatta en bpo-25002.)


dbm
~~~

A diferencia de otras implementaciones de "dbm", el módulo "dbm.dumb"
crea bases de datos con el modo "'rw'" y permite modificar la base de
datos abierta con el modo "'r'". Este comportamiento ahora está en
desuso y se eliminará en 3.8. (Contribuido por Serhiy Storchaka en
bpo-21708.)


distutils
~~~~~~~~~

El argumento "extra_path" no documentado para el constructor
"distutils.Distribution" ahora se considera obsoleto y generará una
advertencia si se configura. La compatibilidad con este parámetro se
eliminará en una futura versión de Python. Consulte bpo-27919 para
obtener más detalles.


grp
~~~

La compatibilidad con argumentos no enteros en "getgrgid()" ha quedado
obsoleta. (Contribuido por Serhiy Storchaka en bpo-26129.)


importlib
~~~~~~~~~

The "importlib.machinery.SourceFileLoader.load_module" and
"importlib.machinery.SourcelessFileLoader.load_module" methods are now
deprecated. They were the only remaining implementations of
"importlib.abc.Loader.load_module" in "importlib" that had not been
deprecated in previous versions of Python in favour of
"importlib.abc.Loader.exec_module()".

La clase "importlib.machinery.WindowsRegistryFinder" ya no se utiliza.
A partir de la versión 3.6.0, todavía se agrega a "sys.meta_path" de
manera predeterminada (en Windows), pero esto puede cambiar en futuras
versiones.


os
~~

El soporte no documentado de *bytes-like objects* general como rutas
en funciones "os", "compile()" y funciones similares ahora está en
desuso. (Contribuido por Serhiy Storchaka en bpo-25791 y bpo-26754.)


re
~~

La compatibilidad con indicadores en línea "(?letters)" en el medio de
la expresión regular ha quedado obsoleta y se eliminará en una versión
futura de Python. Aún se permiten las banderas al comienzo de una
expresión regular. (Contribuido por Serhiy Storchaka en bpo-22493.)


ssl
~~~

OpenSSL 0.9.8, 1.0.0 y 1.0.1 están obsoletos y ya no son compatibles.
En el futuro, el módulo "ssl" requerirá al menos OpenSSL 1.0.2 o
1.1.0.

Los argumentos relacionados con SSL como "certfile", "keyfile" y
"check_hostname" en "ftplib", "http.client", "imaplib", "poplib" y
"smtplib" se han desaprobado en favor de "context". (Contribuido por
Christian Heimes en bpo-28022.)

Un par de protocolos y funciones del módulo "ssl" ahora están en
desuso. Algunas funciones ya no estarán disponibles en futuras
versiones de OpenSSL. Otras funciones están obsoletas en favor de una
API diferente. (Contribuido por Christian Heimes en bpo-28022 y
bpo-26470.)


tkinter
~~~~~~~

El módulo "tkinter.tix" ahora está en desuso. Los usuarios de
"tkinter" deberían utilizar "tkinter.ttk" en su lugar.


venv
~~~~

La secuencia de comandos "pyvenv" se ha desaprobado en favor de
"python3 -m venv". Esto evita la confusión en cuanto a qué intérprete
de Python "pyvenv" está conectado y, por lo tanto, qué intérprete de
Python será utilizado por el entorno virtual. (Contribuido por Brett
Cannon en bpo-25154.)


xml
---

* Como medida de mitigación frente a la recuperación de DTD y
  entidades externas, los módulos "xml.dom.minidom" y "xml.sax" ya no
  procesan entidades externas de forma predeterminada. (Contribuido
  por Christian Heimes en gh-61441.)


Funciones y tipos obsoletos de la API de C
------------------------------------------

Las funciones no documentadas "PyUnicode_AsEncodedObject()",
"PyUnicode_AsDecodedObject()", "PyUnicode_AsEncodedUnicode()" y
"PyUnicode_AsDecodedUnicode()" ya no se utilizan. Utilice generic
codec based API en su lugar.


Opciones de compilación obsoletas
---------------------------------

El indicador de configuración "--with-system-ffi" ahora está activado
de forma predeterminada en plataformas UNIX que no son macOS. Puede
deshabilitarse mediante "--without-system-ffi", pero el uso de la
marca está obsoleto y no se aceptará en Python 3.7. macOS no se ve
afectado por este cambio. Tenga en cuenta que muchos distribuidores de
sistemas operativos ya utilizan el indicador "--with-system-ffi" al
crear su sistema Python.


Remoto
======


Eliminaciones de API y funciones
--------------------------------

* Los escapes desconocidos que constan de "'\'" y una letra ASCII en
  expresiones regulares ahora provocarán un error. En las plantillas
  de reemplazo para "re.sub()", todavía están permitidas, pero en
  desuso. La bandera "re.LOCALE" ahora solo se puede usar con patrones
  binarios.

* Se eliminó "inspect.getmoduleinfo()" (quedó en desuso desde CPython
  3.3). Se debe utilizar "inspect.getmodulename()" para obtener el
  nombre del módulo para una ruta determinada. (Contribuido por Yury
  Selivanov en bpo-13248.)

* La clase "traceback.Ignore" y los métodos "traceback.usage",
  "traceback.modname", "traceback.fullmodname",
  "traceback.find_lines_from_code", "traceback.find_lines",
  "traceback.find_strings", "traceback.find_executable_lines" se
  eliminaron del módulo "traceback". Eran métodos no documentados en
  desuso desde Python 3.2 y la funcionalidad equivalente está
  disponible en métodos privados.

* Se eliminaron los métodos ficticios "tk_menuBar()" y
  "tk_bindForTraversal()" en las clases de widgets "tkinter" (los
  comandos Tk correspondientes estaban obsoletos desde Tk 4.0).

* El método "open()" de la clase "zipfile.ZipFile" ya no admite el
  modo "'U'" (quedó obsoleto desde Python 3.4). Utilice
  "io.TextIOWrapper" para leer archivos de texto comprimidos en modo
  *universal newlines*.

* Los módulos indocumentados "IN", "CDROM", "DLFCN", "TYPES", "CDIO" y
  "STROPTS" se han eliminado. Habían estado disponibles en los
  directorios "Lib/plat-*/" específicos de la plataforma, pero estaban
  desactualizados de forma crónica, estaban disponibles de manera
  incoherente en todas las plataformas y no se mantenían. El script
  que creó estos módulos todavía está disponible en la distribución
  fuente en: source: Tools / scripts / h2py.py.

* Se ha eliminado la clase "asynchat.fifo" obsoleta.


Portar a Python 3.6
===================

Esta sección enumera los cambios descritos anteriormente y otras
correcciones de errores que pueden requerir cambios en su código.


Cambios en el comportamiento del comando 'python'
-------------------------------------------------

* La salida de una compilación especial de Python con macros
  "COUNT_ALLOCS", "SHOW_ALLOC_COUNT" o "SHOW_TRACK_COUNT" definidas
  ahora está desactivada de forma predeterminada. Se puede volver a
  habilitar usando la opción "-X showalloccount". Ahora emite a
  "stderr" en lugar de "stdout". (Contribuido por Serhiy Storchaka en
  bpo-23034.)


Cambios en la API de Python
---------------------------

* "open()" ya no permitirá combinar el indicador de modo "'U'" con
  "'+'". (Contribuido por Jeff Balogh y John O'Connor en bpo-2091.)

* "sqlite3" ya no confirma implícitamente una transacción abierta
  antes de las declaraciones DDL.

* En Linux, "os.urandom()" ahora se bloquea hasta que se inicializa el
  grupo de entropía aleatoria del sistema para aumentar la seguridad.

* Cuando se define "importlib.abc.Loader.exec_module()", también se
  debe definir "importlib.abc.Loader.create_module()".

* "PyErr_SetImportError()" ahora establece "TypeError" cuando su
  argumento **msg** no está establecido. Anteriormente, solo se
  devolvía "NULL".

* The format of the "codeobject.co_lnotab" attribute of code objects
  changed to support a negative line number delta. By default, Python
  does not emit bytecode with a negative line number delta. Functions
  using "frame.f_lineno", "PyFrame_GetLineNumber()" or
  "PyCode_Addr2Line()" are not affected. Functions directly decoding
  "co_lnotab" should be updated to use a signed 8-bit integer type for
  the line number delta, but this is only required to support
  applications using a negative line number delta. See
  "Objects/lnotab_notes.txt" for the "co_lnotab" format and how to
  decode it, and see the **PEP 511** for the rationale.

* Las funciones en el módulo "compileall" ahora devuelven booleanos en
  lugar de "1" o "0" para representar éxito o fracaso,
  respectivamente. Gracias a que los booleanos son una subclase de
  números enteros, esto solo debería ser un problema si estaba
  haciendo verificaciones de identidad para "1" o "0". Ver bpo-25768.

* Reading the "port" attribute of "urllib.parse.urlsplit()" and
  "urlparse()" results now raises "ValueError" for out-of-range
  values, rather than returning "None".  See bpo-20059.

* El módulo "imp" ahora lanza un "DeprecationWarning" en lugar de
  "PendingDeprecationWarning".

* The following modules have had missing APIs added to their "__all__"
  attributes to match the documented APIs: "calendar", "cgi", "csv",
  "ElementTree", "enum", "fileinput", "ftplib", "logging", "mailbox",
  "mimetypes", "optparse", "plistlib", "smtpd", "subprocess",
  "tarfile", "threading" and "wave".  This means they will export new
  symbols when "import *" is used. (Contributed by Joel Taddei and
  Jacek Kołodziej in bpo-23883.)

* Al realizar una importación relativa, si "__package__" no se compara
  igual que "__spec__.parent", entonces "ImportWarning" se lanza.
  (Contribuido por Brett Cannon en bpo-25791.)

* Cuando se realiza una importación relativa y no se conoce ningún
  paquete principal, se lanzará "ImportError". Anteriormente, se podía
  subir "SystemError". (Contribuido por Brett Cannon en bpo-18018.)

* Los servidores basados en el módulo "socketserver", incluidos los
  definidos en "http.server", "xmlrpc.server" y
  "wsgiref.simple_server", ahora solo detectan excepciones derivadas
  de "Exception". Por lo tanto, si un controlador de solicitudes lanza
  una excepción como "SystemExit" o "KeyboardInterrupt", ya no se
  llama a "handle_error()" y la excepción detendrá un servidor de un
  solo subproceso. (Contribuido por Martin Panter en bpo-23430.)

* "spwd.getspnam()" ahora lanza un "PermissionError" en lugar de
  "KeyError" si el usuario no tiene privilegios.

* El método "socket.socket.close()" ahora lanza una excepción si la
  llamada al sistema subyacente informó un error (por ejemplo,
  "EBADF"). (Contribuido por Martin Panter en bpo-26685.)

* El argumento *decode_data* para los constructores
  "smtpd.SMTPChannel" y "smtpd.SMTPServer" ahora es "False" de manera
  predeterminada. Esto significa que el argumento que se pasa a
  "process_message()" ahora es un objeto bytes de manera
  predeterminada y a "process_message()" se le pasarán argumentos de
  palabras clave. El código que ya se haya actualizado de acuerdo con
  la advertencia de obsolescencia generada por la versión 3.5 no se
  verá afectado.

* Todos los argumentos opcionales de las funciones "dump()",
  "dumps()", "load()" y "loads()" y los constructores de clase
  "JSONEncoder" y "JSONDecoder" en el módulo "json" ahora son keyword-
  only. (Contribuido por Serhiy Storchaka en bpo-18726.)

* Es posible que las subclases de "type" que no anulan "type.__new__"
  ya no utilicen la forma de un argumento para obtener el tipo de un
  objeto.

* As part of **PEP 487**, the handling of keyword arguments passed to
  "type" (other than the metaclass hint, "metaclass") is now
  consistently delegated to "object.__init_subclass__()". This means
  that "type.__new__" and "type.__init__" both now accept arbitrary
  keyword arguments, but "object.__init_subclass__()" (which is called
  from "type.__new__") will reject them by default. Custom metaclasses
  accepting additional keyword arguments will need to adjust their
  calls to "type.__new__" (whether direct or via "super") accordingly.

* En "distutils.command.sdist.sdist", se ha eliminado el atributo
  "default_format" y ya no se respeta. En su lugar, el formato de
  archivo tar comprimido con gzip es el predeterminado en todas las
  plataformas y no se realiza ninguna selección específica de la
  plataforma. En entornos donde las distribuciones se crean en Windows
  y se requieren distribuciones zip, configure el proyecto con un
  archivo "setup.cfg" que contenga lo siguiente:

     [sdist]
     formats=zip

  Este comportamiento también ha sido actualizado a versiones
  anteriores de Python por Setuptools 26.0.0.

* En el módulo "urllib.request" y el método
  "http.client.HTTPConnection.request()", si no se ha especificado
  ningún campo de encabezado Content-Length y el cuerpo de la
  solicitud es un objeto de archivo, ahora se envía con codificación
  fragmentada HTTP 1.1. Si un objeto de archivo debe enviarse a un
  servidor HTTP 1.0, la persona que llama ahora debe especificar el
  valor de Longitud de contenido. (Contribuido por Demian Brecht y
  Rolf Krahl con ajustes de Martin Panter en bpo-12319.)

* El "DictReader" ahora devuelve filas de tipo "OrderedDict".
  (Contribuido por Steve Holden en bpo-27842.)

* El "crypt.METHOD_CRYPT" ya no se agregará a "crypt.methods" si la
  plataforma no lo admite. (Contribuido por Victor Stinner en
  bpo-25287.)

* Los argumentos *verbose* and *rename* para "namedtuple()" ahora son
  solo palabras clave. (Contribuido por Raymond Hettinger en
  bpo-25628.)

* En Linux, "ctypes.util.find_library()" ahora busca bibliotecas
  compartidas en "LD_LIBRARY_PATH". (Contribuido por Vinay Sajip en
  bpo-9998.)

* La clase "imaplib.IMAP4" ahora maneja banderas que contienen el
  carácter "']'" en mensajes enviados desde el servidor para mejorar
  la compatibilidad en el mundo real. (Contribuido por Lita Cho en
  bpo-21815.)

* The "mmap.mmap.write()" function now returns the number of bytes
  written like other write methods. (Contributed by Jakub Stasiak in
  bpo-26335.)

* Las funciones "pkgutil.iter_modules()" y "pkgutil.walk_packages()"
  ahora devuelven tuplas con nombre "ModuleInfo". (Contribuido por
  Ramchandra Apte en bpo-17211.)

* "re.sub()" ahora lanza un error para referencias de grupos numéricos
  no válidos en plantillas de reemplazo, incluso si el patrón no se
  encuentra en la cadena. El mensaje de error para referencias de
  grupo no válidas ahora incluye el índice de grupo y la posición de
  la referencia. (Contribuido por SilentGhost, Serhiy Storchaka en
  bpo-25953.)

* "zipfile.ZipFile" ahora lanzará "NotImplementedError" para valores
  de compresión no reconocidos. Anteriormente se planteó un
  "RuntimeError" simple. Además, llamar a los métodos "ZipFile" en un
  ZipFile cerrado o llamar al método "write()" en un ZipFile creado
  con el modo "'r'" lanzará un "ValueError". Anteriormente, se planteó
  un "RuntimeError" en esos escenarios.

* cuando las metaclases personalizadas se combinan con "super()" de
  argumento cero o referencias directas de métodos a la variable de
  cierre "__class__" implícita, la entrada de espacio de nombres
  "__classcell__" implícita ahora debe pasarse a "type.__new__" para
  la inicialización. No hacerlo resultará en un "DeprecationWarning"
  en Python 3.6 y un "RuntimeError" en Python 3.8.

* Con la introducción de "ModuleNotFoundError", los consumidores del
  sistema de importación pueden comenzar a esperar que los reemplazos
  del sistema de importación generen esa excepción más específica
  cuando sea apropiado, en lugar de la excepción menos específica
  "ImportError". Para proporcionar compatibilidad futura con dichos
  consumidores, los implementadores de sistemas de importación
  alternativos que reemplacen completamente a "__import__()" deberán
  actualizar sus implementaciones para generar la nueva subclase
  cuando no se pueda encontrar un módulo. Los implementadores de
  complementos compatibles con el sistema de importación
  predeterminado no deberían necesitar realizar ningún cambio, ya que
  el sistema de importación predeterminado generará la nueva subclase
  cuando sea apropiado.


Cambios en la API de C
----------------------

* La familia de asignadores "PyMem_Malloc()" ahora usa el pymalloc
  allocator en lugar del sistema "malloc()". Las aplicaciones que
  llaman a "PyMem_Malloc()" sin sostener el GIL ahora pueden fallar.
  Establezca la variable de entorno "PYTHONMALLOC" en "debug" para
  validar el uso de asignadores de memoria en su aplicación. Ver
  bpo-26249.

* "Py_Exit()" (y el intérprete principal) ahora anula el estado de
  salida con 120 si fallaron los datos almacenados en el búfer. Ver
  bpo-5319.


Cambios en el código de bytes de CPython
----------------------------------------

Ha habido varios cambios importantes en el *bytecode* en Python 3.6.

* El intérprete de Python ahora usa un código de palabra de 16 bits en
  lugar de un código de bytes. (Contribuido por Demur Rumed con
  aportes y reseñas de Serhiy Storchaka y Victor Stinner en bpo-26647
  y bpo-28050.)

* The new "FORMAT_VALUE" and "BUILD_STRING" opcodes as part of the
  formatted string literal implementation. (Contributed by Eric Smith
  in bpo-25483 and Serhiy Storchaka in bpo-27078.)

* The new "BUILD_CONST_KEY_MAP" opcode to optimize the creation of
  dictionaries with constant keys. (Contributed by Serhiy Storchaka in
  bpo-27140.)

* The function call opcodes have been heavily reworked for better
  performance and simpler implementation. The "MAKE_FUNCTION",
  "CALL_FUNCTION", "CALL_FUNCTION_KW" and "BUILD_MAP_UNPACK_WITH_CALL"
  opcodes have been modified, the new "CALL_FUNCTION_EX" and
  "BUILD_TUPLE_UNPACK_WITH_CALL" have been added, and
  "CALL_FUNCTION_VAR", "CALL_FUNCTION_VAR_KW" and "MAKE_CLOSURE"
  opcodes have been removed. (Contributed by Demur Rumed in bpo-27095,
  and Serhiy Storchaka in bpo-27213, bpo-28257.)

* The new "SETUP_ANNOTATIONS" and "STORE_ANNOTATION" opcodes have been
  added to support the new *variable annotation* syntax. (Contributed
  by Ivan Levkivskyi in bpo-27985.)


Cambios notables en Python 3.6.2
================================


Nuevo objetivo de compilación "make regen-all"
----------------------------------------------

Para simplificar la compilación cruzada y garantizar que CPython se
pueda compilar de manera confiable sin requerir que una versión
existente de Python ya esté disponible, el sistema de compilación
basado en autotools ya no intenta volver a compilar implícitamente los
archivos generados en función de los tiempos de modificación del
archivo.

En su lugar, se ha agregado un nuevo comando "make regen-all" para
forzar la regeneración de estos archivos cuando se desee (por ejemplo,
después de que ya se haya creado una versión inicial de Python basada
en las versiones pregeneradas).

También se definen objetivos de regeneración más selectivos; consulte:
fuente: *Makefile.pre.in* para obtener más detalles.

(Contribuido por Victor Stinner en bpo-23404.)

Added in version 3.6.2.


Eliminación del objetivo de compilación "make touch"
----------------------------------------------------

Se ha eliminado el objetivo de compilación "make touch" que se
utilizaba anteriormente para solicitar la regeneración implícita de
archivos generados mediante la actualización de sus tiempos de
modificación.

Ha sido reemplazado por el nuevo objetivo "make regen-all".

(Contribuido por Victor Stinner en bpo-23404.)

Distinto en la versión 3.6.2.


Cambios notables en Python 3.6.4
================================

El singleton "PyExc_RecursionErrorInst" que formaba parte de la API
pública se ha eliminado ya que sus miembros nunca borrados pueden
causar una falla de segmentación durante la finalización del
intérprete. (Contribuido por Xavier de Gaye en bpo-22898 y bpo-30697.)


Cambios notables en Python 3.6.5
================================

La función "locale.localeconv()" ahora establece temporalmente la
configuración regional "LC_CTYPE" en la configuración regional
"LC_NUMERIC" en algunos casos. (Contribuido por Victor Stinner en
bpo-31900.)


Cambios notables en Python 3.6.7
================================

Los módulos "xml.dom.minidom" y "xml.sax" ya no procesan entidades
externas de forma predeterminada. Consulte también gh-61441.

En 3.6.7, el módulo "tokenize" ahora emite implícitamente un token
"NEWLINE" cuando se le proporciona una entrada que no tiene una nueva
línea al final. Este comportamiento ahora coincide con lo que hace el
tokenizador C internamente. (Contribuido por Ammar Askar en
bpo-33899.)


Cambios notables en Python 3.6.10
=================================

Debido a importantes problemas de seguridad, el parámetro
*reuse_address* de "asyncio.loop.create_datagram_endpoint()" ya no es
compatible. Esto se debe al comportamiento de la opción de socket
"SO_REUSEADDR" en UDP. Para obtener más detalles, consulte la
documentación de "loop.create_datagram_endpoint()". (Contribuido por
Kyle Stanley, Antoine Pitrou y Yury Selivanov en bpo-37228.)


Cambios notables en Python 3.6.13
=================================

Las versiones anteriores de Python permitían utilizar tanto ";" como
"&" como separadores de parámetros de consulta en
"urllib.parse.parse_qs()" y "urllib.parse.parse_qsl()". Por cuestiones
de seguridad y para cumplir con las recomendaciones más recientes del
W3C, esto se ha modificado para permitir solo una clave separadora,
con "&" como valor predeterminado. Este cambio también afecta a
"cgi.parse()" y "cgi.parse_multipart()", ya que utilizan las funciones
afectadas internamente. Para obtener más detalles, consulte su
documentación respectiva. (Contribuido por Adam Goldschmidt, Senthil
Kumaran y Ken Jin en bpo-42967).


Cambios notables en Python 3.6.14
=================================

Una corrección de seguridad modifica el comportamiento de "ftplib.FTP"
para que no confíe en la dirección IPv4 enviada desde el servidor
remoto al configurar un canal de datos pasivo. En su lugar,
reutilizamos la dirección IP del servidor FTP. Para el código inusual
que requiere el comportamiento anterior, configure un atributo
"trust_server_pasv_ipv4_address" en su instancia FTP en "True".
(Consulte gh-87451)

La presencia de caracteres de nueva línea o de tabulación en partes de
una URL permite algunas formas de ataques. Siguiendo la especificación
WHATWG que actualiza RFC 3986, el analizador "urllib.parse()" elimina
de la URL los caracteres de nueva línea ASCII "\n", "\r" y de
tabulación "\t" para evitar este tipo de ataques. Los caracteres
eliminados se controlan mediante una nueva variable de nivel de módulo
"urllib.parse._UNSAFE_URL_BYTES_TO_REMOVE". (Véase gh-88048)
