La unión de tipos `X | None`
`X | None` describe un valor de tipo `X` o el valor `None`. En `-> str | None` indica qué puede devolver una función, no un valor predeterminado.
CKTIS / Python
Sintaxis, operadores y conceptos de programación. Encuentra una explicación, consulta un ejemplo y sigue aprendiendo.
`X | None` describe un valor de tipo `X` o el valor `None`. En `-> str | None` indica qué puede devolver una función, no un valor predeterminado.
Usa `X | None` para admitir un valor de tipo `X` o `None`. Si una clase se define más adelante, entrecomilla toda la anotación o usa la importación de `__future__`.
Usa `setUp()` para que cada prueba empiece con sus propios datos. Después comprueba valores con `assertEqual()` y una excepción esperada con `assertRaises()`.
Comprueba varias entradas en un método de prueba, identifica las subpruebas que fallan y distingue la igualdad de valores de una comprobación de excepciones.
Ejecuta una suite de pruebas o un caso individual y usa el `TestResult` devuelto para crear un resumen propio sin analizar el informe de texto.
En la definición de una función, `*args` reúne los argumentos posicionales sobrantes en una tupla. En una llamada, `*` desempaqueta un iterable en argumentos posicionales.
En Python 3.12, `*args` recoge los argumentos posicionales sobrantes en una tupla y `**kwargs` los argumentos por nombre sin correspondencia en un diccionario. En una llamada, los mismos símbolos desempaquetan argumentos.
En la definición de una función, `*items` reúne los argumentos posicionales restantes en una tupla. En una llamada, `*values` hace lo contrario: pasa los elementos de un iterable como argumentos posicionales separados.
Envuelve un registrador existente en `logging.LoggerAdapter` con un campo `team` para que las llamadas a `info`, `warning` y `error` compartan el contexto del equipo.
Usa `write()` para escribir texto en memoria por partes, `read()` para leer desde la posición actual y `getvalue()` para recuperar todo el búfer sin volver al principio.
AssertionError es una excepción integrada que se produce cuando la condición de una instrucción assert es falsa. Las aserciones comprueban supuestos internos del programa, no sirven para la validación obligatoria de entradas: la optimización puede eliminarlas.
Exception es la clase base integrada de Python para las excepciones ordinarias. Permite definir tipos de error personalizados y capturarlos conjuntamente, pero no abarca todos los descendientes de BaseException.
IndexError es una excepción integrada que se produce al intentar acceder a un elemento de una secuencia con un índice fuera de rango. Aprende cuáles son los límites de los índices válidos, qué diferencia hay entre indexar y usar un segmento, y cómo capturar esta excepción.
KeyError significa que no se encontró una clave solicitada en un mapping, como un dict. Aprende la diferencia entre acceder con corchetes y usar get(), y gestiona las claves que faltan sin ocultar errores que no están relacionados.
NameError significa que Python no pudo encontrar un nombre utilizado en los ámbitos disponibles. Comprueba la escritura, el orden de las asignaciones y las importaciones. Distingue NameError de AttributeError. UnboundLocalError es una subclase de NameError.
StopIteration indica que un iterador se ha agotado durante next(). Su atributo value puede contener el valor devuelto por un generador. Terminar un generador con return no es lo mismo que permitir que un StopIteration lanzado explícitamente escape de su código.
TimeoutError indica que una operación ha superado su límite de tiempo. En Python 3.14, asyncio.TimeoutError es un alias obsoleto de la misma clase, no una excepción distinta. Captura TimeoutError y distingue un tiempo de espera agotado de la cancelación normal de una tarea.
TypeError significa que una operación o función recibió un objeto de tipo inadecuado. Aprende en qué se diferencia de ValueError y cómo gestionarlo sin ocultar el problema subyacente.
UnboundLocalError se produce cuando una función lee una variable local que en ese momento no tiene ningún valor asignado. Es una subclase de NameError; una causa frecuente es una asignación que oculta una variable de un ámbito exterior.
ValueError indica que un argumento tiene el tipo correcto, pero un valor no aceptable. Aprende en qué se diferencia de TypeError y cómo generar y capturar esta excepción.
ZeroDivisionError es una excepción integrada que se produce cuando una división o una operación de resto utiliza un divisor igual a cero. Manéjala con except ZeroDivisionError cuando el programa pueda responder de forma adecuada a ese caso.
Devuelve el valor absoluto de un número o el módulo de un complejo.
Obtiene un iterador asíncrono mediante `__aiter__` sin esperar un valor.
Comprueba el valor lógico de los elementos hasta el primero falso.