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

diff --git a/README.md b/README.md
index 0be86184779dd30f9217f0b4f03e97f013ea26ce..574c7c35e9738ec45adc1950e1c22d66a66ee442 100644 (file)
--- 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 2bc69b58ad819e355ece49c0334e4b8586b9fe3c..0f93117155aab7cabc56d14339905c39ef7e14d9 100644 (file)
--- 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 (file)
index 0000000..cc6a799
--- /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 852bb828a88e6d387b2105f4b45693d3cb69b5a6..518736c2135027f191ddce4ee1679d711c1ec24c 100644 (file)
--- 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: