YAML-LD reader/writer

Ruby YAML-LD reader/writer for RDF.rb

YAML_LD parses and serializes YAML-LD into RDF.

As the specification is under development, this gem should be considered experimental and is subject to change at any time.

YAML-LD documents may use frames or contexts described either using JSON-LD or YAML-LD.

• Process YAML-LD source using JSON-LD Context or Frame.
• Process JSON-LD source using YAML-LD Context or Frame.

require 'rubygems'
require 'yaml\_ld'

input = StringIO.new(%(
"@context":
  "@vocab": http://xmlns.com/foaf/0.1/
name: Gregg Kellogg
homepage: https://greggkellogg.net
depiction: http://www.gravatar.com/avatar/42f948adff3afaa52249d963117af7c8
))

YAML_LD::API.expand(input) # => %(
%YAML 1.2
---
- http://xmlns.com/foaf/0.1/name:
  - "@value": Gregg Kellogg
  http://xmlns.com/foaf/0.1/homepage:
  - "@value": https://greggkellogg.net
  http://xmlns.com/foaf/0.1/depiction:
  - "@value": http://www.gravatar.com/avatar/42f948adff3afaa52249d963117af7c8
)

input = StringIO.new(%(
"@context":
  "@vocab": http://xmlns.com/foaf/0.1/
name: Gregg Kellogg
homepage: https://greggkellogg.net
depiction: http://www.gravatar.com/avatar/42f948adff3afaa52249d963117af7c8
))

YAML_LD::API.expand(input, serializer: JSON::LD::API.method(:serializer)) # => %(
[
  {
    "http://xmlns.com/foaf/0.1/name": [{ "@value": "Gregg Kellogg" }],
    "http://xmlns.com/foaf/0.1/homepage": [{ "@value": "https://greggkellogg.net" }],
    "http://xmlns.com/foaf/0.1/depiction": [{
      "@value": "http://www.gravatar.com/avatar/42f948adff3afaa52249d963117af7c8"
    }]
  }
]
)

input = StringIO.new(%(
{
  "@context": {
    "@vocab":"http://xmlns.com/foaf/0.1/"
  },
  "name": "Gregg Kellogg",
  "homepage": "https://greggkellogg.net",
  "depiction": "http://www.gravatar.com/avatar/42f948adff3afaa52249d963117af7c8"
}
))

YAML_LD::API.expand(input, content_type: 'application/ld+json') # => %(
%YAML 1.2
---
- http://xmlns.com/foaf/0.1/name:
  - "@value": Gregg Kellogg
  http://xmlns.com/foaf/0.1/homepage:
  - "@value": https://greggkellogg.net
  http://xmlns.com/foaf/0.1/depiction:
  - "@value": http://www.gravatar.com/avatar/42f948adff3afaa52249d963117af7c8
  )

The gem largely acts as a front-end for the JSON-LD gem with differences largely in the serialization format only.

In addition to the input, both a context and frame may be specified using either JSON-LD or YAML-LD.

• Ruby (>= 2.6)
• JSON-LD (>= 3.2.2)
• Psych (>= 4.0)
• RDF.rb (~> 3.2)

As of October 2023, Ubuntu distributions are running with libyaml 0.2.1, which does not support YAML 1.2. The minimum version needed is libyaml 0.2.5.

The recommended installation method is via RubyGems. To install the latest official release of the JSON-LD gem, do:

% [sudo] gem install yaml-ld

To get a local working copy of the development repository, do:

% git clone git://github.com/ruby-rdf/yaml-ld.git

• https://lists.w3.org/Archives/Public/public-rdf-ruby/

• Gregg Kellogg - https://greggkellogg.net/

• Do your best to adhere to the existing coding conventions and idioms.
• Don't use hard tabs, and don't leave trailing whitespace on any line.
• Do document every method you add using YARD annotations. Read the tutorial or just look at the existing code for examples.
• Don't touch the json-ld.gemspec, VERSION or AUTHORS files. If you need to change them, do so on your private branch only.
• Do feel free to add yourself to the CREDITS file and the corresponding list in the the README. Alphabetical order applies.
• Do note that in order for us to merge any non-trivial changes (as a rule of thumb, additions larger than about 15 lines of code), we need an explicit public domain dedication on record from you, which you will be asked to agree to on the first commit to a repo within the organization. Note that the agreement applies to all repos in the Ruby RDF organization.

This is free and unencumbered public domain software. For more information, see https://unlicense.org/ or the accompanying {file:UNLICENSE} file.