How is `quay_api.json` being obtained?

[dronenb]

Hello,

I can see how code generation is being done using the OpenAPI specification found in quay_api.json. However, I noted that the schema is OpenAPI 3.0.1, and the one provided by Quay in any Quay instance is Swagger 2.0. Is this being up-converted to 3.0.1, and if so, how? I did not see it documented. Presumably it is done with something similar to the following:

podman run -d --rm -it -p 8080:8080 --name swagger-converter docker.io/swaggerapi/swagger-converter:v1.0.5
curl --silent --data "$(curl --silent --location https://quay.io/api/v1/discovery)" -H "Content-Type: application/json" http://localhost:8080/api/convert | jq > quay_api.json
podman stop swagger-converter

but it would be nice if it was documented to it can be updated with the new schema as API enhancements are added into Quay.

[dpinte]

@dronenb good question and I don't have the answer. I'll investigate.