Qué hay de nuevo en Python 3.11¶

PEP 657: Ubicaciones de errores detallados en rastreos¶

Al imprimir rastreos, el intérprete ahora señalará la expresión exacta que causó el error, en lugar de solo la línea. Por ejemplo:

Traceback (most recent call last):
  File "distance.py", line 11, in <module>
    print(manhattan_distance(p1, p2))
          ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "distance.py", line 6, in manhattan_distance
    return abs(point_1.x - point_2.x) + abs(point_1.y - point_2.y)
                           ^^^^^^^^^
AttributeError: 'NoneType' object has no attribute 'x'

Las versiones anteriores del intérprete apuntaban solo a la línea, por lo que resultaba ambiguo qué objeto era None. Estos errores mejorados también pueden ser útiles cuando se trata de objetos dict profundamente anidados y múltiples llamadas a funciones:

Traceback (most recent call last):
  File "query.py", line 37, in <module>
    magic_arithmetic('foo')
  File "query.py", line 18, in magic_arithmetic
    return add_counts(x) / 25
           ^^^^^^^^^^^^^
  File "query.py", line 24, in add_counts
    return 25 + query_user(user1) + query_user(user2)
                ^^^^^^^^^^^^^^^^^
  File "query.py", line 32, in query_user
    return 1 + query_count(db, response['a']['b']['c']['user'], retry=True)
                               ~~~~~~~~~~~~~~~~~~^^^^^
TypeError: 'NoneType' object is not subscriptable

Además de expresiones aritméticas complejas:

Traceback (most recent call last):
  File "calculation.py", line 54, in <module>
    result = (x / y / z) * (a / b / c)
              ~~~~~~^~~
ZeroDivisionError: division by zero

Además, la información utilizada por la función de rastreo mejorada está disponible a través de una API general, que se puede usar para correlacionar bytecode instructions con la ubicación del código fuente. Esta información se puede recuperar usando:

• El método codeobject.co_positions() en Python.

• La función PyCode_Addr2Location() en la API de C.

Ver PEP 657 para más detalles. (Aportado por Pablo Galindo, Batuhan Taskaya y Ammar Askar en bpo-43950.)

PEP 654: Grupos de excepción y except*¶

PEP 654 presenta funciones de lenguaje que permiten que un programa genere y maneje múltiples excepciones no relacionadas simultáneamente. Los tipos integrados ExceptionGroup y BaseExceptionGroup permiten agrupar excepciones y generarlas juntas, y la nueva sintaxis except* generaliza except para hacer coincidir subgrupos de grupos de excepciones.

Ver PEP 654 para más detalles.

(Aportado por Irit Katriel en bpo-45292. PEP escrito por Irit Katriel, Yury Selivanov y Guido van Rossum.)

PEP 678: Las excepciones se pueden enriquecer con notas¶

El método add_note() se agrega a BaseException. Se puede utilizar para enriquecer las excepciones con información de contexto que no está disponible en el momento en que se genera la excepción. Las notas añadidas aparecen en el rastreo predeterminado.

Ver PEP 678 para más detalles.

(Aportado por Irit Katriel en bpo-45607. PEP escrito por Zac Hatfield-Dodds).

Mejoras en el iniciador de Windows py.exe¶

La copia del Python install manager incluida con Python 3.11 se ha actualizado significativamente. Ahora admite la sintaxis de empresa/etiqueta tal como se define en PEP 514 usando el argumento -V:<company>/<tag> en lugar del limitado -<major>.< menor>. Esto permite iniciar distribuciones distintas a PythonCore, la alojada en python.org.

Al usar los selectores -V:, se puede omitir la empresa o la etiqueta, pero se buscarán todas las instalaciones. Por ejemplo, -V:OtherPython/ seleccionará la «mejor» etiqueta registrada para OtherPython, mientras que -V:3.11 o -V:/3.11 seleccionarán la «mejor» distribución con la etiqueta 3.11.

Cuando se utilizan los argumentos obsoletos -<principal>, -<principal>.<menor>, -<principal>-<bitness> ` o :samp:-{<principal>}.{<menor>}-{<bitness>}`, se debe conservar todo el comportamiento existente de las versiones anteriores y solo se seleccionarán las versiones de PythonCore. Sin embargo, el sufijo -64 ahora implica «no de 32 bits» (no necesariamente x86-64), ya que existen múltiples plataformas de 64 bits compatibles. Los tiempos de ejecución de 32 bits se detectan comprobando la etiqueta del tiempo de ejecución en busca de un sufijo -32. Todas las versiones de Python desde la 3.5 han incluido esto en sus versiones de 32 bits.

PEP 646: Genéricos Variádicos¶

PEP 484 introdujo anteriormente TypeVar, lo que permite la creación de genéricos parametrizados con un solo tipo. PEP 646 añade TypeVarTuple, permitiendo la parametrización con un número de tipos arbitrary. En otras palabras, un TypeVarTuple es una variable de tipo variadic que permite los genéricos variadic.

Esto permite una amplia variedad de casos de uso. En particular, permite parametrizar con el arreglo shape el tipo de estructuras similares a arreglos en bibliotecas de computación numérica como NumPy y TensorFlow. Los verificadores de tipo estático ahora podrán detectar errores relacionados con la forma en el código que usa estas bibliotecas.

Ver PEP 646 para más detalles.

(Contribuido por Matthew Rahtz en bpo-43224, con contribuciones de Serhiy Storchaka y Jelle Zijlstra. PEP escrito por Mark Mendoza, Matthew Rahtz, Pradeep Kumar Srinivasan y Vincent Siles).

PEP 655: Marcado de elementos TypedDict individuales como requeridos o no requeridos¶

Required y NotRequired proporcionan una forma sencilla de marcar si deben estar presentes elementos individuales en un TypedDict. Anteriormente, esto solo era posible mediante la herencia.

Todos los campos siguen siendo obligatorios de forma predeterminada, a menos que el parámetro total se establezca en False, en cuyo caso todos los campos siguen sin ser obligatorios de forma predeterminada. Por ejemplo, lo siguiente especifica un TypedDict con una clave requerida y una no requerida:

class Movie(TypedDict):
   title: str
   year: NotRequired[int]

m1: Movie = {"title": "Black Panther", "year": 2018}  # OK
m2: Movie = {"title": "Star Wars"}  # OK (year is not required)
m3: Movie = {"year": 2022}  # ERROR (missing required field title)

La siguiente definición es equivalente:

class Movie(TypedDict, total=False):
   title: Required[str]
   year: int

Ver PEP 655 para más detalles.

(Aportado por David Foster y Jelle Zijlstra en bpo-47087. PEP escrito por David Foster).

PEP 673: tipo Self¶

La nueva anotación Self proporciona una forma sencilla e intuitiva de anotar métodos que devuelven una instancia de su clase. Se comporta igual que el enfoque specified in PEP 484 basado en TypeVar, pero es más conciso y más fácil de seguir.

Los casos de uso comunes incluyen constructores alternativos proporcionados como classmethods y métodos __enter__() que devuelven self:

class MyLock:
    def __enter__(self) -> Self:
        self.lock()
        return self

    ...

class MyInt:
    @classmethod
    def fromhex(cls, s: str) -> Self:
        return cls(int(s, 16))

    ...

Self también se puede usar para anotar parámetros de método o atributos del mismo tipo que su clase envolvente.

Ver PEP 673 para más detalles.

(Aportado por James Hilton-Balfe en bpo-46534. PEP escrito por Pradeep Kumar Srinivasan y James Hilton-Balfe).

PEP 675: tipo de cadena literal arbitraria¶

