Este documento ofrece una guía completa para configurar un proyecto de Python utilizando Visual Studio Code (VS Code) y el entorno virtual venv en sistemas operativos Mac, Windows y Linux. Además, se incluye una sección sobre el uso de la terminal y comandos básicos para cada sistema operativo.
- Terminal y Comandos Básicos
- Instalación de Visual Studio Code
- Instalación de Python
- Configuración de Visual Studio Code para Python
- Configuración del Entorno Virtual (venv)
En Windows, la terminal puede ser el Símbolo del sistema (CMD) o PowerShell. Ambas herramientas permiten ejecutar comandos para gestionar archivos y directorios.
- Abrir CMD: Puedes abrir el Símbolo del sistema buscando "cmd" en el menú de inicio.
- Abrir PowerShell: Puedes abrir PowerShell buscando "PowerShell" en el menú de inicio.
- Navegar entre directorios:
cd nombre_del_directorio - Listar archivos y directorios:
dir
- Crear un directorio:
mkdir nombre_del_directorio
- Crear un archivo:
echo. > nombre_del_archivo
La terminal en Linux es similar a la de Mac y se puede acceder a ella desde el menú de aplicaciones o utilizando combinaciones de teclas específicas. Es una herramienta esencial para cualquier usuario de Linux.
- Abrir la Terminal: Puedes abrir la terminal buscando "Terminal" en el menú de aplicaciones.
- Navegar entre directorios:
cd nombre_del_directorio - Listar archivos y directorios:
ls
- Crear un directorio:
mkdir nombre_del_directorio
- Crear un archivo:
touch nombre_del_archivo
La terminal en Mac es una herramienta poderosa que permite a los usuarios interactuar con el sistema operativo mediante comandos de texto. A continuación, se presentan algunos comandos básicos que te ayudarán a navegar y gestionar archivos y directorios.
- Abrir la Terminal: Puedes abrir la terminal buscando "Terminal" en Spotlight o navegando a Aplicaciones > Utilidades > Terminal.
- Navegar entre directorios:
cd nombre_del_directorio - Listar archivos y directorios:
ls
- Crear un directorio:
mkdir nombre_del_directorio
- Crear un archivo:
touch nombre_del_archivo
Visual Studio Code es un editor de código fuente desarrollado por Microsoft. Es ligero pero potente, y soporta una amplia gama de lenguajes de programación, incluyendo Python.
- Descarga Visual Studio Code desde su sitio oficial.
- Ejecuta el instalador y sigue las instrucciones en pantalla para completar la instalación.
Python es un lenguaje de programación interpretado, interactivo y orientado a objetos. A continuación, se detallan los pasos para instalar Python en diferentes sistemas operativos.
- Descarga el instalador de Python desde python.org.
- Ejecuta el instalador y asegúrate de marcar la opción "Add Python to PATH".
- Sigue las instrucciones del instalador.
- Verifica la instalación abriendo el Símbolo del sistema (CMD) y ejecutando:
python --version
- Abre la terminal.
- Instala Homebrew (si no lo tienes instalado) con el siguiente comando:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - Instala Python usando Homebrew:
brew install python
- Verifica la instalación ejecutando:
python3 --version
- Abre una terminal.
- Usa el gestor de paquetes de tu distribución para instalar Python. Por ejemplo, en Debian/Ubuntu:
sudo apt update sudo apt install python3 python3-venv python3-pip
- Verifica la instalación ejecutando:
python3 --version
Para desarrollar en Python con Visual Studio Code, es necesario configurar algunas extensiones y ajustes.
-
Abre Visual Studio Code.
-
Instala la extensión de Python de Microsoft:
- Ve a la pestaña de Extensiones (icono de cuadrados en la barra lateral izquierda).
- Busca "Python" y selecciona la extensión desarrollada por Microsoft.
- Haz clic en "Instalar".
-
Configura el intérprete de Python:
- Abre la Paleta de Comandos (Ctrl+Shift+P o Cmd+Shift+P en Mac).
- Escribe "Python: Select Interpreter" y selecciona el intérprete de Python que deseas usar.
El uso de entornos virtuales es una práctica recomendada para gestionar dependencias en proyectos de Python. A continuación, se detallan los pasos para configurar un entorno virtual en VS Code.
-
Al momento de abrir VSCode selección la opción archivo en la parte superior izquierda y selecciona abrir carpeta, y selecciona la carpeta donde guardaras tus archivos.
-
Abre una terminal integrada en VS Code (Ctrl+`).
-
Verifica que estas en el ruta del proyecto.
pwdeste comando debería darte la ruta actual valida si es la misma carpeta que aparece en tu proyecto.
-
Navega al directorio de tu proyecto:
cd ruta/a/tu/proyecto -
Crea un entorno virtual, usando la utilidad de python que ya instalaste y el flag
-my el modulo venv, importante el segundo venv es el nombre de la carpeta que te creara con el entorno virtual.python3 -m venv venv
En Windows, puedes usar:
python -m venv venv
-
Activa el entorno virtual:
- En Mac/Linux:
source venv/bin/activate - En Windows:
.\venv\Scripts\activate
- En Mac/Linux:
-
Verifica que el entorno virtual está activado. Deberías ver el nombre del entorno (venv) al inicio de tu línea de comandos.
-
Instala las dependencias necesarias utilizando pip:
pip install -r requirements.txt
A continuación, se muestra una estructura de directorios recomendada para tu proyecto de Python. Esta estructura facilita la organización y gestión del código y las dependencias.
├── intro_python
│ ├── clase_1
│ │ └── sintaxis.py
│ └── clase_2
│ └── control.py
├── lbrerias
│ ├── mathlib
│ │ ├── mathlib
│ │ │ ├── __init__.py
│ │ │ └── operations.py
│ │ └── setup.py
│ └── pypy
│ └── pypy.py
├── poo
│ ├── clase_1
│ │ └── poo.py
│ ├── clase_2
│ │ └── poo.py
│ ├── clase_3
│ │ └── poo.py
│ └── clase_4
│ └── poo.py
├── tdd
│ └── clase_1
│ └── testing.py
├── tensorflow
│ ├── clase_1
│ │ └── clase_1.py
│ └── clase_2
│ └── tensorflow_datasets.ipynb
├── venv
├── LICENSE
└── README.md