Paquetes en Python: Creación y Uso de Módulos

Clase 29 de 44 • Curso de Python: Comprehensions, Funciones y Manejo de Errores

Resumen

¿Qué son los paquetes en Python?

Un paquete en Python es fundamentalmente una carpeta que contiene múltiples módulos, lo que permite una mejor organización y reutilización del código. Aunque parece simple a primera vista, hay aspectos clave a considerar al trabajar con paquetes. Vamos a profundizar en el concepto y ver cómo se implementan en el código.

¿Cómo crear un paquete en Python?

Para crear un paquete en Python, se necesita estructurar convenientemente las carpetas y archivos. A continuación, se explica paso a paso cómo hacerlo:

Crea una carpeta: En tu editor, crea una nueva carpeta al mismo nivel que tu archivo main.py. Esta carpeta se considerará un paquete.
Nombra la carpeta: Dale un nombre que tenga sentido, como package, para reflejar su función.
Agrega módulos: Dentro del paquete, crea archivos .py que representarán los módulos. Por ejemplo, mod1.py y mod2.py.

Definir funciones en módulos:

# En mod1.py
def funcion1():
    return "funcion1"

def funcion2():
    return "funcion2"

# En mod2.py
def funcion3():
    return "funcion3"

def funcion4():
    return "funcion4"

¿Cómo importar y usar un paquete?

Una vez creado el paquete, es crucial saber cómo importarlo y usarlo en un archivo Python, como main.py. Aquí está el proceso:

Importa las funciones que necesitas de cada módulo:

from package.mod1 import funcion1, funcion2
from package.mod2 import funcion3, funcion4

# Ejecución de las funciones
print(funcion1())
print(funcion2())
print(funcion3())
print(funcion4())

¿Qué es el archivo `init.py`?

¿Por qué y cuándo usar `init.py`?

Hasta Python 3.3, el archivo __init__.py era crucial para que Python reconociera un directorio como un paquete. Si bien desde entonces dejó de ser obligatorio, sigue siendo útil para:

Inicializar variables: Automatiza la creación de variables cada vez que se importa el paquete.
Definir namespaces: Permite gestionar espacios de nombres y minimizar conflictos entre nombres de funciones o variables.

¿Cómo usar `init.py`?

Si estás trabajando con versiones de Python anteriores a 3.3, debes crear este archivo. Sin embargo, desde la versión 3.3, es usado para inicializaciones específicas:

# Dentro de __init__.py

print("Se inició paquete")
url = "https://platzi.com"

import package.mod1
import package.mod2

Esto permite que cada vez que el paquete sea importado, se ejecuten estos comandos y las rutas se inicialicen apropiadamente.

Buenas prácticas para el trabajo con paquetes

Trabajar con paquetes y el archivo __init__.py eficientemente puede mejorar la mantenibilidad y escalabilidad de tus proyectos. Aquí algunas recomendaciones:

Usa __init__.py para gestionar importaciones: Al definir imports dentro de este archivo, facilitas el uso de un namespace que es más limpio y reduce errores de nombre duplicado.
Explora ejemplos profesionales: Examina proyectos open-source como los de Sebastián Ramírez para conocer prácticas de creación de APIs y ver cómo se estructuran paquetes profesionales.

Finalmente, recuerda que el manejo adecuado de paquetes ayuda a mantener un código bien estructurado y facilita la colaboración en proyectos de mayor envergadura. Todo este conocimiento te prepara mejor para el desarrollo profesional en Python. Sigue explorando y construyendo tus habilidades con constancia y dedicación. ¡El mundo de Python está a tus pies!

Carlos Rodríguez

student•

Podemos importar todo un módulo de un paquete y nombrándolo con la palabara clave as

# mod_2.py
import package.mod_2 as mod_2

print(mod_2.func_3())
print(mod_2.func_4())

. También podemos usar los paquetes desntro de un módulo que está en el mismo paquete

# mod_3.py
from .mod_1 import func_1
from . import mod_2

def func_5():
    return func_1()

def func_6():
    return mod_2.func_3()

. Este último es muy común usarlo en framework como django, flask entre otros.

oscar melgarejo

student•

seria como un alias?

Carlos Rodríguez

student•

