Merge pull request #51674 from nextcloud/feat/openapi/merged-spec

feat(openapi): Generate merged spec for all apps

Author: sorbaugh

.reuse/dep5

@@ -342,3 +342,7 @@ License: CC0-1.0
 Files: apps/theming/fonts/OpenDyslexic-Bold.otf apps/theming/fonts/OpenDyslexic-Regular.otf
 Copyright: 2012-2019 Abbie Gonzalez <https://abbiecod.es|[email protected]>, with Reserved Font Name OpenDyslexic.
 License: OFL-1.1-RFN
+
+Files: openapi.json
+Copyright: 2025 Nextcloud GmbH and Nextcloud contributors
+License: AGPL-3.0-or-later

build/files-checker.php

@@ -69,6 +69,7 @@
 	'occ',
 	'ocs',
 	'ocs-provider',
+	'openapi.json',
 	'package-lock.json',
 	'package.json',
 	'psalm-ncu.xml',

build/openapi-checker.sh

@@ -3,13 +3,26 @@
 # SPDX-FileCopyrightText: 2023 Nextcloud GmbH and Nextcloud contributors
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
+specs=()
 for path in core apps/*; do
 	if [ ! -f "$path/.noopenapi" ] && [[ "$(git check-ignore "$path")" != "$path" ]]; then
 		composer exec generate-spec "$path" "$path/openapi.json" || exit 1
+		if [[ "$(basename "$path")" != "core" ]]; then
+			if [ -f "$path/openapi-full.json" ]; then
+				specs+=("$path/openapi-full.json")
+			else
+				specs+=("$path/openapi.json")
+			fi;
+		fi;
 	fi
 done
 
-files="$(git diff --name-only)"
+composer exec merge-specs -- \
+	--core core/openapi-full.json \
+	--merged openapi.json \
+	"${specs[@]}"
+
+files="$(git ls-files --exclude-standard --modified --others)"
 changed=false
 for file in $files; do
     if [[ $file == *"openapi"*".json" ]]; then

composer.json

@@ -71,7 +71,8 @@
 		"test": "phpunit --configuration tests/phpunit-autotest.xml",
 		"test:db": "@composer run test -- --group DB,SLOWDB",
 		"test:files_external": "phpunit --configuration tests/phpunit-autotest-external.xml",
-		"rector": "rector --config=build/rector.php && composer cs:fix"
+		"rector": "rector --config=build/rector.php && composer cs:fix",
+		"openapi": "./build/openapi-checker.sh"
 	},
 	"extra": {
 		"bamarni-bin": {