Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Problem: OpenAPI schema contains long Operation Ids #18

Merged
merged 1 commit into from Jun 26, 2019

Conversation

dkliban
Copy link
Member

@dkliban dkliban commented Jun 19, 2019

Solution: request OpenAPI schema with 'bindings' query parameter

This patch takes advantage of a new feature in pulpcore that allows generating OpenAPI schema
with short Operation Ids.

Required PR: pulp/pulpcore#178

re: #4989
https://pulp.plan.io/issues/4989

dkliban added a commit to dkliban/pulpcore that referenced this pull request Jun 19, 2019
Solution: add ability to request shorter operation ids in the schema

This patch adds ability to specify 'bindings' query parameter when requesting the OpenAPI
schema. When specified, a short OperationId is used for each operation.

Required PR: pulp/pulp-openapi-generator#18

re: #4989
https://pulp.plan.io/issues/4989
dkliban added a commit to dkliban/pulpcore that referenced this pull request Jun 19, 2019
Solution: add ability to request shorter operation ids in the schema

This patch adds ability to specify 'bindings' query parameter when requesting the OpenAPI
schema. When specified, a short OperationId is used for each operation.

Required PR: pulp/pulp-openapi-generator#18

re: #4989
https://pulp.plan.io/issues/4989
dkliban added a commit to dkliban/pulpcore that referenced this pull request Jun 19, 2019
Solution: add ability to request shorter operation ids in the schema

This patch adds ability to specify 'bindings' query parameter when requesting the OpenAPI
schema. When specified, a short OperationId is used for each operation.

Required PR: pulp/pulp-openapi-generator#18

re: #4989
https://pulp.plan.io/issues/4989
dkliban added a commit to dkliban/pulpcore that referenced this pull request Jun 19, 2019
Solution: add ability to request shorter operation ids in the schema

This patch adds ability to specify 'bindings' query parameter when requesting the OpenAPI
schema. When specified, a short OperationId is used for each operation.

This patch also changes how the OpenAPI schema operations are grouped together. Each resource
now has its own tag associated with it. This results in better REST API docs and better
experience for users of bindings.

Required PR: pulp/pulp-openapi-generator#18

re: #4989
https://pulp.plan.io/issues/4989
dkliban added a commit to dkliban/pulpcore that referenced this pull request Jun 20, 2019
Solution: add ability to request shorter operation ids in the schema

This patch adds ability to specify 'bindings' query parameter when requesting the OpenAPI
schema. When specified, a short OperationId is used for each operation.

This patch also changes how the OpenAPI schema operations are grouped together. Each resource
now has its own tag associated with it. This results in better REST API docs and better
experience for users of bindings.

The tag for a resource is determined from it's URL. The plugin name is omitted from the tag. For
example:

URL: /pulp/api/v3/repositories/
Tag: Repositories

URL: /pulp/api/v3/repositories/<uuid>/versions/
Tag: Repositories: Versions

URL: /pulp/api/v3/content/file/files/
Tag: Content: Files

URL: /pulp/api/v3/remotes/file/file/
Tag: Remotes: File

Required PR: pulp/pulp-openapi-generator#18

re: #4989
https://pulp.plan.io/issues/4989
Solution: request OpenAPI schema with 'bindings' query parameter

This patch takes advantage of a new feature in pulpcore that allows generating OpenAPI schema
with short Operation Ids.

Required PR: pulp/pulpcore#178

re: #4989
https://pulp.plan.io/issues/4989
dkliban added a commit to dkliban/pulpcore that referenced this pull request Jun 20, 2019
Solution: add ability to request shorter operation ids in the schema

This patch adds ability to specify 'bindings' query parameter when requesting the OpenAPI
schema. When specified, a short OperationId is used for each operation.

This patch also changes how the OpenAPI schema operations are grouped together. Each resource
now has its own tag associated with it. This results in better REST API docs and better
experience for users of bindings.

The tag for a resource is determined from it's URL. The plugin name is omitted from the tag. For
example:

URL: /pulp/api/v3/repositories/
Tag: Repositories

URL: /pulp/api/v3/repositories/<uuid>/versions/
Tag: Repositories: Versions

URL: /pulp/api/v3/content/file/files/
Tag: Content: Files

URL: /pulp/api/v3/remotes/file/file/
Tag: Remotes: File

Required PR: pulp/pulp-openapi-generator#18

re: #4989
https://pulp.plan.io/issues/4989
dkliban added a commit to dkliban/pulpcore that referenced this pull request Jun 20, 2019
Solution: add ability to request shorter operation ids in the schema

This patch adds ability to specify 'bindings' query parameter when requesting the OpenAPI
schema. When specified, a short OperationId is used for each operation.

This patch also changes how the OpenAPI schema operations are grouped together. Each resource
now has its own tag associated with it. This results in better REST API docs and better
experience for users of bindings.

The tag for a resource is determined from it's URL. The plugin name is omitted from the tag. For
example:

URL: /pulp/api/v3/repositories/
Tag: Repositories

URL: /pulp/api/v3/repositories/<uuid>/versions/
Tag: Repositories: Versions

URL: /pulp/api/v3/content/file/files/
Tag: Content: Files

URL: /pulp/api/v3/remotes/file/file/
Tag: Remotes: File

Required PR: pulp/pulp-openapi-generator#18

re: #4989
https://pulp.plan.io/issues/4989
dkliban added a commit to dkliban/pulpcore that referenced this pull request Jun 20, 2019
Solution: add ability to request shorter operation ids in the schema

This patch adds ability to specify 'bindings' query parameter when requesting the OpenAPI
schema. When specified, a short OperationId is used for each operation.

This patch also changes how the OpenAPI schema operations are grouped together. Each resource
now has its own tag associated with it. This results in better REST API docs and better
experience for users of bindings.

The tag for a resource is determined from it's URL. The plugin name is omitted from the tag. For
example:

URL: /pulp/api/v3/repositories/
Tag: Repositories

URL: /pulp/api/v3/repositories/<uuid>/versions/
Tag: Repositories: Versions

URL: /pulp/api/v3/content/file/files/
Tag: Content: Files

URL: /pulp/api/v3/remotes/file/file/
Tag: Remotes: File

Required PR: pulp/pulp-openapi-generator#18

re: #4989
https://pulp.plan.io/issues/4989
@dkliban dkliban merged commit b8e4b25 into pulp:master Jun 26, 2019
@dkliban dkliban deleted the new-bindings branch June 26, 2019 15:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants