93 lines
2.8 KiB
ReStructuredText
93 lines
2.8 KiB
ReStructuredText
Google Auth Python Library
|
|
==========================
|
|
|
|
|pypi|
|
|
|
|
This library simplifies using Google's various server-to-server authentication
|
|
mechanisms to access Google APIs.
|
|
|
|
.. |pypi| image:: https://img.shields.io/pypi/v/google-auth.svg
|
|
:target: https://pypi.python.org/pypi/google-auth
|
|
|
|
Installing
|
|
----------
|
|
|
|
You can install using `pip`_::
|
|
|
|
$ pip install google-auth
|
|
|
|
.. _pip: https://pip.pypa.io/en/stable/
|
|
|
|
For more information on setting up your Python development environment, please refer to `Python Development Environment Setup Guide`_ for Google Cloud Platform.
|
|
|
|
.. _`Python Development Environment Setup Guide`: https://cloud.google.com/python/docs/setup
|
|
|
|
Extras
|
|
------
|
|
|
|
google-auth has few extras that you can install. For example::
|
|
|
|
$ pip install google-auth[pyopenssl]
|
|
|
|
Note that the extras pyopenssl and enterprise_cert should not be used together because they use conflicting versions of `cryptography`_.
|
|
|
|
.. _`cryptography`: https://cryptography.io/en/latest/
|
|
|
|
Supported Python Versions
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
Python >= 3.7
|
|
|
|
**NOTE**:
|
|
Python 3.7 was marked as `unsupported`_ by the python community in June 2023.
|
|
We recommend that all developers upgrade to Python 3.8 and newer as soon as
|
|
they can. Support for Python 3.7 will be removed from this library after
|
|
January 1 2024. Previous releases that support Python 3.7 will continue to be available
|
|
for download, but releases after January 1 2024 will only target Python 3.8 and
|
|
newer.
|
|
|
|
.. _unsupported: https://devguide.python.org/versions/#unsupported-versions
|
|
|
|
Unsupported Python Versions
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
- Python == 2.7: The last version of this library with support for Python 2.7
|
|
was `google.auth == 1.34.0`.
|
|
|
|
- Python 3.5: The last version of this library with support for Python 3.5
|
|
was `google.auth == 1.23.0`.
|
|
|
|
- Python 3.6: The last version of this library with support for Python 3.6
|
|
was `google.auth == 2.22.0`.
|
|
|
|
Documentation
|
|
-------------
|
|
|
|
Google Auth Python Library has usage and reference documentation at https://googleapis.dev/python/google-auth/latest/index.html.
|
|
|
|
Current Maintainers
|
|
-------------------
|
|
- googleapis-auth@google.com
|
|
|
|
Authors
|
|
-------
|
|
|
|
- `@theacodes <https://github.com/theacodes>`_ (Thea Flowers)
|
|
- `@dhermes <https://github.com/dhermes>`_ (Danny Hermes)
|
|
- `@lukesneeringer <https://github.com/lukesneeringer>`_ (Luke Sneeringer)
|
|
- `@busunkim96 <https://github.com/busunkim96>`_ (Bu Sun Kim)
|
|
|
|
Contributing
|
|
------------
|
|
|
|
Contributions to this library are always welcome and highly encouraged.
|
|
|
|
See `CONTRIBUTING.rst`_ for more information on how to get started.
|
|
|
|
.. _CONTRIBUTING.rst: https://github.com/googleapis/google-auth-library-python/blob/main/CONTRIBUTING.rst
|
|
|
|
License
|
|
-------
|
|
|
|
Apache 2.0 - See `the LICENSE`_ for more information.
|
|
|
|
.. _the LICENSE: https://github.com/googleapis/google-auth-library-python/blob/main/LICENSE
|