La nueva anotación LiteralString se puede usar para indicar que un parámetro de función puede ser de cualquier tipo de cadena literal. Esto permite que una función acepte tipos de cadenas literales arbitrarias, así como cadenas creadas a partir de otras cadenas literales. Los verificadores de tipos pueden hacer cumplir que las funciones confidenciales, como las que ejecutan declaraciones SQL o comandos de shell, se llamen solo con argumentos estáticos, lo que brinda protección contra ataques de inyección.

Por ejemplo, una función de consulta SQL podría anotarse de la siguiente manera:

def run_query(sql: LiteralString) -> ...
    ...

def caller(
    arbitrary_string: str,
    query_string: LiteralString,
    table_name: LiteralString,
) -> None:
    run_query("SELECT * FROM students")       # ok
    run_query(query_string)                   # ok
    run_query("SELECT * FROM " + table_name)  # ok
    run_query(arbitrary_string)               # type checker error
    run_query(                                # type checker error
        f"SELECT * FROM students WHERE name = {arbitrary_string}"
    )

Ver PEP 675 para más detalles.

(Aportado por Jelle Zijlstra en bpo-47088. PEP escrito por Pradeep Kumar Srinivasan y Graham Bleaney).

PEP 681: Transformaciones de clases de datos¶

dataclass_transform se puede usar para decorar una clase, una metaclase o una función que en sí misma es un decorador. La presencia de @dataclass_transform() le dice a un verificador de tipo estático que el objeto decorado realiza una «magia» en tiempo de ejecución que transforma una clase, dándole comportamientos similares a dataclass.

Por ejemplo:

# The create_model decorator is defined by a library.
@typing.dataclass_transform()
def create_model(cls: Type[T]) -> Type[T]:
    cls.__init__ = ...
    cls.__eq__ = ...
    cls.__ne__ = ...
    return cls

# The create_model decorator can now be used to create new model classes:
@create_model
class CustomerModel:
    id: int
    name: str

c = CustomerModel(id=327, name="Eric Idle")

Ver PEP 681 para más detalles.

(Aportado por Jelle Zijlstra en gh-91860. PEP escrito por Erik De Bonte y Eric Traut.)

PEP 563 puede no ser el futuro¶

PEP 563 Evaluación pospuesta de anotaciones (from __future__ import annotations future statement) que originalmente se planeó para su lanzamiento en Python 3.10 se suspendió indefinidamente. Consulte this message from the Steering Council para obtener más información.

asíncio¶

• Se agregó la clase TaskGroup, un asynchronous context manager que contiene un grupo de tareas que las esperará a todas al salir. Para código nuevo, se recomienda usar create_task() y gather() directamente. (Aportado por Yury Selivanov y otros en gh-90908.)

• Se agregó timeout(), un administrador de contexto asíncrono para establecer un tiempo de espera en operaciones asíncronas. Para código nuevo, se recomienda usar wait_for() directamente. (Aportado por Andrew Svetlov en gh-90927.)

• Se agregó la clase Runner, que expone la maquinaria utilizada por run(). (Aportado por Andrew Svetlov en gh-91218.)

• Se agregó la clase Barrier a las primitivas de sincronización en la biblioteca asyncio y la excepción BrokenBarrierError relacionada. (Aportado por Yves Duprat y Andrew Svetlov en gh-87518.)

• Se agregó el argumento de palabra clave all_errors a asyncio.loop.create_connection() para que se puedan generar varios errores de conexión como ExceptionGroup.

• Se agregó el método asyncio.StreamWriter.start_tls() para actualizar las conexiones basadas en secuencias existentes a TLS. (Aportado por Ian Good en bpo-34975.)

• Se agregaron funciones de socket de datagrama sin formato al bucle de eventos: sock_sendto(), sock_recvfrom() y sock_recvfrom_into(). Estos tienen implementaciones en SelectorEventLoop y ProactorEventLoop. (Aportado por Alex Grönholm en bpo-46805.)

• Se agregaron los métodos cancelling() y uncancel() a Task. Estos están destinados principalmente para uso interno, en particular por TaskGroup.

contextlib¶

• Se agregó un administrador de contexto chdir() no seguro en paralelo para cambiar el directorio de trabajo actual y luego restaurarlo al salir. Envoltorio simple alrededor de chdir(). (Aportación de Filipe Laíns en bpo-25625)

clases de datos¶

• Cambie la verificación de mutabilidad predeterminada del campo, permitiendo solo los valores predeterminados que son hashable en lugar de cualquier objeto que no sea una instancia de dict, list o set. (Aportado por Eric V. Smith en bpo-44674.)

fecha y hora¶

• Agregue datetime.UTC, un alias conveniente para datetime.timezone.utc. (Aportado por Kabir Kwatra en gh-91973.)

• datetime.date.fromisoformat(), datetime.time.fromisoformat() y datetime.datetime.fromisoformat() ahora se pueden usar para analizar la mayoría de los formatos ISO 8601 (excepto aquellos que admiten fracciones de horas y minutos). (Aportado por Paul Ganssle en gh-80010.)

enumeración¶

• Cambió el nombre de EnumMeta a EnumType (EnumMeta se mantuvo como un alias).

• Se agregó StrEnum, con miembros que se pueden usar como (y deben ser) cadenas.

• Se agregó ReprEnum, que solo modifica el __repr__() de los miembros mientras devuelve sus valores literales (en lugar de nombres) para __str__() y __format__() (utilizados por str(), format() y f-strings).

• Changed Enum.__format__() (the default for format(), str.format() and f-strings) to always produce the same result as Enum.__str__(): for enums inheriting from ReprEnum it will be the member’s value; for all other enums it will be the enum and member name (e.g. Color.RED).

• Se agregó un nuevo parámetro de clase boundary a las enumeraciones Flag y la enumeración FlagBoundary con sus opciones, para controlar cómo manejar los valores de marca fuera de rango.

• Se agregó el decorador de enumeración verify() y la enumeración EnumCheck con sus opciones, para verificar las clases de enumeración contra varias restricciones específicas.

• Se agregaron los decoradores member() y nonmember() para garantizar que el objeto decorado no se convierta en un miembro de enumeración.

• Se agregó el decorador property(), que funciona como property() excepto para las enumeraciones. Use esto en lugar de types.DynamicClassAttribute().

• Se agregó el decorador de enumeración global_enum(), que ajusta __repr__() y __str__() para mostrar valores como miembros de su módulo en lugar de la clase de enumeración. Por ejemplo, 're.ASCII' para el miembro ASCII de re.RegexFlag en lugar de 'RegexFlag.ASCII'.

• Flag mejorado para admitir len(), iteración y in/not in en sus miembros. Por ejemplo, ahora funciona lo siguiente: len(AFlag(3)) == 2 and list(AFlag(3)) == (AFlag.ONE, AFlag.TWO)

• Se cambiaron Enum y Flag para que los miembros ahora se definan antes de llamar a __init_subclass__(); dir() ahora incluye métodos, etc., de tipos de datos combinados.

• Se modificó Flag para considerar solo los valores primarios (potencia de dos) canónicos, mientras que los valores compuestos (3, 6, 10, etc.) se consideran alias; las banderas invertidas son forzadas a su equivalente positivo.

fcntl¶

• En FreeBSD, se admiten los indicadores F_DUP2FD y F_DUP2FD_CLOEXEC respectivamente; el primero equivale al uso de dup2, mientras que el segundo establece además el indicador FD_CLOEXEC.

fracciones¶

• Compatibilidad con la inicialización al estilo PEP 515 de Fraction desde una cadena. (Aportado por Sergey B Kirpichev en bpo-44258.)

• Fraction ahora implementa un método __int__, de modo que pasa una verificación isinstance(some_fraction, typing.SupportsInt). (Contribuido por Mark Dickinson en bpo-44547.)

herramientas funcionales¶

