subcodex

````markdown # SubCodeX v0.0.4 ```` ![NPM Version](https://img.shields.io/npm/v/subcodex?color=magenta&style=for-the-badge) ![License](https://img.shields.io/github/license/subcero/subcodex?style=for-the-badge) **Un lenguaje de programación interpretado, diseñado desde cero para ser simple, intuitivo y completamente en español.** SubCodeX es la herramienta perfecta para quienes dan sus primeros pasos en el mundo de la programación, así como para educadores que buscan una forma amigable de enseñar lógica y algoritmos. Inspirado en la simplicidad de Python y la flexibilidad de JavaScript, pero con una sintaxis natural en español. ## Características Principales ### Del Lenguaje * **Sintaxis Natural**: Escribe código que se lee casi como el español normal. * **Cero Complicaciones**: Olvídate de los puntos y comas, llaves complejas o tipos de datos estrictos. * **Funcionalidades Clave**: Soporte para variables, constantes, condicionales (`si`/`sino`), bucles (`repetir`), funciones, listas y comentarios. * **Orientado a Principiantes**: Diseñado para que la curva de aprendizaje sea lo más suave posible. ### Del CLI (Interfaz de Línea de Comandos) * **Menú Interactivo**: Ejecuta `subcodex` sin argumentos para un menú guiado por flechas. * **Modo Auto/Vigilancia**: El comando `auto` re-ejecuta tu código automáticamente cada vez que guardas cambios en el archivo. * **Interfaz Atractiva**: Uso de colores, animaciones y spinners para una experiencia de usuario moderna y agradable. * **Gestión de Archivos**: Crea archivos de ejemplo y ejecuta múltiples scripts a la vez. ## Instalación Para instalar la herramienta de línea de comandos de SubCodeX globalmente en tu sistema, solo necesitas Node.js y ejecutar el siguiente comando: ```shell npm install -g subcodex ``` ## Inicio Rápido 1. Crea tu primer archivo, por ejemplo, `hola.subx`. 2. Escribe tu primera línea de código SubCodeX: ```subcodex # mi primer programa decir "¡Hola, mundo desde SubCodeX!" ``` 3. Ejecútalo desde la terminal: ```shell subcodex run hola.subx ``` ----- ## 💻 Uso del CLI Una vez instalado, puedes usar el comando `subcodex` (o su alias `subx`). * **Menú Interactivo** (la forma más fácil de empezar): ```shell subcodex ``` * **Ejecutar uno o más archivos**: ```shell subcodex run <archivo1.subx> [archivo2.subx...] ``` * **Crear un archivo de ejemplo**: ```shell subcodex init [nombre_del_archivo] ``` * **Modo de Desarrollo (Auto)**: ```shell subcodex auto <archivo.subx> ``` Dentro de este modo, puedes usar los atajos: `r` (refrescar), `p` (pausar/reanudar), `q` (salir). ## Guía de Sintaxis ### **Comentarios** ```subcodex # Esto es un comentario. El intérprete lo ignora. ``` ### **Variables y Constantes** ```subcodex # Las variables pueden cambiar de valor. variable puntos = 100 variable nombre = "Arturo" # Las constantes no pueden ser reasignadas. constante PI = 3.1416 ``` ### **Salida en Consola** ```subcodex decir "Hola, " + nombre # Concatena texto y variables decir "Tienes " + puntos + " puntos." ``` ### **Condicionales** ```subcodex si puntos > 50 entonces decir "¡Vas ganando!" sino decir "Necesitas más puntos." fin ``` ### **Bucles** ```subcodex repetir 3 decir "¡Esto se repetirá 3 veces!" fin ``` ### **Funciones** ```subcodex funcion saludar decir "¡Hola desde una función!" retornar "Saludo exitoso" fin # Para usarla: variable resultado = llamar saludar decir "El resultado de la función fue: " + resultado ``` ### **Listas** ```subcodex lista.nueva inventario lista.agregar inventario "Espada" lista.agregar inventario "Poción" ``` ## Contribuciones Las contribuciones son bienvenidas. Si tienes ideas para mejorar SubCodeX, por favor abre un "Gmail" en el correo de "subceroplay@gmail.com" para discutirlo. ## 📜 Licencia Distribuido bajo la Licencia MIT. Ver `LICENSE` para más información. Creado con ❤️ por **Subcero**. nota: (se aceptan ayudantes escribir al correo si quieres trabajar en el proyecto).