Vishesh 'ironeagle' Bangotra
a74e3d0d01
used for server-side route binding, and refactor documentation and templates to treat the client as a first-class contract consumer. Key changes: - Add OpenAPI-first client module based on httpx - Document client usage alongside server-side binder usage - Update mkdocs navigation to include client documentation - Refactor CRUD and model app templates to call APIs via operationId instead of hardcoded paths - Align package documentation and public API surface with client support - Clarify server/client dependency split (fastapi vs httpx) This establishes strict symmetry between OpenAPI-driven server binding and OpenAPI-driven client invocation, reinforcing OpenAPI as the single source of truth on both sides of the contract.
52 lines
1.2 KiB
YAML
52 lines
1.2 KiB
YAML
site_name: Aetoskia Mail Intake
|
|
site_description: Format-agnostic document reading, parsing, and scraping framework
|
|
|
|
theme:
|
|
name: material
|
|
palette:
|
|
- scheme: slate
|
|
primary: deep purple
|
|
accent: cyan
|
|
font:
|
|
text: Inter
|
|
code: JetBrains Mono
|
|
features:
|
|
- navigation.tabs
|
|
- navigation.expand
|
|
- navigation.top
|
|
- navigation.instant
|
|
- content.code.copy
|
|
- content.code.annotate
|
|
|
|
plugins:
|
|
- search
|
|
- mkdocstrings:
|
|
handlers:
|
|
python:
|
|
paths: ["."]
|
|
options:
|
|
docstring_style: google
|
|
show_source: false
|
|
show_signature_annotations: true
|
|
separate_signature: true
|
|
merge_init_into_class: true
|
|
inherited_members: true
|
|
annotations_path: brief
|
|
show_root_heading: true
|
|
group_by_category: true
|
|
|
|
nav:
|
|
- Home: openapi_first/index.md
|
|
|
|
- Core:
|
|
- OpenAPI-First App: openapi_first/app.md
|
|
- Route Binder: openapi_first/binder.md
|
|
- Spec Loaders: openapi_first/loader.md
|
|
- Client: openapi_first/client.md
|
|
|
|
- CLI:
|
|
- Home: openapi_first/cli.md
|
|
|
|
- Errors:
|
|
- Error Hierarchy: openapi_first/errors.md
|