Guía de Uso de LangPy

Instalación

pip install langpy

Uso Básico

Ejecuta archivos LangPy directamente

Crea un archivo con la extensión apropiada (.pyes para español, .pypt para portugués, .pyfr para francés) y ejecútalo con el comando langpy.

# hola.pyes
definir main():
    nombre = "Mundo"
    imprimir(f"Hola {nombre}!")

main()

langpy hola.pyes

Lenguajes Soportados

El lenguaje se determina únicamente por la extensión del archivo

• Español: extensión .pyes
• Portugués: extensión .pypt
• Francés: extensión .pyfr

Transpilar a Python

Convierte archivos LangPy a archivos Python estándar

Genera archivos .py que pueden ejecutarse con el intérprete estándar de Python.

langpy --transpile script.pyes

LangPy transpila automáticamente todos los módulos importados que tengan la extensión del lenguaje correspondiente, creándolos en el mismo directorio que sus equivalentes LangPy.

# Si main.pyes importa utils/operations.pyes:
# main.pyes → main.py
# utils/operations.pyes → utils/operations.py

Referencia de Flags CLI

--transpile

Convierte el archivo LangPy a Python estándar sin ejecutarlo.

langpy --transpile script.pyes

--force

Fuerza la sobrescritura de archivos .py existentes durante la transpilación. Debe usarse con --transpile.

langpy --transpile --force script.pyes

--help

Muestra información de ayuda y comandos disponibles.

langpy --help

--version

Muestra la versión instalada de LangPy.

langpy --version

Trabajar con Librerías

LangPy es 100% compatible con las librerías de Python

Puedes importar y usar cualquier librería de Python o crear módulos locales usando la sintaxis de LangPy.

# utils/operaciones.pyes
definir suma(a, b):
    retornar a + b

# main.pyes
desde utils.operaciones importar suma
importar numpy como np

definir analizar_datos():
    resultado = suma(10, 5)
    datos = np.array([1, 2, 3, 4, 5])
    imprimir(f"Media: {np.mean(datos)}")

analizar_datos()

langpy main.pyes

Cómo Funciona

LangPy es un transpilador léxico que traduce únicamente las palabras clave a Python, dejando todo lo demás sin cambios.

1. Lee tu archivo .pyes/.pypt/.pyfr
2. Tokeniza usando el tokenizador de la biblioteca estándar de Python
3. Reemplaza los tokens de palabras clave con sus equivalentes en Python
4. Destokeniza de vuelta a código Python
5. Ejecuta con la máquina virtual estándar de Python