octri-openapi-parser 0.1.2-aarch64-linux

data/lib/octri_parser.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+require 'fiddle'
+require 'json'
+require_relative 'exact_json'
+require 'pathname'
+
+module OctriParser
+  # Native diagnostics retain physical source positions and related locations.
+  class ParserError < StandardError
+    attr_reader :diagnostics
+
+    def initialize(error)
+      super(error.fetch('message'))
+      @diagnostics = error.fetch('diagnostics')
+    end
+  end
+
+  # Explicit sources avoid guessing whether a string is a path or a document.
+  class Source
+    def self.text(content, uri: 'memory://octri/openapi.yaml')
+      { 'uri' => uri, 'content' => content, 'generated' => false }
+    end
+
+    def self.path(path)
+      { 'uri' => Pathname.new(path).expand_path.to_s, 'content' => nil, 'generated' => false }
+    end
+
+    def self.object(document, uri: 'memory://octri/openapi.json')
+      { 'uri' => uri, 'content' => OctriExactJSON.generate(document), 'generated' => true }
+    end
+  end
+
+  # Stateless synchronous binding. Fiddle borrows input only during the call;
+  # every native response is copied and freed before returning to Ruby.
+  class Parser
+    MAX_REQUEST_BYTES = 128 * 1024 * 1024
+    # Platform gems carry the native library under lib/octri_parser/native.
+    BUNDLED_LIBRARY = File.join(__dir__, 'octri_parser', 'native',
+                                RUBY_PLATFORM.include?('darwin') ? 'liboctri_parser_ffi.dylib' : 'liboctri_parser_ffi.so')
+
+    def initialize(library = BUNDLED_LIBRARY)
+      @library = Fiddle.dlopen(File.realpath(library))
+      version = function('abi_version', [], Fiddle::TYPE_INT)
+      raise LoadError, 'Expected Octri native ABI version 1' unless version.call == 1
+
+      @call = function('call', [Fiddle::TYPE_VOIDP, Fiddle::TYPE_SIZE_T], Fiddle::TYPE_VOIDP)
+      @data = function('buffer_data', [Fiddle::TYPE_VOIDP], Fiddle::TYPE_VOIDP)
+      @length = function('buffer_len', [Fiddle::TYPE_VOIDP], Fiddle::TYPE_SIZE_T)
+      @free = function('buffer_free', [Fiddle::TYPE_VOIDP], Fiddle::TYPE_VOID)
+    end
+
+    # Returns the complete Ok/Err transport envelope for parity tooling.
+    def call(envelope)
+      input = OctriExactJSON.generate(envelope).encode(Encoding::UTF_8)
+      raise ArgumentError, 'Binding request exceeds 128 MiB' if input.bytesize > MAX_REQUEST_BYTES
+
+      result = @call.call(Fiddle::Pointer[input], input.bytesize)
+      raise NoMemoryError, 'Native parser returned a null buffer' if result.null?
+
+      begin
+        OctriExactJSON.parse(@data.call(result).to_s(@length.call(result)).force_encoding(Encoding::UTF_8))
+      ensure
+        @free.call(result)
+      end
+    end
+
+    def execute(operation, source, options = {})
+      result('abiVersion' => 1, 'action' => 'report',
+             'request' => { 'operation' => operation, 'input' => source, 'options' => options })
+    end
+
+    def document(operation, source, options = {})
+      result('abiVersion' => 1, 'action' => 'document',
+             'request' => { 'operation' => operation, 'input' => source, 'options' => options })
+    end
+
+    def parse(source, options = {}) = execute('parse', source, options)
+    def resolve(source, options = {}) = execute('resolve', source, options)
+    def bundle(source, options = {}) = execute('bundle', source, options)
+    def dereference(source, options = {}) = execute('dereference', source, options)
+    def validate(source, options = {}) = execute('validate', source, options)
+
+    def inspect(source = nil, options = {})
+      return super() if source.nil?
+
+      execute('inspect', source, options)
+    end
+
+    def analyze(source, options = {}) = execute('analyze', source, options)
+
+    def serialize(document, format: 'json', limits: {})
+      encoded = OctriExactJSON.generate(document)
+      result('abiVersion' => 1, 'action' => 'serialize', 'document' => encoded, 'format' => format,
+             'limits' => limits)
+    end
+
+    private
+
+    def result(envelope)
+      response = call(envelope)
+      raise ParserError, response.fetch('Err') if response.key?('Err')
+
+      response.fetch('Ok')
+    end
+
+    def function(name, arguments, result)
+      Fiddle::Function.new(@library["octri_parser_#{name}"], arguments, result)
+    end
+  end
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification
+name: octri-openapi-parser
+version: !ruby/object:Gem::Version
+  version: 0.1.2
+platform: aarch64-linux
+authors:
+- Octri contributors
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bigdecimal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fiddle
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Validate, parse, bundle and dereference Swagger 2.0 and OpenAPI 3.x documents
+  with the bundled Octri Rust parser.
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/exact_json.rb
+- lib/octri_parser.rb
+- lib/octri_parser/native/LICENSE
+- lib/octri_parser/native/OAI-LICENSE
+- lib/octri_parser/native/THIRD_PARTY_NOTICES.md
+- lib/octri_parser/native/liboctri_parser_ffi.so
+homepage: https://github.com/octridev/octri-openapi-parser
+licenses:
+- Apache-2.0
+metadata:
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Ruby bindings for the Octri Rust OpenAPI parser
+test_files: []