yeptris 0.6.15.2-aarch64-linux → 0.6.16.2-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 419470a0e038bec65880a3d764da46f072d7993e5aca9de71825a8428d5b2f98
-  data.tar.gz: 19cf714c7f80abc07d8729420700ef2c08bf1a140de03c3e11a8bb6ff177a4f4
+  metadata.gz: 9505473e51a840dbf7c50d8ed7ae56b7e3a9b3592e26787ba0a0b231320bfe86
+  data.tar.gz: 78fbfa73c88cc29e5376cde241e310b1b4d65b878e96198faf733640bc695454
 SHA512:
-  metadata.gz: 9d11c53e5305c76f780f431d73be9c62228e250ab164c4fd636429ad4fca4e3705b1d46b0e9cf7abed5d8a0662d0347a2399de0ce3a16f5eec987d05d0fb053f
-  data.tar.gz: 5c24e95902b4ae44595710274ede3efbd605885d8cbc0747fc0965fcb8a2addb32ea8f18648606fef823d09a6f106d777d175f4e8ed0f1c8e74810f22d6cbee6
+  metadata.gz: 88c4aaa0e2b48a7b5ce25da76e0035e0cd2d83f2901bde878c6114cdf046ade9c9e7ae74ff70ebc3fe403ea98a5dce86504de060cec35a5fb2e4e6a58a4c83b6
+  data.tar.gz: ed0b241f30ae93ea79f8d4deae9ca1f33dd14c124698484c79ea9905e42149564487bbad18234f704125185b0583f7a740c76817eaa2c522b28fa2f3dce20240

data/ext/yeptris_native/cbor_ruby.c

@@ -17,6 +17,14 @@
 #include <stdlib.h>
 #include <string.h>
 
+static rb_encoding* cr_utf8_enc;
+
+/* Map keys repeat across records in CBOR corpora; interning shares one
+ * VALUE per distinct key (the json_ruby.c on_key pattern, #157). */
+static VALUE cr_key_str(const char* p, size_t len) {
+    return rb_enc_interned_str(p, (long)len, cr_utf8_enc);
+}
+
 #include "dom/dom.h"
 #include "doc.h" /* the public YeptrisDocument wrapper: ->dom */
 #include <yeptris/cbor.h>
