Aulas e o jogo de aprendizado

Texto e expressões regulares

Interprete o log de lançamento de um foguete e o feed de GPS de uma nave com strings, split e join, e expressões regulares, depois construa um analisador de logs num Raspberry Pi.

O curso

Texto e expressões regulares é um curso intermediário de Programação em sete aulas num Raspberry Pi 4 com dois LEDs (vermelho no GPIO17, amarelo no GPIO27). Dois feeds reais passam por ele: o log de lançamento do Mokxi-1 (uma aba chamada launch_log.txt, com um comentário, uma linha em branco e uma linha corrompida por uma queda de telemetria) e seis minutos de NMEA 0183 de um navio de pesquisa saindo da Baía de Monterey (nmea.txt, com checksums reais, uma sentença corrompida e uma cortada). Cada passo é verificado contra o que o Pi imprime.

  1. Strings a fundo: repr para ver espaços ocultos, strip, indexação e slicing, find, in, count, por que strings nunca mudam, especificações de formato para colunas organizadas, e escapes e raw strings.
  2. Split e join: split num separador, em espaços e com limite, desempacotando campos, o log inteiro lido linha por linha, join, e partition para telemetria key=value.
  3. Fundamentos de re: re.search e o objeto Match, \d, \w, \s e +, âncoras com re.M, {m,n} e \b, re.split e re.sub, e padrões compilados com re.I.
  4. Grupos: group() e groups(), um carimbo de T-minus convertido em segundos, grupos nomeados, findall com grupos e (?:...), retroreferências em re.sub, e finditer com posições.
  5. Analisando logs: um regex por linha em registros (seconds, system, message), comentários diferenciados de danos, contagens por sistema, avisos com carimbos de tempo, a queima do primeiro estágio (154 s) e uma janela de tempo.
  6. Analisando linhas NMEA: o checksum XOR que detecta a leitura corrompida (e a troca que ele não consegue detectar), os campos do GGA por posição, graus e minutos para graus decimais, uma regex de validação, e velocidade e curso a partir do RMC.
  7. Projeto: um analisador de log: a conclusão.

O gran final

The analyzer loads and parses the launch log, prints a summary (17 events, 2 warnings, 1 unreadable) and then answers commands typed in the Serial Monitor: grep with any regular expression, between T+01:00 T+03:00 for a time window, stats for every system ranked, and quit. A broken pattern like grep ( is reported with re's own message instead of crashing the tool. The red LED on GPIO17 is the alarm: lit whenever the log holds a warning. It is switched on before the prompt, because a program waiting at input() runs nothing else.

O que o motor do Pi faz de diferente

O Pi roda MicroPython 1.29 com uma biblioteca padrão no estilo do CPython:

  • O re é o próprio da engine, escrito em Python com a sintaxe do CPython: grupos nomeados, {m,n}, \b, lookarounds e as flags funcionam, então todo padrão do curso roda no CPython sem mudanças. Ele é mais lento, e o tipo de um padrão compilado imprime como Pattern, onde o CPython diz re.Pattern.
  • O MicroPython em um microcontrolador (uma Pico, um ESP32) tem um re incluído muito menor, sem {m,n}, sem \b e sem grupos nomeados. O curso indica onde um padrão precisaria mudar para rodar lá.
  • str não tem ljust, rjust, zfill, title, capitalize, isalnum, removeprefix nem translate. As especificações de formato ({name:<8}, {n:03d}) fazem o mesmo trabalho e funcionam em qualquer Python.
  • O str() de um float pode imprimir mais dígitos do que o CPython imprime (98.59999999999999 para 98.6), e arredondar um valor exatamente no meio pode cair em um último dígito diferente. Imprimir com uma especificação de formato como {n:.1f} dá o mesmo texto em qualquer lugar.
  • Um dict não mantém a ordem em que as chaves entraram, então as aulas leem as chaves pelo nome ou as ordenam.