tonic-rails 0.1.0-aarch64-linux-gnu

data/lib/tonic/rails/testing.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Tonic
+  module Rails
+    # Call handlers in-process, without a network or the native extension.
+    # Requests and responses go through real protobuf encoding, so tests
+    # exercise the same conversion the server does.
+    #
+    #   require "tonic/rails/testing"
+    #
+    #   response = Tonic::Rails::Testing.call(ProductService, :GetProduct, { id: 1 })
+    #   response.title  # => "Widget"
+    #
+    #   expect { Tonic::Rails::Testing.call(ProductService, :GetProduct, { id: 0 }) }
+    #     .to raise_error(Tonic::Rails::RpcError) { |e| expect(e.code_name).to eq(:not_found) }
+    module Testing
+      # Request side of a call: yields pre-encoded messages.
+      class Reader
+        def initialize(messages, error: nil)
+          @messages = messages.dup
+          @error = error
+        end
+
+        def next
+          @messages.shift
+        end
+
+        attr_reader :error
+      end
+
+      # Response side of a call: collects encoded messages.
+      class Sender
+        attr_reader :messages
+
+        def initialize
+          @messages = []
+        end
+
+        def push(bytes)
+          @messages << bytes
+        end
+      end
+
+      module_function
+
+      # @param service_class [Class] handler class
+      # @param rpc_name [Symbol, String] RPC name as in the .proto
+      # @param request [Google::Protobuf::AbstractMessage, Hash, Array] the
+      #   request; an Array of them for client- and bidi-streaming RPCs
+      # @param metadata [Hash{String=>String}]
+      # @param timeout_ms [Integer, nil] simulated client deadline
+      # @return [Google::Protobuf::AbstractMessage, Array] the response, or
+      #   an Array of responses for server- and bidi-streaming RPCs
+      # @raise [RpcError] when the handler ends the call with a status
+      def call(service_class, rpc_name, request, metadata: {}, timeout_ms: nil)
+        spec = service_class.grpc_rpcs.fetch(rpc_name.to_s) do
+          raise ArgumentError, "#{service_class} has no RPC #{rpc_name}"
+        end
+
+        requests = spec[:request_stream] ? Array(request) : [request]
+        reader = Reader.new(requests.map { |r| encode(spec[:request], r) })
+        sender = Sender.new
+
+        result = service_class.new.call_rpc(
+          rpc_name.to_s,
+          metadata: metadata.transform_keys(&:to_s),
+          reader: reader,
+          sender: sender,
+          timeout_ms: timeout_ms,
+        )
+
+        if spec[:response_stream]
+          sender.messages.map { |bytes| spec[:response].decode(bytes) }
+        else
+          spec[:response].decode(result)
+        end
+      end
+
+      def encode(klass, message)
+        message = klass.new(message) if message.is_a?(Hash)
+        klass.encode(message)
+      end
+    end
+  end
+end

data/lib/tonic/rails/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Tonic
+  module Rails
+    VERSION = "0.1.0"
+  end
+end

data/lib/tonic-rails.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+require "google/protobuf"
+
+module Tonic
+  module Rails
+    class Error < StandardError; end
+    class NotConfiguredError < Error; end
+  end
+end
+
+require "tonic/rails/version"
+require "tonic/rails/rpc_error"
+require "tonic/rails/configuration"
+require "tonic/rails/router"
+require "tonic/rails/base"
+require "tonic/rails/reflection"
+require "tonic/rails/server"
+
+module Tonic
+  module Rails
+    @configuration = Configuration.new
+    @shutting_down = false
+    @native_load_error = nil
+
+    class << self
+      attr_reader :configuration
+
+      def configure
+        yield @configuration
+      end
+
+      # The process-wide server used by the Railtie and rake tasks.
+      def server
+        @server ||= Server.new
+      end
+
+      # True once shutdown has begun.  Long-running handlers (especially
+      # streams) should check this and finish early.
+      def cancelled?
+        @shutting_down
+      end
+
+      # @api private
+      def _set_shutting_down(value)
+        @shutting_down = value
+      end
+
+      # @api private
+      # Log an unexpected exception (and hand it to the Rails error
+      # reporter, if present) without exposing it to the client.
+      def log_exception(error, context)
+        configuration.logger&.error(
+          "tonic-rails: #{context}: #{error.class}: #{error.message}\n" \
+          "#{Array(error.backtrace).first(20).join("\n")}",
+        )
+        if defined?(::Rails.error) && ::Rails.respond_to?(:error)
+          ::Rails.error.report(error, handled: true, source: "tonic-rails", context: { rpc: context })
+        end
+      rescue StandardError
+        nil
+      end
+
+      # @api private
+      def native_extension!
+        return if defined?(::TonicRails::Native::Server)
+
+        raise Error, "tonic-rails native extension is not available " \
+                     "(#{@native_load_error&.message || 'unknown error'}). " \
+                     "Reinstall the gem, or run `bundle exec rake compile` in a checkout."
+      end
+
+      # @api private
+      def load_native_extension
+        # Precompiled platform gems ship one binary per Ruby minor version.
+        ruby_version = RUBY_VERSION[/\d+\.\d+/]
+        require "tonic/rails/#{ruby_version}/tonic_rails_native"
+      rescue LoadError
+        begin
+          require "tonic/rails/tonic_rails_native"
+        rescue LoadError => e
+          @native_load_error = e
+        end
+      end
+    end
+
+    load_native_extension
+  end
+end
+
+require "tonic/rails/railtie" if defined?(Rails::Railtie)

metadata

@@ -0,0 +1,107 @@
+--- !ruby/object:Gem::Specification
+name: tonic-rails
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: aarch64-linux-gnu
+authors:
+- Matt Tanous
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-10-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+- !ruby/object:Gem::Dependency
+  name: google-protobuf
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.27'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.27'
+description: |
+  Tonic::Rails serves gRPC from Rails applications. The transport layer
+  (HTTP/2 framing, connection management, TLS, health checks, reflection)
+  is handled by tonic in Rust and exposed to Ruby through a native
+  extension built with Magnus. Protobuf (de)serialization and business
+  logic remain in Ruby, giving you Rails-grade handlers, routing,
+  interceptors, and the Rails executor around every RPC.
+email:
+- matt.tanous@hey.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/tonic-rails.rb
+- lib/tonic/rails/3.3/tonic_rails_native.so
+- lib/tonic/rails/3.4/tonic_rails_native.so
+- lib/tonic/rails/4.0/tonic_rails_native.so
+- lib/tonic/rails/base.rb
+- lib/tonic/rails/configuration.rb
+- lib/tonic/rails/railtie.rb
+- lib/tonic/rails/reflection.rb
+- lib/tonic/rails/router.rb
+- lib/tonic/rails/rpc_error.rb
+- lib/tonic/rails/server.rb
+- lib/tonic/rails/tasks/tonic-rails.rake
+- lib/tonic/rails/testing.rb
+- lib/tonic/rails/version.rb
+homepage: https://github.com/CodingAnarchy/tonic-rails
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/CodingAnarchy/tonic-rails
+  source_code_uri: https://github.com/CodingAnarchy/tonic-rails
+  bug_tracker_uri: https://github.com/CodingAnarchy/tonic-rails/issues
+  changelog_uri: https://github.com/CodingAnarchy/tonic-rails/blob/main/CHANGELOG.md
+  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.3'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: 4.1.dev
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.11
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.22
+requirements: []
+rubygems_version: 3.5.23
+signing_key: 
+specification_version: 4
+summary: High-performance gRPC endpoints for Rails, powered by tonic via a Rust native
+  extension
+test_files: []