Yang Gao 036bf58b28 Merge pull request #3075 from jboeuf/credentials_naming_and_cleanup hace 10 años
..
grpcio 036bf58b28 Merge pull request #3075 from jboeuf/credentials_naming_and_cleanup hace 10 años
grpcio_health_checking 12dadafd22 Add health-checking to Python hace 10 años
grpcio_test 036bf58b28 Merge pull request #3075 from jboeuf/credentials_naming_and_cleanup hace 10 años
README.md 18b3ccb2f2 Temporary fix on Python doc to alleviate confusion hace 10 años

README.md

gRPC Python

The Python facility of gRPC.

Status

Alpha : Ready for early adopters

PREREQUISITES

  • Python 2.7, virtualenv, pip
  • homebrew on Mac OS X. These simplify the installation of the gRPC C core.

INSTALLATION

Linux (Debian):

Add Debian unstable to your sources.list file. Example:

echo "deb http://ftp.us.debian.org/debian unstable main contrib non-free" | \
sudo tee -a /etc/apt/sources.list

Install the gRPC Debian package

sudo apt-get update
sudo apt-get install libgrpc-dev

Install the gRPC Python module

sudo pip install grpcio

Mac OS X

Install homebrew. Run the following command to install gRPC Python.

$ curl -fsSL https://goo.gl/getgrpc | bash -s python

This will download and run the gRPC install script, then install the latest version of the gRPC Python package. It also installs the Protocol Buffers compiler (protoc) and the gRPC protoc plugin for python.

EXAMPLES

Please read our online documentation for a Quick Start and a detailed example

BUILDING FROM SOURCE

  • Clone this repository

  • Initialize the git submodules

    $ git submodule update --init
    
  • Make the libraries

    $ make
    
  • Use build_python.sh to build the Python code and install it into a virtual environment

    $ CONFIG=opt tools/run_tests/build_python.sh 2.7
    

TESTING

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

    $ CONFIG=opt PYVER=2.7 tools/run_tests/run_python.sh
    

PACKAGING

  • Install packaging dependencies

    $ pip install setuptools twine
    
  • Push to PyPI

    $ ../../tools/distrib/python/submit.py