teptris 0.2.37-s390x-linux

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 601cb20d5aca2c3b53e3f71130378fdf319f399a005a55617e269d5002e22983
+  data.tar.gz: c22b608f437c1e64d4b10de3955739c3f94260c42def04daf0bbbe71e2be2ee4
+SHA512:
+  metadata.gz: 4efe535b4a75353fd13cca492968d7e1eb0477651ccea806a6bbb05e200e155dd495e46cbdc24d2397f0bf596b1308faa9c63a0666ab90af6618634adf11b974
+  data.tar.gz: 72c7d930321e2261bd10b573ca038931cdb5c0c95d4d932e2ca0d699bfbdf768fcddd6d3efc798153126eef1c1844bfc9df3ffbf218c806c7274169440f23341

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/error.rb

@@ -0,0 +1,13 @@
+module Teptris
+  class Error < StandardError; end
+
+  class ParseError < Error
+    attr_reader :line, :column
+
+    def initialize(message, line = 0, column = 0)
+      @line = line
+      @column = column
+      super(message)
+    end
+  end
+end

data/lib/teptris/toml.rb

@@ -0,0 +1,66 @@
+require "date"
+
+require_relative "error"
+
+require_relative "version"
+
+module Teptris
+  # API shape mirrors the tomlib gem: load/dump, String keys, and the
+  # tomlib datetime contract (Time with zone for offset datetimes, local
+  # Time for local datetimes, Date for dates, String "HH:MM:SS" for
+  # local times).
+  module TOML
+    class << self
+      def load(toml)
+        raise ArgumentError, "input must be a String" unless toml.is_a?(String)
+
+        TeptrisExt.load(toml)
+      end
+
+      # Safe-load shaped entry point for frameworks: permitted_classes
+      # restricts datetime materialization (raise when a value would
+      # materialize an unpermitted class); datetime_policy :string keeps
+      # every datetime kind as its canonical ISO string instead.
+      def safe_load(toml, permitted_classes: nil, datetime_policy: :native)
+        unless %i[native string].include?(datetime_policy)
+          raise ArgumentError, "datetime_policy must be :native or :string"
+        end
+        opts = {}
+        opts[:string_datetimes] = true if datetime_policy == :string
+        if permitted_classes && datetime_policy == :native
+          permitted = permitted_classes + [:__scalar]
+          opts[:forbid_time] = true unless permitted.include?(Time)
+          opts[:forbid_date] = true unless permitted.include?(Date)
+        end
+        load(toml) if opts.empty?
+        TeptrisExt.load(toml, opts)
+      end
+
+      # One-pass schema materialization over a compiled
+      # Teptris::Descriptor: unplanned keys are never materialized
+      # (teptris#46).
+      def load_schema(toml, descriptor)
+        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
+        TeptrisExt.engine_version
+      end
+
+      public
+
+      def load_file(path)
+        load(File.read(path))
+      end
+
+      def dump(obj)
+        TeptrisExt.dump(obj)
+      end
+    end
+  end
+end

data/lib/teptris/version.rb

@@ -0,0 +1,3 @@
+module Teptris
+  VERSION = "0.2.37"
+end

data/lib/teptris.rb

@@ -0,0 +1,26 @@
+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
+# the mingw gems ship one extension per ruby minor beside a shared
+# libteptris.dll (nokogiri's fat-gem layout). The native extension IS the
+# binding — no fallback, ever.
+begin
+  if RUBY_PLATFORM =~ /mingw/
+    require "teptris/#{RUBY_VERSION[/\A\d+\.\d+/]}/teptris_ext"
+  else
+    require "teptris_ext"
+  end
+rescue LoadError
+  raise LoadError,
+        "teptris native extension not available for #{RUBY_PLATFORM} " \
+        "ruby #{RUBY_VERSION} (no fallback by design)"
+end
+
+module Teptris
+  TEPTRIS_OK = 0
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: teptris
+version: !ruby/object:Gem::Version
+  version: 0.2.37
+platform: s390x-linux
+authors:
+- teptris contributors
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-09-18 00:00:00.000000000 Z
+dependencies: []
+description: A native C extension over libteptris, a C99 TOML 1.1 parser/emitter.
+  API shape mirrors the tomlib gem.
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/teptris.rb
+- lib/teptris/descriptor.rb
+- lib/teptris/error.rb
+- lib/teptris/toml.rb
+- lib/teptris/version.rb
+- lib/teptris_ext.so
+homepage: https://github.com/leptris/teptris-ruby
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.20
+signing_key:
+specification_version: 4
+summary: TOML for Ruby at libteptris speed (native C extension)
+test_files: []