lutaml-model 0.3.4 → 0.3.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d80c5eb43638cf5d690c6c59db2fba76ddb8e2fc7252117a3c7933bc566b2607
-  data.tar.gz: d75c694c330c017500dcceb604aaa889633dadb53c7766a4b6310ee3aef1725e
+  metadata.gz: 45fc67305626a2fe4d38db31804a618fd887a9855ff8ddb7ef2d0d0e8cc8b9b8
+  data.tar.gz: 7ffbc1f1b1958d05ebbf82889b1b54f032df48a4ed9052f3a963b896bfb43238
 SHA512:
-  metadata.gz: fc9ed09d01c0c19b4038af7de38c3c458f7c200f7b5ae509f4e4cfc2d3abe116ad862168b7d2ffef16e0d5205c67b3a54226b8b826f9859a72ec5d32da00545e
-  data.tar.gz: b4b8348522112cce9236dc7989f30b42df22ac04d6a7459b2fff6ad6c6dc7018d4bd88e97ec9f83ab8b2dcf6d92938d18fcdc882914240d3d53fb16e0ba116d3
+  metadata.gz: 37a4e64c1b61b6a1112329b18ea4bd9b544fe125859cd81a1054b162817e1ffb22e03f4168836ce8890e6f6cba6f137c78110522322c0a0fe6fde3e121c533d4
+  data.tar.gz: bd3bfb6600103c25034c3604fcdc83947d8eb3a14b23ec54e93186f66d273a5270a923394bd5f00e5caf3d58c9ff7c65efce9cd5f7a874ac22f4582711622d27

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2024-08-16 11:07:41 UTC using RuboCop version 1.65.1.
+# on 2024-08-19 03:44:26 UTC using RuboCop version 1.65.1.
 # 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
@@ -14,7 +14,7 @@ Gemspec/RequireMFA:
   Exclude:
     - 'lutaml-model.gemspec'
 
-# Offense count: 76
+# Offense count: 78
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: Max, AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, AllowedPatterns.
 # URISchemes: http, https
@@ -28,6 +28,7 @@ Layout/LineLength:
     - 'lib/lutaml/model/xml_adapter/ox_adapter.rb'
     - 'lib/lutaml/model/xml_adapter/xml_document.rb'
     - 'spec/lutaml/model/comparable_model_spec.rb'
+    - 'spec/lutaml/model/custom_serialization_spec.rb'
     - 'spec/lutaml/model/delegation_spec.rb'
     - 'spec/lutaml/model/schema/json_schema_spec.rb'
     - 'spec/lutaml/model/serializable_spec.rb'
@@ -55,11 +56,11 @@ Metrics/AbcSize:
     - 'lib/lutaml/model/xml_adapter/ox_adapter.rb'
     - 'lib/lutaml/model/xml_adapter/xml_document.rb'
 
-# Offense count: 3
+# Offense count: 4
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
 # AllowedMethods: refine
 Metrics/BlockLength:
-  Max: 30
+  Max: 31
 
 # Offense count: 23
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
@@ -75,7 +76,7 @@ Metrics/CyclomaticComplexity:
 # Offense count: 38
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
-  Max: 41
+  Max: 52
 
 # Offense count: 4
 # Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
@@ -102,7 +103,7 @@ RSpec/ContextWording:
     - 'spec/lutaml/model/xml_adapter/oga_adapter_spec.rb'
     - 'spec/lutaml/model/xml_adapter/ox_adapter_spec.rb'
 
-# Offense count: 70
+# Offense count: 73
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
   Max: 57
@@ -129,7 +130,7 @@ RSpec/MultipleDescribes:
     - 'spec/lutaml/model/xml_adapter/xml_namespace_spec.rb'
     - 'spec/lutaml/model/xml_adapter_spec.rb'
 
-# Offense count: 69
+# Offense count: 70
 RSpec/MultipleExpectations:
   Max: 15
 

data/README.adoc

@@ -13,16 +13,13 @@ objects to and from various formats such as JSON, XML, YAML, and TOML. It uses
 an adapter pattern to support multiple libraries for each format, providing
 flexibility and extensibility for your data modeling needs.
 
