Tim Emiola e69e13dc10 Update README.md 10 years ago
..
lib 56dff9f757 Adds the generated code for the route_guide example 10 years ago
route_guide e7b8164978 added link to new public proto3 doc 10 years ago
.gitignore 49f3ccdd01 Adds a helloworld sample in ruby. 10 years ago
Gemfile 04b6a62c52 We can now use the gRPC gem directly from git. 10 years ago
README.md e69e13dc10 Update README.md 10 years ago
greeter_client.rb 49f3ccdd01 Adds a helloworld sample in ruby. 10 years ago
greeter_server.rb 600d70cd8d change proto README cpp node ruby 10 years ago
grpc-demo.gemspec 498000c518 removes an unnecessary restriction 10 years ago

README.md

gRPC in 3 minutes (Ruby)

BACKGROUND

For this sample, we've already generated the server and client stubs from helloworld.proto

PREREQUISITES

  • Ruby 2.x This requires Ruby 2.x, as the gRPC API surface uses keyword args. If you don't have that installed locally, you can use RVM to use Ruby 2.x for testing without upgrading the version of Ruby on your whole system. RVM is also useful if you don't have the necessary privileges to update your system's Ruby.

    $ # RVM installation as specified at https://rvm.io/rvm/install
    $ gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3
    $ \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
    
  • N.B Make sure your run source $HOME/.rvm/scripts/rvm as instructed to complete the set-up of RVM.

INSTALL

  • Clone this repository
  • Use bundler to install the example package's dependencies

    $ # from this directory
    $ gem install bundler # if you don't already have bundler available
    $ bundle install
    

Try it!

  • Run the server

    $ # from this directory
    $ bundle exec ./greeter_server.rb &
    
  • Run the client

    $ # from this directory
    $ bundle exec ./greeter_client.rb
    

Tutorial

You can find a more detailed tutorial in gRPC Basics: Ruby