mirror of https://github.com/grpc/grpc.git
vjpai
9 years ago
commit
2bf1a9c707
17 changed files with 211 additions and 156 deletions
@ -1,22 +1,40 @@ |
||||
gRPC Python |
||||
=========== |
||||
|
||||
Package for GRPC Python. |
||||
Package for gRPC Python. |
||||
|
||||
Dependencies |
||||
Installation |
||||
------------ |
||||
|
||||
Ensure you have installed the gRPC core. On Mac OS X, install homebrew_. |
||||
Run the following command to install gRPC Python. |
||||
gRPC Python is available for Linux and Mac OS X running Python 2.7. |
||||
|
||||
From PyPI |
||||
~~~~~~~~~ |
||||
|
||||
If you are installing locally... |
||||
|
||||
:: |
||||
|
||||
$ curl -fsSL https://goo.gl/getgrpc | bash -s python |
||||
$ pip install grpcio |
||||
|
||||
Else system wide (on Ubuntu)... |
||||
|
||||
:: |
||||
|
||||
This will download and run the [gRPC install script][] to install grpc core. The script then uses pip to install this package. It also installs the Protocol Buffers compiler (_protoc_) and the gRPC _protoc_ plugin for python. |
||||
$ sudo pip install grpcio |
||||
|
||||
From Source |
||||
~~~~~~~~~~~ |
||||
|
||||
Building from source requires that you have the Python headers (usually a |
||||
package named `python-dev`). |
||||
|
||||
:: |
||||
|
||||
Otherwise, `install from source`_ |
||||
$ export REPO_ROOT=grpc |
||||
$ git clone https://github.com/grpc/grpc.git $REPO_ROOT |
||||
$ cd $REPO_ROOT |
||||
$ pip install . |
||||
|
||||
.. _`install from source`: https://github.com/grpc/grpc/blob/master/src/python/README.md#building-from-source |
||||
.. _homebrew: http://brew.sh |
||||
.. _`gRPC install script`: https://raw.githubusercontent.com/grpc/homebrew-grpc/master/scripts/install |
||||
Note that `$REPO_ROOT` can be assigned to whatever directory name floats your |
||||
fancy. |
||||
|
||||
@ -0,0 +1,102 @@ |
||||
# Copyright 2015-2016, Google Inc. |
||||
# All rights reserved. |
||||
# |
||||
# Redistribution and use in source and binary forms, with or without |
||||
# modification, are permitted provided that the following conditions are |
||||
# met: |
||||
# |
||||
# * Redistributions of source code must retain the above copyright |
||||
# notice, this list of conditions and the following disclaimer. |
||||
# * Redistributions in binary form must reproduce the above |
||||
# copyright notice, this list of conditions and the following disclaimer |
||||
# in the documentation and/or other materials provided with the |
||||
# distribution. |
||||
# * Neither the name of Google Inc. nor the names of its |
||||
# contributors may be used to endorse or promote products derived from |
||||
# this software without specific prior written permission. |
||||
# |
||||
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
||||
|
||||
import os |
||||
import platform |
||||
import shutil |
||||
import sys |
||||
|
||||
import setuptools |
||||
|
||||
import commands |
||||
import grpc_version |
||||
|
||||
try: |
||||
from urllib2 import urlopen |
||||
except ImportError: |
||||
from urllib.request import urlopen |
||||
|
||||
PYTHON_STEM = os.path.dirname(os.path.abspath(__file__)) |
||||
BINARIES_REPOSITORY = os.environ.get( |
||||
'GRPC_PYTHON_BINARIES_REPOSITORY', |
||||
'https://storage.googleapis.com/grpc-precompiled-binaries/python') |
||||
USE_PRECOMPILED_BINARIES = bool(int(os.environ.get( |
||||
'GRPC_PYTHON_USE_PRECOMPILED_BINARIES', '1'))) |
||||
|
||||
def _tagged_ext_name(base): |
||||
uname = platform.uname() |
||||
tags = '-'.join((grpc_version.VERSION, uname[0], uname[4])) |
||||
flavor = 'ucs2' if sys.maxunicode == 65535 else 'ucs4' |
||||
return '{base}-{tags}-{flavor}'.format(base=base, tags=tags, flavor=flavor) |
||||
|
||||
|
||||
class BuildTaggedExt(setuptools.Command): |
||||
|
||||
description = 'build the gRPC tagged extensions' |
||||
user_options = [] |
||||
|
||||
def initialize_options(self): |
||||
# distutils requires this override. |
||||
pass |
||||
|
||||
def finalize_options(self): |
||||
# distutils requires this override. |
||||
pass |
||||
|
||||
def run(self): |
||||
if 'linux' in sys.platform: |
||||
self.run_command('build_ext') |
||||
try: |
||||
os.makedirs('dist/') |
||||
except OSError: |
||||
pass |
||||
shutil.copyfile( |
||||
os.path.join(PYTHON_STEM, 'grpc/_cython/cygrpc.so'), |
||||
'dist/{}.so'.format(_tagged_ext_name('cygrpc'))) |
||||
else: |
||||
sys.stderr.write('nothing to do for build_tagged_ext\n') |
||||
|
||||
|
||||
def update_setup_arguments(setup_arguments): |
||||
url = '{}/{}.so'.format(BINARIES_REPOSITORY, _tagged_ext_name('cygrpc')) |
||||
target_path = os.path.join(PYTHON_STEM, 'grpc/_cython/cygrpc.so') |
||||
try: |
||||
extension = urlopen(url).read() |
||||
except: |
||||
sys.stderr.write( |
||||
'could not download precompiled extension: {}\n'.format(url)) |
||||
return |
||||
try: |
||||
with open(target_path, 'w') as target: |
||||
target.write(extension) |
||||
setup_arguments['ext_modules'] = [] |
||||
except: |
||||
sys.stderr.write( |
||||
'could not write precompiled extension to directory: {} -> {}\n' |
||||
.format(url, target_path)) |
||||
Loading…
Reference in new issue