-The name "LutaML" comes from the Latin word for clay, "Lutum", and "ML"
-for Markup Language. Just as clay can be molded and modeled into beautiful and
-practical end products, the Lutaml::Model gem is used for data modeling,
-allowing you to shape and structure your data into useful forms.
-
+NOTE: Lutaml::Model is designed to be mostly compatible with the data modeling
+API of https://www.shalerb.org[Shale], an impressive Ruby data modeller.
+Lutaml::Model is meant to address advanced needs not currently addressed by
+Shale.
 
-NOTE: Lutaml::Model is designed to be compatible with the
-https://www.shalerb.org[Shale] data modeling API. Shale is an amazing Ruby data
-modeller. Lutaml::Model is meant to address needs that are not currently
-addressed by Shale.
+NOTE: Instructions on how to migrate from Shale to Lutaml::Model are provided in
+<<migrate-from-shale>>.
 
 
 == Data modeling in a nutshell
@@ -80,6 +77,7 @@ There are two ways to define a data model in Lutaml::Model:
 * Inheriting from the `Lutaml::Model::Serializable` class
 * Including the `Lutaml::Model::Serialize` module
 
+[[define-through-inheritance]]
 ==== Definition through inheritance
 
 The simplest way to define a model is to create a class that inherits from
@@ -98,6 +96,7 @@ class Kiln < Lutaml::Model::Serializable
 end
 ----
 
+[[define-through-inclusion]]
 ==== Definition through inclusion
 
 If the model class already has a super class that it inherits from, the model
@@ -169,12 +168,6 @@ attribute :name_of_attribute, {symbol | string | class}
 | `Boolean` | `:boolean` | `Lutaml::Model::Type::Boolean` | `Boolean`
 | `Decimal` | `:decimal` | `Lutaml::Model::Type::Decimal` | `::BigDecimal`
 | `Hash` | `:hash` | `Lutaml::Model::Type::Hash` | `::Hash`
-| `Uuid` | `:uuid` | `Lutaml::Model::Type::Uuid` | `::String`
-| `Symbol` | `:symbol` | `Lutaml::Model::Type::Symbol` | `Symbol`
-| `Binary` | `:binary` | `Lutaml::Model::Type::Binary` | `Binary`
-| `Url` | `:url` | `Lutaml::Model::Type::Url` | `::URI`
-| `IpAddress` | `:ip_address` | `Lutaml::Model::Type::IpAddress` | `::IPAddr`
-| `Json` | `:json` | `Lutaml::Model::Type::Json` | `::JSON`
 
 |===
 
@@ -238,6 +231,7 @@ end
 ----
 ====
 
+[[attribute-enumeration]]
 === Attribute as an enumeration
 
 An attribute can be defined as an enumeration by using the `values` directive.
@@ -777,6 +771,7 @@ end
 ----
 ====
 
+[[namespace-inherit]]
 ===== Namespace with `inherit` option
 
 The `inherit` option is used at the element level to inherit the namespace from
@@ -838,7 +833,7 @@ end
 ----
 ====
 
-
+[[mixed-content]]
 ==== Mixed content
 
 ===== General
@@ -859,6 +854,8 @@ To map this to Lutaml::Model we can use the `mixed` option in either way:
 * when defining the model;
 * when referencing the model.
 
+NOTE: This feature is not supported by Shale.
+
 
 ===== Specifying the `mixed` option at `root`
 
@@ -1071,7 +1068,7 @@ end
 ----
 ====
 
-
+[[separate-serialization-model]]
 === Separate serialization model
 
 The `Serialize` module can be used to define only serialization mappings for a
@@ -1283,6 +1280,9 @@ end
 ----
 ====
 
+NOTE: The corresponding keyword used by Shale is `receiver:` instead of
+`delegate:`.
+
 
 ==== Attribute serialization with custom methods
 
@@ -1291,10 +1291,30 @@ each serialization mapping block for `from` and `to`.
 
 Syntax:
 
+.XML serialization with custom methods
 [source,ruby]
 ----
