Move Swagger to Top Level (PelicanPlatform#1126)

* Move Swagger to Top Level

.gitignore

@@ -3,3 +3,4 @@ README.dev.md
 docs/parameters.json
 web_ui/frontend/public/data/parameters.json
 local
+web_ui/frontend/app/api/docs/pelican-swagger.yaml

Makefile

@@ -78,7 +78,7 @@ docs/parameters.json:
 	@touch docs/parameters.json
 
 .PHONY: generate
-generate: docs/parameters.json web_ui/frontend/public/data/parameters.json
+generate: docs/parameters.json web_ui/frontend/public/data/parameters.json swagger/pelican-swagger.yaml
 ifeq ($(USE_DOCKER),0)
 	@go generate ./...
 else
@@ -111,7 +111,7 @@ pelican-clean:
 	@rm -rf $(PELICAN_DIST_PATH)
 
 .PHONY: pelican-build
-pelican-build: web_ui/frontend/out/index.html
+pelican-build:
 	@echo PELICAN BUILD
 ifeq ($(USE_DOCKER),0)
 	@goreleaser --clean --snapshot

generate/main.go

@@ -28,5 +28,6 @@ func main() {
 	GenParamEnum()
 	GenParamStruct()
 	GenPlaceholderPathForNext()
+	GenSwaggerDoc()
 	GenTokenScope()
 }

generate/next_generator.go

@@ -44,3 +44,19 @@ func GenPlaceholderPathForNext() {
 	}
 	file.Close()
 }
+
+// Copy swagger document from swagger/pelican-swagger.yaml to the web_ui/frontend/app/api directory
+func GenSwaggerDoc() {
+	src := "../swagger/pelican-swagger.yaml"
+	dst := "../web_ui/frontend/app/api/docs/pelican-swagger.yaml"
+
+	swaggerDoc, err := os.ReadFile(src)
+	if err != nil {
+		log.Fatalf("error: %v", err)
+	}
+
+	err = os.WriteFile(dst, swaggerDoc, 0644)
+	if err != nil {
+		log.Fatalf("error: %v", err)
+	}
+}