Novedades de Python 3.9
***********************

Editor:
   Łukasz Langa

This article explains the new features in Python 3.9, compared to 3.8.
Python 3.9 was released on October 5, 2020.

Para obtener detalles completos, consulte el changelog.

Ver también: **PEP 596** - Programa de lanzamiento de Python 3.9


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

Nuevas funciones de sintaxis:

* **PEP 584**, operadores unión agregados a "dict";

* **PEP 585**, genéricos de sugerencia de tipo en colecciones
  estándar;

* **PEP 614**, restricciones gramaticales relajadas para los
  decoradores.

Nuevas funciones integradas:

* **PEP 616**, métodos de cadena para eliminar prefijos y sufijos.

Nuevas funciones en la biblioteca estándar:

* **PEP 593**, función flexible y anotaciones variables;

* Se agregó "os.pidfd_open()" que permite la gestión de procesos sin
  razas ni señales.

Mejoras en el intérprete:

* **PEP 573**, acceso rápido al estado del módulo desde métodos de
  tipos de extensión C;

* **PEP 617**, CPython ahora usa un nuevo analizador basado en PEG;

* varias incorporaciones de Python (rango, tupla, conjunto, conjunto
  frozenset, lista, dict) ahora se aceleran usando **PEP 590**
  vectorcall;

* la recolección de basura no bloquea los objetos resucitados;

* varios módulos de Python ("_abc", "audioop", "_bz2", "_codecs",
  "_contextvars", "_crypt", "_functools", "_json", "_locale", "math",
  "operator", "resource", "time", "_weakref") ahora utilizan la
  inicialización multifase según lo definido por PEP 489;

* varios módulos de biblioteca estándar ("audioop", "ast", "grp",
  "_hashlib", "pwd", "_posixsubprocess", "random", "select", "struct",
  "termios", "zlib") ahora utilizan la ABI estable definida por PEP
  384.

Nuevos módulos de biblioteca:

* **PEP 615**, la base de datos de zona horaria de IANA ahora está
  presente en la biblioteca estándar en el módulo "zoneinfo";

* ahora se proporciona una implementación de una especie de gráfico
  topológico en el nuevo módulo "graphlib".

Cambios en el proceso de lanzamiento:

* **PEP 602**, CPython adopta un ciclo de lanzamiento anual.


Debe verificar DeprecationWarning en su código
==============================================

Cuando todavía se admitía Python 2.7, se conservaba una gran cantidad
de funciones en Python 3 por compatibilidad con versiones anteriores
de Python 2.7. Con el fin de la compatibilidad con Python 2, estas
capas de compatibilidad con versiones anteriores se eliminaron o se
eliminarán pronto. La mayoría de ellos emitió una advertencia
"DeprecationWarning" durante varios años. Por ejemplo, usar
"collections.Mapping" en lugar de "collections.abc.Mapping" emite un
"DeprecationWarning" desde Python 3.3, lanzado en 2012.

Pruebe su aplicación con la opción de línea de comandos "-W" "default"
para ver "DeprecationWarning" y "PendingDeprecationWarning", o incluso
con "-W" "error" para tratarlos como errores. Warnings Filter se puede
utilizar para ignorar las advertencias del código de terceros.

Python 3.9 es la última versión que proporciona esas capas de
compatibilidad con versiones anteriores de Python 2, para dar más
tiempo a los mantenedores de proyectos de Python para organizar la
eliminación del soporte de Python 2 y agregar soporte para Python 3.9.

Los alias de Abstract Base Classes en el módulo "collections", como el
alias de "collections.Mapping" de "collections.abc.Mapping", se
mantienen para una última versión por compatibilidad con versiones
anteriores. Se eliminarán de Python 3.10.

De manera más general, intente ejecutar sus pruebas en el Python
Development Mode, lo que ayuda a preparar su código para que sea
compatible con la próxima versión de Python.

Nota: también se eliminaron varias obsoletas en esta versión de
Python. Consulte la sección Remoto.


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


Operadores de combinación y actualización de diccionarios
---------------------------------------------------------

Los operadores de fusión ("|") y actualización ("|=") se han agregado
a la clase "dict" incorporada. Estos complementan los métodos
"dict.update" y "{**d1, **d2}" existentes para fusionar diccionarios.

Ejemplo:

   >>> x = {"key1": "value1 from x", "key2": "value2 from x"}
   >>> y = {"key2": "value2 from y", "key3": "value3 from y"}
   >>> x | y
   {'key1': 'value1 from x', 'key2': 'value2 from y', 'key3': 'value3 from y'}
   >>> y | x
   {'key2': 'value2 from x', 'key3': 'value3 from y', 'key1': 'value1 from x'}

Consulte **PEP 584** para obtener una descripción completa.
(Contribuido por Brandt Bucher en bpo-36144.)


Nuevos métodos de cadena para eliminar prefijos y sufijos
---------------------------------------------------------

Se han agregado "str.removeprefix(prefix)" y
"str.removesuffix(suffix)" para eliminar fácilmente un prefijo o
sufijo innecesario de una cadena. También se han agregado los métodos
correspondientes "bytes", "bytearray" y "collections.UserString".
Consulte **PEP 616** para obtener una descripción completa.
(Contribuido por Dennis Sweeney en bpo-39939.)


Tipos genéricos de sugerencia en colecciones estándar
-----------------------------------------------------

En las anotaciones de tipo, ahora puede usar tipos de colección
integrados como "list" y "dict" como tipos genéricos en lugar de
importar los tipos en mayúsculas correspondientes (por ejemplo, "List"
o "Dict") desde "typing". Algunos otros tipos de la biblioteca
estándar ahora también son genéricos, por ejemplo, "queue.Queue".

Ejemplo:

   def greet_all(names: list[str]) -> None:
       for name in names:
           print("Hello", name)

Consulte **PEP 585** para obtener más detalles. (Contribuido por Guido
van Rossum, Ethan Smith y Batuhan Taşkaya en bpo-39481.)


Nuevo analizador
----------------

Python 3.9 usa un nuevo analizador, basado en PEG en lugar de LL(1).
El rendimiento del analizador nuevo es aproximadamente comparable al
del analizador anterior, pero el formalismo PEG es más flexible que LL
(1) cuando se trata de diseñar nuevas funciones de lenguaje.
Comenzaremos a usar esta flexibilidad en Python 3.10 y versiones
posteriores.

El módulo "ast" usa el nuevo analizador y produce el mismo AST que el
analizador anterior.

En Python 3.10, el analizador anterior se eliminará y también lo hará
toda la funcionalidad que depende de él (principalmente el módulo
"parser", que ha estado en desuso durante mucho tiempo). En Python 3.9
*only*, puede volver al analizador LL (1) utilizando un modificador de
línea de comando ("-X oldparser") o una variable de entorno
("PYTHONOLDPARSER=1").

Consulte **PEP 617** para obtener más detalles. (Contribuido por Guido
van Rossum, Pablo Galindo y Lysandros Nikolaou en bpo-40334.)


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

* "__import__()" ahora lanza "ImportError" en lugar de "ValueError",
  que solía ocurrir cuando una importación relativa pasaba de su
  paquete de nivel superior. (Contribuido por Ngalim Siregar en
  bpo-37444.)

