HomePhabricator

Provide OpenAPI spec for Blubberoid

Authored by dduvall on Sep 19 2018, 6:06 PM.

Description

Provide OpenAPI spec for Blubberoid

Wrote an OpenAPI 3.0 spec for Blubberoid that provides x-amples
entries compatible with service-checker.

The written spec includes basic schema for Blubber config objects that
may be later factored out for use in validation.

Note that OpenAPI 3.0 supports only the v4 draft of the JSON Schema
standard, so some parts of the configuration could not be fully
described. Specifically, v4 does not include the patternProperties
definition introduced in the JSON Schema v6 draft that would allow us to
describe variants and runs.environment and everything beneath.

Blubberoid was refactored slightly to incorporate the new spec as well
as assume JSON as the canonical and default configuration format. It was
also refactored to include a versioned namespace ("v1") after the server
endpoint.

Bug: T205920
Change-Id: I28a341aa503b8920d802715660d4c4d62be45475

Details

Committed
dduvallDec 12 2018, 8:35 PM
Parents
rGBLBR3da9f201cad3: Support "application/json" in Blubberoid
Branches
Unknown
Tags
Unknown
References
refs/changes/58/461458/6
ChangeId
I28a341aa503b8920d802715660d4c4d62be45475