# Qué hay de nuevo en Python 3.5

Editores:

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

Este artículo explica las nuevas características de Python 3.5, en comparación con 3.4. Python 3.5 se publicó el 13 de septiembre de 2015. Consultar el registro de cambios para una lista completa de cambios.

Ver también

PEP 478 - Python 3.5 Calendario de lanzamiento de Python 3.5

## Resumen – Aspectos destacados de la versión

Nuevas características de sintaxis:

- PEP 492, corrutinas con sintaxis async y await.

- PEP 465, un nuevo operador de multiplicación de matrices: `a @ b`.

- PEP 448, generalizaciones de desembalaje adicionales.

Nuevos módulos:

- `typing`: PEP 484 – Indicador de tipos.

- `zipapp`: PEP 441 Mejora de soporte de la aplicación Python ZIP.

Nuevas características integradas:

- `bytes % args`, `bytearray % args`: PEP 461 – Agrega formato `%` a bytes y bytearray.

- Nuevos métodos `bytes.hex()`, `bytearray.hex()` y `memoryview.hex()`. (Contribución de Arnon Yaari en bpo-9951.)

- `memoryview` ahora admite la indexación de tuplas (incluida la multidimensional). (Contribución de Antoine Pitrou en bpo-23632.)

- Los generadores tienen un nuevo atributo `gi_yieldfrom`, el cual retorna el objeto que está siendo iterado por expresiones `yield from`. (Contribución de Benno Leslie y Yury Selivanov en bpo-24450.)

- Ahora se genera una nueva excepción `RecursionError` cuando se alcanza la profundidad máxima de recursividad. (Contribución de Georg Brandl en bpo-19235.)

Mejoras en la implementación de CPython:

- Cuando la configuración regional `LC_TYPE` es la configuración regional POSIX (configuración regional `C`), ahora `sys.stdin` y `sys.stdout` usan el controlador de errores `surrogateescape`, en lugar del controlador de errores `strict`. (Contribución de Victor Stinner en bpo-19977.)

- Los archivos `.pyo` ya no se utilizan y han sido reemplazados por un esquema más flexible que incluye el nivel de optimización explícitamente en el nombre `.pyc`. (Consultar la PEP 488 descripción general.)

- Ahora los módulos integrados y de extensión son inicializados en un proceso de múltiples fases, que es similar a cómo los módulos de Python son cargados. (Consultar PEP 489 descripción general.)

Mejoras significativas en la biblioteca estándar:

- `collections.OrderedDict` ahora está implementado en C, que lo hace de 4 a 100 veces más rápido.

- El módulo `ssl` adquirió soporte para la memoria BIO, que desacopla el manejo del protocolo SSL de la red de E/S.

- La nueva función `os.scandir()` proporciona una forma mejor y significativamente más rápida de recorrido de directorio.

- `functools.lru_cache()` ha sido principalmente reimplementado en C, produciendo un rendimiento mucho mejor.

- La nueva función `subprocess.run()` proporciona una forma simplificada de ejecutar subprocesos.

- El módulo `traceback` se ha mejorado significativamente para mejorar el rendimiento y la conveniencia del desarrollador.

Mejoras de seguridad:

- Ahora SSLv3 está deshabilitado en toda la biblioteca estándar. Aún se puede habilitar creando una instancia de `ssl.SSLContext` manualmente. (Consultar bpo-22638 para más detalles; este cambio fue respaldado a CPython 3.4 y 2.7.)

- Ahora el análisis de cookies HTTP es más estricto, con el fin de proteger contra posibles ataques de entrada. (Contribución de Antoine Pitrou en bpo-22796.)

Mejoras de Windows:

- Un nuevo instalador para Windows ha reemplazado al antiguo MSI. Consultar Uso de Python en Windows para más información.

- Ahora las compilaciones de Windows usan Microsoft Visual C++ 14.0, y los módulos de extensión deberían utilizar lo mismo.

Por favor sigue leyendo para obtener una lista completa de los cambios que se enfrentan los usuarios, incluidas muchas otras mejoras menores, optimizaciones de CPython, deprecaciones y posibles problemas de portabilidad.

## Nuevas características

### PEP 492 - Corrutinas con sintaxis async y await

PEP 492 mejora enormemente el soporte para la programación asíncrona en Python al agregar objetos aguardables, funciones corrutina, iteración asincrónica, y gestores asincrónicos de contexto.

Las funciones corrutina se declaran usando la nueva sintaxis `async def`:

    >>> async def coro():
    ...     return 'spam'

Dentro de una función corrutina, la nueva expresión `await` puede ser usada para suspender la ejecución de la corrutina hasta que el resultado esté disponible. Cualquier objeto puede ser awaited, siempre que implemente el protocolo awaitable al definir el método `__await__()`.

PEP 492 también agrega la declaración `async for` para una iteración conveniente sobre iterables asincrónicas.

Un ejemplo de un cliente rudimentario HTTP escrito con la nueva sintaxis:

    import asyncio

    async def http_get(domain):
        reader, writer = await asyncio.open_connection(domain, 80)

        writer.write(b'\r\n'.join([
            b'GET / HTTP/1.1',
            b'Host: %b' % domain.encode('latin-1'),
            b'Connection: close',
            b'', b''
        ]))

        async for line in reader:
            print('>>>', line)

        writer.close()

    loop = asyncio.get_event_loop()
    try:
        loop.run_until_complete(http_get('example.com'))
    finally:
        loop.close()

De manera similar a la iteración asincrónica, hay una nueva sintaxis para los gestores asincrónicos de contexto. El siguiente script:

    import asyncio

    async def coro(name, lock):
        print('coro {}: waiting for lock'.format(name))
        async with lock:
            print('coro {}: holding the lock'.format(name))
            await asyncio.sleep(1)
            print('coro {}: releasing the lock'.format(name))

    loop = asyncio.get_event_loop()
    lock = asyncio.Lock()
    coros = asyncio.gather(coro(1, lock), coro(2, lock))
    try:
        loop.run_until_complete(coros)
    finally:
        loop.close()

saldrá:

    coro 2: waiting for lock
    coro 2: holding the lock
    coro 1: waiting for lock
    coro 2: releasing the lock
    coro 1: holding the lock
    coro 1: releasing the lock

Ten en cuenta que tanto `async for` como `async with` solamente pueden ser utilizadas dentro de una función corrutina declarada con `async def`.

Las funciones corrutina están destinadas para ser ejecutadas dentro de un bucle de eventos compatible, como asyncio loop.

Nota

Distinto en la versión 3.5.2: A partir de CPython 3.5.2, `__aiter__` puede retornar directamente iteradores asincrónicos. Retornar un objeto awaitable resultará en `PendingDeprecationWarning`.

Consultar más detalles en la sección de la documentación Iteradores asíncronos.

Ver también

PEP 492 – Corrutinas con sintaxis async y await

  PEP escrito e implementado por Yury Selivanov.

### PEP 465 - Un operador infijo dedicado para la multiplicación de matrices

PEP 465 agrega el operador infijo `@` para la multiplicación de matrices. Actualmente, ningún tipo de Python incorporado implementa el nuevo operador, sin embargo, puede ser implementado al definir `__matmul__()`, `__rmatmul__()`, y `__imatmul__()` para la multiplicación de matrices regulares, reflejadas e in situ. La semántica de estos métodos es similar a la de los métodos que definen otros operadores infijos aritméticos.

La multiplicación de matrices es una operación notablemente común en muchos campos de las matemáticas, la ciencia, la ingeniería, y la adición de `@` permite escribir código más limpio:

    S = (H @ beta - r).T @ inv(H @ V @ H.T) @ (H @ beta - r)

en lugar de:

    S = dot((dot(H, beta) - r).T,
            dot(inv(dot(dot(H, V), H.T)), dot(H, beta) - r))

NumPy 1.10 tiene soporte para el nuevo operador:

    >>> import numpy

    >>> x = numpy.ones(3)
    >>> x
    array([ 1., 1., 1.])

    >>> m = numpy.eye(3)
    >>> m
    array([[ 1., 0., 0.],
           [ 0., 1., 0.],
           [ 0., 0., 1.]])

    >>> x @ m
    array([ 1., 1., 1.])

Ver también

PEP 465 – Un operador infijo dedicado para la multiplicación de matrices

  PEP escrito por Nathaniel J. Smith; implementado por Benjamin Peterson.

### PEP 448 - Generalizaciones de desembalaje adicionales

PEP 448 extiende los usos permitidos del operador de desembalaje iterable `*` y del operador de desembalaje del diccionario `**`. Ahora es posible utilizar un número arbitrario de desembalajes en llamadas a funciones:

    >>> print(*[1], *[2], 3, *[4, 5])
    1 2 3 4 5

    >>> def fn(a, b, c, d):
    ...     print(a, b, c, d)
    ...

    >>> fn(**{'a': 1, 'c': 3}, **{'b': 2, 'd': 4})
    1 2 3 4

De manera similar, las pantallas de tupla, lista, conjunto y diccionario permiten desembalajes múltiples (consultar Listas de expresiones and Despliegues de diccionario):

    >>> *range(4), 4
    (0, 1, 2, 3, 4)

    >>> [*range(4), 4]
    [0, 1, 2, 3, 4]

    >>> {*range(4), 4, *(5, 6, 7)}
    {0, 1, 2, 3, 4, 5, 6, 7}

    >>> {'x': 1, **{'y': 2}}
    {'x': 1, 'y': 2}

Ver también

PEP 448 – Generalizaciones de desembalaje adicionales

  PEP escrito por Joshua Landau; implementado por Neil Girdhar, Thomas Wouters y Joshua Landau.

### PEP 461 - soporte de formateo porcentual para bytes y bytearray

PEP 461 agrega soporte para el operador de interpolación `%` a `bytes` y `bytearray`.

Si bien la interpolación generalmente se considera una operación de cadena de caracteres, hay casos donde la interpolación en `bytes` o `bytearrays` tiene sentido y el trabajo necesario para compensar esta funcionalidad faltante resta valor a la legibilidad general del código. Este problema es particularmente importante cuando se trata con protocolos de formato de cable, que a menudo son una mezcla de texto compatible binario y ASCII.

Ejemplos:

    >>> b'Hello %b!' % b'World'
    b'Hello World!'

    >>> b'x=%i y=%f' % (1, 2.5)
    b'x=1 y=2.500000'

Unicode no está permitido para `%b`, pero es aceptado por `%a` (equivalente a `repr(obj).encode('ascii', 'backslashreplace')`):

    >>> b'Hello %b!' % 'World'
    Traceback (most recent call last):
      File "<stdin>", line 1, in <module>
    TypeError: %b requires bytes, or an object that implements __bytes__, not 'str'

    >>> b'price: %a' % '10€'
    b"price: '10\\u20ac'"

Ten en cuenta que los tipos de conversión `%s` y `%r`, aunque son compatibles, solo deben usarse en bases de código que necesiten compatibilidad con Python 2.

Ver también

