yeptris 0.6.7.4-aarch64-linux → 0.6.7.5-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 38fd217a7686b96f7665ef834d28df3a2d7cdce411f4dcfb29988d57537586c7
-  data.tar.gz: 11ac5624a27aafc4254506f63118ecbe919c8f1cfb6466d8b2b342ef43ca38be
+  metadata.gz: 0b7d5fc414b1459a5bd7507b2cc3f4dc308efd75010d82f132bd7da078c3e999
+  data.tar.gz: a27ba76d7a111dd8902ff058e1a26cadd05c3cfa921034bcab70bbad48deff0f
 SHA512:
-  metadata.gz: a2d5d2f45d7dd6ad25e2e491f5fac8df7ccce2ffd7312ae2302ee49369749b7ee502519a4616d0c69a7365302f4ca349eafc60b0ea45e6c160f709c53f519e82
-  data.tar.gz: 863a0a4e29c2a60f157560881070172f209acd9e001b727d9aeeb70c1f1ec106e1bb5e7a816f1798c841cdc79016674dd8fdf5add5698235439d51c535446e15
+  metadata.gz: 86c23e8e229b87eff443d7e2be1cc16ad57b07a80b8edf5feb7a757e4b611aff34822c78eca5548c72e7eb42a1895f3023b4a50948147e654cb119003ad21a57
+  data.tar.gz: 75ef4719add9a892912352792c0fd8e28347a079ccfee167b1520082d77c1d7a17d83baa593024d2c1b03d8ff0e2d9881f85e6dd1ec56dd00a8606fa25dcaf6f

data/lib/yeptris/cbor.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+module Yeptris
+  # CBOR (RFC 8949) over the same FFI document the rest of the
+  # binding rides (TODO.cbor/04). Decode materializes through the
+  # Psych-compatible path; encode builds the tree with YAMLTree and
+  # hands the document to the C encoder — plain data only (aliases
+  # and non-decimal tag text are unencodable by the C contract).
+  #
+  # Representation notes inherited from the decoder: integers beyond
+  # int64 and bignums materialize as their shortest-double text, byte
+  # strings as tag-chained text — CBOR's JSON-data-model mapping.
+  module CBOR
+    STRICT = (1 << 0) # decode: reject non-minimal arguments
+    CANONICAL = (1 << 1) # encode: s4.2.1 core deterministic profile
+
+    class Error < Yeptris::Error; end
+    class UnencodableError < Error; end
+
+    module_function
+
+    def available?
+      defined?(::Yeptris::FFI::CBOR_EX) && ::Yeptris::FFI::CBOR_EX
+    end
+
+    def load(data, strict: false)
+      raise Error, "libyeptris has no CBOR support" unless available?
+
+      doc_ptr = ::Yeptris::FFI.yeptris_cbor_decode(data, data.bytesize, strict ? STRICT : 0, nil)
+      raise ParseError, ::Yeptris::FFI.last_error_message if doc_ptr.null?
+
+      # the wrapper's finalizer also frees — its idempotent #free is
+      # the ONLY release path (a raw double free corrupts the heap)
+      doc = ::Yeptris::Document.new(doc_ptr)
+      doc.root.to_ruby
+    ensure
+      doc&.free
+    end
+
+    def load_sequence(data, strict: false)
+      raise Error, "libyeptris has no CBOR support" unless available?
+
+      items = []
+      receiver = ::FFI::Function.new(:int, %i[pointer pointer size_t]) do |_ctx, item, _index|
+        # the callback owns the item; materialize then free in place
+        # (through the wrapper — the finalizer frees too)
+        doc = ::Yeptris::Document.new(item)
+        items << doc.root&.to_ruby
+        doc.free
+        0
+      end
+      st = ::Yeptris::FFI.yeptris_cbor_decode_sequence(
+        data, data.bytesize, strict ? STRICT : 0, receiver, nil, nil
+      )
+      raise ParseError, ::Yeptris::FFI.last_error_message if st.zero? && !data.empty?
+
+      items
+    end
+
+    def dump(obj, canonical: true)
+      docs = build_documents([obj])
+      begin
+        encode_one(docs[0], canonical)
+      ensure
+        docs.each(&:free)
+      end
+    end
+
+    def dump_sequence(objects, canonical: true)
+      docs = build_documents(objects)
+      begin
+        opts = canonical ? CANONICAL : 0
+        arr = ::FFI::MemoryPointer.new(:pointer, docs.size)
+        arr.write_array_of_pointer(docs.map(&:c_ptr))
+        len_ptr = ::FFI::MemoryPointer.new(:size_t)
+        take_buffer(
+          ::Yeptris::FFI.yeptris_cbor_encode_sequence(arr, docs.size, opts, len_ptr),
+          len_ptr
+        )
+      ensure
+        docs.each(&:free)
+      end
+    end
+
+    # -- internals ----------------------------------------------------
+
+    def build_documents(objects)
+      # ONE document per object: a visitor's tree is a single
+      # document and push sets its root — reuse would overwrite
+      objects.map do |obj|
+        visitor = ::Yeptris::Psych::Visitors::YAMLTree.new
+        visitor.push(obj)
+        visitor.document
+      end
+    end
+
+    def encode_one(doc, canonical)
+      opts = canonical ? CANONICAL : 0
+      len_ptr = ::FFI::MemoryPointer.new(:size_t)
+      take_buffer(::Yeptris::FFI.yeptris_cbor_encode(doc.c_ptr, opts, len_ptr), len_ptr)
+    end
+
+    # The encode convenience contract: a malloc'd buffer plus its
+    # byte length — binary data, freed through the library's own free.
+    def take_buffer(ptr, len_ptr)
+      raise UnencodableError, ::Yeptris::FFI.last_error_message if ptr.null?
+
+      len = len_ptr.read_uint64
+      ptr.read_bytes(len).force_encoding(Encoding::BINARY)
+    ensure
+      ::Yeptris::FFI.yeptris_free(ptr) if ptr && !ptr.null?
+    end
+  end
+end

data/lib/yeptris/ffi.rb

@@ -230,17 +230,45 @@ module Yeptris
       false
     end
 
+    # 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
+
     # Owned char* results (serialize*): one reader, freed exactly once.
     # The release goes through yeptris_free (libyeptris's own
     # allocator-matching free) because ffi's :free attach has no
     # Windows process-symbol fallback — libyeptris.dll doesn't export
     # libc free, so resolving :free against it fails on Windows.
-    begin
+    # A raised attach ABORTS this file mid-evaluation — everything
+    # after it (NODE_SCALAR and the kind constants below) never
+    # defines, and a lazily autoloaded node.rb then dies with
+    # 'uninitialized constant' (#138). Every fallback attaches too.
+    YEPTRIS_FREE = begin
       attach_function :yeptris_free, [:pointer], :void
+      :direct
     rescue ::FFI::NotFoundError
-      # libyeptris < v0.6.6: POSIX resolves :free through the process
-      # symbol table, so the direct libc attach still works there.
-      attach_function :yeptris_free, :free, [:pointer], :void
+      begin
+        # libyeptris < v0.6.6: POSIX resolves :free through the
+        # process symbol table, so the libc attach still works there.
+        attach_function :yeptris_free, :free, [:pointer], :void
+        :libc
+      rescue ::FFI::NotFoundError
+        # no owned-buffer release on this lib+platform combination;
+        # Owned.string leaks instead of killing the whole file
+        :none
+      end
     end
 
     module Owned
@@ -258,7 +286,7 @@ module Yeptris
             else
               ptr.read_string.force_encoding(Encoding::UTF_8)
             end
-        ::Yeptris::FFI.yeptris_free(ptr)
+        ::Yeptris::FFI.yeptris_free(ptr) if ::Yeptris::FFI::YEPTRIS_FREE != :none
         s
       end
     end

data/lib/yeptris/psych/visitors.rb

@@ -41,6 +41,12 @@ module Yeptris
           BuiltDocument.new(@tree)
         end
 
+        # The raw document (the CBOR encoder consumes the tree
+        # directly; #tree wraps it for stdlib's yaml face)
+        def document
+          @tree
+        end
+
         def finish
           @tree.serialize(explicit_doc_start: true)
         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.7.4".freeze
+  VERSION = "0.6.7.5".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
@@ -44,6 +44,7 @@ module Yeptris
   autoload :ValueML, "yeptris/valueml"
   autoload :Psych, "yeptris/psych"
   autoload :Schema, "yeptris/schema"
+  autoload :CBOR, "yeptris/cbor"
 end
 
 # NOTE (the #318 poisoned-process class): the Psych error-name aliases

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: yeptris
 version: !ruby/object:Gem::Version
-  version: 0.6.7.4
+  version: 0.6.7.5
 platform: aarch64-linux
 authors:
 - Ribose Inc.
@@ -40,6 +40,7 @@ files:
 - ext/yeptris_native/json_ruby.c
 - ext/yeptris_native/yeptris_native.c
 - lib/yeptris.rb
+- lib/yeptris/cbor.rb
 - lib/yeptris/document.rb
 - lib/yeptris/ffi.rb
 - lib/yeptris/json.rb