rails_respond_to_pb 0.1.3 → 0.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +30 -18
- data/lib/rails_respond_to_pb/version.rb +1 -1
- data/rails_respond_to_pb.gemspec +1 -1
- metadata +7 -7
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 1c322c035c9d8609dc8627e797c78c18a180646114ca046e712de5c602833471
|
4
|
+
data.tar.gz: 4620238b1f729bf8afff9f914e89c66d2f28fd19527012bbbd292302cd5da68d
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 2e46f10d9b60f0670413af3683d9ef4ad72d6f84ac1e7773d2bb690ac8e62273e8f48d4de3bd0dc8db2296c7a2eb661d2380945f1a3dec45fa4408392da4a7a8
|
7
|
+
data.tar.gz: 7888edb96143bba2691b486e81368bf3917d20ddd1c6fe66a47b2d7f388fe6b0c3808d01cbeafdcfe2ee7e97bc0e0ab72ab59e20759b049f0ac10cc6ad2d306a
|
data/README.md
CHANGED
@@ -1,5 +1,7 @@
|
|
1
1
|
# rails_respond_to_pb
|
2
2
|
|
3
|
+
[](https://badge.fury.io/rb/rails_respond_to_pb)
|
4
|
+
|
3
5
|
This gem allows you to route RPC calls via protobuf to an existing rails controller. Currently supporting:
|
4
6
|
|
5
7
|
- [Twirp](https://github.com/twitchtv/twirp-ruby)
|
@@ -31,7 +33,8 @@ This gem loads Rails middleware that routes to services with Controllers as Hand
|
|
31
33
|
- assumes a single `ThingsService` per controller
|
32
34
|
- Typical Rails namey-ness conventions are followed here
|
33
35
|
- assumes a `ThingsService` routes to a `ThingsController`
|
34
|
-
-
|
36
|
+
- looking into building generating proto files from controllers
|
37
|
+
- loads any `_twirp.rb` files that exist within your app's `lib` directory
|
35
38
|
- allows a controller to `respond_to` the `pb` format
|
36
39
|
- currently you'd respond with a `render plain: ThingResponse.new(id: 1, name: 'Foo').to_proto`
|
37
40
|
- looking into `render pb:`
|
@@ -44,11 +47,11 @@ syntax = "proto3";
|
|
44
47
|
service Things {
|
45
48
|
// these rpc methods are important - use what's in the corresponding ThingsController.
|
46
49
|
// whatever is sent as an argument will be made available to the controller as `params`
|
47
|
-
rpc
|
48
|
-
rpc
|
49
|
-
rpc
|
50
|
-
rpc
|
51
|
-
rpc
|
50
|
+
rpc Create (ThingParams) returns (ThingResponse);
|
51
|
+
rpc Show (ThingParams) returns (ThingResponse);
|
52
|
+
rpc Index (ThingFilter) returns (ThingList);
|
53
|
+
rpc Update (ThingParams) returns (ThingResponse);
|
54
|
+
rpc Destroy (ThingParams) returns (ThingResponse);
|
52
55
|
}
|
53
56
|
|
54
57
|
message ThingParams {
|
@@ -97,6 +100,15 @@ respond_to do |format|
|
|
97
100
|
render plain: YourProtoResponse.to_proto
|
98
101
|
```
|
99
102
|
|
103
|
+
Of note, if you're trying to wire up **entirely new** methods, you do **NOT** need this gem at all, and you can simply add this to your routes file:
|
104
|
+
|
105
|
+
```ruby
|
106
|
+
handler = ThingsHandler.new()
|
107
|
+
service = ThingsService.new(handler)
|
108
|
+
|
109
|
+
mount service, at: service.full_name
|
110
|
+
```
|
111
|
+
|
100
112
|
### Client
|
101
113
|
|
102
114
|
Assuming you have the prerequisite Client files loaded in your application, you can connect to a Twirp server as usual:
|
@@ -107,6 +119,18 @@ query = ThingFilter.new name: 'foo'
|
|
107
119
|
client.index(query)
|
108
120
|
```
|
109
121
|
|
122
|
+
## Development
|
123
|
+
|
124
|
+
I typically add an alias to make working with dockerized apps easier. This assumes [docker](https://docs.docker.com/get-docker/) is running.
|
125
|
+
|
126
|
+
```sh
|
127
|
+
alias dr="docker compose run --rm "
|
128
|
+
```
|
129
|
+
|
130
|
+
After checking out the repo, run `dr bundle install` to spin up a container, and install dependencies. Then, run `dr rspec spec` to run the tests. You can also run `dr bundle console` for an interactive prompt that will allow you to experiment.
|
131
|
+
|
132
|
+
To release a new version, update the version number in `version.rb`, and then run `dr bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
|
133
|
+
|
110
134
|
### Building protos
|
111
135
|
|
112
136
|
For inspiration on how to build proto files locally (and working with docker-compose), here are some services to use within your application:
|
@@ -154,18 +178,6 @@ FROM ruby:3
|
|
154
178
|
COPY --from=go /go/bin /usr/local/bin
|
155
179
|
```
|
156
180
|
|
157
|
-
## Development
|
158
|
-
|
159
|
-
I typically add an alias to make working with dockerized apps easier. This assumes [docker](https://docs.docker.com/get-docker/) is running.
|
160
|
-
|
161
|
-
```sh
|
162
|
-
alias dr="docker compose run --rm "
|
163
|
-
```
|
164
|
-
|
165
|
-
After checking out the repo, run `dr bundle install` to spin up a container, and install dependencies. Then, run `dr rspec spec` to run the tests. You can also run `dr bundle console` for an interactive prompt that will allow you to experiment.
|
166
|
-
|
167
|
-
To release a new version, update the version number in `version.rb`, and then run `dr bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
|
168
|
-
|
169
181
|
## Contributing
|
170
182
|
|
171
183
|
Bug reports and pull requests are welcome on [GitHub](https://github.com/[USERNAME]/rails_respond_to_pb). This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/rails_respond_to_pb/blob/main/CODE_OF_CONDUCT.md).
|
data/rails_respond_to_pb.gemspec
CHANGED
@@ -12,7 +12,7 @@ Gem::Specification.new do |spec|
|
|
12
12
|
spec.description = 'Middleware for a Rails App providing functionality for gRPC and Twirp'
|
13
13
|
spec.homepage = 'https://github.com/dudo/rails_respond_to_pb'
|
14
14
|
spec.license = 'MIT'
|
15
|
-
spec.required_ruby_version = Gem::Requirement.new('>=
|
15
|
+
spec.required_ruby_version = Gem::Requirement.new('>= 2.7')
|
16
16
|
|
17
17
|
# spec.metadata['allowed_push_host'] = 'http://mygemserver.com'
|
18
18
|
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: rails_respond_to_pb
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.1.
|
4
|
+
version: 0.1.4
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Brett C. Dudo
|
8
|
-
autorequire:
|
8
|
+
autorequire:
|
9
9
|
bindir: exe
|
10
10
|
cert_chain: []
|
11
|
-
date: 2021-
|
11
|
+
date: 2021-12-21 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: grpc-tools
|
@@ -87,7 +87,7 @@ metadata:
|
|
87
87
|
homepage_uri: https://github.com/dudo/rails_respond_to_pb
|
88
88
|
source_code_uri: https://github.com/dudo/rails_respond_to_pb
|
89
89
|
changelog_uri: https://github.com/dudo/rails_respond_to_pb/blob/main/CHANGELOG.md
|
90
|
-
post_install_message:
|
90
|
+
post_install_message:
|
91
91
|
rdoc_options: []
|
92
92
|
require_paths:
|
93
93
|
- lib
|
@@ -95,15 +95,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
|
|
95
95
|
requirements:
|
96
96
|
- - ">="
|
97
97
|
- !ruby/object:Gem::Version
|
98
|
-
version:
|
98
|
+
version: '2.7'
|
99
99
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
100
100
|
requirements:
|
101
101
|
- - ">="
|
102
102
|
- !ruby/object:Gem::Version
|
103
103
|
version: '0'
|
104
104
|
requirements: []
|
105
|
-
rubygems_version: 3.2.
|
106
|
-
signing_key:
|
105
|
+
rubygems_version: 3.2.32
|
106
|
+
signing_key:
|
107
107
|
specification_version: 4
|
108
108
|
summary: Middleware for a Rails App providing functionality for gRPC and Twirp
|
109
109
|
test_files: []
|