Mercurial > repos > rliterman > csp2

annotate CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/lib/python3.8/site-packages/httpx-0.28.1.dist-info/METADATA @ 69:33d812a61356

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
planemo upload commit 2e9511a184a1ca667c7be0c6321a36dc4e3d116d
author jpayne
date Tue, 18 Mar 2025 17:55:14 -0400
parents
children
rev   line source
jpayne@69 1 Metadata-Version: 2.3
jpayne@69 2 Name: httpx
jpayne@69 3 Version: 0.28.1
jpayne@69 4 Summary: The next generation HTTP client.
jpayne@69 5 Project-URL: Changelog, https://github.com/encode/httpx/blob/master/CHANGELOG.md
jpayne@69 6 Project-URL: Documentation, https://www.python-httpx.org
jpayne@69 7 Project-URL: Homepage, https://github.com/encode/httpx
jpayne@69 8 Project-URL: Source, https://github.com/encode/httpx
jpayne@69 9 Author-email: Tom Christie <tom@tomchristie.com>
jpayne@69 10 License: BSD-3-Clause
jpayne@69 11 Classifier: Development Status :: 4 - Beta
jpayne@69 12 Classifier: Environment :: Web Environment
jpayne@69 13 Classifier: Framework :: AsyncIO
jpayne@69 14 Classifier: Framework :: Trio
jpayne@69 15 Classifier: Intended Audience :: Developers
jpayne@69 16 Classifier: License :: OSI Approved :: BSD License
jpayne@69 17 Classifier: Operating System :: OS Independent
jpayne@69 18 Classifier: Programming Language :: Python :: 3
jpayne@69 19 Classifier: Programming Language :: Python :: 3 :: Only
jpayne@69 20 Classifier: Programming Language :: Python :: 3.8
jpayne@69 21 Classifier: Programming Language :: Python :: 3.9
jpayne@69 22 Classifier: Programming Language :: Python :: 3.10
jpayne@69 23 Classifier: Programming Language :: Python :: 3.11
jpayne@69 24 Classifier: Programming Language :: Python :: 3.12
jpayne@69 25 Classifier: Topic :: Internet :: WWW/HTTP
jpayne@69 26 Requires-Python: >=3.8
jpayne@69 27 Requires-Dist: anyio
jpayne@69 28 Requires-Dist: certifi
jpayne@69 29 Requires-Dist: httpcore==1.*
jpayne@69 30 Requires-Dist: idna
jpayne@69 31 Provides-Extra: brotli
jpayne@69 32 Requires-Dist: brotli; (platform_python_implementation == 'CPython') and extra == 'brotli'
jpayne@69 33 Requires-Dist: brotlicffi; (platform_python_implementation != 'CPython') and extra == 'brotli'
jpayne@69 34 Provides-Extra: cli
jpayne@69 35 Requires-Dist: click==8.*; extra == 'cli'
jpayne@69 36 Requires-Dist: pygments==2.*; extra == 'cli'
jpayne@69 37 Requires-Dist: rich<14,>=10; extra == 'cli'
jpayne@69 38 Provides-Extra: http2
jpayne@69 39 Requires-Dist: h2<5,>=3; extra == 'http2'
jpayne@69 40 Provides-Extra: socks
jpayne@69 41 Requires-Dist: socksio==1.*; extra == 'socks'
jpayne@69 42 Provides-Extra: zstd
jpayne@69 43 Requires-Dist: zstandard>=0.18.0; extra == 'zstd'
jpayne@69 44 Description-Content-Type: text/markdown
jpayne@69 45
jpayne@69 46 <p align="center">
jpayne@69 47 <a href="https://www.python-httpx.org/"><img width="350" height="208" src="https://raw.githubusercontent.com/encode/httpx/master/docs/img/butterfly.png" alt='HTTPX'></a>
jpayne@69 48 </p>
jpayne@69 49
jpayne@69 50 <p align="center"><strong>HTTPX</strong> <em>- A next-generation HTTP client for Python.</em></p>
jpayne@69 51
jpayne@69 52 <p align="center">
jpayne@69 53 <a href="https://github.com/encode/httpx/actions">
jpayne@69 54 <img src="https://github.com/encode/httpx/workflows/Test%20Suite/badge.svg" alt="Test Suite">
jpayne@69 55 </a>
jpayne@69 56 <a href="https://pypi.org/project/httpx/">
jpayne@69 57 <img src="https://badge.fury.io/py/httpx.svg" alt="Package version">
jpayne@69 58 </a>
jpayne@69 59 </p>
jpayne@69 60
jpayne@69 61 HTTPX is a fully featured HTTP client library for Python 3. It includes **an integrated command line client**, has support for both **HTTP/1.1 and HTTP/2**, and provides both **sync and async APIs**.
jpayne@69 62
jpayne@69 63 ---
jpayne@69 64
jpayne@69 65 Install HTTPX using pip:
jpayne@69 66
jpayne@69 67 ```shell
jpayne@69 68 $ pip install httpx
jpayne@69 69 ```
jpayne@69 70
jpayne@69 71 Now, let's get started:
jpayne@69 72
jpayne@69 73 ```pycon
jpayne@69 74 >>> import httpx
jpayne@69 75 >>> r = httpx.get('https://www.example.org/')
jpayne@69 76 >>> r
jpayne@69 77 <Response [200 OK]>
jpayne@69 78 >>> r.status_code
jpayne@69 79 200
jpayne@69 80 >>> r.headers['content-type']
jpayne@69 81 'text/html; charset=UTF-8'
jpayne@69 82 >>> r.text
jpayne@69 83 '<!doctype html>\n<html>\n<head>\n<title>Example Domain</title>...'
jpayne@69 84 ```
jpayne@69 85
jpayne@69 86 Or, using the command-line client.
jpayne@69 87
jpayne@69 88 ```shell
jpayne@69 89 $ pip install 'httpx[cli]' # The command line client is an optional dependency.
jpayne@69 90 ```
jpayne@69 91
jpayne@69 92 Which now allows us to use HTTPX directly from the command-line...
jpayne@69 93
jpayne@69 94 <p align="center">
jpayne@69 95 <img width="700" src="https://raw.githubusercontent.com/encode/httpx/master/docs/img/httpx-help.png" alt='httpx --help'>
jpayne@69 96 </p>
jpayne@69 97
jpayne@69 98 Sending a request...
jpayne@69 99
jpayne@69 100 <p align="center">
jpayne@69 101 <img width="700" src="https://raw.githubusercontent.com/encode/httpx/master/docs/img/httpx-request.png" alt='httpx http://httpbin.org/json'>
jpayne@69 102 </p>
jpayne@69 103
jpayne@69 104 ## Features
jpayne@69 105
jpayne@69 106 HTTPX builds on the well-established usability of `requests`, and gives you:
jpayne@69 107
jpayne@69 108 * A broadly [requests-compatible API](https://www.python-httpx.org/compatibility/).
jpayne@69 109 * An integrated command-line client.
jpayne@69 110 * HTTP/1.1 [and HTTP/2 support](https://www.python-httpx.org/http2/).
jpayne@69 111 * Standard synchronous interface, but with [async support if you need it](https://www.python-httpx.org/async/).
jpayne@69 112 * Ability to make requests directly to [WSGI applications](https://www.python-httpx.org/advanced/transports/#wsgi-transport) or [ASGI applications](https://www.python-httpx.org/advanced/transports/#asgi-transport).
jpayne@69 113 * Strict timeouts everywhere.
jpayne@69 114 * Fully type annotated.
jpayne@69 115 * 100% test coverage.
jpayne@69 116
jpayne@69 117 Plus all the standard features of `requests`...
jpayne@69 118
jpayne@69 119 * International Domains and URLs
jpayne@69 120 * Keep-Alive & Connection Pooling
jpayne@69 121 * Sessions with Cookie Persistence
jpayne@69 122 * Browser-style SSL Verification
jpayne@69 123 * Basic/Digest Authentication
jpayne@69 124 * Elegant Key/Value Cookies
jpayne@69 125 * Automatic Decompression
jpayne@69 126 * Automatic Content Decoding
jpayne@69 127 * Unicode Response Bodies
jpayne@69 128 * Multipart File Uploads
jpayne@69 129 * HTTP(S) Proxy Support
jpayne@69 130 * Connection Timeouts
jpayne@69 131 * Streaming Downloads
jpayne@69 132 * .netrc Support
jpayne@69 133 * Chunked Requests
jpayne@69 134
jpayne@69 135 ## Installation
jpayne@69 136
jpayne@69 137 Install with pip:
jpayne@69 138
jpayne@69 139 ```shell
jpayne@69 140 $ pip install httpx
jpayne@69 141 ```
jpayne@69 142
jpayne@69 143 Or, to include the optional HTTP/2 support, use:
jpayne@69 144
jpayne@69 145 ```shell
jpayne@69 146 $ pip install httpx[http2]
jpayne@69 147 ```
jpayne@69 148
jpayne@69 149 HTTPX requires Python 3.8+.
jpayne@69 150
jpayne@69 151 ## Documentation
jpayne@69 152
jpayne@69 153 Project documentation is available at [https://www.python-httpx.org/](https://www.python-httpx.org/).
jpayne@69 154
jpayne@69 155 For a run-through of all the basics, head over to the [QuickStart](https://www.python-httpx.org/quickstart/).
jpayne@69 156
jpayne@69 157 For more advanced topics, see the [Advanced Usage](https://www.python-httpx.org/advanced/) section, the [async support](https://www.python-httpx.org/async/) section, or the [HTTP/2](https://www.python-httpx.org/http2/) section.
jpayne@69 158
jpayne@69 159 The [Developer Interface](https://www.python-httpx.org/api/) provides a comprehensive API reference.
jpayne@69 160
jpayne@69 161 To find out about tools that integrate with HTTPX, see [Third Party Packages](https://www.python-httpx.org/third_party_packages/).
jpayne@69 162
jpayne@69 163 ## Contribute
jpayne@69 164
jpayne@69 165 If you want to contribute with HTTPX check out the [Contributing Guide](https://www.python-httpx.org/contributing/) to learn how to start.
jpayne@69 166
jpayne@69 167 ## Dependencies
jpayne@69 168
jpayne@69 169 The HTTPX project relies on these excellent libraries:
jpayne@69 170
jpayne@69 171 * `httpcore` - The underlying transport implementation for `httpx`.
jpayne@69 172 * `h11` - HTTP/1.1 support.
jpayne@69 173 * `certifi` - SSL certificates.
jpayne@69 174 * `idna` - Internationalized domain name support.
jpayne@69 175 * `sniffio` - Async library autodetection.
jpayne@69 176
jpayne@69 177 As well as these optional installs:
jpayne@69 178
jpayne@69 179 * `h2` - HTTP/2 support. *(Optional, with `httpx[http2]`)*
jpayne@69 180 * `socksio` - SOCKS proxy support. *(Optional, with `httpx[socks]`)*
jpayne@69 181 * `rich` - Rich terminal support. *(Optional, with `httpx[cli]`)*
jpayne@69 182 * `click` - Command line client support. *(Optional, with `httpx[cli]`)*
jpayne@69 183 * `brotli` or `brotlicffi` - Decoding for "brotli" compressed responses. *(Optional, with `httpx[brotli]`)*
jpayne@69 184 * `zstandard` - Decoding for "zstd" compressed responses. *(Optional, with `httpx[zstd]`)*
jpayne@69 185
jpayne@69 186 A huge amount of credit is due to `requests` for the API layout that
jpayne@69 187 much of this work follows, as well as to `urllib3` for plenty of design
jpayne@69 188 inspiration around the lower-level networking details.
jpayne@69 189
jpayne@69 190 ---
jpayne@69 191
jpayne@69 192 <p align="center"><i>HTTPX is <a href="https://github.com/encode/httpx/blob/master/LICENSE.md">BSD licensed</a> code.<br/>Designed & crafted with care.</i><br/>&mdash; 🦋 &mdash;</p>
jpayne@69 193
jpayne@69 194 ## Release Information
jpayne@69 195
jpayne@69 196 ### Fixed
jpayne@69 197
jpayne@69 198 * Reintroduced supposedly-private `URLTypes` shortcut. (#2673)
jpayne@69 199
jpayne@69 200
jpayne@69 201 ---
jpayne@69 202
jpayne@69 203 [Full changelog](https://github.com/encode/httpx/blob/master/CHANGELOG.md)