lutaml-model 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c28f7695801483c724c6d8b03e37b1bc269eb82a506b4e363f65078142bed860
-  data.tar.gz: feb57e7df6c86c2cc3cdaa03012045e017c557a2f957b74c639d80feb53a36fc
+  metadata.gz: 2b948b6c3373e3a5cbe98462e88fe5b945542d9f509b313dd21af2f333859884
+  data.tar.gz: 0c53660f6ff3f8ad249c3368c6c1477eb4d5ea1d426d9c4db44216efec9e5b56
 SHA512:
-  metadata.gz: 4a9641bec82c8c12099bc5c332931aa1f52b0dd8594ebc6e43722ace015c838522e7ebc873b834e324167db151b5055bbb495461ee585f6fdcd1c400ddbe7513
-  data.tar.gz: 88090ad9c5dc0be10531d1fc5c053db353fd5a30412279f19868b4786d046ae1f9b9f03237709c1928afd039f2b94809e137a6ad430e3fe2d04e200416cc8949
+  metadata.gz: 032c506ddc4f5173281092dae4828c63717454dbcdf8ed44fb30bc94482552bffbfbf830084c9ae1b832c49db802f940b81adf684ea94d684d0496bd804e5dbf
+  data.tar.gz: 4b75612301d6df11570f30b04ddd7800b666ae354a9c2171d553fc14cce21846795c54f88e25c4a35896ee66701b14c27fd825f9146fdd3ec469ede544405bd3

data/.gitignore

@@ -1,3 +1,5 @@
+.rubocop-https---*
+
 /.bundle/
 /.yardoc
 /_yardoc/

data/.rubocop.yml

@@ -1,8 +1,15 @@
 inherit_from:
   - https://raw.githubusercontent.com/riboseinc/oss-guides/master/ci/rubocop.yml
+  - .rubocop_todo.yml
 
 # local repo-specific modifications
 # ...
+#
+require:
+- rubocop-performance
+- rubocop-rails
+- rubocop-rake
+- rubocop-rspec
 
 AllCops:
   TargetRubyVersion: 3.0

data/.rubocop_todo.yml