• functools.singledispatch() now supports types.UnionType and typing.Union as annotations to the dispatch argument.:

  >>> from functools import singledispatch
  >>> @singledispatch
  ... def fun(arg, verbose=False):
  ...     if verbose:
  ...         print("Let me just say,", end=" ")
  ...     print(arg)
  ...
  >>> @fun.register
  ... def _(arg: int | float, verbose=False):
  ...     if verbose:
  ...         print("Strength in numbers, eh?", end=" ")
  ...     print(arg)
  ...
  >>> from typing import Union
  >>> @fun.register
  ... def _(arg: Union[list, set], verbose=False):
  ...     if verbose:
  ...         print("Enumerate this:")
  ...     for i, elem in enumerate(arg):
  ...         print(i, elem)
  ...
  

  (Aportado por Yurii Karabas en bpo-46014.)

gzip¶

• The gzip.compress() function is now faster when used with the mtime=0 argument as it delegates the compression entirely to a single zlib.compress() operation. There is one side effect of this change: The gzip file header contains an «OS» byte in its header. That was traditionally always set to a value of 255 representing «unknown» by the gzip module. Now, when using compress() with mtime=0, it may be set to a different value by the underlying zlib C library Python was linked against. (See gh-112346 for details on the side effect.)

hashlib¶

• hashlib.blake2b() y hashlib.blake2s() ahora prefieren libb2 a la copia proporcionada por Python. (Aportado por Christian Heimes en bpo-47095.)

• El módulo interno _sha3 con algoritmos SHA3 y SHAKE ahora usa tiny_sha3 en lugar de Keccak Code Package para reducir el código y el tamaño binario. El módulo hashlib prefiere implementaciones SHA3 y SHAKE optimizadas de OpenSSL. El cambio afecta solo a las instalaciones sin compatibilidad con OpenSSL. (Aportado por Christian Heimes en bpo-47098.)

• Agregue hashlib.file_digest(), una función de ayuda para el hash eficiente de archivos u objetos similares a archivos. (Aportado por Christian Heimes en gh-89313.)

IDLE y libre de inactividad¶

• Aplicar resaltado de sintaxis a archivos .pyi. (Aportado por Alex Waygood y Terry Jan Reedy en bpo-45447).

• Incluya avisos al guardar Shell con entradas y salidas. (Aportado por Terry Jan Reedy en gh-95191.)

inspeccionar¶

• Agregue getmembers_static() para devolver todos los miembros sin activar la búsqueda dinámica a través del protocolo descriptor. (Contribuido por Weipeng Hong en bpo-30533.)

• Agregue ismethodwrapper() para verificar si el tipo de un objeto es MethodWrapperType. (Aportado por Hakan Çelik en bpo-29418.)

• Cambie las funciones relacionadas con el marco en el módulo inspect para devolver nuevas instancias de clase FrameInfo y Traceback (compatibles con las interfaces similares a named tuple anteriores) que incluyen la información de posición PEP 657 extendida (número de línea final, columna y columna final). Las funciones afectadas son:

  • inspect.getframeinfo()

  • inspect.getouterframes()

  • inspect.getinnerframes(),

  • inspect.stack()

  • inspect.trace()

  (Aportado por Pablo Galindo en gh-88116.)

lugar¶

• Agregue locale.getencoding() para obtener la codificación de configuración regional actual. Es similar a locale.getpreferredencoding(False) pero ignora Python UTF-8 Mode.

Inicio sesión¶

• Se agregó getLevelNamesMapping() para devolver una asignación de nombres de nivel de registro (por ejemplo, 'CRITICAL') a los valores de su Niveles de logging correspondiente (por ejemplo, 50, de forma predeterminada). (Aportado por Andrei Kulakovin en gh-88024.)

• Se agregó un método createSocket() a SysLogHandler para que coincida con SocketHandler.createSocket(). Se llama automáticamente durante la inicialización del controlador y cuando se emite un evento, si no hay un socket activo. (Aportado por Kirill Pinchuk en gh-88457.)

Matemáticas¶

• Suma math.exp2(): devuelve 2 elevado a la potencia de x. (Aportado por Gideon Mitchell en bpo-45917.)

• Agregue math.cbrt(): devuelva la raíz cúbica de x. (Aportado por Ajith Ramachandran en bpo-44357.)

• Se cambió el comportamiento de dos casos de esquina math.pow(), para mantener la coherencia con la especificación IEEE 754. Las operaciones math.pow(0.0, -math.inf) y math.pow(-0.0, -math.inf) ahora devuelven inf. Anteriormente plantearon ValueError. (Contribuido por Mark Dickinson en bpo-44339.)

• El valor math.nan ahora está siempre disponible. (Aportado por Victor Stinner en bpo-46917.)

operador¶

• Se ha añadido una nueva función operator.call, de forma que operator.call(obj, *args, **kwargs) == obj(*args, **kwargs). (Aportado por Antony Lee en bpo-44019.)

sistema operativo¶

• En Windows, os.urandom() ahora usa BCryptGenRandom(), en lugar de CryptGenRandom(), que está en desuso. (Aportado por Donghee Na en bpo-44611.)

rutalib¶

• glob() y rglob() solo devuelven directorios si pattern termina con un separador de componentes de nombre de ruta: sep o altsep. (Aportado por Eisuke Kawasima en bpo-22276 y bpo-33392).

re¶

• La agrupación atómica ((?>...)) y los cuantificadores posesivos (*+, ++, ?+, {m,n}+) ahora son compatibles con las expresiones regulares. (Aportado por Jeffrey C. Jacobs y Serhiy Storchaka en bpo-433030).

cerrar¶

• Agregue el parámetro opcional dir_fd en shutil.rmtree(). (Aportado por Serhiy Storchaka en bpo-46245.)

enchufe¶

• Agregue compatibilidad con CAN Socket para NetBSD. (Aportado por Thomas Klausner en bpo-30512.)

• create_connection() tiene una opción para generar, en caso de falla de conexión, un ExceptionGroup que contiene todos los errores en lugar de generar solo el último error. (Aportado por Irit Katriel en bpo-29980.)

sqlite3¶

• Ahora puede deshabilitar el autorizador pasando None a set_authorizer(). (Aportado por Erlend E. Aasland en bpo-44491.)

• El nombre de intercalación create_collation() ahora puede contener cualquier carácter Unicode. Los nombres de intercalación con caracteres no válidos ahora generan UnicodeEncodeError en lugar de sqlite3.ProgrammingError. (Aportado por Erlend E. Aasland en bpo-44688.)

• Las excepciones sqlite3 ahora incluyen el código de error extendido de SQLite como sqlite_errorcode y el nombre de error de SQLite como sqlite_errorname. (Aportado por Aviv Palivoda, Daniel Shahaf y Erlend E. Aasland en bpo-16379 y bpo-24139).

• Agregue setlimit() y getlimit() a sqlite3.Connection para configurar y obtener límites de SQLite por conexión. (Aportado por Erlend E. Aasland en bpo-45243.)

• sqlite3 ahora establece sqlite3.threadsafety en función del modo de subprocesamiento predeterminado con el que se ha compilado la biblioteca SQLite subyacente. (Aportado por Erlend E. Aasland en bpo-45613.)

• Las devoluciones de llamada de sqlite3 C ahora usan excepciones que no se pueden generar si las devoluciones de llamada están habilitadas. Los usuarios ahora pueden registrar un unraisable hook handler para mejorar su experiencia de depuración. (Aportado por Erlend E. Aasland en bpo-45828.)

• Recuperar a través de reversión ya no genera InterfaceError. En cambio, dejamos que la biblioteca SQLite maneje estos casos. (Aportado por Erlend E. Aasland en bpo-44092.)

• Agregue serialize() y deserialize() a sqlite3.Connection para serializar y deserializar bases de datos. (Aportado por Erlend E. Aasland en bpo-41930.)