* Python ahora obtiene la ruta absoluta del nombre de archivo del
  script especificado en la línea de comando (por ejemplo: "python3
  script.py"): el módulo `` __file__`` attribute of the "__main__" se
  convirtió en una ruta absoluta, en lugar de una ruta relativa. Estas
  rutas ahora siguen siendo válidas después de que las tramas del
  módulo "os.chdir()". Como efecto alterno, la traza también muestra
  la ruta absoluta para los marcos del módulo "__main__" en este caso.
  (Contribuido por Victor Stinner en bpo-20443.)

* En Python Development Mode y en debug build, los argumentos de
  *encoding* and *errors* ahora se comprueban para las operaciones de
  codificación y decodificación de cadenas. Ejemplos: "open()",
  "str.encode()" y "bytes.decode()".

  De forma predeterminada, para un mejor rendimiento, el argumento
  *errors* argument is only checked at the first encoding/decoding
  error and the *encoding* a veces se ignora para cadenas vacías.
  (Contribuido por Victor Stinner en bpo-37388.)

* """.replace("", s, n)" ahora devuelve "s" en lugar de una cadena
  vacía para todos los "n" distintos de cero. Ahora es compatible con
  """.replace("", s)". Hay cambios similares para los objetos "bytes"
  y "bytearray". (Contribuido por Serhiy Storchaka en bpo-28029.)

* Cualquier expresión válida ahora se puede utilizar como *decorator*.
  Anteriormente, la gramática era mucho más restrictiva. Consulte
  **PEP 614** para obtener más detalles. (Contribuido por Brandt
  Bucher en bpo-39702.)

* Ayuda mejorada para el módulo "typing". Las cadenas de documentos
  ahora se muestran para todas las formas especiales y alias genéricos
  especiales (como "Union" y "List"). El uso de "help()" con un alias
  genérico como "List[int]" mostrará la ayuda para el tipo concreto
  correspondiente ("list" en este caso). (Contribuido por Serhiy
  Storchaka en bpo-40257.)

* La ejecución en paralelo de "aclose()" / "asend()" / "athrow()"
  ahora está prohibida, y "ag_running" ahora refleja el estado de
  ejecución real del generador asíncrono. (Contribuido por Yury
  Selivanov en bpo-30773.)

* Los errores inesperados al llamar al método "__iter__" ya no están
  enmascarados por "TypeError" en el operador "in" y funciones
  "contains()", "indexOf()" y "countOf()" del módulo "operator".
  (Contribuido por Serhiy Storchaka en bpo-40824.)

* Las expresiones lambda sin paréntesis ya no pueden ser la parte de
  expresión en una cláusula "if" en comprensiones y expresiones
  generadoras. Consulte bpo-41848 y bpo-43755 para obtener más
  detalles.


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


zoneinfo
--------

El módulo "zoneinfo" brinda soporte para la base de datos de zona
horaria de IANA a la biblioteca estándar. Agrega "zoneinfo.ZoneInfo",
una implementación de "datetime.tzinfo" concreta respaldada por los
datos de la zona horaria del sistema.

Ejemplo:

   >>> from zoneinfo import ZoneInfo
   >>> from datetime import datetime, timedelta

   >>> # Daylight saving time
   >>> dt = datetime(2020, 10, 31, 12, tzinfo=ZoneInfo("America/Los_Angeles"))
   >>> print(dt)
   2020-10-31 12:00:00-07:00
   >>> dt.tzname()
   'PDT'

   >>> # Standard time
   >>> dt += timedelta(days=7)
   >>> print(dt)
   2020-11-07 12:00:00-08:00
   >>> print(dt.tzname())
   PST

Como fuente de datos alternativa para las plataformas que no envían la
base de datos de la IANA, el módulo "tzdata" se lanzó como un paquete
propio, distribuido a través de PyPI y mantenido por el equipo central
de CPython.

Ver también:

  **PEP 615**: compatibilidad con la base de datos de zona horaria de
  IANA en la biblioteca estándar
     PEP escrito e implementado por Paul Ganssle


Graphlib
--------

Se agregó un nuevo módulo, "graphlib", que contiene la clase
"graphlib.TopologicalSorter" para ofrecer funcionalidad para realizar
la clasificación topológica de gráficos. (Contribuido por Pablo
Galindo, Tim Peters y Larry Hastings en bpo-17005.)


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


ast
---

Se agregó la opción *indent* a "dump()" que le permite producir una
salida con sangría de varias líneas. (Contribuido por Serhiy Storchaka
en bpo-37995.)

Se agregó "ast.unparse()" como una función en el módulo "ast" que se
puede usar para descomprimir un objeto "ast.AST" y producir una cadena
con código que produciría un objeto "ast.AST" equivalente cuando se
analiza. (Contribuido por Pablo Galindo y Batuhan Taskaya en
bpo-38870.)

Se agregaron cadenas de documentación a los nodos AST que contienen la
firma ASDL utilizada para construir ese nodo. (Contribuido por Batuhan
Taskaya en bpo-39638.)


asyncio
-------

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.)

Se agregó un nuevo *coroutine* "shutdown_default_executor()" que
programa un apagado para el ejecutor predeterminado que espera en el
"ThreadPoolExecutor" para finalizar el cierre. Además, "asyncio.run()"
se ha actualizado para utilizar el nuevo *coroutine*. (Contribuido por
Kyle Stanley en bpo-34037.)

Se agregó "asyncio.PidfdChildWatcher", una implementación de
observador de niños específica de Linux que sondea los descriptores de
archivos de proceso. (bpo-38692)

Se agregó un nuevo *coroutine* "asyncio.to_thread()". Se utiliza
principalmente para ejecutar funciones vinculadas a IO en un hilo
separado para evitar bloquear el bucle de eventos, y esencialmente
funciona como una versión de alto nivel de "run_in_executor()" que
puede tomar directamente argumentos de palabras clave. (Contribuido
por Kyle Stanley y Yury Selivanov en bpo-32309.)

Al cancelar la tarea debido a un tiempo de espera,
"asyncio.wait_for()" ahora esperará hasta que se complete la
cancelación también en el caso de que *timeout* sea <= 0, como ocurre
con los tiempos de espera positivos. (Contribuido por Elvis
Pranskevichus en bpo-32751.)

"asyncio" ahora lanza "TyperError" al llamar a métodos incompatibles
con un socket "ssl.SSLSocket". (Contribuido por Ido Michael en
bpo-37404.)


compilar todo
-------------

Se agregó una nueva posibilidad de usar enlaces duros para archivos
".pyc" duplicados: parámetro *hardlink_dupes* y opción de línea de
comando --hardlink-dupes. (Contribuido por Lumír 'Frenzy' Balhar en
bpo-40495.)

Se agregaron nuevas opciones para la manipulación de rutas en los
archivos ".pyc" resultantes: parámetros *stripdir*, *prependdir*,
*limit_sl_dest* y opciones de línea de comando -s, -p, -e. Se agregó
la posibilidad de especificar la opción para un nivel de optimización
varias veces. (Contribuido por Lumír 'Frenzy' Balhar en bpo-38112.)


Futuros concurrentes
--------------------

Se agregó un nuevo parámetro *cancel_futures* a
"concurrent.futures.Executor.shutdown()" que cancela todos los futuros
pendientes que no han comenzado a ejecutarse, en lugar de esperar a
que se completen antes de apagar el ejecutor. (Contribuido por Kyle
Stanley en bpo-39349.)

Se eliminaron los subprocesos del demonio de "ThreadPoolExecutor" y
"ProcessPoolExecutor". Esto mejora la compatibilidad con los
subinterpretadores y la previsibilidad en sus procesos de cierre.
(Contribuido por Kyle Stanley en bpo-39812.)

Los trabajadores en "ProcessPoolExecutor" ahora se generan a pedido,
solo cuando no hay trabajadores inactivos disponibles para reutilizar.
Esto optimiza la sobrecarga de inicio y reduce la cantidad de tiempo
de CPU perdido para los trabajadores inactivos. (Contribuido por Kyle
Stanley en bpo-39207.)


maldiciones
-----------

Se agregaron funciones "curses.get_escdelay()",
"curses.set_escdelay()", "curses.get_tabsize()" y
"curses.set_tabsize()". (Contribuido por Anthony Sottile en
bpo-38312.)


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

Los métodos "isocalendar()" de "datetime.date" y "isocalendar()" de
"datetime.datetime" ahora devuelven un "namedtuple()" en lugar de un
"tuple". (Contribuido por Dong-hee Na en bpo-24416.)


distutils
---------

El comando: command: *upload* ahora crea resúmenes de hash SHA2-256 y
Blake2b-256. Omite MD5 en plataformas que bloquean el resumen de MD5.
(Contribuido por Christian Heimes en bpo-40698.)


fcntl
-----

Se agregaron las constantes "F_OFD_GETLK", "F_OFD_SETLK" y
"F_OFD_SETLKW". (Contribuido por Dong-hee Na en bpo-38602.)


ftplib
------

"FTP" y "FTP_TLS" ahora lanzan un "ValueError" si el tiempo de espera
dado para su constructor es cero para evitar la creación de un socket
sin bloqueo. (Contribuido por Dong-hee Na en bpo-39259.)


GC
--

Cuando el recolector de basura realiza una recolección en la que
resucitan algunos objetos (se puede acceder a ellos desde fuera de los
ciclos aislados después de que se hayan ejecutado los finalizadores),
no bloquee la recolección de todos los objetos que aún no se pueden
alcanzar. (Contribuido por Pablo Galindo y Tim Peters en bpo-38379.)

Se agregó una nueva función "gc.is_finalized()" para verificar si el
recolector de basura ha finalizado un objeto. (Contribuido por Pablo
Galindo en bpo-39322.)


hashlib
-------

El módulo "hashlib" ahora puede usar hashes SHA3 y SHAKE XOF de
OpenSSL cuando esté disponible. (Contribuido por Christian Heimes en
bpo-37630.)

Los módulos hash incorporados ahora pueden desactivarse con
"./configure --without-builtin-hashlib-hashes" o activarse
selectivamente con p. Ej. "./configure --with-builtin-hashlib-
hashes=sha3,blake2" para forzar el uso de la implementación basada en
OpenSSL. (Contribuido por Christian Heimes en bpo-40479)


