Added benchmark for Tornado. Removed add_docs_route and add_openapi_route.

Author: mr-fatalyst

CHANGELOG.md

@@ -4,12 +4,21 @@ All notable changes to FastOpenAPI are documented in this file.
 
 FastOpenAPI follows the [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) format.
 
-## [0.4.0] - Unreleased
+## [0.4.0] - 2025-03-20
 
 ### Added
 - `ReDoc UI` and default URL (`host:port/redoc`)
 - `TornadoRouter` for integration with the `Tornado` framework
 
+### Changed
+- Revised and updated all tests.
+
+### Fixed
+- Status code for error response fixed: 422 -> 500
+
+### Removed
+- Removed the `add_docs_route` and `add_openapi_route` from `BaseRouter`.
+
 ## [0.3.1] - 2025-03-15
 
 ### Fixed

README.md

@@ -69,7 +69,7 @@ pip install fastopenapi[tornado]
     from fastopenapi.routers import FalconRouter
 
     app = falcon.asgi.App()
-    router = FalconRouter(app=app, docs_url="/docs/", openapi_version="3.0.0")
+    router = FalconRouter(app=app)
 
 
     class HelloResponse(BaseModel):
@@ -98,7 +98,7 @@ pip install fastopenapi[tornado]
     from fastopenapi.routers import FlaskRouter
 
     app = Flask(__name__)
-    router = FlaskRouter(app=app, docs_url="/docs/", openapi_version="3.0.0")
+    router = FlaskRouter(app=app)
 
 
     class HelloResponse(BaseModel):
@@ -127,7 +127,7 @@ pip install fastopenapi[tornado]
     from fastopenapi.routers import QuartRouter
 
     app = Quart(__name__)
-    router = QuartRouter(app=app, docs_url="/docs/", openapi_version="3.0.0")
+    router = QuartRouter(app=app)
 
 
     class HelloResponse(BaseModel):
@@ -156,7 +156,7 @@ pip install fastopenapi[tornado]
     from fastopenapi.routers import SanicRouter
 
     app = Sanic("MySanicApp")
-    router = SanicRouter(app=app, docs_url="/docs/", openapi_version="3.0.0")
+    router = SanicRouter(app=app)
 
 
     class HelloResponse(BaseModel):
@@ -186,7 +186,7 @@ pip install fastopenapi[tornado]
     from fastopenapi.routers import StarletteRouter
 
     app = Starlette()
-    router = StarletteRouter(app=app, docs_url="/docs/", openapi_version="3.0.0")
+    router = StarletteRouter(app=app)
 
 
     class HelloResponse(BaseModel):
@@ -217,9 +217,7 @@ pip install fastopenapi[tornado]
 
     app = Application()
 
-    router = TornadoRouter(
-        app=app, docs_url="/docs", openapi_url="/openapi.json", openapi_version="3.0.0"
-    )
+    router = TornadoRouter(app=app)
 
 
     class HelloResponse(BaseModel):

benchmarks/README.md

@@ -8,11 +8,12 @@ Each implementation runs in a separate instance, and the benchmark measures resp
 
 ### 📈 Rough results
 - You can check rough results here:
-  - [Falcon](FALCON.md)
-  - [Flask](FLASK.md)
-  - [Quart](QUART.md)
-  - [Sanic](SANIC.md)
-  - [Starlette](STARLETTE.md)
+  - [Falcon](falcon/FALCON.md)
+  - [Flask](flask/FLASK.md)
+  - [Quart](quart/QUART.md)
+  - [Sanic](sanic/SANIC.md)
+  - [Starlette](starlette/STARLETTE.md)
+  - [Tornado](tornado/TORNADO.md)
 
 ### 📖 How It Works
 - The script runs **10,000 requests per endpoint**. You can set your own value.

benchmarks/FALCON.md renamed to benchmarks/falcon/FALCON.md

