google-auth-library-python icon indicating copy to clipboard operation
google-auth-library-python copied to clipboard

Google Auth Python Library

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

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