red-flatbuffers 0.0.1

data/lib/flatbuffers/table.rb

@@ -0,0 +1,34 @@
+# Copyright 2025 Sutou Kouhei <kou@clear-code.com>
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require_relative "inspectable"
+require_relative "view"
+
+module FlatBuffers
+  class Table
+    include Inspectable
+
+    def initialize(input)
+      if input.is_a?(View)
+        @view = input
+      else
+        if input.is_a?(String)
+          input = IO::Buffer.for(input)
+        end
+        offset = input.get_value(:u32, 0)
+        @view = View.new(input, offset, have_vtable: true)
+      end
+    end
+  end
+end

data/lib/flatbuffers/union.rb

@@ -0,0 +1,62 @@
+# Copyright 2025 Sutou Kouhei <kou@clear-code.com>
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module FlatBuffers
+  class Union
+    class << self
+      def try_convert(value)
+        case value
+        when Symbol, String
+          @name_to_union[value.to_s]
+        when Integer
+          @value_to_union[value]
+        when self
+          value
+        else
+          nil
+        end
+      end
+
+      def register(name, value, table_class_name, require_path)
+        object = new(name, value, table_class_name, require_path)
+        (@name_to_union ||= {})[name] = object
+        (@value_to_union ||= {})[value] = object
+        object
+      end
+    end
+
+    attr_reader :name
+    attr_reader :value
+    def initialize(name, value, table_class_name, require_path)
+      @name = name
+      @value = value
+      @table_class_name = table_class_name
+      @require_path = require_path
+    end
+
+    def table_class
+      @table_class ||= resolve_table_class
+    end
+
+    private def resolve_table_class
+      return nil if @table_class_name.nil?
+
+      require_table_class
+      Object.const_get(@table_class_name)
+    end
+
+    alias_method :to_i, :value
+    alias_method :to_int, :value
+  end
+end

data/lib/flatbuffers/version.rb

@@ -0,0 +1,17 @@
+# Copyright 2025 Sutou Kouhei <kou@clear-code.com>
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module FlatBuffers
+  VERSION = "0.0.1"
+end

data/lib/flatbuffers/view.rb

@@ -0,0 +1,176 @@
+# Copyright 2025 Sutou Kouhei <kou@clear-code.com>
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module FlatBuffers
+  class View
+    OFFSET_BYTE_SIZE = 4
+    VIRTUAL_OFFSET_BYTE_SIZE = 2
+
+    def initialize(data, offset, have_vtable: false)
+      @data = data
+      @offset = offset
+      if have_vtable
+        vtable_offset = unpack_signed_offset(0)
+        @vtable_start = @offset - vtable_offset
+        # We assume vtable must have length.
+        @vtable_max_offset = VIRTUAL_OFFSET_BYTE_SIZE
+        @vtable_length = unpack_virtual_offset(0)
+        @vtable_max_offset = @vtable_length - VIRTUAL_OFFSET_BYTE_SIZE
+        @table_length = unpack_virtual_offset(VIRTUAL_OFFSET_BYTE_SIZE)
+      end
+    end
+
+    def unpack_virtual_offset(vtable_offset)
+      return 0 if vtable_offset > @vtable_max_offset
+      @data.get_value(:u16, @vtable_start + vtable_offset)
+    end
+
+    def resolve_indirect(offset)
+      @offset + offset + unpack_offset(offset)
+    end
+
+    def unpack_offset_raw(offset)
+      @data.get_value(:u32, offset)
+    end
+
+    def unpack_offset(offset)
+      unpack_offset_raw(@offset + offset)
+    end
+
+    def unpack_signed_offset(offset)
+      @data.get_value(:s32, @offset + offset)
+    end
+
+    def unpack_bool(offset)
+      unpack_byte(offset) != 0
+    end
+
+    def unpack_utype(offset)
+      unpack_ubyte(offset)
+    end
+
+    def unpack_byte(offset)
+      @data.get_value(:S8, @offset + offset)
+    end
+
+    def unpack_ubyte(offset)
+      @data.get_value(:U8, @offset + offset)
+    end
+
+    def unpack_short(offset)
+      @data.get_value(:s16, @offset + offset)
+    end
+
+    def unpack_ushort(offset)
+      @data.get_value(:u16, @offset + offset)
+    end
+
+    def unpack_int(offset)
+      @data.get_value(:s32, @offset + offset)
+    end
+
+    def unpack_uint(offset)
+      @data.get_value(:u32, @offset + offset)
+    end
+
+    def unpack_long(offset)
+      @data.get_value(:s64, @offset + offset)
+    end
+
+    def unpack_ulong(offset)
+      @data.get_value(:u64, @offset + offset)
+    end
+
+    def unpack_float(offset)
+      @data.get_value(:f32, @offset + offset)
+    end
+
+    def unpack_double(offset)
+      @data.get_value(:f64, @offset + offset)
+    end
+
+    def unpack_string(offset)
+      value_offset = resolve_indirect(offset)
+      length = unpack_offset_raw(value_offset)
+      @data.get_string(value_offset + OFFSET_BYTE_SIZE,
+                       length)
+    end
+
+    def unpack_table(klass, offset)
+      sub_view = self.class.new(@data,
+                                resolve_indirect(offset),
+                                have_vtable: true)
+      klass.new(sub_view)
+    end
+
+    def unpack_struct(klass, offset)
+      sub_view = self.class.new(@data,
+                                @offset + offset,
+                                have_vtable: false)
+      klass.new(sub_view)
+    end
+
+    def unpack_union(klass, offset)
+      unpack_table(klass, offset)
+    end
+
+    def unpack_vector_length(offset)
+      vector_offset = resolve_indirect(offset)
+      unpack_offset_raw(vector_offset)
+    end
+
+    def unpack_vector(offset, element_size)
+      relative_vector_offset = offset + unpack_offset(offset)
+      length = unpack_offset(relative_vector_offset)
+      return nil if length.zero?
+
+      relative_vector_body_offset = relative_vector_offset + OFFSET_BYTE_SIZE
+      length.times.collect do |i|
+        relative_element_offset =
+          relative_vector_body_offset + (element_size * i)
+        yield(relative_element_offset)
+      end
+    end
+
+    def unpack_bool_vector(offset, element_size)
+      unpack_vector(offset, element_size) do |relative_element_offset|
+        unpack_bool(relative_element_offset)
+      end
+    end
+
+    def unpack_ubyte_vector(offset, element_size)
+      unpack_vector(offset, element_size) do |relative_element_offset|
+        unpack_ubyte(relative_element_offset)
+      end
+    end
+
+    def unpack_string_vector(offset, element_size)
+      unpack_vector(offset, element_size) do |relative_element_offset|
+        unpack_string(relative_element_offset)
+      end
+    end
+
+    def unpack_table_vector(offset, element_size, klass)
+      unpack_vector(offset, element_size) do |relative_element_offset|
+        unpack_table(klass, relative_element_offset)
+      end
+    end
+
+    def unpack_struct_vector(offset, element_size, klass)
+      unpack_vector(offset, element_size) do |relative_element_offset|
+        unpack_struct(klass, relative_element_offset)
+      end
+    end
+  end
+end