@@ -0,0 +1,48 @@
+# Tornado Benchmark
+
+---
+
+## Testing Original Implementation
+```
+Original - Running 10000 iterations per endpoint
+--------------------------------------------------
+GET all records: 9.3412 sec total, 0.93 ms per request
+GET one record: 9.5527 sec total, 0.96 ms per request
+POST new record: 9.9068 sec total, 0.99 ms per request
+PUT record: 9.8596 sec total, 0.99 ms per request
+PATCH record: 9.8612 sec total, 0.99 ms per request
+DELETE record: 19.0970 sec total, 1.91 ms per request
+```
+---
+
+## Testing FastOpenAPI Implementation
+
+```
+FastOpenAPI - Running 10000 iterations per endpoint
+--------------------------------------------------
+GET all records: 9.5980 sec total, 0.96 ms per request
+GET one record: 9.9557 sec total, 1.00 ms per request
+POST new record: 10.2566 sec total, 1.03 ms per request
+PUT record: 10.4081 sec total, 1.04 ms per request
+PATCH record: 10.2608 sec total, 1.03 ms per request
+DELETE record: 19.9923 sec total, 2.00 ms per request
+```
+
+---
+
+## Performance Comparison (10000 iterations)
+
+| Endpoint                 | Original | FastOpenAPI | Difference |
+|--------------------------|----------|-------------|------------|
+| GET all records          | 0.93 ms  | 0.96 ms     | 0.03 ms (+2.7%)  |
+| GET one record           | 0.96 ms  | 1.00 ms     | 0.04 ms (+4.2%)  |
+| POST new record          | 0.99 ms  | 1.03 ms     | 0.03 ms (+3.5%)  |
+| PUT record               | 0.99 ms  | 1.04 ms     | 0.05 ms (+5.6%)  |
+| PATCH record             | 0.99 ms  | 1.03 ms     | 0.04 ms (+4.1%)  |
+| DELETE record            | 1.91 ms  | 2.00 ms     | 0.09 ms (+4.7%)  |
+
+---
+
+[<< Back](README.md)
+
+---

benchmarks/FLASK.md renamed to benchmarks/flask/FLASK.md

@@ -0,0 +1,102 @@
+import asyncio
+
+from tornado.web import Application, HTTPError
+
+from benchmarks.tornado.with_fastopenapi.schemas import (
+    RecordCreate,
+    RecordResponse,
+    RecordUpdate,
+)
+from benchmarks.tornado.with_fastopenapi.storage import RecordStore
+from fastopenapi.routers import TornadoRouter
+
+# Initialize Sanic app and router
+app = Application()
+router = TornadoRouter(
+    app=app,
+    title="Record API",
+    description="A simple Record API built with FastOpenAPI and Tornado",
+    version="1.0.0",
+    docs_url="/docs",
+    redoc_url="/redoc",
+    openapi_url="/openapi.json",
+)
+
+# Initialize the storage
+store = RecordStore()
+
+
+# Define routes using the TornadoRouter decorators
+@router.get("/records", tags=["records"], response_model=list[RecordResponse])
+async def get_records():
+    """
+    Get all records
+    """
+    return store.get_all()
+
+
+@router.get("/records/{record_id}", tags=["records"], response_model=RecordResponse)
+async def get_record(record_id: str):
+    """
+    Get a specific record by ID
+    """
+    record = store.get_by_id(record_id)
+    if not record:
+        raise HTTPError(status_code=404, log_message="Not Found")
+    return record
+
+
+@router.post(
+    "/records", tags=["records"], status_code=201, response_model=RecordResponse
+)
+async def create_record(record: RecordCreate):
+    """
+    Create a new record
+    """
+    return store.create(record)
+
+
+@router.put("/records/{record_id}", tags=["records"], response_model=RecordResponse)
+async def update_record_full(record_id: str, record: RecordCreate):
+    """
+    Update a record completely (all fields required)
+    """
+    existing_record = store.get_by_id(record_id)
+    if not existing_record:
+        raise HTTPError(status_code=404, log_message="Not Found")
+
+    # Delete and recreate with the same ID
+    store.delete(record_id)
+    new_record = {"id": record_id, **record.model_dump()}
+    store.records[record_id] = new_record
+    return RecordResponse(**new_record)
+
+
+@router.patch("/records/{record_id}", tags=["records"], response_model=RecordResponse)
+async def update_record_partial(record_id: str, record: RecordUpdate):
+    """
+    Update a record partially (only specified fields)
+    """
+    updated_record = store.update(record_id, record)
+    if not updated_record:
+        raise HTTPError(status_code=404, log_message="Not Found")
+    return updated_record
+
+
+@router.delete("/records/{record_id}", tags=["records"], status_code=204)
+async def delete_record(record_id: str):
+    """
+    Delete a record
+    """
+    if not store.delete(record_id):
+        raise HTTPError(status_code=404, log_message="Not Found")
+    return None
+
+
+async def main():
+    app.listen(8001)
+    await asyncio.Event().wait()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())