gritz 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: cb226dd8bf426c8d12c7f625ea6966c9934939253ae52dab3ccc7994fa465a71
+  data.tar.gz: cff37f83aadc7ebaccfefcbc6b1f1dc49aa928279bedb621cbfd406b0ac374df
+SHA512:
+  metadata.gz: 79f29f7b897f4dd4ac1e19a10e0e5b650dd4071996403d033a3d1cde5a6687401adb2179c8db9245b2abda817ccd9e9459dd07a407fb98915c459e17b08fbcc6
+  data.tar.gz: 91a6b189a9486d3978a084e99c3e4534dfa3238b4c8aa38f53c224ea95c1ba7e8598af5c2460ae9fb033466ddce18a8bc7155db0813c664e7c9b08a721d9e90a

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.1.0
+
+Initial release.

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Yudai Takada
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,112 @@
+# Gritz
+
+Gritz is a Ruby gRPC application framework with controllers, middleware and network-free controller tests. It supports a single-process C-core server and all four RPC forms: unary, server streaming, client streaming and bidirectional streaming.
+
+Requires CRuby 3.3 or later and grpc 1.83 or later. Linux and macOS are tested.
+
+## Packages
+
+| Gem | Repository | Role |
+| --- | --- | --- |
+| `gritz` | [gritzrpc/gritz](https://github.com/gritzrpc/gritz) | Default combination and executable |
+| `gritz-core` | [gritzrpc/gritz-core](https://github.com/gritzrpc/gritz-core) | Transport-independent application framework |
+| `gritz-native` | [gritzrpc/gritz-native](https://github.com/gritzrpc/gritz-native) | Official grpc gem adapter and thread pool |
+
+After v0.1.0 is published, applications can add `gem "gritz", "~> 0.1.0"` to their Gemfile. It installs both the core and native adapter. The Fiber adapter `gritz-async` and integrations `gritz-rails` / `gritz-otel` are planned.
+
+## Quickstart from source
+
+```bash
+git clone https://github.com/gritzrpc/gritz.git
+cd gritz
+bundle install
+bundle exec ruby exe/gritz routes -C examples/hello/config/gritz.rb
+bundle exec ruby exe/gritz start -C examples/hello/config/gritz.rb
+```
+
+In another terminal, run `bundle exec ruby examples/hello/client.rb`. It calls all four RPC forms. To use grpcurl, supply the bundled proto:
+
+```bash
+grpcurl -plaintext -import-path examples/hello/proto -proto hello.proto \
+  -d '{"name":"Ruby"}' localhost:50051 helloworld.Greeter/SayHello
+```
+
+## Controllers
+
+```ruby
+class GreeterController < Gritz::Controller
+  bind Helloworld::Greeter::Service
+
+  def say_hello
+    fail!(:invalid_argument, "name is required") if request.message.name.empty?
+    Helloworld::HelloReply.new(message: "Hello, #{request.message.name}!")
+  end
+
+  def chat
+    request.each_message do |message|
+      stream.write(Helloworld::HelloReply.new(message: message.name.upcase))
+    end
+  end
+end
+```
+
+Register controllers in a configuration file:
+
+```ruby
+require_relative "../app/greeter_controller"
+
+workers 0
+threads 16
+bind "127.0.0.1:50051"
+register_controller GreeterController
+```
+
+Set `strict_routes true` once every RPC in the bound service has an action; otherwise missing actions return `UNIMPLEMENTED`.
+
+`before_action`, `around_action`, `after_action` and `rescue_from` support inheritance. Each RPC gets its own controller instance. `Gritz::Context.current` carries metadata, deadline, peer, request ID and a per-request store; child fibers and threads inherit it. Requests exceeding their deadline are rejected cooperatively at request reads and response writes. `context.check_deadline!` can also be called during application work.
+
+The default middleware adds request IDs, scopes context, writes JSON completion logs and converts exceptions to gRPC errors. Internal errors expose an `error-id` trailer rather than application exception messages. `fail!` accepts status symbols, trailing metadata and protobuf rich error details. Middleware wraps the full stream, including incremental response writes.
+
+## Testing
+
+```ruby
+require "gritz/testing/rspec"
+
+RSpec.describe GreeterController, type: :rpc do
+  it "greets a user" do
+    reply = rpc(:say_hello, Helloworld::HelloRequest.new(name: "Ruby"))
+    expect(reply.message).to eq("Hello, Ruby!")
+  end
+
+  it "validates names" do
+    expect { rpc(:say_hello, Helloworld::HelloRequest.new) }
+      .to raise_rpc_error(:invalid_argument)
+  end
+end
+```
+
+Minitest tests can include `Gritz::Testing::Minitest` after requiring `gritz/testing/minitest`; pass `controller:` to `rpc` and use `assert_rpc_error`. `Gritz::Testing::Server.start(controllers: [GreeterController]) { |server| ... }` starts a real server on an ephemeral port and stops it when the block exits.
+
+## Configuration and limitations
+
+Configuration precedence is CLI options, `GRITZ_*` environment variables, configuration file, then defaults. See the [configuration guide](docs/guides/configuration.md) for settings and lifecycle hooks.
+
+Use `TERM` or `INT` to finish in-flight calls within `shutdown_timeout`; `QUIT` closes immediately. Application code should check deadlines and cancellation during long work. The grpc 1.83 server view can report cancellation late; deadlines remain the practical limit for long handlers. The native thread pool rejects excess requests immediately with `RESOURCE_EXHAUSTED`; grpc 1.83 ignores its deprecated `max_waiting_requests` setting.
+
+The server binds insecure gRPC sockets. Use a trusted network or a TLS-terminating proxy. Native TLS, health checks, reflection, metrics export and multi-process supervision are unavailable. Unsupported transport, worker and TLS features fail at startup.
+
+The default transport is `:native` (`Gritz::Transport::Native`). `gritz-core` can be loaded separately with `require "gritz/core"` without loading grpc.
+
+## Development
+
+Each repository has its own tests, CI and package build. Development dependencies come from their Git repositories; sibling checkouts are optional. See [CONTRIBUTING.md](CONTRIBUTING.md) to work on local components.
+
+Run `bundle exec rake`, `COVERAGE=1 bundle exec rspec`, `bundle exec rubocop` and `bundle exec rake build`. The [Linux devcontainer](.devcontainer/devcontainer.json) includes grpcurl and ghz. See the [release guide](docs/guides/releasing.md) for publishing packages.
+
+## Contributing
+
+Bug reports and pull requests are welcome on [GitHub](https://github.com/gritzrpc/gritz). See [CONTRIBUTING.md](CONTRIBUTING.md) and [SECURITY.md](SECURITY.md).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/exe/gritz

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "gritz"
+
+exit Gritz::CLI.new.run(ARGV)

data/lib/gritz/version.rb

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

data/lib/gritz.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require_relative "gritz/version"
+require "gritz/core"
+require "gritz/native"

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification
+name: gritz
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Yudai Takada
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: gritz-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: gritz-native
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+description: Gritz combines transport-independent controllers, middleware and testing
+  with a gRPC C-core server.
+email:
+- t.yudai92@gmail.com
+executables:
+- gritz
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- exe/gritz
+- lib/gritz.rb
+- lib/gritz/version.rb
+homepage: https://github.com/gritzrpc/gritz
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  source_code_uri: https://github.com/gritzrpc/gritz
+  changelog_uri: https://github.com/gritzrpc/gritz/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.16
+specification_version: 4
+summary: A controller-based Ruby gRPC application framework
+test_files: []