@icarusmx/creta 1.4.6 → 1.4.7

package/ejemplo.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+MENSAJE="Salgamos de este laberinto."
+echo $MENSAJE

package/lib/data/lessons/sintaxis/piping-redireccion.js

@@ -0,0 +1,142 @@
+// Piping y Redirección - Conectando comandos y manejando flujos de datos
+export const PIPING_REDIRECCION = {
+  id: 'piping-redireccion',
+
+  intro: {
+    definition: 'Piping y redirección son mecanismos para conectar comandos y controlar hacia dónde va la información.',
+    explanation: 'En lugar de ver resultados en pantalla, puedes enviarlos a archivos, otros comandos, o usarlos como entrada.',
+    detail: 'Esto es lo que hace a bash tan poderoso: puedes combinar comandos simples para crear flujos de trabajo complejos.'
+  },
+
+  steps: [
+    {
+      type: 'command-intro',
+      command: '|',
+      description: 'El pipe (tubería)',
+      explanation: 'El símbolo | toma la salida de un comando y la envía como entrada a otro.',
+      example: 'ls | grep ".js"\ncat archivo.txt | wc -l',
+      instruction: 'Úsalo para encadenar comandos. La salida del izquierdo entra al derecho.'
+    },
+    {
+      type: 'command-intro',
+      command: '>',
+      description: 'Redirección de salida (sobrescribir)',
+      explanation: '> toma la salida de un comando y la guarda en un archivo, sobrescribiendo contenido previo.',
+      example: 'echo "Hola mundo" > saludo.txt\nls > archivos.txt',
+      instruction: 'Si el archivo existe, se borra y se reemplaza con el nuevo contenido.'
+    },
+    {
+      type: 'command-intro',
+      command: '>>',
+      description: 'Redirección de salida (agregar)',
+      explanation: '>> agrega contenido al final de un archivo sin borrar lo que ya existe.',
+      example: 'echo "Primera línea" > log.txt\necho "Segunda línea" >> log.txt',
+      instruction: 'Útil para logs y archivos donde quieres preservar el contenido anterior.'
+    },
+    {
+      type: 'command-intro',
+      command: '<',
+      description: 'Redirección de entrada',
+      explanation: '< toma el contenido de un archivo y lo usa como entrada para un comando.',
+      example: 'wc -l < archivo.txt\nsort < nombres.txt',
+      instruction: 'En lugar de leer desde teclado, el comando lee desde el archivo.'
+    },
+    {
+      type: 'command-intro',
+      command: '<<<',
+      description: 'Here-string (cadena directa)',
+      explanation: '<<< pasa un string directamente como entrada a un comando.',
+      example: 'wc -w <<< "Salgamos de este laberinto"\ngrep "mundo" <<< "Hola mundo"',
+      instruction: 'Muy útil para pasar variables como entrada: grep "patrón" <<< "$VARIABLE"'
+    },
+    {
+      type: 'command-intro',
+      command: 'read <<< "$VAR"',
+      description: 'Usando read con here-string',
+      explanation: 'read puede tomar una string y dividirla en partes.',
+      example: 'VERSION="1.2.3"\nIFS=\'.\' read -r MAJOR MINOR PATCH <<< "$VERSION"\necho $PATCH  # imprime: 3',
+      instruction: 'IFS define el delimitador. read separa la string y asigna a cada variable.'
+    },
+    {
+      type: 'command-intro',
+      command: 'read -r -a',
+      description: 'Read en un array',
+      explanation: 'Con -a, read guarda las partes en un array en lugar de variables separadas.',
+      example: 'VERSION="1.2.3"\nIFS=\'.\' read -r -a PARTS <<< "$VERSION"\necho ${PARTS[0]}  # 1\necho ${PARTS[1]}  # 2\necho ${PARTS[2]}  # 3',
+      instruction: 'Accede a cada parte con ${ARRAY[índice]}. Los índices empiezan en 0.'
+    },
+    {
+      type: 'command-intro',
+      command: '2>',
+      description: 'Redirección de errores',
+      explanation: '2> redirige los mensajes de error (stderr) a un archivo.',
+      example: 'npm install 2> errores.log\nls archivo-que-no-existe 2> /dev/null',
+      instruction: '/dev/null es como un "agujero negro" - descarta todo lo que le envíes.'
+    },
+    {
+      type: 'command-intro',
+      command: '&>',
+      description: 'Redirección de salida Y errores',
+      explanation: '&> redirige tanto la salida normal como los errores al mismo destino.',
+      example: 'npm install &> install-log.txt\ngit pull &> pull.log',
+      instruction: 'Útil cuando quieres capturar todo lo que un comando produce.'
+    },
+    {
+      type: 'code',
+      title: 'Ejemplo real: Procesando una versión',
+      code: `#!/bin/bash
+
+# Obtener versión del package.json
+VERSION=$(node -p "require('./package.json').version")
+
+# Aquí está la magia del here-string:
+# 1. Tomamos $VERSION (ej: "1.2.3")
+# 2. Se lo pasamos como entrada a read usando <<<
+# 3. IFS='.' le dice a read que separe por puntos
+# 4. -r significa "raw" (no interpretar backslashes)
+# 5. -a PARTS dice "guarda las partes en el array PARTS"
+
+IFS='.' read -r -a PARTS <<< "$VERSION"
+
+# Ahora podemos acceder a cada parte
+echo "Major: \${PARTS[0]}"   # 1
+echo "Minor: \${PARTS[1]}"   # 2
+echo "Patch: \${PARTS[2]}"   # 3
+
+# Incrementar el patch
+NEW_PATCH=$((PARTS[2] + 1))
+echo "Nueva versión: \${PARTS[0]}.\${PARTS[1]}.$NEW_PATCH"`,
+      after: [
+        '',
+        'El operador <<< es una forma elegante de pasar datos.',
+        'Sin él, tendrías que crear un archivo temporal o usar echo | read.',
+        'Es especialmente útil para procesar variables.'
+      ]
+    },
+    {
+      type: 'code',
+      title: 'Combinando pipes y redirección',
+      code: `# Ver solo archivos .js, contar líneas, guardar resultado
+ls | grep ".js" | wc -l > total-archivos.txt
+
+# Buscar en múltiples archivos y guardar matches
+cat *.js | grep "function" > funciones.txt
+
+# Procesar git log y extraer solo los commits
+git log --oneline | head -5 > ultimos-commits.txt
+
+# Buscar errores en logs, ignorar otros mensajes
+cat app.log | grep "ERROR" 2> /dev/null > errores-importantes.txt`,
+      after: [
+        '',
+        'Puedes encadenar cuantos pipes necesites.',
+        'Cada comando procesa la salida del anterior.'
+      ]
+    },
+    {
+      type: 'maze-completion',
+      message: 'Piping y Redirección completado!',
+      unlocked: 'Ahora entiendes cómo fluye la información entre comandos.'
+    }
+  ]
+}

