CLI open source para a 42 Network

A 42 inteira, direto do terminal.

Perfil, avaliações, slots, mapa do campus, subjects, notificações no celular, um simulador de provas offline e testes automáticos dos seus projetos. Um binário só, sem dependências.

$curl -fsSL https://tinyurl.com/lightyear42 | sh

Linux (como nas máquinas da 42) e macOS. Sem sudo: instala em ~/.local/bin, confere o sha256 e põe no PATH. Outras formas · Guia de instalação


    
20+comandos
84exercícios dos Exam Ranks 02 a 05
20projetos com testes automáticos
3sistemas: macOS, Linux, Windows
Funções

Tudo que você abre a Intra para ver, e mais.

Usa a API oficial da 42 com OAuth2; o token fica no keyring do sistema e é renovado sozinho. O simulador de provas e os testes funcionam offline, sem login.

01

App em tela cheia canary

Rode só lightyear e ele abre um app no terminal, com abas clicáveis e mouse: tudo o que os comandos mostram, num lugar só.

  • Início, Avaliações, Projetos, Campus, Slots e Exam.
  • Na aba Exam, e abre o subject e a sua entrega lado a lado no editor do lightyear.
  • Com as notificações configuradas, avisa de avaliação nova enquanto está aberto.
lightyear
Como usar o app →
~ $ lightyear clique nas abas · dados de exemplo

      
02

Perfis e busca

O seu perfil ou o de qualquer cadete: nível, wallet, pontos de avaliação, campus e onde está sentado agora.

  • Busca por prefixo de login, com cache local para não gastar a API.
  • Saída limpa, pronta para o terminal.
lightyear melightyear profile <login>lightyear search <prefixo>
Na referência de comandos →
dados de exemplo

      
03

Projetos e subjects

Status e nota de cada projeto, e o PDF do subject de qualquer um deles, aberto direto do terminal.

  • Catálogo de mais de 240 subjects embutido.
  • O PDF fica em cache: abre na hora da próxima vez.
lightyear projectslightyear subject libft
Na referência de comandos →
dados de exemplo
~ $ lightyear projects
╭────────────────┬────────────────┬──────╮
│ PROJETO        │ STATUS         │ NOTA │
├────────────────┼────────────────┼──────┤
│ Libft          │ ✔ aprovado     │ 125  │
│ get_next_line  │ ✔ aprovado     │ 115  │
│ ft_printf      │ ✔ aprovado     │ 100  │
│ Born2beroot    │ em andamento   │  —   │
╰────────────────┴────────────────┴──────╯

~ $ lightyear subject born2beroot
Abrindo ~/.local/share/42cli/subjects/42next-born2beroot_en.pdf
04

Avaliações e slots

Suas próximas avaliações, como avaliador ou avaliado, e a sua disponibilidade para avaliar, sem passar pelo calendário da Intra.

  • --open abre a avaliação direto na Intra.
  • Abra e feche slots de 15 em 15 minutos pelo terminal (scope projects).
lightyear evaluationslightyear slots listlightyear slots open
Na referência de comandos →
dados de exemplo
~ $ lightyear evaluations
Próximas avaliações

hoje 14:30    você avalia       ft_printf       em 2h
amanhã 10:00  você é avaliado   get_next_line   em 21h

~ $ lightyear slots list
hoje     14:00 → 16:00   livre
amanhã   09:00 → 10:00   reservado
05

Notificações no celular

Um push no celular sempre que surge uma avaliação nova na sua agenda, via ntfy: sem conta e sem app próprio.

  • setup gera o tópico e mostra como assinar.
  • Deixe rodando com watch, ou ponha check no cron.
lightyear notify setuplightyear notify testlightyear notify watch
Configurar as notificações →
lightyear notify --help
Envia uma notificação push quando aparece uma avaliação nova na sua
agenda — como avaliador ou como avaliado.