http
----

Los códigos de estado HTTP "103 EARLY_HINTS", "418 IM_A_TEAPOT" y "425
TOO_EARLY" se agregan a "http.HTTPStatus". (Contribuido por Dong-hee
Na en bpo-39509 y Ross Rhodes en bpo-39507.)


IDLE e idlelib
--------------

Opción agregada para apagar el cursor parpadeando. (Contribuido por
Zackery Spytz en bpo-4603.)

La tecla Escape ahora cierra las ventanas de finalización IDLE.
(Contribuido por Johnny Najera en bpo-38944.)

Se agregaron palabras clave a la lista de finalización del nombre del
módulo. (Contribuido por Terry J. Reedy en bpo-37765.)

New in 3.9 maintenance releases

Make IDLE invoke "sys.excepthook()" (when started without '-n'). User
hooks were previously ignored.  (Contributed by Ken Hilton in
bpo-43008.)

Los cambios anteriores se han actualizado a las versiones de
mantenimiento 3.8.

Rearrange the settings dialog.  Split the General tab into Windows and
Shell/Ed tabs.  Move help sources, which extend the Help menu, to the
Extensions tab.  Make space for new options and shorten the dialog.
The latter makes the dialog better fit small screens.  (Contributed by
Terry Jan Reedy in bpo-40468.)  Move the indent space setting from the
Font tab to the new Windows tab.  (Contributed by Mark Roseman and
Terry Jan Reedy in bpo-33962.)

Apply syntax highlighting to ".pyi" files. (Contributed by Alex
Waygood and Terry Jan Reedy in bpo-45447.)


imaplib
-------

"IMAP4" y "IMAP4_SSL" ahora tienen un parámetro *timeout* parameter
for their constructors. También el método "open()" ahora tiene un
parámetro opcional *timeout* con este cambio. Los métodos anulados de
"IMAP4_SSL" y "IMAP4_stream" se aplicaron a este cambio. (Contribuido
por Dong-hee Na en bpo-38615.)

Se agrega "imaplib.IMAP4.unselect()". "imaplib.IMAP4.unselect()"
libera los recursos del servidor asociados con el buzón de correo
seleccionado y devuelve el servidor al estado autenticado. Este
comando realiza las mismas acciones que "imaplib.IMAP4.close()",
excepto que ningún mensaje se elimina permanentemente del buzón de
correo seleccionado actualmente. (Contribuido por Dong-hee Na en
bpo-40375.)


importlib
---------

Para mejorar la coherencia con las declaraciones de importación,
"importlib.util.resolve_name()" ahora lanza "ImportError" en lugar de
"ValueError" para intentos de importación relativa no válidos.
(Contribuido por Ngalim Siregar en bpo-37444.)

Los cargadores de importación que publican objetos de módulo
inmutables ahora pueden publicar paquetes inmutables además de módulos
individuales. (Contribuido por Dino Viehland en bpo-39336.)

Se agregó la función "importlib.resources.files()" con soporte para
subdirectorios en los datos del paquete, compatible con el backport en
"importlib_resources" versión 1.5. (Contribuido por Jason R. Coombs en
bpo-39791.)

"importlib.metadata" actualizado de "importlib_metadata" versión
1.6.1.


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

"inspect.BoundArguments.arguments" se cambia de "OrderedDict" a
dictado regular. (Contribuido por Inada Naoki en bpo-36350 y
bpo-39775.)


dirección IP
------------

"ipaddress" ahora admite direcciones de ámbito IPv6 (dirección IPv6
con sufijo "%<scope_id>").

Las direcciones IPv6 con alcance se pueden analizar mediante
"ipaddress.IPv6Address". Si está presente, la identificación de la
zona del alcance está disponible a través del atributo "scope_id".
(Contribuido por Oleksandr Pavliuk en bpo-34788.)

A partir de Python 3.9.5, el módulo "ipaddress" ya no acepta ceros a
la izquierda en cadenas de direcciones IPv4. (Contribuido por
Christian Heimes en bpo-36384).


Matemáticas
-----------

Se amplió la función "math.gcd()" para manejar múltiples argumentos.
Anteriormente, solo respaldaba dos argumentos. (Contribuido por Serhiy
Storchaka en bpo-39648.)

"math.lcm()" agregado: devuelve el mínimo común múltiplo de argumentos
especificados. (Contribuido por Mark Dickinson, Ananthakrishnan y
Serhiy Storchaka en bpo-39479 y bpo-39648.)

"math.nextafter()" agregado: devuelve el siguiente valor de punto
flotante después de *x* towards *y*. (Contribuido por Victor Stinner
en bpo-39288.)

"math.ulp()" agregado: devuelve el valor del bit menos significativo
de un flotador. (Contribuido por Victor Stinner en bpo-39310.)


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

La clase "multiprocessing.SimpleQueue" tiene un nuevo método "close()"
para cerrar explícitamente la cola. (Contribuido por Victor Stinner en
bpo-30966.)


nntplib
-------

"NNTP" y "NNTP_SSL" ahora lanzan un "ValueError" si el tiempo de
espera dado para su constructor es cero para evitar la creación de un
socket sin bloqueo. (Contribuido por Dong-hee Na en bpo-39259.)


os
--

Se agregaron "CLD_KILLED" y "CLD_STOPPED" para "si_code". (Contribuido
por Dong-hee Na en bpo-38493.)

Se expusieron los "os.pidfd_open()" (bpo-38692) y "os.P_PIDFD"
(bpo-38713) específicos de Linux para la gestión de procesos con
descriptores de archivos.

La función "os.unsetenv()" ahora también está disponible en Windows.
(Contribuido por Victor Stinner en bpo-39413.)

Las funciones "os.putenv()" y "os.unsetenv()" ahora están siempre
disponibles. (Contribuido por Victor Stinner en bpo-39395.)

Función "os.waitstatus_to_exitcode()" agregada: convierte un estado de
espera en un código de salida. (Contribuido por Victor Stinner en
bpo-40094.)


Pathlib
-------

Se agregó "pathlib.Path.readlink()" que actúa de manera similar a
"os.readlink()". (Contribuido por Girts Folkmanis en bpo-30618)


pdb
---

En Windows, ahora "Pdb" es compatible con "~/.pdbrc". (Contribuido por
Tim Hopper y Dan Lidral-Porter en bpo-20523.)


poplib
------

"POP3" y "POP3_SSL" ahora lanzan un "ValueError" si el tiempo de
espera dado para su constructor es cero para evitar la creación de un
socket sin bloqueo. (Contribuido por Dong-hee Na en bpo-39259.)


pprint
------

"pprint" ahora puede imprimir "types.SimpleNamespace" de forma bonita.
(Contribuido por Carl Bordum Hansen en bpo-37376.)


Pydoc
-----

La cadena de documentación ahora se muestra no solo para la clase,
función, método, etc., sino para cualquier objeto que tenga su propio
atributo "__doc__". (Contribuido por Serhiy Storchaka en bpo-40257.)


aleatorio
---------

Se agregó un nuevo método "random.Random.randbytes": generar bytes
aleatorios. (Contribuido por Victor Stinner en bpo-40286.)


señal
-----

Expuso el "signal.pidfd_send_signal()" específico de Linux para enviar
señales a un proceso utilizando un descriptor de archivo en lugar de
un pid. (bpo-38712)


smtplib
-------

"SMTP" y "SMTP_SSL" ahora lanzan un "ValueError" si el tiempo de
espera dado para su constructor es cero para evitar la creación de un
socket sin bloqueo. (Contribuido por Dong-hee Na en bpo-39259.)

El constructor "LMTP" ahora tiene un parámetro *timeout* opcional.
(Contribuido por Dong-hee Na en bpo-39329.)


enchufe
-------

El módulo "socket" ahora exporta la constante "CAN_RAW_JOIN_FILTERS"
en Linux 4.1 y superior. (Contribuido por Stefan Tatschner y Zackery
Spytz en bpo-25780.)

El módulo de socket ahora admite el protocolo "CAN_J1939" en
plataformas que lo admiten. (Contribuido por Karl Ding en bpo-40291.)

El módulo de enchufe ahora tiene las funciones "socket.send_fds()" y
"socket.recv_fds()". (Contribuido por Joannah Nanjekye, Shinya Okano y
Victor Stinner en bpo-28724.)


tiempo
------

En AIX, "thread_time()" ahora se implementa con "thread_cputime()" que
tiene una resolución de nanosegundos, en lugar de
"clock_gettime(CLOCK_THREAD_CPUTIME_ID)" que tiene una resolución de
10 ms. (Contribuido por Batuhan Taskaya en bpo-40192)


