docs: add OpenAPI-first wiki (overview, components, use cases for templates/client/codegen, design, security, error handling, testing) and refresh lib docs index
This commit is contained in:
@@ -40,6 +40,14 @@ class MissingOperationHandler(OpenAPIFirstError):
|
||||
"""
|
||||
Raised when an OpenAPI operation cannot be resolved to a handler.
|
||||
|
||||
Args:
|
||||
path (str):
|
||||
The HTTP path declared in the OpenAPI specification.
|
||||
method (str):
|
||||
The HTTP method (as declared in the OpenAPI spec).
|
||||
operation_id (str | None):
|
||||
The operationId declared in the OpenAPI spec, if present.
|
||||
|
||||
Notes:
|
||||
**Scenarios:**
|
||||
|
||||
@@ -55,17 +63,6 @@ class MissingOperationHandler(OpenAPIFirstError):
|
||||
"""
|
||||
|
||||
def __init__(self, *, path: str, method: str, operation_id: str | None = None):
|
||||
"""
|
||||
Initialize the error.
|
||||
|
||||
Args:
|
||||
path (str):
|
||||
The HTTP path declared in the OpenAPI specification.
|
||||
method (str):
|
||||
The HTTP method (as declared in the OpenAPI spec).
|
||||
operation_id (str | None):
|
||||
The operationId declared in the OpenAPI spec, if present.
|
||||
"""
|
||||
if operation_id:
|
||||
message = (
|
||||
f"Missing handler for operationId '{operation_id}' "
|
||||
|
||||
Reference in New Issue
Block a user