From f3c66d0abd8978f1b9ec7387a99797ed4cec05f1 Mon Sep 17 00:00:00 2001
From: Tobias Klare <klare@dkms-lab.de>
Date: Mon, 28 Apr 2025 13:41:33 +0200
Subject: [PATCH 1/2] feat: register httpx_auth.testing as pytest plugin

---
 pyproject.toml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/pyproject.toml b/pyproject.toml
index 9f68ced..b7a9a8e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -55,6 +55,9 @@ testing = [
     "pytest-asyncio==0.25.*",
 ]
 
+[project.entry-points.pytest11]
+httpx_auth = "httpx_auth.testing"
+
 [tool.setuptools.dynamic]
 version = {attr = "httpx_auth.version.__version__"}
 

From 1a0bed9a312622214b0b7ea5bbb624453c0748db Mon Sep 17 00:00:00 2001
From: Tobias Klare <klare@dkms-lab.de>
Date: Mon, 28 Apr 2025 13:43:12 +0200
Subject: [PATCH 2/2] docs: remove unnecessary imports

Because `httpx_auth.testing` is registered as a pytest plugin, import of fixtures is not necessary anymore.

Also prefer `pytest.mark.usefixture` when fixture doesn't return anything.
---
 README.md | 23 +++++++++++++----------
 1 file changed, 13 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index 9f538e0..294592d 100644
--- a/README.md
+++ b/README.md
@@ -903,9 +903,10 @@ Testing the code using `httpx_auth` authentication classes can be achieved using
 ### token_cache_mock
 
 ```python
-from httpx_auth.testing import token_cache_mock, token_mock
+import pytest
 
-def test_something(token_cache_mock):
+@pytest.mark.usefixture("token_cache_mock")
+def test_something():
     # perform code using authentication
     pass
 ```
@@ -933,15 +934,14 @@ You can however return your custom token by providing your own `token_mock` fixt
 ```python
 import pytest
 
-from httpx_auth.testing import token_cache_mock
-
 
 @pytest.fixture
 def token_mock() -> str:
     return "MyCustomTokenValue"
 
 
-def test_something(token_cache_mock):
+@pytest.mark.usefixtures("token_cache_mock")
+def test_something():
     # perform code using authentication
     pass
 ```
@@ -952,7 +952,8 @@ Note that [`pyjwt`](https://pypi.org/project/PyJWT/) is a required dependency in
 
 ```python
 import pytest
-from httpx_auth.testing import token_cache_mock, create_token
+
+from httpx_auth.testing import create_token
 
 
 @pytest.fixture
@@ -961,7 +962,8 @@ def token_mock() -> str:
     return create_token(expiry)
 
 
-def test_something(token_cache_mock):
+@pytest.mark.usefixtures("token_cache_mock")
+def test_something():
     # perform code using authentication
     pass
 ```
@@ -973,9 +975,10 @@ def test_something(token_cache_mock):
 This [`pytest`][6] fixture will return the token cache and ensure it is reset at the end of the test case.
 
 ```python
-from httpx_auth.testing import token_cache
+import pytest
 
-def test_something(token_cache):
+@pytest.mark.usefixture("token_cache")
+def test_something():
     # perform code using authentication
     pass
 ```
@@ -991,7 +994,7 @@ With this [`pytest`][6] fixture you will be allowed to fine tune your authentica
 ```python
 import datetime
 
-from httpx_auth.testing import browser_mock, BrowserMock, create_token
+from httpx_auth.testing import BrowserMock, create_token
 
 def test_something(browser_mock: BrowserMock):
     token_expiry = datetime.datetime.now(datetime.timezone.utc) + datetime.timedelta(hours=1)