PEP 461 – Agrega formato `%` a bytes y bytearray

  PEP escrito por Ethan Furman; implementado por Neil Schemenauer y Ethan Furman.

### PEP 484 - Indicador de tipos

La sintaxis de anotaciones de funciones ha sido una característica de Python desde la versión 3.0 (PEP 3107), sin embargo, la semántica de anotaciones se ha dejado indefinida.

La experiencia ha mostrado que la mayoría de los usos de las anotaciones de funciones eran para proporcionar el indicador de tipos para los parámetros de función y los valores de retorno. Se hizo evidente que sería beneficioso para los usuarios de Python, si la biblioteca estándar incluyera las definiciones y las herramientas base para las anotaciones de tipo.

PEP 484 introduce un módulo provisional para proporcionar estas definiciones y herramientas estándar, junto con algunas convenciones para situaciones en la que las anotaciones no están disponibles.

Por ejemplo, aquí hay una función simple cuyo argumento y tipo de retorno se declaran en las anotaciones:

    def greeting(name: str) -> str:
        return 'Hello ' + name

While these annotations are available at runtime through the usual `__annotations__` attribute, no automatic type checking happens at runtime. Instead, it is assumed that a separate off-line type checker (e.g. mypy) will be used for on-demand source code analysis.

El sistema de tipos admite uniones, tipos genéricos y un tipo especial llamado `Any` el cual es consistente con (esto es asignable desde y hacia) todos los tipos.

Ver también

- `typing` documentación del módulo

- PEP 484 – Indicador de tipos

    PEP escrito por Guido van Rossum, Jukka Lehtosalo y Łukasz Langa; implementado por Guido van Rossum.

- PEP 483 – La teoría del indicador de tipos

    PEP escrito por Guido van Rossum

### PEP 471 - Función os.scandir() – un iterador de directorio mejor y más rápido

PEP 471 agrega una nueva función de iteración de directorio, `os.scandir()`, a la biblioteca estándar. Adicionalmente, ahora `os.walk()` se implementa utilizando `scandir`, lo que lo hace de 3 a 5 veces más rápido en sistemas POSIX y de 7 a 20 veces más rápido en sistemas Windows. Esto se logra en gran medida al reducir enormemente el número de llamadas necesarias de `os.stat()` para recorrer un árbol de directorios.

También `scandir` retorna un iterador, en lugar de retornar una lista de nombres de archivos, lo que mejora la eficiencia de la memoria cuando se itera sobre directorios muy grandes.

El siguiente ejemplo presenta un uso simple de `os.scandir()` para mostrar todos los archivos (excluyendo directorios) en el path dado que no comienzan con `'.'`. La llamada a `entry.is_file()` generalmente no hará una llamada adicional al sistema:

    for entry in os.scandir(path):
        if not entry.name.startswith('.') and entry.is_file():
            print(entry.name)

Ver también

PEP 471 – Función os.scandir() – un iterador de directorio mejor y más rápido

  PEP escrito e implementado por Ben Hoyt con la ayuda de Victor Stinner.

### PEP 475: Reintentar las llamadas al sistema que fallan con EINTR

An `errno.EINTR` error code is returned whenever a system call, that is waiting for I/O, is interrupted by a signal. Previously, Python would raise `InterruptedError` in such cases. This meant that, when writing a Python application, the developer had two choices:

1. Ignorar el `InterruptedError`.

2. Manejar el `InterruptedError` y probar reiniciar la llamada interrumpida al sistema en cada sitio de llamada.

La primera opción hace que una aplicación falle intermitentemente. La segunda opción agrega una gran cantidad de código repetitivo que hace que el código sea casi ilegible. Compara:

    print("Hello World")

y:

    while True:
        try:
            print("Hello World")
            break
        except InterruptedError:
            continue

PEP 475 implementa el reintento automático de las llamadas al sistema en `EINTR`. Esto elimina la carga de lidiar con `EINTR` o la excepción `InterruptedError` en el código de usuario en la mayoría de las situaciones y hace que los programas de Python, incluida la biblioteca estándar, sean más robustos. Ten en cuenta que la llamada al sistema sólo se reintenta si el gestor de señales no lanza una excepción.

A continuación se muestra una lista de funciones que ahora se reintentan cuando son interrumpidas por una señal:

- `open()` y `io.open()`;

- funciones del módulo `faulthandler`;

- funciones del módulo `os`: `fchdir()`, `fchmod()`, `fchown()`, `fdatasync()`, `fstat()`, `fstatvfs()`, `fsync()`, `ftruncate()`, `mkfifo()`, `mknod()`, `open()`, `posix_fadvise()`, `posix_fallocate()`, `pread()`, `pwrite()`, `read()`, `readv()`, `sendfile()`, `wait3()`, `wait4()`, `wait()`, `waitid()`, `waitpid()`, `write()`, `writev()`;

- special cases: `os.close()` and `os.dup2()` now ignore `EINTR` errors; the syscall is not retried (see the PEP for the rationale);

- funciones del módulo `select`: `devpoll.poll()`, `epoll.poll()`, `kqueue.control()`, `poll.poll()`, `select()`;

- métodos de la clase `socket`: `accept()`, `connect()` (excepto para sockets sin bloqueo), `recv()`, `recvfrom()`, `recvmsg()`, `send()`, `sendall()`, `sendmsg()`, `sendto()`;

- `signal.sigtimedwait()` y `signal.sigwaitinfo()`;

- `time.sleep()`.

Ver también

PEP 475 – Reintentar las llamadas al sistema que fallan con EINTR

  PEP e implementación escrita por Charles-François Natali y Victor Stinner, con la ayuda de Antoine Pitrou (la conexión francesa).

### PEP 479: Cambiar el gestor de StopIteration dentro de generadores

La interacción de los generadores y `StopIteration` en las versiones de Python 3.4 y anteriores a veces fue sorprendente y podría ocultar bugs oscuros. Anteriormente, el `StopIteration` lanzado accidentalmente dentro de una función de generadores se interpretó como el final de la iteración por la construcción de bucle que impulsa el generador.

PEP 479 cambia el comportamiento de los generadores: cuando se lanza una excepción `StopIteration` dentro de un generador, se reemplaza con una excepción `RuntimeError` antes de que salga del marco del generador. El objetivo principal de este cambio es facilitar la depuración en la situación en la que una llamada desprotegida a la función `next()` lanza una excepción `StopIteration` y hace que la iteración controlada por el generador termine silenciosamente. Esto es particularmente pernicioso en combinación con la construcción `yield from`.

Este es un cambio incompatible hacia atrás, así que para habilitar el nuevo comportamiento, es necesario importar __future__:

    >>> from __future__ import generator_stop

    >>> def gen():
    ...     next(iter([]))
    ...     yield
    ...
    >>> next(gen())
    Traceback (most recent call last):
      File "<stdin>", line 2, in gen
    StopIteration

    The above exception was the direct cause of the following exception:

    Traceback (most recent call last):
      File "<stdin>", line 1, in <module>
    RuntimeError: generator raised StopIteration

Si no se importa `__future__`, se lanzará la excepción `PendingDeprecationWarning` siempre que se lance una excepción `StopIteration` dentro de un generador.

Ver también

PEP 479 – Cambiar el gestor de StopIteration dentro de generadores

  PEP escrito por Chris Angelico y Guido van Rossum. Implementado por Chris Angelico, Yury Selivanov y Nick Coghlan.

### PEP 485: Una función para probar la igualdad aproximada

PEP 485 agrega las funciones `math.isclose()` y `cmath.isclose()` que indican si dos valores son aproximadamente iguales o «cercanos» entre sí. Si dos valores se consideran cercanos o no, se determina conforme con las tolerancias absolutas y relativas dadas. La tolerancia relativa es la diferencia máxima permitida entre los argumentos `isclose`, en relación con el valor absoluto mayor:

    >>> import math
    >>> a = 5.0
    >>> b = 4.99998
    >>> math.isclose(a, b, rel_tol=1e-5)
    True
    >>> math.isclose(a, b, rel_tol=1e-6)
    False

También es posible comparar dos valores usando una tolerancia absoluta, que debe ser un valor no negativo:

    >>> import math
    >>> a = 5.0
    >>> b = 4.99998
    >>> math.isclose(a, b, abs_tol=0.00003)
    True
    >>> math.isclose(a, b, abs_tol=0.00001)
    False

Ver también

PEP 485 – Una función para probar la igualdad aproximada

  PEP escrito por Christopher Barker; implementado por Chris Barker y Tal Einat.

### PEP 486: Hacer que el launcher de Python sea consciente de los entornos virtuales

PEP 486 hace que el launcher de Windows (consultar PEP 397) sea consciente de un entorno virtual activo. Cuando se usa el intérprete predeterminado y se establece la variable de entorno `VIRTUAL_ENV` está configurado, se utilizará el intérprete en el entorno virtual.

Ver también

PEP 486 – Hacer que el launcher de Python sea consciente de los entornos virtuales

  PEP escrito e implementado por Paul Moore.

### PEP 488: Eliminación de archivos PYO

PEP 488 elimina el concepto de archivos `.pyo`. Esto significa que los archivos `.pyc` representan tanto bytecode optimizado y sin optimizar. Para evitar la necesidad de regenerar constantemente archivos bytecode, ahora los archivos `.pyc` tienen una etiqueta opcional `opt-` en su nombre cuando se optimiza el bytecode. Esto tiene el efecto secundario de que no habrá más conflictos de nombres de archivos de bytecode cuando se ejecuta bajo `-O` o `-OO`. Por consiguiente, ahora los archivos bytecode generados a partir de `-O` y `-OO` pueden existir simultáneamente. `importlib.util.cache_from_source()` tiene una API actualizada para ayudar con este cambio.

Ver también

PEP 488 – Eliminación de archivos PYO

  PEP escrito e implementado por Brett Cannon.

### PEP 489: Inicialización del módulo de extensión multifase

PEP 489 actualiza la inicialización del módulo de extensión para aprovechar el mecanismo de carga del módulo de dos pasos introducido por PEP 451 en Python 3.4.

Este cambio acerca la semántica de importación de los módulos de extensión que optan por usar el mecanismo nuevo a la de los módulos fuente y de bytecode de Python, incluida la capacidad de utilizar cualquier identificador válido como un nombre de módulo, en lugar de estar restringido a ASCII.

Ver también

PEP 489 – Inicialización del módulo de extensión multifase

  PEP escrito por Petr Viktorin, Stefan Behnel y Nick Coghlan; implementado por Petr Viktorin.

## Otros cambios en el lenguaje

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

- Se agregaron los gestores de error `"namereplace"`. Ahora los gestores de error `"backslashreplace"` funcionan con decodificación y traducción. (Contribución de Serhiy Storchaka en bpo-19676 y bpo-22286.)

- Ahora la opción `-b` afecta comparaciones de `bytes` con `int`. (Contribución de Serhiy Storchaka en bpo-23681.)

- Nuevos códecs Kazakh `kz1048` y Tajik `koi8_t`. (Contribución de Serhiy Storchaka en bpo-22682 y bpo-22681.)