package/lib/data/menus.js

@@ -8,7 +8,8 @@ export const SINTAXIS_MENU_CONFIG = {
   options: [
     { id: 'terminal-basico', title: '1. Terminal básico', description: 'ls, cd, mkdir' },
     { id: 'git-basico', title: '2. Git básico', description: 'init, status, add, commit' },
-    { id: 'bash-scripts', title: '3. Bash Scripts', description: 'variables, sed, condicionales' }
+    { id: 'bash-scripts', title: '3. Bash Scripts', description: 'variables, sed, condicionales' },
+    { id: 'piping-redireccion', title: '4. Piping y Redirección', description: '|, >, <, <<<' }
   ]
 }
 

package/lib/executors/sintaxis-executor.js

@@ -4,6 +4,7 @@ import { LessonBuilder } from '../builders/LessonBuilder.js'
 import { TERMINAL_BASICO } from '../data/lessons/sintaxis/terminal-basico.js'
 import { GIT_BASICO } from '../data/lessons/sintaxis/git-basico.js'
 import { BASH_SCRIPTS } from '../data/lessons/sintaxis/bash-scripts.js'
+import { PIPING_REDIRECCION } from '../data/lessons/sintaxis/piping-redireccion.js'
 import { clearConsole } from '../utils/output.js'
 import { createPromptInterface } from '../utils/input.js'
 import { UserState } from '../utils/user-state.js'
@@ -12,7 +13,8 @@ import { UNLOCK_CONFIG } from '../data/progression.js'
 const LESSONS_BY_ID = new Map([
   ['terminal-basico', TERMINAL_BASICO],
   ['git-basico', GIT_BASICO],
-  ['bash-scripts', BASH_SCRIPTS]
+  ['bash-scripts', BASH_SCRIPTS],
+  ['piping-redireccion', PIPING_REDIRECCION]
 ])
 
 function waitForEnter(message = '\nPresiona Enter para continuar...') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@icarusmx/creta",
-  "version": "1.4.6",
+  "version": "1.4.7",
   "description": "Salgamos de este laberinto.",
   "type": "module",
   "bin": {