aboutsummaryrefslogtreecommitdiffhomepage
path: root/src/ruby/README.md
diff options
context:
space:
mode:
authorGravatar Tim Emiola <temiola@google.com>2015-02-19 09:39:49 -0800
committerGravatar Tim Emiola <temiola@google.com>2015-02-19 09:39:49 -0800
commitc33efe4ad58a9d0fc2e60f19f59ba8c095020844 (patch)
tree2db290654a73b0322e43a8ced07f742bae0b8611 /src/ruby/README.md
parent50b91d001811df0c6cdda17137ce706d9bcb5458 (diff)
Fixes the grpc.gemspec, clarifies the installation instructions
Diffstat (limited to 'src/ruby/README.md')
-rwxr-xr-xsrc/ruby/README.md25
1 files changed, 13 insertions, 12 deletions
diff --git a/src/ruby/README.md b/src/ruby/README.md
index 7ece7e2706..d9e33f87fa 100755
--- a/src/ruby/README.md
+++ b/src/ruby/README.md
@@ -1,7 +1,7 @@
gRPC Ruby
=========
-A Ruby implementation of gRPC, Google's RPC library.
+A Ruby implementation of gRPC.
INSTALLATION PREREQUISITES
@@ -10,29 +10,30 @@ INSTALLATION PREREQUISITES
This requires Ruby 2.x, as the rpc api surface uses keyword args.
-INSTALLING
-----------
+QUICK - INSTALL
+---------------
-- Install the gRPC core library
- TODO: describe this, once the core distribution mechanism is defined.
+- Clone this repository.
+- Follow the instructions in the [INSTALL](../../INSTALL) to install grpc C core library.
+- Use bundler to install
+```sh
+$ # from this directory
+$ gem install bundler && bundle install
```
-$ gem install grpc
-```
-
Installing from source
----------------------
- Build or Install the gRPC core
E.g, from the root of the grpc [git repo](https://github.com/google/grpc)
-```
+```sh
$ cd ../..
$ make && sudo make install
```
- Install Ruby 2.x. Consider doing this with [RVM](http://rvm.io), it's a nice way of controlling
the exact ruby version that's used.
-```
+```sh
$ command curl -sSL https://rvm.io/mpapis.asc | gpg --import -
$ \curl -sSL https://get.rvm.io | bash -s stable --ruby
$
@@ -46,7 +47,7 @@ $ gem install bundler
```
- Finally, install grpc ruby locally.
-```
+```sh
$ cd <install_dir>
$ bundle install
$ rake # compiles the extension, runs the unit tests, see rake -T for other options
@@ -69,6 +70,6 @@ Directory structure is the layout for [ruby extensions](http://guides.rubygems.o
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, INFINITE_FUTURE)
+resp = stub.div(req)
logger.info("Answer: #{resp.inspect}")
```