Sí @omelgarejo, la palabra 'as' funciona como un alias

Camilo Enrique Mejia

student•

PAQUETES Los paquetes son las carpetas que contienen varios módulos y cada uno con una función distinta.

Para ello debe tener siempre un archivo de nombre __init__.py (por lo general esta vacio, ya que así es compatible con programas python versiones anteriores a la 3), con esto le estamos indicado a python que esto se trata de un paquete y no de una carpeta.

Para acceder a los módulos de los paquetes podemos utilizar estas opciones: import nombrecarpeta.nombremodulo from nombrecarpeta import nombremodulo from nombrecarpeta.nombremodulo import def

Estos son algunos ejemplos:

Antes de realizar el ejemplo debemos tener nuestra carpeta definida con la siguiente estructura:

En nuestra carpeta pkg, creamos dos archivos: __init__.py y aritmetica.py

__init__.py Se utiliza cuando debemos utilizar paquetes en versiones anteriores a python 3 o puede contener información la cual se ejecutara siempre, para este caso le colocamos el titulo Bienvenido a la clase de Aritmetica.

aritmetica.py va a contener nuestras operaciones aritmeticas que son, suma, resta, multiplicacion y division:

def sumar(a, b):
    return a + b

def restar(a, b):
    return a - b

def mult(a, b):
    return a * b

def div(a, b):
    return a / b

Ahora en nuestro archivo principal main.py ejecutaremos los paquetes de la siguiente manera:

import nombrecarpeta.nombremodulo

import pkg.aritmetica
print(pkg.aritmetica.sumar(5,7))
print(pkg.aritmetica.restar(5,7))

Produccion:

Bienvenido a la clase de Aritmética
12
-2

from nombrecarpeta import nombremodulo

from pkg import aritmetica 
print(aritmetica.sumar(5,7))
print(aritmetica.restar(5,7))

Produccion:

Bienvenido a la clase de Aritmética
12
-2

from nombrecarpeta.nombremodulo import def

from pkg.aritmetica import sumar
print(sumar(5,7))
from pkg.aritmetica import restar
print(restar(5,7))

Produccion:

Bienvenido a la clase de Aritmética
12
-2

Jeinfferson Bernal G

student•

Excelente informacion. Gracias

Selene Blas

student•

Gracias!!

Daniela Rojas Bedoya

student•

Esta clase fue muy reveladora, por fin entendí para que se utiliza el init.py

Jeinfferson Bernal G

student•

Sara María Mejia Sánchez

student•

De acuerdo! Buena clase!

María Herlandia Copete Perea

student•

Un paquete en Python es una carpeta que contiene varios módulos.

Para importar paquetes módulos en su interior tenemos diversos módulos, entre los que se pueden listar:

import packageName
import packageName.moduleName
from packageName import moduleName
from packageName.moduleName import functionName

Ahora bien, Python maneja los paquetes de 2 formas diferentes:

Versión 3.2 y anteriores

Los paquetes para estas versiones requieren el archivo __init__.py, este es un archivo especial empleado para indicar que el directorio debe ser tratado como un paquete. Usualmente este archivo está vacío, pero puede ser usado para configurar el paquete y definir la variable __all__ (precisa que variables son importadas cuando el módulo lo hace, el resto de variables arrojarán un error - fuente -).

Como se ha mencionado, el archivo __init__.py no necesita contenido puesto que solo se usa para inicializar el paquete cuando se importa.
Versión 3.3 y superiores

Los paquetes de las versiones más recientes no requieren el archivo __init__.py debido al módulo importlib, el cual es el núcleo de todo en sistema de importación; gracias al mismo los paquetes se identifican ahora automáticamente. Sin embargo, el archivo __init__.py ofrece diversas funcionalidades por las que se puede seguir usando, entre ellas:
- Configurar el paquete cuando se importa, por ejemplo, al definir variables o realizar ciertas tareas de inicialización.
- Definir la variable __all__ ya mencionada.
- Definir sub-módulos y sub-paquetes.
- Definir el API del paquete, que es el conjunto de funciones, clases y símbolos que se orientan al uso público.
- Habilitar un namespace.

Namespace

Un namespace es un sistema que tiene un nombre único para cada objeto en Python.