• Agregue create_window_function() a sqlite3.Connection para crear funciones de ventana agregadas. (Aportado por Erlend E. Aasland en bpo-34916.)

• Agregue blobopen() a sqlite3.Connection. sqlite3.Blob permite operaciones de E/S incrementales en blobs. (Contribuido por Aviv Palivoda y Erlend E. Aasland en bpo-24905).

cuerda¶

• Agregue get_identifiers() y is_valid() a string.Template, que devuelven respectivamente todos los marcadores de posición válidos y si hay algún marcador de posición no válido presente. (Aportado por Ben Kehoe en gh-90465.)

sistema¶

• sys.exc_info() ahora deriva los campos type y traceback de value (la instancia de excepción), de modo que cuando se modifica una excepción mientras se está manipulando, los cambios se reflejan en los resultados de llamadas posteriores a exc_info(). (Aportado por Irit Katriel en bpo-45711.)

• Agregue sys.exception() que devuelve la instancia de excepción activa (equivalente a sys.exc_info()[1]). (Aportado por Irit Katriel en bpo-46328.)

• Agregue el indicador sys.flags.safe_path. (Aportado por Victor Stinner en gh-57684.)

configuración del sistema¶

• Se agregaron tres nuevos installation schemes (posix_venv, nt_venv y venv) y se usan cuando Python crea nuevos entornos virtuales o cuando se ejecuta desde un entorno virtual. Los primeros dos esquemas (posix_venv y nt_venv) son específicos del sistema operativo para Windows y no Windows, el venv es esencialmente un alias para uno de ellos según el sistema operativo en el que se ejecuta Python. Esto es útil para los distribuidores posteriores que modifican sysconfig.get_preferred_scheme(). El código de terceros que crea nuevos entornos virtuales debe usar el nuevo esquema de instalación venv para determinar las rutas, al igual que venv. (Aportado por Miro Hrončok en bpo-45413.)

archivo temporal¶

• Los objetos SpooledTemporaryFile ahora implementan completamente los métodos de io.BufferedIOBase o io.TextIOBase (según el modo de archivo). Esto les permite trabajar correctamente con API que esperan objetos similares a archivos, como módulos de compresión. (Aportado por Carey Metcalfe en gh-70363.)

enhebrar¶

• En Unix, si la función sem_clockwait() está disponible en la biblioteca C (glibc 2.30 y posteriores), el método threading.Lock.acquire() ahora usa el reloj monótono (time.CLOCK_MONOTONIC) para el tiempo de espera, en lugar de usar el reloj del sistema (time.CLOCK_REALTIME), para no verse afectado por cambios de reloj del sistema. (Contribución de Victor Stinner en bpo-41710.)

tiempo¶

• En Unix, time.sleep() ahora usa la función clock_nanosleep() o nanosleep(), si está disponible, que tiene una resolución de 1 nanosegundo (10^-9 segundos), en lugar de usar select() que tiene una resolución de 1 microsegundo (10^-6 segundos). (Aportado por Benjamin Szőke y Victor Stinner en bpo-21302.)

• En Windows 8.1 y versiones posteriores, time.sleep() ahora utiliza un temporizador de espera basado en high-resolution timers que tiene una resolución de 100 nanosegundos (10^-7 segundos). Anteriormente, tenía una resolución de 1 milisegundo (10^-3 segundos). (Contribución de Benjamin Szőke, Donghee Na, Eryk Sun y Victor Stinner en bpo-21302 y bpo-45429).

tkinter¶

• Se agregó el método info_patchlevel() que devuelve la versión exacta de la biblioteca Tcl como una tupla con nombre similar a sys.version_info. (Aportado por Serhiy Storchaka en gh-91827.)

rastrear¶

• Agregue traceback.StackSummary.format_frame_summary() para permitir que los usuarios anulen qué marcos aparecen en el rastreo y cómo están formateados. (Aportado por Ammar Askar en bpo-44569.)

• Agregue traceback.TracebackException.print(), que imprime la instancia TracebackException formateada en un archivo. (Aportado por Irit Katriel en bpo-33809.)

mecanografía¶

Para conocer los cambios importantes, consulte Nuevas funciones relacionadas con las sugerencias de tipo.

• Agregue typing.assert_never() y typing.Never. typing.assert_never() es útil para pedirle a un verificador de tipos que confirme que no se puede acceder a una línea de código. En tiempo de ejecución, genera un AssertionError. (Aportado por Jelle Zijlstra en gh-90633.)

• Agregue typing.reveal_type(). Esto es útil para preguntarle a un verificador de tipos qué tipo ha inferido para una expresión dada. En tiempo de ejecución imprime el tipo del valor recibido. (Aportado por Jelle Zijlstra en gh-90572.)

• Agregue typing.assert_type(). Esto es útil para pedirle a un verificador de tipos que confirme que el tipo que ha inferido para una expresión dada coincide con el tipo dado. En tiempo de ejecución, simplemente devuelve el valor recibido. (Aportado por Jelle Zijlstra en gh-90638.)

• Los tipos typing.TypedDict ahora pueden ser genéricos. (Aportado por Samodya Abeysiriwardane en gh-89026.)

• Los tipos NamedTuple ahora pueden ser genéricos. (Aportado por Serhiy Storchaka en bpo-43923.)

• Permitir subclases de typing.Any. Esto es útil para evitar errores de verificación de tipos relacionados con clases altamente dinámicas, como simulacros. (Aportado por Shantanu Jain en gh-91154.)

• El decorador typing.final() ahora establece el atributo __final__ en el objeto decorado. (Aportado por Jelle Zijlstra en gh-90500.)

• La función typing.get_overloads() se puede utilizar para la introspección de las sobrecargas de una función. typing.clear_overloads() se puede utilizar para borrar todas las sobrecargas registradas de una función. (Aportado por Jelle Zijlstra en gh-89263.)

• Ahora se conserva el método __init__() de las subclases Protocol. (Aportado por Adrián García Badarasco en gh-88970.)

• La representación de tipos de tuplas vacías (Tuple[()]) se simplifica. Esto afecta la introspección, p. get_args(Tuple[()]) ahora se evalúa como () en lugar de ((),). (Aportado por Serhiy Storchaka en gh-91137.)

• Afloje los requisitos de tiempo de ejecución para las anotaciones de tipo eliminando la verificación invocable en la función privada typing._type_check. (Aportado por Gregory Beauregard en gh-90802.)

• typing.get_type_hints() ahora admite la evaluación de cadenas como referencias directas en PEP 585 generic aliases. (Aportado por Niklas Rosenstein en gh-85542.)

• typing.get_type_hints() ya no agrega Optional a los parámetros con None como predeterminado. (Aportado por Nikita Sobolev en gh-90353.)

• typing.get_type_hints() ahora admite la evaluación de anotaciones ClassVar con cadenas desnudas. (Aportado por Gregory Beauregard en gh-90711.)

• typing.no_type_check() ya no modifica clases y funciones externas. Ahora también marca correctamente los métodos de clase para que no se verifique el tipo. (Aportado por Nikita Sobolev en gh-90729.)

unicodedata¶

• La base de datos Unicode se ha actualizado a la versión 14.0.0. (Aportado por Benjamin Peterson en bpo-45190).

prueba de unidad¶

• Se agregaron los métodos enterContext() y enterClassContext() de la clase TestCase, el método enterAsyncContext() de la clase IsolatedAsyncioTestCase y la función unittest.enterModuleContext(). (Aportado por Serhiy Storchaka en bpo-45046.)

venv¶

• Cuando se crean nuevos entornos virtuales de Python, el venv sysconfig installation scheme se utiliza para determinar las rutas dentro del entorno. Cuando Python se ejecuta en un entorno virtual, el mismo esquema de instalación es el predeterminado. Eso significa que los distribuidores intermedios pueden cambiar el esquema de instalación de sysconfig predeterminado sin cambiar el comportamiento de los entornos virtuales. El código de terceros que también crea nuevos entornos virtuales debería hacer lo mismo. (Aportado por Miro Hrončok en bpo-45413.)

