Nicolas Noble 3f2fad6c20 Merge pull request #6371 from murgatroid99/ruby_tools_gem 9 ani în urmă
..
bin e621f13ecd Simplified ruby interop test files 9 ani în urmă
ext 9003768b0a Fixed unused parameter error 9 ani în urmă
lib 9e3538c57d Load default roots.pem in Ruby via grpc_set_ssl_roots_override_callback 9 ani în urmă
pb ddaa69f15d Got Ruby stress client working, with some modifications to interop tests 9 ani în urmă
qps 8ecd4d7aa6 Add support for an "OTHER" value in client_type, server_type, and add a string to 9 ani în urmă
spec c0862859be ruby: Add test case for referring external package 9 ani în urmă
stress ddaa69f15d Got Ruby stress client working, with some modifications to interop tests 9 ani în urmă
tools 8e4512ba48 Reversed premature removal of a file 9 ani în urmă
.gitignore 097ef9b7d9 Incorporating ruby into the master grpc repository. 11 ani în urmă
.rubocop.yml d48d84da19 Ruby: fix some synchronization code in server implementation 9 ani în urmă
.rubocop_todo.yml aa57bab3ca Corrects the cancel_after_first_response behaviour 10 ani în urmă
CHANGELOG.md 51a4c0846b Corrects the Changelog date 10 ani în urmă
README.md d8521e75c8 Update Ruby README with simpler install instructions 10 ani în urmă

README.md

Gem

gRPC Ruby

A Ruby implementation of gRPC.

Status

Beta

PREREQUISITES

  • Ruby 2.x. The gRPC API uses keyword args.

INSTALLATION

Linux and Mac OS X:

gem install grpc

BUILD FROM SOURCE

  • Clone this repository

  • 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}")