Es posible habilitar un namespace a través del archivo __init__.py si los módulos de dicho paquete se importan en el mismo:

Archivo __init__.py

import pkg.mod_1

Archivo mod_1.py

def func_1():
  return 'func 1'
  
def func_2():
  return 'func 2'

Respuesta sin __init__.py

import pkg

print(pkg.mod_1.func_1()) # AttributeError: module 'pkg' has no attribute 'mod_1'

Respuesta con __init__.py

import pkg

print(pkg.mod_1.func_1()) # func 1

Así pues, la función importada posee un nombre único a partir de su paquete.

💡 Más información puede ser hallada aquí:

Diego Quintana Hernández

student•

Muchas gracias, que gran aporte

Juan Navarrete

student•

WOW Realmente un aporte genial, redactado de una manera muy hermosa me encantó.

Cristian Diego Góngora Pabón

student•

¿Quién más quiere un curso de POO en Python? 🙌

Diego Jurado

student•

Muy bueno ver esos ejemplos con desarrollos mas profesionales para ir evaluando hasta donde se puede llegar.

Alegre Ramiro German

student•

Totalmente de acuerdo, creo que fue algo muy acercado mostrar un repositorio conocido, eso reafirma que lo que se enseña es correcto, e incluso da pie a investigar por uno mismo.

Sara María Mejia Sánchez

student•

Interesante explorar buenas practicas de entornos profesionales.

Luis Tambo

student•

Ojo con Reptil...no me funcionaba main hasta que ingrese__init__.py a la carpeta pkg

RENÉ CARDOSO

student•

llevo 10 min perdiendo el tiempo. jajajaja! gracias!!!

Sara María Mejia Sánchez

student•

pkg/mod_1

def func_1():
  return "func 1"

def func_2():
  return "func 2"

pkg/mod_2

def func_3():
  return "func 3"

def func_4():
  return "func 4"

pkg/init

# Paquetes
# https://github.com/tiangolo
# https://github.com/tiangolo/full-stack-fastapi-postgresql

'''
Antes de la version 3.3 de Python, este archivo se usaba para declarar los paquetes.
De la 3.3 en adelante se usa solo para inicializar alguna variable o importaciones a paquetes.
'''

print("Se inicio paquete")

# Cada vez que llame el paquete, inmediatamente se va a crear e inicializar esta variable
URL = "platzi.com"

'''
Este archivo tambien puede ser usado para definir un namespace
'''

import pkg.mod_1, pkg.mod_2

main

# El Zen de Python
# import this

'''
from pkg.mod_1 import func_1, func_2
from pkg.mod_2 import func_3, func_4

print(func_1())
print(func_2())
print(func_3())
print(func_4())
'''

import pkg
print(pkg.URL)
print(pkg.mod_1.func_1())

Eduardo Monzón

student•

Muchas gracias, no estaban todos los códigos en recursos, me ayudó.

Victor Santiago

student•

"Parte del código que usaras en tu vida profesional" :') gracias, Nicolas, me motivas.

Dumar Estiven Angulo Sanchez

student•

uan pregunta no puedo importar las caarpetas solo me sale que no medeja

Alejo Rodríguez

student•

¿Podrías mostrar el otro archivo (mod_1) y la estructura de tus carpetas porfa?

Dumar Estiven Angulo Sanchez

student•

este es mod_1

Brandom Cárdenas

student•

Creo q muchos aquí a estas alturas estamos usando una versión de Python bastante actualizada en replit y aún así no nos importaba el paquete hasta q creamos el archivo init.py

Felipe de Jesús Jiménez Rodríguez

student•

Debo precisar que el nombre correcto es: ' __init__.py'

Miguel Angel Reyes Moreno

student•

Les recomiendo seguir a Sebastián Ramírez en sus redes sociales, ¡vale la pena leer lo que escribe!

Daniel Carmona

student•

Excelente, no conocía la segunda forma!

Jeinfferson Bernal G

student•

Inicializar variables en un paquete con el archivo init

Creamos el archivo init en la carpeta del paquete

Agregamos definiciones de prueba en el archivo init

#__init__.py
print('Se inicio paquete')
URL = 'platzi.com'

