lutaml-model 0.8.4 → 0.8.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c512d678682ea756cb7eb7a3d439a7d511b763405936e598900f42f7f07aa705
-  data.tar.gz: e6623585797f809090619a9e6268e026773d962cac0f940ccae608627d8e714c
+  metadata.gz: c356719b1c0c3434ba1acb3f59be81cb9374403c8020710ee4d4a5ea78748765
+  data.tar.gz: ac2aa51ef80ce8db3c50b8055df95b6a3732e3e40b72689c635e8ac22fe889f2
 SHA512:
-  metadata.gz: 81558e237a6a7f55c3defee45c8fa8a1d59bf75a875159708065ce8db44308fdaa17d3c727d6ff1074477391ec199008088221f54d5bbb7f2b3b4546ff4d25cf
-  data.tar.gz: 242730ac59628f328fe07409cc54d7798e75b40d29b6b47ad7382de37a033d9f907d0578d8ab950c45c9ff1b06cd67f6cb98e3e6215948149e63e8e4591be15d
+  metadata.gz: b63ac862dc2eeef4a599ff5ada8c6f2434b3bf71187b5813a2637e69f25170692d373bffb2b9413b48323b1cd6161a8529a2ec6582a2fc313d46c95fa8b67088
+  data.tar.gz: 24e23bdedad47cc0796cff0bad1b32809c649bad4a13a64b23d08b3bef2dad4c769cfc299cdb85abeffd9a53ea677c41f91c759114f320a5047787cafc6c253e

data/.github/workflows/dependent-tests.yml

@@ -22,3 +22,8 @@ jobs:
     uses: metanorma/ci/.github/workflows/dependent-rake.yml@main
     with:
       command: bundle exec rspec
+      setup-tools: 'inkscape,ghostscript,exiftool,ffmpeg,imagemagick'
+      after-setup-ruby: |
+        if [ -f frontend/package.json ]; then cd frontend && npm install && npm run build; fi
+    secrets:
+      pat_token: ${{ secrets.LUTAML_CI_PAT_TOKEN }}

data/.rubocop.yml

@@ -24,3 +24,21 @@ Style/OneClassPerFile:
       - Exclude
   Exclude:
     - 'spec/**/*'
+
+RSpec/EmptyExampleGroup:
+  inherit_mode:
+    merge:
+      - Exclude
+  Exclude:
+    - 'spec/lutaml/jsonld/transform_spec.rb'
+
+RSpec/NamedSubject:
+  inherit_mode:
+    merge:
+      - Exclude
+  Exclude:
+    - 'spec/lutaml/turtle/transform_spec.rb'
+
+RSpec/ContextMethod:
+  Exclude:
+    - 'spec/lutaml/jsonld/transform_spec.rb'

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-05-06 04:21:39 UTC using RuboCop version 1.86.0.
+# on 2026-05-13 07:30:26 UTC using RuboCop version 1.86.0.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -11,13 +11,67 @@ Gemspec/RequiredRubyVersion:
   Exclude:
     - 'lutaml-model.gemspec'
 
-# Offense count: 3232
+# Offense count: 4
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: with_first_argument, with_fixed_indentation
+Layout/ArgumentAlignment:
+  Exclude:
+    - 'lib/lutaml/xml/adapter/plan_based_builder.rb'
+    - 'lib/lutaml/xml/adapter/xml_parser.rb'
+    - 'lib/lutaml/xml/serialization/instance_methods.rb'
+    - 'spec/lutaml/xml/schema/compiler_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: IndentationWidth.
+Layout/AssignmentIndentation:
+  Exclude:
+    - 'lib/lutaml/xml/adapter/xml_serializer.rb'
+
+# Offense count: 3
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleAlignWith.
+# SupportedStylesAlignWith: either, start_of_block, start_of_line
+Layout/BlockAlignment:
+  Exclude:
+    - 'lib/lutaml/xml/serialization/format_conversion.rb'
+    - 'lib/lutaml/xml/xml_element.rb'
+
+# Offense count: 3
+# This cop supports safe autocorrection (--autocorrect).
+Layout/BlockEndNewline:
+  Exclude:
+    - 'lib/lutaml/xml/serialization/format_conversion.rb'
+    - 'lib/lutaml/xml/xml_element.rb'
+
+# Offense count: 6
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Width, EnforcedStyleAlignWith, AllowedPatterns.
+# SupportedStylesAlignWith: start_of_line, relative_to_receiver
+Layout/IndentationWidth:
+  Exclude:
+    - 'lib/lutaml/xml/serialization/format_conversion.rb'
+    - 'lib/lutaml/xml/xml_element.rb'
+
+# Offense count: 2981
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
   Enabled: false
 
