lutaml-model 0.6.2 → 0.6.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 94d3957e15a5f50e2fc02c922f739acf71e99a592b97c4461c64b20cbc203bc5
-  data.tar.gz: 0daf15d9e99b94ecce154a95b86d8b24a11bc4ae89f7e21f44cd7d251ec11ab9
+  metadata.gz: 16b8569b5f2b450dfa8218c1c55a2175f154790220a54536bc9acbf6bc718312
+  data.tar.gz: d9d62e793690a72856e2663a67eb4eeb9cd8b909a861a91b093d8b849674a983
 SHA512:
-  metadata.gz: a05e07d0948529796da6833032c9edae933a022734f9018fc459a4caf7e8ee6d475e325b002a58c4b5de764fecde077380ab528bc0a60f87eecef8919dfa16f4
-  data.tar.gz: f6116e02319e52a64e6ed0817655b456ca0be1933f66fea70dab1999fbd4a1c2a70b52cfc60f153d1b18d6778b23882598c76ca7a4af0b7e7eb5eca0e563040c
+  metadata.gz: 5e491d76d913445b9929b4e1939becc31c4b1ccb656aeaaa3e83caa20bf3c5e53142c3cc45f1a82b0a85d4b7111ab6994d5a5c03588c4f42dd8f76d101c95db0
+  data.tar.gz: e18a44f0047929b93c2bc66c82f8942d3cf48818c6597722bba0b78107c2630aa59f84b3b4034a105155d889e64fa7e8f11881fbc9eca076b3103c21f8f189cf

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2025-02-13 10:44:38 UTC using RuboCop version 1.71.2.
+# on 2025-02-15 02:54:02 UTC using RuboCop version 1.71.2.
 # 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
@@ -138,7 +138,7 @@ RSpec/DescribedClass:
   Exclude:
     - 'spec/lutaml/model/xml_mapping_spec.rb'
 
-# Offense count: 152
+# Offense count: 157
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
   Max: 54
@@ -149,7 +149,7 @@ RSpec/LeakyConstantDeclaration:
     - 'spec/benchmarks/xml_parsing_benchmark_spec.rb'
     - 'spec/lutaml/model/xml_adapter/xml_namespace_spec.rb'
 
-# Offense count: 206
+# Offense count: 208
 RSpec/MultipleExpectations:
   Max: 14
 
@@ -163,13 +163,12 @@ RSpec/MultipleMemoizedHelpers:
 RSpec/NestedGroups:
   Max: 4
 
-# Offense count: 8
+# Offense count: 5
 RSpec/PendingWithoutReason:
   Exclude:
     - 'spec/lutaml/model/type/date_time_spec.rb'
     - 'spec/lutaml/model/type/time_spec.rb'
     - 'spec/lutaml/model/type/time_without_date_spec.rb'
-    - 'spec/lutaml/model/validation_spec.rb'
 
 # Offense count: 3
 # Configuration parameters: Include, CustomTransform, IgnoreMethods, IgnoreMetadata.

data/Gemfile

@@ -8,6 +8,7 @@ gemspec
 gem "benchmark-ips"
 gem "bigdecimal"
 gem "equivalent-xml"
+gem "liquid"
 gem "lutaml-xsd"
 gem "multi_json"
 gem "nokogiri"

data/README.adoc

@@ -413,9 +413,11 @@ end
 
 ==== Decimal type
 
-The Decimal type is an optional type that is disabled by default.
+WARNING: Decimal is an optional feature.
 
-NOTE: The reason why the Decimal type is disalbed by default is that the
+The Decimal type is a value type that is disabled by default.
+
+NOTE: The reason why the Decimal type is disabled by default is that the
 `BigDecimal` class became optional to the standard Ruby library from Ruby 3.4
 onwards. The `Decimal` type is only enabled when the `bigdecimal` library is
 loaded.
@@ -693,7 +695,7 @@ end
 Lutaml lets you create reusable element and attribute collections using `no_root`. These can be imported into other models using:
 
 - `import_model`: imports both attributes and mappings
