METADATA 3.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129
  1. Metadata-Version: 2.1
  2. Name: grpcio
  3. Version: 1.71.0
  4. Summary: HTTP/2-based RPC framework
  5. Home-page: https://grpc.io
  6. Author: The gRPC Authors
  7. Author-email: grpc-io@googlegroups.com
  8. License: Apache License 2.0
  9. Project-URL: Source Code, https://github.com/grpc/grpc
  10. Project-URL: Bug Tracker, https://github.com/grpc/grpc/issues
  11. Project-URL: Documentation, https://grpc.github.io/grpc/python
  12. Classifier: Development Status :: 5 - Production/Stable
  13. Classifier: Programming Language :: Python
  14. Classifier: Programming Language :: Python :: 3
  15. Classifier: Programming Language :: Python :: 3.9
  16. Classifier: Programming Language :: Python :: 3.10
  17. Classifier: Programming Language :: Python :: 3.11
  18. Classifier: Programming Language :: Python :: 3.12
  19. Classifier: Programming Language :: Python :: 3.13
  20. Classifier: License :: OSI Approved :: Apache Software License
  21. Requires-Python: >=3.9
  22. Description-Content-Type: text/x-rst
  23. License-File: LICENSE
  24. Provides-Extra: protobuf
  25. Requires-Dist: grpcio-tools >=1.71.0 ; extra == 'protobuf'
  26. gRPC Python
  27. ===========
  28. |compat_check_pypi|
  29. Package for gRPC Python.
  30. .. |compat_check_pypi| image:: https://python-compatibility-tools.appspot.com/one_badge_image?package=grpcio
  31. :target: https://python-compatibility-tools.appspot.com/one_badge_target?package=grpcio
  32. Installation
  33. ------------
  34. gRPC Python is available for Linux, macOS, and Windows.
  35. Installing From PyPI
  36. ~~~~~~~~~~~~~~~~~~~~
  37. If you are installing locally...
  38. ::
  39. $ pip install grpcio
  40. Else system wide (on Ubuntu)...
  41. ::
  42. $ sudo pip install grpcio
  43. If you're on Windows make sure that you installed the :code:`pip.exe` component
  44. when you installed Python (if not go back and install it!) then invoke:
  45. ::
  46. $ pip.exe install grpcio
  47. Windows users may need to invoke :code:`pip.exe` from a command line ran as
  48. administrator.
  49. n.b. On Windows and on Mac OS X one *must* have a recent release of :code:`pip`
  50. to retrieve the proper wheel from PyPI. Be sure to upgrade to the latest
  51. version!
  52. Installing From Source
  53. ~~~~~~~~~~~~~~~~~~~~~~
  54. Building from source requires that you have the Python headers (usually a
  55. package named :code:`python-dev`).
  56. ::
  57. $ export REPO_ROOT=grpc # REPO_ROOT can be any directory of your choice
  58. $ git clone -b RELEASE_TAG_HERE https://github.com/grpc/grpc $REPO_ROOT
  59. $ cd $REPO_ROOT
  60. $ git submodule update --init
  61. # To include systemd socket-activation feature in the build,
  62. # first install the `libsystemd-dev` package, then :
  63. $ export GRPC_PYTHON_BUILD_WITH_SYSTEMD=1
  64. # For the next two commands do `sudo pip install` if you get permission-denied errors
  65. $ pip install -r requirements.txt
  66. $ GRPC_PYTHON_BUILD_WITH_CYTHON=1 pip install .
  67. You cannot currently install Python from source on Windows. Things might work
  68. out for you in MSYS2 (follow the Linux instructions), but it isn't officially
  69. supported at the moment.
  70. Troubleshooting
  71. ~~~~~~~~~~~~~~~
  72. Help, I ...
  73. * **... see the following error on some platforms**
  74. ::
  75. /tmp/pip-build-U8pSsr/cython/Cython/Plex/Scanners.c:4:20: fatal error: Python.h: No such file or directory
  76. #include "Python.h"
  77. ^
  78. compilation terminated.
  79. You can fix it by installing `python-dev` package. i.e
  80. ::
  81. sudo apt-get install python-dev
  82. Versioning
  83. ~~~~~~~~~~
  84. gRPC Python is developed in a monorepo shared with implementations of gRPC in
  85. other programming languages. While the minor versions are released in
  86. lock-step with other languages in the repo (e.g. 1.63.0 is guaranteed to exist
  87. for all languages), patch versions may be specific to only a single
  88. language. For example, if 1.63.1 is a C++-specific patch, 1.63.1 may not be
  89. uploaded to PyPi. As a result, it is __not__ a good assumption that the latest
  90. patch for a given minor version on Github is also the latest patch for that
  91. same minor version on PyPi.