sys
---

Se agregó un nuevo atributo "sys.platlibdir": nombre del directorio de
biblioteca específico de la plataforma. Se utiliza para construir la
ruta de la biblioteca estándar y las rutas de los módulos de extensión
instalados. Es igual a ""lib"" en la mayoría de las plataformas. En
Fedora y SuSE, es igual a ""lib64"" en plataformas de 64 bits.
(Contribuido por Jan Matějek, Matěj Cepl, Charalampos Stratakis y
Victor Stinner en bpo-1294959.)

Anteriormente, "sys.stderr" estaba bloqueado en búfer cuando no era
interactivo. Ahora "stderr" tiene como valor predeterminado que
siempre tenga búfer de línea. (Contribuido por Jendrik Seipp en
bpo-13601.)


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

Se agregó "tracemalloc.reset_peak()" para establecer el tamaño máximo
de los bloques de memoria rastreados al tamaño actual, para medir el
pico de piezas de código específicas. (Contribuido por Huon Wilson en
bpo-40630.)


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

**PEP 593** introdujo un tipo "typing.Annotated" para decorar tipos
existentes con metadatos específicos del contexto y el nuevo parámetro
"include_extras" en "typing.get_type_hints()" para acceder a los
metadatos en tiempo de ejecución. (Contribuido por Till Varoquaux y
Konstantin Kashin.)


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

La base de datos Unicode se ha actualizado a la versión 13.0.0.
(bpo-39926).


venv
----

Los scripts de activación proporcionados por "venv" ahora especifican
su personalización de solicitud de manera consistente utilizando
siempre el valor especificado por "__VENV_PROMPT__". Anteriormente,
algunos scripts usaban "__VENV_PROMPT__" incondicionalmente, otros
solo si estaba configurado (que era el caso predeterminado) y uno
usaba "__VENV_NAME__" en su lugar. (Contribuido por Brett Cannon en
bpo-37663.)


xml
---

Los caracteres de espacio en blanco dentro de los atributos ahora se
conservan al serializar "xml.etree.ElementTree" en un archivo XML. Los
EOLN ya no se normalizan a "n". Este es el resultado de la discusión
sobre cómo interpretar la sección 2.11 de la especificación XML.
(Contribuido por Mefistotelis en bpo-39011.)


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

* Optimización del idioma para la asignación de una variable temporal
  en las comprensiones. Ahora "for y in [expr]" en comprensiones es
  tan rápido como una simple asignación "y = expr". Por ejemplo:

     sumas = [s para s en [0] para x en datos para s en [s + x]]

  A diferencia del operador ":=", este idioma no filtra una variable
  al alcance externo.

  (Contribuido por Serhiy Storchaka en bpo-32856.)

* Manejo de señal optimizado en aplicaciones multiproceso. Si un
  subproceso diferente al subproceso principal recibe una señal, el
  bucle de evaluación del código de bytes ya no se interrumpe en cada
  instrucción de código de bytes para verificar si hay señales
  pendientes que no se pueden manejar. Solo el hilo principal del
  intérprete principal puede manejar señales.

  Anteriormente, el ciclo de evaluación del código de bytes se
  interrumpía en cada instrucción hasta que el hilo principal manejaba
  las señales. (Contribuido por Victor Stinner en bpo-40010.)

* Optimicé el módulo "subprocess" en FreeBSD usando "closefrom()".
  (Contribuido por Ed Maste, Conrad Meyer, Kyle Evans, Kubilay Kocak y
  Victor Stinner en bpo-38061.)

* "PyLong_FromDouble()" is now up to 1.87x faster for values that fit
  into "long". (Contributed by Sergey Fedoseev in bpo-37986.)

* Varias incorporaciones de Python ("range", "tuple", "set",
  "frozenset", "list", "dict") ahora se aceleran mediante el protocolo
  de llamada vectorial **PEP 590**. (Contribuido por Dong-hee Na, Mark
  Shannon, Jeroen Demeyer y Petr Viktorin en bpo-37207.)

* "difference_update()" optimizado para el caso en el que el otro
  conjunto es mucho más grande que el conjunto base. (Sugerido por
  Evgeny Kapun con código aportado por Michele Orrù en bpo-8425.)

* El asignador de objetos pequeños de Python ("obmalloc.c") ahora
  permite (no más de) que una arena vacía permanezca disponible para
  su reutilización inmediata, sin devolverla al sistema operativo.
  Esto evita la paliza en bucles simples donde una arena podría
  crearse y destruirse de nuevo en cada iteración. (Contribuido por
  Tim Peters en bpo-37257.)

* *floor division* de operación flotante ahora tiene un mejor
  rendimiento. También se actualiza el mensaje de "ZeroDivisionError"
  para esta operación. (Contribuido por Dong-hee Na en bpo-39434.)

* La decodificación de cadenas cortas ASCII con códecs UTF-8 y ascii
  ahora es aproximadamente un 15% más rápida. (Contribuido por Inada
  Naoki en bpo-37348.)

A continuación, se muestra un resumen de las mejoras de rendimiento
desde Python 3.4 hasta Python 3.9:

   Python version                       3.4     3.5     3.6     3.7     3.8    3.9
   --------------                       ---     ---     ---     ---     ---    ---

   Variable and attribute read access:
       read_local                       7.1     7.1     5.4     5.1     3.9    3.9
       read_nonlocal                    7.1     8.1     5.8     5.4     4.4    4.5
       read_global                     15.5    19.0    14.3    13.6     7.6    7.8
       read_builtin                    21.1    21.6    18.5    19.0     7.5    7.8
       read_classvar_from_class        25.6    26.5    20.7    19.5    18.4   17.9
       read_classvar_from_instance     22.8    23.5    18.8    17.1    16.4   16.9
       read_instancevar                32.4    33.1    28.0    26.3    25.4   25.3
       read_instancevar_slots          27.8    31.3    20.8    20.8    20.2   20.5
       read_namedtuple                 73.8    57.5    45.0    46.8    18.4   18.7
       read_boundmethod                37.6    37.9    29.6    26.9    27.7   41.1

   Variable and attribute write access:
       write_local                      8.7     9.3     5.5     5.3     4.3    4.3
       write_nonlocal                  10.5    11.1     5.6     5.5     4.7    4.8
       write_global                    19.7    21.2    18.0    18.0    15.8   16.7
       write_classvar                  92.9    96.0   104.6   102.1    39.2   39.8
       write_instancevar               44.6    45.8    40.0    38.9    35.5   37.4
       write_instancevar_slots         35.6    36.1    27.3    26.6    25.7   25.8

   Data structure read access:
       read_list                       24.2    24.5    20.8    20.8    19.0   19.5
       read_deque                      24.7    25.5    20.2    20.6    19.8   20.2
       read_dict                       24.3    25.7    22.3    23.0    21.0   22.4
       read_strdict                    22.6    24.3    19.5    21.2    18.9   21.5

   Data structure write access:
       write_list                      27.1    28.5    22.5    21.6    20.0   20.0
       write_deque                     28.7    30.1    22.7    21.8    23.5   21.7
       write_dict                      31.4    33.3    29.3    29.2    24.7   25.4
       write_strdict                   28.4    29.9    27.5    25.2    23.1   24.5

   Stack (or queue) operations:
       list_append_pop                 93.4   112.7    75.4    74.2    50.8   50.6
       deque_append_pop                43.5    57.0    49.4    49.2    42.5   44.2
       deque_append_popleft            43.7    57.3    49.7    49.7    42.8   46.4

   Timing loop:
       loop_overhead                    0.5     0.6     0.4     0.3     0.3    0.3

Estos resultados se generaron a partir del script de referencia de
acceso variable en: "Tools/scripts/var_access_benchmark.py". El script
de referencia muestra tiempos en nanosegundos. Los puntos de
referencia se midieron en un Intel® Core™ i7-4960HQ processor que
ejecuta las compilaciones de macOS de 64 bits que se encuentran en
python.org.


Obsoleto
========

* El comando distutils "bdist_msi" ahora está en desuso, use
  "bdist_wheel" (paquetes de ruedas) en su lugar. (Contribuido por
  Hugo van Kemenade en bpo-39586.)

* Actualmente, "math.factorial()" acepta instancias de "float" con
  valores enteros no negativos (como "5.0"). Sube un "ValueError" para
  flotadores no integrales y negativos. Ahora está en desuso. En
  futuras versiones de Python, lanzará un "TypeError" para todos los
  flotadores. (Contribuido por Serhiy Storchaka en bpo-37315.)

* Los módulos "parser" y "symbol" están obsoletos y se eliminarán en
  futuras versiones de Python. Para la mayoría de los casos de uso,
  los usuarios pueden aprovechar la etapa de generación y compilación
  del árbol de sintaxis abstracta (AST), utilizando el módulo "ast".

