Kotlin / Kotlin/dataframe

OpenAPI: Circular references break generation

Open
#288 0 comments 0 reactions 1 assignee View on GitHub

@Jolanrensen is already working on this.

Since Apr 25, 2023.

bug enhancement OpenAPI
Dominant language
Kotlin
Stars
1.1k
Forks
83
Avg merge
4d 12h
Merged PRs (30d)
30

Description

For example: https://youtrack.jetbrains.com/api/openapi.json
According to https://apitools.dev/swagger-parser/online/, there exists a circular reference and that would explain the cannot find ref IllegalStateException that is thrown when trying to generate @DataSchemas from this OpenAPI spec.

While circular references don't work in JSON, it is possible with optional properties to support it in an OpenAPI spec.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.