+# Offense count: 5
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowInHeredoc.
+Layout/TrailingWhitespace:
+  Exclude:
+    - 'lib/lutaml/xml/adapter/plan_based_builder.rb'
+    - 'lib/lutaml/xml/adapter/xml_parser.rb'
+    - 'lib/lutaml/xml/adapter/xml_serializer.rb'
+    - 'lib/lutaml/xml/serialization/instance_methods.rb'
+    - 'spec/lutaml/xml/schema/compiler_spec.rb'
+
 # Offense count: 21
 # Configuration parameters: AllowedMethods.
 # AllowedMethods: enums
@@ -96,13 +150,12 @@ Lint/StructNewOverride:
   Exclude:
     - 'lib/lutaml/model/import_registry.rb'
 
-# Offense count: 15
+# Offense count: 14
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
 # NotImplementedExceptions: NotImplementedError
 Lint/UnusedMethodArgument:
   Exclude:
-    - 'lib/lutaml/xml/adapter/nokogiri_adapter.rb'
     - 'lib/lutaml/xml/declaration_planner.rb'
     - 'lib/lutaml/xml/mapping.rb'
     - 'lib/lutaml/xml/namespace_collector.rb'
@@ -110,45 +163,44 @@ Lint/UnusedMethodArgument:
     - 'lib/lutaml/xml/unqualified_inheritance_strategy.rb'
     - 'spec/support/xml/xsd/code_example_validator.rb'
 
-# Offense count: 3
+# Offense count: 1
 Lint/UselessConstantScoping:
   Exclude:
-    - 'lib/lutaml/xml/adapter/nokogiri_adapter.rb'
     - 'lib/lutaml/xml/mapping_rule.rb'
 
-# Offense count: 346
+# Offense count: 342
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
   Enabled: false
 
-# Offense count: 54
+# Offense count: 39
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
 # AllowedMethods: refine
 Metrics/BlockLength:
   Max: 127
 
-# Offense count: 20
+# Offense count: 16
 # Configuration parameters: CountBlocks, CountModifierForms.
 Metrics/BlockNesting:
   Max: 6
 
-# Offense count: 309
+# Offense count: 300
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Enabled: false
 
-# Offense count: 562
+# Offense count: 549
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
   Max: 514
 
-# Offense count: 86
+# Offense count: 81
 # Configuration parameters: CountKeywordArgs.
 Metrics/ParameterLists:
   Max: 24
   MaxOptionalParameters: 5
 
-# Offense count: 260
+# Offense count: 251
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/PerceivedComplexity:
   Enabled: false
@@ -240,7 +292,7 @@ RSpec/BeforeAfterAll:
 RSpec/ContextWording:
   Enabled: false
 
-# Offense count: 88
+# Offense count: 94
 # Configuration parameters: IgnoredMetadata.
 RSpec/DescribeClass:
   Enabled: false
@@ -251,7 +303,7 @@ RSpec/DescribeMethod:
     - 'spec/lutaml/xml/schema/xsd/schema_helper_methods_spec.rb'
     - 'spec/lutaml/xml/serializable_namespace_spec.rb'
 
-# Offense count: 1207
+# Offense count: 1238
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
   Max: 68
@@ -326,7 +378,7 @@ RSpec/MultipleDescribes:
     - 'spec/lutaml/xml/namespace_resolution_strategy_spec.rb'
     - 'spec/lutaml/xml/xml_space_type_spec.rb'
 
-# Offense count: 1383
+# Offense count: 1468
 RSpec/MultipleExpectations:
   Max: 21
 
@@ -350,7 +402,7 @@ RSpec/NoExpectationExample:
     - 'spec/lutaml/model/global_context_spec.rb'
     - 'spec/lutaml/model/type_context_spec.rb'
 
-# Offense count: 11
+# Offense count: 10
 RSpec/RemoveConst:
   Exclude:
     - 'spec/lutaml/xml/schema/compiler_spec.rb'
