lutaml-model 0.8.71 → 0.8.72

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a883654d3aade8e954a1c8c13b5e90e93fbc31a50c91de6cf01112a6cab8309f
-  data.tar.gz: f63078d1f4aacf1b33f9cc8a1170ddab301515195dfc415056924d533f087a94
+  metadata.gz: 95182bda9669da0320508b55f43356fede1a292ce745cf3909f8f1caa9b07b42
+  data.tar.gz: 9d28efcea7784103991d992e3e85a4fd4f00b8caf90ec3edf137bea4b2fdc768
 SHA512:
-  metadata.gz: 1588bee4f62fdf4e5849d44286567400acb69f47df50569af652ebff39d02a437a6b9ff036f9a18affed3c176bd3ec192df2cd8b2b8fcce55721a34af432245e
-  data.tar.gz: 20dae52f3cb83a71079724c6d882e16b5a0cd7a0f279d62d7e34f5b85c51b4e2d5a1755eb08d5cad09cc33ebc04fd88a3213f2e8888cf58d1ed768e31b69d00c
+  metadata.gz: '03994dc9b1069fc2fdb00f41b2ee949a0a9b9f0845673847af0b5c2ffff9d63e6a6d72078f03938f65e657dbb27b8fe29e426c9f6764b7ee692f49ce5b9cd3af'
+  data.tar.gz: 24f6867bb3851091561f98fbff70566f7734d58da18fa8ce2d9b220fb99d4a0ee87db1f497ce69278aa12462a7addb1e0bbccd726dfeb8e139aeb5c98c761c6d

data/bench/bench_common.rb

@@ -12,6 +12,17 @@
 #   bundle exec ruby bench/bench_uniword.rb
 
 require "bundler/setup"
+
+# TODO.perf/15: run any benchmark with PLAN_COMPILE_STATS=1 to append
+# the plan-compiler opt-out histogram (which clauses keep a corpus on
+# the interpretive path) after the benchmark output.
+if ENV["PLAN_COMPILE_STATS"]
+  at_exit do
+    require "pp"
+    puts "\nPlanCompiler opt-out histogram:"
+    pp(Lutaml::Xml::PlanCompiler.stats)
+  end
+end
 require "benchmark"
 require "fileutils"
 

data/lib/lutaml/model/version.rb

@@ -2,6 +2,6 @@
 
 module Lutaml
   module Model
-    VERSION = "0.8.71"
+    VERSION = "0.8.72"
   end
 end

data/lib/lutaml/xml/plan_compiler.rb

@@ -24,6 +24,19 @@ module Lutaml
     # full semantics audit (parent links, consolidation, ordering
     # metadata) completes.
     module PlanCompiler
+      # TODO.perf/15: env-gated histogram of why models opt out of the
+      # plan path. Set PLAN_COMPILE_STATS=1 and read PlanCompiler.stats
+      # after a parse. Zero cost when disabled.
+      def self.stats
+        @stats ||= Hash.new(0)
+      end
+
+      def self.opt_out!(clause)
+        @plan_stats ||= Hash.new(0)
+        @plan_stats[clause] += 1 if ENV["PLAN_COMPILE_STATS"]
+        nil
+      end
+
       # Isolated holder: suites freeze model classes; a cache on a
       # frozen constant would be immutable (TypeProbeCache precedent).
       PLAN_CACHE = ::Class.new do
@@ -103,8 +116,8 @@ module Lutaml
                    else
                      model_class.attributes(register)[rule.to]
                    end
-            return nil if attr.nil?
-            return nil if attr.derived?
+            return opt_out!(:attr_nil) if attr.nil?
+            return opt_out!(:derived) if attr.derived?
 
             # Partition rows (TODO 34 step 2) ride native predicates
             # only in the plain-capture shape; any other when_attribute
@@ -118,7 +131,7 @@ module Lutaml
                 !attr.polymorphic? && !attr.union? &&
                 !(t.is_a?(Class) &&
                   t.include?(::Lutaml::Model::Serialize))
-              return nil unless plain_partition
+              return opt_out!(:non_plain_partition) unless plain_partition
             end
 
             # Interpretive hydration materializes every mapped
@@ -132,20 +145,20 @@ module Lutaml
             # ns-qualified models keep those rules interpretive.
             fragment_needed = rule.has_custom_method_for_deserialization? ||
               rule.polymorphic_mapping? || attr.polymorphic? || attr.union?
-            return nil if fragment_needed && model_ns
+            return opt_out!(:fragment_with_ns) if fragment_needed && model_ns
 
             if rule.attribute?
-              return nil unless scalar_type?(attr, register)
+              return opt_out!(:non_scalar) unless scalar_type?(attr, register)
               # Attribute plan rows are local-name keyed; a type-level
               # namespace makes the attribute (URI, local)-identified
               # (lutaml-model#744) — the interpretive matcher owns it
               # until plan rows carry namespace identity.
-              return nil if attr.type_namespace_class(register)
+              return opt_out!(:attr_type_ns) if attr.type_namespace_class(register)
 
               attr_rows << [rule, attr]
               plan_attrs << { name: rule.name.to_s }
             elsif rule.content_mapping?
-              return nil if content_rows(rows) >= 1
+              return opt_out!(:multi_content) if content_rows(rows) >= 1
 
               mixed_content = true
               compiled << [rule, attr,
@@ -161,7 +174,7 @@ module Lutaml
               rows << { name: rule.name.to_s, kind: :raw }
             elsif rule.polymorphic_mapping? || attr.polymorphic? || attr.union?
               type = attr.type(register)
-              return nil unless serializable_type?(type) || attr.union?
+              return opt_out!(:non_serializable_poly) unless serializable_type?(type) || attr.union?
 
               needs_nodes = true
               compiled << [rule, attr, :polymorphic, nil, delegate_target]
@@ -170,7 +183,7 @@ module Lutaml
               type = attr.type(register)
               if serializable_type?(type)
                 child = compile(type, register)
-                return nil unless child
+                return opt_out!(:child_uncompilable) unless child
 
                 if child[:ordered]
                   # Ordered/mixed children need element_order on their
@@ -178,7 +191,7 @@ module Lutaml
                   # source nodes, so the subtree defers interpretively
                   # (the fragment parse runs the full machinery,
                   # order included).
-                  return nil if model_ns
+                  return opt_out!(:ordered_child_with_ns) if model_ns
 
                   needs_nodes = true
                   compiled << [rule, attr, :ordered_deferred, nil,
@@ -200,7 +213,7 @@ module Lutaml
                             type_tag: (tag += 1) }
                 end
               else
-                return nil unless scalar_type?(attr, register)
+                return opt_out!(:non_scalar) unless scalar_type?(attr, register)
 
                 row = { name: rule.name.to_s }
                 row[:ns] = child_ns(rule, model_ns) if rule.namespace_set?

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lutaml-model
 version: !ruby/object:Gem::Version
-  version: 0.8.71
+  version: 0.8.72
 platform: ruby
 authors:
 - Ribose Inc.