data/lib/flatbuffers.rb

@@ -0,0 +1,20 @@
+# Copyright 2025  Sutou Kouhei <kou@clear-code.com>
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require_relative "flatbuffers/enum"
+require_relative "flatbuffers/flags"
+require_relative "flatbuffers/struct"
+require_relative "flatbuffers/table"
+require_relative "flatbuffers/union"
+require_relative "flatbuffers/version"

data/red-flatbuffers.gemspec

@@ -0,0 +1,46 @@
+# -*- ruby -*-
+#
+# Copyright 2025 Sutou Kouhei <kou@clear-code.com>
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+clean_white_space = lambda do |entry|
+  entry.gsub(/(\A\n+|\n+\z)/, '') + "\n"
+end
+
+require_relative "lib/flatbuffers/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "red-flatbuffers"
+  spec.version = FlatBuffers::VERSION
+  spec.homepage = "https://github.com/red-data-tools/red-flatbuffers"
+  spec.authors = ["Sutou Kouhei"]
+  spec.email = ["kou@clear-code.com"]
+
+  readme = File.read("README.md")
+  readme.force_encoding("UTF-8")
+  entries = readme.split(/^\#\#\s(.*)$/)
+  description = clean_white_space.call(entries[2])
+  spec.summary, spec.description, = description.split(/\n\n+/, 3)
+  spec.license = "Apache-2.0"
+  spec.files = ["README.md", "#{spec.name}.gemspec"]
+  spec.files += Dir.glob("lib/**/*.rb")
+  spec.files += Dir.glob("doc/text/*")
+  Dir.chdir("bin") do
+    spec.executables = Dir.glob("*")
+  end
+
+  spec.add_development_dependency("bundler")
+  spec.add_development_dependency("rake")
+  spec.add_development_dependency("test-unit")
+end

metadata

@@ -0,0 +1,111 @@
+--- !ruby/object:Gem::Specification
+name: red-flatbuffers
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Sutou Kouhei
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: test-unit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ''
+email:
+- kou@clear-code.com
+executables:
+- rbflatc
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/rbflatc
+- doc/text/apache-2.0.txt
+- doc/text/news.md
+- lib/flatbuffers.rb
+- lib/flatbuffers/command/rbflatc.rb
+- lib/flatbuffers/enum.rb
+- lib/flatbuffers/flags.rb
+- lib/flatbuffers/generator.rb
+- lib/flatbuffers/inspectable.rb
+- lib/flatbuffers/reflection/advanced_features.rb
+- lib/flatbuffers/reflection/base_type.rb
+- lib/flatbuffers/reflection/enum.rb
+- lib/flatbuffers/reflection/enum_val.rb
+- lib/flatbuffers/reflection/field.rb
+- lib/flatbuffers/reflection/key_value.rb
+- lib/flatbuffers/reflection/object.rb
+- lib/flatbuffers/reflection/rpccall.rb
+- lib/flatbuffers/reflection/schema.rb
+- lib/flatbuffers/reflection/schema_file.rb
+- lib/flatbuffers/reflection/service.rb
+- lib/flatbuffers/reflection/type.rb
+- lib/flatbuffers/struct.rb
+- lib/flatbuffers/table.rb
+- lib/flatbuffers/union.rb
+- lib/flatbuffers/version.rb
+- lib/flatbuffers/view.rb
+- red-flatbuffers.gemspec
+homepage: https://github.com/red-data-tools/red-flatbuffers
+licenses:
+- Apache-2.0
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: "```bash gem install red-flatbuffers ```"
+test_files: []