* Las funciones de la API pública de C
  "PyParser_SimpleParseStringFlags()",
  "PyParser_SimpleParseStringFlagsFilename()",
  "PyParser_SimpleParseFileFlags()" y "PyNode_Compile()" están en
  desuso y se eliminarán en Python 3.10 junto con el analizador
  anterior.

* El uso de "NotImplemented" en un contexto booleano ha quedado
  obsoleto, ya que es casi exclusivamente el resultado de
  implementaciones incorrectas de comparadores ricos. Se convertirá en
  "TypeError" en una versión futura de Python. (Contribuido por Josh
  Rosenberg en bpo-35712.)

* El módulo "random" actualmente acepta cualquier tipo hash como
  posible valor semilla. Desafortunadamente, no se garantiza que
  algunos de esos tipos tengan un valor hash determinista. Después de
  Python 3.9, el módulo restringirá sus semillas a "None", "int",
  "float", "str", "bytes" y "bytearray".

* Abrir el archivo "GzipFile" para escritura sin especificar el
  argumento *mode* argument is deprecated.  In future Python versions
  it will always be opened for reading by default.  Specify the *mode*
  para abrirlo para escribir y silenciar una advertencia. (Contribuido
  por Serhiy Storchaka en bpo-28286.)

* En desuso el `` split () `` method of "_tkinter.TkappType" en favor
  del método "splitlist()" que tiene un comportamiento más consistente
  y predecible. (Contribuido por Serhiy Storchaka en bpo-38371.)

* El paso explícito de objetos de rutina a "asyncio.wait()" ha quedado
  obsoleto y se eliminará en la versión 3.11. (Contribuido por Yury
  Selivanov y Kyle Stanley en bpo-34790.)

* Los estándares binhex4 y hexbin4 ahora están en desuso. El módulo
  "binhex" y las siguientes funciones "binascii" ahora están en
  desuso:

  * "b2a_hqx()", "a2b_hqx()"

  * "rlecode_hqx()", "rledecode_hqx()"

  (Contribuido por Victor Stinner en bpo-39353.)

* Las clases "ast" "slice", "Index" y "ExtSlice" se consideran
  obsoletas y se eliminarán en futuras versiones de Python. El propio
  "value" debe utilizarse en lugar de "Index(value)". Se debe utilizar
  "Tuple(slices, Load())" en lugar de "ExtSlice(slices)". (Contribuido
  por Serhiy Storchaka en bpo-34822.)

* Las clases "ast" "Suite", "Param", "AugLoad" y "AugStore" se
  consideran obsoletas y se eliminarán en futuras versiones de Python.
  No fueron generados por el analizador y no aceptados por el
  generador de código en Python 3. (Contribuido por Batuhan Taskaya en
  bpo-39639 y bpo-39969 y Serhiy Storchaka en bpo-39988).

* Las funciones "PyEval_InitThreads()" y "PyEval_ThreadsInitialized()"
  ahora están en desuso y se eliminarán en Python 3.11. Llamar a
  "PyEval_InitThreads()" ahora no hace nada. *GIL* es inicializado por
  "Py_Initialize()" desde Python 3.7. (Contribuido por Victor Stinner
  en bpo-39877.)

* Pasar "None" como primer argumento a la función "shlex.split()" ha
  quedado obsoleto. (Contribuido por Zackery Spytz en bpo-33262.)

* "smtpd.MailmanProxy()" ahora está en desuso porque no se puede
  utilizar sin un módulo externo, "mailman". (Contribuido por Samuel
  Colvin en bpo-35800.)

* El módulo "lib2to3" ahora emite un "PendingDeprecationWarning".
  Python 3.9 cambió a un analizador PEG (consulte **PEP 617**), y
  Python 3.10 puede incluir una nueva sintaxis de lenguaje que no es
  analizable por el analizador LL (1) de lib2to3. El módulo "lib2to3"
  puede eliminarse de la biblioteca estándar en una versión futura de
  Python. Considere alternativas de terceros como LibCST o parso.
  (Contribuido por Carl Meyer en bpo-40360.)

* El parámetro *random* de "random.shuffle()" ha quedado obsoleto.
  (Contribuido por Raymond Hettinger en bpo-40465)


Remoto
======

* Se ha eliminado la versión errónea en "unittest.mock.__version__".

* "nntplib.NNTP": Se han eliminado los métodos "xpath()" y
  "xgtitle()". Estos métodos están obsoletos desde Python 3.3.
  Generalmente, estas extensiones no son compatibles o no están
  habilitadas por los administradores del servidor NNTP. Para
  "xgtitle()", utilice "nntplib.NNTP.descriptions()" o
  "nntplib.NNTP.description()" en su lugar. (Contribuido por Dong-hee
  Na en bpo-39366.)

* "array.array": Se han eliminado los métodos "tostring()" y
  "fromstring()". Eran alias de "tobytes()" y "frombytes()", obsoletos
  desde Python 3.2. (Contribuido por Victor Stinner en bpo-38916.)

* Se ha eliminado la función "sys.callstats()" sin documentar. Desde
  Python 3.7, quedó obsoleto y siempre devolvió "None". Requería una
  opción de compilación especial "CALL_PROFILE" que ya se eliminó en
  Python 3.7. (Contribuido por Victor Stinner en bpo-37414.)

* Se han eliminado las funciones "sys.getcheckinterval()" y
  "sys.setcheckinterval()". Fueron obsoletos desde Python 3.2. Utilice
  "sys.getswitchinterval()" y "sys.setswitchinterval()" en su lugar.
  (Contribuido por Victor Stinner en bpo-37392.)

* Se ha eliminado la función C "PyImport_Cleanup()". Se documentó
  como: "Vacíe la tabla del módulo. Solo para uso interno".
  (Contribuido por Victor Stinner en bpo-36710.)

* Se han eliminado los módulos "_dummy_thread" y "dummy_threading".
  Estos módulos quedaron obsoletos desde Python 3.7, que requiere
  compatibilidad con subprocesos. (Contribuido por Victor Stinner en
  bpo-37312.)

* Se han eliminado el alias de "aifc.openfp()" a "aifc.open()", el
  alias de "sunau.openfp()" a "sunau.open()" y el alias de
  "wave.openfp()" a "wave.open()". Fueron obsoletos desde Python 3.7.
  (Contribuido por Victor Stinner en bpo-37320.)

* Se ha eliminado el método "isAlive()" de "threading.Thread". Quedó
  en desuso desde Python 3.8. Utilice "is_alive()" en su lugar.
  (Contribuido por Dong-hee Na en bpo-37804.)

* Se han eliminado los métodos "getchildren()" y "getiterator()" de
  las clases "ElementTree" y "Element" en el módulo "ElementTree".
  Fueron obsoletos en Python 3.2. Utilice "iter(x)" o "list(x)" en
  lugar de "x.getchildren()" y "x.iter()" o "list(x.iter())" en lugar
  de "x.getiterator()". (Contribuido por Serhiy Storchaka en
  bpo-36543.)

* Se eliminó la antigua API "plistlib", quedó en desuso desde Python
  3.4. Utilice las funciones "load()", "loads()", "dump()" y
  "dumps()". Además, se eliminó el parámetro *use_builtin_types*; en
  su lugar, siempre se utilizan objetos "bytes" estándar. (Contribuido
  por Jon Janzen en bpo-36409.)

* Se ha eliminado la función C "PyGen_NeedsFinalizing". No se
  documentó, probó ni usó en ningún lugar dentro de CPython después de
  la implementación de **PEP 442**. Parche de Joannah Nanjekye.
  (Contribuido por Joannah Nanjekye en bpo-15088)

* "base64.encodestring()" y "base64.decodestring()", los alias
  obsoletos desde Python 3.1, se han eliminado: utilice
  "base64.encodebytes()" y "base64.decodebytes()" en su lugar.
  (Contribuido por Victor Stinner en bpo-39351.)

* La función "fractions.gcd()" se ha eliminado, está obsoleta desde
  Python 3.5 (bpo-22486): utilice "math.gcd()" en su lugar.
  (Contribuido por Victor Stinner en bpo-39350.)

* Se ha eliminado el parámetro *buffering* de "bz2.BZ2File". Desde
  Python 3.0, se ignoró y su uso emitió un "DeprecationWarning". Pase
  un objeto de archivo abierto para controlar cómo se abre el archivo.
  (Contribuido por Victor Stinner en bpo-39357.)

* Se ha eliminado el parámetro *encoding* de "json.loads()". A partir
  de Python 3.1, fue obsoleto e ignorado; su uso ha emitido un
  "DeprecationWarning" desde Python 3.8. (Contribuido por Inada Naoki
  en bpo-39377)

