Expose missing classes

Author: Colin-b

CHANGELOG.md

@@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 ### Added
 - Adding explicit support for Python `3.12`.
+- Publicly expose `requests_auth.SupportMultiAuth`, allowing multiple authentication support for every `requests` authentication class that exists.
+- Publicly expose `requests_auth.TokenMemoryCache`, allowing to create custom Oauth2 token cache based on this default implementation.
 
 ### Changed
 - Except for `requests_auth.testing`, only direct access via `requests_auth.` was considered publicly exposed. This is now explicit, as inner packages are now using private prefix (`_`).

README.md

@@ -698,6 +698,17 @@ oauth2 = OAuth2Implicit('https://www.example.com')
 requests.get('https://www.example.com', auth=api_key + oauth2)
 ```
 
+This is supported on every authentication class exposed by `requests_auth`, but you can also enable it on your own authentication classes by using `requests_auth.SupportMultiAuth` as in the following sample:
+
+```python
+from requests_auth import SupportMultiAuth
+# TODO Import your own auth here
+from my_package import MyAuth
+
+class MyMultiAuth(MyAuth, SupportMultiAuth):
+    pass
+```
+
 ## Available pytest fixtures
 
 Testing the code using `requests_auth` authentication classes can be achieved using provided [`pytest`][6] fixtures.

requests_auth/__init__.py

@@ -3,6 +3,7 @@
     HeaderApiKey,
     QueryApiKey,
     NTLM,
+    SupportMultiAuth,
 )
 from requests_auth._oauth2.common import OAuth2
 from requests_auth._oauth2.authorization_code import (
@@ -28,7 +29,7 @@
     OAuth2ResourceOwnerPasswordCredentials,
     OktaResourceOwnerPasswordCredentials,
 )
-from requests_auth._oauth2.tokens import JsonTokenFileCache
+from requests_auth._oauth2.tokens import JsonTokenFileCache, TokenMemoryCache
 from requests_auth._errors import (
     GrantNotProvided,
     TimeoutOccurred,
@@ -59,7 +60,9 @@
     "OAuth2ResourceOwnerPasswordCredentials",
     "OktaResourceOwnerPasswordCredentials",
     "NTLM",
+    "SupportMultiAuth",
     "JsonTokenFileCache",
+    "TokenMemoryCache",
     "GrantNotProvided",
     "TimeoutOccurred",
     "AuthenticationFailed",

requests_auth/testing.py

@@ -20,7 +20,7 @@ def create_token(expiry: Optional[datetime.datetime]) -> str:
 
 
 @pytest.fixture
-def token_cache():
+def token_cache() -> requests_auth.TokenMemoryCache:
     yield requests_auth.OAuth2.token_cache
     requests_auth.OAuth2.token_cache.clear()
 

tests/test_json_token_file_cache.py

@@ -8,7 +8,7 @@
 
 
 @pytest.fixture
-def token_cache(request):
+def token_cache(request) -> requests_auth.JsonTokenFileCache:
     _token_cache = requests_auth.JsonTokenFileCache(request.node.name + ".cache")
     yield _token_cache
     _token_cache.clear()