Craig Tiller | 6169d5f | 2016-03-31 07:46:18 -0700 | [diff] [blame] | 1 | # Copyright 2015, Google Inc. |
Nathaniel Manista | b68f3d1 | 2015-01-23 21:32:47 +0000 | [diff] [blame] | 2 | # All rights reserved. |
| 3 | # |
| 4 | # Redistribution and use in source and binary forms, with or without |
| 5 | # modification, are permitted provided that the following conditions are |
| 6 | # met: |
| 7 | # |
| 8 | # * Redistributions of source code must retain the above copyright |
| 9 | # notice, this list of conditions and the following disclaimer. |
| 10 | # * Redistributions in binary form must reproduce the above |
| 11 | # copyright notice, this list of conditions and the following disclaimer |
| 12 | # in the documentation and/or other materials provided with the |
| 13 | # distribution. |
| 14 | # * Neither the name of Google Inc. nor the names of its |
| 15 | # contributors may be used to endorse or promote products derived from |
| 16 | # this software without specific prior written permission. |
| 17 | # |
| 18 | # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| 19 | # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| 20 | # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
| 21 | # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
| 22 | # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| 23 | # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| 24 | # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| 25 | # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| 26 | # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| 27 | # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| 28 | # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| 29 | |
Nathaniel Manista | b8b0adf | 2015-01-29 00:30:51 +0000 | [diff] [blame] | 30 | """A setup module for the GRPC Python package.""" |
Nathaniel Manista | b68f3d1 | 2015-01-23 21:32:47 +0000 | [diff] [blame] | 31 | |
Masood Malekghassemi | 743c10c | 2015-06-16 18:05:27 -0700 | [diff] [blame] | 32 | import os |
Masood Malekghassemi | d65632a | 2015-07-27 14:30:09 -0700 | [diff] [blame] | 33 | import os.path |
Ken Payson | fe754b4 | 2016-06-23 12:32:07 -0700 | [diff] [blame] | 34 | import shlex |
Masood Malekghassemi | 6d2ef17 | 2016-01-04 15:33:17 -0800 | [diff] [blame] | 35 | import shutil |
Alexander Staubo | 8eac91e | 2015-04-06 12:06:22 -0400 | [diff] [blame] | 36 | import sys |
Ken Payson | 1efb601 | 2016-06-08 13:06:44 -0700 | [diff] [blame] | 37 | import sysconfig |
Nathaniel Manista | b68f3d1 | 2015-01-23 21:32:47 +0000 | [diff] [blame] | 38 | |
Masood Malekghassemi | 743c10c | 2015-06-16 18:05:27 -0700 | [diff] [blame] | 39 | from distutils import core as _core |
Masood Malekghassemi | 5a65bcd | 2015-09-25 11:27:10 -0700 | [diff] [blame] | 40 | from distutils import extension as _extension |
Ken Payson | 1efb601 | 2016-06-08 13:06:44 -0700 | [diff] [blame] | 41 | import pkg_resources |
Masood Malekghassemi | 743c10c | 2015-06-16 18:05:27 -0700 | [diff] [blame] | 42 | import setuptools |
Masood Malekghassemi | b7e7b3f | 2015-12-17 00:16:49 -0800 | [diff] [blame] | 43 | from setuptools.command import egg_info |
| 44 | |
| 45 | # Redirect the manifest template from MANIFEST.in to PYTHON-MANIFEST.in. |
| 46 | egg_info.manifest_maker.template = 'PYTHON-MANIFEST.in' |
Masood Malekghassemi | 743c10c | 2015-06-16 18:05:27 -0700 | [diff] [blame] | 47 | |
Leifur Halldor Asgeirsson | 38a3d7a | 2016-03-01 10:00:08 -0500 | [diff] [blame] | 48 | PY3 = sys.version_info.major == 3 |
Masood Malekghassemi | e540b57 | 2016-01-14 15:00:34 -0800 | [diff] [blame] | 49 | PYTHON_STEM = './src/python/grpcio' |
| 50 | CORE_INCLUDE = ('./include', '.',) |
Masood Malekghassemi | 387e116 | 2016-01-05 10:16:12 -0800 | [diff] [blame] | 51 | BORINGSSL_INCLUDE = ('./third_party/boringssl/include',) |
Masood Malekghassemi | 0cc2792 | 2016-01-22 16:32:41 -0800 | [diff] [blame] | 52 | ZLIB_INCLUDE = ('./third_party/zlib',) |
Masood Malekghassemi | 116982e | 2015-12-11 15:53:38 -0800 | [diff] [blame] | 53 | |
Masood Malekghassemi | d65632a | 2015-07-27 14:30:09 -0700 | [diff] [blame] | 54 | # Ensure we're in the proper directory whether or not we're being used by pip. |
| 55 | os.chdir(os.path.dirname(os.path.abspath(__file__))) |
Masood Malekghassemi | 58a1dc2 | 2016-01-21 14:23:55 -0800 | [diff] [blame] | 56 | sys.path.insert(0, os.path.abspath(PYTHON_STEM)) |
Masood Malekghassemi | d65632a | 2015-07-27 14:30:09 -0700 | [diff] [blame] | 57 | |
Masood Malekghassemi | 116982e | 2015-12-11 15:53:38 -0800 | [diff] [blame] | 58 | # Break import-style to ensure we can actually find our in-repo dependencies. |
Masood Malekghassemi | d65632a | 2015-07-27 14:30:09 -0700 | [diff] [blame] | 59 | import commands |
Masood Malekghassemi | 116982e | 2015-12-11 15:53:38 -0800 | [diff] [blame] | 60 | import grpc_core_dependencies |
Craig Tiller | f008f06 | 2016-02-08 12:48:03 -0800 | [diff] [blame] | 61 | import grpc_version |
Masood Malekghassemi | 743c10c | 2015-06-16 18:05:27 -0700 | [diff] [blame] | 62 | |
Masood Malekghassemi | df97aec | 2016-01-11 16:19:14 -0800 | [diff] [blame] | 63 | LICENSE = '3-clause BSD' |
| 64 | |
Masood Malekghassemi | 7566c9a | 2015-10-21 20:29:23 -0700 | [diff] [blame] | 65 | # Environment variable to determine whether or not the Cython extension should |
| 66 | # *use* Cython or use the generated C files. Note that this requires the C files |
| 67 | # to have been generated by building first *with* Cython support. |
| 68 | BUILD_WITH_CYTHON = os.environ.get('GRPC_PYTHON_BUILD_WITH_CYTHON', False) |
Masood Malekghassemi | 743c10c | 2015-06-16 18:05:27 -0700 | [diff] [blame] | 69 | |
Masood Malekghassemi | 7566c9a | 2015-10-21 20:29:23 -0700 | [diff] [blame] | 70 | # Environment variable to determine whether or not to enable coverage analysis |
| 71 | # in Cython modules. |
| 72 | ENABLE_CYTHON_TRACING = os.environ.get( |
| 73 | 'GRPC_PYTHON_ENABLE_CYTHON_TRACING', False) |
| 74 | |
Masood Malekghassemi | 7566c9a | 2015-10-21 20:29:23 -0700 | [diff] [blame] | 75 | CYTHON_EXTENSION_PACKAGE_NAMES = () |
Masood Malekghassemi | 5a65bcd | 2015-09-25 11:27:10 -0700 | [diff] [blame] | 76 | |
Masood Malekghassemi | 116982e | 2015-12-11 15:53:38 -0800 | [diff] [blame] | 77 | CYTHON_EXTENSION_MODULE_NAMES = ('grpc._cython.cygrpc',) |
Masood Malekghassemi | 5a65bcd | 2015-09-25 11:27:10 -0700 | [diff] [blame] | 78 | |
Masood Malekghassemi | df1e07e | 2016-02-02 14:17:14 -0800 | [diff] [blame] | 79 | CYTHON_HELPER_C_FILES = ( |
| 80 | os.path.join(PYTHON_STEM, 'grpc/_cython/loader.c'), |
| 81 | os.path.join(PYTHON_STEM, 'grpc/_cython/imports.generated.c'), |
| 82 | ) |
| 83 | |
| 84 | CORE_C_FILES = () |
| 85 | if not "win32" in sys.platform: |
Masood Malekghassemi | 10509a2 | 2016-02-03 13:32:22 -0800 | [diff] [blame] | 86 | CORE_C_FILES += tuple(grpc_core_dependencies.CORE_SOURCE_FILES) |
Masood Malekghassemi | df1e07e | 2016-02-02 14:17:14 -0800 | [diff] [blame] | 87 | |
Masood Malekghassemi | 387e116 | 2016-01-05 10:16:12 -0800 | [diff] [blame] | 88 | EXTENSION_INCLUDE_DIRECTORIES = ( |
Masood Malekghassemi | 0cc2792 | 2016-01-22 16:32:41 -0800 | [diff] [blame] | 89 | (PYTHON_STEM,) + CORE_INCLUDE + BORINGSSL_INCLUDE + ZLIB_INCLUDE) |
Nathaniel Manista | a4ead5d | 2015-01-31 01:33:27 +0000 | [diff] [blame] | 90 | |
Masood Malekghassemi | 10509a2 | 2016-02-03 13:32:22 -0800 | [diff] [blame] | 91 | EXTENSION_LIBRARIES = () |
Masood Malekghassemi | c9c53ee | 2016-02-03 10:30:23 -0800 | [diff] [blame] | 92 | if "linux" in sys.platform: |
Craig Tiller | 4bef7ce | 2016-02-02 08:38:43 -0800 | [diff] [blame] | 93 | EXTENSION_LIBRARIES += ('rt',) |
Masood Malekghassemi | 10509a2 | 2016-02-03 13:32:22 -0800 | [diff] [blame] | 94 | if not "win32" in sys.platform: |
| 95 | EXTENSION_LIBRARIES += ('m',) |
Nathaniel Manista | a4ead5d | 2015-01-31 01:33:27 +0000 | [diff] [blame] | 96 | |
Craig Tiller | 71ea4a1 | 2016-02-04 15:06:41 -0800 | [diff] [blame] | 97 | DEFINE_MACROS = (('OPENSSL_NO_ASM', 1), ('_WIN32_WINNT', 0x600), ('GPR_BACKWARDS_COMPATIBILITY_MODE', 1),) |
Masood Malekghassemi | 743c10c | 2015-06-16 18:05:27 -0700 | [diff] [blame] | 98 | |
Ken Payson | fe754b4 | 2016-06-23 12:32:07 -0700 | [diff] [blame] | 99 | LDFLAGS = shlex.split(os.environ.get('GRPC_PYTHON_LDFLAGS', '')) |
| 100 | CFLAGS = shlex.split(os.environ.get('GRPC_PYTHON_CFLAGS', '')) |
| 101 | |
Craig Tiller | 4bef7ce | 2016-02-02 08:38:43 -0800 | [diff] [blame] | 102 | if "linux" in sys.platform: |
| 103 | LDFLAGS += ('-Wl,-wrap,memcpy',) |
| 104 | if "linux" in sys.platform or "darwin" in sys.platform: |
| 105 | CFLAGS += ('-fvisibility=hidden',) |
Leifur Halldor Asgeirsson | 38a3d7a | 2016-03-01 10:00:08 -0500 | [diff] [blame] | 106 | |
| 107 | pymodinit_type = 'PyObject*' if PY3 else 'void' |
| 108 | |
| 109 | pymodinit = '__attribute__((visibility ("default"))) {}'.format(pymodinit_type) |
| 110 | DEFINE_MACROS += (('PyMODINIT_FUNC', pymodinit),) |
Craig Tiller | 4bef7ce | 2016-02-02 08:38:43 -0800 | [diff] [blame] | 111 | |
| 112 | |
Ken Payson | 1efb601 | 2016-06-08 13:06:44 -0700 | [diff] [blame] | 113 | # By default, Python3 distutils enforces compatibility of |
| 114 | # c plugins (.so files) with the OSX version Python3 was built with. |
| 115 | # For Python3.4, this is OSX 10.6, but we need Thread Local Support (__thread) |
| 116 | if 'darwin' in sys.platform and PY3: |
| 117 | mac_target = sysconfig.get_config_var('MACOSX_DEPLOYMENT_TARGET') |
| 118 | if mac_target and (pkg_resources.parse_version(mac_target) < |
| 119 | pkg_resources.parse_version('10.7.0')): |
| 120 | os.environ['MACOSX_DEPLOYMENT_TARGET'] = '10.7' |
| 121 | |
| 122 | |
Leifur Halldor Asgeirsson | 554c7dd | 2016-02-18 17:24:05 -0500 | [diff] [blame] | 123 | def cython_extensions(module_names, extra_sources, include_dirs, |
Masood Malekghassemi | df1e07e | 2016-02-02 14:17:14 -0800 | [diff] [blame] | 124 | libraries, define_macros, build_with_cython=False): |
Masood Malekghassemi | 68a94c8 | 2016-03-09 11:45:07 -0800 | [diff] [blame] | 125 | # Set compiler directives linetrace argument only if we care about tracing; |
| 126 | # this is due to Cython having different behavior between linetrace being |
| 127 | # False and linetrace being unset. See issue #5689. |
| 128 | cython_compiler_directives = {} |
Masood Malekghassemi | 387e116 | 2016-01-05 10:16:12 -0800 | [diff] [blame] | 129 | if ENABLE_CYTHON_TRACING: |
| 130 | define_macros = define_macros + [('CYTHON_TRACE_NOGIL', 1)] |
Masood Malekghassemi | 68a94c8 | 2016-03-09 11:45:07 -0800 | [diff] [blame] | 131 | cython_compiler_directives['linetrace'] = True |
Masood Malekghassemi | 5a65bcd | 2015-09-25 11:27:10 -0700 | [diff] [blame] | 132 | file_extension = 'pyx' if build_with_cython else 'c' |
Masood Malekghassemi | 116982e | 2015-12-11 15:53:38 -0800 | [diff] [blame] | 133 | module_files = [os.path.join(PYTHON_STEM, |
| 134 | name.replace('.', '/') + '.' + file_extension) |
Masood Malekghassemi | 5a65bcd | 2015-09-25 11:27:10 -0700 | [diff] [blame] | 135 | for name in module_names] |
| 136 | extensions = [ |
| 137 | _extension.Extension( |
Masood Malekghassemi | 116982e | 2015-12-11 15:53:38 -0800 | [diff] [blame] | 138 | name=module_name, |
Masood Malekghassemi | df1e07e | 2016-02-02 14:17:14 -0800 | [diff] [blame] | 139 | sources=[module_file] + extra_sources, |
Masood Malekghassemi | 7566c9a | 2015-10-21 20:29:23 -0700 | [diff] [blame] | 140 | include_dirs=include_dirs, libraries=libraries, |
Masood Malekghassemi | 387e116 | 2016-01-05 10:16:12 -0800 | [diff] [blame] | 141 | define_macros=define_macros, |
Craig Tiller | a7f3e05 | 2016-02-05 15:02:39 -0800 | [diff] [blame] | 142 | extra_compile_args=list(CFLAGS), |
| 143 | extra_link_args=list(LDFLAGS), |
Masood Malekghassemi | 5a65bcd | 2015-09-25 11:27:10 -0700 | [diff] [blame] | 144 | ) for (module_name, module_file) in zip(module_names, module_files) |
| 145 | ] |
| 146 | if build_with_cython: |
| 147 | import Cython.Build |
Masood Malekghassemi | 7566c9a | 2015-10-21 20:29:23 -0700 | [diff] [blame] | 148 | return Cython.Build.cythonize( |
| 149 | extensions, |
Masood Malekghassemi | 116982e | 2015-12-11 15:53:38 -0800 | [diff] [blame] | 150 | include_path=include_dirs, |
Masood Malekghassemi | 68a94c8 | 2016-03-09 11:45:07 -0800 | [diff] [blame] | 151 | compiler_directives=cython_compiler_directives) |
Masood Malekghassemi | 5a65bcd | 2015-09-25 11:27:10 -0700 | [diff] [blame] | 152 | else: |
| 153 | return extensions |
| 154 | |
Masood Malekghassemi | 7566c9a | 2015-10-21 20:29:23 -0700 | [diff] [blame] | 155 | CYTHON_EXTENSION_MODULES = cython_extensions( |
Leifur Halldor Asgeirsson | 554c7dd | 2016-02-18 17:24:05 -0500 | [diff] [blame] | 156 | list(CYTHON_EXTENSION_MODULE_NAMES), |
Masood Malekghassemi | df1e07e | 2016-02-02 14:17:14 -0800 | [diff] [blame] | 157 | list(CYTHON_HELPER_C_FILES) + list(CORE_C_FILES), |
Masood Malekghassemi | 7566c9a | 2015-10-21 20:29:23 -0700 | [diff] [blame] | 158 | list(EXTENSION_INCLUDE_DIRECTORIES), list(EXTENSION_LIBRARIES), |
Masood Malekghassemi | 1d17781 | 2016-01-12 09:21:57 -0800 | [diff] [blame] | 159 | list(DEFINE_MACROS), bool(BUILD_WITH_CYTHON)) |
Masood Malekghassemi | 5a65bcd | 2015-09-25 11:27:10 -0700 | [diff] [blame] | 160 | |
Masood Malekghassemi | 7566c9a | 2015-10-21 20:29:23 -0700 | [diff] [blame] | 161 | PACKAGE_DIRECTORIES = { |
Masood Malekghassemi | 116982e | 2015-12-11 15:53:38 -0800 | [diff] [blame] | 162 | '': PYTHON_STEM, |
Nathaniel Manista | b8b0adf | 2015-01-29 00:30:51 +0000 | [diff] [blame] | 163 | } |
| 164 | |
Masood Malekghassemi | 7566c9a | 2015-10-21 20:29:23 -0700 | [diff] [blame] | 165 | INSTALL_REQUIRES = ( |
Ken Payson | 2b7fae0 | 2016-06-28 17:20:37 -0700 | [diff] [blame] | 166 | 'six>=1.5.2', |
Nathaniel Manista | a188022 | 2015-09-10 22:16:04 +0000 | [diff] [blame] | 167 | 'enum34>=1.0.4', |
| 168 | 'futures>=2.2.0', |
Masood Malekghassemi | ad32ff4 | 2016-01-21 15:15:38 -0800 | [diff] [blame] | 169 | # TODO(atash): eventually split the grpcio package into a metapackage |
| 170 | # depending on protobuf and the runtime component (independent of protobuf) |
| 171 | 'protobuf>=3.0.0a3', |
Masood Malekghassemi | d65632a | 2015-07-27 14:30:09 -0700 | [diff] [blame] | 172 | ) |
| 173 | |
Ken Payson | 2b7fae0 | 2016-06-28 17:20:37 -0700 | [diff] [blame] | 174 | SETUP_REQUIRES = INSTALL_REQUIRES + ( |
Masood Malekghassemi | d65632a | 2015-07-27 14:30:09 -0700 | [diff] [blame] | 175 | 'sphinx>=1.3', |
Ken Payson | 2b7fae0 | 2016-06-28 17:20:37 -0700 | [diff] [blame] | 176 | 'sphinx_rtd_theme>=0.1.8', |
| 177 | 'six>=1.10', |
| 178 | ) |
Masood Malekghassemi | d65632a | 2015-07-27 14:30:09 -0700 | [diff] [blame] | 179 | |
Masood Malekghassemi | 7566c9a | 2015-10-21 20:29:23 -0700 | [diff] [blame] | 180 | COMMAND_CLASS = { |
Masood Malekghassemi | 791cc31 | 2015-07-27 14:22:33 -0700 | [diff] [blame] | 181 | 'doc': commands.SphinxDocumentation, |
Masood Malekghassemi | 5c14763 | 2015-07-31 14:08:19 -0700 | [diff] [blame] | 182 | 'build_project_metadata': commands.BuildProjectMetadata, |
| 183 | 'build_py': commands.BuildPy, |
Masood Malekghassemi | 1d17781 | 2016-01-12 09:21:57 -0800 | [diff] [blame] | 184 | 'build_ext': commands.BuildExt, |
Masood Malekghassemi | 7566c9a | 2015-10-21 20:29:23 -0700 | [diff] [blame] | 185 | 'gather': commands.Gather, |
Masood Malekghassemi | d65632a | 2015-07-27 14:30:09 -0700 | [diff] [blame] | 186 | } |
| 187 | |
Masood Malekghassemi | 6d2ef17 | 2016-01-04 15:33:17 -0800 | [diff] [blame] | 188 | # Ensure that package data is copied over before any commands have been run: |
Nathaniel Manista | fa6cad7 | 2016-02-05 21:26:54 +0000 | [diff] [blame] | 189 | credentials_dir = os.path.join(PYTHON_STEM, 'grpc/_cython/_credentials') |
Masood Malekghassemi | 6d2ef17 | 2016-01-04 15:33:17 -0800 | [diff] [blame] | 190 | try: |
| 191 | os.mkdir(credentials_dir) |
| 192 | except OSError: |
| 193 | pass |
| 194 | shutil.copyfile('etc/roots.pem', os.path.join(credentials_dir, 'roots.pem')) |
| 195 | |
Masood Malekghassemi | df1e07e | 2016-02-02 14:17:14 -0800 | [diff] [blame] | 196 | PACKAGE_DATA = { |
Masood Malekghassemi | f747409 | 2016-02-12 12:04:53 -0800 | [diff] [blame] | 197 | # Binaries that may or may not be present in the final installation, but are |
| 198 | # mentioned here for completeness. |
Masood Malekghassemi | df1e07e | 2016-02-02 14:17:14 -0800 | [diff] [blame] | 199 | 'grpc._cython': [ |
Nathaniel Manista | fa6cad7 | 2016-02-05 21:26:54 +0000 | [diff] [blame] | 200 | '_credentials/roots.pem', |
Masood Malekghassemi | df1e07e | 2016-02-02 14:17:14 -0800 | [diff] [blame] | 201 | '_windows/grpc_c.32.python', |
| 202 | '_windows/grpc_c.64.python', |
| 203 | ], |
| 204 | } |
Masood Malekghassemi | 1ff429d | 2016-06-02 16:39:20 -0700 | [diff] [blame] | 205 | PACKAGES = setuptools.find_packages(PYTHON_STEM) |
Masood Malekghassemi | 7566c9a | 2015-10-21 20:29:23 -0700 | [diff] [blame] | 206 | |
Masood Malekghassemi | ab5309c | 2016-05-05 18:39:01 -0700 | [diff] [blame] | 207 | setuptools.setup( |
| 208 | name='grpcio', |
| 209 | version=grpc_version.VERSION, |
| 210 | license=LICENSE, |
| 211 | ext_modules=CYTHON_EXTENSION_MODULES, |
| 212 | packages=list(PACKAGES), |
| 213 | package_dir=PACKAGE_DIRECTORIES, |
Masood Malekghassemi | ab5309c | 2016-05-05 18:39:01 -0700 | [diff] [blame] | 214 | package_data=PACKAGE_DATA, |
| 215 | install_requires=INSTALL_REQUIRES, |
| 216 | setup_requires=SETUP_REQUIRES, |
| 217 | cmdclass=COMMAND_CLASS, |
Masood Malekghassemi | ab5309c | 2016-05-05 18:39:01 -0700 | [diff] [blame] | 218 | ) |