* Las declaraciones "with (await asyncio.lock):" y "with (yield from
  asyncio.lock):" ya no son compatibles, utilice "async with lock" en
  su lugar. Lo mismo es correcto para "asyncio.Condition" y
  "asyncio.Semaphore". (Contribuido por Andrew Svetlov en bpo-34793.)

* Se han eliminado la función "sys.getcounts()", la opción de línea de
  comando "-X showalloccount" y el campo "show_alloc_count" de la
  estructura C "PyConfig". Necesitaban una compilación especial de
  Python definiendo la macro "COUNT_ALLOCS". (Contribuido por Victor
  Stinner en bpo-39489.)

* Se ha eliminado el atributo "_field_types" de la clase
  "typing.NamedTuple". Quedó en desuso desde Python 3.8. En su lugar,
  utilice el atributo "__annotations__". (Contribuido por Serhiy
  Storchaka en bpo-40182.)

* Se ha eliminado el método "symtable.SymbolTable.has_exec()". Quedó
  en desuso desde 2006 y solo devuelve "False" cuando se llama.
  (Contribuido por Batuhan Taskaya en bpo-40208)

* Se han eliminado "asyncio.Task.current_task()" y
  "asyncio.Task.all_tasks()". Fueron obsoletos desde Python 3.7 y
  puede usar "asyncio.current_task()" y "asyncio.all_tasks()" en su
  lugar. (Contribución de Rémi Lapeyre en bpo-40967)

* El método "unescape()" en la clase "html.parser.HTMLParser" se ha
  eliminado (quedó obsoleto desde Python 3.4). "html.unescape()" debe
  usarse para convertir referencias de caracteres a los caracteres
  Unicode correspondientes.


Portar a Python 3.9
===================

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


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

* "__import__()" y "importlib.util.resolve_name()" ahora lanzan
  "ImportError" donde anteriormente lanzaban "ValueError". Las
  personas que llaman que detectan el tipo de excepción específico y
  son compatibles con Python 3.9 y versiones anteriores deberán
  detectar ambas usando "except (ImportError, ValueError):".

