release: bump version to 0.3.0

- Refactor Redis backend connection handling and pool management
- Update algorithm implementations with improved type annotations
- Enhance config loader validation with stricter Pydantic schemas
- Improve decorator and middleware error handling
- Expand example scripts with better docstrings and usage patterns
- Add new 00_basic_usage.py example for quick start
- Reorganize examples directory structure
- Fix type annotation inconsistencies across core modules
- Update dependencies in pyproject.toml

examples/05_middleware.py

@@ -11,6 +11,10 @@ from fastapi_traffic.middleware import RateLimitMiddleware
 # from fastapi_traffic.middleware import SlidingWindowMiddleware
 # from fastapi_traffic.middleware import TokenBucketMiddleware
 
+
+DEFAULT_HOST = "127.0.0.1"
+DEFAULT_PORT = 8001
+
 app = FastAPI(title="Middleware Rate Limiting")
 
 
@@ -104,6 +108,22 @@ async def docs_info() -> dict[str, str]:
 
 
 if __name__ == "__main__":
+    import argparse
+
     import uvicorn
 
-    uvicorn.run(app, host="0.0.0.0", port=8000)
+    parser = argparse.ArgumentParser(description="Middleware rate limiting example")
+    parser.add_argument(
+        "--host",
+        default=DEFAULT_HOST,
+        help=f"Host to bind to (default: {DEFAULT_HOST})",
+    )
+    parser.add_argument(
+        "--port",
+        type=int,
+        default=DEFAULT_PORT,
+        help=f"Port to bind to (default: {DEFAULT_PORT})",
+    )
+    args = parser.parse_args()
+
+    uvicorn.run(app, host=args.host, port=args.port)