@@ -91,8 +99,17 @@ static VALUE cr_walk(const yep_dom* d, uint32_t id) {
         VALUE h = HASH_NEW_CAPA(pairs);
         uint32_t c = n->first_child;
         for (long i = 0; i < pairs && c != UINT32_MAX; i++) {
-            VALUE k = cr_walk(d, c);
-            c = d->nodes[c].next_sibling;
+            VALUE k;
+            const yep_dnode* kn = &d->nodes[c];
+            if (kn->kind == YEP_DOM_SCALAR && kn->tag_id == YEPTRIS_TAG_STR) {
+                uint32_t klen = 0;
+                const char* kp = cr_view(d, kn->value, &klen);
+                k = cr_key_str(kp, klen);
+                c = kn->next_sibling;
+            } else {
+                k = cr_walk(d, c);
+                c = d->nodes[c].next_sibling;
+            }
             VALUE v = (c != UINT32_MAX) ? cr_walk(d, c) : Qnil;
             if (c != UINT32_MAX) {
                 c = d->nodes[c].next_sibling;
@@ -107,6 +124,9 @@ static VALUE cr_walk(const yep_dom* d, uint32_t id) {
 }
 
 VALUE yep_rb_cbor_load(const char* p, size_t len, int strict) {
+    if (cr_utf8_enc == NULL) {
+        cr_utf8_enc = rb_utf8_encoding();
+    }
     YeptrisStatus st = YEPTRIS_OK;
     /* the DOM borrows the input buffer zero-copy; the walk ALLOCATES,
      * and a GC compaction mid-walk moves the caller's String — the

data/ext/yeptris_native/yeptris_native.c

@@ -423,8 +423,51 @@ static VALUE native_gc_mode_set(VALUE self, VALUE mode) {
     return mode;
 }
 
+/* ABI-drift self-check (the #157-audit silent-nil class): the bundle
+ * is compiled against a specific yep_dom layout; engine drift makes
+ * the walkers read fields at stale offsets — cbor_load returned NIL
+ * on valid CBOR in the dev-checkout audit, with no error anywhere.
+ * Both walkers must round-trip a known document at load, or Init
+ * raises LoadError: lib/yeptris.rb's existing rescue falls back to
+ * the FFI ladder (loudly), and the stale bundle never answers with
+ * garbage. Runs inside rb_protect so a drifted walk raises instead of
+ * crashing the load. */
+static VALUE native_self_check_body(VALUE unused) {
+    /* JSON: {"a"=>[1, 2.5, "x", true, nil]} */
+    const char* json = "{\"a\":[1,2.5,\"x\",true,null]}";
+    VALUE j = yep_rb_parse_json(json, strlen(json), 0);
+    if (j == Qundef || !RB_TYPE_P(j, T_HASH)) return Qfalse;
+    VALUE a = rb_hash_lookup(j, rb_str_new_cstr("a"));
+    if (!RB_TYPE_P(a, T_ARRAY) || RARRAY_LEN(a) != 5) return Qfalse;
+    if (!RB_INTEGER_TYPE_P(rb_ary_entry(a, 0))) return Qfalse;
+    if (!RB_FLOAT_TYPE_P(rb_ary_entry(a, 1))) return Qfalse;
+    if (!RB_TYPE_P(rb_ary_entry(a, 2), T_STRING)) return Qfalse;
+    if (rb_ary_entry(a, 3) != Qtrue || !NIL_P(rb_ary_entry(a, 4))) return Qfalse;
+
+    /* CBOR: A1 61 6B 01 = {"k" => 1} (canonical, hand-encoded) */
+    const char cbor[] = "\xA1\x61\x6B\x01";
+    VALUE c = yep_rb_cbor_load(cbor, sizeof(cbor) - 1, 0);
+    if (c == Qundef || !RB_TYPE_P(c, T_HASH)) return Qfalse;
+    VALUE one = rb_hash_lookup(c, rb_str_new_cstr("k"));
+    if (!RB_INTEGER_TYPE_P(one) || !rb_eql(one, INT2FIX(1))) return Qfalse;
+    return Qtrue;
+}
+
+static void native_self_check(void) {
+    int state = 0;
+    VALUE ok = rb_protect(native_self_check_body, Qnil, &state);
+    if (state != 0 || ok != Qtrue) {
+        if (state != 0) rb_set_errinfo(Qnil);
+        rb_raise(rb_eLoadError,
+                 "yeptris: native materializer failed its ABI self-check "
+                 "(stale build against a drifted engine?) — refusing to "
+                 "register; the FFI ladder will carry the load");
+    }
+}
+
 RUBY_FUNC_EXPORTED void Init_native(void) {
     utf8_enc = rb_utf8_encoding();
+    native_self_check();
     VALUE mYep = rb_define_module("Yeptris");
     VALUE mNat = rb_define_module_under(mYep, "Native");
     rb_define_singleton_method(mNat, "load_json", native_load_json, -1);

data/lib/yeptris/document.rb

@@ -8,6 +8,11 @@ class Yeptris::Document
   # explicit free path and the finalizer both flip the same flag.
   Freed = Struct.new(:state) # :alive | :freed
 
+  # The raw C handle — the Yeptris::Node wrappers cache by its
+  # address; stream-children wrappers (Document.without_finalizer)
+  # carry it without registering a finalizer (#182).
+  attr_reader :c_ptr
+
   # The schema this document was parsed with (a parse property).
   attr_reader :parse_schema
 
@@ -80,6 +85,18 @@ class Yeptris::Document
     new(c_ptr, Freed.new(:alive), schema)
   end
 
+  # #182: the stream-children wrapper owns NOTHING (the parent
+  # Document wrapper is the sole freer of the C memory). A plain
+  # Document.new would register a finalizer on a c_ptr we don't own;
+  # a parse_stream on a multi-doc stream would free the same pointer
+  # three times at GC → SIGABRT. This factory builds the wrapper
+  # WITHOUT a finalizer; the wrapper's lifetime follows the owner.
+  def self.without_finalizer(c_ptr)
+    doc = new(c_ptr)
+    ObjectSpace.undefine_finalizer(doc)
+    doc
+  end
+
   def ensure_alive!
     raise Yeptris::FreedError, "document is freed" if @freed.state == :freed
   end

data/lib/yeptris/json.rb

@@ -119,7 +119,7 @@ module Yeptris
       end
     end
 
-    def walk_tape(src, tape)
+    def walk_tape(src, tape, strict_dup = STRICT_DUPLICATE_KEYS)
       n = tape[:count]
       kinds = tape[:kinds].read_bytes(n).unpack("C*")
       offs = tape[:offs].read_bytes(n * 4).unpack("V*")
@@ -139,7 +139,7 @@ module Yeptris
 
       docs = [nil] # record 0 (DOC) pre-consumed — the root's slot
       stack = []
-      key_sets = STRICT_DUPLICATE_KEYS ? [{}] : nil
+      key_sets = strict_dup ? [{}] : nil
       pending_key = nil
       i = 1
       while i < n
@@ -152,8 +152,12 @@ module Yeptris
           place(docs, stack, pending_key) { {} }
           pending_key = nil
         when T_CLOSE
+          # Key frames are pushed per MAP_OPEN — an ARRAY close must
+          # not pop the enclosing map's frame (issue found by ea's CI:
+          # {"a":[1],"b":[2],"c":[3]} exhausted the frames and the next
+          # map key hit key_sets.last.key? on nil under strict mode).
+          key_sets&.pop if stack.last.is_a?(Hash)
           stack.pop
-          key_sets&.pop
         when T_STR
           # empty-string literals are frozen+shared since Ruby 3.4
           # (and `+""` binds after the method chain anyway), so the
@@ -256,8 +260,8 @@ module Yeptris
           place(docs, stack, pending_key) { {} }
           pending_key = nil
         when ValueML::CLOSE
+          key_sets&.pop if stack.last.is_a?(Hash)
           stack.pop
-          key_sets&.pop
         when ValueML::V_STR
           text = arena.byteslice(offs[i], lens[i])
           if ikeys[i] == 1 && !stack.empty? && stack.last.is_a?(Hash)

data/lib/yeptris/psych/class_loader.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require "date"
+
+module Yeptris
+  module Psych
+    # The minimal ClassLoader face the ScalarScanner port drives
+    # (stdlib's loader resolves through the class hierarchy; the
+    # scanner only needs the date class and symbolize).
+    class ClassLoader
+      def date
+        Date
+      end
+
+      def symbolize str
+        str.to_sym
+      end
+
+      def load name
+        Object.const_get(name)
+      end
+    end
+  end
+end

data/lib/yeptris/psych/scalar_scanner.rb

@@ -0,0 +1,149 @@
+# frozen_string_literal: true
+
+require "date"
+
+module Yeptris
+  module Psych
+    ###
+    # Scan scalars for built in types — the stdlib Psych::ScalarScanner
+    # port (#179): same regexes, same precedence, same edge verdicts.
+    # The load path types through the C resolver; this class is the
+    # standalone API stdlib code (and Psych's own tests) drive directly.
+    class ScalarScanner
+      # Taken from http://yaml.org/type/timestamp.html
+      TIME = /^-?\d{4}-\d{1,2}-\d{1,2}(?:[Tt]|\s+)\d{1,2}:\d\d:\d\d(?:\.\d*)?(?:\s*(?:Z|[-+]\d{1,2}:?(?:\d\d)?))?$/
+
+      # Taken from http://yaml.org/type/float.html
+      # Base 60, [-+]inf and NaN are handled separately
+      FLOAT = /^(?:[-+]?([0-9][0-9_,]*)?\.[0-9]*([eE][-+][0-9]+)?(?# base 10))$/x
+
+      # Taken from http://yaml.org/type/int.html and modified to ensure at least one numerical symbol exists
+      INTEGER_STRICT = /^(?:[-+]?0b[_]*[0-1][0-1_]*             (?# base 2)
+                           |[-+]?0[_]*[0-7][0-7_]*              (?# base 8)
+                           |[-+]?(0|[1-9][0-9_]*)               (?# base 10)
+                           |[-+]?0x[_]*[0-9a-fA-F][0-9a-fA-F_]* (?# base 16))$/x
+
+      # Same as above, but allows commas.
+      # Not to YML spec, but kept for backwards compatibility
+      INTEGER_LEGACY = /^(?:[-+]?0b[_,]*[0-1][0-1_,]*                (?# base 2)
+                           |[-+]?0[_,]*[0-7][0-7_,]*                 (?# base 8)
+                           |[-+]?(?:0|[1-9](?:[0-9]|,[0-9]|_[0-9])*) (?# base 10)
+                           |[-+]?0x[_,]*[0-9a-fA-F][0-9a-fA-F_,]*    (?# base 16))$/x
+
+      BOOLEAN_TRUE  = /^(yes|true|on)$/i
+      BOOLEAN_FALSE = /^(no|false|off)$/i
+
+      attr_reader :class_loader
+
+      # Create a new scanner
+      def initialize class_loader = ClassLoader, strict_integer: false, parse_symbols: true
+        @symbol_cache = {}
+        @class_loader = class_loader
+        @strict_integer = strict_integer
+        @parse_symbols = parse_symbols
+      end
+
+      # Tokenize +string+ returning the Ruby object
+      def tokenize string
+        return nil if string.empty?
+        return @symbol_cache[string] if @symbol_cache.key?(string)
+        integer_regex = @strict_integer ? INTEGER_STRICT : INTEGER_LEGACY
+        # Check for a String type, being careful not to get caught by hash keys, hex values, and
+        # special floats (e.g., -.inf).
+        if string.match?(%r{^[^\d.:-]?[[:alpha:]_\s!@#$%\^&*(){}<>|/\\~;=]+}) || string.match?(/\n/)
+          return string if string.length > 5
+
+          if string.match?(/^[^ytonf~]/i)
+            string
+          elsif string == '~' || string.match?(/^null$/i)
+            nil
+          elsif string.match?(BOOLEAN_TRUE)
+            true
+          elsif string.match?(BOOLEAN_FALSE)
+            false
+          else
+            string
+          end
+        elsif string.match?(TIME)
+          begin
+            parse_time string
+          rescue ArgumentError
+            string
+          end
+        elsif string.match?(/^\d{4}-(?:1[012]|0\d|\d)-(?:[12]\d|3[01]|0\d|\d)$/)
+          begin
+            class_loader.date.strptime(string, '%F', Date::GREGORIAN)
+          rescue ArgumentError
+            string
+          end
+        elsif string.match?(/^\+?\.inf$/i)
+          Float::INFINITY
+        elsif string.match?(/^-\.inf$/i)
+          -Float::INFINITY
+        elsif string.match?(/^\.nan$/i)
+          Float::NAN
+        elsif @parse_symbols && string.match?(/^:./)
+          if string =~ /^:(["'])(.*)\1/
+            @symbol_cache[string] = class_loader.symbolize($2.sub(/^:/, ''))
+          else
+            @symbol_cache[string] = class_loader.symbolize(string.sub(/^:/, ''))
+          end
+        elsif string.match?(/^[-+]?[0-9][0-9_]*(:[0-5]?[0-9]){1,2}$/)
+          i = 0
+          string.split(':').each_with_index do |n, e|
+            i += (n.to_i * 60**(e - 2).abs)
+          end
+          i
+        elsif string.match?(/^[-+]?[0-9][0-9_]*(:[0-5]?[0-9]){1,2}\.[0-9_]*$/)
+          i = 0
+          string.split(':').each_with_index do |n, e|
+            i += (n.to_f * 60**(e - 2).abs)
+          end
+          i
+        elsif string.match?(FLOAT)
+          if string.match?(/\A[-+]?\.\Z/)
+            string
+          else
+            Float(string.delete(',_').gsub(/\.([Ee]|$)/, '\1'))
+          end
+        elsif string.match?(integer_regex)
+          parse_int string
+        else
+          string
+        end
+      end
+
+      # Parse and return an int from +string+
+      def parse_int string
+        Integer(string.delete(',_'))
+      end
+
+      ###
+      # Parse and return a Time from +string+
+      def parse_time string
+        date, time = *(string.split(/[Tt]|\s+/, 2))
+        (yy, m, dd) = date.match(/^(-?\d{4})-(\d{1,2})-(\d{1,2})/).captures.map { |x| x.to_i }
+        md = time.match(/(\d+:\d+:\d+)(?:\.(\d*))?\s*(Z|[-+]\d+(:\d\d)?)?/)
+
+        (hh, mm, ss) = md[1].split(':').map { |x| x.to_i }
+        us = (md[2] ? Rational("0.#{md[2]}") : 0) * 1_000_000
+
+        time = Time.utc(yy, m, dd, hh, mm, ss, us)
+
+        return time if 'Z' == md[3]
+        return Time.at(time.to_i, us) unless md[3]
+
+        tz = md[3].match(/^([+\-]?\d{1,2})\:?(\d{1,2})?$/)[1..-1].compact.map { |digit| Integer(digit, 10) }
+        offset = tz.first * 3600
+
+        if offset < 0
+          offset -= ((tz[1] || 0) * 60)
+        else
+          offset += ((tz[1] || 0) * 60)
+        end
+
+        Time.new(yy, m, dd, hh, mm, ss + us / 1_000_000r, offset)
+      end
+    end
+  end
+end

data/lib/yeptris/psych.rb

@@ -22,6 +22,9 @@ require "yeptris"
 # document without materializing.
 module Yeptris
   module Psych
+    autoload :ClassLoader, "yeptris/psych/class_loader"
+    autoload :ScalarScanner, "yeptris/psych/scalar_scanner"
+
     # The tag registries (Psych's class-level API, #95 bug 4):
     # load_tags maps a serialized tag to the Class that revives it;
     # dump_tags overrides the emitted tag for a Class. Consulted by
@@ -258,18 +261,28 @@ module Yeptris
         ::Yeptris::Psych.dump(obj, io, options)
       end
 
-      def load_stream(yaml, **kwargs)
+      def load_stream(yaml, **kwargs, &block)
         # materialize each document's root directly — the stream
         # children share one C document, so their handles would all
-        # resolve to the first document's tree
+        # resolve to the first document's tree. stdlib's block form
+        # yields each loaded document's object (#179 round 4).
         doc = Yeptris::Document.parse(yaml, schema: :compat_11)
         return nil if doc.nil? # the legal empty stream
 
         begin
-          (0...doc.document_count).map { |i| doc.root(i).to_ruby }
+          docs = (0...doc.document_count).map { |i| doc.root(i).to_ruby }
         ensure
           doc.free
         end
+        docs.each { |d| block.call(d) } if block
+        docs
+      end
+
+      # safe_load_stream: stdlib's surface — the stream form of
+      # safe_load. Our load_stream is already safe-by-default
+      # (Psych 5 semantics), so this is the yielding wrapper.
+      def safe_load_stream(yaml, **kwargs, &block)
+        load_stream(yaml, **kwargs, &block)
       end
 
       # The first document's node tree (no Ruby materialization).
@@ -291,13 +304,22 @@ module Yeptris
         raise SyntaxError.from_parse_error(e)
       end
 
-      def parse_stream(yaml)
+      def parse_stream(yaml, &block)
+        # stdlib yields each document to a block if one was given (and
+        # the stream it returns holds the same children either way).
+        # #182: the wrapper is the sole owner of the C memory — the
+        # stream merely REFERENCES it; the wrapper's own finalizer
+        # handles GC-free. (The block-yielding form is tracked under
+        # #179: the current implementation materializes eagerly; the
+        # block is only honored as a no-op convenience.)
         doc = Yeptris::Document.parse(yaml, schema: :compat_11)
         return nil if doc.nil? || doc.document_count.zero?
 
         stream = Nodes::Stream.new
         (0...doc.document_count).each do |i|
-          stream.children << Nodes::Builder.document_stream_child(doc, i)
+          child = Nodes::Builder.document_stream_child(doc, i)
+          stream.children << child
+          block.call(child) if block # stdlib's yielding form (#179 round 4)
         end
         # ownership: the DOCUMENT wrapper is the sole owner — its own
         # finalizer (pointer-only closure) frees the C memory; the
@@ -308,6 +330,8 @@ module Yeptris
       rescue Yeptris::ParseError => e
         raise SyntaxError.from_parse_error(e)
       ensure
+        # the returned stream OWNS the doc's lifetime (its free delegates
+        # to the owner); only free here when the stream wasn't built
         doc&.free if doc && !stream
       end
 
@@ -440,6 +464,10 @@ module Yeptris
       # tree stay valid while the tree is reachable; a GC finalizer
       # releases the C memory when it is not.
       class Document < Node
+          # The document's root as a Ruby object (the stream-yield face).
+          def to_ruby
+            children.first&.to_ruby
+          end
         attr_reader :version, :tags
 
         def initialize(version = [], tags = {})
@@ -522,8 +550,12 @@ module Yeptris
         # stream owns the yeptris document)
         def document_stream_child(doc, index)
           root = doc.root(index)
-          d = Document.new
-          d.handle = root&.document
+          # #182's root cause: three per-stream Document wrappers all
+          # capture the same c_ptr in their finalizers → three frees.
+          # The stream-children WRAPPER owns nothing (the owner wrapper
+          # is the real Document; this one just references it). Build
+          # a non-owning wrapper with no finalizer.
+          d = Document.send(:new, root&.document, false)
           d.children << node(root) if root
           d
         end

data/lib/yeptris/schema.rb

@@ -66,6 +66,92 @@ module Yeptris
       end
     end
 
+    # #184 (lutaml-model KV path): zip Schema columns into record
+    # hashes ready for Serializable.instantiate. Mapping root → one
+    # hash; sequence-of-mappings → one hash per element; nested
+    # mappings → nested hashes. Returns Array<Hash> always. when_attribute
+    # / polymorphic stay out of scope (interpretive fallback).
+    def load_records(source, schema: :core_12, desc:, capacity: 64)
+      cols = load(source, schema: schema, desc: desc, capacity: capacity)
+      zip_records(desc, cols)
+    end
+
+    def zip_records(desc, cols)
+      root = desc[0] || {}
+      case root[:kind]
+      when :sequence
+        child_start = root[:child_index] || 1
+        child_count = root[:child_count] || 0
+        return [] if child_count.zero?
+
+        child = desc[child_start]
+        if child && child[:kind] == :mapping
+          field_start = child[:child_index] || (child_start + 1)
+          field_count = child[:child_count] || 0
+          fields = desc[field_start, field_count] || []
+          field_cols = cols[field_start, field_count] || []
+          nrows = field_cols.map(&:length).max || 0
+          Array.new(nrows) do |r|
+            h = {}
+            fields.each_with_index do |f, i|
+              next unless f[:wire_name]
+              col = field_cols[i] || []
+              # ABSENT keys are OMITTED, not nil-filled (lutaml-model's
+              # load-bearing edge: absent seeds defaults +
+              # using_default?; explicit nil is a present value with
+              # different render semantics). The C columns fill in
+              # document order — col.length > r means present.
+              next if col.length <= r
+
+              h[f[:wire_name].to_sym] = materialize_field(f, desc, cols, col[r])
+            end
+            h
+          end
+        else
+          (cols[child_start] || []).map { |v| { value: v } }
+        end
+      when :mapping
+        field_start = root[:child_index] || 1
+        field_count = root[:child_count] || 0
+        fields = desc[field_start, field_count] || []
+        field_cols = cols[field_start, field_count] || []
+        h = {}
+        fields.each_with_index do |f, i|
+          next unless f[:wire_name]
+          col = field_cols[i] || []
+          next if col.empty? # absent: omitted, not nil-filled (#184)
+
+          h[f[:wire_name].to_sym] = materialize_field(f, desc, cols, col[0])
+        end
+        [h]
+      else
+        [{ value: cols[0]&.first }]
+      end
+    end
+    private_class_method :zip_records
+
+    def materialize_field(field, desc, cols, cell)
+      case field[:kind]
+      when :mapping
+        start = field[:child_index] || 0
+        count = field[:child_count] || 0
+        return nil if count.zero? || cell.nil?
+
+        nested = {}
+        desc[start, count]&.each_with_index do |nf, i|
+          next unless nf[:wire_name]
+          ncol = cols[start + i] || []
+          nested[nf[:wire_name].to_sym] = ncol.is_a?(Array) ? (ncol[0] rescue cell) : cell
+        end
+        nested
+      when :sequence
+        cell.is_a?(Array) ? cell : Array(cell)
+      else
+        cell
+      end
+    end
+    private_class_method :materialize_field
+
     def compile(desc)
       desc.map do |n|
         { kind: KIND.fetch(n.fetch(:kind)),

data/lib/yeptris.rb

@@ -3,7 +3,7 @@
 module Yeptris
   # The gem's version lives in the parent namespace's file — the last
   # internal require (yeptris/version) retired with it.
-  VERSION = "0.6.15.2".freeze
+  VERSION = "0.6.16.2".freeze
   # The error hierarchy lives in THIS file (the parent namespace's
   # own file): nested constants do not trigger a parent-constant
   # autoload, and the law forbids internal requires — defining the

data/vendor/libyeptris/CMakeLists.txt

@@ -3,7 +3,7 @@
 cmake_minimum_required(VERSION 3.20)
 
 project(yeptris
-    VERSION 0.6.15
+    VERSION 0.6.16
     DESCRIPTION "Ultra-fast YAML 1.2 parser, emitter and streamer in C"
     LANGUAGES C CXX
 )

data/vendor/libyeptris/src/yeptris/dom/dom.c

@@ -241,6 +241,9 @@ void dom_link(yep_dom* d, uint32_t parent, uint32_t child) {
     }
     p->last_child = child;
     p->count++;
+    /* every link changes SOME container's child list (#377's cache) */
+    d->child_cache_id = UINT32_MAX;
+    d->child_cache_len = 0;
 }
 
 /* ---- mutation side tables (64-2a) ---- */
@@ -485,6 +488,9 @@ yep_dom* yep_dom_create(const yep_allocator* sys) {
      * document that decode-only consumers (CBOR load, serialize, free)
      * never touch; yep_dom_handles() materializes it on first use */
     d->handles = NULL;
+    d->child_cache = NULL;
+    d->child_cache_id = UINT32_MAX;
+    d->child_cache_len = 0;
     if (yep_mutex_init(&d->midx.mu) != 0) {
         yep_pool_destroy(pool);
         yep_free(sys, d);
@@ -513,6 +519,69 @@ struct yep_hpool* yep_dom_handles(yep_dom* d) {
     return h;
 }
 
+/* #377 (ruby #168): seq_at/map_at were O(i) sibling walks — the
+ * bindings' per-element loops made an 80k-row sequence quadratic
+ * (the relaton index: 238-328s where stdlib takes ~3s). The bulk
+ * drain (yeptris_node_children) fixed the bindings; THIS fixes the
+ * accessor: the last indexed container's child ids cache under the
+ * lazy-init mutex, O(1) after the first call. Invalidated by every
+ * child-list mutation (dom_invalidate_child_cache). */
+void dom_invalidate_child_cache(yep_dom* d) {
+    if (d == NULL) {
+        return;
+    }
+    d->child_cache_id = UINT32_MAX;
+    d->child_cache_len = 0;
+}
+
+/* Returns child id at index (UINT32_MAX when out of range); the
+ * container's child count rides *count_out. */
+uint32_t dom_indexed_child(yep_dom* d, uint32_t cid, size_t index, uint32_t* count_out) {
+    const yep_dnode* n = yep_dom_node(d, cid);
+    if (n == NULL) {
+        *count_out = 0;
+        return UINT32_MAX;
+    }
+    *count_out = n->count;
+    if (d->child_cache_id == cid) {
+        if (index < d->child_cache_len) {
+            return d->child_cache[index];
+        }
+        return UINT32_MAX;
+    }
+    /* miss: build once under the lazy-init mutex (Threads.
+     * ReadOnlySharing — concurrent first calls race here exactly like
+     * the handle pool's) */
+    yep_mutex_lock(&d->midx.mu);
+    if (d->child_cache_id != cid) {
+        yep_free(d->sys, d->child_cache);
+        d->child_cache = NULL;
+        d->child_cache_len = 0;
+        if (n->count > 0) {
+            uint32_t* arr = yep_alloc(d->sys, n->count * sizeof(uint32_t));
+            if (arr != NULL) {
+                uint32_t k = 0;
+                for (uint32_t id = n->first_child; id != UINT32_MAX && k < n->count;) {
+                    const yep_dnode* cn = yep_dom_node(d, id);
+                    if (cn == NULL) {
+                        break;
+                    }
+                    arr[k++] = id;
+                    id = cn->next_sibling;
+                }
+                d->child_cache = arr;
+                d->child_cache_len = k;
+            }
+        }
+        d->child_cache_id = cid;
+    }
+    yep_mutex_unlock(&d->midx.mu);
+    if (index < d->child_cache_len) {
+        return d->child_cache[index];
+    }
+    return UINT32_MAX;
+}
+
 void yep_dom_destroy(yep_dom* d) {
     if (d == NULL) {
         return;
@@ -523,6 +592,7 @@ void yep_dom_destroy(yep_dom* d) {
     yep_free(d->sys, d->mut_att);
     yep_free(d->sys, d->mut_depth);
     yep_hpool_destroy(d->handles);
+    yep_free(d->sys, d->child_cache);
     yep_pool_destroy(d->pool);
     yep_free(d->sys, d);
 }

data/vendor/libyeptris/src/yeptris/dom/dom.h

@@ -114,6 +114,13 @@ typedef struct yep_dom {
      * YeptrisNode wrappers here, so read-only document sharing across
      * threads is safe; parse-path pools stay single-threaded */
     struct yep_hpool* handles;
+    /* #377: the lazy indexed-children cache — child ids of the LAST
+     * container indexed via seq_at/map_at. Built once per container
+     * under the lazy-init mutex (read-only sharing), O(1) after;
+     * invalidated by every child-list mutation. NULL when idle. */
+    uint32_t* child_cache;
+    uint32_t child_cache_id; /* UINT32_MAX = empty */
+    uint32_t child_cache_len;
     yep_dnode* nodes;
     uint32_t ncount, ncap;
     uint32_t* docs; /* document root node ids */
@@ -200,6 +207,9 @@ void dom_mut_set_depth(yep_dom* d, uint32_t id, uint16_t depth);
 struct yep_hpool* yep_hpool_create(const yep_allocator* sys);
 /* Lazy handle-pool acquisition (#157): NULL dom or OOM stays NULL. */
 struct yep_hpool* yep_dom_handles(yep_dom* d);
+/* #377: the lazy indexed-children cache (seq_at/map_at's O(1) leg) */
+void dom_invalidate_child_cache(yep_dom* d);
+uint32_t dom_indexed_child(yep_dom* d, uint32_t cid, size_t index, uint32_t* count_out);
 void yep_hpool_destroy(struct yep_hpool* p);
 void* yep_hpool_alloc(struct yep_hpool* p, size_t size, size_t align);
 

data/vendor/libyeptris/src/yeptris/dom/mutate.c

@@ -268,6 +268,8 @@ static int unlink_child(yep_dom* d, uint32_t parent, uint32_t child) {
             p->last_child = c;
         }
     }
+    d->child_cache_id = UINT32_MAX; /* #377: the list changed */
+    d->child_cache_len = 0;
     d->nodes[child].next_sibling = UINT32_MAX;
     dom_mut_set_att(d, child, 0);
     p->count--;

data/vendor/libyeptris/src/yeptris/parse.c

@@ -646,11 +646,12 @@ YEPTRIS_API YeptrisNode yeptris_node_seq_at(YeptrisNode handle, size_t index) {
     if (n == NULL || n->kind != YEP_DOM_SEQUENCE || index >= n->count) {
         return NULL;
     }
-    const yep_dom* dom = ((yeptris_node*)handle)->doc->dom;
-    uint32_t id = n->first_child;
-    for (size_t i = 0; i < index && id != UINT32_MAX; i++) {
-        const yep_dnode* cur = yep_dom_node(dom, id);
-        id = cur ? cur->next_sibling : UINT32_MAX;
+    yep_dom* dom = ((yeptris_node*)handle)->doc->dom;
+    uint32_t count = 0;
+    /* the node id IS its dnode index */
+    uint32_t id = dom_indexed_child(dom, ((yeptris_node*)handle)->id, index, &count); /* #377 */
+    if (id == UINT32_MAX) {
+        return NULL;
     }
     return wrap((yeptris_node*)handle, id);
 }
@@ -685,10 +686,11 @@ YEPTRIS_API int yeptris_node_map_at(YeptrisNode handle, size_t index, YeptrisNod
         return -1;
     }
     yeptris_node* h = (yeptris_node*)handle;
-    const yep_dom* d = h->doc->dom;
-    uint32_t child = n->first_child;
-    for (size_t i = 0; i < index * 2; i++) {
-        child = d->nodes[child].next_sibling; /* pairs are key,value,… */
+    yep_dom* d = h->doc->dom;
+    uint32_t count = 0;
+    uint32_t child = dom_indexed_child(d, h->id, (size_t)index * 2, &count); /* #377 */
+    if (child == UINT32_MAX) {
+        return -1;
     }
     if (key != NULL) {
         *key = wrap(h, child);

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yeptris
 version: !ruby/object:Gem::Version
-  version: 0.6.15.2
+  version: 0.6.16.2
 platform: aarch64-linux
 authors:
 - Ribose Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-21 00:00:00.000000000 Z
+date: 2026-09-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -50,11 +50,13 @@ files:
 - lib/yeptris/native-3.3.so
 - lib/yeptris/node.rb
 - lib/yeptris/psych.rb
+- lib/yeptris/psych/class_loader.rb
 - lib/yeptris/psych/coder_shim.rb
 - lib/yeptris/psych/drop_in.rb
 - lib/yeptris/psych/encodable.rb
 - lib/yeptris/psych/handler.rb
 - lib/yeptris/psych/parser.rb
+- lib/yeptris/psych/scalar_scanner.rb
 - lib/yeptris/psych/visitors.rb
 - lib/yeptris/schema.rb
 - lib/yeptris/valueml.rb