Cómo ejecutar código Python

Ejecutar código en Python es muy sencillo. Vas al terminal tecleas python y el nombre del archivo .py que contiene el código Python que quieres ejecutar y listo. Fin del artículo. Pero todavía no te vayas que estaba bromeando 😉.

Es cierto que ejecutar código Python es una tarea sencilla. Sin embargo, si nunca has programado puede que no lo sea tanto. Además, esta tarea también varía en función del sistema operativo que utilices. Es por ello que en este artículo te explico todos los pasos que tienes que realizar para ejecutar un script en Python: desde su instalación, hasta los programas recomendados para hacerlo y cómo solucionar posibles errores de dependencias. Es decir, se intenta cubrir el caso en el que has obtenido un script de Python desarrollado por un tercero, pero no sabes como ejecutarlo por no tener conocimientos en la materia.

Paso 1: Instalar Python en la computadora

Este paso puede parecer muy obvio pero no nos lo podemos saltar, sobretodo la primera vez que queramos ejecutar un script en Python en un ordenador determinado. Hay que tener en cuenta que Windows, por ejemplo, no trae instalado por defecto una versión de Python. En macOS y Linux la cosa cambia, pero también vamos a ver algunas consideraciones a tener en cuenta.

Windows 10/11

Para instalar el intérprete de Python en Windows, la opción más sencilla es hacerlo desde la Microsoft Store, un programa que puedes encontrar encontrar en el menú de inicio de Windows. Una vez lo has abierto, puedes buscar python en la barra del menú superior, el cual te devolverá un listado con distintas versiones del intérprete. Mi recomendación es que instales siempre la última versión disponible para poder aprovechar las novedades y mejoras que se le van haciendo a este lenguaje de programación. Como vemos en la siguiente imagen, al pulsar sobre el botón Instalar instalaríamos la versión 3.11 de Python.

Para comprobar que Python se ha instalado correctamente, puedes abrir la aplicación Símbolo del Sistema también conocida como cmd. Dicha aplicación se encuentra el menú de inicio en: Sistema de Windows → Símbolo del Sistema, pero también puedes dar con ella tecleando cmd en el menú de búsqueda al lado del botón de inicio, tal y como vemos en la siguiente imagen.

Una vez abierta, tecleando el comando python --version te debería retornar la versión de Python instalada en Windows con lo cual ya podrías ejecutar archivos de código Python sin problema.

En caso que utilices una versión anterior de Windows, la alternativa es descargarse el instalador de la web oficial. En este caso no vas a poder instalar la última versión, pero en la misma página te informan a partir de qué versión de Windows no puedes usar esa versión específica de Python que vas a descargar.

macOS

En las computadoras de la compañía de la manzana se pude instalar Python de varias maneras. También cabe mencionar que las versiones de macOS entre la 10.8 y la 12.2 ya vienen con una versión de Python 2.7 preinstalada, y desde la versión 12.3 con una versión de Python 3. Sin embargo, estas versiones son utilizadas internamente por el sistema operativo y es recomendable realizar una instalación a parte para tener una versión de Python actualizada.

Para ello, la opción más sencilla es utilizar la versión más reciente del instalador para macOS que te puedes descargar en la web oficial de Python. Una vez descargado, abres el archivo .pkg, sigues los pasos y al finalizar ya puedes ejecutar código Python en tu Mac.

Para comprobarlo, puedes utilizar la aplicación Terminal la cual puedes abrir fácilmente con Spotlight. Para ello utiliza el atajo de teclado cmd + espacio y en el recuadro de búsqueda escribe terminal. Ya en la Terminal teclea python3 --version y te debería retornar la versión de Python que acabas de instalar.

Linux

Normalmente todas las distribuciones de Linux vienen con una versión de Python instalada. Para saber si es tu caso, accede al terminal y teclea python3 --version. En caso afirmativo, verás la versión específica de Python que tienes instalada. En caso de error, puedes instalar Python con el siguiente comando:

$ sudo apt update && sudo apt install python3

Paso 2: Utilizar un entorno de ejecución

Una vez sabemos que tenemos instalado Python en nuestra computadora, ya estamos preparados para ejecutar archivos con extensión .py que no son más que archivos con código Python. Para ello vamos a explorar distintas opciones a nuestra disposición como son la Terminal o el uso de editores como Visual Studio Code o Sublime Text.

Aplicación de Terminal

Vamos a ver los pasos para ejecutar código Python en la Terminal de Windows. Esta aplicación también conocida como CMD o PowerShell, es una aplicación de línea de comandos. Podemos acceder a ella del modo que hemos visto en el apartado anterior. La Terminal se abre por defecto en la carpeta del usuario que suele ser: C:\Users\nombre_de_usuario>.

