fix(oauth): rename user_info to userinfo and fix example attribute access

- Rename user_info method to userinfo in OAuthClient and AsyncOAuthClient
- Replace dict-style .get() calls with dataclass attribute access in examples
- Update test method names and calls to match the renamed method

Author: appleboy

examples/01_user_login.py

@@ -29,8 +29,8 @@ def main() -> None:
 
     # Use the client to call an OAuth endpoint (e.g., UserInfo).
     userinfo = client.userinfo(token.access_token)
-    print(f"Subject : {userinfo.get('sub')}")
-    print(f"Email   : {userinfo.get('email')}")
+    print(f"Subject : {userinfo.sub}")
+    print(f"Email   : {userinfo.email}")
 
 
 if __name__ == "__main__":

examples/04_async_login.py

@@ -28,7 +28,7 @@ async def main() -> None:
     print(f"Logged in!  access_token={token.access_token[:20]}...")
 
     userinfo = await client.userinfo(token.access_token)
-    print(f"Subject: {userinfo.get('sub')}")
+    print(f"Subject: {userinfo.sub}")
 
 
 if __name__ == "__main__":

src/authgate/oauth/async_client.py

@@ -156,7 +156,7 @@ async def introspect(self, token: str) -> IntrospectionResult:
             jti=body.get("jti", ""),
         )
 
-    async def user_info(self, access_token: str) -> UserInfo:
+    async def userinfo(self, access_token: str) -> UserInfo:
         """Fetch user information from the UserInfo endpoint (OIDC Core 1.0 SS5.3)."""
         if not self._endpoints.userinfo_url:
             raise OAuthError("invalid_request", "userinfo endpoint not configured")

src/authgate/oauth/client.py

@@ -156,7 +156,7 @@ def introspect(self, token: str) -> IntrospectionResult:
             jti=body.get("jti", ""),
         )
 
-    def user_info(self, access_token: str) -> UserInfo:
+    def userinfo(self, access_token: str) -> UserInfo:
         """Fetch user information from the UserInfo endpoint (OIDC Core 1.0 SS5.3)."""
         if not self._endpoints.userinfo_url:
             raise OAuthError("invalid_request", "userinfo endpoint not configured")

tests/test_oauth.py

@@ -159,7 +159,7 @@ def handler(request: httpx.Request) -> httpx.Response:
         assert result.active
         assert result.scope == "openid profile"
 
-    def test_user_info(self, endpoints: Endpoints) -> None:
+    def test_userinfo(self, endpoints: Endpoints) -> None:
         def handler(request: httpx.Request) -> httpx.Response:
             assert "Bearer" in request.headers["Authorization"]
             return httpx.Response(
@@ -177,7 +177,7 @@ def handler(request: httpx.Request) -> httpx.Response:
             endpoints,
             http_client=httpx.Client(transport=transport),
         )
-        info = client.user_info("access-token")
+        info = client.userinfo("access-token")
         assert info.sub == "user123"
         assert info.name == "Test User"
 
@@ -232,7 +232,7 @@ def test_missing_endpoint_raises(self) -> None:
         with pytest.raises(OAuthError, match="introspection endpoint"):
             client.introspect("tok")
         with pytest.raises(OAuthError, match="userinfo endpoint"):
-            client.user_info("tok")
+            client.userinfo("tok")
         with pytest.raises(OAuthError, match="tokeninfo endpoint"):
             client.token_info_request("tok")