teptris 0.2.26-aarch64-linux → 0.2.30-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9015612a2cef8cc7e6cb87507211d38ae526d92a446a0dcb5d21f6c9ffc7a389
-  data.tar.gz: ff9036e1a2725b3405618325506ef508f87c7b1bb92049ff1587ea746f6a2748
+  metadata.gz: '059989b3fe2865a88701cd0f3fa6017e6a7d1858d9f1f4acb92b775a6678002b'
+  data.tar.gz: 83c5727792a555111b7e9d8fe48d3250022b5b8fed521930973f57b4c60f5add
 SHA512:
-  metadata.gz: c6c01d4de20806279f9831c8976bd9b46d3a4296cbfbab723c7e51fdccc944b0d221f9e1fc503d8d31821168caac3bac8bbb8a6adb82ebbbaf86b3998a5372af
-  data.tar.gz: fcff4cab03a7673b1d43ef70e05a8209fde11b1793aa10933debfc699bf765c6d3dc06df7e9c3c8197842268f8f9bb792f8c978b7756956e0d92f135452cdeb3
+  metadata.gz: 5bc284eabb37a3f900fae5acb85f4ab84e7400d28bc2bfc1088cd3744026c310dfc2feba6bcb547ad285976897ea3109f2323bf14b5f94683f217a0c3c4300ba
+  data.tar.gz: 8e3395e4e6543dea2d6dd0409bd8caa4768bad3a8c21298874b5c2e5f3f17ae6a616e7737cf32ea28aee4a8c34e4996b35d5f399dd5d9c927c14bb0af64a1e95

data/lib/teptris/descriptor.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+# Tree-shaped schema-descriptor materialization (teptris#46, mirroring
+# leptris v1): compile a plan tree once, then materialize a whole TOML
+# subtree against it in ONE native pass — unplanned keys are never
+# materialized.
+#
+#   descriptor = Teptris::Descriptor.build(
+#     children: [
+#       { name: "name", kind: :scalar },
+#       { name: "port", kind: :scalar },
+#       { name: "hosts", kind: :collection },
+#       { name: "items", kind: :nested, plan: {
+#           children: [{ name: "id", kind: :scalar }] } },
+#       { name: "everything_else", kind: :raw },
+#     ])
+#   descriptor.walk(toml_string)  # => { "name" => "svc", ... }
+#
+# Row kinds: :scalar (any TOML value), :collection (array of scalars),
+# :nested (recurse via +plan:+; also spans arrays of tables), :raw
+# (the untouched native subtree). Rows absent from the document read
+# as nil.
+class Teptris::Descriptor
+  KINDS = { scalar: 1, collection: 2, nested: 3, raw: 4 }.freeze
+  private_constant :KINDS
+
+  attr_reader :rows, :first_row
+
+  def self.build(tree)
+    # Pre-order plan numbering (root = plan 0) with each plan's rows
+    # assigned a DISJOINT reserved range. Interleaved appending leaks
+    # siblings that follow a :nested child into the sub-plan's range —
+    # the 0.2.29 bug (every array-of-tables element grew stray nil
+    # rows).
+    plans = []
+    index_of = {}
+    collect = lambda do |t|
+      unless index_of.key?(t.object_id)
+        index_of[t.object_id] = plans.length
+        plans << t
+      end
+      (t[:children] || []).each do |ch|
+        collect.call(ch[:plan]) if KINDS.fetch(ch[:kind]) == 3
+      end
+    end
+    collect.call(tree)
+
+    first_row = [0]
+    plans.each { |t| first_row << first_row[-1] + (t[:children] || []).length }
+    rows = Array.new(first_row[-1])
+    plans.each_with_index do |t, i|
+      (t[:children] || []).each_with_index do |ch, j|
+        kind = KINDS.fetch(ch[:kind])
+        sub = kind == 3 ? index_of[ch[:plan].object_id] : 0
+        rows[first_row[i] + j] = [ch[:name].to_s, kind, sub]
+      end
+    end
+
+    d = allocate
+    d.instance_variable_set(:@rows, rows.freeze)
+    d.instance_variable_set(:@first_row, first_row.freeze)
+    d.instance_variable_set(:@handle,
+                            TeptrisExt.plan_build(rows, first_row))
+    d.freeze
+  end
+
+  def walk(toml)
+    TeptrisExt.plan_emit(@handle, toml)
+  end
+end

data/lib/teptris/toml.rb

@@ -36,13 +36,16 @@ module Teptris
         TeptrisExt.load(toml, opts)
       end
 
-      # Reserved: fused descriptor materialization, the same descriptor
-      # shape as leptris/yeptris#238 — see docs/DESCRIPTOR_ABI.md.
+      # One-pass schema materialization over a compiled
+      # Teptris::Descriptor: unplanned keys are never materialized
+      # (teptris#46).
       def load_schema(toml, descriptor)
-        raise Error,
-              "descriptor materialization lands with the co-designed " \
-              "ABI (leptris/yeptris#238); entry point is reserved — " \
-              "see docs/DESCRIPTOR_ABI.md (descriptor #{descriptor.class})"
+        unless descriptor.is_a?(Teptris::Descriptor)
+          raise ArgumentError,
+                "descriptor must be a Teptris::Descriptor (use " \
+                "Teptris::Descriptor.build), got #{descriptor.class}"
+        end
+        descriptor.walk(toml)
       end
 
       def engine_version

data/lib/teptris/version.rb

@@ -1,3 +1,3 @@
 module Teptris
-  VERSION = "0.2.26"
+  VERSION = "0.2.30"
 end

data/lib/teptris.rb

@@ -2,6 +2,7 @@ require "date"
 
 require_relative "teptris/version"
 require_relative "teptris/error"
+require_relative "teptris/descriptor"
 require_relative "teptris/toml"
 
 # Windows ucrt rubies name their DLL per minor (x64-ucrt-ruby330.dll), so

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: teptris
 version: !ruby/object:Gem::Version
-  version: 0.2.26
+  version: 0.2.30
 platform: aarch64-linux
 authors:
 - teptris contributors
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-16 00:00:00.000000000 Z
+date: 2026-09-17 00:00:00.000000000 Z
 dependencies: []
 description: An FFI binding over libteptris, a C11 TOML 1.0 parser/emitter. API shape
   mirrors the tomlib gem.
@@ -18,6 +18,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/teptris.rb
+- lib/teptris/descriptor.rb
 - lib/teptris/error.rb
 - lib/teptris/toml.rb
 - lib/teptris/version.rb