Cómo está montado el trabajo detrás de esta web: los ejercicios viven en packs, unas pocas herramientas de terminal los eligen, los prueban y los entregan, y la web copia la misma estructura. Empezó en la piscine y ahora abarca el cursus entero; la idea es que el outer core entre igual.
En 42 te pasas el día haciendo las mismas cuatro cosas: editar, mirar la norma, compilar y probar. El sistema zen hace que las tres últimas pasen solas. Eliges un ejercicio una vez y una ventana de terminal partida en paneles se pone a vigilarlo: uno enseña el árbol de ficheros, otro pasa la norma y otro relanza los tests cada pocos segundos. Tú solo escribes; si algo se pone en rojo, lo ves al momento.
+---------------+-------------+---------------+
| | watch tree | |
| zenpack +-------------+ asistente |
| + shell | norminette | |
| +-------------+---------------+
| | watch tests | shell del pack|
+---------------+-------------+---------------+
Todo se apoya en un truco muy simple: un único fichero de estado,
~/.local/state/zenidx/current-pack, que guarda la ruta del pack activo. Solo
zenpack lo escribe; todos los demás lo leen en cada vuelta. Por eso, al cambiar
de ejercicio, los seis paneles se reapuntan sin reiniciar nada.
zenhelp monta el mapa leyendo esas cabeceras en vez de duplicarlas.Un pack es una carpeta por proyecto con todo lo que hace falta para trabajarlo:
~/zenidx/packs/ETAPA/[MN/]NNN_nombre/
├── repo/ lo que se entrega (ex00, ex01, ... o el proyecto entero)
├── test/ Makefile + test.c → compila un binario `runner`
├── subject.pdf el enunciado (y subject.txt, su texto)
└── extra/ lo que no se entrega: pruebas, scripts, notas
La separación importa: repo/ es exactamente lo que verá la Moulinette, y nada de
test/ ni de extra/ puede colarse en la entrega. El repositorio
ZenidX/Projects42 versiona los packs enteros; vogsphere solo recibe cada
repo/.
La etapa es el tramo de 42: piscine y cursus. Dentro, los packs
van numerados del 000 al 999 en el orden en que se hacen, que casi nunca es
el alfabético:
packs/piscine/000_shell00 … 015_c13, 016_rush00 … 019_bsq
packs/cursus/M0/000_C-piscine-reloaded, M0/001_Libft
packs/cursus/M1/100_ft_printf, 101_get_next_line, 102_push_swap, 103_Exam_atonement
packs/cursus/M2/200_Born2beroot … 213_Exam_Rank_02
…
packs/cursus/M6/600_ft_transcendence … 602_Exam_Rank_06
La piscine son 20 packs y cabe en una lista. El cursus son más de treinta, así que se parte en
milestones: un directorio MN/ por cada rank de la intra, y la centena del número
sigue al milestone (M1/100, M2/200…). Los títulos salen de
packs/cursus/.milestones, y con ese fichero el menú de zenpack pregunta
primero por el rank y luego por el proyecto. El reparto de proyectos por rank se leyó del
holy graph de la intra, siguiendo el camino 42next. La galaxia de esta web
lo dibuja igual.
Para elegir no hace falta escribirlo entero: zenpack 005_c03, zenpack c03
y zenpack 005 llevan al mismo sitio.
| Comando | Qué hace |
|---|---|
zenpack | Elige o crea (-n) el pack activo y te deja en su repo/. Es el único que escribe el estado. |
zenin | Ejecuta un comando dentro del pack activo: la pieza básica de los paneles. |
zenwatch | Envuelve zenin en watch -n; con Ctrl+C deja una shell viva en vez de cerrar el panel. |
zentest | cd <pack>/test && make && ./runner ../repo; con --compact, resumen para el panel. |
zennorm | norminette, o flake8 si el repo es de Python; los flags especiales de un pack van en su .zennorm. |
zenshell / zcd | Una shell dentro del pack, o saltar a él desde la shell en la que estás. |
zenlibft | Copia la libft maestra a un proyecto y trae de vuelta lo nuevo. |
zengit | git para los repos de vogsphere, con el .git fuera del pack. |
zen / zenlayout | Menú de ajustes (layout, ritmo de cada panel) y abrir el layout en Terminator. |
zenhelp | El mapa de todo; zenhelp zengit enseña la ayuda de uno. |
Todo vive en tools/zen/ y se instala copiando los scripts a ~/.local/bin
con ./install.sh, que se puede relanzar las veces que haga falta y guarda una copia
.bak de lo que pisa. El PATH va en ~/.zshenv y no en
~/.zshrc porque los paneles arrancan la shell en modo no interactivo, que no lee
.zshrc.
En la piscine cada módulo era un pack con su test/. El día a día era:
zenpack c03: el layout se pone a vigilar C 03.ex00/ft_strcmp.c. En segundos, el panel de norminette dice si
cumple la norma y el de tests compila y lo prueba.repo/ a vogsphere.Los runners de C 00 a C 08 salen de una plantilla común: una cabecera, los casos de cada
módulo y un final. El runner se recompila una vez por ejercicio, hace #include del
fuente del alumno y anula su main con -Dmain= para poder llamar a sus
funciones. Cada caso corre en un proceso hijo con tiempo límite, así que un segfault o un bucle
infinito marcan ese caso como CRASH o TIMEOUT y el resto sigue.
-fsyntax-only para distinguir «no está declarado» de «está declarado con
otro tipo». Ese módulo obliga además a escribir macros con parámetros, que la norminette prohíbe:
por eso zennorm admite flags propios de cada pack, y el panel no se queda en rojo por
errores que no puedes arreglar.Las páginas de la piscine documentan esas soluciones ejercicio a ejercicio.
El salto al cursus cambió la escala: pasó de 20 módulos de un día a decenas de proyectos de semanas, repartidos por ranks. El sistema creció en cuatro direcciones:
cursus/M0…M6, con el menú en dos pasos.ft_*.c por
separado, vigila malloc/free para cazar fugas, hace fallar el malloc
número k y pone buffers pegados a una página protegida para que leer un byte de más dé
CRASH. El de get_next_line se recompila con varios BUFFER_SIZE (1, 42,
10000000). El de ft_printf compara cada caso con el snprintf de glibc y saca una
línea OK/KO por llamada.lib/libft. Casi todo el cursus la reutiliza, pero
vogsphere necesita los ficheros dentro de cada repo/, y un enlace simbólico no se
entrega. zenlibft la copia a cada proyecto y, con -b, se trae lo nuevo
que hayas escrito allí. Antes de tocar la maestra comprueba que lo nuevo compila, pasa la norma
y está en el Makefile.zennorm decide en cada
pasada qué norma toca: si en el repo solo hay .py, flake8; si no, norminette.Cada entrega es su propio repo de git en vogsphere, pero los ficheros también están versionados
en ZenidX/Projects42. Si cada repo/ llevara su .git dentro, el
repo grande solo vería un puntero vacío (un gitlink) en lugar de los ficheros. La
solución de zengit es guardar el .git de cada entrega fuera, en
~/.local/share/zenidx-vogsphere/<slug>.git, con core.worktree
apuntando de vuelta al pack:
cd ~/zenidx/packs/cursus/M1/100_ft_printf
zengit init
zengit remote add origin vogsphere@…:vogsphere/<id>
zengit add . && zengit commit -m "entrega" && zengit push
El árbol de trabajo es siempre el que se registró en el alta, así que zengit add .
desde la raíz del pack solo añade lo que hay en repo/, nunca el enunciado ni los
tests.
Esta web es web/ dentro del mismo repositorio y copia su estructura:
packs/piscine/004_c02/ → web/piscine/004_c02.html
packs/cursus/M1/102_push_swap/ → web/cursus/M1/102_push_swap.html
Cada proyecto hecho tiene una página con su código explicado, un glosario de teoría y las
preguntas probables de la evaluación. Los que faltan tienen una ficha «pendiente» que explica el
enunciado sin dar la solución. Con cada push a main que toque web/, un
GitHub Action la publica en GitHub Pages.
Después del common core (los ranks 00 a 06) llega el outer core, la parte de
especialización del cursus. El sistema está pensado para que entre sin cambiar ninguna
herramienta: será una etapa más, packs/outercore/, con sus milestones en un
.milestones si hacen falta, sus packs numerados y su reflejo en web/.
zenpack, zentest y zengit ya entienden cualquier etapa,
porque no tienen ninguna lista de proyectos escrita dentro. En la galaxia,
el outer core es el anillo exterior, de momento vacío.