advertencias¶

• warnings.catch_warnings() ahora acepta argumentos para warnings.simplefilter(), lo que proporciona una forma más concisa de ignorar localmente las advertencias o convertirlas en errores. (Aportado por Zac Hatfield-Dodds en bpo-47074).

archivo zip¶

• Se agregó compatibilidad para especificar la codificación de nombres de miembros para leer metadatos en los encabezados de archivos y directorios de ZipFile. (Aportado por Stephen J. Turnbull y Serhiy Storchaka en bpo-28080).

• Se agregó ZipFile.mkdir() para crear nuevos directorios dentro de archivos ZIP. (Aportado por Sam Ezeh en gh-49083.)

• Se agregaron stem, suffix y suffixes a zipfile.Path. (Aportado por Miguel Brito en gh-88261.)

Inicio más rápido¶

Read __pycache__ -> Unmarshal -> Heap allocated code object -> Evaluate

Statically allocated code object -> Evaluate

Tiempo de ejecución más rápido¶

Varios¶

• Los objetos ahora requieren menos memoria debido a los espacios de nombres de objetos creados con pereza. Sus diccionarios de espacio de nombres ahora también comparten claves más libremente. (Contribuido por Mark Shannon en bpo-45340 y bpo-40116).

• Se implementan excepciones de «costo cero», lo que elimina el costo de las declaraciones try cuando no se plantea ninguna excepción. (Contribución de Mark Shannon en bpo-40222.)

• Una representación más concisa de las excepciones en el intérprete redujo el tiempo necesario para detectar una excepción en aproximadamente un 10 %. (Aportado por Irit Katriel en bpo-45711.)

• El motor de coincidencia de expresiones regulares de re ha sido parcialmente refactorizado y ahora utiliza gotos calculados (o «código de subprocesos») en las plataformas compatibles. Como resultado, Python 3.11 ejecuta pyperformance regular expression benchmarks hasta un 10% más rápido que Python 3.10. (Contribución de Brandt Bucher en gh-91404.)

Preguntas más frecuentes¶

Sobre¶

Faster CPython explora optimizaciones para CPython. El equipo principal está financiado por Microsoft para trabajar en esto a tiempo completo. Pablo Galindo Salgado también está financiado por Bloomberg LP para trabajar en el proyecto a tiempo parcial. Finalmente, muchos contribuyentes son voluntarios de la comunidad.

Nuevos códigos de operación¶

• ASYNC_GEN_WRAP, RETURN_GENERATOR and SEND, used in generators and co-routines.

• COPY_FREE_VARS, que evita la necesidad de un código especial del lado de la persona que llama para los cierres.

• JUMP_BACKWARD_NO_INTERRUPT, para usar en ciertos bucles donde no es deseable manejar interrupciones.

• MAKE_CELL, para crear Objetos celda.

• CHECK_EG_MATCH and PREP_RERAISE_STAR, to handle the new exception groups and except* added in PEP 654.

• PUSH_EXC_INFO, para uso en controladores de excepciones.

• RESUME, no operativo, para el seguimiento interno, la depuración y las comprobaciones de optimización.

Códigos de operación reemplazados¶

Códigos de operación cambiados/eliminados¶

• Se cambiaron MATCH_CLASS y MATCH_KEYS para que ya no envíen un valor booleano adicional para indicar éxito/fracaso. En su lugar, se inserta None en caso de error en lugar de la tupla de valores extraídos.

• Se cambiaron los códigos de operación que funcionan con excepciones para reflejarlas y ahora se representan como un elemento en la pila en lugar de tres (ver gh-89874).

• Se eliminaron COPY_DICT_WITHOUT_KEYS, GEN_START, POP_BLOCK, SETUP_FINALLY y YIELD_FROM.

Idioma/Construidos¶

• El encadenamiento de descriptores classmethod (introducido en bpo-19072) ahora está en desuso. Ya no se puede usar para envolver otros descriptores como property. El diseño central de esta función tenía fallas y causó una serie de problemas posteriores. Para «transmitir» un classmethod, considere usar el atributo __wrapped__ que se agregó en Python 3.10. (Aportado por Raymond Hettinger en gh-89519.)

• Los escapes octales en cadenas y bytes literales con valores mayores que 0o377 (255 en decimal) ahora producen un DeprecationWarning. En una futura versión de Python, generarán un SyntaxWarning y eventualmente un SyntaxError. (Aportado por Serhiy Storchaka en gh-81548.)

• La delegación de int() a __trunc__() ahora está obsoleta. Llamar a int(a) cuando type(a) implementa __trunc__() pero no __int__() o __index__() ahora genera un DeprecationWarning. (Aportado por Zackery Spytz en bpo-44977).

Módulos¶

• PEP 594 condujo a la desaprobación de los siguientes módulos programados para su eliminación en Python 3.13:

  aifc	chunk	msilib	pipes	telnetlib
  audioop	crypt	nis	sndhdr	uu
  cgi	imghdr	nntplib	spwd	xdrlib
  cgitb	mailcap	ossaudiodev	sunau

  (Aportado por Brett Cannon en bpo-47061 y Victor Stinner en gh-68966).

• The asynchat, asyncore and smtpd modules have been deprecated since at least Python 3.6. Their documentation and deprecation warnings have now been updated to note they will be removed in Python 3.12. (Contributed by Hugo van Kemenade in bpo-47022.)

• The lib2to3 package and 2to3 tool are now deprecated and may not be able to parse Python 3.10 or newer. See PEP 617, introducing the new PEG parser, for details. (Contributed by Victor Stinner in bpo-40360.)

• Los módulos no documentados sre_compile, sre_constants y sre_parse ahora están obsoletos. (Aportado por Serhiy Storchaka en bpo-47152.)

Biblioteca estándar¶

• Lo siguiente ha quedado obsoleto en configparser desde Python 3.2. Sus advertencias de obsolescencia ahora se han actualizado para tener en cuenta que se eliminarán en Python 3.12:

  • la clase configparser.SafeConfigParser

  • la propiedad configparser.ParsingError.filename

  • the configparser.RawConfigParser.readfp() method

  (Aportado por Hugo van Kemenade en bpo-45173.)

• configparser.LegacyInterpolation ha quedado obsoleto en la cadena de documentación desde Python 3.2 y no aparece en la documentación de configparser. Ahora emite un DeprecationWarning y se eliminará en Python 3.13. Utilice configparser.BasicInterpolation o configparser.ExtendedInterpolation en su lugar. (Aportado por Hugo van Kemenade en bpo-46607.)

• El conjunto anterior de funciones importlib.resources quedó en desuso en favor de los reemplazos agregados en Python 3.9 y se eliminará en una versión futura de Python, debido a que no admite recursos ubicados dentro de los subdirectorios del paquete:

  • importlib.resources.contents()

  • importlib.resources.is_resource()

  • importlib.resources.open_binary()

  • importlib.resources.open_text()

  • importlib.resources.read_binary()

  • importlib.resources.read_text()

  • importlib.resources.path()

• The locale.getdefaultlocale() function is deprecated and will be removed in Python 3.15. Use locale.setlocale(), locale.getpreferredencoding(False) and locale.getlocale() functions instead. (Contributed by Victor Stinner in gh-90817.)

• The locale.resetlocale() function is deprecated and will be removed in Python 3.13. Use locale.setlocale(locale.LC_ALL, "") instead. (Contributed by Victor Stinner in gh-90817.)

