
GitHub Actions aceita YAML inválido segundo a especificação 1.2.2
O GitHub Actions aceita uma construção fora do YAML 1.2.2, embora analisadores conformes possam rejeitá-la.
Uma etapa de ação expõe a divergência
O GitHub Actions aceita uma construção que viola a especificação YAML 1.2.2. A divergência veio à tona quando uma pessoa relatou que o zizmor rejeitou um fluxo de trabalho com uma etapa aceita pela plataforma.
A etapa usava a ação jsdaniell/create-json@v1.2.3 para criar um arquivo JSON de configuração de um repositório remoto do npm. O valor da entrada json era um texto JSON entre aspas simples, distribuído por várias linhas. A construção parece comum, mas não atende à regra de indentação do YAML.
A regra de indentação do YAML
A especificação YAML 1.2.2 determina que nós no estilo de fluxo dentro de uma coleção em bloco — como uma lista ou um mapa — comecem com pelo menos um espaço a mais que a coleção que os contém. Eles também podem começar em uma linha seguinte, desde que respeitem essa exigência de recuo.
No exemplo, a construção aceita pelo GitHub Actions difere da forma compatível com a especificação por um espaço: o conteúdo da string JSON precisa avançar ao menos um espaço em relação à coleção em bloco. A diferença é discreta e pode passar despercebida, mas leva um analisador estritamente conforme a rejeitar o arquivo.
Consequências para a análise de fluxos
Essa diferença dificulta a leitura automatizada de fluxos de trabalho reais. Um arquivo tolerado pelo GitHub Actions pode ser recusado por uma ferramenta que aplica a regra publicada, impedindo seu processamento. O autor descreve o caso como um obstáculo à análise de algumas configurações usadas na prática.
O episódio também levou a uma revisão de uma tentativa de corrigir o comportamento do tree-sitter-yaml. Primeiro, o autor abriu o item nº 36 para acomodar a construção observada. Depois, concluiu que a mudança tratava como válida uma sintaxe fora da especificação e abriu o item nº 51 para revertê-la.
O parser usado pela plataforma ainda é uma hipótese
Como boa parte do código por trás do GitHub Actions é proprietária, não há confirmação direta sobre o analisador empregado. O autor considera provável que seja o YamlDotNet e estima que o Actions use a versão 5.3.0, lançada em 2018. Essa identificação é uma hipótese, não uma confirmação do GitHub.
Segundo a análise do autor, atualizar para o YamlDotNet 18.1.0, versão mais recente considerada no relato, ainda não corrigiria esse caso: o comportamento problemático permanece nessa versão. A explicação proposta é que uma correção de 2020 cobriu strings entre aspas duplas, mas não as entre aspas simples. O autor relaciona essa possibilidade ao fato de a suíte oficial de testes YAML exercitar a regra 8.2.3 com aspas duplas, embora ela também se aplique às simples. Leia o relato original.

Comentários
0Comece a conversa.
Seja a primeira pessoa a comentar este conteúdo.