Comparando releases

Veja o que mudou entre duas versões do WhatsApp Web, em texto, JSON, NDJSON ou Markdown.

Comparar duas versões é como você encontra recursos antes do anúncio.

cellar diff

Sem argumentos, ele compara as duas versões mais recentes que você guardou. Informe os nomes quando quiser um par específico.

cellar diff whatsapp-1030882912 whatsapp-1044822804 --filter protocol --no-hunks

whatsapp-1030882912 -> whatsapp-1044822804  (filter `protocol`)
  considered 4711 of 172040 modules (old) / 5269 of 187892 (new)
  added 913 | removed 355 | modified 1515 | unchanged 2841
  suppressed as noise: 41 | diffs skipped for size: 0

Leia o resumo antes dos detalhes. Módulos adicionados e removidos são onde recursos novos aparecem. Módulos modificados que ganharam dependências ou exports são onde recursos existentes cresceram.

Comece com --no-hunks para ver o formato do release e rode de novo sem essa flag para os poucos módulos que valem a leitura.

​

O que conta como mudança

Um módulo é comparado pela impressão digital de todas as definições que ele publica, não pelo texto. Só reformatação nunca aparece como mudança, e um módulo que ganhou uma segunda variante de build aparece, mesmo que a definição principal não tenha mudado.

Mudanças em que toda linha alterada é saída de compilador são contadas como noiseOnly no resumo e ficam fora da lista. Use --include-noise se desconfiar que as regras de ruído estão escondendo algo.

​

Formatos de exportação

Texto

Legível por humanos, o padrão.

cellar diff --no-hunks

[modified] WAWebSendMsgStanza
  + deps: WAWebAddonEncryption
  81.4% similar, +4 -7 lines
  new: /Users/voce/.cellar/bundles/whatsapp-1044822804/modules/WAWebSendMsgStanza.js

JSON

Um documento só, para scripts e assistentes.

cellar diff --format json | jq '.summary'

{
  "added": 913,
  "removed": 355,
  "modified": 1515,
  "unchanged": 2841,
  "noiseOnly": 41,
  "diffsSkipped": 0,
  "oldTotal": 172040,
  "newTotal": 187892
}

Liste só os módulos novos:

cellar diff --format json | jq -r '.changes[] | select(.kind=="added") | .name'

NDJSON

Um objeto JSON por linha. A primeira linha é o resumo com a lista de mudanças vazia, depois vem uma linha por mudança, então dá para processar em fluxo em vez de carregar tudo na memória.

cellar diff --format ndjson --no-hunks | head -2

{"changes":[],"filter":"protocol","new":"whatsapp-1044822804","old":"whatsapp-1030882912","summary":{"added":913,"modified":1515,...}}
{"kind":"added","name":"A2UIWidgetStateContext","newFile":"modules/A2UIWidgetStateContext.js","newSha256":"953e62318175bd4cd3d4039ccc41b70e049246bd6c4d729edd2d9869575065b3"}

Markdown

Um relatório para colar em uma issue ou changelog.

cellar diff --format md --limit 40 > notas-release.md

# whatsapp-1030882912 → whatsapp-1044822804

Filter: `protocol`

| metric | count |
| --- | --- |
| Added | 913 |
| Removed | 355 |
| Modified | 1515 |
| Unchanged | 2841 |
| Noise-only (suppressed) | 41 |
| Diffs skipped for size | 0 |

## added (913)

### `A2UIWidgetStateContext`

​

Opções

Flag	Significado
--filter NOME	Quais módulos considerar. Padrão default.
--no-hunks	Lista o que mudou sem o diff linha a linha.
--include-noise	Inclui mudanças que são só saída de compilador.
-C N	Linhas de contexto em volta de cada mudança. Padrão 3.
--limit N	Limita a lista. O resumo continua com os totais reais.
--platform	De qual produto tirar os padrões. Padrão whatsapp.

O filtro default pula arquivos .pb e .graphql, porque são gerados e comparam mal como texto. Quando estiver procurando um campo protobuf novo, use --filter schemas. Veja filtros.