Ferramentas YAML no XMLSpy

Editor e validador YAML

  • Realce de sintaxe
  • Verificação da conformidade do YAML
  • Visualização em grade YAML
  • Validar o formato YAML em relação a um esquema JSON / esquema YAML
  • Suporte para esquemas YAML
  • Consultar arquivos YAML com XQuery
  • Converter YAML para JSON / XML
  • Converter XML para YAML
  • Converter JSON para YAML
  • Gerar um esquema JSON a partir de YAML
  • Gerar um esquema YAML a partir de um ficheiro YAML
  • Converter um esquema XSD para YAML

Vantagens do YAML

Abreviatura de "YAML Ain't Markup Language" (YAML não é uma linguagem de marcação) YAML YAML é um formato de serialização de dados que é facilmente compreensível por humanos e que é frequentemente utilizado para ficheiros de configuração, troca de dados e programação de aplicações. A maioria das linguagens de programação oferece bibliotecas ou suporte integrado para a análise de YAML. Foi concebido para ser fácil de ler e escrever, o que o torna uma excelente opção para configurações que precisam ser editadas por pessoas.

Uma das principais vantagens do YAML é a sua simplicidade e flexibilidade. O YAML utiliza indentação e dois pontos para definir estruturas hierárquicas, tornando-o conciso e fácil de entender. Suporta uma variedade de tipos de dados, incluindo valores simples (strings, números, booleanos), sequências (listas) e mapeamentos (pares chave-valor). O YAML também suporta âncoras e aliases, que permitem a reutilização de dados e permitem representar estruturas de dados complexas de forma eficiente.

Os ficheiros YAML terminam normalmente com a extensão .yaml ou .yml.

Editor YAML: Visualização de texto

Editor YAML no XMLSpy

Muitas aplicações e sistemas modernos utilizam uma combinação de XML, JSON e YAML para ficheiros de configuração, troca de dados e conteúdo de APIs.

Além de Edição de arquivos YAMLO XMLSpy oferece um suporte abrangente para XML e JSON. A capacidade de trabalhar com todos estes formatos num único editor oferece aos programadores a flexibilidade de trabalhar com ficheiros de diferentes fontes e integrá-los nos seus projetos de forma fluida.

As ferramentas XMLSpy para YAML incluem:

  • Edição de arquivos YAML com realce de sintaxe
  • Dobramento do código e números de linha
  • Verificação de correção sintática
  • Validador YAML
  • Geração de esquema a partir de um documento YAML
  • Conversor YAML com um único clique

Visualização em grade YAML

Além do seu editor de texto, o XMLSpy inclui uma visualização em grade para editar documentos YAML de forma visual. A visualização em grade YAML será imediatamente familiar aos programadores que utilizam as visualizações XML Grid e JSON Grid do XMLSpy.

A visualização em grade YAML oferece uma representação gráfica da estrutura do documento, que é muito mais fácil de entender do que o código correspondente na visualização de texto. A visualização em grade permite interagir com os dados YAML de uma forma mais intuitiva, reduzindo os erros que podem ocorrer ao editar manualmente ficheiros YAML (como o desalinhamento da indentação). A possibilidade de expandir e recolher seções dos dados YAML facilita a navegação em ficheiros grandes e a localização de elementos específicos.

Editor visual YAML no XMLSpy

Ferramentas inovadoras, como o modo de tabela (mostrado na área selecionada acima) e os filtros XPath/XQuery, tornam o YAML Grid particularmente útil, e a visualização em grade oferece uma variedade de ferramentas que facilitam o trabalho com YAML:

  • A estrutura do documento YAML pode ser facilmente modificada através da adição, eliminação ou movimentação de elementos na grelha. Blocos inteiros de texto podem ser reorganizados rapidamente (por exemplo, através da ordenação ou movimentação).
  • O conteúdo pode ser editado facilmente na visualização em grade, especialmente utilizando os comandos integrados em cada célula.
  • O modo "Tabela" permite que um nó com nós descendentes seja exibido num formato de tabela, facilitando a compreensão, com cada objeto descendente apresentado numa linha separada. Pode ativar e desativar o modo "Tabela" conforme necessário, para se adequar ao conteúdo em questão.
  • As funcionalidades de visualização ajudam a determinar rapidamente a relação entre um alias e um ponto de referência.
  • Filtros e fórmulas podem ser utilizados para filtrar e processar dados, conforme necessário.
  • O conteúdo pode ser editado visualmente, utilizando funcionalidades de arrastar e soltar e menus de contexto relacionados aos tipos de dados.

Validador YAML

Como a especificação YAML não inclui um esquema, o XMLSpy permite validar documentos YAML em relação a esquemas JSON, garantindo a consistência dos dados e a deteção de erros. É possível utilizar tanto esquemas JSON tradicionais como esquemas YAML, que são esquemas JSON escritos na sintaxe YAML. Os esquemas JSON e YAML podem ser editados facilmente na interface gráfica do XMLSpy Editor de Esquemas JSON.

Pode atribuir um esquema ao seu documento YAML na aba JSON da janela de informações do XMLSpy. Após a validação, os resultados serão destacados no documento e os detalhes serão exibidos na janela de mensagens. Pode clicar num erro na janela de mensagens para ir diretamente para esse erro no documento, facilitando a resolução de problemas.

Converter YAML

Para garantir a compatibilidade e a interoperabilidade, o XMLSpy permite a conversão, com um único clique, entre os formatos YAML, XML e JSON.

Isto inclui a conversão de:

  • Conversão de JSON para YAML
  • XML para YAML
  • YAML para JSON / XML
  • Conversão de YAML para esquema JSON
  • Conversão de YAML para esquema YAML
  • Conversão de um esquema XML (XSD) para um esquema YAML
Converter JSON para YAML no XMLSpy

O XMLSpy consegue gerar um esquema JSON ou um esquema YAML a partir de uma instância YAML. Esta funcionalidade é muito útil, pois fornece rapidamente um esquema baseado num documento YAML existente, poupando-lhe o trabalho associado à criação manual de um esquema do zero. Depois, pode modificar ou expandir o esquema gerado de acordo com as suas necessidades.

Consultar ficheiros YAML com XQuery

Ao contrário do XML, JSON e YAML não possuem uma linguagem de consulta oficial. No entanto, é possível consultar dados em JSON utilizando expressões XPath/XQuery 3.1, e o XMLSpy disponibiliza a mesma funcionalidade para documentos YAML na janela XPath/XQuery.

Para começar rapidamente, selecione um local no ficheiro YAML ativo e escolha a opção "Copiar XPath" no menu de contexto. Em seguida, cole essa expressão na área de construção de XPath/XQuery como ponto de partida. Para modificar a expressão, a ferramenta de construção de XPath/XQuery oferece autocompletar e permite construir expressões através de cliques, utilizando uma lista abrangente de operadores, expressões e funções integradas.

À medida que trabalha, o Avaliador devolve os resultados da sua expressão XQuery, para que possa testar e aperfeiçoar o seu trabalho.

Utilize XQuery para consultar um documento YAML

A capacidade de utilizar o XQuery para trabalhar com arquivos YAML é outra funcionalidade inovadora, exclusiva do XMLSpy.