* Los scripts de activación de "venv" ya no son casos especiales
  cuando "__VENV_PROMPT__" se establece en """".

* El método "select.epoll.unregister()" ya no ignora el error "EBADF".
  (Contribuido por Victor Stinner en bpo-39239.)

* Se ha eliminado el parámetro *compresslevel* "bz2.BZ2File" se
  convirtió solo en un parámetro de llave, ya que *buffering* se
  quitó. (Contribuido por Victor Stinner en bpo-39357.)

* AST simplificado para suscripción. Los índices simples se
  representarán por su valor, los segmentos extendidos se
  representarán como tuplas. "Index(value)" devolverá un "value" en sí
  mismo, "ExtSlice(slices)" devolverá "Tuple(slices, Load())".
  (Contribuido por Serhiy Storchaka en bpo-34822.)

* El módulo "importlib" ahora ignora la variable de entorno
  "PYTHONCASEOK" cuando se utilizan las opciones de línea de comando
  "-E" o "-I".

* El parámetro *encoding* se ha agregado a las clases "ftplib.FTP" y
  "ftplib.FTP_TLS" como un parámetro de solo palabra clave, y la
  codificación predeterminada se cambia de Latin-1 a UTF-8 para
  seguir: rfc: *2640*.

* "asyncio.loop.shutdown_default_executor()" se ha agregado a
  "AbstractEventLoop", lo que significa que los bucles de eventos
  alternativos que heredan de él deben tener definido este método.
  (Contribuido por Kyle Stanley en bpo-34037.)

* Los valores constantes de los indicadores futuros en el módulo
  "__future__" se actualizan para evitar la colisión con los
  indicadores del compilador. Anteriormente,
  "PyCF_ALLOW_TOP_LEVEL_AWAIT" chocaba con "CO_FUTURE_DIVISION".
  (Contribuido por Batuhan Taskaya en bpo-39562)

* "array('u')" ahora usa "wchar_t" como tipo C en lugar de
  "Py_UNICODE". Este cambio no afecta su comportamiento porque
  "Py_UNICODE" es alias de "wchar_t" desde Python 3.3. (Contribuido
  por Inada Naoki en bpo-34538.)

* La API "logging.getLogger()" ahora devuelve el registrador raíz
  cuando se le pasó el nombre "'root'", mientras que anteriormente
  devolvía un registrador no raíz llamado "'root'". Esto podría
  afectar los casos en los que el código de usuario desea
  explícitamente un registrador no root llamado "'root'", o crea una
  instancia de un registrador usando "logging.getLogger(__name__)" en
  algún módulo de nivel superior llamado "'root.py'". (Contribuido por
  Vinay Sajip en bpo-37742.)

* El manejo de división de "PurePath" ahora devuelve "NotImplemented"
  en lugar de lanzar un "TypeError" cuando se pasa algo que no sea una
  instancia de "str" o "PurePath". Esto permite crear clases
  compatibles que no hereden de esos tipos mencionados. (Contribución
  de Roger Aiudi en bpo-34775).

* A partir de Python 3.9.5, el módulo "ipaddress" ya no acepta ceros a
  la izquierda en las cadenas de direcciones IPv4. Los ceros iniciales
  son ambiguos y algunas bibliotecas los interpretan como notación
  octal. Por ejemplo, la función heredada "socket.inet_aton()" trata
  los ceros iniciales como una notación octal. La implementación glibc
  del "inet_pton()" moderno no acepta ceros a la izquierda.
  (Contribuido por Christian Heimes en bpo-36384).

* "codecs.lookup()" ahora normaliza el nombre de codificación de la
  misma manera que "encodings.normalize_encoding()", excepto que
  "codecs.lookup()" también convierte el nombre a minúsculas. Por
  ejemplo, el nombre de codificación ""latex+latin1"" ahora está
  normalizado a ""latex_latin1"". (Contribuido por Jordon Xu en
  bpo-37751.)


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

* Las instancias de heap-allocated types (como las creadas con
  "PyType_FromSpec()" y API similares) contienen una referencia a su
  objeto de tipo desde Python 3.8. Como se indica en los "Cambios en
  la API C" de Python 3.8, para la gran mayoría de los casos, no
  debería haber efectos secundarios, pero para los tipos que tienen
  una función personalizada "tp_traverse", asegúrese de que todas las
  funciones "tp_traverse" personalizadas de los tipos asignados al
  montón visitan el tipo del objeto.

     Ejemplo:

        int
        foo_traverse(foo_struct *self, visitproc visit, void *arg) {
        // Rest of the traverse function
        #if PY_VERSION_HEX >= 0x03090000
            // This was not needed before Python 3.9 (Python issue 35810 and 40217)
            Py_VISIT(Py_TYPE(self));
        #endif
        }

  Si su función transversal delega en "tp_traverse" de su clase base
  (u otro tipo), asegúrese de que "Py_TYPE(self)" se visite solo una
  vez. Tenga en cuenta que solo se espera que heap type visite el tipo
  en "tp_traverse".

     Por ejemplo, si su función "tp_traverse" incluye:

        base->tp_traverse(self, visit, arg)

     Luego añade:

        #if PY_VERSION_HEX >= 0x03090000
            // This was not needed before Python 3.9 (bpo-35810 and bpo-40217)
            if (base->tp_flags & Py_TPFLAGS_HEAPTYPE) {
                // a heap type's tp_traverse already visited Py_TYPE(self)
            } else {
                Py_VISIT(Py_TYPE(self));
            }
        #else

  (Consulte bpo-35810 y bpo-40217 para obtener más información).

* Las funciones "PyEval_CallObject", "PyEval_CallFunction",
  "PyEval_CallMethod" y "PyEval_CallObjectWithKeywords" están en
  desuso. Utilice "PyObject_Call()" y sus variantes en su lugar. (Ver
  más detalles en bpo-29548.)


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

* Se agregó el código de operación "LOAD_ASSERTION_ERROR" para manejar
  la declaración "assert". Anteriormente, la declaración de aserción
  no funcionaría correctamente si la excepción "AssertionError"
  estuviera siendo sombreada. (Contribuido por Zackery Spytz en
  bpo-34880.)

* El código de operación "COMPARE_OP" se dividió en cuatro
  instrucciones distintas:

  * "COMPARE_OP" para comparaciones enriquecidas

  * "IS_OP" para pruebas 'es' y 'no es'

  * "CONTAINS_OP" para pruebas 'in' y 'not in'

  * "JUMP_IF_NOT_EXC_MATCH" para verificar las excepciones en las
    declaraciones 'try-except'.

  (Contribuido por Mark Shannon en bpo-39156.)


Construir cambios
=================

* Se agregó la opción "--with-platlibdir" al script "configure":
  nombre del directorio de biblioteca específico de la plataforma,
  almacenado en el nuevo atributo "sys.platlibdir". Consulte el
  atributo "sys.platlibdir" para obtener más información. (Contribuido
  por Jan Matějek, Matěj Cepl, Charalampos Stratakis y Victor Stinner
  en bpo-1294959.)

* Se ha eliminado la macro de compilación especial "COUNT_ALLOCS".
  (Contribuido por Victor Stinner en bpo-39489.)

* En plataformas que no son de Windows, ahora se requieren las
  funciones "setenv()" y "unsetenv()" para compilar Python.
  (Contribuido por Victor Stinner en bpo-39395.)

* En plataformas que no son de Windows, la creación de instaladores
  "bdist_wininst" ahora no es compatible oficialmente. (Consulte
  bpo-10945 para obtener más detalles).

* Al compilar Python en macOS desde la fuente, "_tkinter" ahora se
  vincula con marcos Tcl y Tk que no son del sistema si están
  instalados en "/Library/Frameworks", como había sido el caso en
  versiones anteriores de macOS. Si un SDK de macOS está configurado
  explícitamente, mediante "--enable-universalsdk" o "-isysroot", solo
  se busca en el SDK. El comportamiento predeterminado aún se puede
  anular con "--with-tcltk-includes" y "--with-tcltk-libs".
  (Contribuido por Ned Deily en bpo-34956.)

* Python ahora se puede construir para Windows 10 ARM64. (Contribuido
  por Steve Dower en bpo-33125.)

* Algunas pruebas individuales ahora se omiten cuando se usa "--pgo".
  Las pruebas en cuestión aumentaron significativamente el tiempo de
  la tarea PGO y probablemente no ayudaron a mejorar la optimización
  del ejecutable final. Esto acelera la tarea en un factor de
  aproximadamente 15 veces. La ejecución del conjunto de pruebas
  unitarias completo es lenta. Este cambio puede resultar en una
  compilación ligeramente menos optimizada ya que no se ejecutarán
  tantas ramas de código. Si está dispuesto a esperar la compilación
  mucho más lenta, el comportamiento anterior se puede restaurar
  usando "./configure [..] PROFILE_TASK="-m test --pgo-extended"". No
  garantizamos qué conjunto de tareas de PGO produce una compilación
  más rápida. Los usuarios interesados deben ejecutar sus propios
  puntos de referencia relevantes, ya que los resultados pueden
  depender del entorno, la carga de trabajo y la cadena de
  herramientas del compilador. (Consulte bpo-36044 y bpo-37707 para
  obtener más detalles).


Cambios en la API de C
======================


Nuevas características
----------------------

* **PEP 573**: Se agregó "PyType_FromModuleAndSpec()" para asociar un
  módulo con una clase; "PyType_GetModule()" y
  "PyType_GetModuleState()" para recuperar el módulo y su estado; y
  "PyCMethod" y "METH_METHOD" para permitir que un método acceda a la
  clase en la que se definió. (Contribuido por Marcel Plch y Petr
  Viktorin en bpo-38787.)

* Se agregó la función "PyFrame_GetCode()": obtenga un código de
  marco. Se agregó la función "PyFrame_GetBack()": obtenga el
  siguiente marco exterior del marco. (Contribuido por Victor Stinner
  en bpo-40421.)

* Se agregó "PyFrame_GetLineNumber()" a la API C limitada.
  (Contribuido por Victor Stinner en bpo-40421.)

* Se agregaron funciones "PyThreadState_GetInterpreter()" y
  "PyInterpreterState_Get()" para obtener el intérprete. Se agregó la
  función "PyThreadState_GetFrame()" para obtener el marco actual de
  un estado de subproceso de Python. Se agregó la función
  "PyThreadState_GetID()": obtenga el identificador único de un estado
  de subproceso de Python. (Contribuido por Victor Stinner en
  bpo-39947.)

* Se agregó una nueva función pública "PyObject_CallNoArgs()" a la API
  de C, que llama a un objeto de Python invocable sin ningún
  argumento. Es la forma más eficiente de llamar a un objeto de Python
  invocable sin ningún argumento. (Contribuido por Victor Stinner en
  bpo-37194.)

* Cambios en la API C limitada (si se define la macro
  "Py_LIMITED_API"):

  * Proporcione "Py_EnterRecursiveCall()" y "Py_LeaveRecursiveCall()"
    como funciones regulares para la API limitada. Anteriormente, se
    definían como macros, pero estas macros no se compilaban con la
    API C limitada que no puede acceder al campo
    "PyThreadState.recursion_depth" (la estructura es opaca en la API
    C limitada).

  * "PyObject_INIT()" y "PyObject_INIT_VAR()" se convierten en
    funciones "opacas" habituales para ocultar los detalles de la
    implementación.

  (Contribuido por Victor Stinner en bpo-38644 y bpo-39542.)

* Se agrega la función "PyModule_AddType()" para ayudar a agregar un
  tipo a un módulo. (Contribuido por Dong-hee Na en bpo-40024.)

* Se agregaron las funciones "PyObject_GC_IsTracked()" y
  "PyObject_GC_IsFinalized()" a la API pública para permitir consultar
  si los objetos de Python se están rastreando actualmente o si ya han
  sido finalizados por el recolector de basura, respectivamente.
  (Contribuido por Pablo Galindo Salgado en bpo-40241.)

* Se agregó "_PyObject_FunctionStr()" para obtener una representación
  de cadena fácil de usar de un objeto similar a una función. (Parche
  de Jeroen Demeyer en bpo-37645.)

* Se agregó "PyObject_CallOneArg()" para llamar a un objeto con un
  argumento posicional (parche de Jeroen Demeyer en bpo-37483).


Portar a Python 3.9
-------------------

* "PyInterpreterState.eval_frame" (**PEP 523**) ahora requiere un
  nuevo parámetro *tstate* obligatorio ("PyThreadState*").
  (Contribuido por Victor Stinner en bpo-38500.)

* Módulos de extensión: "m_traverse", "m_clear" y "m_free" Las
  funciones de "PyModuleDef" ya no se llaman si el estado del módulo
  era solicitado pero aún no asignado. Este es el caso inmediatamente
  después de que se crea el módulo y antes de que se ejecute (función
  "Py_mod_exec"). Más precisamente, estas funciones no se llaman si:
  c: member: *~ PyModuleDef.m_size* es mayor que 0 y el estado del
  módulo (como lo devuelve "PyModule_GetState()") es "NULL".

  Los módulos de extensión sin estado de módulo ("m_size <= 0") no se
  ven afectados.

* Si se llama a "Py_AddPendingCall()" en un subinterpretador, la
  función ahora está programada para ser llamada desde el
  subinterpretador, en lugar de ser llamada desde el intérprete
  principal. Cada subinterpretador ahora tiene su propia lista de
  llamadas programadas. (Contribuido por Victor Stinner en bpo-39984.)

* El registro de Windows ya no se usa para inicializar "sys.path"
  cuando se usa la opción "-E" (si "PyConfig.use_environment" está
  configurado en "0"). Esto es importante al incrustar Python en
  Windows. (Contribuido por Zackery Spytz en bpo-8901.)

* La variable global "PyStructSequence_UnnamedField" ahora es una
  constante y se refiere a una cadena constante. (Contribuido por
  Serhiy Storchaka en bpo-38650.)

* La estructura "PyGC_Head" ahora es opaca. Solo se define en la API C
  interna ("pycore_gc.h"). (Contribuido por Victor Stinner en
  bpo-40241.)

* "Py_UNICODE_COPY", "Py_UNICODE_FILL", "PyUnicode_WSTR_LENGTH",
  "PyUnicode_FromUnicode()", "PyUnicode_AsUnicode()",
  "_PyUnicode_AsUnicode" y "PyUnicode_AsUnicodeAndSize()" están
  marcados como obsoletos en C. Han sido obsoletos por **PEP 393**
  desde Python 3.3. (Contribuido por Inada Naoki en bpo-36346.)

* La función "Py_FatalError()" se reemplaza con una macro que registra
  automáticamente el nombre de la función actual, a menos que se
  defina la macro "Py_LIMITED_API". (Contribuido por Victor Stinner en
  bpo-39882.)

* El protocolo vectorcall ahora requiere que la persona que llama solo
  pase cadenas como nombres de palabras clave. (Consulte bpo-37540
  para obtener más información).

* Los detalles de implementación de una serie de macros y funciones
  ahora están ocultos:

  * La macro "PyObject_IS_GC()" se convirtió en una función.

  * La macro "PyObject_NEW()" se convierte en un alias de la macro
    "PyObject_New()" y la macro "PyObject_NEW_VAR()" se convierte en
    un alias de la macro "PyObject_NewVar()". Ya no acceden
    directamente al miembro "PyTypeObject.tp_basicsize".

  * La macro "PyObject_GET_WEAKREFS_LISTPTR()" se convirtió en una
    función: la macro accedió directamente al miembro
    "PyTypeObject.tp_weaklistoffset".

  * La macro "PyObject_CheckBuffer()" se convirtió en una función: la
    macro accedió directamente al miembro "PyTypeObject.tp_as_buffer".

  * "PyIndex_Check()" ahora siempre se declara como una función opaca
    para ocultar los detalles de implementación: se eliminó la macro
    "PyIndex_Check()". La macro accedió directamente al miembro
    "PyTypeObject.tp_as_number".

  (Consulte bpo-40170 para obtener más detalles).


Remoto
------

* Se excluyeron las macros "PyFPE_START_PROTECT()" y
  "PyFPE_END_PROTECT()" de "pyfpe.h" de la API C limitada.
  (Contribuido por Victor Stinner en bpo-38835.)

* Se ha eliminado la ranura "tp_print" de PyTypeObject. Se usó para
  imprimir objetos en archivos en Python 2.7 y antes. Desde Python
  3.0, se ha ignorado y no se ha utilizado. (Contribuido por Jeroen
  Demeyer en bpo-36974.)

* Cambios en la API C limitada (si se define la macro
  "Py_LIMITED_API"):

  * Se excluyeron las siguientes funciones de la API C limitada:

    * "PyThreadState_DeleteCurrent()" (Contribuido por Joannah
      Nanjekye en bpo-37878.)

    * "_Py_CheckRecursionLimit"

    * "_Py_NewReference()"

    * "_Py_ForgetReference()"

    * "_PyTraceMalloc_NewReference()"

    * "_Py_GetRefTotal()"

    * El mecanismo de papelera que nunca funcionó en la API C
      limitada.

    * "PyTrash_UNWIND_LEVEL"

    * "Py_TRASHCAN_BEGIN_CONDITION"

    * "Py_TRASHCAN_BEGIN"

    * "Py_TRASHCAN_END"

    * "Py_TRASHCAN_SAFE_BEGIN"

    * "Py_TRASHCAN_SAFE_END"

  * Se movieron las siguientes funciones y definiciones a la API de C
    interna:

    * "_PyDebug_PrintTotalRefs()"

    * "_Py_PrintReferences()"

    * "_Py_PrintReferenceAddresses()"

    * "_Py_tracemalloc_config"

    * "_Py_AddToAllObjects()" (específico para "Py_TRACE_REFS"
      acumulación)

  (Contribuido por Victor Stinner en bpo-38644 y bpo-39542.)

* Se eliminó el gancho "_PyRuntime.getframe" y se eliminó la macro
  "_PyThreadState_GetFrame", que era un alias de
  "_PyRuntime.getframe". Solo fueron expuestos por la API C interna.
  También se eliminó el tipo "PyThreadFrameGetter". (Contribuido por
  Victor Stinner en bpo-39946.)

* Se eliminaron las siguientes funciones de la API de C. Llame a
  "PyGC_Collect()" explícitamente para borrar todas las listas libres.
  (Contribuido por Inada Naoki y Victor Stinner en bpo-37340,
  bpo-38896 y bpo-40428.)

  * "PyAsyncGen_ClearFreeLists()"

  * "PyContext_ClearFreeList()"

  * "PyDict_ClearFreeList()"

  * "PyFloat_ClearFreeList()"

  * "PyFrame_ClearFreeList()"

  * "PyList_ClearFreeList()"

  * "PyMethod_ClearFreeList()" y "PyCFunction_ClearFreeList()": se han
    eliminado las listas libres de objetos de método enlazados.

  * "PySet_ClearFreeList()": la lista de conjuntos libres se ha
    eliminado en Python 3.4.

  * "PyTuple_ClearFreeList()"

  * "PyUnicode_ClearFreeList()": la lista libre de Unicode se ha
    eliminado en Python 3.3.

* Función "_PyUnicode_ClearStaticStrings()" eliminada. (Contribuido
  por Victor Stinner en bpo-39465.)

* Eliminado "Py_UNICODE_MATCH". Ha sido obsoleto por **PEP 393** y
  roto desde Python 3.3. En su lugar, se puede utilizar la función
  "PyUnicode_Tailmatch()". (Contribuido por Inada Naoki en bpo-36346.)

* Archivos de encabezado limpios de interfaces definidas pero sin
  implementación. Los símbolos API públicos que se eliminan son:
  "_PyBytes_InsertThousandsGroupingLocale",
  "_PyBytes_InsertThousandsGrouping", "_Py_InitializeFromArgs",
  "_Py_InitializeFromWideArgs", "_PyFloat_Repr", "_PyFloat_Digits",
  "_PyFloat_DigitsInit", "PyFrame_ExtendStack",
  "_PyAIterWrapper_Type", "PyNullImporter_Type", "PyCmpWrapper_Type",
  "PySortWrapper_Type", "PyNoArgsFunction". (Contribuido por Pablo
  Galindo Salgado en bpo-39372.)


Cambios notables en Python 3.9.1
================================


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

El comportamiento de "typing.Literal" se modificó para cumplir con
**PEP 586** y para coincidir con el comportamiento de los
verificadores de tipo estático especificados en el PEP.

1. "Literal" ahora elimina los parámetros duplicados.

2. Las comparaciones de igualdad entre objetos "Literal" ahora son
   independientes del orden.

3. Las comparaciones de "Literal" ahora respetan los tipos. Por
   ejemplo, "Literal[0] == Literal[False]" evaluado previamente como
   "True". Ahora es "False". Para respaldar este cambio, la caché de
   tipos utilizada internamente ahora admite tipos diferenciados.

4. Los objetos "Literal" ahora lanzarán una excepción "TypeError"
   durante las comparaciones de igualdad si alguno de sus parámetros
   no es *hashable*. Tenga en cuenta que declarar "Literal" con
   parámetros mutables no arrojará un error:

      >>> from typing import Literal
      >>> Literal[{0}]
      >>> Literal[{0}] == Literal[{False}]
      Traceback (most recent call last):
        File "<stdin>", line 1, in <module>
      TypeError: unhashable type: 'set'

(Contribuido por Yurii Karabas en bpo-42345.)


Compatibilidad con macOS 11.0 (Big Sur) y Apple Silicon Mac
-----------------------------------------------------------

A partir de 3.9.1, Python ahora es totalmente compatible con la
construcción y ejecución en macOS 11.0 (Big Sur) y en Apple Silicon
Macs (basado en la arquitectura "ARM64"). Una nueva variante de
compilación universal, "universal2", ahora está disponible para
admitir de forma nativa tanto "ARM64" como "Intel 64" en un conjunto
de ejecutables. Los binarios ahora también se pueden construir en
versiones actuales de macOS para ser implementados en una variedad de
versiones anteriores de macOS (probadas a 10.9) mientras hacen que
algunas funciones y opciones más nuevas del sistema operativo estén
disponibles condicionalmente según la versión del sistema operativo en
uso en tiempo de ejecución ("vinculación débil" ).

(Contribuido por Ronald Oussoren y Lawrence D'Anna en bpo-41100.)


Cambios notables en Python 3.9.2
================================


colecciones.abc
---------------

"collections.abc.Callable" genérico ahora aplana los parámetros de
tipo, similar a lo que hace actualmente "typing.Callable". Esto
significa que "collections.abc.Callable[[int, str], str]" tendrá
"__args__" de "(int, str, str)"; anteriormente esto era "([int, str],
str)". Para permitir este cambio, "types.GenericAlias" ahora puede ser
subclasificado, y se devolverá una subclase al subíndice el tipo
"collections.abc.Callable". El código que accede a los argumentos a
través de "typing.get_args()" o "__args__" debe tener en cuenta este
cambio. Se puede emitir un "DeprecationWarning" para formas no válidas
de parametrizar "collections.abc.Callable" que pueden haber pasado
silenciosamente en Python 3.9.1. Este "DeprecationWarning" se
convertirá en un "TypeError" en Python 3.10. (Contribuido por Ken Jin
en bpo-42195.)


urllib.parse
------------

Las versiones anteriores de Python permitían el uso de ";" y "&" como
separadores de parámetros de consulta en "urllib.parse.parse_qs()" y
"urllib.parse.parse_qsl()". Debido a problemas de seguridad y para
cumplir con las recomendaciones más recientes del W3C, esto se ha
cambiado para permitir solo una clave separadora, con "&" como
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.)
