feat: Update schema caching mechanism and add example for fetching enums

- Changed default schema cache TTL from 24 hours to 15 days in VNDB client.
- Refactored get_schema method to utilize the new caching system.
- Added get_enums method to retrieve enum definitions from the cached schema.
- Created a new example script (schema_enums_example.py) demonstrating how to fetch and display schema enums with caching.
- Added initial schema cache file (.veedb_cache/schema.json) containing the VNDB API schema.

Author: Sub0X

.veedb_cache/vndb_schema.json .veedb_cache/schema.json.veedb_cache/vndb_schema.json renamed to .veedb_cache/schema.json

@@ -0,0 +1,40 @@
+#!/usr/bin/env python3
+"""
+Example demonstrating how to get schema enums with caching.
+The schema is cached for 15 days to avoid unnecessary API calls.
+"""
+
+import asyncio
+from veedb import VNDB
+
+async def main():
+    async with VNDB() as client:
+        print("Fetching VNDB schema enums (cached for 15 days)...")
+        
+        # Get all enums from the schema
+        enums = await client.get_enums()
+        
+        print(f"\nFound {len(enums)} enum types:")
+        for enum_name in enums.keys():
+            print(f"  - {enum_name}")
+        
+        # Example: Show language enum values
+        if 'language' in enums:
+            languages = enums['language']
+            print(f"\nLanguage enum has {len(languages)} values:")
+            for lang in languages[:5]:  # Show first 5
+                print(f"  {lang['id']}: {lang['label']}")
+            if len(languages) > 5:
+                print(f"  ... and {len(languages) - 5} more")
+        
+        # Example: Show platform enum values
+        if 'platform' in enums:
+            platforms = enums['platform']
+            print(f"\nPlatform enum has {len(platforms)} values:")
+            for platform in platforms[:5]:  # Show first 5
+                print(f"  {platform['id']}: {platform['label']}")
+            if len(platforms) > 5:
+                print(f"  ... and {len(platforms) - 5} more")
+
+if __name__ == "__main__":
+    asyncio.run(main())

examples/schema_enums_example.py

@@ -263,7 +263,7 @@ def __init__(
         session: Optional[aiohttp.ClientSession] = None,
         local_schema_path: Optional[str] = None, 
         schema_cache_dir: str = ".veedb_cache", 
-        schema_cache_ttl_hours: float = 24.0,
+        schema_cache_ttl_hours: float = 15 * 24,  # Default to 15 days
     ):
         self.api_token = api_token
         self.base_url = SANDBOX_URL if use_sandbox else BASE_URL
@@ -322,9 +322,17 @@ async def __aexit__(self, exc_type, exc_val, exc_tb):
         await self.close()
 
     async def get_schema(self) -> dict:
-        url = f"{self.base_url}/schema"
-        session = self._get_session()
-        return await _fetch_api(session=session, method="GET", url=url, token=self.api_token)
+        """
+        Get the VNDB API schema, using cache if available and not older than configured TTL.
+        Downloads and caches the schema if cache doesn't exist or is expired.
+        Uses the same schema cache as the filter validation system.
+        """
+        return await self._schema_cache_instance.get_schema(self)
+
+    async def get_enums(self) -> Dict[str, Any]:
+        """Get enum definitions from the VNDB API schema (uses shared schema cache)."""
+        schema = await self.get_schema()
+        return schema.get("enums", {})
 
     async def get_stats(self) -> UserStats:
         url = f"{self.base_url}/stats"