if name == "main": run()
Se le llama: Entry point
Cuando trabajas con archivos Python, es común querer que un mismo archivo funcione tanto como módulo importable desde otro archivo como script ejecutable directamente desde la terminal. Esta dualidad puede generar comportamientos inesperados si no se controla correctamente, y la solución está en una línea que encontrarás en prácticamente todos los proyectos profesionales de Python.
¿Cuál es el problema de la dualidad entre módulos y scripts?
Un archivo .py en Python puede ejecutarse de dos formas. La primera es como módulo, donde defines funciones y las importas desde otro archivo. Por ejemplo, un archivo utils.py con funciones que se importan desde main.py [0:18]. La segunda es como script, ejecutándolo directamente desde la terminal con el comando python seguido de la ruta del archivo [0:40].
El conflicto aparece cuando importas un archivo que contiene código ejecutable fuera de funciones. Al hacer import main desde un archivo example.py, todo el código de main.py se ejecuta automáticamente [2:07]. Esto significa que si main.py tiene un input() o cualquier lógica directa, se disparará sin que lo desees.
¿Cómo evitar que un módulo se ejecute al importarlo?
La primera estrategia es encapsular el código dentro de una función. En lugar de tener instrucciones sueltas en el archivo, creas una función llamada run() y colocas toda la lógica dentro de su scope o alcance [3:08].
python def run(): country = input('Escribe un país: ') # lógica del programa
De esta manera, al importar el módulo desde otro archivo, el código no se ejecuta automáticamente. Solo se ejecuta cuando llamas explícitamente a main.run() [3:30].
data, siguen siendo accesibles mediante main.data [4:05].¿Qué hace if name == "main" y por qué es esencial?
Al encapsular todo en una función run(), resuelves el problema de la importación. Pero ahora pierdes la capacidad de ejecutar el archivo directamente como script, porque nadie llama a run() cuando lo ejecutas desde la terminal [4:50].
Aquí entra el patrón más importante de Python para manejar esta dualidad. Se trata de un condicional que evalúa la variable especial __name__ [5:30]:
python if name == "main": run()
Esta variable __name__ es una propiedad interna que Python asigna automáticamente a cada archivo. Cuando ejecutas un archivo directamente desde la terminal, Python le asigna el valor "__main__". Cuando el archivo es importado desde otro módulo, __name__ toma el nombre del archivo.
¿Cómo funciona en la práctica este condicional?
El comportamiento resultante es exactamente la dualidad controlada que necesitas:
python app/main.py desde la terminal, el condicional se cumple y run() se ejecuta [6:22].main desde example.py, el bloque if no se ejecuta, y solo corres lo que llames explícitamente como main.run() [6:05].python data = [1, 2, 3]
def run(): country = input('Escribe un país: ') # lógica del programa
if name == "main": run()
Sin este if, perderías la posibilidad de que el archivo funcione como script independiente [6:42]. Con él, tienes un archivo que sirve como módulo reutilizable y como punto de entrada directo.
¿Por qué la modularización importa en proyectos Python?
La modularización consiste en organizar el código en archivos separados con responsabilidades claras. Cada archivo .py es considerado un módulo, incluso main.py [1:20]. Esto permite reutilizar funciones sin duplicar código.
El patrón if __name__ == "__main__" es una pregunta frecuente en entrevistas y una práctica estándar en proyectos profesionales [6:55]. Dominarlo te permite escribir código que es tanto importable como ejecutable, algo fundamental cuando tus proyectos crecen y necesitas trabajar con paquetes, el siguiente paso natural en la organización de código Python.
¿Has encontrado errores al importar módulos que se ejecutaban sin querer? Comparte tu experiencia y cómo lo resolviste.
Cuando trabajas con archivos Python, es común querer que un mismo archivo funcione tanto como módulo importable desde otro archivo como script ejecutable directamente desde la terminal. Esta dualidad puede generar comportamientos inesperados si no se controla correctamente, y la solución está en una línea que encontrarás en prácticamente todos los proyectos profesionales de Python.
Un archivo .py en Python puede ejecutarse de dos formas. La primera es como módulo, donde defines funciones y las importas desde otro archivo. Por ejemplo, un archivo utils.py con funciones que se importan desde main.py [0:18]. La segunda es como script, ejecutándolo directamente desde la terminal con el comando python seguido de la ruta del archivo [0:40].
El conflicto aparece cuando importas un archivo que contiene código ejecutable fuera de funciones. Al hacer import main desde un archivo example.py, todo el código de main.py se ejecuta automáticamente [2:07]. Esto significa que si main.py tiene un input() o cualquier lógica directa, se disparará sin que lo desees.
La primera estrategia es encapsular el código dentro de una función. En lugar de tener instrucciones sueltas en el archivo, creas una función llamada run() y colocas toda la lógica dentro de su scope o alcance [3:08].
python def run(): country = input('Escribe un país: ') # lógica del programa
De esta manera, al importar el módulo desde otro archivo, el código no se ejecuta automáticamente. Solo se ejecuta cuando llamas explícitamente a main.run() [3:30].
data, siguen siendo accesibles mediante main.data [4:05].Al encapsular todo en una función run(), resuelves el problema de la importación. Pero ahora pierdes la capacidad de ejecutar el archivo directamente como script, porque nadie llama a run() cuando lo ejecutas desde la terminal [4:50].
Aquí entra el patrón más importante de Python para manejar esta dualidad. Se trata de un condicional que evalúa la variable especial __name__ [5:30]:
python if name == "main": run()
Esta variable __name__ es una propiedad interna que Python asigna automáticamente a cada archivo. Cuando ejecutas un archivo directamente desde la terminal, Python le asigna el valor "__main__". Cuando el archivo es importado desde otro módulo, __name__ toma el nombre del archivo.
El comportamiento resultante es exactamente la dualidad controlada que necesitas:
python app/main.py desde la terminal, el condicional se cumple y run() se ejecuta [6:22].main desde example.py, el bloque if no se ejecuta, y solo corres lo que llames explícitamente como main.run() [6:05].python data = [1, 2, 3]
def run(): country = input('Escribe un país: ') # lógica del programa
if name == "main": run()
Sin este if, perderías la posibilidad de que el archivo funcione como script independiente [6:42]. Con él, tienes un archivo que sirve como módulo reutilizable y como punto de entrada directo.
La modularización consiste en organizar el código en archivos separados con responsabilidades claras. Cada archivo .py es considerado un módulo, incluso main.py [1:20]. Esto permite reutilizar funciones sin duplicar código.
El patrón if __name__ == "__main__" es una pregunta frecuente en entrevistas y una práctica estándar en proyectos profesionales [6:55]. Dominarlo te permite escribir código que es tanto importable como ejecutable, algo fundamental cuando tus proyectos crecen y necesitas trabajar con paquetes, el siguiente paso natural en la organización de código Python.
¿Has encontrado errores al importar módulos que se ejecutaban sin querer? Comparte tu experiencia y cómo lo resolviste.
if name == "main": run()
Se le llama: Entry point
Este if dice que si es ejecutado desde la terminal, entre al run y si es ejecutado desde otro archivo, no se ejecuta.
if __name__ == "__main__":
run()
MÓDULOS COMO SCRIPTS: NAME y MAIN
Cuando utilizamos name == 'main' estamos dando dualidad a cierta función para que sea ejecutada en dos archivos distintos.
Para ello debemos tener en cuenta que su uso esta catalogado de dos maneras:
Para Python, es independiente cual de las dos formas estemos utilizando el código, ya que python define una variable especial llamada __name__ la cual contiene un string y cuyo resultado dependerá de la forma en como sea usada.
Como en el ejemplo, se observa que el primer archivo que denominamos main.py.
main.py
import utils
keys, values = utils.get_population()
print(keys, values)
data = [
{
'country': 'Colombia',
'Population': 500
},
{
'country': 'Peru',
'Population': 250
},
{
'country': 'Argentina',
'Population': 350
}
]
def run():
keys, values = utils.get_population()
print(keys, values)
country = input('Digite el país: ')
result = utils.population_by_countrie(data, country)
print(result)
if __name__ == '__main__':
run()
Cuando ejecutamos el archivo directamente como un script nuestra variable if __name__ tomara el valor de __main__
Al ser ejecutado nuestro output será el siguiente:
Producción:
Digite el país: Peru
[{'country': 'Peru', 'Population': 250}]
Con esto podemos concluir que la función __name__ == '__main__' ayuda a que python identifique de que manera se debe ejecutar e o los módulos ó script.
Material de apoyo
El profe Facundo nos habló de utilizar el entry point como una buena prática de programación. Ahora Nicolás nos explica la razón detrás de su uso. Agradecido con ambos.
__name__**es una variable especial en Python que contiene el nombre del módulo en el que se está ejecutando el código.__name__
es igual a "__main__". Esto significa que el archivo se está ejecutando como un script principal y no está siendo importado por otro módulo o script.mi_script.py**con el siguiente código:print(__name__)
#Output: __main__
mi_script.py**desde otro módulo o script, el valor de **__name__**será el nombre del módulo (en este caso, mi_script).if __name__ == "__main__":, estás diciendo "si estoy ejecutando este archivo como un script principal, ejecuta el código dentro de este bloque".Me quedé algo confundido con la explicación de if name == main así que salí a investigar un poco y encontré este artículo que les comparto. Ahora lo tengo más claro.
un recurso muy util sobre la misma sentencia me ayudo mucho en mis inicios con Python https://realpython.com/if-name-main-python/
Un archivo py se corre como script al ejecutarlo en la linea de comando como:
>> python utils.py
Y tambien puede correr desde otro archivo (main) cuando es utilizado como modulo:
import utils
>> python main.py
Sin embargo, al querer utilizar una de las funciones del main en otro archivo (example) ocurre que se ejecuta primero todo el archivo main para luego darte acceso a la funcion requerida por el archivo example. Esto es un problema ya que solo quieres utilizar la funcion sin que se ejecute todo el main. La solucion se conoce como los DATAPOINT
# indica que si el archivo es ejecutado desde la terminal se ejecute run()
# en caso de ser ejecutado desde otro archivo como modulo no se corra run()
if __name__ == '__main__':
run()
Esto le da la dualidad a los modulos de ejecutarse tanto como script desde la terminal como tambien desde otro archivo como un modulo
El archivo main puede reestructurarse de la siguiente manera para que tome la dualidad antes mencionada:
# llamar al modulo utils
import utils
# lista de paises con su repectiva poblacion
data = [
{
'Country':'colombia',
'Population':30
},
{
'Country':'bolivia',
'Population':18
},
{
'Country':'mexico',
'Population':100
},
{
'Country':'nicaragua',
'Population':7
}
]
def run():
# utilizar la funcion get_population
Pais, Poblacion = utils.get_population()
print(Pais, Poblacion)
# utilizar la variable A
print(utils.A)
# obtener la poblacion de un pais especifico
poblacion = utils.population_by_country(data, 'mexico')
print(poblacion)
# obtener el pais del cual queremos saber su poblacion de forma dinamica
country = input('Digite el pais: ')
poblacion_pais = utils.population_by_country(data, country)
print(poblacion_pais)
if __name__ == '__main__':
run()
Las instrucciones de main quedan encerradas en una funcion llamada run() y se agrega el datapoint junto a la funcion run() para que esta corra solo cuando el archivo sea ejecutado desde la terminal.
En el archivo example pedimos que se muestre data y que se ejecute la funcion run() del archivo main de la siguiente manera:
import main
# obtener la data del archivo main
print(main.data)
main.run()
Por si tienen la misma pregunta que yo, de como hace el profe en el 5:07 para borrar solo la identación de Data al sacarlo de la función y que quede bien identado, lo hace seleccionando las lineas correspondientes y la combinación de teclas Shit + Tab
Recomiendo mucho leer este pequeño post para entender mucho mejor la importancia de:
if __name__ == "__main__":
main():
Muy muy muy muy muy necesario y útil en casi cualquier programa de python.
Joel Angel David Barrantes Palacios
Julio Rogers Cajas Guncay
Daniel Carmona
Ricardo Mazuera
Diego Jurado
Camilo Enrique Mejia
Jean Ramos
Eliana Ossio
Andrés Guerrero
Pablo Garrido Hernandez
Javier Hugo Noto Enriquez
Fidel Parabacuto
Eli Riera
GUSTAVO EDUARDO CHAVEZ AYALA
SANDRO SIMON
Juan Pablo Osorio Quiroga
MARDELY VANESA MORALES TIRADO
Rigoberto Martinez Madriz
Jeinfferson Bernal G
Samuel Steven Bernal Martínez
Juan Camilo Maldonado Perez
Daniela Laura
Jose Reynoso
Néstor Reyes Rojas
Francisco Valdés
Jose Miguel Lopez
Hiram Jiménez
Hiram Jiménez
Gustavo Rodriguez Compean
Enrique Aguilera
Jose Castillo
andres alvarez
Leonardo Carvallo
JUAN CAMILO AGUIRRE ROMERO
Cristian Quirama
Daniel Julian Rico Coca
Ángel Téllez Gutiérrez
Yetzojhanan Varela Sierra
Francisco Ponce
if name == "main": run()
Se le llama: Entry point
Esto es un dato muy importante que considero deberian mencionar en las clases grabadas. Es importante saber el nombre correcto de lo que estamos haciendo.
Genial!
Este if dice que si es ejecutado desde la terminal, entre al run y si es ejecutado desde otro archivo, no se ejecuta.
if __name__ == "__main__": run()
Ese entry point es el que se utiliza por defecto en muchos programas.
MÓDULOS COMO SCRIPTS: NAME y MAIN
Cuando utilizamos name == 'main' estamos dando dualidad a cierta función para que sea ejecutada en dos archivos distintos.
Para ello debemos tener en cuenta que su uso esta catalogado de dos maneras:
Para Python, es independiente cual de las dos formas estemos utilizando el código, ya que python define una variable especial llamada __name__ la cual contiene un string y cuyo resultado dependerá de la forma en como sea usada.
Como en el ejemplo, se observa que el primer archivo que denominamos main.py.
main.py
import utils keys, values = utils.get_population() print(keys, values) data = [ { 'country': 'Colombia', 'Population': 500 }, { 'country': 'Peru', 'Population': 250 }, { 'country': 'Argentina', 'Population': 350 } ] def run(): keys, values = utils.get_population() print(keys, values) country = input('Digite el país: ') result = utils.population_by_countrie(data, country) print(result) if __name__ == '__main__': run()
Cuando ejecutamos el archivo directamente como un script nuestra variable if __name__ tomara el valor de __main__
Al ser ejecutado nuestro output será el siguiente:
Producción:
Digite el país: Peru [{'country': 'Peru', 'Population': 250}]
Con esto podemos concluir que la función __name__ == '__main__' ayuda a que python identifique de que manera se debe ejecutar e o los módulos ó script.
Material de apoyo
excelente aporte, lo encontré super útil, gracias
Gracias por la explicación, me ayudó a entender mejor.
El profe Facundo nos habló de utilizar el entry point como una buena prática de programación. Ahora Nicolás nos explica la razón detrás de su uso. Agradecido con ambos.
🤯 luego de esta clase al entender por que es una buena practica jajaja
Me paso lo mismo, gran complemento, ojala tuvieramos acceso tanto a las clases del profe facundo como a las clases actuales
__name__**es una variable especial en Python que contiene el nombre del módulo en el que se está ejecutando el código.__name__
es igual a "__main__". Esto significa que el archivo se está ejecutando como un script principal y no está siendo importado por otro módulo o script.mi_script.py**con el siguiente código:print(__name__) #Output: __main__
mi_script.py**desde otro módulo o script, el valor de **__name__**será el nombre del módulo (en este caso, mi_script).if __name__ == "__main__":, estás diciendo "si estoy ejecutando este archivo como un script principal, ejecuta el código dentro de este bloque".El mejor aporte!!! sin esta informacion la clase queda incompleta.
Gracias!
Grandioso aporte me ayudaste entender claramente los conceptos, gracias 👌
Me quedé algo confundido con la explicación de if name == main así que salí a investigar un poco y encontré este artículo que les comparto. Ahora lo tengo más claro.
Gracias, tambien lo pude entender mejor gracias a ese articulo.
Hola, muchas gracias por el artículo, también quedé un poco confundida
un recurso muy util sobre la misma sentencia me ayudo mucho en mis inicios con Python https://realpython.com/if-name-main-python/
Modulos como Script
Un archivo py se corre como script al ejecutarlo en la linea de comando como:
>> python utils.py
Y tambien puede correr desde otro archivo (main) cuando es utilizado como modulo:
import utils >> python main.py
Sin embargo, al querer utilizar una de las funciones del main en otro archivo (example) ocurre que se ejecuta primero todo el archivo main para luego darte acceso a la funcion requerida por el archivo example. Esto es un problema ya que solo quieres utilizar la funcion sin que se ejecute todo el main. La solucion se conoce como los DATAPOINT
# indica que si el archivo es ejecutado desde la terminal se ejecute run() # en caso de ser ejecutado desde otro archivo como modulo no se corra run() if __name__ == '__main__': run()
Esto le da la dualidad a los modulos de ejecutarse tanto como script desde la terminal como tambien desde otro archivo como un modulo
El archivo main puede reestructurarse de la siguiente manera para que tome la dualidad antes mencionada:
# llamar al modulo utils import utils # lista de paises con su repectiva poblacion data = [ { 'Country':'colombia', 'Population':30 }, { 'Country':'bolivia', 'Population':18 }, { 'Country':'mexico', 'Population':100 }, { 'Country':'nicaragua', 'Population':7 } ] def run(): # utilizar la funcion get_population Pais, Poblacion = utils.get_population() print(Pais, Poblacion) # utilizar la variable A print(utils.A) # obtener la poblacion de un pais especifico poblacion = utils.population_by_country(data, 'mexico') print(poblacion) # obtener el pais del cual queremos saber su poblacion de forma dinamica country = input('Digite el pais: ') poblacion_pais = utils.population_by_country(data, country) print(poblacion_pais) if __name__ == '__main__': run()
Las instrucciones de main quedan encerradas en una funcion llamada run() y se agrega el datapoint junto a la funcion run() para que esta corra solo cuando el archivo sea ejecutado desde la terminal.
En el archivo example pedimos que se muestre data y que se ejecute la funcion run() del archivo main de la siguiente manera:
import main # obtener la data del archivo main print(main.data) main.run()
Por si tienen la misma pregunta que yo, de como hace el profe en el 5:07 para borrar solo la identación de Data al sacarlo de la función y que quede bien identado, lo hace seleccionando las lineas correspondientes y la combinación de teclas Shit + Tab
Recomiendo mucho leer este pequeño post para entender mucho mejor la importancia de:
if __name__ == "__main__": main():
Muy muy muy muy muy necesario y útil en casi cualquier programa de python.
__ name __ ejecutado desde el propio modulo (modulo a) es igual a __ main __, pero si el (modulo a) se importa y ejecuta desde otro modulo (modulo b), __ name __ es igual al nombre del modulo importado (modulo a). De esta manera, con el:
if __name__ == '__main__'
podemos controlar que parte del codigo queremos que se ejecute solo si es llamado desde el propio modulo.
Muchas gracias! me sirvio mucho tu aporte para terminar de comprender todo, gracias
Honestamente no entendí nada de esto.
Consulta puedo llamar a otros módulos si no estan en la misma carpeta
tuve la misma duda y me puse a investigar
para llamar a otros modulos se usa el from ,por ejemplo caso ejecutar main "principal" de proyecto
from app import utils
Que tal, no pude quedarme con las ganas e implementé el código de esta clase tanto en vscode y en replit, después de algunas correcciones ya no marcó errores pero las gráficas no las muestra, alguien sabe por qué? estoy sobre ubuntu con wsl será por eso? incluso instalé desde línea de código matplotlib, y como no las mostraba debugee el código y si mostraba la lista con datos del archivo csv. Se me ocurrió ir a un jupyter el de colab de google y ahí si funciona 😊 espero alguien me oriente les dejo la jupyter notebook!
Actualización.. en replit ya mostró la gráfica en vcode aún no...!
Hola, ¿tienes instalados los modulos necesarios? creo es matplotlib para los gráficos o intenta con seaborn.
por primera vez alguien explico bien para que sirve el
if __name__ == "__main__":
En resumen, su nombre tecnico es entry point, punto de entrada.
Y nos permite definir que el modulo pueda ser usado cuando se ejecuta desde la terminal, y previene que esa ejecucion ocurra cuando es llamado desde otro archivo como modulo, evitando así una doble ejecucion.
# Entry point if __main__ == "_main__: run()
No entiendo porque igual me corre el programa, es decir me el modulo me lee la funcion así no la invoque
Exacto, carga el código en memoría, incluso hace alguna svalidaciones de sintaxis. Solo queda a la espera que invoques la función con los parametros para poder realizar la operación.
Inicié este curso, pero no sé en qué momento se hicieron esos archivos main y todo lo que sale aquí. Estoy muy perdido en esta clase
Un año de diferencia pero... si soy, me hace sentir un poco "lento" pero bueeeno
Una duda que me surge es: siempre en el if se debe poner el main o es el nombre del archivo, ya que en este caso pues tienen el mismo nombre
siempre tiene que ser usando 'main'
Qué teclas utilizan para hacer identación a varias lineas de código
Yo lo que hago es seleccionar las líneas e identarlas con la tecla tab