• Ahora se aplicarán reglas más estrictas para las referencias de grupos numéricos y los nombres de grupos en regular expressions. Ahora solo se aceptarán secuencias de dígitos ASCII como referencia numérica, y el nombre del grupo en los patrones bytes y las cadenas de reemplazo solo pueden contener letras ASCII, dígitos y guiones bajos. Por ahora, se genera una advertencia de desaprobación para la sintaxis que viola estas reglas. (Aportado por Serhiy Storchaka en gh-91760.)

• En el módulo re, la función re.template() y los indicadores re.TEMPLATE y re.T correspondientes están en desuso, ya que no estaban documentados y carecían de un propósito obvio. Se eliminarán en Python 3.13. (Contribución de Serhiy Storchaka y Miro Hrončok en gh-92728.)

• turtle.settiltangle() has been deprecated since Python 3.1; it now emits a deprecation warning and will be removed in Python 3.13. Use turtle.tiltangle() instead (it was earlier incorrectly marked as deprecated, and its docstring is now corrected). (Contributed by Hugo van Kemenade in bpo-45837.)

• typing.Text, que existe únicamente para proporcionar soporte de compatibilidad entre el código de Python 2 y Python 3, ahora está obsoleto. Su eliminación no está planificada actualmente, pero se recomienda a los usuarios que usen str en su lugar siempre que sea posible. (Aportado por Alex Waygood en gh-92332.)

• La sintaxis de argumento de palabra clave para construir tipos typing.TypedDict ahora está obsoleta. Se eliminará el soporte en Python 3.13. (Aportado por Jingchen Ye en gh-90224.)

• webbrowser.MacOSX está en desuso y se eliminará en Python 3.13. No está probado, no está documentado y no lo utiliza el propio webbrowser. (Contribución de Donghee Na en bpo-42255.)

• El comportamiento de devolver un valor de los métodos de prueba TestCase y IsolatedAsyncioTestCase (aparte del valor None predeterminado) ahora está obsoleto.

• Se descartaron las siguientes funciones unittest no documentadas formalmente, programadas para su eliminación en Python 3.13:

  • unittest.findTestCases()

  • unittest.makeSuite()

  • unittest.getTestCaseNames()

  Utilice métodos TestLoader en su lugar:

  • unittest.TestLoader.loadTestsFromModule()

  • unittest.TestLoader.loadTestsFromTestCase()

  • unittest.TestLoader.getTestCaseNames()

  (Aportado por Erlend E. Aasland en bpo-5846.)

• unittest.TestProgram.usageExit() is marked deprecated, to be removed in 3.13. (Contributed by Carlos Damázio in gh-67048.)

Nuevas características¶

• Agregue una nueva función PyType_GetName() para obtener el nombre corto del tipo. (Aportado por Hai Shi en bpo-42035.)

• Agregue una nueva función PyType_GetQualName() para obtener el nombre completo del tipo. (Aportado por Hai Shi en bpo-42035.)

• Agregue nuevas funciones PyThreadState_EnterTracing() y PyThreadState_LeaveTracing() a la API de C limitada para suspender y reanudar el seguimiento y la creación de perfiles. (Aportado por Victor Stinner en bpo-43760.)

• Se agregó la constante Py_Version que tiene el mismo valor que PY_VERSION_HEX. (Aportado por Gabriele N. Tornetta en bpo-43931.)

• Py_buffer y las API ahora forman parte de la API limitada y la ABI estable:

  • PyObject_CheckBuffer()

  • PyObject_GetBuffer()

  • PyBuffer_GetPointer()

  • PyBuffer_SizeFromFormat()

  • PyBuffer_ToContiguous()

  • PyBuffer_FromContiguous()

  • PyObject_CopyData()

  • PyBuffer_IsContiguous()

  • PyBuffer_FillContiguousStrides()

  • PyBuffer_FillInfo()

  • PyBuffer_Release()

  • PyMemoryView_FromBuffer()

  • Ranuras de tipo bf_getbuffer y bf_releasebuffer

  (Aportado por Christian Heimes en bpo-45459.)

• Se agregó la función PyType_GetModuleByDef(), utilizada para obtener el módulo en el que se definió un método, en los casos en que esta información no esté disponible directamente (a través de PyCMethod). (Aportado por Petr Viktorin en bpo-46613.)

• Agrega nuevas funciones para empaquetar y desempaquetar C doble (serializar y deserializar): PyFloat_Pack2(), PyFloat_Pack4(), PyFloat_Pack8(), PyFloat_Unpack2(), PyFloat_Unpack4() y PyFloat_Unpack8(). (Aportado por Victor Stinner en bpo-46906.)

• Agregue nuevas funciones para obtener atributos de objetos de marco: PyFrame_GetBuiltins(), PyFrame_GetGenerator(), PyFrame_GetGlobals(), PyFrame_GetLasti().

• Se agregaron dos funciones nuevas para obtener y configurar la instancia de excepción activa: PyErr_GetHandledException() y PyErr_SetHandledException(). Estas son alternativas a PyErr_SetExcInfo() y PyErr_GetExcInfo() que funcionan con la representación de excepciones heredada de 3 tuplas. (Aportado por Irit Katriel en bpo-46343.)

• Se agregó el miembro PyConfig.safe_path. (Aportado por Victor Stinner en gh-57684.)

Migración a Python 3.11¶

• Algunas macros se han convertido en funciones estáticas en línea para evitar macro pitfalls. El cambio debería ser en su mayoría transparente para los usuarios, ya que las funciones de reemplazo emitirán sus argumentos a los tipos esperados para evitar advertencias del compilador debido a comprobaciones de tipos estáticos. Sin embargo, cuando la API de C limitada se establece en >=3.11, estas conversiones no se realizan y las personas que llaman deberán convertir argumentos a sus tipos esperados. Ver PEP 670 para más detalles. (Aportado por Victor Stinner y Erlend E. Aasland en gh-89653.)

• PyErr_SetExcInfo() ya no usa los argumentos type y traceback, el intérprete ahora deriva esos valores de la instancia de excepción (el argumento value). La función aún roba referencias de los tres argumentos. (Aportado por Irit Katriel en bpo-45711.)

• PyErr_GetExcInfo() ahora deriva los campos type y traceback del resultado de la instancia de excepción (el campo value). (Aportado por Irit Katriel en bpo-45711.)

• _frozen tiene un nuevo campo is_package para indicar si el módulo congelado es o no un paquete. Anteriormente, un valor negativo en el campo size era el indicador. Ahora solo se pueden usar valores no negativos para size. (Aportado por Kumar Aditya en bpo-46608.)

• _PyFrameEvalFunction() ahora toma _PyInterpreterFrame* como su segundo parámetro, en lugar de PyFrameObject*. Consulte PEP 523 para obtener más detalles sobre cómo usar este tipo de puntero de función.

• PyCode_New() and PyCode_NewWithPosOnlyArgs() now take an additional exception_table argument. Using these functions should be avoided, if at all possible. To get a custom code object: create a code object using the compiler, then get a modified version with the replace method.

• PyCodeObject ya no tiene los campos co_code, co_varnames, co_cellvars y co_freevars. En su lugar, utilice PyCode_GetCode(), PyCode_GetVarnames(), PyCode_GetCellvars() y PyCode_GetFreevars() respectivamente para acceder a ellos a través de la API de C. (Aportado por Brandt Bucher en bpo-46841 y Ken Jin en gh-92154 y gh-94936).

