Guía de Configuración e Instalación: Python y LangPy
Esta guía detalla los pasos técnicos para preparar un entorno de desarrollo funcional, instalar el paquete LangPy y ejecutar scripts con sintaxis en español.
Tabla de Contenidos
1. Verificación del Intérprete de Python
Para el correcto funcionamiento de las dependencias, se requiere Python 3.10 o superior.
Debe verificar la presencia del intérprete en su sistema mediante la terminal:
- Windows: python --version
- macOS / Linux: python3 --version
Si el comando no es reconocido o la versión es inferior a la 3.10, descargue el instalador oficial en python.org. En Windows, es indispensable marcar la opción "Add Python to PATH" para permitir que el sistema localice el ejecutable.
2. Configuración del Entorno Virtual
El uso de entornos virtuales es una práctica estándar que permite aislar las librerías de un proyecto, evitando conflictos con otras instalaciones de Python.
Creación del entorno
Ejecute el siguiente comando en su terminal para generar la estructura del entorno:
- Windows: python -m venv venv
- macOS / Linux: python3 -m venv venv
Activación
Para que las herramientas se instalen en el lugar correcto, debe activar el entorno:
- Windows (CMD): venv\Scripts\activate
- Windows (PowerShell): .\venv\Scripts\Activate.ps1
- macOS / Linux: source venv/bin/activate
3. Instalación de LangPy
Con el entorno activo, utilice el gestor de paquetes pip para instalar la librería.
pip install langpy
Este paquete permite al intérprete procesar palabras clave de programación en español, facilitando la lógica para hispanohablantes.
4. Creación y Ejecución del Script
LangPy utiliza una extensión de archivo personalizada (.pyes) para diferenciar los scripts que contienen sintaxis traducida.
- Abra su editor de texto.
- Cree un archivo nuevo y guárdelo como main.pyes.
- Inserte el siguiente código:
imprimir("Hola desde LangPy")Ejecución
A diferencia de los scripts estándar de Python, los archivos .pyes se ejecutan invocando directamente al comando de la librería desde la terminal:
langpy main.pyes
Al ejecutar este comando, LangPy realiza una traducción interna de la sintaxis y utiliza el intérprete de Python configurado para procesar la instrucción.
Solución de Problemas Comunes
En entornos de programación, es habitual encontrar errores de configuración inicial. A continuación, se detallan los fallos más frecuentes y sus soluciones técnicas.
Python no se reconoce como comando externo o interno
Al escribir python o pip, la terminal indica que el comando no existe.
Python no se añadió a las variables de entorno (PATH) durante la instalación.
Reinstale Python asegurándose de marcar la casilla "Add Python to PATH" o añada manualmente la ruta de la carpeta de instalación a las variables de entorno del sistema.
Error de ejecución de scripts (Solo Windows)
Al intentar activar el entorno virtual (.\venv\Scripts\Activate.ps1), aparece un error sobre políticas de ejecución.
Windows restringe la ejecución de scripts externos en PowerShell.
Ejecute el comando: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process
Comando langpy no encontrado
El comando langpy main.pyes devuelve un error de comando no reconocido.
El entorno virtual no está activado o la instalación de pip falló.
Verifique que el entorno esté activo y reinstale con: python -m pip install --upgrade pip && pip install langpy
Versión de Python incorrecta
LangPy devuelve errores inesperados al procesar el archivo .pyes.
Está utilizando una versión de Python inferior a la 3.10.
Ejecute python --version y actualice Python desde el sitio oficial si es necesario.