- Ahora las docstrings de propiedad se pueden escribir. Esto es especialmente útil para las docstrings `collections.namedtuple()`. (Contribución de Berker Peksag en bpo-24064.)

- Ahora se admiten las importaciones circulares que involucran importaciones relativas. (Contribución de Brett Cannon y Antoine Pitrou en bpo-17636.)

## Nuevos módulos

### typing

El módulo nuevo provisional `typing` proporciona definiciones y herramientas estándar para anotaciones de tipos de funciones. Consultar Indicador de tipos para más información.

### zipapp

El módulo nuevo `zipapp` (especificado en PEP 441) proporciona una API y una herramienta de línea de comandos para crear aplicaciones Python Zip ejecutables, las cuales se introdujeron en la versión de Python 2.6 en bpo-1739468, pero no se publicitaron bien, ni en ese momento ni desde entonces.

Con el módulo nuevo, empaquetar tu aplicación es tan simple como colocar todos los archivos, incluido un archivo `__main__.py` en un directorio `myapp` y ejecutar:

    $ python -m zipapp myapp
    $ python myapp.pyz

La implementación del módulo ha sido contribución de Paul Moore en bpo-23491.

Ver también

PEP 441 – Mejora de soporte de la aplicación Python ZIP

## Módulos mejorados

### argparse

Ahora la clase `ArgumentParser` permite deshabilitar el uso abreviado de opciones largas al establecer allow_abbrev en `False`. (Contribución de Jonathan Paugh, Steven Bethard, paul j3 y Daniel Eriksson en bpo-14910.)

### asyncio

Ya que el módulo `asyncio` es provisional, todos los cambios que se introdujeron en Python 3.5 también se han actualizado en Python 3.4.x.

Cambios notables en el módulo `asyncio` desde Python 3.4.0:

- Nuevas API de depuración: métodos `loop.set_debug()` y `loop.get_debug()`. (Contribución de Victor Stinner.)

- Ahora el ciclo de eventos proactor es compatible con SSL. (Contribución de Antoine Pitrou y Victor Stinner en bpo-22560.)

- Un nuevo método `loop.is_closed()` para comprobar si el ciclo de eventos está cerrado. (Contribución de Victor Stinner en bpo-21326.)

- Un nuevo método `loop.create_task()` para crear y programar convenientemente una nueva clase `Task` para una corrutina. El método `create_task` también se usa para todas las funciones asyncio que contengan corrutinas en tareas, tales como `asyncio.wait()`, `asyncio.gather()`, etc. (Contribución de Victor Stinner.)

- Un nuevo método `transport.get_write_buffer_limits()` para consultar los límites high- (superior) y low- (inferior) del control de flujo. (Contribución de Victor Stinner.)

- La función `async()` está obsoleta en favor de la función `ensure_future()`. (Contribución de Yury Selivanov.)

- Nuevos métodos `loop.set_task_factory()` y `loop.get_task_factory()` para personalizar la fábrica de tareas que el método `loop.create_task()` usa. (Contribución de Yury Selivanov.)

- Nuevos métodos de cola `Queue.join()` y `Queue.task_done()`. (Contribución de Victor Stinner.)

- Se eliminó la clase `JoinableQueue`, en favor de la clase `asyncio.Queue`. (Contribución de Victor Stinner.)

Actualizaciones en 3.5.1:

