gRPC Python

The Python facility of gRPC.

Status

Usable with limitations, Pre-Alpha

Prerequisites

Python 2.7, virtualenv, pip, libprotobuf-dev, and libprotoc-dev.

Building from source

$ make shared_c static_c
  • Use build_python.sh to build the Python code and install it into a virtual environment
$ tools/run_tests/build_python.sh

Testing

  • Use run_python.sh to run gRPC as it was installed into the virtual environment
$ tools/run_tests/run_python.sh

Installing

  • Install the gRPC core

    • Debian package
      $ wget https://github.com/grpc/grpc/releases/download/release-0_5_0/libgrpc_0.5.0_amd64.deb
      $ wget https://github.com/grpc/grpc/releases/download/release-0_5_0/libgrpc-dev_0.5.0_amd64.deb
      $ sudo dpkg -i libgrpc_0.5.0_amd64.deb libgrpc-dev_0.5.0_amd64.deb
      
    • From source
  • Install gRPC Python's dependencies

$ pip install -r src/python/requirements.txt
  • Install gRPC Python
$ pip install src/python/src

Packaging to PyPI

  • Install packaging dependencies
$ pip install setuptools twine
  • Push to PyPI
$ ../../tools/distrib/python/submit.py