-xml | json | yaml | toml do
-  map 'key_value_model_attribute_name', to: :name_of_attribute, with: {
+xml do
+  map_element 'element_name', to: :name_of_element, with: {
+    to: :method_name_to_serialize,
+    from: :method_name_to_deserialize
+  }
+  map_attribute 'attribute_name', to: :name_of_attribute, with: {
+    to: :method_name_to_serialize,
+    from: :method_name_to_deserialize
+  }
+  map_content, to: :name_of_content, with: {
+    to: :method_name_to_serialize,
+    from: :method_name_to_deserialize
+  }
+end
+----
+
+.Key-value data model serialization with custom methods
+[source,ruby]
+----
+json | yaml | toml do
+  map 'attribute_name', to: :name_of_attribute, with: {
     to: :method_name_to_serialize,
     from: :method_name_to_deserialize
   }
@@ -1345,7 +1365,7 @@ end
 ====
 
 
-
+[[attribute-extraction]]
 ==== Attribute extraction
 
 NOTE: This feature is for key-value data model serialization only.
@@ -1541,7 +1561,7 @@ serialization format.
 You will need to specify the configuration for the adapter you want to use. The
 easiest way is to copy and paste the following configuration into your code.
 
-The default configuration is as follows:
+The configuration is as follows:
 
 [source,ruby]
 ----
@@ -1559,6 +1579,21 @@ Lutaml::Model::Config.configure do |config|
 end
 ----
 
+You can also provide the adapter type by using symbols like 
+
+[source,ruby]
+----
+require 'lutaml/model'
+
+Lutaml::Model::Config.configure do |config|
+  config.xml_adapter_type = :nokogiri # can be one of [:nokogiri, :ox, :oga]
+  config.yaml_adapter_type = :standard_yaml
+  config.json_adapter_type = :standard_json # can be one of [:standard_json, :multi_json]
+  config.toml_adapter_type = :toml_rb # can be one of [:toml_rb, :tomlib]
+end
+----
+
+NOTE: By default `yaml_adapter_type` and `json_adapter_type` are set to `:standard_yaml` and `:standard_json` respectively.
 
 === XML
 
@@ -1679,6 +1714,396 @@ Lutaml::Model::Config.configure do |config|
 end
 ----
 
+
+== Comparison with Shale
+
+Lutaml::Model is a serialization library that is similar to Shale, but with some
+differences in implementation.
+
+[cols="a,a,a,a",options="header"]
+|===
+| Feature | Lutaml::Model | Shale | Notes
+
+| Data model definition
+|
+3 types:
+
+* <<define-through-inheritance,Inherit from `Lutaml::Model::Serializable`>>
+* <<define-through-inclusion,Include `Lutaml::Model::Serialize`>>
+* <<separate-serialization-model,Separate serialization model class>>
+|
+2 types:
+
+* Inherit from `Shale::Mapper`
+* Custom model class
+|
+
+| Value types
+| `Lutaml::Model::Type` includes: `Integer`, `String`, `Float`, `Boolean`, `Date`, `DateTime`, `Time`, `Hash`.
+| `Shale::Type` includes: `Integer`, `String`, `Float`, `Boolean`, `Date`, `Time`.
+| Lutaml::Model supports the additional value types `DateTime` and `Hash`.
+
+| Configuration
+| `Lutaml::Model::Config`
+| `Shale.{type}_adapter`
+| Lutaml::Model uses a configuration block to set the serialization adapters.
+
+| Custom serialization methods
+| `:with`, on individual attributes
+| `:using`, on entire object/document
+| Lutaml::Model uses the `:with` keyword for custom serialization methods.
+
+| Serialization formats
+| XML, YAML, JSON, TOML
+| XML, YAML, JSON, TOML, CSV
+| Lutaml::Model does not support CSV.
+
+| Adapter support
+| XML (Nokogiri, Ox, Oga), YAML, JSON (JSON, MultiJson), TOML (Toml-rb, Tomlib)
+| XML (Nokogiri, Ox), YAML, JSON (JSON, MultiJson), TOML (Toml-rb, Tomlib), CSV
+| Lutaml::Model does not support CSV.
+
+4+h| XML features
+
+| XML mixed content support
+| Yes. Supports the following kind of XML through <<mixed-content,mixed content>> support.
+
+[source,xml]
+----
+<description>My name is
+<bold>John Doe</bold>,
+and I'm <i>28</i>
+years old</description>
+----
+| No. Shale's `map_content` only supports the first text node.
+|
+
+| XML namespace inheritance
+| Yes. Supports the <<namespace-inherit,`inherit`>> option to inherit the
+namespace from the root element.
+| No.
+|
+
+4+h| Attribute features
+
+| Attribute delegation
+| `:delegate` option to delegate attribute mappings to a model.
+| `:receiver` option to delegate attribute mappings to a model.
+|
+
+| Enumerations
+| Yes. Supports enumerations as value types through the
+<<attribute-enumeration,`values:` option>>.
+| No.
+| Lutaml::Model supports enumerations as value types.
+
+| Attribute extraction
+| Yes. Supports <<attribute-extraction,attribute extraction>> from key-value
+data models.
+| No.
+| Lutaml::Model supports attribute extraction from key-value data models.
+
+
+|===
+
+
+[[migrate-from-shale]]
+== Migration steps from Shale
+
+The following sections provide a guide for migrating from Shale to Lutaml::Model.
+
+=== Step 1: Replace inheritance class
+
+`Lutaml::Model` uses `Lutaml::Model::Serializable` as the base inheritance class.
+
+[source,ruby]
+----
+class Example < Lutaml::Model::Serializable
+  # ...
+end
+----
+
+[NOTE]
+====
+`Lutaml::Model` also supports an inclusion method as in the following example,
+which is not supported by Shale. This is useful for cases where you want to
+include the serialization methods in a class that already inherits from another
+class.
+
+[source,ruby]
+----
+class Example
+  include Lutaml::Model::Serialize
+  # ...
+end
+----
+====
+
+Shale uses `Shale::Mapper` as the base inheritance class.
+
+[source,ruby]
+----
+class Example < Shale::Mapper
+  # ...
+end
+----
+
+Actions:
+
+* Replace mentions of `Shale::Mapper` with `Lutaml::Model::Serializable`.
+* Potentially replace inheritance with inclusion for suitable cases.
+
+
+=== Step 2: Replace value type definitions
+
+Value types in `Lutaml::Model` are under the `Lutaml::Model::Type` module.
+
+[source,ruby]
+----
+class Example < Lutaml::Model::Serializable
+  attribute :length, Lutaml::Model::Type::Integer
+  attribute :description, Lutaml::Model::Type::String
+end
+----
+
+[NOTE]
+====
+`Lutaml::Model` also supports specifying predefined value types as strings or
+symbols, which is not supported by Shale.
+
+[source,ruby]
+----
+class Example < Lutaml::Model::Serializable
+  attribute :length, :integer
+  attribute :description, "String"
+end
+----
+====
+
+Value types in Shale are under the `Shale::Type` module.
+
+[source,ruby]
+----
+class Example < Shale::Mapper
+  attribute :length, Shale::Type::Integer
+  attribute :description, Shale::Type::String
+end
+----
+
+Action:
+
+* Replace mentions of `Shale::Type` with `Lutaml::Model::Type`.
+* Potentially replace value type definitions with strings or symbols.
+
+
+=== Step 3: Configure serialization adapters
+
+`Lutaml::Model` uses a configuration block to set the serialization adapters.
+
+[source,ruby]
+----
+require 'lutaml/model/xml_adapter/nokogiri_adapter'
+Lutaml::Model::Config.configure do |config|
+  config.xml_adapter = Lutaml::Model::XmlAdapter::NokogiriAdapter
+end
+----
+
+The equivalent for Shale is this:
+
+[source,ruby]
+----
+require 'shale/adapter/nokogiri'
+Shale.xml_adapter = Shale::Adapter::Nokogiri
+----
+
+
+Here are places that this code may reside at:
+
+* If your code is a standalone Ruby script, this code will be present in your code.
+* If your code is organized in a Ruby gem, this code will be specified somewhere referenced by `lib/your_gem_name.rb`.
+* If your code contains tests or specs, they will be in the test setup file, e.g. RSpec `spec/spec_helper.rb`.
+
+Actions:
+
+* Replace the Shale configuration block with the `Lutaml::Model::Config`
+configuration block.
+
+* Replace the Shale adapter with the `Lutaml::Model` adapter.
+
+
+
+=== Step 4: Rewrite custom serialization methods
+
+There is an implementation difference between Lutaml::Model and Shale for custom
+serialization methods.
+
+Custom serialization methods in `Lutaml::Model` map to individual attributes.
+
+For custom serialization methods, Lutaml::Model uses the `:with` keyword
+instead of the `:using` keyword used by Shale.
+
+[source,ruby]
+----
+class Example < Lutaml::Model::Serializable
+  attribute :name, :string
+  attribute :size, :integer
+  attribute :color, :string
+  attribute :description, :string
+
+  json do
+    map "name", to: :name, with: { to: :name_to_json, from: :name_from_json }
+    map "size", to: :size
+    map "color", to: :color,
+                 with: { to: :color_to_json, from: :color_from_json }
+    map "description", to: :description,
+                       with: { to: :description_to_json, from: :description_from_json }
+  end
+
+  xml do
+    root "CustomSerialization"
+    map_element "Name", to: :name,
+                        with: { to: :name_to_xml, from: :name_from_xml }
+    map_attribute "Size", to: :size
+    map_element "Color", to: :color,
+                         with: { to: :color_to_xml, from: :color_from_xml }
+    map_content to: :description,
+                with: { to: :description_to_xml,
+                        from: :description_from_xml }
+  end
+
+  def name_to_json(_model, value)
+    "JSON Masterpiece: #{value}"
+  end
+
+  def name_from_json(_model, doc)
+    doc["name"].sub(/^JSON Masterpiece: /, "")
+  end
+
+  def color_to_json(_model, value)
+    value.upcase
+  end
+
+  def color_from_json(_model, doc)
+    doc["color"].downcase
+  end
+
+  def description_to_json(_model, value)
+    "JSON Description: #{value}"
+  end
+
+  def description_from_json(_model, doc)
+    doc["description"].sub(/^JSON Description: /, "")
+  end
+
+  def name_to_xml(_model, value)
+    "XML Masterpiece: #{value}"
+  end
+
+  def name_from_xml(_model, value)
+    value.sub(/^XML Masterpiece: /, "")
+  end
+
+  def color_to_xml(_model, value)
+    value.upcase
+  end
+
+  def color_from_xml(_model, value)
+    value.downcase
+  end
+
+  def description_to_xml(_model, value)
+    "XML Description: #{value}"
+  end
+
+  def description_from_xml(_model, value)
+    value.sub(/^XML Description: /, "")
+  end
+end
+----
+
+Custom serialization methods in Shale do not map to specific attributes, but
+allow the user to specify where the data goes.
+
+[source,ruby]
+----
+class Example < Shale::Mapper
+  attribute :name, Shale::Type::String
+  attribute :size, Shale::Type::Integer
+  attribute :color, Shale::Type::String
+  attribute :description, Shale::Type::String
+
+  json do
+    map "name", using: { from: :name_from_json, to: :name_to_json }
+    map "size", to: :size
+    map "color", using: { from: :color_from_json, to: :color_to_json }
+    map "description", to: :description, using: { from: :description_from_json, to: :description_to_json }
+  end
+
+  xml do
+    root "CustomSerialization"
+    map_element "Name", using: { from: :name_from_xml, to: :name_to_xml }
+    map_attribute "Size", to: :size
+    map_element "Color", using: { from: :color_from_xml, to: :color_to_xml }
+    map_content to: :description, using: { from: :description_from_xml, to: :description_to_xml }
+  end
+
+  def name_to_json(model, doc)
+    doc['name'] = "JSON Masterpiece: #{model.name}"
+  end
+
+  def name_from_json(model, value)
+    model.name = value.sub(/^JSON Masterpiece: /, "")
+  end
+
+  def color_to_json(model, doc)
+    doc['color'] = model.color.upcase
+  end
+
+  def color_from_json(model, doc)
+    model.color = doc['color'].downcase
+  end
+
+  def description_to_json(model, doc)
+    doc['description'] = "JSON Description: #{model.description}"
+  end
+
+  def description_from_json(model, doc)
+    model.description = doc['description'].sub(/^JSON Description: /, "")
+  end
+
+  def name_from_xml(model, node)
+    model.name = node.text.sub(/^XML Masterpiece: /, "")
+  end
+
+  def name_to_xml(model, parent, doc)
+    name_element = doc.create_element('Name')
+    doc.add_text(name_element, model.street.to_s)
+    doc.add_element(parent, name_element)
+  end
+end
+----
+
+NOTE: There are cases where the Shale implementation of custom methods work
+differently from the Lutaml::Model implementation. In these cases, you will need
+to adjust the custom methods accordingly.
+
+Actions:
+
+* Replace the `using` keyword with the `with` keyword.
+* Adjust the custom methods.
+
+
+== About LutaML
+
+The name "LutaML" is pronounced as "Looh-tah-mel".
+
+The name "LutaML" comes from the Latin word for clay, "Lutum", and "ML"
+for "Markup Language". Just as clay can be molded and modeled into beautiful and
+practical end products, the Lutaml::Model gem is used for data modeling,
+allowing you to shape and structure your data into useful forms.
+
+
+
 == License and Copyright
 
 This project is licensed under the BSD 2-clause License.

data/lib/lutaml/model/config.rb

@@ -3,11 +3,92 @@ module Lutaml
     module Config
       extend self
 
-      attr_accessor :xml_adapter, :json_adapter, :yaml_adapter, :toml_adapter
+      # Default values are set for these so the readers are defined below
+      attr_writer :json_adapter, :yaml_adapter
+
+      attr_accessor :xml_adapter, :toml_adapter
+
+      AVAILABLE_FORMATS = %i[xml json yaml toml].freeze
 
       def configure
         yield self
       end
+
+      # This will generate the following methods
+      #
+      # xml_adapter_type=
+      #   @params:
+      #     one of [:nokogiri, :ox, :oga]
+      #   @example
+      #     Lutaml::Model::Config.xml_adapter = :nokogiri
+      #
+      # json_adapter_type=
+      #   @params:
+      #     one of [:standard_json, :multi_json]
+      #     if not set, :standard_json will be used by default
+      #   @example
+      #     Lutaml::Model::Config.json_adapter = :standard_json
+      #
+      # yaml_adapter_type=
+      #   @params:
+      #     one of [:standard_yaml]
+      #     if not set, :standard_yaml will be used by default
+      #   @example
+      #     Lutaml::Model::Config.yaml_adapter = :standard_yaml
+      #
+      # toml_adapter_type=
+      #   @params
+      #     one of [:tomlib, :toml_rb]
+      #   @example
+      #     Lutaml::Model::Config.toml_adapter = :tomlib
+      AVAILABLE_FORMATS.each do |adapter_name|
+        define_method(:"#{adapter_name}_adapter_type=") do |type_name|
+          adapter = "#{adapter_name}_adapter"
+          type = "#{type_name}_adapter"
+
+          begin
+            adapter_file = File.join(adapter, type)
+            require_relative adapter_file
+          rescue LoadError
+            raise(
+              Lutaml::Model::UnknownAdapterTypeError.new(
+                adapter_name,
+                type_name,
+              ),
+              cause: nil,
+            )
+          end
+
+          instance_variable_set(
+            :"@#{adapter}",
+            Lutaml::Model.const_get(to_class_name(adapter))
+                         .const_get(to_class_name(type)),
+          )
+        end
+      end
+
+      # Return JSON adapter. By default StandardJsonAdapter is used
+      #
+      # @example
+      #   Lutaml::Model::Config.json_adapter
+      #   # => Lutaml::Model::YamlAdapter::StandardJsonAdapter
+      def json_adapter
+        @json_adapter || Lutaml::Model::JsonAdapter::StandardJsonAdapter
+      end
+
+      # Return YAML adapter. By default StandardYamlAdapter is used
+      #
+      # @example
+      #   Lutaml::Model::Config.yaml_adapter
+      #   # => Lutaml::Model::YamlAdapter::StandardYamlAdapter
+      def yaml_adapter
+        @yaml_adapter || Lutaml::Model::YamlAdapter::StandardYamlAdapter
+      end
+
+      # @api private
+      def to_class_name(str)
+        str.to_s.split("_").map(&:capitalize).join
+      end
     end
   end
 end

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

@@ -0,0 +1,16 @@
+module Lutaml
+  module Model
+    class UnknownAdapterTypeError < Error
+      def initialize(adapter_name, type_name)
+        @adapter_name = adapter_name
+        @type_name = type_name
+
+        super()
+      end
+
+      def to_s
+        "Unknown type: `#{@type_name}` for `#{@adapter_name}` adapter"
+      end
+    end
+  end
+end

data/lib/lutaml/model/error.rb

@@ -6,3 +6,4 @@ module Lutaml
 end
 
 require_relative "error/invalid_value_error"
+require_relative "error/unknown_adapter_type_error"

data/lib/lutaml/model/serialize.rb

@@ -13,8 +13,6 @@ require_relative "comparable_model"
 module Lutaml
   module Model
     module Serialize
-      FORMATS = %i[xml json yaml toml].freeze
-
       include ComparableModel
 
       def self.included(base)
@@ -73,7 +71,7 @@ module Lutaml
           attr.options[:values].include?(value)
         end
 
-        FORMATS.each do |format|
+        Lutaml::Model::Config::AVAILABLE_FORMATS.each do |format|
           define_method(format) do |&block|
             klass = format == :xml ? XmlMapping : KeyValueMapping
             mappings[format] = klass.new
@@ -210,9 +208,7 @@ module Lutaml
               else
                 # TODO: This code is problematic because Type.cast does not know
                 # about all the types.
-                Lutaml::Model::Type.cast(
-                  v, attr_rule.type
-                )
+                Lutaml::Model::Type.cast(v, attr_rule.type)
               end
             end
           elsif value.is_a?(Hash) && attr_rule.type != Lutaml::Model::Type::Hash
@@ -276,7 +272,7 @@ module Lutaml
                 end.public_send(:[]=, path.last.to_s, child_obj.send(attr_name))
               end
             end
-            # hash[mapping.name] ||= {}
+
             hash[map_key] = map_value
           end
 
@@ -337,6 +333,8 @@ module Lutaml
           mapping_hash.item_order = doc.item_order
           mapping_hash.ordered = mappings_for(:xml).mixed_content? || mixed_content
 
+          mapping_from = []
+
           mappings.each_with_object(mapping_hash) do |rule, hash|
             attr = attributes[rule.to]
             raise "Attribute '#{rule.to}' not found in #{self}" unless attr
@@ -372,8 +370,22 @@ module Lutaml
               value = attr.type.cast(value) unless is_content_mapping
             end
 
+            mapping_from << rule if rule.custom_methods[:from]
+
             hash[rule.to] = value
           end
+
+          mapping_from.each do |rule|
+            value = if rule.name.nil?
+                      mapping_hash[rule.to].join("\n").strip
+                    else
+                      mapping_hash[rule.to]
+                    end
+
+            mapping_hash[rule.to] = new.send(rule.custom_methods[:from], mapping_hash, value)
+          end
+
+          mapping_hash
         end
 
         def ensure_utf8(value)
@@ -385,7 +397,9 @@ module Lutaml
           when Hash
             value.transform_keys do |k|
               ensure_utf8(k)
-            end.transform_values { |v| ensure_utf8(v) }
+            end.transform_values do |v|
+              ensure_utf8(v)
+            end
           else
             value
           end
@@ -416,14 +430,14 @@ module Lutaml
       end
 
       def key_exist?(hash, key)
-        hash.key?(key) || hash.key?(key.to_sym) || hash.key?(key.to_s)
+        hash.key?(key.to_sym) || hash.key?(key.to_s)
       end
 
       def key_value(hash, key)
-        hash[key] || hash[key.to_sym] || hash[key.to_s]
+        hash[key.to_sym] || hash[key.to_s]
       end
 
-      FORMATS.each do |format|
+      Lutaml::Model::Config::AVAILABLE_FORMATS.each do |format|
         define_method(:"to_#{format}") do |options = {}|
           validate
           adapter = Lutaml::Model::Config.public_send(:"#{format}_adapter")

data/lib/lutaml/model/type.rb

@@ -1,8 +1,5 @@
 require "date"
 require "bigdecimal"
-require "securerandom"
-require "uri"
-require "ipaddr"
 
 module Lutaml
   module Model
@@ -20,12 +17,6 @@ module Lutaml
         Boolean
         Decimal
         Hash
-        Uuid
-        Symbol
-        Binary
-        Url
-        IpAddress
-        Json
       ).each do |t|
         class_eval <<~HEREDOC, __FILE__, __LINE__ + 1
                      class #{t}                        # class Integer