• Las antiguas macros de papelera (Py_TRASHCAN_SAFE_BEGIN/Py_TRASHCAN_SAFE_END) ahora están obsoletas. Deberían ser reemplazadas por las nuevas macros Py_TRASHCAN_BEGIN y Py_TRASHCAN_END.

  Una función tp_dealloc que tiene las macros antiguas, como:

  static void
  mytype_dealloc(mytype *p)
  {
      PyObject_GC_UnTrack(p);
      Py_TRASHCAN_SAFE_BEGIN(p);
      ...
      Py_TRASHCAN_SAFE_END
  }
  

  debe migrar a las nuevas macros de la siguiente manera:

  static void
  mytype_dealloc(mytype *p)
  {
      PyObject_GC_UnTrack(p);
      Py_TRASHCAN_BEGIN(p, mytype_dealloc)
      ...
      Py_TRASHCAN_END
  }
  

  Tenga en cuenta que Py_TRASHCAN_BEGIN tiene un segundo argumento que debería ser la función de desasignación en la que se encuentra.

  Para admitir versiones anteriores de Python en la misma base de código, puede definir las siguientes macros y usarlas en todo el código (crédito: se copiaron de la base de código mypy):

  #if PY_VERSION_HEX >= 0x03080000
  #  define CPy_TRASHCAN_BEGIN(op, dealloc) Py_TRASHCAN_BEGIN(op, dealloc)
  #  define CPy_TRASHCAN_END(op) Py_TRASHCAN_END
  #else
  #  define CPy_TRASHCAN_BEGIN(op, dealloc) Py_TRASHCAN_SAFE_BEGIN(op)
  #  define CPy_TRASHCAN_END(op) Py_TRASHCAN_SAFE_END(op)
  #endif
  

• La función PyType_Ready() ahora genera un error si un tipo se define con el indicador Py_TPFLAGS_HAVE_GC establecido pero no tiene función transversal (PyTypeObject.tp_traverse). (Aportado por Victor Stinner en bpo-44263.)

• Los tipos de montón con el indicador Py_TPFLAGS_IMMUTABLETYPE ahora pueden heredar el protocolo de llamada vectorial PEP 590. Anteriormente, esto sólo era posible para static types. (Aportado por Erlend E. Aasland en bpo-43908)

• Dado que Py_TYPE() se cambia a una función estática en línea, Py_TYPE(obj) = new_type debe reemplazarse por Py_SET_TYPE(obj, new_type): consulte la función Py_SET_TYPE() (disponible desde Python 3.9). Para compatibilidad con versiones anteriores, se puede usar esta macro:

  #if PY_VERSION_HEX < 0x030900A4 && !defined(Py_SET_TYPE)
  static inline void _Py_SET_TYPE(PyObject *ob, PyTypeObject *type)
  { ob->ob_type = type; }
  #define Py_SET_TYPE(ob, type) _Py_SET_TYPE((PyObject*)(ob), type)
  #endif
  

  (Aportado por Victor Stinner en bpo-39573.)

• Dado que Py_SIZE() se cambia a una función estática en línea, Py_SIZE(obj) = new_size debe reemplazarse por Py_SET_SIZE(obj, new_size): consulte la función Py_SET_SIZE() (disponible desde Python 3.9). Para compatibilidad con versiones anteriores, se puede usar esta macro:

  #if PY_VERSION_HEX < 0x030900A4 && !defined(Py_SET_SIZE)
  static inline void _Py_SET_SIZE(PyVarObject *ob, Py_ssize_t size)
  { ob->ob_size = size; }
  #define Py_SET_SIZE(ob, size) _Py_SET_SIZE((PyVarObject*)(ob), size)
  #endif
  

  (Aportado por Victor Stinner en bpo-39573.)

• <Python.h> ya no incluye los archivos de encabezado <stdlib.h>, <stdio.h>, <errno.h> y <string.h> cuando la macro Py_LIMITED_API se establece en 0x030b0000 (Python 3.11) o superior. Las extensiones de C deben incluir explícitamente los archivos de encabezado después de #include <Python.h>. (Aportado por Victor Stinner en bpo-45434.)

• Los archivos de API no limitados cellobject.h, classobject.h, code.h, context.h, funcobject.h, genobject.h y longintrepr.h se han movido al directorio Include/cpython. Además, se eliminó el archivo de encabezado eval.h. Estos archivos no deben incluirse directamente, ya que ya están incluidos en Python.h: Include Files. Si se han incluido directamente, considere incluir Python.h en su lugar. (Aportado por Victor Stinner en bpo-35134.)

• The PyUnicode_CHECK_INTERNED() macro has been excluded from the limited C API. It was never usable there, because it used internal structures which are not available in the limited C API. (Contributed by Victor Stinner in bpo-46007.)

• Las siguientes funciones y tipos de cuadros ahora están disponibles directamente con #include <Python.h>, ya no es necesario agregar #include <frameobject.h>:

  • PyFrame_Check()

  • PyFrame_GetBack()

  • PyFrame_GetBuiltins()

  • PyFrame_GetGenerator()

  • PyFrame_GetGlobals()

  • PyFrame_GetLasti()

  • PyFrame_GetLocals()

  • PyFrame_Type

  (Aportado por Victor Stinner en gh-93937.)

• Los miembros de la estructura PyFrameObject se han eliminado de la API de C pública.

  Si bien la documentación señala que los campos PyFrameObject están sujetos a cambios en cualquier momento, se han mantenido estables durante mucho tiempo y se usaron en varias extensiones populares.

  En Python 3.11, la estructura del marco se reorganizó para permitir optimizaciones de rendimiento. Algunos campos se eliminaron por completo, ya que eran detalles de la implementación anterior.

  Campos PyFrameObject:

  • f_back: usa PyFrame_GetBack().

  • f_blockstack: eliminado.

  • f_builtins: usa PyFrame_GetBuiltins().

  • f_code: usa PyFrame_GetCode().

  • f_gen: usa PyFrame_GetGenerator().

  • f_globals: usa PyFrame_GetGlobals().

  • f_iblock: eliminado.

  • f_lasti: usa PyFrame_GetLasti(). El código que usa f_lasti con PyCode_Addr2Line() debería usar PyFrame_GetLineNumber() en su lugar; puede ser más rápido.

  • f_lineno: usar PyFrame_GetLineNumber()

  • f_locals: usa PyFrame_GetLocals().

  • f_stackdepth: eliminado.

  • f_state: sin API pública (renombrado como f_frame.f_state).

  • f_trace: sin API pública.

  • f_trace_lines: utiliza PyObject_GetAttrString((PyObject*)frame, "f_trace_lines").

  • f_trace_opcodes: utiliza PyObject_GetAttrString((PyObject*)frame, "f_trace_opcodes").

  • f_localsplus: sin API pública (renombrado como f_frame.localsplus).

  • f_valuestack: eliminado.

  The Python frame object is now created lazily. A side effect is that the f_back member must not be accessed directly, since its value is now also computed lazily. The PyFrame_GetBack() function must be called instead.

  Debuggers that accessed the f_locals directly must call PyFrame_GetLocals() instead. They no longer need to call PyFrame_FastToLocalsWithError() or PyFrame_LocalsToFast(), in fact they should not call those functions. The necessary updating of the frame is now managed by the virtual machine.

  Código que define PyFrame_GetCode() en Python 3.8 y anteriores:

  #if PY_VERSION_HEX < 0x030900B1
  static inline PyCodeObject* PyFrame_GetCode(PyFrameObject *frame)
  {
      Py_INCREF(frame->f_code);
      return frame->f_code;
  }
  #endif
  

  Código que define PyFrame_GetBack() en Python 3.8 y anteriores:

  #if PY_VERSION_HEX < 0x030900B1
  static inline PyFrameObject* PyFrame_GetBack(PyFrameObject *frame)
  {
      Py_XINCREF(frame->f_back);
      return frame->f_back;
  }
  #endif
  

  O use pythoncapi_compat project para obtener estas dos funciones en versiones anteriores de Python.