Al correr el archivo main, el sistema busca primero el archivo init y corre lo que esta dentro, luego corre los que esta en el archivo main

>>> python main.py
--> Se inicio paquete
		func 1
		func 2
		func 3
		func 4

Podemos utilizar alguna variable de init en main al importar todo el paquete

# main.py
from pkg.mod_01 import func_1, func_2
from pkg.mod_02 import func_3, func_4

print(func_1())
print(func_2())
print(func_3())
print(func_4())

import pkg
print(pkg.URL)
>>> python main.py
--> Se inicio paquete
		func 1
		func 2
		func 3
		func 4
		platzi.com

Marlon Ramirez

student•

Excelente que hayan tenido en cuenta explicar que son los paquetes, en los cursos anteriores no lo hacían.

Erick Estrada Mancilla

student•

No entendi muy bien. no importabamos todo el modulo antes? (osea el archivo py), ahora del archivo solo importo las funciones.

que pasa cuando por ejemplo importo un modulo descargado?

from flask import Flask

Erick Estrada Mancilla

student•

no, esperen ya entendí jaja. todo es gracias al archivo init este archivo carga todos los imports de flask y sus funciones

por lo que existe la funcion flask() dentro del paquete flask, gracias a que se definio en el archivo init.py

Nicole Araos

student•

Amigos, alguien que me pueda ayudar, he hecho los mismos códigos en repplit pero no me funciona el run, ustedes saben que otro programa puedo utilizar para probar el mismo código?

Armando Jhunior

student•

Deberías colocar imágenes sobre tu código. Yo utilizo VSCode para realizar este curso.

David Cano

student•

como hago para que la carpeta no se suba sobre main?

Johan Nicolás Valderrama Serrato

student•

Hola, consulta como decirle que importe todos los módulos? intente con asterisco y me sale raro

<code> from package.mod_1 import func_1, func_2

Johan Nicolás Valderrama Serrato

student•

Creo encontré la respuesta, con el archivo init aseguras que al importar el paquete, se importen todos los módulos de ese paquete

Valentina Mesa Sotelo

student•

Hola comunidad, Soy muy principiante en el mundo de Python , al ejecutar el código me genera un error, no entiendo por que. Agradezco su ayuda.

Se Rem

student•

no tienes instalado esa libreria debes ir a la terminal y pip install NOMBRE_LIBRERIA

Se Rem

student•

ese idiota de graciasg00g1e no sabe leer

Paquetes en Python: Creación y Uso de Módulos

Introducción

Curso Intermedio de Python: Manejo de Errores y Conceptos Avanzados

Conjuntos

Conjuntos en Python: Propiedades y Uso Práctico

Manipulación de Conjuntos: Agregar, Remover y Actualizar Elementos

Operaciones Fundamentales con Conjuntos en Python

Playgrounds: Elimina elementos duplicados usando conjuntos

Comprehensions

List Comprehension en Python: Sintaxis y Ejemplos Prácticos

Comprensión de Diccionarios en Python: Ejemplos y Aplicaciones

Dictionary Comprehension con Condicionales en Python

Playgrounds: Crea una lista usando List Comprehension

Comparación de Listas, Tuplas y Conjuntos en Python

Funciones

Funciones en Programación: Creación y Uso en Python

Funciones en Python: Retorno de Valores y Reutilización de Código

Funciones en Python: Retorno múltiple y valores por defecto

Entendiendo el Scope en Python: Variables y Funciones

Refactorización de Juegos en Python: Uso de Funciones

Playgrounds: Tienda de Tecnología

Funciones Lambda en Python: Sintaxis y Aplicaciones Prácticas

Funciones de Orden Superior en Python: Concepto y Ejemplos Prácticos

Uso de la función map en Python para transformar listas

Transformaciones con Map en Diccionarios Complexos

Manejo de referencias en memoria con diccionarios y map en Python

Playgrounds: Multiplica todos los elementos por dos

Filtrado de listas con Filter en Python

Playgrounds: Retorna solo palabras de 4 letras y más

Uso de Reduce en Python para Manipular Listas

Módulos

Módulos en Python: Uso y Ejemplos Prácticos

Creación y Uso de Módulos en Python

Manejo de la dualidad de módulos en Python: script y módulo