@@ -72,18 +63,6 @@ module Lutaml
           BigDecimal(value.to_s)
         when "Hash"
           normalize_hash(Hash(value))
-        when "Uuid"
-          UUID_REGEX.match?(value) ? value : SecureRandom.uuid
-        when "Symbol"
-          value.to_sym
-        when "Binary"
-          value.force_encoding("BINARY")
-        when "Url"
-          URI.parse(value.to_s)
-        when "IpAddress"
-          IPAddr.new(value.to_s)
-        when "Json"
-          Json.cast(value)
         else
           value
         end
@@ -107,8 +86,6 @@ module Lutaml
           value.to_s("F")
         when "Hash"
           Hash(value)
-        when "Json"
-          value.to_json
         else
           value.to_s
         end
@@ -145,4 +122,3 @@ end
 
 require_relative "type/time_without_date"
 require_relative "type/date_time"
-require_relative "type/json"

data/lib/lutaml/model/version.rb

@@ -2,6 +2,6 @@
 
 module Lutaml
   module Model
-    VERSION = "0.3.4"
+    VERSION = "0.3.6"
   end
 end

data/lib/lutaml/model/xml_adapter/nokogiri_adapter.rb

@@ -71,10 +71,14 @@ module Lutaml
               end
             end
 
-            if xml_mapping.content_mapping
-              text = element.send(xml_mapping.content_mapping.to)
+            if (content_rule = xml_mapping.content_mapping)
+              text = element.send(content_rule.to)
               text = text.join if text.is_a?(Array)
 
