diff --git a/README.md b/README.md index 30700a2..2576513 100644 --- a/README.md +++ b/README.md @@ -24,54 +24,7 @@ Note that the license also inherits to the output. - `src` *.yaml files should be written according to the [v3.0/schema.json](https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/schemas/v3.0/schema.json) - `dist` Do not rewrite this file as it is an automatically generated OpenAPI file. -### About build - -- `src/openapi/**/*.yaml#/paths/*/*/parameters` will be overwritten by `src/config/parameters.yaml#/paths/~1parameters/*/parameters` - - This overwritten done before parsing yaml -- `src/openapi/**/*.yaml#/paths/*/*/requestBody` will be overwritten by `src/config/parameters.yaml#/paths/~1parameters/*/requestBody` - - This overwritten done before parsing yaml -- `src/openapi/**/*.yaml#/paths/*/get/responses/200/headers` will be overwritten by `src/config/headers.yaml#/components/headers` - - This overwritten done before parsing yaml -- Items enclosed in double brackets are placeholders - - `src/config/placeholder.json` replaces it - - If a placeholder is used in `src/config/**/*.yaml`, the pathname is added as a prefix - - This substitution is done before parsing the yaml - -#### variable.json - -It can be written as `{% if variable == value %}` `{ endif }` - -| lang | description| -|---|---| -| docs | Outputs the most correct swagger syntax | -| typescript | Since it is difficult to handle default values with the typescript generator, we refer to `src/config/placeholder.json` and handle default values | -| dart | Basically the same as typescript, but headers are processed as parameters | - -##### *_parameters = string - -- This is defined in `src/config/parameters.yaml` -- Replace `src/config/placeholder.json` as an string - -##### *_parameters = object - -- This is defined in `src/config/parameters.yaml` -- Replace `src/config/placeholder.json` as an object - -##### *_parameters = schema_content - -- The schema automatically generated from the `src/config/placeholder.json` is replaced with `src/openapi/**/*.yaml#/paths/*/*/parameters` -- Some generators cannot handle it correctly because it generates the syntax introduced in swagger 3.0 -- This is defined in `tools/build.py` - -##### *_parameters = schema_parameters - -- The schema automatically generated from the `src/config/placeholder.json` is replaced with `src/openapi/**/*.yaml#/paths/*/*/parameters` - -##### *_parameters = schema_request_body - -- The schema automatically generated from the `src/config/placeholder.json` is replaced with `src/openapi/**/*.yaml#/paths/*/*/requestBody` - -#### command +### build ```shell python -V # Python 3.10.8