David Garcia Quintas b44b385ad2 Merge branch 'fix_cpp_deps' of https://github.com/dgquintas/grpc into bb_reader_error 10 жил өмнө
..
bin b39ad701ea Added comments to ruby code generation 10 жил өмнө
ext b44b385ad2 Merge branch 'fix_cpp_deps' of https://github.com/dgquintas/grpc into bb_reader_error 10 жил өмнө
lib 13c22ae595 Resolved merge conflicts with master 10 жил өмнө
pb 67e2525892 Fix handling of one error in bidi calls, and one interop server method 10 жил өмнө
qps 11ca9d8dc0 Merge pull request #6674 from murgatroid99/node_ruby_codegen_comments 10 жил өмнө
spec d9d9ba9302 Updated compression tests with batch API changes 10 жил өмнө
stress ddaa69f15d Got Ruby stress client working, with some modifications to interop tests 10 жил өмнө
tools d29a3bf004 Update master branch to 0.16.0-dev 10 жил өмнө
.gitignore 097ef9b7d9 Incorporating ruby into the master grpc repository. 11 жил өмнө
.rubocop.yml 59dfee8800 Fixed rubocop issues with newest changes 10 жил өмнө
.rubocop_todo.yml aa57bab3ca Corrects the cancel_after_first_response behaviour 11 жил өмнө
CHANGELOG.md 51a4c0846b Corrects the Changelog date 11 жил өмнө
README.md d8521e75c8 Update Ruby README with simpler install instructions 10 жил өмнө

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