# SubCodeX v0.0.4 

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:

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:

   # mi primer programa
   decir "¡Hola, mundo desde SubCodeX!"

3. Ejecútalo desde la terminal:

   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):

  subcodex

• Ejecutar uno o más archivos:

  subcodex run <archivo1.subx> [archivo2.subx...]

• Crear un archivo de ejemplo:

  subcodex init [nombre_del_archivo]

• Modo de Desarrollo (Auto):

  subcodex auto <archivo.subx>

  Dentro de este modo, puedes usar los atajos: r (refrescar), p (pausar/reanudar), q (salir).

Guía de Sintaxis

Comentarios

# Esto es un comentario. El intérprete lo ignora.

Variables y Constantes

# 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

decir "Hola, " + nombre # Concatena texto y variables
decir "Tienes " + puntos + " puntos."

Condicionales

si puntos > 50 entonces
  decir "¡Vas ganando!"
sino
  decir "Necesitas más puntos."
fin

Bucles

repetir 3
  decir "¡Esto se repetirá 3 veces!"
fin

Funciones

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

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 "[email protected]" 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).