Lint and fix issues in example projects

- Add test file pattern to ruff ignore rules for S101
- Fix logging issues in web scraper example (use module logger)
- Fix try/except pattern in web scraper cache_page method
- Auto-format code with ruff (import sorting, blank lines)
- Fix markdown formatting issues (code block languages, list spacing)

Co-authored-by: William Easton <strawgate@users.noreply.github.com>

Author: github-actions[bot]

examples/README.md

@@ -47,6 +47,7 @@ pytest test_chat_app.py -v
 **Use Case**: Simple chat message storage with automatic expiration
 
 **Demonstrates**:
+
 - Type-safe message storage with PydanticAdapter
 - Automatic message expiration using TTLClampWrapper
 - Operation statistics tracking with StatisticsWrapper
@@ -66,6 +67,7 @@ pytest test_chat_app.py -v
 caching
 
 **Demonstrates**:
+
 - Multi-tier caching (memory + disk) with PassthroughCacheWrapper
 - Data compression with CompressionWrapper
 - Automatic retry with RetryWrapper
@@ -85,6 +87,7 @@ optimization
 **Use Case**: Cache scraped web pages with encryption and size limits
 
 **Demonstrates**:
+
 - Encrypted storage with FernetEncryptionWrapper
 - Size limits with LimitSizeWrapper (reject pages >5MB)
 - TTL enforcement with TTLClampWrapper
@@ -185,6 +188,7 @@ async def cache(self, tmp_path) -> MyCache:
 - pydantic
 
 Additional dependencies per example:
+
 - **trading_data**: None (uses built-in stores)
 - **web_scraper_cache**: cryptography (for encryption)
 
@@ -194,7 +198,7 @@ Additional dependencies per example:
 
 Each example follows this structure:
 
-```
+```text
 example_name/
 ├── README.md           # Detailed documentation
 ├── pyproject.toml      # Project metadata and dependencies

examples/chat_app/chat_app.py

@@ -12,13 +12,12 @@
 import logging
 from datetime import datetime, timezone
 
-from pydantic import BaseModel
-
 from key_value.aio.adapters.pydantic import PydanticAdapter
 from key_value.aio.stores.memory.store import MemoryStore
 from key_value.aio.wrappers.logging.wrapper import LoggingWrapper
 from key_value.aio.wrappers.statistics.wrapper import StatisticsWrapper
 from key_value.aio.wrappers.ttl_clamp.wrapper import TTLClampWrapper
+from pydantic import BaseModel
 
 # Configure logging
 logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s")

examples/trading_data/README.md

@@ -31,6 +31,7 @@ The wrapper stack (applied inside-out):
    persistence
 
 Data flow:
+
 - **Write**: Data → Memory cache → Compressed → Disk storage
 - **Read**: Check memory cache → If miss, load from disk → Decompress → Cache in
   memory
