From d7f76d9b2504f320ecaa8178823ca742cf489f51 Mon Sep 17 00:00:00 2001 From: Will Ockmore Date: Mon, 21 Apr 2025 00:02:15 +0100 Subject: [PATCH 1/7] Add httpx-retries to third party packages docs Sorts the entries on the page to make it easier to browse. --- docs/third_party_packages.md | 78 +++++++++++++++++++----------------- 1 file changed, 42 insertions(+), 36 deletions(-) diff --git a/docs/third_party_packages.md b/docs/third_party_packages.md index 22e0f1a908..5d7f6c9f7c 100644 --- a/docs/third_party_packages.md +++ b/docs/third_party_packages.md @@ -4,17 +4,23 @@ As HTTPX usage grows, there is an expanding community of developers building too ## Plugins -### httpx-ws +### Authlib -[GitHub](https://github.com/frankie567/httpx-ws) - [Documentation](https://frankie567.github.io/httpx-ws/) +[GitHub](https://github.com/lepture/authlib) - [Documentation](https://docs.authlib.org/en/latest/) -WebSocket support for HTTPX. +The ultimate Python library in building OAuth and OpenID Connect clients and servers. Includes an [OAuth HTTPX client](https://docs.authlib.org/en/latest/client/httpx.html). -### httpx-socks +### Gidgethub -[GitHub](https://github.com/romis2012/httpx-socks) +[GitHub](https://github.com/brettcannon/gidgethub) - [Documentation](https://gidgethub.readthedocs.io/en/latest/index.html) -Proxy (HTTP, SOCKS) transports for httpx. +An asynchronous GitHub API library. Includes [HTTPX support](https://gidgethub.readthedocs.io/en/latest/httpx.html). + +### Hishel + +[GitHub](https://github.com/karpetrosyan/hishel) - [Documentation](https://hishel.com/) + +An elegant HTTP Cache implementation for HTTPX and HTTP Core. ### httpdbg @@ -22,29 +28,41 @@ Proxy (HTTP, SOCKS) transports for httpx. A tool for Python developers to easily debug the HTTP(S) client requests in a Python program. -### Hishel +### HTTPX-Auth -[GitHub](https://github.com/karpetrosyan/hishel) - [Documentation](https://hishel.com/) +[GitHub](https://github.com/Colin-b/httpx_auth) - [Documentation](https://colin-b.github.io/httpx_auth/) -An elegant HTTP Cache implementation for HTTPX and HTTP Core. +Provides authentication classes to be used with HTTPX [authentication parameter](advanced/authentication.md#customizing-authentication). -### Authlib +### httpx-caching -[GitHub](https://github.com/lepture/authlib) - [Documentation](https://docs.authlib.org/en/latest/) +[Github](https://github.com/johtso/httpx-caching) -The ultimate Python library in building OAuth and OpenID Connect clients and servers. Includes an [OAuth HTTPX client](https://docs.authlib.org/en/latest/client/httpx.html). +This package adds caching functionality to HTTPX -### Gidgethub +### httpx-socks -[GitHub](https://github.com/brettcannon/gidgethub) - [Documentation](https://gidgethub.readthedocs.io/en/latest/index.html) +[GitHub](https://github.com/romis2012/httpx-socks) -An asynchronous GitHub API library. Includes [HTTPX support](https://gidgethub.readthedocs.io/en/latest/httpx.html). +Proxy (HTTP, SOCKS) transports for httpx. -### HTTPX-Auth +### httpx-sse -[GitHub](https://github.com/Colin-b/httpx_auth) - [Documentation](https://colin-b.github.io/httpx_auth/) +[GitHub](https://github.com/florimondmanca/httpx-sse) -Provides authentication classes to be used with HTTPX [authentication parameter](advanced/authentication.md#customizing-authentication). +Allows consuming Server-Sent Events (SSE) with HTTPX. + +### httpx-retries + +[GitHub](https://github.com/will-ockmore/httpx-retries) - [Documentation](https://will-ockmore.github.io/httpx-retries/) + +A retry layer for HTTPX. + +### httpx-ws + +[GitHub](https://github.com/frankie567/httpx-ws) - [Documentation](https://frankie567.github.io/httpx-ws/) + +WebSocket support for HTTPX. ### pytest-HTTPX @@ -58,6 +76,12 @@ Provides `httpx_mock` [pytest](https://docs.pytest.org/en/latest/) fixture to mo A utility for mocking out the Python HTTPX library. +### robox + +[Github](https://github.com/danclaudiupop/robox) + +A library for scraping the web built on top of HTTPX. + ### rpc.py [Github](https://github.com/abersheeran/rpc.py) - [Documentation](https://github.com/abersheeran/rpc.py#rpcpy) @@ -70,24 +94,6 @@ An fast and powerful RPC framework based on ASGI/WSGI. Use HTTPX as the client o A utility for record and repeat an http request. -### httpx-caching - -[Github](https://github.com/johtso/httpx-caching) - -This package adds caching functionality to HTTPX - -### httpx-sse - -[GitHub](https://github.com/florimondmanca/httpx-sse) - -Allows consuming Server-Sent Events (SSE) with HTTPX. - -### robox - -[Github](https://github.com/danclaudiupop/robox) - -A library for scraping the web built on top of HTTPX. - ## Gists From b8ae7e262e255b83f441499a31e6159b781d46df Mon Sep 17 00:00:00 2001 From: Will Ockmore Date: Fri, 2 May 2025 10:18:41 +0100 Subject: [PATCH 2/7] Remove robox --- docs/third_party_packages.md | 6 ------ 1 file changed, 6 deletions(-) diff --git a/docs/third_party_packages.md b/docs/third_party_packages.md index 5d7f6c9f7c..0de950b1b8 100644 --- a/docs/third_party_packages.md +++ b/docs/third_party_packages.md @@ -76,12 +76,6 @@ Provides `httpx_mock` [pytest](https://docs.pytest.org/en/latest/) fixture to mo A utility for mocking out the Python HTTPX library. -### robox - -[Github](https://github.com/danclaudiupop/robox) - -A library for scraping the web built on top of HTTPX. - ### rpc.py [Github](https://github.com/abersheeran/rpc.py) - [Documentation](https://github.com/abersheeran/rpc.py#rpcpy) From a3ceb5ba06efd6b855486a64298ad84979281def Mon Sep 17 00:00:00 2001 From: Will Ockmore Date: Fri, 2 May 2025 10:33:17 +0100 Subject: [PATCH 3/7] Add "libraries with httpx support" section --- docs/third_party_packages.md | 42 +++++++++++++++++++----------------- 1 file changed, 22 insertions(+), 20 deletions(-) diff --git a/docs/third_party_packages.md b/docs/third_party_packages.md index 0de950b1b8..f8ac071a42 100644 --- a/docs/third_party_packages.md +++ b/docs/third_party_packages.md @@ -2,19 +2,9 @@ As HTTPX usage grows, there is an expanding community of developers building tools and libraries that integrate with HTTPX, or depend on HTTPX. Here are some of them. -## Plugins - -### Authlib - -[GitHub](https://github.com/lepture/authlib) - [Documentation](https://docs.authlib.org/en/latest/) - -The ultimate Python library in building OAuth and OpenID Connect clients and servers. Includes an [OAuth HTTPX client](https://docs.authlib.org/en/latest/client/httpx.html). - -### Gidgethub - -[GitHub](https://github.com/brettcannon/gidgethub) - [Documentation](https://gidgethub.readthedocs.io/en/latest/index.html) + -An asynchronous GitHub API library. Includes [HTTPX support](https://gidgethub.readthedocs.io/en/latest/httpx.html). +## Plugins ### Hishel @@ -22,12 +12,6 @@ An asynchronous GitHub API library. Includes [HTTPX support](https://gidgethub.r An elegant HTTP Cache implementation for HTTPX and HTTP Core. -### httpdbg - -[GitHub](https://github.com/cle-b/httpdbg) - [Documentation](https://httpdbg.readthedocs.io/) - -A tool for Python developers to easily debug the HTTP(S) client requests in a Python program. - ### HTTPX-Auth [GitHub](https://github.com/Colin-b/httpx_auth) - [Documentation](https://colin-b.github.io/httpx_auth/) @@ -82,6 +66,26 @@ A utility for mocking out the Python HTTPX library. An fast and powerful RPC framework based on ASGI/WSGI. Use HTTPX as the client of the RPC service. +## Libraries with HTTPX support + +### Authlib + +[GitHub](https://github.com/lepture/authlib) - [Documentation](https://docs.authlib.org/en/latest/) + +A python library for building OAuth and OpenID Connect clients and servers. Includes an [OAuth HTTPX client](https://docs.authlib.org/en/latest/client/httpx.html). + +### Gidgethub + +[GitHub](https://github.com/brettcannon/gidgethub) - [Documentation](https://gidgethub.readthedocs.io/en/latest/index.html) + +An asynchronous GitHub API library. Includes [HTTPX support](https://gidgethub.readthedocs.io/en/latest/httpx.html). + +### httpdbg + +[GitHub](https://github.com/cle-b/httpdbg) - [Documentation](https://httpdbg.readthedocs.io/) + +A tool for Python developers to easily debug the HTTP(S) client requests in a Python program. + ### VCR.py [GitHub](https://github.com/kevin1024/vcrpy) - [Documentation](https://vcrpy.readthedocs.io/) @@ -90,8 +94,6 @@ A utility for record and repeat an http request. ## Gists - - ### urllib3-transport [GitHub](https://gist.github.com/florimondmanca/d56764d78d748eb9f73165da388e546e) From d69ef5ece095e8cc7f897607050c93bb9a6617e8 Mon Sep 17 00:00:00 2001 From: Will Ockmore Date: Fri, 2 May 2025 10:35:42 +0100 Subject: [PATCH 4/7] Simplify VCR tagline --- docs/third_party_packages.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/third_party_packages.md b/docs/third_party_packages.md index f8ac071a42..499d496fd7 100644 --- a/docs/third_party_packages.md +++ b/docs/third_party_packages.md @@ -90,7 +90,7 @@ A tool for Python developers to easily debug the HTTP(S) client requests in a Py [GitHub](https://github.com/kevin1024/vcrpy) - [Documentation](https://vcrpy.readthedocs.io/) -A utility for record and repeat an http request. +Record and repeat requests. ## Gists From 42bed54da3f9f73e684742154260cc5d7ffd460a Mon Sep 17 00:00:00 2001 From: Will Ockmore Date: Fri, 2 May 2025 10:36:19 +0100 Subject: [PATCH 5/7] consistent "python" lowercasing --- docs/third_party_packages.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/third_party_packages.md b/docs/third_party_packages.md index 499d496fd7..ed16f8ad07 100644 --- a/docs/third_party_packages.md +++ b/docs/third_party_packages.md @@ -58,7 +58,7 @@ Provides `httpx_mock` [pytest](https://docs.pytest.org/en/latest/) fixture to mo [GitHub](https://github.com/lundberg/respx) - [Documentation](https://lundberg.github.io/respx/) -A utility for mocking out the Python HTTPX library. +A utility for mocking out the python HTTPX library. ### rpc.py @@ -84,7 +84,7 @@ An asynchronous GitHub API library. Includes [HTTPX support](https://gidgethub.r [GitHub](https://github.com/cle-b/httpdbg) - [Documentation](https://httpdbg.readthedocs.io/) -A tool for Python developers to easily debug the HTTP(S) client requests in a Python program. +A tool for python developers to easily debug the HTTP(S) client requests in a python program. ### VCR.py From 59cf69672409a1f4a6ed2c0a307ef6f8517f72dc Mon Sep 17 00:00:00 2001 From: Will Ockmore Date: Fri, 2 May 2025 10:37:53 +0100 Subject: [PATCH 6/7] grammar improvements --- docs/third_party_packages.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/third_party_packages.md b/docs/third_party_packages.md index ed16f8ad07..87ff345c37 100644 --- a/docs/third_party_packages.md +++ b/docs/third_party_packages.md @@ -58,13 +58,13 @@ Provides `httpx_mock` [pytest](https://docs.pytest.org/en/latest/) fixture to mo [GitHub](https://github.com/lundberg/respx) - [Documentation](https://lundberg.github.io/respx/) -A utility for mocking out the python HTTPX library. +A utility for mocking out HTTPX. ### rpc.py [Github](https://github.com/abersheeran/rpc.py) - [Documentation](https://github.com/abersheeran/rpc.py#rpcpy) -An fast and powerful RPC framework based on ASGI/WSGI. Use HTTPX as the client of the RPC service. +A fast and powerful RPC framework based on ASGI/WSGI. Use HTTPX as the client of the RPC service. ## Libraries with HTTPX support From 8ccabf08526ba73f38a9027450ec35a7cca38de4 Mon Sep 17 00:00:00 2001 From: Will Ockmore Date: Fri, 2 May 2025 10:48:07 +0100 Subject: [PATCH 7/7] small grammar improvements --- docs/third_party_packages.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/third_party_packages.md b/docs/third_party_packages.md index 87ff345c37..546607f716 100644 --- a/docs/third_party_packages.md +++ b/docs/third_party_packages.md @@ -16,7 +16,7 @@ An elegant HTTP Cache implementation for HTTPX and HTTP Core. [GitHub](https://github.com/Colin-b/httpx_auth) - [Documentation](https://colin-b.github.io/httpx_auth/) -Provides authentication classes to be used with HTTPX [authentication parameter](advanced/authentication.md#customizing-authentication). +Provides authentication classes to be used with HTTPX's [authentication parameter](advanced/authentication.md#customizing-authentication). ### httpx-caching @@ -52,7 +52,7 @@ WebSocket support for HTTPX. [GitHub](https://github.com/Colin-b/pytest_httpx) - [Documentation](https://colin-b.github.io/pytest_httpx/) -Provides `httpx_mock` [pytest](https://docs.pytest.org/en/latest/) fixture to mock HTTPX within test cases. +Provides a [pytest](https://docs.pytest.org/en/latest/) fixture to mock HTTPX within test cases. ### RESPX