Skip to content
Snippets Groups Projects
Select Git revision
  • f90ce677b38391e57fcf071a30cd393731a0f223
  • master default protected
  • arm-aarch-platform
  • arm-platform
  • vjpai-patch-3
  • vjpai-patch-1
  • v1.27.x
  • jtattermusch-patch-2
  • jtattermusch-patch-1
  • update-java-worker-example-in-performance-docs
  • revert-21805-revert-21797-reintroduce_21527
  • revert-21804-tls-credentials-1
  • zhen_cleanup_namecheck
  • revert-21806-revert-21767-revert-21725-revert-21680-cq_ordering
  • vjpai-patch-2
  • revert-21766-tls-credentials-1
  • revert-21640-change_local_tcp_security_level
  • revert-21680-cq_ordering
  • revert-21527-unify_boringssl_deps2
  • revert-20803-grpclb_stabilization
  • fix-kokoro-rvm-key
  • v1.27.0
  • v1.27.0-pre2
  • v1.27.0-pre1
  • v1.26.0
  • v1.26.0-pre1
  • v1.25.0
  • v1.25.0-pre1
  • v1.24.3
  • v1.24.2
  • v1.24.1
  • v1.23.1
  • v1.24.0
  • v1.24.0-pre2
  • v1.24.0-pre1
  • v1.22.1
  • v1.23.0
  • v1.23.0-pre1
  • v1.22.0
  • v1.22.0-pre1
  • v1.21.4
41 results

ruby

  • Clone with SSH
  • Clone with HTTPS
  • user avatar
    Tim Emiola authored
    f90ce677
    History

    gRPC Ruby

    A Ruby implementation of gRPC.

    Status

    Alpha : Ready for early adopters

    INSTALLATION PREREQUISITES

    This requires Ruby 2.1, as the RPC API surface uses keyword args.

    QUICK - INSTALL

    • Clone this repository.
    • Follow the instructions in INSTALL to install the gRPC C core.
    • If you don't have Ruby 2.1 installed, switch to the more detailed instructions below
    • Use bundler to install
    $ # from this directory
    $ gem install bundler && bundle install

    Installing from source

    • Build the gRPC C core E.g, from the root of the gRPC git repo
    $ cd ../..
    $ make && sudo make install
    • Install Ruby 2.1. 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.1
    $
    $ # 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, 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

    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 unittest
    • 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)
    logger.info("div(7/3): req=#{req.inspect}")
    resp = stub.div(req)
    logger.info("Answer: #{resp.inspect}")