@@ -114,6 +115,7 @@ cache_store = PassthroughCacheWrapper(
 ```
 
 Benefits:
+
 - **Fast reads**: Recent data served from memory
 - **Persistence**: All data backed by disk storage
 - **Automatic promotion**: Disk data cached in memory on read
@@ -127,6 +129,7 @@ compressed_store = CompressionWrapper(key_value=disk_cache)
 ```
 
 Especially effective for:
+
 - Historical price data with many data points
 - JSON-serialized objects with repeated keys
 - Text-heavy data structures
@@ -144,6 +147,7 @@ retry_store = RetryWrapper(
 ```
 
 Automatically retries on:
+
 - Network timeouts
 - Temporary unavailability
 - Rate limiting

examples/trading_data/__init__.py

@@ -2,4 +2,4 @@
 
 from trading_app import PriceData, TradingDataCache
 
-__all__ = ["TradingDataCache", "PriceData"]
+__all__ = ["PriceData", "TradingDataCache"]

examples/trading_data/test_trading_app.py

@@ -1,7 +1,6 @@
 """Tests for the trading data cache example."""
 
 import pytest
-
 from trading_app import PriceData, TradingDataCache
 
 

examples/trading_data/trading_app.py

@@ -14,15 +14,14 @@
 from datetime import datetime, timezone
 from pathlib import Path
 
-from pydantic import BaseModel
-
 from key_value.aio.adapters.pydantic import PydanticAdapter
 from key_value.aio.stores.disk.store import DiskStore
 from key_value.aio.stores.memory.store import MemoryStore
 from key_value.aio.wrappers.compression.wrapper import CompressionWrapper
 from key_value.aio.wrappers.passthrough_cache.wrapper import PassthroughCacheWrapper
 from key_value.aio.wrappers.retry.wrapper import RetryWrapper
 from key_value.aio.wrappers.statistics.wrapper import StatisticsWrapper
+from pydantic import BaseModel
 
 # Configure logging
 logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s")
@@ -167,7 +166,6 @@ def get_cache_statistics(self) -> dict[str, int]:
     async def cleanup(self):
         """Clean up resources (close stores, etc.)."""
         # In a real application, you'd close any open connections here
-        pass
 
 
 async def main():

examples/web_scraper_cache/README.md

@@ -30,6 +30,7 @@ The wrapper stack (applied inside-out):
 4. **FallbackWrapper** - Falls back to memory storage if disk operations fail
 
 Data flow:
+
 - **Write**: Data → Size check → Encrypt → Store (disk or memory fallback)
 - **Read**: Retrieve → Decrypt → Return data
 
@@ -149,6 +150,7 @@ fallback_store = FallbackWrapper(
 ```
 
 Use cases:
+
 - Disk failures → Memory fallback
 - Remote failures → Local fallback
 - Complex store → Simple store fallback
@@ -166,6 +168,7 @@ clamped_store = TTLClampWrapper(
 ```
 
 Benefits:
+
 - Prevents too-short TTL (cache thrashing)
 - Prevents too-long TTL (stale data)
 - Enforces consistent caching policy
@@ -182,6 +185,7 @@ def url_to_key(url: str) -> str:
 ```
 
 Advantages:
+
 - Filesystem-safe keys
 - Consistent key generation
 - Privacy (URLs not stored in plaintext as keys)

examples/web_scraper_cache/__init__.py

@@ -2,4 +2,4 @@
 
 from scraper import ScrapedPage, WebScraperCache
 
-__all__ = ["WebScraperCache", "ScrapedPage"]
+__all__ = ["ScrapedPage", "WebScraperCache"]

examples/web_scraper_cache/scraper.py

@@ -16,18 +16,18 @@
 from pathlib import Path
 
 from cryptography.fernet import Fernet
-from pydantic import BaseModel
-
 from key_value.aio.adapters.pydantic import PydanticAdapter
 from key_value.aio.stores.disk.store import DiskStore
 from key_value.aio.stores.memory.store import MemoryStore
 from key_value.aio.wrappers.encryption.wrapper import FernetEncryptionWrapper
 from key_value.aio.wrappers.fallback.wrapper import FallbackWrapper
 from key_value.aio.wrappers.limit_size.wrapper import LimitSizeWrapper
 from key_value.aio.wrappers.ttl_clamp.wrapper import TTLClampWrapper
+from pydantic import BaseModel
 
 # Configure logging
 logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s")
+logger = logging.getLogger(__name__)
 
 
 class ScrapedPage(BaseModel):
@@ -54,8 +54,8 @@ def __init__(self, cache_dir: str = ".scraper_cache", encryption_key: bytes | No
         # Generate or use provided encryption key
         if encryption_key is None:
             encryption_key = Fernet.generate_key()
-            logging.warning(f"Generated new encryption key: {encryption_key.decode()}")
-            logging.warning("Store this key securely! Data encrypted with different keys cannot be decrypted.")
+            logger.warning(f"Generated new encryption key: {encryption_key.decode()}")
+            logger.warning("Store this key securely! Data encrypted with different keys cannot be decrypted.")
 
         self.encryption_key = encryption_key
 
@@ -123,10 +123,11 @@ async def cache_page(self, url: str, content: str, headers: dict[str, str] | Non
 
         try:
             await self.adapter.put(collection="pages", key=key, value=page, ttl=ttl)
-            return True
-        except Exception as e:
-            logging.error(f"Failed to cache page {url}: {e}")
+        except Exception:
+            logger.exception(f"Failed to cache page {url}")
             return False
+        else:
+            return True
 
     async def get_cached_page(self, url: str) -> ScrapedPage | None:
         """
@@ -170,7 +171,6 @@ async def is_cached(self, url: str) -> bool:
     async def cleanup(self):
         """Clean up resources."""
         # In a real application, you'd close any open connections here
-        pass
 
 
 async def simulate_scrape(url: str) -> tuple[str, dict[str, str]]:

examples/web_scraper_cache/test_scraper.py

@@ -2,7 +2,6 @@
 
 import pytest
 from cryptography.fernet import Fernet
-
 from scraper import ScrapedPage, WebScraperCache