Build one large openapi document from subsets, ie different api endpoints or domain logic.

openapi.md

generate-openapi-one:
	rm -rf /tmp/openapi/one && \
	mkdir -p /tmp/openapi/one && \
	cp ./openapi/learnalist.yaml /tmp/openapi/one/ && \
	yq m -i /tmp/openapi/one/learnalist.yaml ./openapi/api.version.yaml && \
	yq m -i /tmp/openapi/one/learnalist.yaml ./openapi/api.asset.yaml && \
	yq m -i /tmp/openapi/one/learnalist.yaml ./openapi/api.plank.yaml && \
	yq m -i /tmp/openapi/one/learnalist.yaml ./openapi/api.user.yaml && \
	yq m -i /tmp/openapi/one/learnalist.yaml ./openapi/api.alist.yaml && \
	yq m -i /tmp/openapi/one/learnalist.yaml ./openapi/api.spaced_repetition.yaml && \
	yq m -i /tmp/openapi/one/learnalist.yaml ./openapi/api.challenge.yaml && \
	yq m -i /tmp/openapi/one/learnalist.yaml ./openapi/api.mobile.yaml && \
	yq m -i /tmp/openapi/one/learnalist.yaml ./openapi/api.remind.yaml && \
	yq m -i /tmp/openapi/one/learnalist.yaml ./openapi/api.app_settings.yaml && \
	yq m -i /tmp/openapi/one/learnalist.yaml ./openapi/api.payment.yaml && \
	yq m -i /tmp/openapi/one/learnalist.yaml ./openapi/api.list_slideshow.yaml && \
	docker run --rm \
	-v "/tmp/openapi/:/src/openapi/" \
	openapitools/openapi-generator-cli generate \
		-i /src/openapi/one/learnalist.yaml \
		-g openapi-yaml \
		-o /src/openapi/one

./openapi/learnalist.yaml

• Contains some of the base information, ie server and security setup.

Using an older yq

• yq version 3.4.1 (Worth noting, the example uses an out of date yq, so a few modifictaions might be needed)

Reference

• yq https://github.com/mikefarah/yq