YAML

Origem: Wikipédia, a enciclopédia livre.

YAML é um formato de serialização (codificação de dados) de dados legíveis por humanos inspirado em linguagens como XML, C, Python, Perl, assim como o formato de correio eletrônico especificado pela RFC 2822. YAML foi proposto por Clark Evans em 2001 em conjunto com Ingy döt Net e Oren Ben-Kiki.

YAML é um acrónimo recursivo que significa "YAML Ain't Another Markup Language" (em português, "YAML não é outra linguagem de marcação"). No início do seu desenvolvimento YAML significava "Yet Another Markup Language" ("Mais outra linguagem de marcação") para distinguir seu propósito centrado em dados no lugar de documentos marcados. Como é usado frequentemente XML para serialização de dados e XML é uma autêntica linguagem de marcação de documentos, é razoável considerar o YAML como uma linguagem de marcação rápida.

[editar] Características

YAML foi criado na crença que todos os dados podem ser reprsentados adequadamente como combinação de listas, hashes (mapas) e dados escalares (valores simples). A sintaxe é relativamente simples e foi desenhada tendo em conta que é muito legível, mas que também fosse facilmente mapeada pelos tipo de dados mais comuns na maoria das linguagens de alto-nível. Além disso, YAML utiliza uma notação baseada em identação e um conjunto de caracteres sigil distintos dos que são usados pelo XML, fazendo com que as duas linguagens sejam facilmente compostas uma na outra.

Os conteúdos em YAML utilizam o conjunto de caracteres unicode (UTF-8 ou UTF-16).
A estrutura do documento é composto por identação com espaços em branco; não é permitido o uso de caracteres de tabulação para a identação.
Os membros das listas são encabeçados por um traço ( - ) nos títulos e com um membro em cada linha, ou entre colchetes ( [ ] ) e separados por uma vígula e espaço ( , ).
Os vetores associativos se representam usando os ois pontos ( : ) seguido por um espaço. Na seguinte forma "Chave: valor", um por linha ou entre chaves ( { } ) e separados por vírgula seguido de espaço ( , ).
Um valor de um vetor associativo vem precedida por um sinal interrogação ( ? ), o que permite que se construam chaves complexas sem ambiguidade.
Os valores simples não levam as aspas, mas podem ser incluidas as aspas duplas ( " ), ou aspas simples ( ' ).
Nas aspas duplas, os caracteres espaciais podem ser representados com sequências de escape similares a da [[linguagem de programação C, que começam com uma barra invertida ( \ ).
Se pode incluir múltiplos documentos dentro de um único fluxo, separando-os por três traços ( --- ); os três pontos ( ... ) indicam o fim de um documento dentro de um fluxo.
Os nós repetidos podem ser inicializados com um ampersand ( & ) e são referidos posteriormente usando o asterisco ( * )
Os comentários são encabeçados por cerquilha ( # ) e continuam até o final da linha.
Os documentos YAML podem ser precedidos por diretivas compostas por um sinal de porcentagem ( % ) seguidos de um nome e parâmetros delimitados por um espaço.
- A diretiva %YAML é utilizada para identificar a versão do YAML em um documento.
- A diretiva %TAG é utilizada como atalho para prefixos de URIs.

YAML requer que as vírgulas e pontos sejam utilizados como separadores nas listas seguidos por um espaço, de forma que os valores escalares que contenham sinais de pontuação (como 5,280 ou http://www.wikipedia.org) possam se representar sem a necessidade de utilizar aspas.

[editar] Exemplos

[editar] Listas

--- # Enciclopédias favoritas, formato em bloco
- Wikipedia
- Encarta
- Barsa
--- # Lista de compra, formato em linha
[Britannia, Larrousse]

[editar] Vetores assosiativos

--- # Em Bloco
nome: Pedro
idade: 23
--- # Em linha
{nome: Pedro, idade: 23}

[editar] Preservando retornos de linha

--- |
A Rosa do Povo
Sentimento do mundo
O poeta, declina de toda responsabilidade,
    na marcha do mundo, capitalista,
    e com suas palavras, intuições, 
    símbolos e outras armas, promete ajudar
    a destruí-lo, como uma pedreira,
    uma, floresta, um verme

[editar] Ignorando retornos de linha

--- >
 Este texto 
 será formatado
 como um 
 único parágrafo

 As linhas em branco 
 fazendo a mudança de parágrafo.

[editar] Listas de vetores associativos

- {nome: Cosme, idade: 47}
- nome: Damião
  idade: 57

[editar] Vetores associados a listas

nomes: [Cosme, Damião]
nomes:
 - Cosme
 - Damião

[editar] Implementações

Existem implementação de YAML para as seguintes linguagens:

JavaScript
Objective-C
Perl
PHP
Python
Ruby (utiliza YAML como formato de serialização por padrão; YAML está incluído na biblioteca padrão desde a versão 1.8)
Java
Haskell
XML

[editar] Veja também

Outras linguagens de marcação:

JSON (Jason)
Simple Outline XML
OGDL
S-expressão
Plist, o formato de serialização de objetos do NEXTSTEP.

[editar] Referências na internet

Retirado de "http://pt.wikipedia.org../../../y/a/m/YAML_9463.html"

Categoria: Linguagens de marcação