Initial checkin of gRPC to third_party/

third_party/grpc/src/python/grpcio/README.rst

Index: third_party/grpc/src/python/grpcio/README.rst
diff --git a/third_party/grpc/src/python/grpcio/README.rst b/third_party/grpc/src/python/grpcio/README.rst
new file mode 100644
index 0000000000000000000000000000000000000000..3dfae50b4bc030b12bc401c75f52caabe3f6b2b4
--- /dev/null
+++ b/third_party/grpc/src/python/grpcio/README.rst
@@ -0,0 +1,58 @@
+gRPC Python
+===========
+
+Package for gRPC Python.
+
+Installation
+------------
+
+gRPC Python is available for Linux, Mac OS X, and Windows running Python 2.7.
+
+From PyPI
+~~~~~~~~~
+
+If you are installing locally...
+
+::
+
+  $ pip install grpcio
+
+Else system wide (on Ubuntu)...
+
+::
+
+  $ sudo pip install grpcio
+
+n.b. On Windows and on Mac OS X one *must* have a recent release of :code:`pip`
+to retrieve the proper wheel from PyPI. Be sure to upgrade to the latest
+version!
+
+From Source
+~~~~~~~~~~~
+
+Building from source requires that you have the Python headers (usually a
+package named :code:`python-dev`).
+
+::
+
+  $ export REPO_ROOT=grpc
+  $ git clone https://github.com/grpc/grpc.git $REPO_ROOT
+  $ cd $REPO_ROOT
+  $ pip install .
+
+Note that :code:`$REPO_ROOT` can be assigned to whatever directory name floats
+your fancy.
+
+Troubleshooting
+~~~~~~~~~~~~~~~
+
+Help, I ...
+
+* **... see a** :code:`pkg_resources.VersionConflict` **when I try to install
+  grpc!**
+
+  This is likely because :code:`pip` doesn't own the offending dependency,
+  which in turn is likely because your operating system's package manager owns
+  it. You'll need to force the installation of the dependency:
+
+  :code:`pip install --ignore-installed $OFFENDING_DEPENDENCY`