gRPC Python

The Python facility of gRPC.

Status

Alpha : Ready for early adopters

Prerequisites

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

Building from source

• Build the gRPC core from the root of the gRPC git repo

$ 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