RFC variant selector added

Author: loechel

docs/advanced/authentication.md

@@ -32,8 +32,8 @@ Bearer Token authentication ([RFC 6750](https://datatracker.ietf.org/doc/html/rf
 There are three variants to transmit the Token:
 
 * `Authorization` Request Header Field
-* Form-Encoded Body Parameter
-* URI Query Parameter
+* Form-Encoded Body Parameter (not implemented)
+* URI Query Parameter (not implemented)
 
 Since it is unencrypted it should typically only be used over `https`, although this is not strictly enforced.
 

httpx/_auth.py

@@ -148,7 +148,9 @@ class BearerTokenAuth(Auth):
     and uses HTTP Bearer authentication (RFC 6750).
     """
 
-    def __init__(self, bearer_token: str | bytes) -> None:
+    def __init__(self, bearer_token: str | bytes, variant: typing.Literal["HEADER", "FORM-ENCODED", "QUERY"] = "HEADER") -> None:
+        if variant != "HEADER":
+            raise NotImplementedError(f"BearerTokenAuth variant '{variant}' is not yet implemented")
         self._auth_header = self._build_auth_header(bearer_token)
 
     def auth_flow(self, request: Request) -> typing.Generator[Request, Response, None]: