comparison requests/__init__.py @ 7:5eb2d5e3bf22

planemo upload for repository https://toolrepo.galaxytrakr.org/view/jpayne/bioproject_to_srr_2/556cac4fb538
author jpayne
date Sun, 05 May 2024 23:32:17 -0400
parents
children
comparison
equal deleted inserted replaced
6:b2745907b1eb 7:5eb2d5e3bf22
1 # __
2 # /__) _ _ _ _ _/ _
3 # / ( (- (/ (/ (- _) / _)
4 # /
5
6 """
7 Requests HTTP Library
8 ~~~~~~~~~~~~~~~~~~~~~
9
10 Requests is an HTTP library, written in Python, for human beings.
11 Basic GET usage:
12
13 >>> import requests
14 >>> r = requests.get('https://www.python.org')
15 >>> r.status_code
16 200
17 >>> b'Python is a programming language' in r.content
18 True
19
20 ... or POST:
21
22 >>> payload = dict(key1='value1', key2='value2')
23 >>> r = requests.post('https://httpbin.org/post', data=payload)
24 >>> print(r.text)
25 {
26 ...
27 "form": {
28 "key1": "value1",
29 "key2": "value2"
30 },
31 ...
32 }
33
34 The other HTTP methods are supported - see `requests.api`. Full documentation
35 is at <https://requests.readthedocs.io>.
36
37 :copyright: (c) 2017 by Kenneth Reitz.
38 :license: Apache 2.0, see LICENSE for more details.
39 """
40
41 import warnings
42
43 import urllib3
44
45 from .exceptions import RequestsDependencyWarning
46
47 try:
48 from charset_normalizer import __version__ as charset_normalizer_version
49 except ImportError:
50 charset_normalizer_version = None
51
52 try:
53 from chardet import __version__ as chardet_version
54 except ImportError:
55 chardet_version = None
56
57
58 def check_compatibility(urllib3_version, chardet_version, charset_normalizer_version):
59 urllib3_version = urllib3_version.split(".")
60 assert urllib3_version != ["dev"] # Verify urllib3 isn't installed from git.
61
62 # Sometimes, urllib3 only reports its version as 16.1.
63 if len(urllib3_version) == 2:
64 urllib3_version.append("0")
65
66 # Check urllib3 for compatibility.
67 major, minor, patch = urllib3_version # noqa: F811
68 major, minor, patch = int(major), int(minor), int(patch)
69 # urllib3 >= 1.21.1
70 assert major >= 1
71 if major == 1:
72 assert minor >= 21
73
74 # Check charset_normalizer for compatibility.
75 if chardet_version:
76 major, minor, patch = chardet_version.split(".")[:3]
77 major, minor, patch = int(major), int(minor), int(patch)
78 # chardet_version >= 3.0.2, < 6.0.0
79 assert (3, 0, 2) <= (major, minor, patch) < (6, 0, 0)
80 elif charset_normalizer_version:
81 major, minor, patch = charset_normalizer_version.split(".")[:3]
82 major, minor, patch = int(major), int(minor), int(patch)
83 # charset_normalizer >= 2.0.0 < 4.0.0
84 assert (2, 0, 0) <= (major, minor, patch) < (4, 0, 0)
85 else:
86 raise Exception("You need either charset_normalizer or chardet installed")
87
88
89 def _check_cryptography(cryptography_version):
90 # cryptography < 1.3.4
91 try:
92 cryptography_version = list(map(int, cryptography_version.split(".")))
93 except ValueError:
94 return
95
96 if cryptography_version < [1, 3, 4]:
97 warning = "Old version of cryptography ({}) may cause slowdown.".format(
98 cryptography_version
99 )
100 warnings.warn(warning, RequestsDependencyWarning)
101
102
103 # Check imported dependencies for compatibility.
104 try:
105 check_compatibility(
106 urllib3.__version__, chardet_version, charset_normalizer_version
107 )
108 except (AssertionError, ValueError):
109 warnings.warn(
110 "urllib3 ({}) or chardet ({})/charset_normalizer ({}) doesn't match a supported "
111 "version!".format(
112 urllib3.__version__, chardet_version, charset_normalizer_version
113 ),
114 RequestsDependencyWarning,
115 )
116
117 # Attempt to enable urllib3's fallback for SNI support
118 # if the standard library doesn't support SNI or the
119 # 'ssl' library isn't available.
120 try:
121 try:
122 import ssl
123 except ImportError:
124 ssl = None
125
126 if not getattr(ssl, "HAS_SNI", False):
127 from urllib3.contrib import pyopenssl
128
129 pyopenssl.inject_into_urllib3()
130
131 # Check cryptography version
132 from cryptography import __version__ as cryptography_version
133
134 _check_cryptography(cryptography_version)
135 except ImportError:
136 pass
137
138 # urllib3's DependencyWarnings should be silenced.
139 from urllib3.exceptions import DependencyWarning
140
141 warnings.simplefilter("ignore", DependencyWarning)
142
143 # Set default logging handler to avoid "No handler found" warnings.
144 import logging
145 from logging import NullHandler
146
147 from . import packages, utils
148 from .__version__ import (
149 __author__,
150 __author_email__,
151 __build__,
152 __cake__,
153 __copyright__,
154 __description__,
155 __license__,
156 __title__,
157 __url__,
158 __version__,
159 )
160 from .api import delete, get, head, options, patch, post, put, request
161 from .exceptions import (
162 ConnectionError,
163 ConnectTimeout,
164 FileModeWarning,
165 HTTPError,
166 JSONDecodeError,
167 ReadTimeout,
168 RequestException,
169 Timeout,
170 TooManyRedirects,
171 URLRequired,
172 )
173 from .models import PreparedRequest, Request, Response
174 from .sessions import Session, session
175 from .status_codes import codes
176
177 logging.getLogger(__name__).addHandler(NullHandler())
178
179 # FileModeWarnings go off per the default.
180 warnings.simplefilter("default", FileModeWarning, append=True)