blob: 10de0ac06f7573fc9801b2ecb262001f19a0429e [file] [log] [blame]
Jon Wayne Parrott24d87e82017-01-11 13:29:02 -08001Google Auth Python Library
2==========================
Jon Wayne Parrott377f2932016-10-04 10:20:36 -07003
Bu Sun Kim1b9de8d2020-01-22 16:09:31 -08004|pypi|
Jon Wayne Parrott377f2932016-10-04 10:20:36 -07005
6This library simplifies using Google's various server-to-server authentication
7mechanisms to access Google APIs.
8
Jon Wayne Parrott90c1c1b2016-12-14 12:43:30 -08009.. |pypi| image:: https://img.shields.io/pypi/v/google-auth.svg
Jon Wayne Parrott377f2932016-10-04 10:20:36 -070010 :target: https://pypi.python.org/pypi/google-auth
11
12Installing
13----------
14
Jon Wayne Parrott2b773f32016-10-10 13:32:16 -070015You can install using `pip`_::
Jon Wayne Parrott377f2932016-10-04 10:20:36 -070016
Jon Wayne Parrott2b773f32016-10-10 13:32:16 -070017 $ pip install google-auth
Jon Wayne Parrott377f2932016-10-04 10:20:36 -070018
Jon Wayne Parrott2b773f32016-10-10 13:32:16 -070019.. _pip: https://pip.pypa.io/en/stable/
Jon Wayne Parrott377f2932016-10-04 10:20:36 -070020
michaelawyuddf3cec2017-10-13 10:20:44 -070021For more information on setting up your Python development environment, please refer to `Python Development Environment Setup Guide`_ for Google Cloud Platform.
22
23.. _`Python Development Environment Setup Guide`: https://cloud.google.com/python/setup
24
Christopher Wilcox3f736942018-12-14 12:24:38 -080025Supported Python Versions
26^^^^^^^^^^^^^^^^^^^^^^^^^
Bu Sun Kim8c84d0f2020-06-30 14:10:03 -070027Python >= 3.5
Christopher Wilcox3f736942018-12-14 12:24:38 -080028
29Deprecated Python Versions
30^^^^^^^^^^^^^^^^^^^^^^^^^^
31Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
32
Jon Wayne Parrott377f2932016-10-04 10:20:36 -070033Documentation
34-------------
35
Bu Sun Kim1b9de8d2020-01-22 16:09:31 -080036Google Auth Python Library has usage and reference documentation at https://googleapis.dev/python/google-auth/latest/index.html.
Jon Wayne Parrott377f2932016-10-04 10:20:36 -070037
Bu Sun Kimae3bafd2019-10-02 14:05:04 -070038Current Maintainers
39-------------------
40- `@busunkim96 <https://github.com/busunkim96>`_ (Bu Sun Kim)
41
42Authors
43-------
Jon Wayne Parrott377f2932016-10-04 10:20:36 -070044
Christopher Wilcox5f65d272018-09-19 10:35:40 -070045- `@theacodes <https://github.com/theacodes>`_ (Thea Flowers)
Jon Wayne Parrott377f2932016-10-04 10:20:36 -070046- `@dhermes <https://github.com/dhermes>`_ (Danny Hermes)
Jon Wayne Parrott709953d2017-04-17 13:13:13 -070047- `@lukesneeringer <https://github.com/lukesneeringer>`_ (Luke Sneeringer)
Jon Wayne Parrott377f2932016-10-04 10:20:36 -070048
49Contributing
50------------
51
52Contributions to this library are always welcome and highly encouraged.
53
Jon Wayne Parrott246df812016-10-21 14:31:06 -070054See `CONTRIBUTING.rst`_ for more information on how to get started.
Jon Wayne Parrott377f2932016-10-04 10:20:36 -070055
Bu Sun Kim1b9de8d2020-01-22 16:09:31 -080056.. _CONTRIBUTING.rst: https://github.com/googleapis/google-auth-library-python/blob/master/CONTRIBUTING.rst
Jon Wayne Parrott377f2932016-10-04 10:20:36 -070057
58License
59-------
60
Jon Wayne Parrott246df812016-10-21 14:31:06 -070061Apache 2.0 - See `the LICENSE`_ for more information.
Jon Wayne Parrott377f2932016-10-04 10:20:36 -070062
Bu Sun Kim1b9de8d2020-01-22 16:09:31 -080063.. _the LICENSE: https://github.com/googleapis/google-auth-library-python/blob/master/LICENSE