mirror of
https://github.com/meta-llama/llama-stack.git
synced 2025-12-03 18:00:36 +00:00
7d3db6b22c
Generate the Stainless client config directly from code so we can validate the config before we ever write the YAML. This change enforces allowed HTTP verbs/paths, detects duplicate routes across resources, and ensures README example endpoints exist and match the OpenAPI spec. The generator now fails fast when config entries drift, keeping the published config (hopefully) more current with the spec. I think more validation can be done but this is a good start.
11 lines
743 B
Markdown
11 lines
743 B
Markdown
These are the source-of-truth configuration files used to generate the Stainless client SDKs via Stainless.
|
|
|
|
- `openapi.yml`: this is the OpenAPI specification for the Llama Stack API.
|
|
- `config.yml`: this is the Stainless _configuration_ which instructs Stainless how to generate the client SDKs.
|
|
|
|
A small side note: notice the `.yml` suffixes since Stainless uses that suffix typically for its configuration files.
|
|
|
|
These files go hand-in-hand. Both `openapi.yml` and `config.yml` are generated by `scripts/run_openapi_generator.sh`:
|
|
|
|
- `openapi.yml` comes from the FastAPI-based generator.
|
|
- `config.yml` is rendered from `scripts/openapi_generator/stainless_config/config_data.py` so the Stainless config stays in lock-step with the spec.
|