@@ -374,7 +426,7 @@ RSpec/RepeatedExampleGroupDescription:
   Exclude:
     - 'spec/lutaml/model/mixed_content_spec.rb'
 
-# Offense count: 35
+# Offense count: 40
 # Configuration parameters: CustomTransform, IgnoreMethods, IgnoreMetadata, InflectorPath, EnforcedInflector.
 # SupportedInflectors: default, active_support
 RSpec/SpecFilePathFormat:
@@ -399,6 +451,18 @@ Security/MarshalLoad:
   Exclude:
     - 'scripts-xmi-profile/profile_xmi.rb'
 
+# Offense count: 4
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, ProceduralMethods, FunctionalMethods, AllowedMethods, AllowedPatterns, AllowBracesOnProceduralOneLiners, BracesRequiredMethods.
+# SupportedStyles: line_count_based, semantic, braces_for_chaining, always_braces
+# ProceduralMethods: benchmark, bm, bmbm, create, each_with_object, measure, new, realtime, tap, with_object
+# FunctionalMethods: let, let!, subject, watch
+# AllowedMethods: lambda, proc, it
+Style/BlockDelimiters:
+  Exclude:
+    - 'lib/lutaml/xml/serialization/format_conversion.rb'
+    - 'lib/lutaml/xml/xml_element.rb'
+
 # Offense count: 2
 # This cop supports unsafe autocorrection (--autocorrect-all).
 # Configuration parameters: AllowedMethods, AllowedPatterns.
@@ -408,7 +472,7 @@ Style/ClassEqualityComparison:
     - 'lib/lutaml/model/attribute.rb'
     - 'lib/lutaml/model/validation/profile.rb'
 
-# Offense count: 13
+# Offense count: 7
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: EnforcedStyle, AllowComments.
 # SupportedStyles: empty, nil, both
@@ -417,9 +481,6 @@ Style/EmptyElse:
     - 'lib/lutaml/key_value/data_model/element.rb'
     - 'lib/lutaml/key_value/transformation.rb'
     - 'lib/lutaml/model/mapping/mapping_rule.rb'
-    - 'lib/lutaml/xml/adapter/nokogiri_adapter.rb'
-    - 'lib/lutaml/xml/adapter/oga_adapter.rb'
-    - 'lib/lutaml/xml/adapter/ox_adapter.rb'
     - 'lib/lutaml/xml/declaration_planner.rb'
     - 'lib/lutaml/xml/model_transform.rb'
 
@@ -447,6 +508,14 @@ Style/MixinUsage:
     - 'bench/bench_unitsml.rb'
     - 'bench/bench_xmi.rb'
 
+# Offense count: 3
+# This cop supports safe autocorrection (--autocorrect).
+Style/MultilineIfModifier:
+  Exclude:
+    - 'lib/lutaml/xml/adapter/xml_parser.rb'
+    - 'lib/lutaml/xml/adapter/xml_serializer.rb'
+    - 'spec/lutaml/xml/schema/compiler_spec.rb'
+
 # Offense count: 12
 # Configuration parameters: AllowedClasses.
 Style/OneClassPerFile:

data/Gemfile

@@ -12,6 +12,7 @@ gem "base64"
 gem "benchmark-ips"
 gem "bigdecimal"
 gem "canon" # , path: "../canon"
+gem "json-ld", "~> 3.3"
 gem "liquid", "~> 5"
 gem "multi_json"
 gem "nokogiri"
@@ -20,6 +21,7 @@ gem "oj"
 gem "openssl", "~> 3.0"
 gem "ox"
 gem "rake"
+gem "rdf-turtle", "~> 3.3"
 gem "rexml"
 gem "rspec"
 gem "rubocop"

data/README.adoc

@@ -27,7 +27,7 @@ for:
 
 It provides simple, flexible and comprehensive mechanisms for defining
 information models with attributes and types, and the serialization of them
-to/from serialization formats including JSON, XML, YAML, and TOML, as well as
+to/from serialization formats including JSON, XML, YAML, TOML, JSON-LD, and Turtle, as well as
 transformation to other formats like Hash.
 
 For serialization formats, it uses an adapter pattern to support multiple
