fix CI: run ruff format and generate sphinx docs

zzstoatzz · claude · zzstoatzz · commit c7ab5632e4a0 · 2025-11-14T12:52:50.000-06:00
- run ruff format on Flask demo app - generate sphinx documentation for atproto_oauth package - add atproto_oauth to docs module index resolves codegen_check and ruff CI failures. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
diff --git a/docs/source/atproto/atproto_oauth.rst b/docs/source/atproto/atproto_oauth.rst
@@ -0,0 +1,77 @@
+atproto\_oauth package
+======================
+
+Subpackages
+-----------
+
+.. toctree::
+   :maxdepth: 4
+
+   atproto_oauth.stores
+
+Submodules
+----------
+
+atproto\_oauth.client module
+----------------------------
+
+.. automodule:: atproto_oauth.client
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+atproto\_oauth.dpop module
+--------------------------
+
+.. automodule:: atproto_oauth.dpop
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+atproto\_oauth.exceptions module
+--------------------------------
+
+.. automodule:: atproto_oauth.exceptions
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+atproto\_oauth.metadata module
+------------------------------
+
+.. automodule:: atproto_oauth.metadata
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+atproto\_oauth.models module
+----------------------------
+
+.. automodule:: atproto_oauth.models
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+atproto\_oauth.pkce module
+--------------------------
+
+.. automodule:: atproto_oauth.pkce
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+atproto\_oauth.security module
+------------------------------
+
+.. automodule:: atproto_oauth.security
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Module contents
+---------------
+
+.. automodule:: atproto_oauth
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/source/atproto/atproto_oauth.stores.rst b/docs/source/atproto/atproto_oauth.stores.rst
@@ -0,0 +1,29 @@
+atproto\_oauth.stores package
+=============================
+
+Submodules
+----------
+
+atproto\_oauth.stores.base module
+---------------------------------
+
+.. automodule:: atproto_oauth.stores.base
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+atproto\_oauth.stores.memory module
+-----------------------------------
+
+.. automodule:: atproto_oauth.stores.memory
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Module contents
+---------------
+
+.. automodule:: atproto_oauth.stores
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/source/atproto/modules.rst b/docs/source/atproto/modules.rst
@@ -13,4 +13,5 @@ packages
    atproto_firehose
    atproto_identity
    atproto_lexicon
+   atproto_oauth
    atproto_server
diff --git a/examples/oauth_flask_demo/app.py b/examples/oauth_flask_demo/app.py
@@ -23,10 +23,12 @@
 SCOPE = 'atproto'
 
 # Create client_id for localhost testing
-CLIENT_ID = 'http://localhost?' + urlencode({
-    'redirect_uri': REDIRECT_URI,
-    'scope': SCOPE,
-})
+CLIENT_ID = 'http://localhost?' + urlencode(
+    {
+        'redirect_uri': REDIRECT_URI,
+        'scope': SCOPE,
+    }
+)
 
 # Initialize OAuth client with memory stores (for demo only!)
 oauth_client = OAuthClient(
@@ -77,6 +79,7 @@ def login() -> str:
     try:
         # Start OAuth authorization
         import asyncio
+
         auth_url, state = asyncio.run(oauth_client.start_authorization(handle))
 
         # Store state in session for verification
@@ -87,11 +90,9 @@ def login() -> str:
 
     except Exception:  # noqa: BLE001
         import traceback
+
         error_msg = traceback.format_exc()
-        return (
-            f'<html><body><h1>Login Error</h1><pre>{error_msg}</pre>'
-            f'<p><a href="/">Back</a></p></body></html>'
-        ), 500
+        return (f'<html><body><h1>Login Error</h1><pre>{error_msg}</pre><p><a href="/">Back</a></p></body></html>'), 500
 
 
 @app.route('/callback')
@@ -121,6 +122,7 @@ def callback() -> str:
     try:
         # Complete OAuth flow
         import asyncio
+
         oauth_session = asyncio.run(oauth_client.handle_callback(code, state, iss))
 
         # Store user info in session
@@ -143,6 +145,7 @@ def logout() -> str:
         try:
             # Revoke OAuth session
             import asyncio
+
             oauth_session = asyncio.run(oauth_client.session_store.get_session(user_did))
             if oauth_session:
                 asyncio.run(oauth_client.revoke_session(oauth_session))
@@ -170,11 +173,13 @@ def api_profile() -> tuple:
             return jsonify({'error': 'Session not found'}), 401
 
         # Make authenticated request to PDS
-        response = asyncio.run(oauth_client.make_authenticated_request(
-            session=oauth_session,
-            method='GET',
-            url=f'{oauth_session.pds_url}/xrpc/com.atproto.repo.describeRepo?repo={user_did}',
-        ))
+        response = asyncio.run(
+            oauth_client.make_authenticated_request(
+                session=oauth_session,
+                method='GET',
+                url=f'{oauth_session.pds_url}/xrpc/com.atproto.repo.describeRepo?repo={user_did}',
+            )
+        )
 
         if response.status_code != 200:
             return jsonify({'error': 'PDS request failed', 'status': response.status_code}), 500
