yeptris 0.6.12.1 → 0.6.12.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ffeaeb76cbc3a0a575cf5fce09e5ceff42ae233fa38125c4fb575eb15c2aafab
-  data.tar.gz: d6667ffc31e29fd13f97d7bd5378b6a3611c39f849f7a69075d9e90c6e262df6
+  metadata.gz: 5900164f14038b2ef4e6c7b3e7764c335faf037559f9743099787e2ffcadb2f7
+  data.tar.gz: b539d2090254785c57c6dfd5a08e46200b668b0061619691e779a5c186a3978a
 SHA512:
-  metadata.gz: 52298af429a38b41b55adf972d89156e5c214367debc1ccf618fd8e1a438414004861c8b6a7e9a1cc1e5235c68ba07a734ae580da668b3b7751b708102c9d46c
-  data.tar.gz: c40301fda3424c9ef0d3d314a71dbf05b9a50af488c12b470f14cb8523912416ceb762de6e73ca6b44a97ac04b549d565113b688333320dabe9f3a2861895e50
+  metadata.gz: d837519cc77193279158957e4757a0b2ee6f250467d293422676135b6aee89058eac9dbb48c6b7a5f3eb79ca77cc1e076399f93935ed75d652612244b845db74
+  data.tar.gz: 5eff7ba15bd3c4314508d226ebaa4d2e3aa0eb0a7cc2887645078acbbecd193cbaa443af6877891b226224719b8955700f8567ec8a0446cc42fa713349993864

data/lib/yeptris/ffi.rb

@@ -28,6 +28,32 @@ module Yeptris
       MSG
     end
 
+    class << self
+      # #138's class, hit again by the oiml-cs report: a stale
+      # libyeptris on the machine (the Windows base-name dedupe makes
+      # a system copy win) lacks newer symbols, and a raising attach
+      # aborts this file mid-evaluation — every constant after it
+      # never defines, so the next autoload dies with
+      # 'uninitialized constant Yeptris::FFI::NODE_SCALAR'. Attaches
+      # now record the miss and define a raising stub of the same
+      # name: the load completes, optional surfaces fail with a clear
+      # message at USE, and the ESSENTIAL self-check at the bottom of
+      # this file raises the friendly load error for truly old
+      # engines.
+      def attach_function(name, args, ret, opts = {})
+        super
+      rescue ::FFI::NotFoundError, ::FFI::TypeError
+        define_singleton_method(name) do |*_a, **_kw|
+          raise ::FFI::NotFoundError,
+                "yeptris: #{name} is unavailable — the loaded " \
+                "libyeptris is older than this gem. Update the engine " \
+                "library (or clear the stale copy shadowing it)."
+        end
+        (@missing ||= []) << name
+        nil
+      end
+    end
+
 
     typedef :pointer, :yeptris_document
     typedef :pointer, :yeptris_node
@@ -194,18 +220,14 @@ module Yeptris
     # instead of walking per-value records in pure Ruby. Same feature-
     # detect discipline as the columnar drain (older libraries fall
     # back to the record walk).
-    MARSHAL = begin
-      MARSHAL_ALL_DOCS = 0
-      MARSHAL_FIRST_DOC = 1
-      attach_function :yeptris_marshal,
-                      %i[pointer size_t int int pointer pointer], :int
-      attach_function :yeptris_marshal_node,
-                      %i[yeptris_node pointer pointer], :int
-      attach_function :yeptris_marshal_free, [:pointer], :void
-      true
-    rescue ::FFI::NotFoundError
-      false
-    end
+    MARSHAL_ALL_DOCS = 0
+    MARSHAL_FIRST_DOC = 1
+    attach_function :yeptris_marshal,
+                    %i[pointer size_t int int pointer pointer], :int
+    attach_function :yeptris_marshal_node,
+                    %i[yeptris_node pointer pointer], :int
+    attach_function :yeptris_marshal_free, [:pointer], :void
+    MARSHAL = !(@missing ||= []).include?(:yeptris_marshal_node)
 
     # bulk build (TODO.impl/15 phase D): one call raises a document
     BUILD_SCALAR = 1
@@ -238,19 +260,15 @@ module Yeptris
 
     # CBOR (RFC 8949, TODO.cbor): absent on libraries before the
     # codec's release — the CBOR module feature-detects
-    CBOR_EX = begin
-      attach_function :yeptris_cbor_decode, %i[pointer size_t uint32 yeptris_status_out],
-                      :yeptris_document
-      callback :cbor_item_cb, %i[pointer yeptris_document size_t], :int
-      attach_function :yeptris_cbor_decode_sequence,
-                      %i[pointer size_t uint32 cbor_item_cb pointer yeptris_status_out], :size_t
-      attach_function :yeptris_cbor_encode, %i[yeptris_document uint32 pointer], :pointer
-      attach_function :yeptris_cbor_encode_sequence,
-                      %i[pointer size_t uint32 pointer], :pointer
-      true
-    rescue ::FFI::NotFoundError
-      false
-    end
+    attach_function :yeptris_cbor_decode, %i[pointer size_t uint32 yeptris_status_out],
+                    :yeptris_document
+    callback :cbor_item_cb, %i[pointer yeptris_document size_t], :int
+    attach_function :yeptris_cbor_decode_sequence,
+                    %i[pointer size_t uint32 cbor_item_cb pointer yeptris_status_out], :size_t
+    attach_function :yeptris_cbor_encode, %i[yeptris_document uint32 pointer], :pointer
+    attach_function :yeptris_cbor_encode_sequence,
+                    %i[pointer size_t uint32 pointer], :pointer
+    CBOR_EX = !(@missing ||= []).include?(:yeptris_cbor_decode)
 
     # Owned char* results (serialize*): one reader, freed exactly once.
     # The release goes through yeptris_free (libyeptris's own
@@ -368,5 +386,24 @@ module Yeptris
     ERROR_ARG = 6
     ERROR_UNSUPPORTED = 7
     ERROR_INTERNAL = 8
+    # The load-time essentials (the read path + the ownership
+    # contract): absent on engines far older than the optional
+    # surfaces — raise the friendly error once every constant has
+    # fully defined, so no partial-module state leaks into autoloads
+    # (the #138 class, closed at the root).
+    ESSENTIAL = %i[
+      yeptris_version yeptris_last_error yeptris_parse yeptris_parse_ex
+      yeptris_parse_json yeptris_document_free yeptris_document_count
+      yeptris_document_root yeptris_node_kind yeptris_node_value
+      yeptris_node_tag_id yeptris_node_style yeptris_document_new
+      yeptris_document_set_root yeptris_serialize yeptris_serialize_ex
+    ].freeze
+    missing_core = ESSENTIAL & (@missing ||= [])
+    raise ::FFI::NotFoundError,
+          "yeptris: the loaded libyeptris is older than this gem " \
+          "requires (missing: #{missing_core.join(', ')}). Update the " \
+          "engine library, or clear the stale copy shadowing it." \
+          unless missing_core.empty?
+
   end
 end

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.12.1".freeze
+  VERSION = "0.6.12.3".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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: yeptris
 version: !ruby/object:Gem::Version
-  version: 0.6.12.1
+  version: 0.6.12.3
 platform: ruby
 authors:
 - Ribose Inc.