Guía de Uso del Sistema

1. Verificar el Entorno

Asegúrate de que el sistema esté listo para trabajar ejecutando el comando principal en tu consola sin añadir nada más.

langpy

2. Uso Esencial

Ejecuta tus archivos de código directamente

Crea un archivo de texto con la extensión de tu idioma (`.pyes` para español) y ponlo en marcha con la orden básica.

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

main()

langpy hola.pyes

3. Extensiones del Sistema

El entorno identifica el diccionario a usar según el tipo de archivo

• Español (extensión `.pyes`): Activa comandos naturales como `definir`, `si`, `para`, `imprimir`.
• Portugués (extensión `.pypt`): Activa comandos naturales como `definir`, `se`, `para`, `imprimir`.
• Francés (extensión `.pyfr`): Activa comandos naturales como `definir`, `si`, `pour`, `imprimer`.

4. Estructura de Proyectos Avanzados

Ideal para enseñar cómo se organiza un software real en carpetas

Puedes agrupar múltiples archivos dentro de un directorio utilizando `__main__.pyes` como el interruptor principal de encendido.

mi_proyecto/
├── __main__.pyes     # Archivo principal de ejecución
├── math.pyes            # Módulo o clase local
└── utils/
    ├── __init__.pyes
    └── helpers.pyes

langpy mi_proyecto/

5. El Puente: Convertir a Python Estándar

Exporta tu lógica nativa a archivos limpios de la industria

¿Listo para el siguiente paso? Genera archivos `.py` tradicionales listos para ser abiertos con el intérprete oficial de Python en cualquier lugar del mundo.

langpy transpile script.pyes

El convertidor analiza de forma inteligente las carpetas y módulos locales internos, traduciéndolos en cascada mientras mantiene la estructura exacta de tu proyecto intacta.

# main.pyes llama internamente a utils/math.pyes:
# main.pyes              → main.py
# utils/math.pyes     → utils/math.py

6. Exportar a Carpetas Específicas

Separa tu entorno de aprendizaje de tus archivos de producción

Usa la instrucción `--output` para decirle al sistema en qué carpeta exclusiva quieres guardar la versión traducida en formato limpio.

langpy transpile main.pyes --output carpeta_salida/
langpy transpile main.pyes -o carpeta_salida/

7. Diccionario Completo de Comandos

langpy <archivo o carpeta>

Ejecuta en tiempo real un script individual o un directorio estructurado.

langpy script.pyes
langpy mi_proyecto/

langpy transpile

Inicia el proceso de conversión de la lógica en español hacia código limpio compatible con la industria.

langpy transpile script.pyes

--output / -o

Asigna la ruta de destino exacta para tus archivos convertidos.

langpy transpile script.pyes --output carpeta_salida/

--force / -f

Obliga al sistema a sobreescribir los archivos `.py` previos en caso de que existan modificaciones.

langpy transpile script.pyes --force

--help

Despliega la guía de ayuda rápida con la lista de comandos disponibles en consola.

langpy --help

--version

Muestra la versión exacta instalada en el sistema.

langpy --version

8. Compatibilidad Total con Librerías Reales

Usa herramientas profesionales como NumPy o Pandas desde el primer día

No estás atrapado en un juguete lógico. Puedes importar cualquier librería científica o de datos de Python y combinarla con tus comandos nativos.

# math.pyes
definir suma(a, b):
    retornar a + b

definir resta(a, b):
    retornar a - b

# main.pyes
desde operations importar suma, resta
importar numpy como np

definir analizar_datos():
    # Usa tus funciones en español
    resultado = suma(10, 5)
    imprimir(f"Suma: {resultado}")
    
    # Usa cualquier ecosistema nativo de Python
    datos = np.array([1, 2, 3, 4, 5])
    imprimir(f"Media: {np.mean(datos)}")

analizar_datos()

langpy main.pyes

9. Mecánica de Funcionamiento

LangPy procesa únicamente el texto de las instrucciones clave de control, traduciéndolas limpiamente a Python y dejando el resto (tus comentarios o textos) intacto.

1. Analiza la extensión del archivo ingresado (`.pyes`, `.pypt` o `.pyfr`).
2. Desglosa el script utilizando las herramientas de lectura de la biblioteca estándar de Python.
3. Intercambia exclusivamente los identificadores lógicos mapeados a tu idioma (los textos planos permanecen protegidos).
4. Reconstruye la estructura como un archivo de código Python completamente válido.
5. Lo ejecuta directamente sobre la máquina virtual nativa del sistema operativo.