Ahora supongamos que queremos ejecutar un archivo denominado hola.py ubicado en la carpeta python, la cual a su vez está dentro del escritorio de Windows. En este caso podríamos ubicarnos en dicha carpeta mediante el comando cd Desktop\python, y seguidamente ejecutar el archivo mediante el comando python hola.py, tal y como vemos a continuación.

Alternativamente, también podemos acceder directamente a dicha carpeta en la Terminal mediante el explorador de archivos. Para ello, tenemos que abrir la carpeta que contiene el código Python a ejecutar, que en nuestro ejemplo es la carpeta: Desktop → python, y en la barra superior de navegación teclear: cmd. Al pulsar intro se nos abrirá la aplicación de Terminal directamente en esa carpeta.

Estos pasos son similares en la Terminal de macOS y Linux. Simplemente has de tener en cuenta lo siguiente:

1. En estos sistemas operativos la separación entre carpetas se realiza con una barra /, en lugar de una barra invertida.
2. Tendrás que utilizar el comando python3 para ejecutar los scripts.

Además, tanto en macOS como en Linux también puedes hacer que la Terminal se abra en una carpeta determinada. En el caso de macOS, en el Finder clica con el botón derecho en dicha carpeta y selecciona la siguiente opción del menú contextual: Nuevo terminal en la carpeta. En Linux esta opción tiene un nombre similar a: Abrir un una terminal.

Visual Studio Code

Visual Studio Code es un editor de texto avanzado enfocado al desarrollo de software. En otra entrada ya hemos visto cómo configurar Visual Studio Code para Python, así que te remito a ese artículo en caso que te interese ejecutar Python con este software. Aquí, simplemente añadir que para ejecutar el código Python puedes clicar el botón play que aparece en la parte superior derecha del editor, el cual abrirá una Terminal en la parte inferior del editor y, siguiendo con el ejemplo del apartado anterior, ejecutará el comando python hola.py en Windows o python3 hola.py en macOS y Linux.

Sublime Text

Si no vas a programar frecuentemente en Python, una buena alternativa a Visual Studio Code es Sublime Text. En este caso, también hemos visto en una entrada anterior cómo configurar Sublime Text para Python. Una vez configurado, para ejecutar Python en Sublime Text tenemos que indicar que vamos a utilizar este lenguaje de programación mediante la opción de menú: Tools → Build System → Python. A continuación, teniendo abierto un fichero .py, lo podemos ejecutar mediante la opción: Tools → Build.

Paso 3: Solucionar errores de dependencias

En este apartado vamos a ver cómo solucionar los errores de tipo ModuleNotFoundError. Es decir, los que aparecen cuando ejecutamos un programa en Python y nuestro entorno de ejecución no puede encontrar alguna de las dependencias utilizadas en dicho código.

En tal caso, se recomienda crear un entorno virtual para instalar dichas dependencias, aunque el uso del entorno virtual no es estrictamente necesario. En el artículo enlazado se detallan los comandos para crear, activar y desactivar entornos virtuales; así como los comandos para instalar dependencias en dicho entorno y los beneficios de hacerlo.

Tanto si usas o no un entorno virtual, las librerías que se importan en un script de Python mediante la sentencia import y que no forman parte de la librería estándar de Python han de ser accesibles para el interprete de Python. En caso contrario, al ejecutar el código obtendremos un error del tipo ModuleNotFoudError tal y como vemos en la siguiente imagen. En este caso, el intérprete nos dice que no puede encontrar el módulo requests que hemos importado en la línea 1 de nuestro programa mediante la sentencia import requests.

Para solucionar dicho error, tenemos que descargar e importar a nuestra computadora la librería requests del Python Package Index. La herramienta pip, incluida con la instalación de Python, nos ayuda a realizar este proceso de una manera muy sencilla. Para ello sólo tenemos que ejecutar el siguiente comando, y en caso que utilices un entorno virtual asegúrate antes de que está activo:

$ pip install requests

Además, ten en cuenta que vas a tener que sustituir requests por el nombre del módulo que en tu caso todavía no tienes instalado.

La herramienta pip también tiene comandos para listar las librerías que tenemos instaladas, actualizarlas, eliminarlas, etc. Si quieres profundizar más en este tema, te recomiendo el artículo que trata sobre la gestión de dependencias con pip.

Conclusión

En este artículo hemos visto todo lo básico para poder ejecutar código Python en tu computadora desde cero. Es decir, hemos partido de la base que todavía no tienes instalado ninguna versión de Python y hemos visto cómo hacerlo independientemente de cual sea tu sistema operativo. A continuación hemos visto tres opciones alternativas de ejecutar código Python como son la ejecución del intérprete de Python directamente desde la Terminal, y el uso de editores de texto como Visual Studio Code y Sublime Text. Para finalizar, hemos visto cómo solucionar errores del tipo ModuleNotFoundError que son los que potencialmente podemos obtener si nos descargamos un script de Internet.