+              if content_rule.custom_methods[:to]
+                text = @root.send(content_rule.custom_methods[:to], @root, text)
+              end
+
               prefixed_xml.text text
             end
           end
@@ -130,6 +134,10 @@ module Lutaml
         end
 
         def add_to_xml(xml, value, attribute, rule)
+          if rule.custom_methods[:to]
+            value = @root.send(rule.custom_methods[:to], @root, value)
+          end
+
           if value && (attribute&.type&.<= Lutaml::Model::Serialize)
             handle_nested_elements(
               xml,

data/lib/lutaml/model/xml_adapter/ox_adapter.rb

@@ -69,10 +69,14 @@ module Lutaml
               end
             end
 
-            if xml_mapping.content_mapping
+            if (content_rule = xml_mapping.content_mapping)
               text = element.send(xml_mapping.content_mapping.to)
               text = text.join if text.is_a?(Array)
 
+              if content_rule.custom_methods[:to]
+                text = @root.send(content_rule.custom_methods[:to], @root, text)
+              end
+
               el.text text
             end
           end
@@ -113,6 +117,10 @@ module Lutaml
         end
 
         def add_to_xml(xml, value, attribute, rule)
+          if rule.custom_methods[:to]
+            value = @root.send(rule.custom_methods[:to], @root, value)
+          end
+
           if value && (attribute&.type&.<= Lutaml::Model::Serialize)
             handle_nested_elements(
               xml,

data/lib/lutaml/model.rb

@@ -3,8 +3,8 @@
 require_relative "model/version"
 require_relative "model/type"
 require_relative "model/serializable"
-require_relative "model/json_adapter"
-require_relative "model/yaml_adapter"
+require_relative "model/json_adapter/standard_json_adapter"
+require_relative "model/yaml_adapter/standard_yaml_adapter"
 require_relative "model/xml_adapter"
 require_relative "model/toml_adapter"
 require_relative "model/error"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lutaml-model
 version: !ruby/object:Gem::Version
-  version: 0.3.4
+  version: 0.3.6
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-08-16 00:00:00.000000000 Z
+date: 2024-08-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -56,6 +56,7 @@ files:
 - lib/lutaml/model/config.rb
 - lib/lutaml/model/error.rb
 - lib/lutaml/model/error/invalid_value_error.rb
+- lib/lutaml/model/error/unknown_adapter_type_error.rb
 - lib/lutaml/model/json_adapter.rb
 - lib/lutaml/model/json_adapter/json_document.rb
 - lib/lutaml/model/json_adapter/json_object.rb
@@ -80,7 +81,6 @@ files:
 - lib/lutaml/model/toml_adapter/tomlib_adapter.rb
 - lib/lutaml/model/type.rb
 - lib/lutaml/model/type/date_time.rb
-- lib/lutaml/model/type/json.rb
 - lib/lutaml/model/type/time_without_date.rb
 - lib/lutaml/model/version.rb
 - lib/lutaml/model/xml_adapter.rb

data/lib/lutaml/model/type/json.rb

@@ -1,34 +0,0 @@
-require "json"
-
-module Lutaml
-  module Model
-    module Type
-      # JSON representation
-      class Json
-        attr_reader :value
-
-        def initialize(value)
-          @value = value
-        end
-
-        def to_json(*_args)
-          @value.to_json
-        end
-
-        def ==(other)
-          @value == (other.is_a?(::Hash) ? other : other.value)
-        end
-
-        def self.cast(value)
-          return value if value.is_a?(self) || value.nil?
-
-          new(::JSON.parse(value))
-        end
-
-        def self.serialize(value)
-          value.to_json
-        end
-      end
-    end
-  end
-end