A entrega usa o ntfy (https://ntfy.sh): instale o app no celular, assine o
tópico gerado pelo "lightyear notify setup" e pronto.

Fluxo típico:

  lightyear notify setup    # gera o tópico e mostra como assinar
  lightyear notify test     # confirma que chega no celular
  lightyear notify watch    # deixa rodando; avisa a cada avaliação nova
06

Campus e amigos

Quem está online, cluster por cluster e posto por posto, e um dashboard ao vivo com perfil, ocupação, avaliações e amigos online.

  • Uma lista local de amigos, e onde cada um está sentado.
  • --friends filtra o mapa só para eles.
lightyear campuslightyear friends addlightyear dashboard
Na referência de comandos →
dados de exemplo
~ $ lightyear campus
42 São Paulo — 87 online

Cluster 1  █████████████████░░░░░░░  41/60  68%
Cluster 2  ███████████░░░░░░░░░░░░░  27/60  45%
Cluster 3  ███████░░░░░░░░░░░░░░░░░  19/60  32%

Cluster 1  ● ocupado
r1  ● ● · ● · · ● ● ● ·
r2  · ● ● ● · ● · · ● ●
r3  ● · · ● ● ● ● · ● ·
07

Simulador de provas

O examshell no seu computador: sorteia o exercício, cronometra, corrige e sobe de nível. Funciona offline, só precisa de um compilador C (e de Python para os Ranks 03 a 05).

  • Os 56 exercícios em C do Exam Rank 02 e os 28 em Python dos Ranks 03, 04 e 05, com enunciado em inglês e português.
  • Correção de verdade: cc -Wall -Wextra -Werror, os mesmos testes no seu código e numa solução de referência.
  • Trace claro de cada falha: compilação, saída diferente, crash ou timeout.
lightyear exam startlightyear exam grademelightyear exam practice ft_split
Como o simulador funciona →
lightyear exam grademe
~ $ lightyear exam grademe
Corrigindo…
✗ FAILURE  first_word

first_word "   lorem,ipsum   "
esperado: "lorem,ipsum\n"
recebido: "\n"

Trace salvo em ~/lightyear-exam/traces/first_word.trace
08

Testes de projeto canary

Na raiz do projeto, lightyear test abre o editor com a árvore de arquivos e um botão ▶ Rodar testes. Centenas de casos por projeto, tirados do subject.

  • libft, ft_printf, get_next_line, os módulos de Python 00 a 10 (e 05/06 bis) e born2beroot.
  • Cada caso roda isolado: segfault, loop infinito, vazamento, double free e malloc sem proteção aparecem caso a caso.
  • Clique num erro e vá direto à linha. Ou rode sem editor com --run.
lightyear test libftlightyear test ft_printf --runsudo lightyear test born2beroot
O que cada projeto testa →
lightyear test libft --run
✓ Makefile 14
✓ funções permitidas 1
✓ ft_strlen 17
✓ ft_memmove 32
✗ ft_split 1 de 24 falharam
    ✗ malloc falhando em cada alocação
        o 3º malloc devolveu NULL e a função não liberou
        o que já tinha alocado (2 bloco(s))
✗ ft_itoa 1 de 25 falharam
    ✗ ft_itoa(-2147483648)
        esperado "-2147483648", recebido "-"
✓ ft_lstmap 4

libft: 734 passaram · 2 falharam (4.1s)
09

Editor embutido canary

Um editor modal estilo Vim dentro do lightyear, com syntax highlighting do Tree-sitter e language server para C, C++, Go, Python e Rust.

  • Erros do compilador na linha, K, gd, autocomplete, renomear e formatar.
  • Buffers, janelas, text objects, macros e . para repetir.
  • Temas com :colorscheme. Clique num aqui ao lado.
:colorscheme draculagdK:Format
Atalhos do editor →

      
10

Atualização e canais

O lightyear se atualiza sozinho pelo GitHub Releases, sem gerenciador de pacotes. Escolha entre a versão estável e a canary, que recebe as novidades antes.

  • --check só verifica; --yes não pergunta.
  • --canary entra no canal canary; --stable volta.
lightyear updatelightyear update --canarylightyear update --stable
Atualizar e trocar de canal →
lightyear update --canary
~ $ lightyear update --canary --yes
Versão atual:  1.2.1
Canal:         canary
Última release: 1.3.0-canary.35
Asset:         lightyear_1.3.0-canary.35_Linux_x86_64.tar.gz
Destino:       /home/marvin/.local/bin/lightyear
Baixando e instalando…
Atualizado para 1.3.0-canary.35. Rode: lightyear version
11

Configuração em dois minutos

Um guia cria a aplicação OAuth na Intra, faz o login e instala o autocomplete do seu shell. O token fica no keyring do sistema.

  • Keychain no macOS, Secret Service no Linux, Credential Manager no Windows.
  • Tudo o que fica no disco tem um caminho só: lightyear config path.
lightyear setuplightyear loginlightyear config show
Primeiros passos →
lightyear --help
Available Commands:
  campus      Mostra quem está online no campus, organizado como um mapa
  evaluations Lista suas próximas avaliações agendadas
  exam        Simulador de provas da 42 (exam rank), com correção local
  notify      Avisa no celular quando uma avaliação nova for agendada
  projects    Lista os projetos de um usuário da 42
  setup       Configura client_id e client_secret da aplicação OAuth na Intra
  slots       Gerencia seus slots de disponibilidade para avaliar
  subject     Baixa e abre o PDF do subject de um projeto
  test        Testa o seu projeto da 42 (libft…) com centenas de casos
  update      Atualiza o lightyear a partir do GitHub Releases
  …
Instalar

Um binário. Nenhuma dependência.

No campus, prefira o comando de uma linha ou o .deb: o Go das máquinas costuma ser mais antigo que o 1.25 que o lightyear exige.

Guia completo de instalação →

      
Open source

Feito por cadetes, aberto para todo mundo.

O lightyear é MIT e está inteiro no GitHub. Achou um bug, quer um comando novo, mais exercícios do exam ou testes de outro projeto? Abra uma issue ou mande um PR.

Créditos: o fluxo do simulador foi inspirado no CodeSim (vgomes-p), e a lista e as soluções base do Exam Rank 02 vêm do Exam_Rank_02_42_School (Alex Higuera, MIT), e a lista dos Ranks 03 a 05 vem do 42exam.net. Os enunciados foram reescritos. O lightyear não é um projeto oficial da 42.