pbwire 0.1.1

data/lib/pbwire.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+# pbwire Ruby binding: a compiled extension over the C core, no gems.
+#
+# A FileDescriptorSet (`protoc --descriptor_set_out`) is the schema; messages
+# are built and read by field name or number and go to/from wire bytes with no
+# generated code. Every pbw_status is checked and turned into Pbwire::Error.
+#
+#   schema = Pbwire::Schema.from_file("sample.desc")
+#   msg = schema.message("pbwire.ruby.Sample")
+#   msg["name"] = "alice"
+#   wire = msg.encode
+#   schema.message("pbwire.ruby.Sample").decode(wire)["name"] # => "alice"
+#
+# Build it with build.sh (or `make ruby-build`); the extension is linked against
+# the C core, so the schema and the wire format stay in one place.
+require_relative 'pbwire_ext'
+
+# Idiomatic Ruby resource handling, mirroring File.open: with a block the
+# schema closes itself (even on exception), without one the caller owns it
+# and closes it explicitly. The C extension owns the format; this wrapper
+# only owns the ergonomics, so no wire behavior changes here.
+module Pbwire
+  class Schema
+    class << self
+      alias_method :__pbwire_from_bytes__, :from_bytes
+      alias_method :__pbwire_from_file__, :from_file
+
+      def from_bytes(bytes)
+        schema = __pbwire_from_bytes__(bytes)
+        return schema unless block_given?
+
+        begin
+          yield schema
+        ensure
+          schema.close unless schema.closed?
+        end
+      end
+
+      def from_file(path)
+        schema = __pbwire_from_file__(path)
+        return schema unless block_given?
+
+        begin
+          yield schema
+        ensure
+          schema.close unless schema.closed?
+        end
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,57 @@
+--- !ruby/object:Gem::Specification
+name: pbwire
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- jinganix
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: A FileDescriptorSet becomes the schema at runtime; messages go to/from
+  wire bytes with no generated code, through a C extension over the pbwire core.
+executables: []
+extensions:
+- ext/pbwire_ext/extconf.rb
+extra_rdoc_files: []
+files:
+- "../../VERSION"
+- "../../include/pbwire.h"
+- "../../src/arena.c"
+- "../../src/ctx.c"
+- "../../src/decode.c"
+- "../../src/descriptor_set.c"
+- "../../src/encode.c"
+- "../../src/json.c"
+- "../../src/message.c"
+- "../../src/schema.c"
+- "../../src/stream.c"
+- "../../src/text.c"
+- "../../src/wire.c"
+- README.md
+- ext/pbwire_ext/extconf.rb
+- ext/pbwire_ext/pbwire_ext.c
+- lib/pbwire.rb
+homepage: https://github.com/jinganix/pbwire
+licenses:
+- Apache-2.0
+metadata: {}
+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.6.9
+specification_version: 4
+summary: Dynamic protobuf over the pbwire C ABI, schema at runtime
+test_files: []