dmosk / valeditor

Linter de JSON, YAML e configurações DevOps

Verifique JSON e YAML no navegador. Depois virão Dockerfile, Compose, Kubernetes, GitLab CI e GitHub Actions.

Só no navegador. JSON e YAML já estão ativos; Dockerfile/Compose, Kubernetes, GitLab CI e GitHub Actions em breve.

Por que o valeditor é útil

  • Nada sai do seu navegador. A verificação roda localmente, então suas configurações não são enviadas nem guardadas.
  • Primeiro JSON e YAML. Verificação rigorosa de sintaxe, com linha e coluna em cada erro.
  • Pega problemas traiçoeiros. BOM, chaves duplicadas e YAML com vários documentos separados por ---.
  • Formatar, compartilhar, baixar. Organize o texto, mande um link a um colega ou salve o arquivo.
  • Mais formatos a caminho. Dockerfile, Compose, Kubernetes, GitLab CI e GitHub Actions estão no roteiro.
  • Grátis e sem cadastro. Abra a página, cole o texto e pronto.

Como usar

  1. Cole JSON ou YAML no editor, ou abra um arquivo.
  2. Escolha o formato ou deixe a detecção automática.
  3. Leia os erros e avisos; cada um mostra linha e coluna.
  4. Formate o texto e depois copie, compartilhe um link ou baixe o arquivo.

O que torna o valeditor confiável

Ele não olha só colchetes e indentação: procura o que costuma quebrar configurações depois do commit.

Vale saber:

  • Chaves duplicadas são reportadas em vez de sobrescritas em silêncio.
  • Um BOM no início do arquivo é detectado antes de quebrar um parser no CI.
  • YAML com vários documentos é verificado documento por documento.
  • Cada erro aponta uma linha e uma coluna, sem precisar procurar.
  • Arquivos grandes são verificados na hora, pois não há ida ao servidor.

Onde ajuda

  • Verificar o arquivo de pipeline antes do commit, em vez de esperar o CI ficar vermelho.
  • Revisar configurações em um pull request e confirmar que o arquivo ao menos é interpretado.
  • Arquivos JSON como package.json, tsconfig.json e configurações de aplicativos.
  • YAML de Helm values, arquivos Compose e manifestos do Kubernetes.
  • Depurar uma configuração copiada de um chat ou ticket que falha sem motivo claro.

Perguntas frequentes

O que é o valeditor?

É um linter online de JSON e YAML que roda no navegador. Ele encontra erros de sintaxe, BOM, chaves duplicadas e problemas em YAML com vários documentos.

Meu texto é enviado a um servidor?

Não. Tudo roda localmente no seu navegador e o conteúdo das suas configurações nunca é enviado.

Quais formatos são suportados?

Hoje, JSON e YAML. Dockerfile, Compose, Kubernetes, GitLab CI e GitHub Actions chegam em breve.

O que exatamente ele verifica?

A sintaxe de JSON e YAML, um BOM no início do arquivo, chaves duplicadas e a estrutura de YAML com vários documentos. Os erros trazem linha e coluna.

Posso verificar arquivos de Compose, Kubernetes e CI agora?

Você pode checar a sintaxe deles, pois são YAML. Regras específicas de cada formato serão adicionadas depois.

Posso formatar, compartilhar e baixar o resultado?

Sim. Você pode organizar o texto, copiar um link para um colega ou salvar o arquivo.

Há suporte para YAML com vários documentos?

Sim. Documentos separados por linhas --- são verificados um a um, e os erros apontam o lugar certo.

É grátis e preciso me cadastrar?

É grátis e não exige cadastro. Basta abrir a página e colar o texto.