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.
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
Instalación: 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 en el equipo.
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 (Símbolo del sistema): venv\Scripts\activate
- Windows (PowerShell): .\venv\Scripts\Activate.ps1
- macOS / Linux: source venv/bin/activate
3. Instalación de LangPy (v0.1.4)
Con el entorno activo, utilice el gestor de paquetes pip para instalar la versión específica de 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
Nota técnica: 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 (Troubleshooting)
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
Síntoma: Al escribir python o pip, la terminal indica que el comando no existe.
Causa: Python no se añadió a las variables de entorno (PATH) durante la instalación.
Solució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)
Síntoma: Al intentar activar el entorno virtual (.\venv\Scripts\Activate.ps1), aparece un error de color rojo sobre "políticas de ejecución".
Causa: Por seguridad, Windows restringe la ejecución de scripts externos en PowerShell.
Solución: Ejecute el siguiente comando en la terminal para permitir la sesión actual Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process
Comando langpy no encontrado
Síntoma: Después de instalar la librería, el comando langpy main.pyes devuelve un error de comando no reconocido.
Causa: El entorno virtual no está activado o la instalación de pip falló.
Solución: 1. Verifique que el nombre del entorno aparezca entre paréntesis en su terminal (venv). 2. Si persiste, intente forzar la actualización de pip e instale de nuevo python -m pip install --upgrade pip pip install langpy
Versión de Python incorrecta
Síntoma: LangPy devuelve errores inesperados al procesar el archivo .pyes.
Causa: Está utilizando una versión de Python antigua (menor a 3.10).
Verificación: Ejecute python --version. Si es 3.9 o inferior, LangPy no garantiza estabilidad. Actualice desde el sitio oficial.