@@ -0,0 +1,207 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2024-07-31 10:20:40 UTC using RuboCop version 1.64.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
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Severity, Include.
+# Include: **/*.gemspec
+Gemspec/RequireMFA:
+  Exclude:
+    - 'lutaml-model.gemspec'
+
+# Offense count: 15
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Max, AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, AllowedPatterns.
+# URISchemes: http, https
+Layout/LineLength:
+  Exclude:
+    - 'lib/lutaml/model/serialize.rb'
+    - 'lib/lutaml/model/type.rb'
+    - 'lib/lutaml/model/xml_adapter.rb'
+    - 'lib/lutaml/model/xml_adapter/nokogiri_adapter.rb'
+    - 'lib/lutaml/model/xml_adapter/ox_adapter.rb'
+    - 'spec/lutaml/model/xml_namespace_spec.rb'
+
+# Offense count: 20
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
+Metrics/AbcSize:
+  Exclude:
+    - 'lib/lutaml/model/serialize.rb'
+    - 'lib/lutaml/model/type.rb'
+    - 'lib/lutaml/model/xml_adapter.rb'
+    - 'lib/lutaml/model/xml_adapter/nokogiri_adapter.rb'
+    - 'lib/lutaml/model/xml_adapter/ox_adapter.rb'
+
+# Offense count: 3
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
+# AllowedMethods: refine
+Metrics/BlockLength:
+  Max: 30
+
+# Offense count: 17
+# Configuration parameters: AllowedMethods, AllowedPatterns, Max.
+Metrics/CyclomaticComplexity:
+  Exclude:
+    - 'lib/lutaml/model/serialize.rb'
+    - 'lib/lutaml/model/type.rb'
+    - 'lib/lutaml/model/xml_adapter.rb'
+    - 'lib/lutaml/model/xml_adapter/nokogiri_adapter.rb'
+    - 'lib/lutaml/model/xml_adapter/ox_adapter.rb'
+
+# Offense count: 24
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Max: 42
+
+# Offense count: 3
+# Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
+Metrics/ParameterLists:
+  Max: 9
+
+# Offense count: 16
+# Configuration parameters: AllowedMethods, AllowedPatterns, Max.
+Metrics/PerceivedComplexity:
+  Exclude:
+    - 'lib/lutaml/model/serialize.rb'
+    - 'lib/lutaml/model/type.rb'
+    - 'lib/lutaml/model/xml_adapter.rb'
+    - 'lib/lutaml/model/xml_adapter/nokogiri_adapter.rb'
+    - 'lib/lutaml/model/xml_adapter/ox_adapter.rb'
+
+# Offense count: 2
+# This cop supports unsafe autocorrection (--autocorrect-all).
+RSpec/BeEq:
+  Exclude:
+    - 'spec/lutaml/model/collection_spec.rb'
+    - 'spec/lutaml/model/simple_model_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: be, be_nil
+RSpec/BeNil:
+  Exclude:
+    - 'spec/lutaml/model_spec.rb'
+
+# Offense count: 6
+# Configuration parameters: Prefixes, AllowedPatterns.
+# Prefixes: when, with, without
+RSpec/ContextWording:
+  Exclude:
+    - 'spec/lutaml/model/xml_adapter/nokogiri_adapter_spec.rb'
+    - 'spec/lutaml/model/xml_adapter/oga_adapter_spec.rb'
+    - 'spec/lutaml/model/xml_adapter/ox_adapter_spec.rb'
+
+# Offense count: 18
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: SkipBlocks, EnforcedStyle, OnlyStaticConstants.
+# SupportedStyles: described_class, explicit
+RSpec/DescribedClass:
+  Exclude:
+    - 'spec/address_spec.rb'
+    - 'spec/lutaml/model/custom_serialization_spec.rb'
+    - 'spec/lutaml/model/defaults_spec.rb'
+    - 'spec/lutaml/model/render_nil_spec.rb'
+    - 'spec/person_spec.rb'
+
+# Offense count: 60
+# Configuration parameters: CountAsOne.
+RSpec/ExampleLength:
+  Max: 36
+
+# Offense count: 2
+# Configuration parameters: Max, AllowedIdentifiers, AllowedPatterns.
+RSpec/IndexedLet:
+  Exclude:
+    - 'spec/address_spec.rb'
+
+# Offense count: 3
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AutoCorrect.
+RSpec/LetBeforeExamples:
+  Exclude:
+    - 'spec/lutaml/model/defaults_spec.rb'
+    - 'spec/person_spec.rb'
+
+# Offense count: 4
+RSpec/MultipleDescribes:
+  Exclude:
+    - 'spec/lutaml/model/json_adapter_spec.rb'
+    - 'spec/lutaml/model/toml_adapter_spec.rb'
+    - 'spec/lutaml/model/xml_adapter_spec.rb'
+    - 'spec/lutaml/model/xml_namespace_spec.rb'
+
+# Offense count: 54
+RSpec/MultipleExpectations:
+  Max: 15
+
+# Offense count: 1
+# Configuration parameters: AllowSubject.
+RSpec/MultipleMemoizedHelpers:
+  Max: 9
+
+# Offense count: 3
+RSpec/PendingWithoutReason:
+  Exclude:
+    - 'spec/lutaml/model/xml_adapter/oga_adapter_spec.rb'
+    - 'spec/lutaml/model/xml_adapter_spec.rb'
+    - 'spec/lutaml/model/xml_namespace_spec.rb'
+
+# Offense count: 3
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AutoCorrect.
+RSpec/ScatteredLet:
+  Exclude:
+    - 'spec/lutaml/model/defaults_spec.rb'
+    - 'spec/person_spec.rb'
+
+# Offense count: 5
+# Configuration parameters: Include, CustomTransform, IgnoreMethods, IgnoreMetadata.
+# Include: **/*_spec.rb
+RSpec/SpecFilePathFormat:
+  Exclude:
+    - 'spec/lutaml/model/collection_spec.rb'
+    - 'spec/lutaml/model/xml_adapter/nokogiri_adapter_spec.rb'
+    - 'spec/lutaml/model/xml_adapter/oga_adapter_spec.rb'
+    - 'spec/lutaml/model/xml_adapter/ox_adapter_spec.rb'
+    - 'spec/lutaml/model/yaml_adapter_spec.rb'
+
+# Offense count: 2
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: Whitelist, AllowedMethods, AllowedReceivers.
+# Whitelist: find_by_sql, find_by_token_for
+# AllowedMethods: find_by_sql, find_by_token_for
+# AllowedReceivers: Gem::Specification, page
+Rails/DynamicFindBy:
+  Exclude:
+    - 'lib/lutaml/model/xml_adapter/nokogiri_adapter.rb'
+    - 'lib/lutaml/model/xml_adapter/ox_adapter.rb'
+
+# Offense count: 1
+# This cop supports unsafe autocorrection (--autocorrect-all).
+Rails/NegateInclude:
+  Exclude:
+    - 'lib/lutaml/model/serialize.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: NotNilAndNotEmpty, NotBlank, UnlessBlank.
+Rails/Present:
+  Exclude:
+    - 'lib/lutaml/model/serialize.rb'
+    - 'lib/lutaml/model/xml_namespace.rb'
+
+# Offense count: 6
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: strict, flexible
+Rails/TimeZone:
+  Exclude:
+    - 'lib/lutaml/model/type.rb'
+    - 'lib/lutaml/model/type/time_without_date.rb'
+    - 'spec/person_spec.rb'

