fix: The Fern Definition respects endpoint level base-path overrides when validating examples.
0.44.5
feat: The Fern Definition now supports overriding `base-path` at the endpoint level.
This is useful if you have subset of endpoints that do not live at the
configured base-path.
```yml imdb.yml
service:
endpoints:
getMovie:
method: POST
base-path: "latest/" # overrides the base-path configured in api.yml
path: "movies/{movieId}"
```
0.44.4
fix: Fern's OpenAPI importer will now handle generating examples for declared
errors so that they show up in the generated documentation.
0.44.3
feat: Fern's OpenAPI importer can now handle `readOnly` properties in the top level
request schema. Note that Fern does not handle nested `readOnly` properties
just yet; please file a GitHub issue if this is important!
0.44.2
fix: Fern's OpenAPI importer can now handle multiple error schemas for the
same status code.
2 additional updates, see more 0.44.1
feat: The OpenAPI importer used to try and coerce all enums into a literals.
In some cases this is not desirable, so we now expose an option called
`coerce-enums-to-literals` in your generators.yml.
```yml generators.yml
api:
specs:
- openapi: ../openapi.json
overrides: ../openapi-overrides.yml
settings:
title-as-schema-name: false
coerce-enums-to-literals: false
```
0.44.0-rc0
feat: The Fern CLI now supports parsing [Conjure](https://github.com/palantir/conjure), Palantir's
home-grown API Definition format.
If you know a company that is using Conjure that wants API Docs + SDKs, send them our way!
Upgrading from
0.43.8to0.44.6- Changelog0.44.6fix:The Fern Definition respects endpoint level base-path overrides when validating examples.0.44.5feat:The Fern Definition now supports overriding `base-path` at the endpoint level. This is useful if you have subset of endpoints that do not live at the configured base-path. ```yml imdb.yml service: endpoints: getMovie: method: POST base-path: "latest/" # overrides the base-path configured in api.yml path: "movies/{movieId}" ```0.44.4fix:Fern's OpenAPI importer will now handle generating examples for declared errors so that they show up in the generated documentation.0.44.3feat:Fern's OpenAPI importer can now handle `readOnly` properties in the top level request schema. Note that Fern does not handle nested `readOnly` properties just yet; please file a GitHub issue if this is important!0.44.2fix:Fern's OpenAPI importer can now handle multiple error schemas for the same status code.2 additional updates, see more
0.44.1feat:The OpenAPI importer used to try and coerce all enums into a literals. In some cases this is not desirable, so we now expose an option called `coerce-enums-to-literals` in your generators.yml. ```yml generators.yml api: specs: - openapi: ../openapi.json overrides: ../openapi-overrides.yml settings: title-as-schema-name: false coerce-enums-to-literals: false ```0.44.0-rc0feat:The Fern CLI now supports parsing [Conjure](https://github.com/palantir/conjure), Palantir's home-grown API Definition format. If you know a company that is using Conjure that wants API Docs + SDKs, send them our way!