Tim Burks

Reverse rejoiner

1

I think it would be useful to be able to analyze a GraphQL schema and produce a set of .proto files describing services that, when implemented, could be stitched together...

Proposal: Expand OpenAPI to include RPC APIs

15

The OpenAPI 2.0 Specification states that its goal is [“to define a standard, language-agnostic interface to REST APIs”](https://github.com/OAI/OpenAPI-Specification). REST is an extremely popular style for implementing APIs that run over...

I noticed some specs have a top-level field called "source" ([example](https://github.com/APIs-guru/openapi-directory/blob/07915b26e5182e90297d0f31663ac931caf9401f/APIs/googleapis.com/translate/v3beta1/openapi.yaml#L1264)). That spec has an `openapi` value of `3.0.0` and I don't see a `source` property in the [3.0.0 spec](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.0.md)...

Split this repo?

6

Our recent efforts to configure a multi-module repository [did not go well](https://github.com/google/gnostic/issues/283), but the motivating issue remains -- the growing applications in the `cmd` directory add dependencies that aren't needed...

Project Background, Goals, and Non-Goals

4

Thanks @morphar, for [pointing out a need for background on this project including goals and non-goals](https://github.com/google/gnostic/issues/268#issuecomment-1088331075). As the author and maintainer, I'll use this issue to draft a perspective on...

AsyncAPI

2

The [Async API](https://www.asyncapi.com/) spec is very similar in structure to OpenAPI. With a JSON schema, we might generate a .proto model and compiler for it.

With #194, gnostic upgrades its dependency on yaml.v2 to yaml.v3. This means that code that calls the automatically-generated NewDocument functions will break, because they take yaml.v2 data structures as input....

Noted by @noahdietz in comments on #166: - https://github.com/googleapis/gnostic/pull/166#discussion_r415920689 Suggestion: put a return in this conditional block. `return x, compiler.NewErrorGroupOrNil(errors)`. This keeps the error flow indented but the following "green...

linters should report status

1

When a linter runs and finds no problems, if it doesn't return any messages, a user might think that it didn't run at all. Can we fix this by having...

Resolve question about presence/absence of OpenAPI object properties

1

Question about object properties from @wora: > Does OpenAPI depend on presence? e.g. for a property like "bool foo", does OpenAPI treat true, false, and null as 3 separate states?...