Meta tags:
description=Aprende cómo funcionan los paquetes de Python: crea un paquete con __init__.py, usa importaciones absolutas y relativas, expón una API pública limpia y evita…;

Headings (most frequently used words):

de, paquete, un, paquetes, py, importaciones, el, python, la, __init__, relativas, nombres, usar, módulos, clave, archivo, los, estructura, exponer, del, módulo, sistema, importación, vs, diferencia, absolutas, controlar, api, pública, con, __all__, anidados, sub, ejemplo, práctico, construir, geometry, espacio, cómo, encuentra, distribuir, errores, comunes, resumen, práctica, mínima, nivel, cuándo, hasta, qué, profundidad, deberías, llegar, directorios, shapes, conversions, falta, nombrar, igual, que, biblioteca, estándar, ejecutar, como, script, circulares, entre, mismo, importerror, al, fuera,

Text of the page (most frequently used words):
python (93), #paquete (51), import (41), __init__ (32), copiar (31), from (28), myapp (28), que (26), con (25), los (22), #paquetes (22), geometry (20), utils (20), nombres (18), una (18), directorio (16), greet (16), para (15), aprender (15), importaciones (15), the (15), del (14), matplotlib (14), mysql (13), módulos (12), importación (12), mongodb (12), archivo (11), package (11), como (11), elementos (11), print (10), relativas (9), directory (9), return (9), circle_area (8), shapes (8), def (8), módulo (8), sys (8), listas (8), html (7), __all__ (7), las (7), pip (7), lista (7), conversions (7), email (7), math (7), degrees_to_radians (7), crear (7), tuplas (7), espacio (6), solo (6), lugar (6), services (6), path (6), height (6), radius (6), nivel (6), analytics (6), eliminar (6), métodos (6), datos (6), w3docs (5), json (5), cómo (5), absolutas (5), file (5), por (5), actual (5), siempre (5), script (5), config (5), usar (5), puede (5), importar (5), biblioteca (5), directorios (5), rectangle_area (5), radians (5), float (5), degrees (5), base (5), max_retries (5), greetings (5), archivos (5), string (5), strings (5), primeros (5), pasos (5), tutorial (5), variables (5), formatter (5), color (5), english (4), generator (4), práctica (4), desde (4), sub (4), controlar (4), api (4), pública (4), clave (4), with (4), name (4), parent (4), relativa (4), relative (4), importerror (4), importa (4), mismo (4), directamente (4), usa (4), estándar (4), pero (4), build (4), dentro (4), alice (4), radians_to_degrees (4), triangle_area (4), son (4), recorrer (4), regresión (4), diccionarios (4), acceder (4), code (3), encoder (3), editor (3), cuestionarios (3), ejercicios (3), php (3), javascript (3), css (3), errores (3), comunes (3), distribuir (3), anidados (3), entornos (3), virtuales (3), inside (3), install (3), sin (3), absoluta (3), ejecuta (3), module (3), ejecutar (3), trata (3), ahora (3), entorno (3), modo (3), desarrollo (3), pyproject (3), toml (3), home (3), nombre (3), 180 (3), width (3), area (3), estructura (3), superior (3), generate_report (3), reports (3), daily (3), parte (3), también (3), farewell (3), este (3), significa (3), árbol (3), hello (3), escribir (3), cadenas (3), unir (3), ver (3), tools (3), todos (2), italiano (2), português (2), español (2), français (2), русский (2), deutsch (2), beautifier (2), diff (2), password (2), herramientas (2), try (2), java (2), git (2), libros (2), fragmentos (2), resumen (2), encuentra (2), ejemplo (2), práctico (2), construir (2), diferencia (2), this (2), page (2), pytest (2), next (2), same (2), what (2), makes (2), versions (2), before (2), consulta (2), código (2), proyecto (2), cualquier (2), instalación (2), editable (2), raíz (2), convierte (2), primera (2), contiene (2), entrada (2), sea (2), raise (2), attempted (2), known (2), fuera (2), suele (2), ser (2), función (2), entre (2), evita (2), sigue (2), funciona (2), virtual (2), independientemente (2), requires (2), simple (2), utilities (2), project (2), setuptools (2), src (2), otros (2), encuentre (2), estar (2), menos (2), projects (2), donde (2), cuando (2), único (2), múltiples (2), exponer (2), convert (2), paso (2), niveles (2), profundidad (2), separados (2), forma (2), independiente (2), dos (2), qué (2), charts (2), bar (2), puntos (2), contener (2), bajo (2), runs (2), funcionan (2), quieres (2), cuándo (2), message (2), user (2), bob (2), ambos (2), disponibles (2), más (2), empty (2), spanish (2), sistema (2), and (2), handling (2), números (2), clases (2), limit (2), colección (2), delete (2), ordenar (2), cuadrícula (2), dispersión (2), distribución (2), introducción (2), bucles (2), conjuntos (2), set (2), sets (2), cambiar (2), agregar (2), hash (2), 2026, derechos, reservados, hecho, desarrolladores, idioma, política, privacidad, contacto, acerca, empresa, tutoriales, ejemplos, gratuitos, web, 2014, previous, yes, was, helpful, comprobar, __package__, any, setup, organización, instalar, terceros, mantener, aisladas, dependencias, encontrado, venv, exportados, descripción, breve, concepto, ejecútalo, reestructura, punto, separado, importe, run, will, imported, only, when, function, called, some_function, delayed, breaks, cycle, load, time, tienes, circular, síntomas, incluyen, aparecen, inesperadamente, solución, mover, lógica, compartida, tercer, retrasar, interior, cuerpo, none, circulares, indicó, anteriormente, rompe, rompiendo, relacionado, nombrar, igual, olvidas, generalmente, funcionando, ignora, completo, explícito, añade, falta, instálalo, localmente, durante, description, version, backends, legacy, backend, wheel, system, mínimo, metadata, my_project, compartir, instalarlo, necesitas, instala, manipulación, manual, consejo, debe, estas, ubicaciones, está, encontrará, esté, viven, instalados, site, packages, variable, pythonpath, ejecución, interactivo, escribes, busca, orden, cotidiano, incluye, hace, intención, inequívoca, todas, versiones, fusiona, lógico, esto, principalmente, útil, grandes, organizaciones, dividen, repositorios, 141592653589793, 274333882308138, selectivas, 5707963267948966, 53981633974483, main, sits, public, triangle, rectangle, must, non, negative, valueerror, circle, given, construyamos, pequeño, realista, tres, cuatro, señal, crecido, demasiado, debería, dividirse, instalables, mayoría, proyectos, suficiente, hasta, deberías, llegar, caller, bien, expone, barchart, profundamente, anidado, ruta, completa, pie, weekly, pueden, cada, subdirectorio, necesita, propio, trae, existiendo, simplemente, interfaz, anunciada, guion, inicial, excluyen, convención, _private, intentionally, not, exported, exporta, documenta, considera, público, right, part, wrong, breaking, imports, ejecutas, lanza, advertencia, útiles, dejar, claro, proviene, alguna, externa, facilitan, refactorización, porque, mueven, renombras, two, dots, sms, one, dot, abuelo, así, sucesivamente, padre, navegar, relativo, ubicación, pep, inequívocas, invoque, estilo, defecto, recomendado, sending, send_welcome, absolute, starts, top, level, tiene, aspecto, nunca, depende, dónde, realiza, whatever, defines, están, patrón, habitual, utilizados, usuarios, puedan, that, fine, can, mínima, definir, inicialización, configuración, logging, comprobaciones, versión, etc, estén, vez, cualquiera, sus, vacío, pretendes, pypi, varios, relacionados, utilidad, pequeña, autocontenida, situación, importan, misma, palabra, ofrece, jerarquía, espacios, comparten, especial, llamado, única, unidad, importable, carpeta, muchos, capítulo, explica, exponen, correctamente, evitar, problemas, confunden, principiantes, aprende, crea, expón, limpia, peticiones, http, tooling, best, practices, threading, asyncio, concurrency, csv, random, itertools, collections, lanzar, excepciones, error, standard, library, sumar, invertir, duplicados, how, enumeraciones, abstractas, encapsulamiento, polimorfismo, dataclasses, static, classmethod, property, mágicos, advanced, oop, sentencia, match, enumerate, zip, map, comprensiones, gestores, contexto, recursión, closures, generadores, decoradores, args, kwargs, sugerencias, tipo, 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, decisión, train, test, escalar, múltiple, polinomial, lineal, diagrama, normal, percentil, desviación, media, mediana, moda, machine, learning, gráficos, pastel, histogramas, barras, subplot, etiquetas, líneas, marcadores, trazado, pyplot, django, scipy, pandas, numpy, modules, leer, manejo, formateo, usuario, except, regex, matemáticas, fechas, ámbito, iteradores, herencia, objetos, arrays, lambda, funciones, for, while, else, operadores, booleanos, casting, tipos, comentarios, sintaxis, actualizar, desempaquetar, tupla, segmentación, salida, modificar, iterar, sobre, comprensión, globales, formato, caracteres, escape, diccionario, concatenar, asignar, valores, conjunto, añadir, iniciar, sesión, buscar, formatters, url, reverse, sha256, md5, length, calculator, colors, hsl, hex, mixer, converter, picker, general, cursos, estructurar,

Text of the page (random words):
de un set acceder a tuplas agregar elementos añadir elementos a una lista agregar elementos a un conjunto asignar múltiples valores cambiar elementos cambiar elementos de una lista concatenar strings copiar diccionarios copiar listas métodos de diccionario caracteres de escape cadenas de formato variables globales unir listas unir sets unir tuplas comprensión de listas métodos de lista iterar sobre diccionarios recorrer listas recorrer sets recorrer tuplas modificar strings diccionarios anidados variables de salida python home listas de python conjuntos en python python strings tuplas en python variables en python eliminar elementos eliminar elementos de una lista eliminar elementos de un set métodos de conjuntos segmentación de cadenas ordenar listas métodos de string métodos de tupla desempaquetar tuplas actualizar tuplas nombres de variables introducción a python primeros pasos con python sintaxis de python comentarios en python variables en python tipos de datos en python números en python casting en python strings de python booleanos en python operadores de python listas de python tuplas de python diccionarios en python python if else bucles while en python bucles for en python funciones en python python lambda arrays en python clases y objetos en python herencia en python iteradores de python ámbito en python módulos de python fechas en python matemáticas en python python json python regex python pip python try except entrada de usuario en python formateo de cadenas en python file handling manejo de archivos en python leer archivos en python escribir crear archivos en python eliminar archivos en python python modules tutorial de numpy tutorial de pandas tutorial de scipy tutorial de django python matplotlib introducción a matplotlib primeros pasos con matplotlib matplotlib pyplot trazado con matplotlib marcadores de matplotlib líneas en matplotlib etiquetas en matplotlib cuadrícula de matplotlib subplot de matplotlib dispersión en matplotlib barras en matplotlib histogramas con matplotlib gráficos de pastel con matplotlib machine learning primeros pasos media mediana moda desviación estándar percentil distribución de datos distribución normal de datos diagrama de dispersión regresión lineal regresión polinomial regresión múltiple escalar train test árbol de decisión matriz de confusión agrupamiento jerárquico regresión logística búsqueda en cuadrícula datos categóricos k means agregación bootstrap validación cruzada curva auc roc k vecinos más cercanos python mysql primeros pasos con mysql mysql crear base de datos mysql crear tabla mysql insert mysql select mysql where 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 paquetes de python y el sistema de importación aprende cómo funcionan los paquetes de python crea un paquete con __init__ py usa importaciones absolutas y relativas expón una api pública limpia y evita errores comunes un paquete es un directorio de módulos de python que se trata como una única unidad importable donde un módulo es un solo archivo py un paquete es una carpeta que puede contener muchos módulos y sub paquetes que el sistema de importación de python puede recorrer como un árbol este capítulo explica cómo crear paquetes controlar lo que exponen escribir importaciones absolutas y relativas correctamente y evitar los problemas que confunden a los principiantes módulos vs paquetes la diferencia clave un módulo es un solo archivo py greetings py module copiar un paquete es un directorio que contiene al menos un archivo especial llamado __init__ py greetings package __init__ py english py spanish py copiar ambos se importan con la misma palabra clave import pero un paquete te ofrece una jerarquía de espacios de nombres greetings english y greetings spanish son módulos separados pero comparten el espacio de nombres greetings cuándo usar un módulo vs un paquete situación usar una utilidad pequeña y autocontenida módulo un archivo py varios módulos relacionados que quieres bajo un mismo nombre paquete un directorio una biblioteca que pretendes distribuir en pypi paquete con estructura src el archivo __init__ py __init__ py es lo que convierte un directorio en un paquete python lo ejecuta la primera vez que se importa el paquete o cualquiera de sus módulos puede estar vacío o puede importar nombres de sub módulos para que estén disponibles a nivel del paquete ejecutar inicialización a nivel del paquete configuración de logging comprobaciones de versión etc definir __all__ para controlar from package import estructura mínima de un paquete myapp __init__ py can be empty utils py config py copiar myapp __init__ py empty that is fine copiar myapp utils py def greet name return f hello name copiar importar desde fuera del paquete from myapp utils import greet print greet alice hello alice copiar exponer nombres a nivel del paquete un patrón habitual es importar los nombres más utilizados en __init__ py para que los usuarios puedan escribir from myapp import greet en lugar de from myapp utils import greet myapp __init__ py from utils import greet from config import max_retries copiar ahora ambos nombres están disponibles directamente en el paquete import myapp print myapp greet bob hello bob print myapp max_retries whatever config py defines copiar importaciones absolutas una importación absoluta siempre parte del paquete de nivel superior o de un directorio en sys path nunca depende de dónde se encuentre el archivo que realiza la importación project myapp __init__ py utils py services __init__ py email py copiar dentro de email py una importación absoluta tiene este aspecto myapp services email py from myapp utils import greet absolute starts from the top level package def send_welcome user message greet user print f sending message copiar las importaciones absolutas son el estilo por defecto y el recomendado pep 8 son inequívocas independientemente de cómo se invoque python importaciones relativas una importación relativa usa puntos para navegar por el árbol de paquetes relativo a la ubicación del archivo actual significa el paquete actual significa el paquete padre significa el paquete abuelo y así sucesivamente myapp services email py one dot import from myapp services same directory from import sms two dots import from myapp parent directory from utils import greet copiar cuándo usar importaciones relativas las importaciones relativas son útiles dentro de un paquete cuando quieres dejar claro que greet proviene de este paquete y no de alguna biblioteca externa con el mismo nombre también facilitan la refactorización porque las importaciones se mueven con el paquete si renombras el directorio de nivel superior advertencia las importaciones relativas solo funcionan dentro de un paquete si ejecutas python myapp utils py directamente python lo trata como un script independiente no como parte de un paquete y una importación relativa lanza importerror attempted relative import with no known parent package ejecuta el paquete con python m myapp utils en su lugar wrong runs utils py as a script breaking relative imports python myapp utils py right runs utils py as part of the myapp package python m myapp utils copiar controlar la api pública con __all__ __all__ es una lista de nombres que from package import exporta también documenta qué considera el paquete como público myapp __init__ py from utils import greet farewell from config import max_retries __all__ greet max_retries farewell is intentionally not exported copiar ahora from myapp import trae solo greet y max_retries la función farewell sigue existiendo simplemente no forma parte de la interfaz pública anunciada los nombres con un guion bajo inicial _private también se excluyen de import por convención paquetes anidados sub paquetes los paquetes pueden contener otros paquetes cada subdirectorio necesita su propio __init__ py analytics __init__ py reports __init__ py daily py weekly py charts __init__ py bar py pie py copiar importa un módulo profundamente anidado con la ruta completa con puntos from analytics reports daily import generate_report from analytics charts bar import barchart copiar o bien si analytics __init__ py los expone analytics __init__ py from reports daily import generate_report copiar caller from analytics import generate_report copiar hasta qué profundidad deberías llegar un paquete con tres o cuatro niveles de profundidad suele ser una señal de que ha crecido demasiado y debería dividirse en paquetes de nivel superior separados instalables de forma independiente para la mayoría de los proyectos dos niveles package module es suficiente un ejemplo práctico construir un paquete geometry construyamos un paquete pequeño pero realista paso a paso estructura de directorios geometry __init__ py shapes py conversions py copiar shapes py geometry shapes py import math def circle_area radius return the area of a circle with the given radius if radius 0 raise valueerror radius must be non negative return math pi radius 2 def rectangle_area width height return the area of a rectangle return width height def triangle_area base height return the area of a triangle return 0 5 base height copiar conversions py geometry conversions py def degrees_to_radians degrees convert degrees to radians import math return degrees math pi 180 def radians_to_degrees radians convert radians to degrees import math return radians 180 math pi copiar __init__ py exponer los nombres clave geometry __init__ py geometry simple 2 d geometry utilities public api circle_area radius float rectangle_area width height float triangle_area base height float degrees_to_radians degrees float radians_to_degrees radians float from shapes import circle_area rectangle_area triangle_area from conversions import degrees_to_radians radians_to_degrees __all__ circle_area rectangle_area triangle_area degrees_to_radians radians_to_degrees copiar usar el paquete main py sits next to the geometry directory import geometry print geometry circle_area 5 78 53981633974483 print geometry rectangle_area 4 6 24 print geometry degrees_to_radians 90 1 5707963267948966 copiar o con importaciones selectivas from geometry import circle_area degrees_to_radians print circle_area 3 28 274333882308138 print degrees_to_radians 180 3 141592653589793 copiar paquetes de espacio de nombres python 3 3 desde python 3 3 un directorio sin __init__ py es un paquete de espacio de nombres python fusiona todos los directorios con el mismo nombre en sys path en un único paquete lógico esto es principalmente útil para grandes organizaciones que dividen un único paquete entre múltiples repositorios o directorios de instalación para el desarrollo cotidiano incluye siempre __init__ py hace que tu intención sea inequívoca y funciona en todas las versiones de python cómo encuentra python los paquetes cuando escribes import geometry python busca en sys path en orden el directorio del script en ejecución o el directorio actual en modo interactivo los directorios en la variable de entorno pythonpath los directorios de la biblioteca estándar el directorio site packages donde viven los paquetes instalados con pip import sys print sys path copiar el directorio del paquete debe estar directamente dentro de una de estas ubicaciones si geometry está en home alice projects python no lo encontrará a menos que home alice projects esté en sys path consejo usa un entorno virtual e instala tu paquete en modo de desarrollo pip install e para que python siempre lo encuentre sin manipulación manual de sys path distribuir un paquete para compartir un paquete con otros o instalarlo con pip necesitas un pyproject toml en la raíz del proyecto my_project pyproject toml build metadata src geometry __init__ py shapes py conversions py copiar un pyproject toml mínimo build system requires setuptools 68 wheel build backend setuptools backends legacy build project name geometry version 0 1 0 description simple 2 d geometry utilities requires python 3 9 copiar instálalo localmente en modo editable durante el desarrollo pip install e copiar ahora import geometry funciona en cualquier lugar de tu entorno virtual independientemente de tu directorio actual errores comunes falta el archivo __init__ py si olvidas __init__ py python 3 trata el directorio como un paquete de espacio de nombres que generalmente sigue funcionando pero python 2 lo ignora por completo sé explícito añade siempre __init__ py nombrar un paquete igual que un módulo de la biblioteca estándar evita nombres como math json os email python puede importar tu paquete en lugar del de la biblioteca estándar rompiendo código no relacionado ejecutar un módulo de paquete como script como se indicó anteriormente ejecutar python myapp services email py directamente rompe las importaciones relativas usa python m myapp services email en su lugar importaciones circulares entre módulos del mismo paquete si shapes py importa de conversions py y conversions py importa de shapes py tienes una importación circular los síntomas incluyen importerror o nombres que aparecen inesperadamente como none la solución suele ser mover la lógica compartida a un tercer módulo o retrasar la importación al interior del cuerpo de una función delayed import breaks the cycle at module load time def some_function from shapes import circle_area imported only when the function is called copiar importerror al usar importaciones relativas fuera de un paquete will raise importerror attempted relative import with no known parent package if run as python myapp utils py from import config relative import inside utils py copiar ejecútalo como python m myapp utils o reestructura para que el punto de entrada sea un script separado que importe el paquete resumen concepto descripción breve paquete un directorio con __init__ py que contiene módulos __init__ py convierte un directorio en paquete se ejecuta en la primera importación importación absoluta from myapp utils import greet siempre desde la raíz importación relativa from utils import greet relativa al archivo actual __all__ lista los nombres exportados por from package import paquete de espaci...