Create a TCK about microprofile-open-api

[mrglavas]

@arthurdm I'm currently working on the skeleton for the TCK. Can you assign this one to me? Thanks.

[arthurdm]

Unfortunately the Assignee field only picks from the committers list, so can't assign. But it's recorded here that @mrglavas is currently working on this issue.

[mrglavas]

Breakdown of TCK test scenarios:

API:

• Direct testing of OpenAPI model construction through OASFactory.
• Check that each method on model interfaces can be executed.
• Check that each getter method on model returns what was set with setter or builder method.
• Test any other factory method that gets added for filtering, etc...
• Negative testing for bad input (e.g. non-model interface passed to OASFactory.createObject()).

REST endpoints:

• Test driver which accesses the OpenAPI document endpoint and verifies that it returns the correct output.
• Test the endpoint with Accept headers (application/yaml and application/json)
• Develop input for the test driver that covers all of the various documentation mechanisms.
  -- Configuration values for mp.openapi namespace
  -- OASModelReader
  -- OASFilter
  -- Static OpenAPI file (YAML / JSON)
  -- Annotated JAX-RS applications (covers OpenAPI annotations + JAX-RS annotations)

Utilities:

• May require an OpenAPI parser to help with comparing expected output.

[mrglavas]

I am currently working on the model construction test.

[arthurdm]

Looks good @mrglavas ! My only comment is that the query parameter (format) is an optional part of the spec, so the TCK should be testing with the Accept header (application/yaml and application/json).

[mrglavas]

Thanks @arthurdm. I've updated the description.

[arthurdm]

Closing this as we have other issues to handle the remaining TCK portions