data/Gemfile

@@ -23,9 +23,13 @@ gem "ox"
 
 gem "pry"
 
-gem "rubocop-performance"
+gem "rubocop-performance", require: false
 
-gem "rubocop-rails"
+gem "rubocop-rails", require: false
+
+gem "rubocop-rake", require: false
+
+gem "rubocop-rspec", require: false
 
 gem "tomlib"
 

data/README.adoc

@@ -105,6 +105,8 @@ class Example < Lutaml::Model::Serializable
 end
 ----
 
+NOTE: If root is not given then the class name will be used as the root.
+
 === Key Value Data Models: JSON, YAML, TOML
 
 Define key-value data models like JSON, YAML, and TOML using the `map` method.
@@ -294,16 +296,31 @@ end
 
 === XML Namespace on Attribute
 
+If the namespace is defined on an attribute then that will be given priority over the one defined in the class. In the example below `glz` will be used for `Glaze` if it is added inside the `Ceramic` class, and `glaze` will be used otherwise.
+
 [source,ruby]
 ----
+class Glaze < Lutaml::Model::Serializable
+  attribute :color, Lutaml::Model::Type::String
+  attribute :temperature, Lutaml::Model::Type::Integer
+
+  xml do
+    root 'Glaze'
+    namespace 'http://example.com/old_glaze', 'glaze'
+
+    map_element 'color', to: :color
+    map_element 'temperature', to: :temperature
+  end
+end
+
 class Ceramic < Lutaml::Model::Serializable
   attribute :type, Lutaml::Model::Type::String
-  attribute :glaze, Lutaml::Model::Type::String
+  attribute :glaze, Glaze
 
   xml do
     root 'Ceramic'
     map_element 'Type', to: :type
-    map_element 'Glaze', to: :glaze
+    map_element 'Glaze', to: :glaze, namespace: 'http://example.com/glaze', prefix: "glz"
     map_attribute 'xmlns', to: :namespace, namespace: 'http://example.com/ceramic'
   end
 end
@@ -326,6 +343,60 @@ class Ceramic < Lutaml::Model::Serializable
 end
 ----
 
