OAPI: better reporting of version info

Make it explicit that the `version` property is for human consumption.
Also add a new `git` property so that all info from `version` is also
included in separate fields for machine consumption.
This commit is contained in:
Sybren A. Stüvel 2023-07-06 12:18:26 +02:00
parent dd34d538ec
commit c6dcf6d7bd

View File

@ -1334,14 +1334,21 @@ components:
FlamencoVersion: FlamencoVersion:
type: object type: object
properties: properties:
"version": { type: string } "version":
type: string
description: >
Version of this Manager, meant for human consumption. For release
builds it is the same as `shortversion`, for other builds it also
includes the `git` version info.
"shortversion": { type: string } "shortversion": { type: string }
"name": { type: string } "name": { type: string }
required: [version, shortversion, name] "git": { type: string }
required: [version, shortversion, name, git]
example: example:
version: 3.0-beta1-56-g4761e3d7-dirty version: "3.3-alpha0 (v3.2-76-gdd34d538)"
shortversion: 3.0-beta1 shortversion: 3.3-alpha0
name: Your Manager name: Your Manager
git: v3.2-76-gdd34d538
ManagerConfiguration: ManagerConfiguration:
type: object type: object