- La función `ensure_future()` y todas las funciones que la utilizan, como el método `loop.run_until_complete()`, ahora acepta todo tipo de objetos aguardables. (Contribución de 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 se está cerrando o ya está cerrado. (Contribución de Yury Selivanov.)

- Ahora el método `loop.create_server()` puede aceptar una lista de hosts. (Contribución de Yann Sionneau.)

Actualizaciones en 3.5.2:

- Nuevo método `loop.create_future()` para crear objetos Future. Esto permite implementaciones alternativas de bucles de eventos, como uvloop, para proporcionar una implementación más rápida de `asyncio.Future`. (Contribución de Yury Selivanov.)

- Nuevo método `loop.get_exception_handler()` para obtener el gestor de excepciones actual. (Contribución de Yury Selivanov.)

- Nuevo método `StreamReader.readuntil()` para leer datos de la secuencia hasta que aparezca una secuencia de separador de bytes. (Contribución de Mark Korenberg.)

- Se optimizaron los métodos `loop.create_connection()` y `loop.create_server()` para evitar llamar al sistema la función `getaddrinfo` si la dirección ya está resuelta. (Contribución de A. Jesse Jiryu Davis.)

- El método `loop.sock_connect(sock, address)` ya no requiere address para que se resuelva antes de la llamada. (Contribución de A. Jesse Jiryu Davis.)

### bz2

Ahora el método `BZ2Decompressor.decompress` acepta un argumento opcional max_length para limitar el tamaño máximo de datos descomprimidos. (Contribución de Nikolaus Rath en bpo-15955.)

### cgi

Ahora la clase `FieldStorage` admite el protocolo context manager. (Contribución de Berker Peksag en bpo-20289.)

### cmath

Una nueva función `isclose()` proporciona una forma de probar la igualdad aproximada. (Contribución de Chris Barker y Tal Einat en bpo-24270.)

### code

Ahora el método `InteractiveInterpreter.showtraceback()` imprime el rastreo encadenado completo, al igual que el interprete interactivo. (Contribución de Claudiu Popa en bpo-17442.)

### collections

Ahora la clase `OrderedDict` está implementada en C, lo que la hace de 4 a 100 veces más rápida. (Contribución de Eric Snow en bpo-16991.)

`OrderedDict.items()`, `OrderedDict.keys()`, `OrderedDict.values()` ahora soportan la iteración `reversed()`. (Contribución de Serhiy Storchaka en bpo-19505.)

Ahora la clase `deque` define `index()`, `insert()` y `copy()`, y soporta los operadores `+` y `*`. Esto permite que las deques sean reconocidas como `MutableSequence` y mejora su sustituibilidad por listas. (Contribución de Raymond Hettinger en bpo-23704.)

Ahora las docstrings producidas por `namedtuple()` se pueden actualizar:

    Point = namedtuple('Point', ['x', 'y'])
    Point.__doc__ += ': Cartesian coordinate'
    Point.x.__doc__ = 'abscissa'
    Point.y.__doc__ = 'ordinate'

(Contribución de Berker Peksag en bpo-24064.)

Ahora la clase `UserString` implementa los métodos `__getnewargs__()`, `__rmod__()`, `casefold()`, `format_map()`, `isprintable()` y `maketrans()` para que coincidan con los métodos correspondientes de `str`. (Contribución de Joe Jevnik en bpo-22189.)

### collections.abc

Ahora el método `Sequence.index()` acepta los argumentos start y stop para que coincidan con los métodos correspondientes de `tuple`, `list`, etc. (Contribución de Devin Jeanpierre en bpo-23086.)

Una nueva clase de base abstracta `Generator`. (Contribución de Stefan Behnel en bpo-24018.)

Nuevas clases de base abstracta `Awaitable`, `Coroutine`, `AsyncIterator` y `AsyncIterable`. (Contribución de Yury Selivanov en bpo-24184.)

Para versiones anteriores de Python, un backport del nuevo ABC está disponible en un paquete PyPI externo.

### compileall

Una nueva opción `compileall`, `-j N`, permite ejecutar N workers simultáneamente para realizar la compilación de bytecode en paralelo. La función `compile_dir()` tiene un parámetro `workers` correspondiente. (Contribución de Claudiu Popa en bpo-16104.)

Otra nueva opción, `-r`, permite controlar el nivel máximo de recursividad de los subdirectorios. (Contribución de Claudiu Popa en bpo-19628.)

Ahora la opción de línea de comando `-q` se puede especificar más de una vez, en cuyo caso todas las salidas, incluyendo errores, se suprimirán. Ahora el parámetro `quiet` correspondiente en `compile_dir()`, `compile_file()` y `compile_path()` puede aceptar un valor entero que indica el nivel de supresión de salida. (Contribución de Thomas Kluyver en bpo-21338.)

### concurrent.futures

Ahora el método `Executor.map()` acepta un argumento chunksize para permitir el procesamiento por lotes de tareas para mejorar el desempeño cuando se usa `ProcessPoolExecutor()`. (Contribución de Dan O’Reilly en bpo-11271.)

Ahora el número de workers en el constructor `ThreadPoolExecutor` es opcional. El valor predeterminado es 5 veces el número de CPUs. (Contribución de Claudiu Popa en bpo-21527.)

### configparser

Ahora `configparser` proporciona una forma de personalizar la conversión de valores al especificar un diccionario de convertidores en el constructor `ConfigParser` o al definirlos como métodos en las subclases `ConfigParser`. Los convertidores definidos en una instancia de analizador se heredan por sus proxies de sección.

Ejemplo:

    >>> import configparser
    >>> conv = {}
    >>> conv['list'] = lambda v: [e.strip() for e in v.split() if e.strip()]
    >>> cfg = configparser.ConfigParser(converters=conv)
    >>> cfg.read_string("""
    ... [s]
    ... list = a b c d e f g
    ... """)
    >>> cfg.get('s', 'list')
    'a b c d e f g'
    >>> cfg.getlist('s', 'list')
    ['a', 'b', 'c', 'd', 'e', 'f', 'g']
    >>> section = cfg['s']
    >>> section.getlist('list')
    ['a', 'b', 'c', 'd', 'e', 'f', 'g']

(Contribución de Łukasz Langa en bpo-18159.)

### contextlib

El nuevo context manager `redirect_stderr()` (similar a `redirect_stdout()`) facilita que los scripts de utilidad manejen APIs inflexibles que escriben su salida a `sys.stderr` y no proporcionen ninguna opción para redirigirlo:

    >>> import contextlib, io, logging
    >>> f = io.StringIO()
    >>> with contextlib.redirect_stderr(f):
    ...     logging.warning('warning')
    ...
    >>> f.getvalue()
    'WARNING:root:warning\n'

(Contribución de Berker Peksag en bpo-22389.)

### csv

Ahora el método `writerow()` admite iterables arbitrarios, no sólo secuencias. (Contribución de Serhiy Storchaka en bpo-23171.)

### curses

The new `update_lines_cols()` function updates the `LINES` and `COLS` module variables. This is useful for detecting manual screen resizing. (Contributed by Arnon Yaari in bpo-4254.)

### dbm

`dumb.open` siempre crea una nueva base de datos cuando la bandera tiene el valor `"n"`. (Contribución de Claudiu Popa en bpo-18039.)

### difflib

Ahora el juego de caracteres de los documentos HTML generado por `HtmlDiff.make_file()` se puede personalizar usando un nuevo argumento de solo palabras clave charset. El juego de caracteres predeterminado del documento HTML cambió de `"ISO-8859-1"` a `"utf-8"`. (Contribución de Berker Peksag en bpo-2052.)

Ahora la función `diff_bytes()` puede comparar listas de bytes de cadenas de caracteres. Esto arregla una regresión de Python 2. (Contribución de Terry J. Reedy y Greg Ward en bpo-17445.)

### distutils

Ahora los comandos `build` y `build_ext` aceptan una opción `-j` para habilitar la construcción paralela de módulos de extensión. (Contribución de Antoine Pitrou en bpo-5309.)

Ahora el módulo `distutils` admite la compresión `xz` y se puede habilitar pasando `xztar` como un argumento a `bdist --format`. (Contribución de Serhiy Storchaka en bpo-16314.)

### doctest

La función `DocTestSuite()` retorna una clase `unittest.TestSuite` vacía si module no contiene docstrings, en lugar de lanzar `ValueError`. (Contribución de Glenn Jones en bpo-15916.)

### email

Una nueva opción de directiva `Policy.mangle_from_` controla si las líneas que empiecen o no con `"From "` en los cuerpos del correo electrónico tienen el prefijo de un caracter `">"` por generadores. El valor predeterminado es `True` para `compat32` y `False` para todas las demás directivas. (Contribución de Milan Oberkirch en bpo-20098.)

Un nuevo método `Message.get_content_disposition()` proporciona fácil acceso a un valor canónico para el encabezado Content-Disposition. (Contribución de Abhilash Raj en bpo-21083.)

Una nueva opción de directiva `EmailPolicy.utf8` se puede configurar en `True` para codificar los encabezados de correo electrónico usando el juego de caracteres UTF-8 en lugar de utilizar palabras codificadas. Esto permite formatear `Messages` de acuerdo a RFC 6532 y usarlos con un servidor SMTP que admita la extensión RFC 6531 `SMTPUTF8`. (Contribución de R. David Murray en bpo-24211.)

Ahora el constructor `mime.text.MIMEText` admite una instancia de `charset.Charset`. (Contribución de Claude Paroz y Berker Peksag en bpo-16324.)

### enum

La clase invocable `Enum` tiene un nuevo parámetro start para especificar el número inicial de los valores de enumeración si solo se proporcionan names:

    >>> Animal = enum.Enum('Animal', 'cat dog', start=10)
    >>> Animal.cat
    <Animal.cat: 10>
    >>> Animal.dog
    <Animal.dog: 11>

(Contribución de Ethan Furman en bpo-21706.)

### faulthandler

Ahora las funciones `enable()`, `register()`, `dump_traceback()` y `dump_traceback_later()` aceptan descriptores de archivo además de objetos similares a archivos. (Contribución de Wei Wu en bpo-23566.)

### functools

Ahora la mayoría de la maquinaria de `lru_cache()` se implementa en C, lo que la hace significativamente más rápida. (Contribución de Matt Joiner, Alexey Kachayev y Serhiy Storchaka en bpo-14373.)

### glob

Ahora las funciones `iglob()` y `glob()` admiten búsquedas recursivas en subdirectorios usando el patrón `"**"`. (Contribución de Serhiy Storchaka en bpo-13968.)

### gzip

Ahora el argumento mode del constructor de `GzipFile` acepta `"x"` para solicitar la creación exclusiva. (Contribución de Tim Heaney en bpo-19222.)

### heapq

Ahora la comparación de elementos en `merge()` se puede personalizar pasando una key function en un nuevo argumento de palabra clave opcional key, y un nuevo argumento de palabra clave opcional reverse se puede usar para revertir la comparación de elementos:

    >>> import heapq
    >>> a = ['9', '777', '55555']
    >>> b = ['88', '6666']
    >>> list(heapq.merge(a, b, key=len))
    ['9', '88', '777', '6666', '55555']
    >>> list(heapq.merge(reversed(a), reversed(b), key=len, reverse=True))
    ['55555', '6666', '777', '88', '9']

(Contribución de Raymond Hettinger en bpo-13742.)

### http

Una nueva enumeración `HTTPStatus` que define un conjunto de códigos de estado HTTP, frases de motivo y descripciones largas escritas en inglés. (Contribución de Demian Brecht en bpo-21793.)

### http.client

Ahora `HTTPConnection.getresponse()` lanza una excepción `RemoteDisconnected` cuando una conexión de servidor remoto se cierra inesperadamente. Además, si se lanza una excepción `ConnectionError` (del cual `RemoteDisconnected` es una subclase), ahora el socket del cliente se cierra automáticamente y se reconectará en la siguiente solicitud:

    import http.client
    conn = http.client.HTTPConnection('www.python.org')
    for retries in range(3):
        try:
            conn.request('GET', '/')
            resp = conn.getresponse()
        except http.client.RemoteDisconnected:
            pass

(Contribución de Martin Panter en bpo-3566.)

### idlelib e IDLE

Desde que idlelib implementa el shell y el editor IDLE y no se destina para ser importado por otros programas, obtiene mejoras con cada versión. Consultar `Lib/idlelib/NEWS.txt` para una lista acumulativa de cambios desde la 3.4.0, así como los cambios realizados en futuras versiones 3.5.x. Este archivo también está disponible en IDLE Help ‣ About IDLE.

### imaplib

Ahora la clase `IMAP4` admite el protocolo context manager. Cuando se utiliza en una declaración `with`, el comando IMAP4 `LOGOUT` se llamará automáticamente al final del bloque. (Contribución de Tarek Ziadé y Serhiy Storchaka en bpo-4972.)

Ahora el módulo `imaplib` admite RFC 5161 (extensión ENABLE) y RFC 6855 (soporte UTF-8) a través del método `IMAP4.enable()`. Un nuevo atributo `IMAP4.utf8_enabled` rastrea si el soporte con RFC 6855 está habilitado o no. (Contribución de Milan Oberkirch, R. David Murray y Maciej Szulik en bpo-21800.)

Ahora el módulo `imaplib` codifica automáticamente nombres de usuario y contraseñas de cadenas de caracteres no ASCII usando UTF-8, como recomiendan las RFCs. (Contribución de Milan Oberkirch en bpo-21800.)

### imghdr

La función `what()` ahora reconoce el formato OpenEXR (aportado por Martin Vignali y Claudiu Popa en bpo-20295) y el formato WebP (aportado por Fabrice Aneche y Claudiu Popa en bpo-20197).

### importlib

La clase `util.LazyLoader` permite la carga lenta de módulos en aplicaciones donde el tiempo de inicio es importante. (Contribución de Brett Cannon en bpo-17621.)

Ahora el método es `abc.InspectLoader.source_to_code()` es un método estático. Esto hace más fácil la inicialización de un objeto de módulo con código compilado a partir de una cadena de caracteres ejecutando `exec(code, module.__dict__)`. (Contribución de Brett Cannon en bpo-21156.)

Ahora la nueva función `util.module_from_spec()` es la forma preferida para crear un nuevo módulo. A diferencia de crear directamente una instancia `types.ModuleType`, esta nueva función configurará varios atributos controlados por importación basados en el objeto de especificación pasado. (Contribución de Brett Cannon en bpo-20383.)

### inspect

Ahora las clases `Signature` y `Parameter` se pueden seleccionar y manipular. (Contribución de Yury Selivanov en bpo-20726 y bpo-20334.)

Un nuevo método `BoundArguments.apply_defaults()` proporciona una forma de establecer valores predeterminados para los argumentos faltantes:

    >>> def foo(a, b='ham', *args): pass
    >>> ba = inspect.signature(foo).bind('spam')
    >>> ba.apply_defaults()
    >>> ba.arguments
    OrderedDict([('a', 'spam'), ('b', 'ham'), ('args', ())])

(Contribución de Yury Selivanov en bpo-24190.)

Un nuevo método de clase `Signature.from_callable()` facilita la subclasificación de `Signature`. (Contribución de Yury Selivanov y Eric Snow en bpo-17373.)

Ahora la función `signature()` acepta un argumento de palabra clave opcional follow_wrapped, el cual, cuando se establece en `False`, deshabilita el seguimiento automático de enlaces `__wrapped__`. (Contribución de Yury Selivanov en bpo-20691.)

Se ha agregado un conjunto de nuevas funciones para inspeccionar funciones corrutina y objetos corrutina: `iscoroutine()`, `iscoroutinefunction()`, `isawaitable()`, `getcoroutinelocals()` y `getcoroutinestate()`. (Contribución de Yury Selivanov en bpo-24017 y bpo-24400.)

Ahora las funciones `stack()`, `trace()`, `getouterframes()` y `getinnerframes()` retornan una lista de tuplas con nombre. (Contribución de Daniel Shahaf en bpo-16808.)

### io

Un nuevo método `BufferedIOBase.readinto1()`, que usa como mucho una llamada al flujo sin procesar subyacente de los métodos `RawIOBase.read()` o `RawIOBase.readinto()`. (Contribución de Nikolaus Rath en bpo-20578.)

### ipaddress

Ahora las clases `IPv4Network` y `IPv6Network` aceptan un argumento de tupla `(address, netmask)`, para construir fácilmente objetos de red a partir de direcciones existentes:

    >>> import ipaddress
    >>> ipaddress.IPv4Network(('127.0.0.0', 8))
    IPv4Network('127.0.0.0/8')
    >>> ipaddress.IPv4Network(('127.0.0.0', '255.0.0.0'))
    IPv4Network('127.0.0.0/8')

(Contribución de Peter Moody y Antoine Pitrou en bpo-16531.)

Un nuevo atributo `reverse_pointer` para las clases `IPv4Network` y `IPv6Network` retorna el nombre del registro DNS PTR inverso:

    >>> import ipaddress
    >>> addr = ipaddress.IPv4Address('127.0.0.1')
    >>> addr.reverse_pointer
    '1.0.0.127.in-addr.arpa'
    >>> addr6 = ipaddress.IPv6Address('::1')
    >>> addr6.reverse_pointer
    '1.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.ip6.arpa'

(Contribución de Leon Weber en bpo-20480.)

### json

Ahora la interfaz de la línea de comandos `json.tool` conserva el orden de los nombres en los objetos JSON pasados en la entrada. La nueva opción `--sort-keys` se puede usar para ordenar los nombres alfabéticamente. (Contribución de Berker Peksag en bpo-21650.)

Ahora el decodificador JSON lanza `JSONDecodeError` en lugar de `ValueError` para proporcionar una mejor información de contexto sobre el error. (Contribución de Serhiy Storchaka en bpo-19361.)

### linecache

Una nueva función `lazycache()` se puede usar para capturar información sobre un módulo no basado en archivos para permitir obtener sus líneas más tarde a través de `getline()`. Esto evita hacer E/S hasta que una línea sea realmente necesaria, sin tener que llevar los módulos globales indefinidamente. (Contribución de Robert Collins en bpo-17911.)

### locale

Una nueva función `delocalize()` se puede usar para convertir una cadena de caracteres en una cadena numérica normalizada, teniendo la configuración `LC_NUMERIC` en cuenta:

    >>> import locale
    >>> locale.setlocale(locale.LC_NUMERIC, 'de_DE.UTF-8')
    'de_DE.UTF-8'
    >>> locale.delocalize('1.234,56')
    '1234.56'
    >>> locale.setlocale(locale.LC_NUMERIC, 'en_US.UTF-8')
    'en_US.UTF-8'
    >>> locale.delocalize('1,234.56')
    '1234.56'

(Contribución de Cédric Krier en bpo-13918.)

### logging

Ahora todos los métodos del módulo logging (`Logger` `log()`, `exception()`, `critical()`, `debug()`, etc.), aceptan instancias de excepción como un argumento exc_info, además de valores booleanos y tuplas de excepción:

    >>> import logging
    >>> try:
    ...     1/0
    ... except ZeroDivisionError as ex:
    ...     logging.error('exception', exc_info=ex)
    ERROR:root:exception

(Contribución de Yury Selivanov en bpo-20537.)

Ahora la clase `handlers.HTTPHandler` acepta una instancia opcional `ssl.SSLContext` para establecer la configuración SSL usada en una conexión HTTP. (Contribución de Alex Gaynor en bpo-22788.)

Ahora la clase `handlers.QueueListener` toma un argumento de palabra clave respect_handler_level, el cual, si se establece en `True`, pasará mensajes a gestores teniendo en cuenta los gestores de niveles. (Contribución de Vinay Sajip.)

### lzma

Ahora el método `LZMADecompressor.decompress()` acepta un argumento opcional max_length para limitar el tamaño máximo de datos descomprimidos. (Contribución de Martin Panter en bpo-15955.)

### math

Se agregaron dos nuevas contantes en el módulo `math`: `inf` y `nan`. (Contribución de Mark Dickinson en bpo-23185.)

Una nueva función `isclose()` proporciona una forma de comprobar la igualdad aproximada. (Contribución de Chris Barker y Tal Einat en bpo-24270.)

Se agregó una nueva función `gcd()`. Ahora la función `fractions.gcd()` está obsoleta. (Contribución de Mark Dickinson y Serhiy Storchaka en bpo-22486.)

### multiprocessing

Ahora los objetos `sharedctypes.synchronized()` admiten el protocolo context manager. (Contribución de Charles-François Natali en bpo-21565.)

### operator

Ahora los objetos `attrgetter()`, `itemgetter()` y `methodcaller()` admiten pickling. (Contribución de Josh Rosenberg y Serhiy Storchaka en bpo-22955.)

Las nuevas funciones `matmul()` y `imatmul()` para realizar multiplicación de matrices. (Contribución de Benjamin Peterson en bpo-21176.)

### os

Se agregó la nueva función `scandir()` que retorna un iterador de `DirEntry`. Si es posible, `scandir()` extrae los atributos del archivo mientras escanea un directorio, eliminando la necesidad de realizar llamadas posteriores al sistema para determinar el tipo de archivo o los atributos, lo que puede mejorar significativamente el rendimiento. (Contribución de Ben Hoyt con la ayuda de Victor Stinner en bpo-22524.)

En Windows, ahora un nuevo atributo `stat_result.st_file_attributes` está disponible. Corresponde al miembro `dwFileAttributes` de la estructura `BY_HANDLE_FILE_INFORMATION` retornado por `GetFileInformationByHandle()`. (Contribución de Ben Hoyt en bpo-21719.)

Ahora la función `urandom()` usa la llamada al sistema `getrandom()` en Linux 3.17 o versiones más recientes, y `getentropy()` en OpenBSD 5.6 y versiones más recientes, eliminando la necesidad de utilizar `/dev/urandom` y evitando fallas debido al posible agotamiento del descriptor de archivo. (Contribución de Victor Stinner en bpo-22181.)

New `get_blocking()` and `set_blocking()` functions allow getting and setting a file descriptor’s blocking mode (`O_NONBLOCK`.) (Contributed by Victor Stinner in bpo-22054.)

Ahora las funciones `truncate()` y `ftruncate()` se admiten en Windows. (Contribución de Steve Dower en bpo-23668.)

Hay una nueva función `os.path.commonpath()` que retorna la sub-ruta común más larga de cada nombre de ruta pasado. A diferencia de la función `os.path.commonprefix()`, siempre retorna una ruta válida:

    >>> os.path.commonprefix(['/usr/lib', '/usr/local/lib'])
    '/usr/l'

    >>> os.path.commonpath(['/usr/lib', '/usr/local/lib'])
    '/usr'

(Contribución de Rafik Draoui y Serhiy Storchaka en bpo-10395.)

### pathlib

El nuevo método `Path.samefile()` se puede usar para verificar si la ruta apunta al mismo archivo que otra ruta, el cual puede ser otro objeto `Path` o una cadena de caracteres:

    >>> import pathlib
    >>> p1 = pathlib.Path('/etc/hosts')
    >>> p2 = pathlib.Path('/etc/../etc/hosts')
    >>> p1.samefile(p2)
    True

(Contribución de Vajrasky Kok y Antoine Pitrou en bpo-19775.)

Ahora el método `Path.mkdir()` acepta un nuevo argumento opcional exist_ok para que coincida con la funcionalidad `mkdir -p` y `os.makedirs()`. (Contribución de Berker Peksag en bpo-21539.)

Hay un nuevo método `Path.expanduser()` para expandir los prefijos `~` y `~user`. (Contribución de Serhiy Storchaka y Claudiu Popa en bpo-19776.)

Una nueva clase de método `Path.home()` se puede usar para obtener una instancia `Path` que representa el directorio de inicio del usuario. (Contribución de Victor Salgado y Mayank Tripathi en bpo-19777.)

Los nuevos métodos `Path.write_text()`, `Path.read_text()`, `Path.write_bytes()`, `Path.read_bytes()` para simplificar la lectura/escritura de operaciones en los archivos.

El siguiente fragmento de código creará o reescribirá el archivo existente `~/spam42`:

    >>> import pathlib
    >>> p = pathlib.Path('~/spam42')
    >>> p.expanduser().write_text('ham')
    3

(Contribución de Christopher Welborn en bpo-20218.)

### pickle

Ahora los objetos anidados, como los métodos independientes o las clases anidadas, se pueden serializar con pickle usando protocolos pickle anteriores al protocolo de la versión 4. El protocolo de la versión 4 ya admite estos casos. (Contribución de Serhiy Storchaka en bpo-23611.)

### poplib

Un nuevo comando `POP3.utf8()` habilita el soporte (correo electrónico internacionalizado) RFC 6856, si un servidor POP lo admite. (Contribución de Milan Oberkirch en bpo-21804.)

### re

Ahora las referencias y referencias condicionales a grupos con longitud fija se permiten en afirmaciones retrospectivas:

    >>> import re
    >>> pat = re.compile(r'(a|b).(?<=\1)c')
    >>> pat.match('aac')
    <_sre.SRE_Match object; span=(0, 3), match='aac'>
    >>> pat.match('bbc')
    <_sre.SRE_Match object; span=(0, 3), match='bbc'>

(Contribución de Serhiy Storchaka en bpo-9179.)

El número de captura de grupos en expresiones regulares ya no se limita a 100. (Contribución de Serhiy Storchaka en bpo-22437.)

Ahora las funciones `sub()` y `subn()` reemplazan grupos que no coinciden con cadenas de caracteres vacías en lugar de lanzar una excepción. (Contribución de Serhiy Storchaka en bpo-1519638.)

Las excepciones `re.error` tienen nuevos atributos, `msg`, `pattern`, `pos`, `lineno` y `colno`, que proporcionan una mejor información de contexto sobre el error:

    >>> re.compile("""
    ...     (?x)
    ...     .++
    ... """)
    Traceback (most recent call last):
       ...
    sre_constants.error: multiple repeat at position 16 (line 3, column 7)

(Contribución de Serhiy Storchaka en bpo-22578.)

### readline

Una nueva función `append_history_file()` se puede usar para adjuntar el número especificado de los elementos finales en el historial al archivo dado. (Contribución de Bruno Cauet en bpo-22940.)

### selectors

La nueva clase `DevpollSelector` admite sondeos eficientes `/dev/poll` en Solaris. (Contribución de Giampaolo Rodola” en bpo-18931.)

### shutil

Ahora la función `move()` acepta un argumento copy_function, permitiendo, por ejemplo, que se use la función `copy()` en lugar de la predeterminada `copy2()` si es necesario ignorar metadatos de archivo al moverlo. (Contribución de Claudiu Popa en bpo-19840.)

Ahora la función `make_archive()` admite el formato xztar. (Contribución de Serhiy Storchaka en bpo-5411.)

### signal

En Windows, ahora la función `set_wakeup_fd()` también admite identificadores de socket. (Contribución de Victor Stinner en bpo-22018.)

Varias constantes `SIG*` en el módulo `signal` se convirtieron en `Enums`. Esto permite que los nombres significativos se impriman durante la depuración en lugar de «números mágicos» enteros. (Contribución de Giampaolo Rodola” en bpo-21076.)

### smtpd

Ahora las clases `SMTPServer` y `SMTPChannel` aceptan un argumento de palabra clave decode_data para determinar si la porción `DATA` de la transacción SMTP se decodifica usando el códec `"utf-8"` o en su lugar se proporciona al método `SMTPServer.process_message()` como un byte de cadena de caracteres. El valor predeterminado es `True` por razones de compatibilidad con versiones anteriores, pero se cambiará a `False` en Python 3.6. Si decode_data se establece en `False`, el método `process_message` se debe preparar para aceptar argumentos de palabra clave. (Contribución de Maciej Szulik en bpo-19662.)

Ahora la clase `SMTPServer` anuncia la extensión `8BITMIME` (RFC 6152) si decode_data se establece como `True`. Si el cliente especifica `BODY=8BITMIME` en el comando `MAIL`, se pasa al método `SMTPServer.process_message()` a través de la palabra clave mail_options. (Contribución de Milan Oberkirch y R. David Murray en bpo-21795.)

Ahora la clase `SMTPServer` también admite la extensión `SMTPUTF8` (RFC 6531: correo electrónico internacionalizado). Si el cliente especificó `SMTPUTF8 BODY=8BITMIME` en el comando `MAIL`, se pasan al método `SMTPServer.process_message()` a través de la palabra clave mail_options. Es responsabilidad del método `process_message` manejar correctamente los datos `SMTPUTF8`. (Contribución de Milan Oberkirch en bpo-21725.)

Ahora es posible proporcionar, directamente o mediante resolución de nombres, direcciones IPv6 en el constructor `SMTPServer`, y hacer que se conecte correctamente. (Contribución de Milan Oberkirch en bpo-14758.)

### smtplib

Un nuevo método `SMTP.auth()` proporciona una forma conveniente de implementar mecanismos de autenticación personalizados. (Contribución de Milan Oberkirch en bpo-15014.)

Ahora el método `SMTP.set_debuglevel()` acepta un nivel de depuración adicional (2), el cual habilita las marcas de tiempo en los mensajes de depuración. (Contribución de Gavin Chappell y Maciej Szulik en bpo-16914.)

Ahora los métodos `SMTP.sendmail()` y `SMTP.send_message()` admiten RFC 6531 (SMTPUTF8). (Contribución de Milan Oberkirch y R. David Murray en bpo-22027.)

### sndhdr

Ahora las funciones `what()` y `whathdr()` retornan una `namedtuple()`. (Contribución de Claudiu Popa en bpo-18615.)

### socket

Ahora las funciones con tiempo de espera usan un reloj monótono en lugar de un reloj del sistema. (Contribución de Victor Stinner en bpo-22043.)

Un nuevo método `socket.sendfile()` permite enviar un archivo a través de un socket usando la función de alto rendimiento `os.sendfile()` en UNIX, lo que hace que las cargas sean de 2 a 3 veces más rápido que cuando se usa el método simple `socket.send()`. (Contribución de Giampaolo Rodola” en bpo-17552.)

El método `socket.sendall()` ya no reinicia el tiempo de espera del socket cada vez que se reciben o se envían bytes. Ahora el tiempo de espera del socket es la duración total máxima para enviar todos los datos. (Contribución de Victor Stinner en bpo-23853.)

Ahora el argumento backlog del método `socket.listen()` es opcional. De forma predeterminada, se establece en `SOMAXCONN` o en `128`, lo que sea menor. (Contribución de Charles-François Natali en bpo-21455.)

### ssl

#### Soporte de memoria BIO

(Contribución de Geert Jansen en bpo-21965.)

Se ha agregado la nueva clase `SSLObject` para proporcionar soporte del protocolo SSL para los casos en que las capacidades de E/S de red de `SSLSocket` no son necesarias o no son óptimas. `SSLObject` representa una instancia del protocolo SSL pero no implementa ningún método de E/S de red y, en su lugar, proporciona una interfaz de búfer de memoria. La nueva clase `MemoryBIO` se puede usar para pasar datos entre Python y una instancia del protocolo SSL.

El soporte de la memoria BIO SSL está destinado principalmente para ser usado en frameworks que implementan E/S asíncronas para las cuales el modelo de preparación («select/poll») de `SSLSocket` es ineficiente.

Un nuevo método `SSLContext.wrap_bio()` se puede usar para crear una nueva instancia `SSLObject`.

#### Soporte de negociación de protocolo de capa de aplicación

(Contribución de Benjamin Peterson en bpo-20188.)

Donde está presente el soporte de OpenSSL, ahora el módulo `ssl` implementa la extensión TLS Application-Layer Protocol Negotiation como se describe en RFC 7301.

El nuevo método `SSLContext.set_alpn_protocols()` se puede usar para especificar qué protocolos deben anunciar un socket durante el protocolo de enlace TLS.

The new `SSLSocket.selected_alpn_protocol()` returns the protocol that was selected during the TLS handshake. The `HAS_ALPN` flag indicates whether ALPN support is present.

#### Otros cambios

Hay un nuevo método `SSLSocket.version()` para consultar la versión actual del protocolo en uso. (Contribución de Antoine Pitrou en bpo-20421.)

Ahora la clase `SSLSocket` implementa un método `SSLSocket.sendfile()`. (Contribución de Giampaolo Rodola” en bpo-17552.)

Ahora el método `SSLSocket.send()` lanza la excepción `ssl.SSLWantReadError` o `ssl.SSLWantWriteError` en un socket sin bloqueo si la operación se bloquearía. Anteriormente, retornaría `0`. (Contribución de Nikolaus Rath en bpo-20951.)

Ahora la función `cert_time_to_seconds()` interpreta la hora de entrada como UTC y no como hora local, por RFC 5280. Además, el valor de retorno siempre es un `int`. (Contribución de Akira Li en bpo-19940.)

Los nuevos métodos `SSLObject.shared_ciphers()` y `SSLSocket.shared_ciphers()` retornan la lista de cifrados enviados por el cliente durante el protocolo de enlace. (Contribución de Benjamin Peterson en bpo-23186.)

Los métodos `SSLSocket.do_handshake()`, `SSLSocket.read()`, `SSLSocket.shutdown()` y `SSLSocket.write()` de la clase `SSLSocket` ya no reinician el tiempo de espera del socket cada vez que se reciben o se envían bytes. Ahora el tiempo de espera del socket es la duración total máxima del método. (Contribución de Victor Stinner en bpo-23853.)

Ahora la función `match_hostname()` admite la coincidencia de direcciones IP. (Contribución de Antoine Pitrou en bpo-23239.)

### sqlite3

Ahora la clase `Row` admite totalmente el protocolo de secuencia, en particular la iteración `reversed()` y la indexación segmentada. (Contribución de Claudiu Popa en bpo-10203; de Lucas Sinclair, Jessica McKellar, y Serhiy Storchaka en bpo-13583.)

### subprocess

Se agregó la nueva función `run()`. Ejecuta el comando especificado y retorna un objeto `CompletedProcess`, el cual describe un proceso terminado. La nueva API es más consistente y es el enfoque recomendado para invocar subprocesos en código Python que no necesita mantener la compatibilidad con versiones anteriores de Python. (Contribución de Thomas Kluyver en bpo-23342.)

Ejemplos:

    >>> subprocess.run(["ls", "-l"])  # doesn't capture output
    CompletedProcess(args=['ls', '-l'], returncode=0)

    >>> subprocess.run("exit 1", shell=True, check=True)
    Traceback (most recent call last):
      ...
    subprocess.CalledProcessError: Command 'exit 1' returned non-zero exit status 1

    >>> subprocess.run(["ls", "-l", "/dev/null"], stdout=subprocess.PIPE)
    CompletedProcess(args=['ls', '-l', '/dev/null'], returncode=0,
    stdout=b'crw-rw-rw- 1 root root 1, 3 Jan 23 16:23 /dev/null\n')

### sys

Una nueva función `set_coroutine_wrapper()` permite configurar un enlace global que será llamado siempre que un objeto corrutina sea creado por una función `async def`. Una función correspondiente `get_coroutine_wrapper()` se puede usar para obtener un contenedor configurado actualmente. Ambas funciones son provisionales y se destinan solo para propósitos de depuración. (Contribución de Yury Selivanov en bpo-24017.)

Una nueva función `is_finalizing()` se puede usar para verificar si el intérprete de Python se está apagando. (Contribución de Antoine Pitrou en bpo-22696.)

### sysconfig

Ahora el nombre del directorio de los scripts del usuario en Windows incluye los dos primeros componentes de la versión de Python. (Contribución de Paul Moore en bpo-23437.)

### tarfile

Ahora el argumento mode de la función `open()` acepta `"x"` para solicitar una creación exclusiva. (Contribución de Berker Peksag en bpo-21717.)

Ahora los métodos `TarFile.extractall()` y `TarFile.extract()` toman un argumento de palabra clave numeric_owner. Si se establece como `True`, los archivos y directorios extraídos serán propiedad de los números `uid` y `gid` del archivo tar. Si se establece como `False` (el valor predeterminado y el comportamiento en versiones anteriores a la 3.5), serán propiedad del usuario y el grupo nombrados en el archivo tar. (Contribución de Michael Vogt y Eric Smith en bpo-23193.)

Ahora `TarFile.list()` acepta un argumento de palabra clave opcional members que se puede establecer en un subconjunto de la lista retornada por `TarFile.getmembers()`. (Contribución de Serhiy Storchaka en bpo-21549.)

### threading

Ahora los métodos `Lock.acquire()` y `RLock.acquire()` usan un reloj monótono para la administración del tiempo de espera. (Contribución de Victor Stinner en bpo-22043.)

### time

Ahora la función `monotonic()` siempre está disponible. (Contribución de Victor Stinner en bpo-22043.)

### timeit

Una nueva opción de línea de comando `-u` o `--unit=U` se puede usar para especificar la unidad de tiempo para la salida del temporizador. Las opciones que se admiten son `usec`, `msec` o `sec`. (Contribución de Julian Gindi en bpo-18983.)

La función `timeit()` tiene un nuevo parámetro globals para especificar el espacio de nombres donde el código se ejecutará. (Contribución de Ben Roberts en bpo-2527.)

### tkinter

El módulo `tkinter._fix` que se usaba para configurar el entorno Tcl/Tk en Windows se reemplazó por una función privada en el módulo `_tkinter` que no hace cambios permanentes en las variables de entorno. (Contribución de Zachary Ware en bpo-20035.)

### traceback

New `walk_stack()` and `walk_tb()` functions to conveniently traverse frame and traceback objects. (Contributed by Robert Collins in bpo-17911.)

Nuevas clases ligeras: `TracebackException`, `StackSummary` y `FrameSummary`. (Contribución de Robert Collins en bpo-17911.)

Ahora las funciones `print_tb()` y `print_stack()` admiten valores negativos para el argumento limit. (Contribución de Dmitry Kazakov en bpo-22619.)

### types

Una nueva función `coroutine()` para transformar un iterador generador y objetos `generator-like` en aguardables. (Contribución de Yury Selivanov en bpo-24017.)

Un nuevo tipo llamado `CoroutineType`, el cual se usa para objetos coroutine creados por funciones `async def`. (Contribución de Yury Selivanov en bpo-24400.)

### unicodedata

El módulo `unicodedata` ahora usa datos de Unicode 8.0.0.

### unittest

Ahora el método `TestLoader.loadTestsFromModule()` acepta un solo argumento de palabra clave pattern que se pasa a `load_tests` como el tercer argumento. Ahora los paquetes encontrados se verifican en busca de `load_tests` independientemente de si su ruta coincide con pattern, porque es imposible que el nombre de un paquete coincida con el modelo predeterminado. (Contribución de Robert Collins y Barry A. Warsaw en bpo-16662.)

Ahora los errores de descubrimiento de unittest se exponen en el atributo `TestLoader.errors` de la instancia `TestLoader`. (Contribución de Robert Collins en bpo-19746.)

Una nueva opción de línea de comando `--locals` muestra variables locales en rastreo. (Contribución de Robert Collins en bpo-22936.)

### unittest.mock

La clase `Mock` tiene las siguientes mejoras:

- El constructor de la clase tiene un nuevo parámetro unsafe, que hace que los objetos simulados lancen `AttributeError` en los nombres de atributo que comienzan con `"assert"`. (Contribución de Kushal Das en bpo-21238.)

- Un nuevo método `Mock.assert_not_called()` para verificar si se llamó el objeto simulado. (Contribución de Kushal Das en bpo-21262.)

Ahora la clase `MagicMock` admite los operadores `__truediv__()`, `__divmod__()` y `__matmul__()`. (Contribución de Johannes Baiter en bpo-20968 y de Håkan Lövdahl en bpo-23581 y bpo-23568.)

Ya no es necesario pasar explícitamente `create=True` a la función `patch()` cuando se parchean los nombres incorporados. (Contribución de Kushal Das en bpo-17660.)

### urllib

Una nueva clase `request.HTTPPasswordMgrWithPriorAuth` permite que se administren las credenciales de autenticación básica HTTP para eliminar el manejo innecesario de respuestas `401` o enviar credenciales incondicionalmente en la primera solicitud para comunicarse con los servidores que retornen una respuesta `404` en lugar de un `401` si el encabezado `Authorization` no se envía. (Contribución de Matej Cepl en bpo-19494 y de Akshit Khurana en bpo-7159.)

Un nuevo argumento quote_via para la función `parse.urlencode()` proporciona una forma de controlar la codificación de las partes de la consulta si es necesario. (Contribución de Samwyse y Arnon Yaari en bpo-13866.)

La función `request.urlopen()` acepta un objeto `ssl.SSLContext` como un argumento context, el cual se usará para la conexión HTTPS. (Contribución de Alex Gaynor en bpo-22366.)

Se actualizó `parse.urljoin()` para usar la semántica RFC 3986 para la resolución de URL relativas, en lugar de RFC 1808 y RFC 2396. (Contribución de Demian Brecht y Senthil Kumaran en bpo-22118.)

### wsgiref

Ahora el argumento headers del constructor de la clase `headers.Headers` es opcional. (Contribución de Pablo Torres Navarrete y SilentGhost en bpo-5800.)

### xmlrpc

Ahora la clase `client.ServerProxy` admite el protocolo context manager. (Contribución de Claudiu Popa en bpo-20627.)

Ahora el constructor de `client.ServerProxy` acepta una instancia opcional `ssl.SSLContext`. (Contribución de Alex Gaynor en bpo-22960.)

### xml.sax

Ahora los analizadores SAX admiten un flujo de caracteres del objeto `xmlreader.InputSource`. (Contribución de Serhiy Storchaka en bpo-2175.)

Ahora `parseString()` acepta una instancia `str`. (Contribución de Serhiy Storchaka en bpo-10590.)

### zipfile

Ahora la salida ZIP se puede escribir en flujos inescrutables. (Contribución de Serhiy Storchaka en bpo-23252.)

Ahora el argumento mode del método `ZipFile.open()` acepta `"x"` para solicitar una creación exclusiva. (Contribución de Serhiy Storchaka en bpo-21717.)

## Otros cambios a nivel de módulo

Ahora muchas funciones en los módulos `mmap`, `ossaudiodev`, `socket`, `ssl` y `codecs` aceptan objetos de tipo bytes que se pueden escribir. (Contribución de Serhiy Storchaka en bpo-23001.)

## Optimizaciones

La función `os.walk()` se aceleró de 3 a 5 veces en los sistemas POSIX y de 7 a 20 veces en Windows. Esto se hizo usando la nueva función `os.scandir()`, el cual expone la información del archivo de las llamadas al sistema `readdir` o `FindFirstFile`/`FindNextFile`. (Contribución de Ben Hoyt con ayuda de Victor Stinner en bpo-23605.)

La construcción de `bytes(int)` (llenado con cero bytes) es más rápida y usa menos memoria para objetos grandes. Se usa `calloc()` en lugar de `malloc()` para asignar memoria para estos objetos. (Contribución de Victor Stinner en bpo-21233.)

Algunas operaciones en `ipaddress` `IPv4Network` y `IPv6Network` se aceleraron masivamente, tal como `subnets()`, `supernet()`, `summarize_address_range()`, `collapse_addresses()`. La velocidad puede variar de 3 a 15 veces. (Contribución de Antoine Pitrou, Michel Albert y Markus en bpo-21486, bpo-21487, bpo-20826, bpo-23266.)

Se optimizó pickling de objetos `ipaddress` para producir una salida significativamente menor. (Contribución de Serhiy Storchaka en bpo-23133.)

Ahora muchas operaciones en `io.BytesIO` son de 50% a 100% más rápidas. (Contribución de Serhiy Storchaka en bpo-15381 y de David Wilson en bpo-22003.)

Ahora la función `marshal.dumps()` es más rápida: 65–85% en las versiones 3 y 4, 20–25% en las versiones 0 a 2 con datos típicos, y hasta 5 veces en el mejor de los casos. (Contribución de Serhiy Storchaka en bpo-20416 y bpo-23344.)

Ahora el codificador UTF-32 es de 3 a 7 veces más rápido. (Contribución de Serhiy Storchaka en bpo-15027.)

Ahora las expresiones regulares se analizan hasta un 10% más rápido. (Contribución de Serhiy Storchaka en bpo-19380.)

Se optimizó la función `json.dumps()` para ejecutarse con `ensure_ascii=False` tan rápido como con `ensure_ascii=True`. (Contribución de Naoki Inada en bpo-23206.)

Las funciones `PyObject_IsInstance()` y `PyObject_IsSubclass()` se aceleraron en el caso común de que el segundo argumento tenga `type` como su metaclase. (Contribución de Georg Brandl en bpo-22540.)

Se mejoró ligeramente el almacenamiento en caché del método, lo que arrojó una mejora del rendimiento de hasta un 5% en algunos puntos de referencia. (Contribución de Antoine Pitrou en bpo-22847.)

Ahora los objetos del módulo `random` usan un 50% menos de memoria en compilaciones de 64 bits. (Contribución de Serhiy Storchaka en bpo-23488.)

Las llamadas getter de `property()` son hasta un 25% más rápidas. (Contribución de Joe Jevnik en bpo-23910.)

Ahora la instanciación de `fractions.Fraction` es hasta un 30% más rápida. (Contribución de Stefan Behnel en bpo-22464.)

Ahora los métodos de cadena de caracteres `find()`, `rfind()`, `split()`, `partition()` y el operador `in` son significativamente más rápidos para buscar subcadenas de 1 carácter. (Contribución de Serhiy Storchaka en bpo-23573.)

## Cambios en la compilación y la API de C

Se agregaron las nuevas funciones `calloc`:

- `PyMem_RawCalloc()`,

- `PyMem_Calloc()`,

- `PyObject_Calloc()`.

(Contribución de Victor Stinner en bpo-21233.)

Nuevas funciones auxiliares de codificación/decodificación:

- `Py_DecodeLocale()` (reemplazó `_Py_char2wchar()`),

- `Py_EncodeLocale()` (reemplazó `_Py_wchar2char()`).

(Contribución de Victor Stinner en bpo-18395.)

Una nueva función `PyCodec_NameReplaceErrors()` para reemplazar el error de codificación unicode con `\N{...}` escapes. (Contribución de Serhiy Storchaka en bpo-19676.)

A new `PyErr_FormatV()` function similar to `PyErr_Format()`, but accepts a `va_list` argument. (Contributed by Antoine Pitrou in bpo-18711.)

Una nueva excepción `PyExc_RecursionError`. (Contribución de Georg Brandl en bpo-19235.)

Se introdujeron las nuevas funciones `PyModule_FromDefAndSpec()`, `PyModule_FromDefAndSpec2()` y `PyModule_ExecDef()` por PEP 489 – inicialización del módulo de extensión multifase. (Contribución de Petr Viktorin en bpo-24268.)

Nuevas funciones `PyNumber_MatrixMultiply()` y `PyNumber_InPlaceMatrixMultiply()` para realizar la multiplicación de matrices. (Contribución de Benjamin Peterson en bpo-21176. Consultar también PEP 465 para más detalles.)

Ahora el espacio `PyTypeObject.tp_finalize` es parte de la ABI estable.

Windows builds now require Microsoft Visual C++ 14.0, which is available as part of Visual Studio 2015.

Ahora los módulos de extensión incluyen una etiqueta de información de la plataforma en su nombre de archivo en algunas plataformas (la etiqueta es opcional y CPython importará las extensiones sin ella, aunque si la etiqueta está presente y no coincide, no se cargará la extensión):

- En Linux, los nombres de archivo del módulo de extensión termina con `.cpython-<major><minor>m-<architecture>-<os>.pyd`:

  - `<major>` es el número principal de la versión de Python; para Python 3.5 este es `3`.

  - `<minor>` es el número menor de la versión de Python; para Python 3.5 este es `5`.

  - `<architecture>` es la arquitectura de hardware para la que se construyó el módulo de extensión. Es más común `i386` para plataformas Intel de 32 bits o `x86_64` para plataformas Intel (y AMD) de 64 bits.

  - `<os>` siempre es `linux-gnu`, excepto para las extensiones que se crearon para comunicarse con la ABI de 32 bits en plataformas de 64 bits, en cuyo caso es `linux-gnu32` (y `<architecture>` será `x86_64`).

- En Windows, los nombres de archivo del módulo de extensión termina con `<debug>.cp<major><minor>-<platform>.pyd`:

  - `<major>` es el número principal de la versión de Python; para Python 3.5 este es `3`.

  - `<minor>` es el número menor de la versión de Python; para Python 3.5 este es `5`.

  - `<platform>` es la plataforma para la que se construyó el módulo de extensión, ya sea `win32` para Win32, `win_amd64` para Win64, `win_ia64` para Windows Itanium 64 y `win_arm` para Windows con ARM.

  - Si está integrado en el modo de depuración, `<debug>` será `_d`, de lo contrario estará en blanco.

- En plataformas OS X, ahora los nombres de archivo del módulo de extensión terminan con `-darwin.so`.

- En todas las demás plataformas, los nombres de archivo del módulo de extensión son los mismos que en Python 3.4.

## Obsoleto

### Nuevas palabras clave

No se recomienda usarse `async` y `await` como nombres de variable, clase, función o módulo. Se introdujo por PEP 492 en Python 3.5, se convertirán en palabras clave adecuadas en Python 3.7.

### Comportamiento obsoleto de Python

Al lanzar la excepción `StopIteration` dentro de un generador ahora se lanzará un `PendingDeprecationWarning` silencioso, el cual se convertirá en una advertencia de deprecación no silenciosa en Python 3.6 y activará un `RuntimeError` en Python 3.7. Consultar PEP 479: Cambiar el gestor de StopIteration dentro de generadores para más detalles.

### Sistemas operativos no compatibles

Windows XP ya no es compatible con Microsoft, por lo tanto, según PEP 11, CPython 3.5 oficialmente ya no es compatible con este sistema operativo.

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

Ahora el módulo `formatter` se ha graduado a su deprecación completa y aún está programada para su eliminación en Python 3.6.

La función `asyncio.async()` es obsoleta en favor de `ensure_future()`.

En el pasado, el módulo `smtpd` siempre ha decodificado la porción DATA de los mensajes de correo electrónico usando el códec `utf-8`. Ahora esto se puede controlar con la nueva palabra clave decode_data en `SMTPServer`. El valor predeterminado es `True`, pero éste está obsoleto. Especificar la palabra clave decode_data con un valor apropiado para evitar la advertencia de deprecación.

Está obsoleto asignar valores directamente en `key`, `value` y `coded_value` en los objetos de `http.cookies.Morsel`. Usar en su lugar el método `set()`. Además, el parámetro no documentado LegalChars de `set()` está obsoleto y ahora se ignora.

Pasar una cadena de caracteres de formato como argumento de palabra clave format_string al método `format()` de la clase `string.Formatter` se ha quedado obsoleto. (Contribución de Serhiy Storchaka en bpo-23671.)

Ahora las funciones `platform.dist()` y `platform.linux_distribution()` están obsoletas. Las distribuciones de Linux usan demasiadas formas diferentes de describirse a sí mismas, así que la funcionalidad se deja a un paquete. (Contribución de Vajrasky Kok y Berker Peksag en bpo-1322.)

Los métodos `from_function` y `from_builtin` previamente no documentados de `inspect.Signature` están obsoletos. Utilizar en su lugar el nuevo método `Signature.from_callable()`. (Contribución de Yury Selivanov en bpo-24248.)

La función `inspect.getargspec()` está obsoleta y programada para ser eliminada en Python 3.6. (Consultar bpo-20438 para más detalles.)

Las funciones `inspect` `getfullargspec()`, `getcallargs()` y `formatargspec()` están obsoletas en favor de la API `inspect.signature()`. (Contribución de Yury Selivanov en bpo-20438.)

Las funciones `getargvalues()` y `formatargvalues()` se marcaron inadvertidamente como obsoletas con el lanzamiento de Python 3.5.0.

Ahora el uso de la bandera `re.LOCALE` con patrones str o `re.ASCII` está obsoleto. (Contribución de Serhiy Storchaka en bpo-22407.)

El uso de secuencias especiales no reconocidas que consisten en `'\'` y una letra ASCII en patrones de expresión regular y patrones de reemplazo ahora lanza una advertencia de deprecación y estará prohibido en Python 3.6. (Contribución de Serhiy Storchaka en bpo-23622.)

Ahora el argumento predeterminado no documentado y no oficial use_load_tests del método `unittest.TestLoader.loadTestsFromModule()` está obsoleto e ignorado. (Contribución de Robert Collins y Barry A. Warsaw en bpo-16662.)

## Eliminado

### APIs y características eliminadas

Se eliminaron las siguientes APIs y características obsoletas y anteriormente obsoletas:

- Se eliminó el atributo `__version__` del paquete de correo electrónico. No se envió el código de correo electrónico por separado de stdlib durante mucho tiempo, y la cadena de caracteres `__version__` no se actualizó en las últimas versiones.

- La clase interna `Netrc` en el módulo `ftplib` quedó obsoleta en la versión 3.4 y ahora se eliminó. (Contribución de Matt Chaput en bpo-6623.)

- Se eliminó el concepto de los archivos `.pyo`.

- La clase JoinableQueue en el módulo provisional `asyncio` quedó obsoleto en la versión 3.4.4 y ahora se eliminó. (Contribución de A. Jesse Jiryu Davis en bpo-23464.)

## Portando a Python 3.5

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

### Cambios en el comportamiento de Python

- Debido a un descuido, erróneamente en anteriores versiones de Python aceptaron la siguiente sintaxis:

      f(1 for x in [1], *args)
      f(1 for x in [1], **kwargs)

  Ahora Python 3.5 lanza correctamente un `SyntaxError`, ya que las expresiones generadoras deben ponerse entre paréntesis si no son el único argumento de una función.

### Cambios en la API de Python

- PEP 475: Ahora se reintentan las llamadas al sistema cuando se interrumpen por una señal en lugar de lanzar `InterruptedError` si el gestor de señales de Python no lanza una excepción.

- Antes de Python 3.5, se consideraba falso un objeto `datetime.time` si representaba la medianoche en UTC. Este comportamiento se consideraba oscuro y propenso a errores y se eliminó en Python 3.5. Consultar bpo-13936 para más detalles.

- Ahora el método `ssl.SSLSocket.send()` lanza ya sea `ssl.SSLWantReadError` o `ssl.SSLWantWriteError` en un socket sin bloqueo si la operación se bloqueara. Anteriormente, retornaría `0`. (Contribución de Nikolaus Rath en bpo-20951.)

- Ahora el atributo `__name__` de los generadores se establece desde el nombre de la función en lugar de establecerse desde el nombre del código. Usar `gen.gi_code.co_name` para recuperar el nombre del código. También los generadores tienen un nuevo atributo `__qualname__`, el nombre calificado, el cual se utiliza ahora para la representación de un generador (`repr(gen)`). (Contribución de Victor Stinner en bpo-21205.)

- The deprecated «strict» mode and argument of `HTMLParser`, `HTMLParser.error()`, and the `HTMLParserError` exception have been removed. (Contributed by Ezio Melotti in bpo-15114.) The convert_charrefs argument of `HTMLParser` is now `True` by default. (Contributed by Berker Peksag in bpo-21047.)

- Aunque no es parte formalmente de la API, vale la pena señalar con fines de portabilidad (es decir: pruebas de reparación) que ahora los mensajes de error que anteriormente tenían el formato «“sometype” no es compatible con el protocolo búfer» son del formato «se requiere bytes-like object, no “sometype”». (Contribución de Ezio Melotti en bpo-16518.)

- Si el directorio actual se establece en un directorio que ya no existe entonces ya no se lanzará `FileNotFoundError` y en su lugar `find_spec()` retornará `None` sin almacenamiento en caché `None` en `sys.path_importer_cache`, el cual es diferente al caso típico (bpo-22834).

- El código de estado HTTP y los mensajes de `http.client` y `http.server` se refactorizaron en una enumeración `HTTPStatus`. Los valores en `http.client` y `http.server` permanecen disponibles para compatibilidad con versiones anteriores. (Contribución de Demian Brecht en bpo-21793.)

- Cuando un cargador de importación define `importlib.machinery.Loader.exec_module()`, ahora se espera que también defina `create_module()` (ahora lanza un `DeprecationWarning`, será un error en Python 3.6). Si el cargador hereda de `importlib.abc.Loader` entonces no hay nada que hacer, de lo contrario simplemente defina `create_module()` para retornar `None`. (Contribución de Brett Cannon en bpo-23014.)

- La función `re.split()` siempre ignoraba las coincidencias de patrones vacías, así que el patrón `"x*"` funcionaba igual que `"x+"` y el patrón `"\b"` nunca funcionó. Ahora `re.split()` lanza una advertencia si el patrón puede coincidir con una cadena de caracteres vacía. Para compatibilidad, usar patrones que nunca coincidan con una cadena vacía (p. ej. `"x+"` en lugar de `"x*"`). Ahora los patrones que solo pueden coincidir con una cadena vacía (como `"\b"`) lanzan un error. (Contribución de Serhiy Storchaka en bpo-22818.)

- La interfaz similar a diccionarios `http.cookies.Morsel` se ha hecho autoconsistente: ahora la comparación de morsel toma en cuenta `key` y `value`, ahora `copy()` da como resultado en una instancia `Morsel` en lugar de un `dict`, y ahora `update()` lanzará una excepción si alguna de las claves del diccionario de actualización no es válida. Además, el parámetro no documentado LegalChars de `set()` está obsoleto y ahora se ignora. (Contribución de Demian Brecht en bpo-2211.)

- PEP 488 eliminó los archivos `.pyo` de Python e introdujo la etiqueta opcional `opt-` en los nombres de archivo `.pyc`. El `importlib.util.cache_from_source()` ha obtenido un parámetro optimization para ayudar a controlar la etiqueta `opt-`. Debido a esto, el parámetro debug_override de la función ahora está en desuso. Los archivos `.pyo` ya no se admiten como argumento de archivo para el intérprete de Python y, por lo tanto, no sirven para nada cuando se distribuyen por sí solos (es decir, distribución de código sin código fuente). Debido al hecho de que el número mágico para el código de bytes ha cambiado en Python 3.5, todos los archivos `.pyo` antiguos de versiones anteriores de Python no son válidos independientemente de este PEP.

- The `socket` module now exports the `CAN_RAW_FD_FRAMES` constant on linux 3.6 and greater.

- Ahora la función `ssl.cert_time_to_seconds()` interpreta la hora de entrada como UTC y no como hora local, por RFC 5280. Además, el valor de retorno siempre es un `int`. (Contribución de Akira Li en bpo-19940.)

- Ahora la herramienta `pygettext.py` usa el formato estándar +NNNN para zonas horarias en el encabezado POT-Creation-Date.

- Ahora el módulo `smtplib` usa `sys.stderr` en lugar de la variable anterior de nivel de módulo `stderr` para la salida de depuración. Si tu programa (de prueba) depende de parchear la variable de nivel de mundo para capturar la salida de depuración, necesitarás actualizarlo para capturar sys.stderr en su lugar.

- Los métodos `str.startswith()` y `str.endswith()` ya no retornan `True` cuando encuentran la cadena de caracteres vacía y los índices están completamente fuera de rango. (Contribución de Serhiy Storchaka en bpo-24284.)

- Ahora la función `inspect.getdoc()` retorna cadenas de documentación que se heredaron de clases base. Ya no es necesario duplicar las cadenas de documentación si la documentación que se heredó es apropiada. Para suprimir una cadena que se heredó, se debe especificar una cadena vacía (o se puede completar la documentación). Este cambio afecta la salida del módulo `pydoc` y la función `help()`. (Contribución de Serhiy Storchaka en bpo-15582.)

- Ahora las llamadas anidadas `functools.partial()` se aplanan. Si se confiaba en el comportamiento anterior, ahora se puede agregar un atributo a un objeto `functools.partial()` o se puede crear una subclase de `functools.partial()`. (Contribución de Alexander Belopolsky en bpo-7830.)

### Cambios en la API de C

- The undocumented `format` member of the (non-public) `PyMemoryViewObject` structure has been removed. All extensions relying on the relevant parts in `memoryobject.h` must be rebuilt.

- La estructura `PyMemAllocator` se renombró a `PyMemAllocatorEx` y se agregó un nuevo campo `calloc`.

- Removed non-documented macro `PyObject_REPR()` which leaked references. Use format character `%R` in `PyUnicode_FromFormat()`-like functions to format the `repr()` of the object. (Contributed by Serhiy Storchaka in bpo-22453.)

- Debido a que la falta del atributo `__module__` rompe pickling y la introspección, ahora se lanza una advertencia de deprecación para los tipos integrados sin el atributo `__module__`. Este sería un AttributeError en el futuro. (Contribución de Serhiy Storchaka en bpo-20204.)

- As part of the PEP 492 implementation, the `tp_reserved` slot of `PyTypeObject` was replaced with a `tp_as_async` slot. Refer to Objetos corrutina for new types, structures and functions.

## Cambios notables en Python 3.5.4

### Nuevo objetivo de compilación `make regen-all`

Para simplificar la compilación cruzada y asegurar 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 herramientas automáticas ya no intenta volver a compilar implícitamente los archivos generados en función de los tiempos de modificación de los archivos.

En su lugar, se agregó un nuevo comando `make regen-all` para forzar la regeneración de estos archivos cuando se desee (p. ej. 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 - consultar Makefile.pre.in para más detalles.

(Contribución de Victor Stinner en bpo-23404.)

Nuevo en la versión 3.5.4.

### Eliminación del objetivo de compilación `make touch`

Se eliminó el objetivo de compilación `make touch` que anteriormente se usaba para solicitar la regeneración implícita de los archivos generados mediante la actualización de sus tiempos de modificación.

Se reemplazó por el nuevo objetivo `make regen-all`.

(Contribución de Victor Stinner en bpo-23404.)

Distinto en la versión 3.5.4.