web-dev-qa-db-fra.com

Je ne comprends pas ce qu'est une balise YAML

Je l'obtiens à un certain niveau, mais je n'ai pas encore vu d'exemple qui n'a pas soulevé plus de questions que de réponses.

http://rhnh.net/2011/01/31/yaml-tutorial

# Set.new([1,2]).to_yaml
--- !Ruby/object:Set 
hash: 
  1: true
  2: true

Je comprends que nous déclarons une balise Set. Je ne comprends pas ce que le mappage de hachage a à voir avec cela. Déclarons-nous un schéma? Quelqu'un peut-il me montrer un exemple avec plusieurs déclarations de balises?

J'ai lu la spécification: http://yaml.org/spec/1.2/spec.html#id2761292

%TAG ! tag:clarkevans.com,2002:

Est-ce que cela déclare un schéma? Existe-t-il autre chose qu'un analyseur doit faire pour analyser correctement le fichier? Un fichier de schéma d'un certain type?

http://www.yaml.org/refcard.html

Tag property: # Usually unspecified.
    none    : Unspecified tag (automatically resolved by application).
    '!'     : Non-specific tag (by default, "!!map"/"!!seq"/"!!str").
    '!foo'  : Primary (by convention, means a local "!foo" tag).
    '!!foo' : Secondary (by convention, means "tag:yaml.org,2002:foo").
    '!h!foo': Requires "%TAG !h! <prefix>" (and then means "<prefix>foo").
    '!<foo>': Verbatim tag (always means "foo").

Pourquoi est-il pertinent d'avoir une balise principale et secondaire, et pourquoi une balise secondaire fait-elle référence à un URI? Quel problème est résolu en les ayant?

Il me semble voir beaucoup de "ce qu'ils sont", et non "pourquoi sont-ils là", ou "à quoi servent-ils".

tagsyamlspecificationspyyaml
37
Fred

Je ne sais pas grand chose sur YAML mais je vais essayer:

Les balises sont utilisées pour désigner les types. Une balise est déclarée à l'aide de ! comme vous l'avez vu sur la "refcard". Le %TAG directive est un peu comme déclarer un raccourci vers une balise.

Je vais démontrer avec PyYaml. PyYaml peut analyser la balise secondaire de !!python/object: comme un véritable objet python. Le double point d'exclamation est une substitution en soi, abréviation de !tag:yaml.org,2002:, qui transforme l'expression entière en !tag:yaml.org,2002:python/object:. Cette expression est un peu difficile à saisir chaque fois que nous voulons créer un objet, nous lui donnons donc un alias en utilisant le %TAG directive:

%TAG !py! tag:yaml.org,2002:python/object:            # declares the tag alias
---
- !py!__main__.MyClass                                # creates an instance of MyClass

- !!python/object:__main__.MyClass                    # equivalent with no alias

- !<tag:yaml.org,2002:python/object:__main__.MyClass> # equivalent using primary tag

Les nœuds sont analysés par leur type par défaut si vous n'avez aucune annotation de balise. Les éléments suivants sont équivalents:

- 1: Alex
- !!int "1": !!str "Alex"

Voici un programme complet Python utilisant PyYaml démontrant l'utilisation des balises:

import yaml

class Entity:
    def __init__(self, idNum, components):
        self.id = idNum
        self.components = components
    def __repr__(self):
         return "%s(id=%r, components=%r)" % (
             self.__class__.__name__, self.id, self.components)

class Component:
    def __init__(self, name):
        self.name = name
    def __repr__(self):
        return "%s(name=%r)" % (
            self.__class__.__name__, self.name)

text = """
%TAG !py! tag:yaml.org,2002:python/object:__main__.
---
- !py!Component &transform
  name: Transform

- !!python/object:__main__.Component &render
  name: Render

- !<tag:yaml.org,2002:python/object:__main__.Entity>
  id: 123
  components: [*transform, *render]

- !<tag:yaml.org,2002:int> "3"
"""

result = yaml.load(text)

Plus d'informations sont disponibles dans le spec

19
AlexFoxGill