@@ -48,7 +48,7 @@ link:docs/migration-guides/0-1-0-migrate-from-shale.adoc[Migrating from Shale to
 == Features
 
 * Define models with attributes and types
-* Serialize and deserialize models to/from JSON, XML, YAML, and TOML
+* Serialize and deserialize models to/from JSON, XML, YAML, TOML, JSON-LD, and Turtle
 * Transform models to other formats like Hash
 * Support for multiple serialization libraries (e.g., `toml-rb`, `tomlib`)
 * Configurable adapters for different serialization formats
@@ -65,6 +65,7 @@ link:docs/migration-guides/0-1-0-migrate-from-shale.adoc[Migrating from Shale to
 * Symmetric OOP architecture for all formats with KeyValueDataModel (see <<keyvaluedatamodel-architecture>>)
 * Parse XSD schemas into Ruby objects for inspection and manipulation (see <<xsd-schema-parsing>>)
 * Reusable XML mapping classes for sharing mappings across models
+* RDF namespace classes and JSON-LD/Turtle format adapters for Linked Data serialization
 * Consolidation mapping: group sibling XML elements into structured model instances (see <<consolidation-mapping>>)
 * Document-level validation framework with composable rules, profiles, and remediation (see <<document-validation-framework>>)
 
@@ -5391,6 +5392,11 @@ Collection serialization formats::
 `jsonl`::: JSONL (JSON Lines) (see <<mapping-collections>>)
 `yamls`::: YAML Stream (multi-document format) (see <<mapping-collections>>)
 
+RDF serialization formats::
+
+`rdf`::: Unified RDF mapping for both JSON-LD and Turtle (see <<mapping-rdf>>)
+`turtle`::: Turtle (see link:docs/_guides/turtle-serialization.adoc[Turtle Serialization])
+
 
 .Using the `xml`, `hsh`, `json`, `yaml`, `toml` and `key_value` blocks to define serialization mappings
 [example]
@@ -5439,6 +5445,73 @@ end
 ====
 
 
+[[mapping-rdf]]
+=== Unified RDF mapping (`rdf`)
+
+The `rdf` block defines predicate-based mappings once for both JSON-LD and
+Turtle serialization. It follows the same unified-mapping principle as
+`key_value` (which serves JSON, YAML, TOML).
+
+.Using the `rdf` block to define unified RDF mappings
+[example]
+====
+[source,ruby]
+----
+class Concept < Lutaml::Model::Serializable
+  attribute :code, :string
+  attribute :name, :string
+
+  rdf do
+    namespace SkosNamespace
+
+    subject { |m| "http://example.org/concept/#{m.code}" }
+    type "skos:Concept"
+
+    predicate :notation,  namespace: SkosNamespace, to: :code
+    predicate :prefLabel, namespace: SkosNamespace, to: :name
+  end
+end
+----
+
+Serializes to both formats:
+
+[source,ruby]
+----
+concept = Concept.new(code: "2119", name: "component")
+concept.to_turtle   # => Turtle with @prefix, a skos:Concept, predicates
+concept.to_jsonld   # => JSON-LD with @context, @type, @id, properties
+----
+====
+
+Graph-level serialization uses `members` to emit all contained resources as
+separate subjects in the same document:
+
+[source,ruby]
+----
+class Vocabulary < Lutaml::Model::Serializable
+  attribute :id, :string
+  attribute :concepts, Concept, collection: true
+
+  rdf do
+    namespace SkosNamespace
+    subject { |v| "http://example.org/vocab/#{v.id}" }
+    type "skos:ConceptScheme"
+    predicate :prefLabel, namespace: SkosNamespace, to: :id
+    members :concepts
+  end
+end
+
+# Turtle: single document with ConceptScheme + all Concept triples
+# JSON-LD: @graph array with ConceptScheme + all Concept objects
+vocab.to_turtle
+vocab.to_jsonld
+----
+
+See link:docs/_guides/rdf-serialization.adoc[Unified RDF Serialization] for the
+complete guide including language-tagged values, graph serialization, and
+architecture details.
+
+
 == Serialization: XML
 
 === General
@@ -10100,8 +10173,14 @@ Key-value data models supported are identified by their short name:
 `json`:: JSON
 `yaml`:: YAML
 `toml`:: TOML
+`jsonld`:: JSON-LD (extends key-value with `@context`, `@type`, `@id`)
 `key_value`:: A way to configure key-value mappings for all supported key-value data models.
 
+RDF serialization formats::
+
+`rdf`:: Unified RDF mapping for both JSON-LD and Turtle (see <<mapping-rdf>>)
+`turtle`:: Turtle (see link:docs/_guides/turtle-serialization.adoc[Turtle Serialization])
+
 
 === Mapping
 
@@ -15735,6 +15814,8 @@ LutaML, out of the box, supports the following serialization formats:
 * YAML (https://yaml.org/[YAML version 1.2])
 * JSON (https://www.ecma-international.org/publications-and-standards/standards/ecma-404/[ECMA-404 The JSON Data Interchange Standard], unofficial link: https://www.json.org[JSON])
 * TOML (https://toml.io/en[TOML version 1.0])
+* JSON-LD (https://www.w3.org/TR/json-ld11/[W3C JSON-LD 1.1])
+* Turtle (https://www.w3.org/TR/turtle/[W3C RDF 1.1 Turtle])
 
 The adapter interface is also used to support certain transformation of models
 into an "end format", which is not a serialization format. For example, the
@@ -15977,6 +16058,37 @@ end
 ----
 
 
+=== JSON-LD
+
+Lutaml::Model supports serialization to and from JSON-LD (W3C JSON-LD 1.1).
+JSON-LD is a key-value format that extends JSON with `@context`, `@type`, and
+`@id`. No additional gem is required beyond `lutaml-model`.
+
+For unified RDF mapping (both JSON-LD and Turtle from a single `rdf` block), see
+link:docs/_guides/rdf-serialization.adoc[Unified RDF Serialization].
+
+See link:docs/_guides/jsonld-serialization.adoc[JSON-LD Serialization] for the
+legacy `jsonld do` block DSL and usage examples.
+
+
+=== Turtle
+
+Lutaml::Model supports serialization to and from W3C RDF Turtle format.
+Turtle is a non-key-value format based on RDF triples. Requires the
+`rdf-turtle` gem:
+
+[source,ruby]
+----
+gem "rdf-turtle", "~> 3.3"
+----
+
+For unified RDF mapping (both JSON-LD and Turtle from a single `rdf` block), see
+link:docs/_guides/rdf-serialization.adoc[Unified RDF Serialization].
+
+See link:docs/_guides/turtle-serialization.adoc[Turtle Serialization] for the
+legacy `turtle do` block DSL and usage examples.
+
+
 === Per-operation adapter override
 
 Override the adapter for a single serialization/deserialization call using the `adapter:` option:

data/docs/_guides/index.adoc

@@ -22,6 +22,17 @@ Task-oriented guides for accomplishing specific goals with Lutaml::Model.
 * link:../keyvalue-serialization[Key-Value Serialization] - JSON/YAML/TOML/Hash
 * link:../collection-serialization[Collection Serialization] - JSONL and YAML Stream
 
+== Linked Data serialization
+
+* link:../rdf-serialization[Unified RDF Serialization] - One `rdf` block for both JSON-LD and Turtle
+* link:../jsonld-serialization[JSON-LD Serialization] - W3C JSON-LD 1.1 with `@context`
+* link:../turtle-serialization[Turtle Serialization] - W3C RDF Turtle format
+
+== RDF infrastructure
+
+See link:../references/rdf-namespaces[RDF Namespaces] for namespace classes,
+`NamespaceSet`, `Iri`, and `Literal` value objects.
+
 == Advanced features
 
 * link:../value-transformations[Value Transformations] - Transform values during serialization
@@ -49,6 +60,13 @@ Task-oriented guides for accomplishing specific goals with Lutaml::Model.
 . link:../value-transformations[Transform values if needed]
 . link:../missing-values-handling[Handle nil/empty values]
 
+=== I want to serialize to JSON-LD or Turtle (Linked Data)
+
+. link:../rdf-serialization[Unified RDF Serialization] (recommended — one block for both formats)
+. link:../jsonld-serialization[JSON-LD Serialization guide] (legacy `jsonld do` block)
+. link:../turtle-serialization[Turtle Serialization guide] (legacy `turtle do` block)
+. link:../references/rdf-namespaces[RDF Namespaces reference]
+
 === I want to work with collections
 
 . link:../collection-serialization[Collection Serialization]