magicprotorb 0.1.0

data/lib/magicprotorb/service_builder.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Magicprotorb
+  # Synthesizes gRPC Service/Stub classes from the service descriptors in a
+  # FileDescriptorProto — the runtime equivalent of a generated
+  # `*_services_pb.rb`. Requires the optional `grpc` gem, loaded lazily so that
+  # message-only users never pay for it.
+  module ServiceBuilder
+    module_function
+
+    def build(file)
+      require "grpc"
+      package = file.package
+      file.service.each { |service| build_service(package, service) }
+    end
+
+    def build_service(package, service)
+      # Use to_h to read the repeated `method` field: ServiceDescriptorProto#method
+      # collides with Ruby's Object#method.
+      descriptor = service.to_h
+      name = descriptor[:name]
+      full_name = qualify(package, name)
+
+      service_class = define_service_class(full_name, descriptor[:method] || [])
+
+      mod = Registrar.ensure_module(Naming.package_modules(package) + [Naming.constant_name(name)])
+      mod.const_set(:Service, service_class) unless mod.const_defined?(:Service, false)
+      mod.const_set(:Stub, service_class.rpc_stub_class) unless mod.const_defined?(:Stub, false)
+    end
+
+    def define_service_class(full_name, methods)
+      pool = Google::Protobuf::DescriptorPool.generated_pool
+
+      Class.new do
+        include GRPC::GenericService
+
+        self.marshal_class_method = :encode
+        self.unmarshal_class_method = :decode
+        self.service_name = full_name
+
+        methods.each do |method|
+          request = pool.lookup(ServiceBuilder.strip(method[:input_type])).msgclass
+          response = pool.lookup(ServiceBuilder.strip(method[:output_type])).msgclass
+          # stream(...) is provided by GenericService's DSL inside the class body.
+          request = stream(request) if method[:client_streaming]
+          response = stream(response) if method[:server_streaming]
+          rpc method[:name].to_sym, request, response
+        end
+      end
+    end
+
+    def qualify(package, name)
+      package.nil? || package.empty? ? name : "#{package}.#{name}"
+    end
+
+    # Descriptor type references are fully-qualified with a leading dot
+    # (".greet.HelloRequest"); the pool is keyed without it.
+    def strip(type_name)
+      type_name.sub(/\A\./, "")
+    end
+  end
+end

data/lib/magicprotorb/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Magicprotorb
+  VERSION = "0.1.0"
+end

data/lib/magicprotorb.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require "google/protobuf"
+require "google/protobuf/descriptor_pb"
+
+require_relative "magicprotorb/version"
+
+module Magicprotorb
+  class Error < StandardError; end
+
+  # Raised when the native compiler rejects a .proto (syntax error, unresolved
+  # import, etc.).
+  class CompileError < Error; end
+end
+
+# The Rust compiler extension (defines Magicprotorb::Compiler._compile).
+require_relative "magicprotorb/magicprotorb_native"
+
+require_relative "magicprotorb/naming"
+require_relative "magicprotorb/include_path"
+require_relative "magicprotorb/registrar"
+require_relative "magicprotorb/service_builder"
+require_relative "magicprotorb/loader"
+require_relative "magicprotorb/require_hook"
+
+module Magicprotorb
+  # Public, programmatic entry points. The primary interface is the require hook
+  # installed below; these mirror it for callers who prefer an explicit API.
+
+  module_function
+
+  # The include roots currently searched for protos (MAGICPROTORB_PATH then
+  # $LOAD_PATH), highest priority first.
+  def include_paths
+    IncludePath.roots
+  end
+
+  # Programmatic equivalent of `require "magicprotorb/<proto>_pb"`. Accepts a
+  # canonical proto path with or without the .proto extension.
+  def import(proto)
+    Loader.load_messages(normalize(proto))
+  end
+
+  # Programmatic equivalent of `require "magicprotorb/<proto>_services_pb"`.
+  def import_services(proto)
+    Loader.load_services(normalize(proto))
+  end
+
+  def normalize(proto)
+    proto.end_with?(".proto") ? proto : "#{proto}.proto"
+  end
+end
+
+# Install the import hook. After this, `require "magicprotorb/foo/bar_pb"` works.
+Kernel.prepend(Magicprotorb::RequireHook)

data/sig/magicprotorb.rbs

@@ -0,0 +1,29 @@
+module Magicprotorb
+  VERSION: String
+
+  class Error < StandardError
+  end
+
+  # Raised when the native compiler rejects a .proto.
+  class CompileError < Error
+  end
+
+  # Compiles greet/hello.proto and defines its message/enum constants.
+  # Equivalent to `require "magicprotorb/greet/hello_pb"`.
+  def self.import: (String proto) -> void
+
+  # As import, plus synthesizes the gRPC Service/Stub.
+  # Equivalent to `require "magicprotorb/greet/hello_services_pb"`.
+  def self.import_services: (String proto) -> void
+
+  # The include roots currently searched (MAGICPROTORB_PATH, then $LOAD_PATH).
+  def self.include_paths: () -> Array[String]
+
+  def self.normalize: (String proto) -> String
+
+  # The Rust extension's compiler entry point.
+  class Compiler
+    # Returns a serialized FileDescriptorSet (binary string).
+    def self._compile: (String proto_path, Array[String] include_dirs) -> String
+  end
+end

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification
+name: magicprotorb
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Sam
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2026-05-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: google-protobuf
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.21'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.21'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rb_sys
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: |
+  magicprotorb lets you `require "magicprotorb/foo/bar_pb"` and have foo/bar.proto
+  compiled to descriptors and registered at require time. The dotted require path
+  mirrors the canonical proto path 1:1, so the require name, the file location, and
+  the descriptor name can never drift apart. A small Rust extension (built on the
+  pure-Rust protox compiler) turns .proto text into a FileDescriptorSet, which is
+  then registered through the stock protobuf DescriptorPool — making the resulting
+  message classes indistinguishable from generated ones.
+email:
+executables: []
+extensions:
+- ext/magicprotorb_native/extconf.rb
+extra_rdoc_files: []
+files:
+- ".rubocop.yml"
+- Cargo.lock
+- Cargo.toml
+- DESIGN.md
+- README.md
+- Rakefile
+- ext/magicprotorb_native/Cargo.toml
+- ext/magicprotorb_native/extconf.rb
+- ext/magicprotorb_native/src/lib.rs
+- lib/magicprotorb.rb
+- lib/magicprotorb/include_path.rb
+- lib/magicprotorb/loader.rb
+- lib/magicprotorb/naming.rb
+- lib/magicprotorb/registrar.rb
+- lib/magicprotorb/require_hook.rb
+- lib/magicprotorb/service_builder.rb
+- lib/magicprotorb/version.rb
+- sig/magicprotorb.rbs
+homepage: https://github.com/grpyc/magicproto-rb
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/grpyc/magicproto-rb
+  source_code_uri: https://github.com/grpyc/magicproto-rb
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: Import .proto files directly in Ruby — no protoc, no generated _pb.rb, no
+  build step.
+test_files: []