Chiebot-Mirror
/
grpc
mirror of https://github.com/grpc/grpc.git
8
0
Fork 0
Code Issues Projects Releases Wiki Activity
The C based gRPC (C++, Python, Ruby, Objective-C, PHP, C#) https://grpc.io/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
5236 Commits
274 Branches
377 Tags
1.2 GiB
 
 
 
 
 
 
Tag: Branch: Tree: 1911c3b2c4
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '1911c3b2c4'
${ noResults }
grpc/src/ruby
Craig Tiller 4671122995
Merge branch 'you-complete-me' into we-dont-need-no-backup 		10 years ago
..
bin Corrects the cancel_after_first_response test 10 years ago
ext/grpc Changes to byte_buffer based on comments. 10 years ago
lib Update version; fix dependency advisory comment 10 years ago
spec Merge github.com:grpc/grpc into we-dont-need-no-backup 10 years ago
.gitignore Incorporating ruby into the master grpc repository. 10 years ago
.rspec Add SimpleCov coverage set up for gRPC ruby 10 years ago
.rubocop.yml Adds rubocop and fixes most style violations it detected 10 years ago
.rubocop_todo.yml Various tweaks to improve server stability 10 years ago
CHANGELOG.md Corrects the Changelog date 10 years ago
Gemfile Switches to using protobuf-ruby. 10 years ago
README.md Update INSTALL on Ruby README.md 10 years ago
Rakefile Add SimpleCov coverage set up for gRPC ruby 10 years ago
grpc.gemspec Update version; fix dependency advisory comment 10 years ago

README.md

gRPC Ruby

A Ruby implementation of gRPC.

Status

Alpha : Ready for early adopters

PREREQUISITES

  • Ruby 2.x. The gRPC API uses keyword args.
  • homebrew on Mac OS X, linuxbrew on Linux. These simplify the installation of the gRPC C core.

INSTALLATION

On Mac OS X, install homebrew. On Linux, install linuxbrew. Run the following command to install gRPC Ruby.

$ curl -fsSL https://goo.gl/getgrpc | bash -s ruby

This will download and run the gRPC install script, then install the latest version of gRPC Ruby gem. It also installs Protocol Buffers compiler (protoc) and the gRPC protoc plugin for ruby.

BUILD FROM SOURCE

  • Clone this repository
  • Build the gRPC C core E.g, from the root of the gRPC Git repository
$ cd ../..
$ make && sudo make install
  • Install Ruby 2.x. Consider doing this with RVM, it's a nice way of controlling the exact ruby version that's used.
$ command curl -sSL https://rvm.io/mpapis.asc | gpg --import -
$ \curl -sSL https://get.rvm.io | bash -s stable --ruby=ruby-2
$
$ # follow the instructions to ensure that your're using the latest stable version of Ruby
$ # and that the rvm command is installed

  • Make sure your run source $HOME/.rvm/scripts/rvm as instructed to complete the set up of RVM

  • Install bundler

$ gem install bundler
  • Finally, build and install the gRPC gem locally.
$ # from this directory
$ bundle install  # creates the ruby bundle, including building the grpc extension
$ rake  # runs the unit tests, see rake -T for other options

DOCUMENTATION

  • rubydoc for the gRPC gem is available online at rubydoc.
  • the gRPC Ruby reference documentation is available online at grpc.io

CONTENTS

Directory structure is the layout for ruby extensions

  • ext: the gRPC ruby extension

  • lib: the entrypoint gRPC ruby library to be used in a 'require' statement

  • spec: Rspec unittests

  • bin: example gRPC clients and servers, e.g,

    stub = Math::Math::Stub.new('my.test.math.server.com:8080')
req = Math::DivArgs.new(dividend: 7, divisor: 3)
GRPC.logger.info("div(7/3): req=#{req.inspect}")
resp = stub.div(req)
GRPC.logger.info("Answer: #{resp.inspect}")