refactor: rename cache size variable and reorganize test comments

Author: kishore7snehil

examples/MCD.md examples/MultipleCustomDomains.mdexamples/MCD.md renamed to examples/MultipleCustomDomains.md

@@ -145,7 +145,7 @@ def __init__(
         self._metadata_cache = {}  # {domain: {"data": {...}, "expires_at": timestamp}}
         self._jwks_cache = {}      # {domain: {"data": {...}, "expires_at": timestamp}}
         self._cache_ttl = 3600     # 1 hour TTL
-        self._cache_max_size = 100 # Max 100 domains to prevent memory bloat
+        self._cache_max_entries = 100 # Max 100 domains to prevent memory bloat
 
     # ==========================================
     # Interactive Login Flow
@@ -1090,7 +1090,7 @@ async def _get_oidc_metadata_cached(self, domain: str) -> dict:
         metadata = await self._fetch_oidc_metadata(domain)
 
         # Enforce cache size limit (FIFO eviction)
-        if len(self._metadata_cache) >= self._cache_max_size:
+        if len(self._metadata_cache) >= self._cache_max_entries:
             oldest_key = next(iter(self._metadata_cache))
             del self._metadata_cache[oldest_key]
 
@@ -1160,7 +1160,7 @@ async def _get_jwks_cached(self, domain: str, metadata: dict = None) -> dict:
         jwks = await self._fetch_jwks(jwks_uri)
 
         # Enforce cache size limit (FIFO eviction)
-        if len(self._jwks_cache) >= self._cache_max_size:
+        if len(self._jwks_cache) >= self._cache_max_entries:
             oldest_key = next(iter(self._jwks_cache))
             del self._jwks_cache[oldest_key]
 

src/auth0_server_python/auth_server/server_client.py

@@ -1978,7 +1978,7 @@ async def test_complete_connect_account_no_transactions(mocker):
 
 
 # =============================================================================
-# Requirement 1: Multiple Issuer Configuration Methods Tests
+# MCD Tests : Multiple Issuer Configuration Methods Tests
 # =============================================================================
 
 @pytest.mark.asyncio
@@ -2049,7 +2049,7 @@ async def test_empty_domain_string():
 
 
 # =============================================================================
-# Requirement 2: Domain Resolver Context Tests
+# MCD Tests : Domain Resolver Context Tests
 # =============================================================================
 
 @pytest.mark.asyncio
@@ -2179,8 +2179,7 @@ async def domain_resolver(context):
     try:
         await client.start_interactive_login(store_options=None)
     except Exception:  # noqa: S110
-        pass  # Intentionally ignore - testing context only
-
+        pass  # We only care about context being passed
     assert received_context is not None
     assert received_context.request_url is None
     assert received_context.request_headers is None
@@ -2206,7 +2205,7 @@ async def bad_resolver(context):
 
 
 # =============================================================================
-# Requirement 3: OIDC Metadata and JWKS Fetching Tests
+# OIDC Metadata and JWKS Fetching Tests
 # =============================================================================
 
 
@@ -2416,7 +2415,7 @@ async def test_jwks_cache_size_limit():
     )
 
     # Set small cache size for testing
-    client._cache_max_size = 3
+    client._cache_max_entries = 3
 
     mock_jwks = {"keys": [{"kty": "RSA"}]}
 
@@ -2487,7 +2486,7 @@ async def test_metadata_cache_size_limit():
         state_store=AsyncMock()
     )
 
-    client._cache_max_size = 2
+    client._cache_max_entries = 2
 
     async def mock_fetch(domain):
         return {"issuer": f"https://{domain}/"}
@@ -2509,7 +2508,7 @@ async def mock_fetch(domain):
 
 
 # =============================================================================
-# Requirement 4: Issuer Validation Tests
+# Issuer Validation Tests
 # =============================================================================
 
 
@@ -2668,7 +2667,7 @@ async def test_normalize_domain_handles_different_schemes():
 
 
 # =============================================================================
-# Requirements 5-8: Domain-specific Session Management Tests
+# MCD Tests : Domain-specific Session Management Tests
 # =============================================================================