-- `import_model_attributes`: imports only attributes  
+- `import_model_attributes`: imports only attributes
 - `import_model_mappings`: imports only mappings
 
 NOTE: This feature works with XML. Import order determines how elements and attributes are overwritten.
@@ -3898,7 +3900,7 @@ class Person < Lutaml::Model::Serializable
     }
   end
 
-  # Mapping-level transformation in XML format  
+  # Mapping-level transformation in XML format
   xml do
     map "full-name", to: :name, transform: {
       export: ->(value) { "Dr. #{value}" },
@@ -4098,39 +4100,39 @@ NOTE: For `NokogiriAdapter`, we can also call `to_xml` on `value.node.adapter_no
 
 # Nokogiri Adapter Node
 
-#<Lutaml::Model::XmlAdapter::NokogiriElement:0x0000000107656ed8                                                                 
-#   @attributes={},                                                                                                                
-#   @children=                                                                                                                     
+#<Lutaml::Model::XmlAdapter::NokogiriElement:0x0000000107656ed8
+#   @attributes={},
+#   @children=
 #   [#<Lutaml::Model::XmlAdapter::NokogiriElement:0x0000000107656cd0 @attributes={}, @children=[], @default_namespace=nil, @name="text", @namespace_prefix=nil, @text="\n    ">,
-#   #<Lutaml::Model::XmlAdapter::NokogiriElement:0x00000001076569b0                                                              
-#     @attributes={},                                                                                                             
-#     @children=                                                                                                                  
+#   #<Lutaml::Model::XmlAdapter::NokogiriElement:0x00000001076569b0
+#     @attributes={},
+#     @children=
 #     [#<Lutaml::Model::XmlAdapter::NokogiriElement:0x00000001076567f8 @attributes={}, @children=[], @default_namespace=nil, @name="text", @namespace_prefix=nil, @text="Metadata">],
-#     @default_namespace=nil,                                                                                                     
-#     @name="category",                                                                                                           
-#     @namespace_prefix=nil,                                                                                                      
-#     @text="Metadata">,                                                                                                          
+#     @default_namespace=nil,
+#     @name="category",
+#     @namespace_prefix=nil,
+#     @text="Metadata">,
 #   #<Lutaml::Model::XmlAdapter::NokogiriElement:0x0000000107656028 @attributes={}, @children=[], @default_namespace=nil, @name="text", @namespace_prefix=nil, @text="\n  ">],
-# @default_namespace=nil,                                                                                                        
+# @default_namespace=nil,
 # @name="metadata",
 # @namespace_prefix=nil,
 # @text="\n    Metadata\n  ">
 
 # Ox Adapter Node
 
-#<Lutaml::Model::XmlAdapter::OxElement:0x0000000107584f78                                                                                      
-# @attributes={},                                                                                                                               
-# @children=                                                                                                                                    
-#   [#<Lutaml::Model::XmlAdapter::OxElement:0x0000000107584e60                                                                                   
-#     @attributes={},                                                                                                                            
+#<Lutaml::Model::XmlAdapter::OxElement:0x0000000107584f78
+# @attributes={},
+# @children=
+#   [#<Lutaml::Model::XmlAdapter::OxElement:0x0000000107584e60
+#     @attributes={},
 #     @children=[#<Lutaml::Model::XmlAdapter::OxElement:0x0000000107584d48 @attributes={}, @children=[], @default_namespace=nil, @name="text", @namespace_prefix=nil, @text="Metadata">],
-#     @default_namespace=nil,                                                                                                                    
-#     @name="category",                                                                                                                          
-#     @namespace_prefix=nil,                                                                                                                     
-#     @text="Metadata">],                                                                                                                        
-# @default_namespace=nil,                                                                                                                       
-# @name="metadata",                                                                                                                             
-# @namespace_prefix=nil,                                                                                                                        
+#     @default_namespace=nil,
+#     @name="category",
+#     @namespace_prefix=nil,
+#     @text="Metadata">],
+# @default_namespace=nil,
+# @name="metadata",
+# @namespace_prefix=nil,
 # @text=nil>
 
 # Oga Adapter Node
@@ -4190,7 +4192,7 @@ class CustomModelParentMapper < Lutaml::Model::Serializable
     map_element :CustomModelChild,
                 with: { to: :child_to_xml, from: :child_from_xml }
   end
-  
+
   def child_to_xml(model, parent, doc)
     child_el = doc.create_element("CustomModelChild")
     street_el = doc.create_element("street")
@@ -4227,7 +4229,7 @@ end
 [source,ruby]
 ----
 > instance = CustomModelParentMapper.from_xml(xml)
-> #<CustomModelParent:0x0000000107c9ca68 @child_mapper=#<CustomModelChild:0x0000000107c95218 @city="London", @street="Oxford Street">, @first_name="John"> 
+> #<CustomModelParent:0x0000000107c9ca68 @child_mapper=#<CustomModelChild:0x0000000107c95218 @city="London", @street="Oxford Street">, @first_name="John">
 > CustomModelParentMapper.to_xml(instance)
 > #<CustomModelParent><first_name>John</first_name><CustomModelChild><street>Oxford Street</street><city>London</city></CustomModelChild></CustomModelParent>
 ----
@@ -4595,27 +4597,228 @@ klin.validate
 ====
 
 
-== Liquid Compatability
+== Liquid template access
+
+WARNING: The Liquid template feature is optional. To enable it, please
+explicitly require the `liquid` gem.
+
+The https://shopify.github.io/liquid/[Liquid template language] is an
+open-source template language developed by Shopify and written in Ruby.
+
+`Lutaml::Model::Serializable` objects can be safely accessed within Liquid
+templates through a `to_liquid` method that converts the objects into
+`Liquid::Drop` instances.
 
-`to_liquid` can be used to convert a class that inherit from *Lutaml::Model::Serializable* to `LiquidDrop` to be safely used in liquid templates. The returned drop provides all the attributes defined in the class as methods.
+* All attributes are accessible in the Liquid template by their names.
+* Nested attributes are also converted into `Liquid::Drop` objects so
+inner attributes can be accessed using the Liquid dot notation.
+
+NOTE: Every `Lutaml::Model::Serializable` class extends the `Liquefiable` module
+which generates a corresponding `Liquid::Drop` class.
+
+NOTE: Methods defined in the `Lutaml::Model::Serializable` class are not
+accessible in the Liquid template.
+
+.Using `to_liquid` to convert model instances into corresponding Liquid drop instances
 
 [example]
 ====
 [source,ruby]
 ----
-class Person < Lutaml::Model::Serializable
+class Ceramic < Lutaml::Model::Serializable
+  attribute :name, :string
+  attribute :temperature, :integer
+end
+
+ceramic = Ceramic.new({ name: "Porcelain Vase", temperature: 1200 })
+ceramic_drop = ceramic.to_liquid
+# Ceramic::CeramicDrop
+
+puts ceramic_drop.name
+# "Porcelain Vase"
+puts ceramic_drop.temperature
+# 1200
+----
+====
+
+.Accessing LutaML::Model objects within a Liquid template
+[example]
+====
+[source,ruby]
+----
+class Ceramic < Lutaml::Model::Serializable
+  attribute :name, :string
+  attribute :temperature, :integer
+end
+
+class CeramicCollection < Lutaml::Model::Serializable
+  attribute :ceramics, Ceramic, collection: true
+end
+----
+
+`sample.yml`:
+
+[source,yaml]
+----
+---
+ceramics:
+- name: Porcelain Vase
+  temperature: 1200
+- name: Earthenware Pot
+  temperature: 950
+- name: Stoneware Jug
+  temperature: 1200
+----
+
+`template.liquid`:
+
+[source,liquid]
+----
+{% for ceramic in ceramic_collection.ceramics %}
+* Name: "{{ ceramic.name }}"
+** Temperature: {{ ceramic.temperature }}
+{%- endfor %}
+----
+
+[source,ruby]
+----
+# Load the Lutaml::Model collection
+ceramic_collection = CeramicCollection.from_yaml(File.read("sample.yml"))
+
+# Load the Liquid template
+template = Liquid::Template.parse(File.read("template.liquid"))
+
+# Pass the Lutaml::Model collection to the Liquid template and render
+output = template.render("ceramic_collection" => ceramic_collection)
+puts output
+# >
+# * Name: "Porcelain Vase"
+# ** Temperature: 1200
+# * Name: "Earthenware Pot"
+# ** Temperature: 950
+# * Name: "Stoneware Jug"
+# ** Temperature: 1200
+----
+====
+
+.Accessing nested LutaML::Model objects within nested Liquid templates
+[example]
+====
+[source,ruby]
+----
+class Glaze < Lutaml::Model::Serializable
+  attribute :color, :string
+  attribute :opacity, :string
+end
+
+class CeramicWork < Lutaml::Model::Serializable
   attribute :name, :string
-  attribute :age, integer
+  attribute :glaze, Glaze
+end
+
+class CeramicCollection < Lutaml::Model::Serializable
+  attribute :ceramics, Ceramic, collection: true
 end
 
-person = Person.new({ name: "John", age: 22 })
-person_drop = person.to_liquid
-# Person::PersonDrop
+ceramic_work = CeramicWork.new({
+  name: "Celadon Bowl",
+  glaze: Glaze.new({
+    color: "Jade Green",
+    opacity: "Translucent"
+  })
+})
+ceramic_work_drop = ceramic_work.to_liquid
+# CeramicWork::CeramicWorkDrop
+
+puts ceramic_work_drop.name
+# "Celadon Bowl"
+puts ceramic_work_drop.glaze.color
+# "Jade Green"
+puts ceramic_work_drop.glaze.opacity
+# "Translucent"
+----
+
+`ceramics.yml`:
+
+[source,yaml]
+----
+---
+ceramics:
+- name: Celadon Bowl
+  glaze:
+    color: Jade Green
+    opacity: Translucent
+- name: Earthenware Pot
+  glaze:
+    color: Rust Red
+    opacity: Opaque
+- name: Stoneware Jug
+  glaze:
+    color: Cobalt Blue
+    opacity: Transparent
+----
+
+
+`templates/_ceramics.liquid`:
+
+[source,liquid]
+----
+{% for ceramic in ceramic_collection.ceramics %}
+{% render 'ceramic' ceramic: ceramic %}
+{%- endfor %}
+----
+
+NOTE: `render` is a Liquid tag that renders a partial template, by default
+Liquid uses the pattern `_%s.liquid` to find the partial template. Here
+`ceramic` refers to the file at `templates/_ceramic.liquid`.
+
+`templates/_ceramic.liquid`:
+
+[source,liquid]
+----
+* Name: "{{ ceramic.name }}"
+** Temperature: {{ ceramic.temperature }}
+{%- if ceramic.glaze %}
+** Glaze (color): {{ ceramic.glaze.color }}
+** Glaze (opacity): {{ ceramic.glaze.opacity }}
+{%- endif %}
+----
+
+[source,ruby]
+----
+require 'liquid'
+
+# Create a Liquid template object that supports dynamic loading
+template = Liquid::Template.new
+
+# Link the Liquid template object to a "local file system" (directory)
+file_system = Liquid::LocalFileSystem.new('templates/')
+template.registers[:file_system] = file_system
+
+# Load the partial template, this is necessary.
+# This will also allow Liquid to load any inner partials from the file system
+# dynamically (see `file_system.pattern` to see what it loads)
+template.parse(file_system.read_template_file('ceramics'))
+
+# Read the lutaml-model collection
+ceramic_collection = CeramicCollection.from_yaml(File.read("ceramics.yml"))
 
-puts person_drop.name
-# "John"
-puts person_drop.age
-# 22
+# Render the template with the collection
+output = template.render("ceramic_collection" => ceramic_collection)
+puts output
+# >
+# * Name: "Celadon Bowl"
+# ** Temperature: 1200
+# ** Glaze (color): Jade Green
+# ** Glaze (finish): Translucent
+# * Name: "Earthenware Pot"
+# ** Temperature: 950
+# ** Glaze (color): Rust Red
+# ** Glaze (finish): Opaque
+# * Name: "Stoneware Jug"
+# ** Temperature: 1200
+# ** Glaze (color): Cobalt Blue
+# ** Glaze (finish): Transparent
 ----
 ====
 

data/lib/lutaml/model/error/liquid_not_enabled_error.rb

@@ -0,0 +1,9 @@
+module Lutaml
+  module Model
+    class LiquidNotEnabledError < Error
+      def to_s
+        "Liquid functionality is not available by default; please install and require `liquid` gem to use this functionality"
+      end
+    end
+  end
+end

data/lib/lutaml/model/error.rb

@@ -6,6 +6,7 @@ module Lutaml
 end
 
 require_relative "error/invalid_value_error"
+require_relative "error/liquid_not_enabled_error"
 require_relative "error/incorrect_mapping_argument_error"
 require_relative "error/pattern_not_matched_error"
 require_relative "error/unknown_adapter_type_error"

data/lib/lutaml/model/liquefiable.rb

@@ -1,5 +1,3 @@
-require "liquid"
-
 module Lutaml
   module Model
     module Liquefiable
@@ -9,6 +7,7 @@ module Lutaml
 
       module ClassMethods
         def register_liquid_drop_class
+          validate_liquid!
           if drop_class
             raise "#{drop_class_name} Already exists!"
           end
@@ -38,6 +37,7 @@ module Lutaml
 
         def register_drop_method(method_name)
           register_liquid_drop_class unless drop_class
+          return if drop_class.method_defined?(method_name)
 
           drop_class.define_method(method_name) do
             value = @object.public_send(method_name)
@@ -49,9 +49,22 @@ module Lutaml
             end
           end
         end
+
+        def validate_liquid!
+          return if Object.const_defined?(:Liquid)
+
+          raise Lutaml::Model::LiquidNotEnabledError
+        end
       end
 
       def to_liquid
+        self.class.validate_liquid!
+
+        if is_a?(Lutaml::Model::Serializable)
+          self.class.attributes.each_key do |attr_name|
+            self.class.register_drop_method(attr_name)
+          end
+        end
         self.class.drop_class.new(self)
       end
     end

data/lib/lutaml/model/serialize.rb

@@ -117,8 +117,6 @@ module Lutaml
             end
           end
 
-          register_drop_method(name)
-
           attr
         end
 

data/lib/lutaml/model/validation.rb

@@ -6,13 +6,14 @@ module Lutaml
         self.class.attributes.each do |name, attr|
           value = public_send(:"#{name}")
           begin
-            if value.respond_to?(:validate!)
-              value.validate!
+            if value.respond_to?(:validate)
+              errors.concat(value.validate)
             else
               attr.validate_value!(value)
             end
           rescue Lutaml::Model::InvalidValueError,
                  Lutaml::Model::CollectionCountOutOfRangeError,
+                 Lutaml::Model::CollectionTrueMissingError,
                  PatternNotMatchedError => e
             errors << e
           end

data/lib/lutaml/model/version.rb

@@ -2,6 +2,6 @@
 
 module Lutaml
   module Model
-    VERSION = "0.6.2"
+    VERSION = "0.6.4"
   end
 end

data/spec/fixtures/liquid_templates/_ceramic.liquid

@@ -0,0 +1,6 @@
+* Name: "{{ ceramic.name }}"
+** Temperature: {{ ceramic.temperature }}
+{%- if ceramic.glaze %}
+** Glaze (color): {{ ceramic.glaze.color }}
+** Glaze (opacity): {{ ceramic.glaze.opacity }}
+{%- endif %}

data/spec/fixtures/liquid_templates/_ceramics.liquid

@@ -0,0 +1,3 @@
+{% for ceramic in ceramic_collection.ceramics %}
+{% render 'ceramic' ceramic: ceramic %}
+{%- endfor %}

data/spec/fixtures/liquid_templates/_ceramics_in_one.liquid

@@ -0,0 +1,4 @@
+{% for ceramic in ceramic_collection.ceramics %}
+* Name: "{{ ceramic.name }}"
+** Temperature: {{ ceramic.temperature }}
+{%- endfor %}

data/spec/lutaml/model/liquefiable_spec.rb

@@ -1,4 +1,5 @@
 require "spec_helper"
+require "liquid"
 require_relative "../../fixtures/address"
 
 class LiquefiableClass
@@ -16,6 +17,23 @@ class LiquefiableClass
   end
 end
 
+module LiquefiableSpec
+  class Glaze < Lutaml::Model::Serializable
+    attribute :color, :string
+    attribute :opacity, :string
+  end
+
+  class Ceramic < Lutaml::Model::Serializable
+    attribute :name, :string
+    attribute :temperature, :integer
+    attribute :glaze, Glaze
+  end
+
+  class CeramicCollection < Lutaml::Model::Serializable
+    attribute :ceramics, Ceramic, collection: true
+  end
+end
+
 RSpec.describe Lutaml::Model::Liquefiable do
   before do
     stub_const("DummyModel", Class.new(LiquefiableClass))
@@ -26,14 +44,27 @@ RSpec.describe Lutaml::Model::Liquefiable do
   describe ".register_liquid_drop_class" do
     context "when drop class does not exist" do
       it "creates a new drop class" do
-        expect { dummy.class.register_liquid_drop_class }.to change {
-          dummy.class.const_defined?(:DummyModelDrop)
-        }
+        expect do
+          dummy.class.register_liquid_drop_class
+        end.to change {
+                 dummy.class.const_defined?(:DummyModelDrop)
+               }
           .from(false)
           .to(true)
       end
     end
 
+    context "when 'liquid' is not available" do
+      before { allow(Object).to receive(:const_defined?).with(:Liquid).and_return(false) }
+
+      it "raises an error" do
+        expect { dummy.class.register_liquid_drop_class }.to raise_error(
+          Lutaml::Model::LiquidNotEnabledError,
+          "Liquid functionality is not available by default; please install and require `liquid` gem to use this functionality",
+        )
+      end
+    end
+
     context "when drop class already exists" do
       it "raises an error" do
         dummy.class.register_liquid_drop_class
@@ -69,26 +100,41 @@ RSpec.describe Lutaml::Model::Liquefiable do
     end
 
     it "defines a method on the drop class" do
-      expect { dummy.class.register_drop_method(:display_name) }.to change {
-        dummy.to_liquid.respond_to?(:display_name)
-      }
+      expect do
+        dummy.class.register_drop_method(:display_name)
+      end.to change {
+               dummy.to_liquid.respond_to?(:display_name)
+             }
         .from(false)
         .to(true)
     end
   end
 
   describe ".to_liquid" do
-    before do
-      dummy.class.register_liquid_drop_class
-      dummy.class.register_drop_method(:display_name)
-    end
+    context "when liquid is not enabled" do
+      before { allow(Object).to receive(:const_defined?).with(:Liquid).and_return(false) }
 
-    it "returns an instance of the drop class" do
-      expect(dummy.to_liquid).to be_a(dummy.class.drop_class)
+      it "raises an error" do
+        expect { dummy.to_liquid }.to raise_error(
+          Lutaml::Model::LiquidNotEnabledError,
+          "Liquid functionality is not available by default; please install and require `liquid` gem to use this functionality",
+        )
+      end
     end
 
-    it "allows access to registered methods via the drop class" do
-      expect(dummy.to_liquid.display_name).to eq("TestName (42)")
+    context "when liquid is enabled" do
+      before do
+        dummy.class.register_liquid_drop_class
+        dummy.class.register_drop_method(:display_name)
+      end
+
+      it "returns an instance of the drop class" do
+        expect(dummy.to_liquid).to be_a(dummy.class.drop_class)
+      end
+
+      it "allows access to registered methods via the drop class" do
+        expect(dummy.to_liquid.display_name).to eq("TestName (42)")
+      end
     end
   end
 
@@ -118,4 +164,96 @@ RSpec.describe Lutaml::Model::Liquefiable do
       end
     end
   end
+
+  describe "working with liquid templates" do
+    let(:liquid_template_dir) do
+      File.join(File.dirname(__FILE__), "../../fixtures/liquid_templates")
+    end
+
+    describe "rendering simple models with liquid templates" do
+      let :yaml do
+        <<~YAML
+          ---
+          ceramics:
+          - name: Porcelain Vase
+            temperature: 1200
+          - name: Earthenware Pot
+            temperature: 950
+          - name: Stoneware Jug
+            temperature: 1200
+        YAML
+      end
+      let :template_path do
+        File.join(liquid_template_dir, "_ceramics_in_one.liquid")
+      end
+
+      it "renders" do
+        template = Liquid::Template.parse(File.read(template_path))
+        ceramic_collection = LiquefiableSpec::CeramicCollection.from_yaml(yaml)
+        output = template.render("ceramic_collection" => ceramic_collection)
+
+        expected_output = <<~OUTPUT
+          * Name: "Porcelain Vase"
+          ** Temperature: 1200
+          * Name: "Earthenware Pot"
+          ** Temperature: 950
+          * Name: "Stoneware Jug"
+          ** Temperature: 1200
+        OUTPUT
+
+        expect(output.strip).to eq(expected_output.strip)
+      end
+    end
+
+    describe "rendering nested models with liquid templates from file system" do
+      let :yaml do
+        <<~YAML
+          ---
+          ceramics:
+          - name: Celadon Bowl
+            temperature: 1200
+            glaze:
+              color: Jade Green
+              opacity: Translucent
+          - name: Earthenware Pot
+            temperature: 950
+            glaze:
+              color: Rust Red
+              opacity: Opaque
+          - name: Stoneware Jug
+            temperature: 1200
+            glaze:
+              color: Cobalt Blue
+              opacity: Transparent
+        YAML
+      end
+
+      it "renders" do
+        template = Liquid::Template.new
+        file_system = Liquid::LocalFileSystem.new(liquid_template_dir)
+        template.registers[:file_system] = file_system
+        template.parse(file_system.read_template_file("ceramics"))
+
+        ceramic_collection = LiquefiableSpec::CeramicCollection.from_yaml(yaml)
+        output = template.render("ceramic_collection" => ceramic_collection)
+        # puts output
+
+        expected_output = <<~OUTPUT
+          * Name: "Celadon Bowl"
+          ** Temperature: 1200
+          ** Glaze (color): Jade Green
+          ** Glaze (opacity): Translucent
+          * Name: "Earthenware Pot"
+          ** Temperature: 950
+          ** Glaze (color): Rust Red
+          ** Glaze (opacity): Opaque
+          * Name: "Stoneware Jug"
+          ** Temperature: 1200
+          ** Glaze (color): Cobalt Blue
+          ** Glaze (opacity): Transparent
+        OUTPUT
+        expect(output.strip).to eq(expected_output.strip)
+      end
+    end
+  end
 end

data/spec/lutaml/model/validation_spec.rb

@@ -12,6 +12,18 @@ RSpec.describe Lutaml::Model::Validation do
       attribute :tags, :string, collection: true
       attribute :role, :string, collection: 1..3
     end)
+
+    stub_const("ValidationTestMainClass", Class.new(Lutaml::Model::Serializable) do
+      attribute :test_class, ValidationTestClass
+
+      xml do
+        map_element "test_class", to: :test_class
+      end
+
+      key_value do
+        map "test_class", to: :test_class
+      end
+    end)
   end
 
   let(:valid_instance) do
@@ -24,15 +36,29 @@ RSpec.describe Lutaml::Model::Validation do
     )
   end
 
+  let(:valid_nested_instance) do
+    ValidationTestMainClass.new(
+      test_class: valid_instance,
+    )
+  end
+
   describe "#validate" do
     it "returns an empty array for a valid instance" do
       expect(valid_instance.validate).to be_empty
     end
 
-    xit "returns errors for invalid integer value" do
+    it "returns errors for invalid integer value" do
       instance = ValidationTestClass.new(age: "thirty", role: ["admin"])
       errors = instance.validate
-      expect(errors).to include("Invalid value for attribute age: thirty")
+      expect(errors).to eq([])
+      expect(instance.age).to be_nil
+    end
+
+    it "raises error if Array is set but collection is not set" do
+      instance = ValidationTestClass.new(name: ["admin"])
+      expect do
+        instance.validate
+      end.not_to raise_error(Lutaml::Model::CollectionTrueMissingError)
     end
 
     it "returns errors for value not in allowed set" do
@@ -55,17 +81,20 @@ RSpec.describe Lutaml::Model::Validation do
       end
     end
 
-    xit "returns multiple errors for multiple invalid attributes" do
+    it "returns multiple errors for multiple invalid attributes" do
       instance = ValidationTestClass.new(name: "123", age: "thirty",
                                          email: "invalid@example.com", role: [])
       expect do
         instance.validate!
       end.to raise_error(Lutaml::Model::ValidationError) do |error|
-        expect(error.error_messages.join("\n")).to include("Invalid value for attribute age: thirty")
         expect(error.error_messages.join("\n")).to include("email is `invalid@example.com`, must be one of the following [test@example.com, user@example.com]")
         expect(error.error_messages.join("\n")).to include("role count is 0, must be between 1 and 3")
       end
     end
+
+    it "returns an empty array for a valid nested instance" do
+      expect(valid_nested_instance.validate).to be_empty
+    end
   end
 
   describe "#validate!" do
@@ -73,13 +102,31 @@ RSpec.describe Lutaml::Model::Validation do
       expect { valid_instance.validate! }.not_to raise_error
     end
 
-    xit "raises a ValidationError with all error messages for an invalid instance" do
+    it "raises a ValidationError with all error messages for an invalid instance" do
       instance = ValidationTestClass.new(name: "test", age: "thirty")
       expect do
         instance.validate!
       end.to raise_error(Lutaml::Model::ValidationError) do |error|
         expect(error.error_messages.join("\n")).to include("role count is 0, must be between 1 and 3")
-        expect(error.error_messages.join("\n")).to include("Invalid value for attribute age: thirty")
+      end
+    end
+
+    it "validates nested ValidationTestClass instance" do
+      invalid_nested = ValidationTestMainClass.new(
+        test_class: ValidationTestClass.new(
+          name: "John Doe",
+          age: 30,
+          email: "invalid@example.com",
+          role: ["admin"],
+        ),
+      )
+
+      expect do
+        invalid_nested.validate!
+      end.to raise_error(Lutaml::Model::ValidationError) do |error|
+        expect(error.error_messages.join("\n")).to include(
+          "email is `invalid@example.com`, must be one of the following [test@example.com, user@example.com]",
+        )
       end
     end
   end

data/spec/spec_helper.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "liquid"
 require "rspec/matchers"
 require "equivalent-xml"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lutaml-model
 version: !ruby/object:Gem::Version
-  version: 0.6.2
+  version: 0.6.4
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-02-13 00:00:00.000000000 Z
+date: 2025-02-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -111,6 +111,7 @@ files:
 - lib/lutaml/model/error/incorrect_sequence_error.rb
 - lib/lutaml/model/error/invalid_choice_range_error.rb
 - lib/lutaml/model/error/invalid_value_error.rb
+- lib/lutaml/model/error/liquid_not_enabled_error.rb
 - lib/lutaml/model/error/multiple_mappings_error.rb
 - lib/lutaml/model/error/no_root_mapping_error.rb
 - lib/lutaml/model/error/no_root_namespace_error.rb
@@ -192,6 +193,9 @@ files:
 - spec/ceramic_spec.rb
 - spec/fixtures/address.rb
 - spec/fixtures/ceramic.rb
+- spec/fixtures/liquid_templates/_ceramic.liquid
+- spec/fixtures/liquid_templates/_ceramics.liquid
+- spec/fixtures/liquid_templates/_ceramics_in_one.liquid
 - spec/fixtures/person.rb
 - spec/fixtures/sample_model.rb
 - spec/fixtures/vase.rb