Ravenports generated: 04 Dec 2019 22:38
[ravenports.git] / bucket_A4 / python-requests-oauthlib
1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
2
3 NAMEBASE=               python-requests-oauthlib
4 VERSION=                1.3.0
5 KEYWORDS=               python
6 VARIANTS=               py38 py37
7 SDESC[py37]=            Authentication support for Requests (PY 37)
8 SDESC[py38]=            Authentication support for Requests (PY 38)
9 HOMEPAGE=               https://github.com/requests/requests-oauthlib
10 CONTACT=                Python_Automaton[python@ironwolf.systems]
11
12 DOWNLOAD_GROUPS=        main
13 SITES[main]=            PYPI/r/requests-oauthlib
14 DISTFILE[1]=            requests-oauthlib-1.3.0.tar.gz:main
15 DF_INDEX=               1
16 SPKGS[py37]=            single
17 SPKGS[py38]=            single
18
19 OPTIONS_AVAILABLE=      PY38 PY37
20 OPTIONS_STANDARD=       none
21 VOPTS[py37]=            PY38=OFF PY37=ON
22 VOPTS[py38]=            PY38=ON PY37=OFF
23
24 DISTNAME=               requests-oauthlib-1.3.0
25
26 GENERATED=              yes
27
28 [PY37].BUILDRUN_DEPENDS_ON=             python-oauthlib:single:py37
29                                         python-requests:single:py37
30 [PY37].USES_ON=                         python:py37
31
32 [PY38].BUILDRUN_DEPENDS_ON=             python-oauthlib:single:py38
33                                         python-requests:single:py38
34 [PY38].USES_ON=                         python:py38
35
36 [FILE:3884:descriptions/desc.single]
37 Requests-OAuthlib |build-status| |coverage-status| |docs|
38 =========================================================
39
40 This project provides first-class OAuth library support for `Requests
41 <http://python-requests.org>`_.
42
43 The OAuth 1 workflow
44 --------------------
45
46 OAuth 1 can seem overly complicated and it sure has its quirks. Luckily,
47 requests_oauthlib hides most of these and let you focus at the task at
48 hand.
49
50 Accessing protected resources using requests_oauthlib is as simple as:
51
52 .. code-block:: pycon
53
54     >>> from requests_oauthlib import OAuth1Session
55     >>> twitter = OAuth1Session('client_key',
56                                 client_secret='client_secret',
57                                 resource_owner_key='resource_owner_key',
58
59 resource_owner_secret='resource_owner_secret')
60     >>> url = 'https://api.twitter.com/1/account/settings.json'
61     >>> r = twitter.get(url)
62
63 Before accessing resources you will need to obtain a few credentials from
64 your
65 provider (e.g. Twitter) and authorization from the user for whom you wish
66 to
67 retrieve resources for. You can read all about this in the full
68 `OAuth 1 workflow guide on RTD
69 <https://requests-oauthlib.readthedocs.io/en/latest/oauth1_workflow.html>`_
70 .
71
72 The OAuth 2 workflow
73 --------------------
74
75 OAuth 2 is generally simpler than OAuth 1 but comes in more flavours. The
76 most
77 common being the Authorization Code Grant, also known as the WebApplication
78 flow.
79
80 Fetching a protected resource after obtaining an access token can be
81 extremely
82 simple. However, before accessing resources you will need to obtain a few
83 credentials from your provider (e.g. Google) and authorization from the
84 user
85 for whom you wish to retrieve resources for. You can read all about this
86 in the
87 full `OAuth 2 workflow guide on RTD
88 <https://requests-oauthlib.readthedocs.io/en/latest/oauth2_workflow.html>`_
89 .
90
91 Installation
92 -------------
93
94 To install requests and requests_oauthlib you can use pip:
95
96 .. code-block:: bash
97
98     $ pip install requests requests_oauthlib
99
100 .. |build-status| image::
101 https://travis-ci.org/requests/requests-oauthlib.svg?branch=master
102    :target: https://travis-ci.org/requests/requests-oauthlib
103 .. |coverage-status| image::
104 https://img.shields.io/coveralls/requests/requests-oauthlib.svg
105    :target: https://coveralls.io/r/requests/requests-oauthlib
106 .. |docs| image:: https://readthedocs.org/projects/requests-oauthlib/badge/
107    :alt: Documentation Status
108    :scale: 100%
109    :target: https://requests-oauthlib.readthedocs.io/
110
111
112 History
113 -------
114
115 UNRELEASED
116 ++++++++++
117
118 nothing yet
119
120 v1.3.0 (6 November 2019)
121 ++++++++++++++++++++++++
122
123 - Instagram compliance fix
124 - Added ``force_querystring`` argument to fetch_token() method on
125 OAuth2Session
126
127 v1.2.0 (14 January 2019)
128 ++++++++++++++++++++++++
129
130 - This project now depends on OAuthlib 3.0.0 and above. It does **not**
131 support
132   versions of OAuthlib before 3.0.0.
133 - Updated oauth2 tests to use 'sess' for an OAuth2Session instance instead
134 of `auth`
135   because OAuth2Session objects and methods acceept an `auth` paramether
136 which is
137   typically an instance of `requests.auth.HTTPBasicAuth`
138 - `OAuth2Session.fetch_token` previously tried to guess how and where to
139 provide
140   "client" and "user" credentials incorrectly. This was incompatible with
141 some
142   OAuth servers and incompatible with breaking changes in oauthlib that
143 seek to
144   correctly provide the `client_id`. The older implementation also did not
145 raise
146   the correct exceptions when username and password are not present on
147 Legacy
148   clients.
149 - Avoid automatic netrc authentication for OAuth2Session.
150
151 v1.1.0 (9 January 2019)
152 +++++++++++++++++++++++
153
154 - Adjusted version specifier for ``oauthlib`` dependency: this project is
155   not yet compatible with ``oauthlib`` 3.0.0.
156 - Dropped dependency on ``nose``.
157 - Minor changes to clean up the code and make it more
158 readable/maintainable.
159
160 v1.0.0 (4 June 2018)
161 ++++++++++++++++++++
162
163
164 [FILE:109:distinfo]
165 b4261601a71fd721a8bd6d7aa1cc1d6a8a93b4a9f5e96626f8e4d91e8beeaa6a        88157 requests-oauthlib-1.3.0.tar.gz
166