gRPC Python
===========
|compat_check_pypi|
Package for gRPC Python.
.. |compat_check_pypi| image:: https://python-compatibility-tools.appspot.com/one_badge_image?package=grpcio
:target: https://python-compatibility-tools.appspot.com/one_badge_target?package=grpcio
Installation
------------
gRPC Python is available for Linux, macOS, and Windows.
Installing From PyPI
~~~~~~~~~~~~~~~~~~~~
If you are installing locally...
::
$ pip install grpcio
Else system wide (on Ubuntu)...
::
$ sudo pip install grpcio
If you're on Windows make sure that you installed the :code:`pip.exe` component
when you installed Python (if not go back and install it!) then invoke:
::
$ pip.exe install grpcio
Windows users may need to invoke :code:`pip.exe` from a command line ran as
administrator.
n.b. On Windows and on Mac OS X one *must* have a recent release of :code:`pip`
to retrieve the proper wheel from PyPI. Be sure to upgrade to the latest
version!
Installing From Source
~~~~~~~~~~~~~~~~~~~~~~
Building from source requires that you have the Python headers (usually a
package named :code:`python-dev`).
::
$ export REPO_ROOT=grpc # REPO_ROOT can be any directory of your choice
$ git clone -b RELEASE_TAG_HERE https://github.com/grpc/grpc $REPO_ROOT
$ cd $REPO_ROOT
$ git submodule update --init
# To include systemd socket-activation feature in the build,
# first install the `libsystemd-dev` package, then :
$ export GRPC_PYTHON_BUILD_WITH_SYSTEMD=1
# For the next two commands do `sudo pip install` if you get permission-denied errors
$ pip install -r requirements.txt
$ GRPC_PYTHON_BUILD_WITH_CYTHON=1 pip install .
You cannot currently install Python from source on Windows. Things might work
out for you in MSYS2 (follow the Linux instructions), but it isn't officially
supported at the moment.
Troubleshooting
~~~~~~~~~~~~~~~
Help, I ...
* **... see the following error on some platforms**
::
/tmp/pip-build-U8pSsr/cython/Cython/Plex/Scanners.c:4:20: fatal error: Python.h: No such file or directory
#include "Python.h"
^
compilation terminated.
You can fix it by installing `python-dev` package. i.e
::
sudo apt-get install python-dev
Versioning
~~~~~~~~~~
gRPC Python is developed in a monorepo shared with implementations of gRPC in
other programming languages. While the minor versions are released in
lock-step with other languages in the repo (e.g. 1.63.0 is guaranteed to exist
for all languages), patch versions may be specific to only a single
language. For example, if 1.63.1 is a C++-specific patch, 1.63.1 may not be
uploaded to PyPi. As a result, it is __not__ a good assumption that the latest
patch for a given minor version on Github is also the latest patch for that
same minor version on PyPi.
Raw data
{
"_id": null,
"home_page": "https://grpc.io",
"name": "grpcio-fips",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "The gRPC Authors",
"author_email": "grpc-io@googlegroups.com",
"download_url": null,
"platform": null,
"description": "gRPC Python\r\n===========\r\n\r\n|compat_check_pypi|\r\n\r\nPackage for gRPC Python.\r\n\r\n.. |compat_check_pypi| image:: https://python-compatibility-tools.appspot.com/one_badge_image?package=grpcio\r\n :target: https://python-compatibility-tools.appspot.com/one_badge_target?package=grpcio\r\n\r\n\r\nInstallation\r\n------------\r\n\r\ngRPC Python is available for Linux, macOS, and Windows.\r\n\r\nInstalling From PyPI\r\n~~~~~~~~~~~~~~~~~~~~\r\n\r\nIf you are installing locally...\r\n\r\n::\r\n\r\n $ pip install grpcio\r\n\r\nElse system wide (on Ubuntu)...\r\n\r\n::\r\n\r\n $ sudo pip install grpcio\r\n\r\nIf you're on Windows make sure that you installed the :code:`pip.exe` component\r\nwhen you installed Python (if not go back and install it!) then invoke:\r\n\r\n::\r\n\r\n $ pip.exe install grpcio\r\n\r\nWindows users may need to invoke :code:`pip.exe` from a command line ran as\r\nadministrator.\r\n\r\nn.b. On Windows and on Mac OS X one *must* have a recent release of :code:`pip`\r\nto retrieve the proper wheel from PyPI. Be sure to upgrade to the latest\r\nversion!\r\n\r\nInstalling From Source\r\n~~~~~~~~~~~~~~~~~~~~~~\r\n\r\nBuilding from source requires that you have the Python headers (usually a\r\npackage named :code:`python-dev`).\r\n\r\n::\r\n\r\n $ export REPO_ROOT=grpc # REPO_ROOT can be any directory of your choice\r\n $ git clone -b RELEASE_TAG_HERE https://github.com/grpc/grpc $REPO_ROOT\r\n $ cd $REPO_ROOT\r\n $ git submodule update --init\r\n\r\n # To include systemd socket-activation feature in the build,\r\n # first install the `libsystemd-dev` package, then :\r\n $ export GRPC_PYTHON_BUILD_WITH_SYSTEMD=1\r\n\r\n # For the next two commands do `sudo pip install` if you get permission-denied errors\r\n $ pip install -r requirements.txt\r\n $ GRPC_PYTHON_BUILD_WITH_CYTHON=1 pip install .\r\n\r\nYou cannot currently install Python from source on Windows. Things might work\r\nout for you in MSYS2 (follow the Linux instructions), but it isn't officially\r\nsupported at the moment.\r\n\r\nTroubleshooting\r\n~~~~~~~~~~~~~~~\r\n\r\nHelp, I ...\r\n\r\n* **... see the following error on some platforms**\r\n\r\n ::\r\n\r\n /tmp/pip-build-U8pSsr/cython/Cython/Plex/Scanners.c:4:20: fatal error: Python.h: No such file or directory\r\n #include \"Python.h\"\r\n ^\r\n compilation terminated.\r\n\r\n You can fix it by installing `python-dev` package. i.e\r\n\r\n ::\r\n\r\n sudo apt-get install python-dev\r\n\r\n\r\nVersioning\r\n~~~~~~~~~~\r\n\r\ngRPC Python is developed in a monorepo shared with implementations of gRPC in\r\nother programming languages. While the minor versions are released in\r\nlock-step with other languages in the repo (e.g. 1.63.0 is guaranteed to exist\r\nfor all languages), patch versions may be specific to only a single\r\nlanguage. For example, if 1.63.1 is a C++-specific patch, 1.63.1 may not be\r\nuploaded to PyPi. As a result, it is __not__ a good assumption that the latest\r\npatch for a given minor version on Github is also the latest patch for that\r\nsame minor version on PyPi.\r\n\r\n\r\n\r\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "HTTP/2-based RPC framework",
"version": "1.70.0",
"project_urls": {
"Bug Tracker": "https://github.com/grpc/grpc/issues",
"Documentation": "https://grpc.github.io/grpc/python",
"Homepage": "https://grpc.io",
"Source Code": "https://github.com/grpc/grpc"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "8aee89b041e3ef2b08768e39a5bf594235f21feae35c544235334cf457f7ba4a",
"md5": "34629494743273f8649df2c764ea808a",
"sha256": "db3f6524e68302bfd5ccdc6dc6d3404af5e51cd1a3eb997693a0ceb0dd936eb2"
},
"downloads": -1,
"filename": "grpcio_fips-1.70.0-0-cp310-cp310-win_amd64.whl",
"has_sig": false,
"md5_digest": "34629494743273f8649df2c764ea808a",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": ">=3.8",
"size": 3805936,
"upload_time": "2025-02-18T15:44:36",
"upload_time_iso_8601": "2025-02-18T15:44:36.118499Z",
"url": "https://files.pythonhosted.org/packages/8a/ee/89b041e3ef2b08768e39a5bf594235f21feae35c544235334cf457f7ba4a/grpcio_fips-1.70.0-0-cp310-cp310-win_amd64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "ffa52c28ad92d65131c468da9830804ed3182882f2a2c621e50572a0f216a4bd",
"md5": "ae8b6118c346f692c26094e33e6010d4",
"sha256": "c6161c9ced1a959a99dae2c3bf4f7f9d2f26b966bf8be081438352b5bd591f31"
},
"downloads": -1,
"filename": "grpcio_fips-1.70.0-0-cp38-cp38-win_amd64.whl",
"has_sig": false,
"md5_digest": "ae8b6118c346f692c26094e33e6010d4",
"packagetype": "bdist_wheel",
"python_version": "cp38",
"requires_python": ">=3.8",
"size": 4544760,
"upload_time": "2025-02-18T15:40:45",
"upload_time_iso_8601": "2025-02-18T15:40:45.649916Z",
"url": "https://files.pythonhosted.org/packages/ff/a5/2c28ad92d65131c468da9830804ed3182882f2a2c621e50572a0f216a4bd/grpcio_fips-1.70.0-0-cp38-cp38-win_amd64.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-18 15:44:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "grpc",
"github_project": "grpc",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "coverage",
"specs": [
[
">=",
"4.0"
]
]
},
{
"name": "cython",
"specs": [
[
">=",
"3.0.0"
]
]
},
{
"name": "protobuf",
"specs": [
[
">=",
"5.26.1"
],
[
"<",
"6.0dev"
]
]
},
{
"name": "wheel",
"specs": [
[
">=",
"0.29"
]
]
}
],
"lcname": "grpcio-fips"
}