+== Using XML `mixed` option
+
+In XML there can be some tags that containg content mixed with other tags for example `<description><p>My name is <bold>John Doe</bold>, and I'm <i>28</i> years old</p></description>`
+
+To map this to Lutaml::Model we can use the mixed option when defining the model or when referencing it. 
+
+=== Adding mixed option when defining a Model
+
+This will always treat the content of `<p>` tag as mixed content.
+
+[source,ruby]
+----
+class Paragraph < Lutaml::Model::Serializable
+  attribute :bold, Lutaml::Model::Type::String
+  attribute :italic, Lutaml::Model::Type::String
+
+  xml do
+    root 'p', mixed: true
+
+    map_element 'bold', to: :bold
+    map_element 'i', to: :italic
+  end
+end
+----
+
+=== Adding mixed option when referencing a Model
+
+This will only treat the content of `<p>` tag as mixed content if the `mixed: true` is added when referencing it.
+
+[source,ruby]
+----
+class Paragraph < Lutaml::Model::Serializable
+  attribute :bold, Lutaml::Model::Type::String
+  attribute :italic, Lutaml::Model::Type::String
+
+  xml do
+    root 'p'
+
+    map_element 'bold', to: :bold
+    map_element 'i', to: :italic
+  end
+end
+
+class Description < Lutaml::Model::Serializable
+  attribute :paragraph, Paragraph
+
+  xml do
+    root 'description'
+
+    map_element 'p', to: :paragraph, mixed: true
+  end
+end
+----
+
 == Adapters
 
 Lutaml::Model uses an adapter pattern to support multiple libraries for each serialization format.
@@ -377,4 +448,4 @@ end
 
 This project is licensed under the BSD 2-clause License - see the LICENSE file for details.
 
-This project is maintained by Ribose.
+This project is maintained by Ribose.

data/lib/lutaml/model/attribute.rb

@@ -8,6 +8,10 @@ module Lutaml
         @name = name
         @type = type
         @options = options
+
+        if collection? && !options[:default]
+          @options[:default] = -> { [] }
+        end
       end
 
       def collection?

data/lib/lutaml/model/mapping_hash.rb

@@ -0,0 +1,42 @@
+# lib/lutaml/model/type.rb
+
+module Lutaml
+  module Model
+    class MappingHash < Hash
+      attr_accessor :ordered
+
+      def initialize
+        @ordered = false
+        @item_order = []
+
+        super
+      end
+
+      def item_order
+        @item_order&.map { |key| normalize(key) } || keys
+      end
+
+      def item_order=(order)
+        raise "`item order` must be an array" unless order.is_a?(Array)
+
+        @item_order = order
+      end
+
+      def ordered?
+        @ordered
+      end
+
+      private
+
+      def normalize(key)
+        if self[key.to_s]
+          key.to_s
+        elsif self[key.to_sym]
+          key.to_sym
+        else
+          key
+        end
+      end
+    end
+  end
+end

data/lib/lutaml/model/mapping_rule.rb

@@ -2,14 +2,29 @@
 module Lutaml
   module Model
     class MappingRule
-      attr_reader :name, :to, :render_nil, :custom_methods, :delegate
+      attr_reader :name,
+                  :to,
+                  :render_nil,
+                  :custom_methods,
+                  :delegate,
+                  :mixed_content
 
-      def initialize(name, to:, render_nil: false, with: {}, delegate: nil)
+      def initialize(
+        name,
+        to:,
+        render_nil: false,
+        with: {},
+        delegate: nil,
+        mixed_content: false,
+        namespace_set: false
+      )
         @name = name
         @to = to
         @render_nil = render_nil
         @custom_methods = with
         @delegate = delegate
+        @mixed_content = mixed_content
+        @namespace_set = namespace_set
       end
 
       alias from name
@@ -38,6 +53,10 @@ module Lutaml
           doc[name.to_s]
         end
       end
+
+      def namespace_set?
+        @namespace_set
+      end
     end
   end
 end