From: Florimond Manca <florimond.manca@gmail.com>
Date: Thu, 26 Mar 2020 14:43:04 +0000 (+0100)
Subject: Add 'Third Party Packages' docs page (#876)
X-Git-Tag: 0.13.0.dev0~19
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=21f533774f87292c2381376eb40f3216a48eee06;p=thirdparty%2Fhttpx.git

Add 'Third Party Packages' docs page (#876)
---

diff --git a/README.md b/README.md
index 0be86184..574c7c35 100644
--- a/README.md
+++ b/README.md
@@ -101,6 +101,8 @@ For more advanced topics, see the [Advanced Usage](https://www.python-httpx.org/
 
 The [Developer Interface](https://www.python-httpx.org/api/) provides a comprehensive API reference.
 
+To find out about tools that integrate with HTTPX, see [Third Party Packages](https://www.python-httpx.org/third-party-packages/).
+
 ## Contribute
 
 If you want to contribute with HTTPX check out the [Contributing Guide](https://www.python-httpx.org/contributing/) to learn how to start.
diff --git a/docs/index.md b/docs/index.md
index 2bc69b58..0f931171 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -103,6 +103,8 @@ the [async support](async.md) section, or the [HTTP/2](http2.md) section.
 
 The [Developer Interface](api.md) provides a comprehensive API reference.
 
+To find out about tools that integrate with HTTPX, see [Third Party Packages](third-party-packages.md).
+
 ## Dependencies
 
 The HTTPX project relies on these excellent libraries:
diff --git a/docs/third-party-packages.md b/docs/third-party-packages.md
new file mode 100644
index 00000000..cc6a7999
--- /dev/null
+++ b/docs/third-party-packages.md
@@ -0,0 +1,25 @@
+# Third Party Packages
+
+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
+
+<!-- NOTE: this list is in alphabetical order. -->
+
+### 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).
+
+### RESPX
+
+[GitHub](https://github.com/lundberg/respx) - [Documentation](https://lundberg.github.io/respx/)
+
+A utility for mocking out the Python HTTPX library.
diff --git a/mkdocs.yml b/mkdocs.yml
index 852bb828..518736c2 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -18,6 +18,7 @@ nav:
     - Environment Variables: 'environment_variables.md'
     - Requests Compatibility: 'compatibility.md'
     - Developer Interface: 'api.md'
+    - Third Party Packages: 'third-party-packages.md'
     - Contributing: 'contributing.md'
 
 markdown_extensions: