Files
opencloud/services/groupware/Makefile
Pascal Bleser 42a4c5c156 groupware: swagger API documentation improvements
* add more documentation for properties

 * fixes after a bit of trial-and-error with go-swagger

 * fix email filter marshalling when there are no search criteria

 * introduce an apidoc.yml that contains Swagger data and is merged when
   generating the swagger.yml from sources
2026-02-04 09:40:20 +01:00

25 lines
629 B
Makefile

SHELL := bash
NAME := groupware
ifneq (, $(shell command -v go 2> /dev/null)) # suppress `command not found warnings` for non go targets in CI
include ../../.bingo/Variables.mk
endif
include ../../.make/default.mk
include ../../.make/go.mk
include ../../.make/release.mk
include ../../.make/docs.mk
.PHONY: apidoc
apidoc: swagger.yml
.PHONY: swagger.yml
swagger.yml: apidoc.yml
swagger generate spec --output=$@ --include='groupware' --include='jmap' --scan-models --input=$<
APIDOC_PORT=9999
.PHONY: serve-apidoc
serve-apidoc: swagger.yml
swagger serve --no-open --port=$(APIDOC_PORT) --host=127.0.0.1 --flavor=redoc $<