• Cambios de los miembros de la estructura PyThreadState:

  • frame: eliminado, use PyThreadState_GetFrame() (función agregada a Python 3.9 por bpo-40429). Advertencia: la función devuelve un strong reference, necesita llamar a Py_XDECREF().

  • tracing: cambiado, use PyThreadState_EnterTracing() y PyThreadState_LeaveTracing() (funciones agregadas a Python 3.11 por bpo-43760).

  • recursion_depth: eliminado, use (tstate->recursion_limit - tstate->recursion_remaining) en su lugar.

  • stackcheck_counter: eliminado.

  Código que define PyThreadState_GetFrame() en Python 3.8 y anteriores:

  #if PY_VERSION_HEX < 0x030900B1
  static inline PyFrameObject* PyThreadState_GetFrame(PyThreadState *tstate)
  {
      Py_XINCREF(tstate->frame);
      return tstate->frame;
  }
  #endif
  

  Código que define PyThreadState_EnterTracing() y PyThreadState_LeaveTracing() en Python 3.10 y versiones anteriores:

  #if PY_VERSION_HEX < 0x030B00A2
  static inline void PyThreadState_EnterTracing(PyThreadState *tstate)
  {
      tstate->tracing++;
  #if PY_VERSION_HEX >= 0x030A00A1
      tstate->cframe->use_tracing = 0;
  #else
      tstate->use_tracing = 0;
  #endif
  }
  
  static inline void PyThreadState_LeaveTracing(PyThreadState *tstate)
  {
      int use_tracing = (tstate->c_tracefunc != NULL || tstate->c_profilefunc != NULL);
      tstate->tracing--;
  #if PY_VERSION_HEX >= 0x030A00A1
      tstate->cframe->use_tracing = use_tracing;
  #else
      tstate->use_tracing = use_tracing;
  #endif
  }
  #endif
  

  O use the pythoncapi-compat project para obtener estas funciones en funciones antiguas de Python.

• Se alienta a los distribuidores a compilar Python con la biblioteca Blake2 optimizada libb2.

• El campo PyConfig.module_search_paths_set ahora debe establecerse en 1 para que la inicialización use PyConfig.module_search_paths para inicializar sys.path. De lo contrario, la inicialización volverá a calcular la ruta y reemplazará los valores agregados a module_search_paths.

• PyConfig_Read() ya no calcula la ruta de búsqueda inicial y no completará ningún valor en PyConfig.module_search_paths. Para calcular rutas predeterminadas y luego modificarlas, finalice la inicialización y use PySys_GetObject() para recuperar sys.path como un objeto de lista de Python y modificarlo directamente.

Obsoleto¶

• Deseche las siguientes funciones para configurar la inicialización de Python:

  • PySys_AddWarnOptionUnicode()

  • PySys_AddWarnOption()

  • PySys_AddXOption()

  • PySys_HasWarnOptions()

  • PySys_SetArgvEx()

  • PySys_SetArgv()

  • PySys_SetPath()

  • Py_SetPath()

  • Py_SetProgramName()

  • Py_SetPythonHome()

  • Py_SetStandardStreamEncoding()

  • _Py_SetProgramFullPath()

  Utilice la nueva API PyConfig de Python Initialization Configuration en su lugar (PEP 587). (Aportado por Victor Stinner en gh-88279.)

• Deje obsoleto el miembro ob_shash de PyBytesObject. Utilice PyObject_Hash() en su lugar. (Aportado por Inada Naoki en bpo-46864.)

Eliminación pendiente en Python 3.12¶

Las siguientes API de C quedaron obsoletas en versiones anteriores de Python y se eliminarán en Python 3.12.

• PyUnicode_AS_DATA()

• PyUnicode_AS_UNICODE()

• PyUnicode_AsUnicodeAndSize()

• PyUnicode_AsUnicode()

• PyUnicode_FromUnicode()

• PyUnicode_GET_DATA_SIZE()

• PyUnicode_GET_SIZE()

• PyUnicode_GetSize()

• PyUnicode_IS_COMPACT()

• PyUnicode_IS_READY()

• PyUnicode_READY()

• Py_UNICODE_WSTR_LENGTH()

• _PyUnicode_AsUnicode()

• PyUnicode_WCHAR_KIND

• PyUnicodeObject

• PyUnicode_InternImmortal()

Remoto¶

• Se han eliminado PyFrame_BlockSetup() y PyFrame_BlockPop(). (Aportado por Mark Shannon en bpo-40222.)

• Quite las siguientes macros matemáticas usando la variable errno:

  • Py_ADJUST_ERANGE1()

  • Py_ADJUST_ERANGE2()

  • Py_OVERFLOWED()

  • Py_SET_ERANGE_IF_OVERFLOW()

  • Py_SET_ERRNO_ON_MATH_ERROR()

  (Aportado por Victor Stinner en bpo-45412.)

• Elimine las macros Py_UNICODE_COPY() y Py_UNICODE_FILL(), obsoletas desde Python 3.3. Utilice PyUnicode_CopyCharacters() o memcpy() (cadena wchar_t*) y las funciones PyUnicode_Fill() en su lugar. (Aportado por Victor Stinner en bpo-41123.)

• Elimine el archivo de encabezado pystrhex.h. Solo contiene funciones privadas. Las extensiones C solo deben incluir el archivo de encabezado principal <Python.h>. (Aportado por Victor Stinner en bpo-45434.)

• Quite la macro Py_FORCE_DOUBLE(). Fue utilizado por la macro Py_IS_INFINITY(). (Aportado por Victor Stinner en bpo-45440.)

• Los siguientes elementos ya no están disponibles cuando se define Py_LIMITED_API:

  • PyMarshal_WriteLongToFile()

  • PyMarshal_WriteObjectToFile()

  • PyMarshal_ReadObjectFromString()

  • PyMarshal_WriteObjectToString()

  • la macro Py_MARSHAL_VERSION

  Estos no forman parte del limited API.

  (Aportado por Victor Stinner en bpo-45474.)

• Exclude PyWeakref_GET_OBJECT() from the limited C API. It never worked since the PyWeakReference structure is opaque in the limited C API. (Contributed by Victor Stinner in bpo-35134.)

• Quite la macro PyHeapType_GET_MEMBERS(). Fue expuesto en la API pública de C por error, solo debe ser utilizado por Python internamente. Utilice el miembro PyTypeObject.tp_members en su lugar. (Aportado por Victor Stinner en bpo-40170.)

• Elimine la macro HAVE_PY_SET_53BIT_PRECISION (movida a la API de C interna). (Aportado por Victor Stinner en bpo-45412.)

• Elimine las API del codificador Py_UNICODE, ya que han quedado obsoletas desde Python 3.3, se usan poco y son ineficientes en relación con las alternativas recomendadas.

  Las funciones eliminadas son:

  • PyUnicode_Encode()

  • PyUnicode_EncodeASCII()

  • PyUnicode_EncodeLatin1()

  • PyUnicode_EncodeUTF7()

  • PyUnicode_EncodeUTF8()

  • PyUnicode_EncodeUTF16()

  • PyUnicode_EncodeUTF32()

  • PyUnicode_EncodeUnicodeEscape()

  • PyUnicode_EncodeRawUnicodeEscape()

  • PyUnicode_EncodeCharmap()

  • PyUnicode_TranslateCharmap()

  • PyUnicode_EncodeDecimal()

  • PyUnicode_TransformDecimalToASCII()

  Ver PEP 624 para más detalles y migration guidance. (Aportado por Inada Naoki en bpo-44029.)

tarfile¶

• The extraction methods in tarfile, and shutil.unpack_archive(), have a new a filter argument that allows limiting tar features than may be surprising or dangerous, such as creating files outside the destination directory. See Extraction filters for details. In Python 3.12, use without the filter argument will show a DeprecationWarning. In Python 3.14, the default will switch to 'data'. (Contributed by Petr Viktorin in PEP 706.)

OpenSSL¶

• Windows builds and macOS installers from python.org now use OpenSSL 3.0.