teptris 0.2.25-aarch64-linux → 0.2.29-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d901942963661a7e6be8be9d98d5bb527ee92965364602718b78161f28746539
-  data.tar.gz: 63e47c7ec54a0ba59cba210885fcdfa88c2e93120a8480430ab673e5f1d5825b
+  metadata.gz: 477a02cb5a2389ff022cbb1b6589e4a684b11b29836afac63e6e9e6e85bc622f
+  data.tar.gz: 057a9b7e89921edc84147357d44d8844155a9e79a1fc54f84a9151a9ac32bc12
 SHA512:
-  metadata.gz: 6ccbd464be1f97223b3962ccd6170dee5eb1fa675492f91fc703f5f225c3d01dcd0fb4ccceb3c99c0a090f05a6ae409c352b9507758564080a5aa5bad229766d
-  data.tar.gz: dabfa2c4b4f1e9b1f26c714c0638c66067e4dc6b6e46c18f5da79a698e88fe693d5081ed983e37c50df1588f1b6c32951ba1d80bf0c0acc44b724866031908e9
+  metadata.gz: f77168573b78bcbc4b4051c74e7be7296ff42b4727eea93fc91c48711698e7013143401a18e8b4eac539d56f5087d05e3deeb0eb1216e4852f25f3370f4ae9b0
+  data.tar.gz: e489a2f3b3eb893126ab803c539eb7e2df63da5fc38850d83cf4ffd4377fc3d044b7ac6abb6fe92a234b9d4378907a023e97cfa91b56904517a12cae91904317

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)
+    rows = []
+    first_row = [0] # plan 0 = the root: asm walks plan index 0
+    counter = [0]
+    compile(tree, rows, first_row, counter)
+    first_row << rows.length # sentinel: end of the last plan's rows
+    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
+
+  # Pre-order: each plan's rows are one CONTIGUOUS block; nested
+  # sub-plans are compiled after the parent's block starts and their
+  # indices patch the parent's NESTED rows. first_row must eventually
+  # carry plan_count + 1 entries (the sentinel is rows.length).
+  def self.compile(tree, rows, first_row, counter)
+    idx = counter[0]
+    counter[0] += 1
+    first_row[idx] = rows.length
+    (tree[:children] || []).each do |ch|
+      kind = KINDS.fetch(ch[:kind])
+      if kind == 3
+        sub = counter[0]
+        pos = rows.length
+        rows << nil # patched with the real sub index below
+        sub = compile(ch[:plan], rows, first_row, counter)
+        rows[pos] = [ch[:name].to_s, kind, sub]
+      else
+        rows << [ch[:name].to_s, kind, 0]
+      end
+    end
+    idx
+  end
+  private_class_method :compile
+
+  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.25"
+  VERSION = "0.2.29"
 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.25
+  version: 0.2.29
 platform: aarch64-linux
 authors:
 - teptris contributors
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-15 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