Meta tags:
description= Aprende las sugerencias de tipo en Python: anotar variables, funciones y clases, usar el módulo typing y verificar tipos con mypy.;
Headings (most frequently used words):
de, python, con, tipo, anotar, mypy, list, sugerencias, en, por, sintaxis, 10, genéricos, optional, vs, qué, usar, variables, funciones, el, módulo, typing, moderna, clases, alias, typevar, comprobación, tipos, estática, tipado, gradual, errores, comunes, referencia, rápida, temas, relacionados, práctica, parámetros, valor, defecto, args, kwargs, tuple, set, dict, union, callable, any, integrados, unión, classvar, ejemplo, detectar, un, error, opciones, útiles, referencias, anticipadas, anotaciones, tiempo, ejecución, none, compatibilidad, versiones,
Text of the page (most frequently used words):
#python (90), str (74), int (64), tipo (41), def (37), none (35), print (29), copiar (28), list (26), las (26), que (26), return (26), con (23), una (23), typing (22), tipos (21), self (20), los (18), value (18), optional (18), mypy (17), float (17), para (15), aprender (15), from (14), import (14), más (14), matplotlib (14), anotar (13), dict (13), mysql (13), typevar (12), sugerencias (12), type (12), any (12), anotaciones (12), mongodb (12), variables (11), por (11), name (11), items (11), retorno (11), función (11), valor (11), sin (11), elementos (11), clases (10), módulo (10), funciones (10), the (10), union (10), del (10), sintaxis (9), métodos (9), callable (9), tuple (9), usa (9), alice (9), alias (8), user_id (8), balance (8), counts (8), listas (8), html (7), errores (7), strings (7), lista (7), cada (7), owner (7), amount (7), tuplas (7), práctica (6), desde (6), usar (6), variable (6), and (6), __init__ (6), classvar (6), cualquier (6), código (6), error (6), como (6), significa (6), true (6), greet (6), argumento (6), crear (6), word (6), string (6), set (6), eliminar (6), datos (6), w3docs (5), referencia (5), genéricos (5), next (5), clase (5), bool (5), cuando (5), todas (5), cadenas (5), partir (5), hello (5), comprobador (5), double (5), bankaccount (5), integrados (5), archivos (5), primeros (5), pasos (5), tutorial (5), formatter (5), color (5), json (4), code (4), generator (4), tipado (4), gradual (4), comprobación (4), moderna (4), qué (4), this (4), that (4), what (4), annotation (4), son (4), parámetros (4), valores (4), nivel (4), devuelve (4), anotación (4), puede (4), defecto (4), tiempo (4), ejecución (4), archivo (4), node (4), class (4), anota (4), también (4), pero (4), antes (4), numeric (4), puedes (4), timeout (4), account (4), parse (4), lugar (4), word_count (4), text (4), log (4), stringify (4), prices (4), después (4), dos (4), regresión (4), diccionarios (4), acceder (4), encoder (3), editor (3), cuestionarios (3), ejercicios (3), php (3), javascript (3), css (3), ejemplos (3), web (3), relacionados (3), comunes (3), args (3), kwargs (3), comprobar (3), types (3), function (3), returns (3), base (3), abstractas (3), donde (3), atributo (3), significativo (3), escribir (3), directamente (3), añade (3), __future__ (3), annotations (3), siempre (3), solo (3), anticipada (3), comillas (3), agrega (3), esto (3), head (3), mismo (3), nombre (3), terceros (3), strict (3), untyped (3), defs (3), sobre (3), missing (3), file (3), demo (3), result (3), pip (3), esa (3), first_item (3), coordinates (3), instancia (3), escribes (3), deposit (3), first (3), cat (3), else (3), get (3), for (3), func (3), find_user (3), not (3), bob (3), one (3), users (3), fields (3), colección (3), connect (3), secure (3), puntos (3), recorrer (3), unir (3), ver (3), tools (3), italiano (2), português (2), español (2), français (2), русский (2), deutsch (2), english (2), beautifier (2), diff (2), password (2), herramientas (2), try (2), java (2), git (2), libros (2), fragmentos (2), temas (2), rápida (2), estática (2), page (2), runtime (2), purpose (2), module (2), which (2), correctly (2), accepts (2), integers (2), single (2), integer (2), can (2), does (2), mean (2), hint (2), forma (2), declarar (2), dataclasses (2), atributos (2), objetos (2), desactiva (2), toma (2), tupla (2), ejecuta (2), debes (2), compatibilidad (2), ignore (2), devolver (2), almacenan (2), evalúan (2), referencias (2), anticipadas (2), myclass (2), elimina (2), necesidad (2), hace (2), adelante (2), cadena (2), activa (2), proyecto (2), vez (2), anotado (2), check (2), línea (2), proyectos (2), found (2), ejecutar (2), reporta (2), upper (2), detectar (2), estático (2), conjunto (2), infiere (2), información (2), sola (2), mientras (2), vector (2), matrix (2), distance (2), max_retries (2), config (2), withdraw (2), false (2), initial_balance (2), dentro (2), leer (2), nothing (2), dog (2), split (2), escape (2), asignable (2), returntype (2), apply_twice (2), útil (2), verificar (2), two (2), unique_tags (2), 1920 (2), 1080 (2), dimensions (2), first_names (2), consulta (2), create_user (2), total (2), example (2), com (2), port (2), host (2), tiene (2), add (2), subject (2), firma (2), diccionario (2), asignar (2), versión (2), bibliotecas (2), editores (2), handling (2), números (2), limit (2), delete (2), ordenar (2), cuadrícula (2), dispersión (2), distribución (2), introducción (2), bucles (2), conjuntos (2), sets (2), cambiar (2), agregar (2), hash (2), 2026, todos, derechos, reservados, hecho, desarrolladores, idioma, política, privacidad, contacto, acerca, empresa, tutoriales, gratuitos, 2014, previous, yes, was, helpful, complex, shorter, enforce, raising, typeerror, create, generic, placeholder, preserves, relationships, across, declare, whose, changes, array, itself, ignored, checkers, either, parameter, omitted, entirely, funcionan, natural, necesarias, campos, dataclass, viven, genérica, mapea, enteros, nada, parámetro, entero, significado, anterior, funciona, necesitas, ambos, importaciones, versiones, get_name_safe, correct, bug, get_name, wrong, will, flag, callers, assume, always, frecuente, sea, posible, inspeccionan, resuelve, problema, automáticamente, clone, works, with, quotes, anteriores, ansiosa, eso, lanza, nameerror, inicio, convierte, lazy, poner, manualmente, definida, pon, entre, convertirlo, biblioteca, tenga, comentario, explicando, medida, mejora, cobertura, primero, llamadas, propensas, nuevo, primer, día, enfoque, práctico, existente, tienes, admite, coexisten, pacíficamente, omite, menos, establezca, ignore_missing_imports, mantiene, configuración, fuera, comandos, pyproject, toml, tool, ini, exige, definiciones, disallow, comprueba, suprime, stubs, faltantes, imports, comprobaciones, opcionales, recomendado, nuevos, efecto, opción, opciones, útiles, problemas, convierten, detectó, desajuste, tuvieras, descubrirlo, producción, checked, source, argument, has, incompatible, expected, passing, instead, guarda, siguiente, ejemplo, my_script, luego, ejecútalo, install, utilizado, instálalo, restringir, permitidos, cuál, lleva, tendrías, perder, seguridad, permite, funcione, preserva, relaciones, instrucción, explícitos, inspeccionables, structured, filename, userid, simple, largo, complejo, corto, advierte, intentas, establecer, está, destinado, compartirse, marcar, pertenece, nunca, 120, 100, __repr__, must, positive, valueerror, raise, level, default, equivalente, esta, limpia, fácil, introdujo, operador, uniones, reemplazando, unión, así, sucesivamente, importar, moderación, escotilla, protección, ofrecen, apropiado, interactuar, durante, migración, grande, especial, ese, argumentos, compleja, desconocida, pasa, argtypes, acepta, genuinamente, varios, idiomático, ser, sabe, llamar, resultado, verificación, abreviatura, úsalo, estar, ausente, cosa, allá, básicos, importa, muchos, fusionaron, equivalentes, posicional, sigue, siendo, ordinaria, floats, modo, nombrado, admin, role, round, sum, elemento, 443, uses, defaults, connecting, 8080, van, implícitamente, omitir, válido, explícito, deja, clara, intención, message, sending, body, send_email, coloca, cierran, afectan, comportamiento, intérprete, ignora, demás, __annotations__, declared, but, yet, assigned, todavía, denomina, declaración, is_active, price, age, seguidos, introdujeron, mediante, refinado, principal, entonces, continuación, indican, mínima, estuvo, disponible, primera, pep, 484, tipadas, exponen, autocompletado, método, fáciles, comunica, contrato, documentación, documenta, cambia, indica, llamada, rompe, refactorización, vuelve, segura, pycharm, otros, subrayan, desajustes, detectan, inmediato, resuelven, renunciar, dinamismo, dinámico, contener, flexibilidad, poderosa, grandes, sean, difíciles, navegar, saber, leyendo, llama, análisis, importantes, cuándo, usarlas, este, capítulo, cubre, permiten, adjuntar, esperada, aplica, metadatos, consumidos, linters, comprobadores, aprende, peticiones, http, pytest, paquetes, entornos, virtuales, tooling, best, practices, threading, asyncio, concurrency, csv, random, sys, itertools, collections, lanzar, excepciones, standard, library, sumar, invertir, duplicados, how, enumeraciones, encapsulamiento, polimorfismo, static, classmethod, property, mágicos, advanced, oop, sentencia, match, enumerate, zip, map, comprensiones, gestores, contexto, recursión, closures, generadores, decoradores, intermediate, actualización, find, insertar, join, update, drop, table, order, where, select, insert, tabla, vecinos, cercanos, curva, auc, roc, validación, cruzada, agregación, bootstrap, means, categóricos, búsqueda, logística, agrupamiento, jerárquico, matriz, confusión, árbol, decisión, train, test, escalar, múltiple, polinomial, lineal, diagrama, normal, percentil, desviación, estándar, media, mediana, moda, machine, learning, gráficos, pastel, histogramas, barras, subplot, etiquetas, líneas, marcadores, trazado, pyplot, django, scipy, pandas, numpy, modules, manejo, formateo, entrada, usuario, except, regex, matemáticas, fechas, módulos, ámbito, iteradores, herencia, arrays, lambda, while, operadores, booleanos, casting, comentarios, nombres, actualizar, desempaquetar, segmentación, home, salida, anidados, modificar, iterar, comprensión, globales, formato, caracteres, concatenar, múltiples, añadir, iniciar, sesión, buscar, formatters, url, reverse, sha256, md5, length, calculator, colors, hsl, hex, mixer, converter, picker, general, cursos, guía, completa,
Text of the page (random words):
mysql order by mysql delete mysql drop table mysql update mysql limit mysql join python mongodb primeros pasos con mongodb crear base de datos mongodb mongodb crear colección insertar en mongodb mongodb find consulta mongodb ordenar en mongodb mongodb delete eliminar colección en mongodb actualización en mongodb mongodb limit intermediate python f strings sugerencias de tipo args kwargs decoradores generadores closures recursión gestores de contexto comprensiones enumerate zip map sentencia match advanced oop métodos mágicos property static y classmethod dataclasses polimorfismo encapsulamiento clases abstractas enumeraciones python how to eliminar duplicados en listas invertir un string sumar dos números error handling and the standard library lanzar excepciones collections itertools os sys random archivos csv concurrency in python asyncio threading python tooling and best practices entornos virtuales paquetes pytest peticiones http sugerencias de tipo en python aprende las sugerencias de tipo en python anotar variables funciones y clases usar el módulo typing y verificar tipos con mypy las sugerencias de tipo permiten adjuntar información de tipo esperada a variables parámetros de función y valores de retorno python no las aplica en tiempo de ejecución son metadatos consumidos por editores linters y comprobadores de tipos como mypy para detectar errores antes de ejecutar una sola línea este capítulo cubre por qué son importantes las sugerencias de tipo y cuándo usarlas anotar variables y funciones tipos integrados y el módulo typing list dict optional union tuple any callable sintaxis moderna python 3 10 anotar clases y self genéricos y alias de tipo análisis estático con mypy errores comunes por qué usar sugerencias de tipo python tiene tipado dinámico una variable puede contener cualquier valor de cualquier tipo esa flexibilidad es poderosa pero hace que los proyectos grandes sean más difíciles de navegar no puedes saber el tipo del argumento de una función solo leyendo el lugar donde se llama las sugerencias de tipo resuelven esto sin renunciar al dinamismo de python los editores detectan errores de inmediato vs code pycharm y otros subrayan los desajustes de tipo mientras escribes la refactorización se vuelve más segura cambia la firma de una función y el comprobador de tipos te indica cada llamada que se rompe el código se documenta a sí mismo def greet name str str comunica el contrato sin necesidad de una cadena de documentación las bibliotecas son más fáciles de usar las bibliotecas tipadas exponen autocompletado para cada atributo y método las sugerencias de tipo se introdujeron en python 3 5 mediante pep 484 la sintaxis se ha refinado en cada versión principal desde entonces los ejemplos a continuación indican la versión mínima de python en que la sintaxis estuvo disponible por primera vez anotar variables añade dos puntos después del nombre de la variable seguidos del tipo name str alice age int 30 price float 9 99 is_active bool true copiar también puedes declarar el tipo de una variable sin asignar un valor todavía esto se denomina declaración anticipada y es útil dentro de clases o a nivel de módulo user_id int declared but not yet assigned user_id 42 copiar las anotaciones de tipo en variables a nivel de módulo no afectan el comportamiento en tiempo de ejecución se almacenan en el diccionario __annotations__ del módulo pero el intérprete las ignora por lo demás anotar funciones coloca anotaciones en los parámetros después de los dos puntos y en el valor de retorno después de antes de los dos puntos que cierran la firma def add a int b int int return a b def greet name str str return f hello name def send_email to str subject str body str none print f sending subject to to result int add 3 5 message str greet alice copiar none significa que la función no tiene un valor de retorno significativo devuelve none implícitamente omitir la anotación de retorno también es válido pero none explícito deja clara la intención parámetros con valor por defecto los valores por defecto van después de la anotación def connect host str port int 8080 secure bool false none print f connecting to host port secure secure connect example com uses defaults connect example com 443 true copiar args y kwargs anota el tipo del elemento no el tipo de la colección def total prices float float return sum prices def create_user fields str dict return fields print round total 9 99 4 50 12 00 2 26 49 print create_user name bob role admin copiar prices float significa que cada argumento posicional es un float en tiempo de ejecución prices sigue siendo una tuple ordinaria de floats del mismo modo fields str significa que el valor de cada argumento nombrado es un str el módulo typing para cualquier cosa más allá de los tipos integrados básicos importa desde el módulo typing python 3 5 a partir de python 3 9 muchos tipos de typing se fusionaron directamente en los equivalentes integrados consulta sintaxis moderna más adelante list tuple set dict from typing import list tuple set dict def first_names users list str str return users 0 if users else def dimensions tuple int int int return 1920 1080 32 def unique_tags items list str set str return set items def word_count text str dict str int counts dict str int for word in text split counts word counts get word 0 1 return counts print first_names alice bob alice print dimensions 1920 1080 32 print unique_tags py web py py web print word_count one two one one 2 two 1 copiar optional optional x es una abreviatura de union x none úsalo cuando un valor puede estar ausente from typing import optional def find_user user_id int optional str db 1 alice 2 bob return db get user_id returns none if not found name find_user 1 if name is not none print name upper alice missing find_user 99 print missing none copiar un comprobador de tipos ve optional str y sabe que debes verificar si el valor es none antes de llamar a métodos de string en el resultado sin esa verificación reporta un error union union x y significa que el valor puede ser del tipo x o del tipo y from typing import union def stringify value union int float str str return str value print stringify 42 42 print stringify 3 14 3 14 print stringify hi hi copiar union es más útil cuando una función acepta genuinamente varios tipos no relacionados si escribes union str none usa optional str en su lugar es más idiomático callable callable argtypes returntype anota una función que se pasa como argumento from typing import callable def apply_twice func callable int int value int int return func func value def double n int int return n 2 print apply_twice double 3 12 copiar callable int int significa un callable que toma un argumento int y devuelve un int si la lista de argumentos es compleja o desconocida usa callable returntype any any es un tipo especial que desactiva la comprobación de tipos para ese valor cada tipo es asignable a any y también asignable desde any from typing import any def log value any none print value log 42 log hello log 1 2 3 copiar usa any con moderación es una escotilla de escape que elimina la protección que ofrecen las sugerencias de tipo es apropiado al interactuar con código de terceros sin tipos o durante una migración gradual de un proyecto grande sintaxis moderna python 3 9 3 10 genéricos integrados python 3 9 a partir de python 3 9 puedes usar los tipos integrados directamente como genéricos sin importar desde typing python 3 9 def word_count text str dict str int counts dict str int for word in text split counts word counts get word 0 1 return counts def first items list int int none return items 0 if items else none print word_count cat dog cat cat 2 dog 1 print first 10 20 30 10 print first none copiar usa list str en lugar de list str dict str int en lugar de dict str int y así sucesivamente sintaxis de unión x y python 3 10 python 3 10 introdujo el operador para uniones reemplazando union x y y optional x python 3 10 def parse value str int none str if value is none return nothing return str value print parse hello hello print parse 42 42 print parse none nothing copiar str none es equivalente a optional str esta sintaxis es más limpia y fácil de leer anotar clases anota los atributos de instancia dentro de __init__ y agrega anotaciones de retorno a los métodos class bankaccount owner str class level annotation no default value balance float def __init__ self owner str initial_balance float 0 0 none self owner owner self balance initial_balance def deposit self amount float none if amount 0 raise valueerror deposit amount must be positive self balance amount def withdraw self amount float bool if amount self balance return false self balance amount return true def __repr__ self str return f bankaccount owner self owner r balance self balance 2f account bankaccount alice 100 0 account deposit 50 0 print account withdraw 30 0 true print account bankaccount owner alice balance 120 00 copiar la anotación de self siempre se infiere nunca escribes self bankaccount el tipo de retorno de __init__ es siempre none classvar usa classvar t de typing para marcar un atributo que pertenece a la clase y no a cada instancia from typing import classvar class config max_retries classvar int 3 timeout int def __init__ self timeout int none self timeout timeout print config max_retries 3 copiar un comprobador de tipos advierte si intentas establecer classvar en una instancia está destinado a compartirse a nivel de clase alias de tipo un alias de tipo da a un tipo largo o complejo un nombre más corto y significativo from typing import list tuple simple alias userid int filename str structured alias coordinates tuple float float matrix list list float def distance p1 coordinates p2 coordinates float return p1 0 p2 0 2 p1 1 p2 1 2 0 5 print distance 0 0 0 0 3 0 4 0 5 0 copiar a partir de python 3 12 usa la instrucción type para crear alias explícitos e inspeccionables python 3 12 type vector list float type matrix list vector copiar genéricos con typevar typevar te permite escribir una sola función que funcione con cualquier tipo mientras preserva las relaciones de tipo from typing import typevar list t typevar t def first_item items list t t return items 0 x int first_item 1 2 3 x is int s str first_item a b s is str copiar el comprobador de tipos infiere a partir del argumento cuál es t y lleva esa información al tipo de retorno sin typevar tendrías que devolver any y perder la seguridad de tipos puedes restringir typevar a un conjunto de tipos permitidos from typing import typevar numeric typevar numeric int float def double n numeric numeric return n 2 print double 4 8 int print double 2 5 5 0 float copiar comprobación de tipos estática con mypy mypy es el comprobador de tipos estático más utilizado para python instálalo con pip pip install mypy copiar luego ejecútalo sobre un archivo mypy my_script py copiar ejemplo detectar un error con mypy guarda lo siguiente como demo py def greet name str str return f hello name result greet 42 passing int instead of str print result upper copiar al ejecutar mypy demo py se reporta demo py 4 error argument 1 to greet has incompatible type int expected str found 1 error in 1 file checked 1 source file copiar python en sí ejecuta el código sin problemas los f strings convierten cualquier tipo pero mypy detectó el desajuste antes de que tuvieras que descubrirlo en producción opciones útiles de mypy opción efecto strict activa todas las comprobaciones opcionales recomendado para proyectos nuevos ignore missing imports suprime errores sobre stubs de terceros faltantes check untyped defs también comprueba tipos en funciones sin anotaciones disallow untyped defs exige anotaciones en todas las definiciones de función un archivo mypy ini o tool mypy en pyproject toml mantiene la configuración fuera de la línea de comandos mypy strict true ignore_missing_imports true copiar tipado gradual no tienes que anotar todas las funciones de una vez python admite el tipado gradual el código anotado y el no anotado coexisten pacíficamente mypy omite las funciones sin anotar por defecto a menos que se establezca check untyped defs un enfoque práctico para un proyecto existente añade anotaciones al código nuevo desde el primer día anota primero las funciones más llamadas o más propensas a errores activa strict módulo a módulo a medida que mejora la cobertura usa any solo donde una biblioteca de terceros no tenga tipos y agrega un comentario explicando por qué errores comunes referencias anticipadas si un tipo hace referencia a una clase definida más adelante en el mismo archivo pon el nombre entre comillas para convertirlo en una cadena una referencia anticipada class node def __init__ self value int next node none none none self value value self next next head node 1 node 2 print head value head next value 1 2 copiar a partir de python 3 10 agrega from __future__ import annotations al inicio del archivo esto convierte todas las anotaciones en cadenas lazy y elimina la necesidad de poner comillas manualmente anotaciones en tiempo de ejecución por defecto las anotaciones en python 3 9 y anteriores se evalúan de forma ansiosa eso significa que una referencia anticipada sin comillas lanza un nameerror works with quotes def clone self myclass myclass copiar con from __future__ import annotations python 3 7 todas las anotaciones se almacenan como cadenas y solo se evalúan cuando se inspeccionan lo que resuelve el problema de las referencias anticipadas automáticamente none vs optional un error frecuente es anotar un tipo de retorno como str cuando la función puede devolver none usa siempre optional str o str none cuando none sea un posible retorno from typing import optional wrong mypy will flag callers that assume this is always str def get_name user_id int str if user_id 0 return none type ignore this is the bug correct def get_name_safe user_id int optional str if user_id 0 return none return alice copiar list vs list compatibilidad de versiones si tu código se ejecuta en python 3 8 o anterior debes usar from typing import list y escribir list str en python 3 9 list str funciona directamente si necesitas compatibilidad con ambos usa las importaciones de typing o añade from __future__ import annotations referencia rápida anotación significado x int la variable x es un entero def f a str bool el parámetro a es str el valor de retorno es bool none la función no devuelve nada significativo optional str str o none union int str int o str list int list int lista de enteros dict str int dict str int dict que mapea str a int tuple int str tuple int str tupla de int str callable int str función que toma int y devuelve str any cualquier tipo desactiva la comprobación classvar t atributo a nivel de clase typevar t variable de tipo genérica temas relacionados funciones de python donde viven las anotaciones de tipo en parámetros y valores de retorno clases y objetos de python para anotar __init__ métodos y atributos de cl...
|
