From d2b13f77491cce0dfe1035ad7eb7adc1ec24bdee Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=98=99=E2=97=A6=20The=20Tablet=20=E2=9D=80=20GamerGirla?= =?UTF-8?q?ndCo=20=E2=97=A6=E2=9D=A7?= Date: Sat, 22 Nov 2025 17:31:57 -0500 Subject: [PATCH] fix swagger comments in repo adoption routes --- routers/api/v1/admin/adopt.go | 16 +++++- templates/swagger/v1_groups.json | 89 -------------------------------- templates/swagger/v1_json.tmpl | 77 +-------------------------- 3 files changed, 16 insertions(+), 166 deletions(-) diff --git a/routers/api/v1/admin/adopt.go b/routers/api/v1/admin/adopt.go index 0399a1107f..57421ecc28 100644 --- a/routers/api/v1/admin/adopt.go +++ b/routers/api/v1/admin/adopt.go @@ -125,7 +125,7 @@ func AdoptRepository(ctx *context.APIContext) { } func AdoptGroupRepository(ctx *context.APIContext) { - // swagger:operation POST /admin/unadopted/{owner}/{group_id}/{repo} admin adminAdoptRepository + // swagger:operation POST /admin/unadopted/{owner}/group/{group_id}/{repo} admin adminAdoptRepositoryInGroup // --- // summary: Adopt unadopted files as a repository // produces: @@ -141,6 +141,12 @@ func AdoptGroupRepository(ctx *context.APIContext) { // description: name of the repo // type: string // required: true + // - name: group_id + // in: path + // description: group ID of the repo + // type: integer + // format: int64 + // required: true // responses: // "204": // "$ref": "#/responses/empty" @@ -217,7 +223,7 @@ func DeleteUnadoptedRepository(ctx *context.APIContext) { } func DeleteUnadoptedRepositoryInGroup(ctx *context.APIContext) { - // swagger:operation DELETE /admin/unadopted/{owner}/{group_id}/{repo} admin adminDeleteUnadoptedRepository + // swagger:operation DELETE /admin/unadopted/{owner}/group/{group_id}/{repo} admin adminDeleteUnadoptedRepositoryInGroup // --- // summary: Delete unadopted files // produces: @@ -233,6 +239,12 @@ func DeleteUnadoptedRepositoryInGroup(ctx *context.APIContext) { // description: name of the repo // type: string // required: true + // - name: group_id + // in: path + // description: group ID of the repo + // type: integer + // format: int64 + // required: true // responses: // "204": // "$ref": "#/responses/empty" diff --git a/templates/swagger/v1_groups.json b/templates/swagger/v1_groups.json index ab4fbeba22..4895c793dc 100644 --- a/templates/swagger/v1_groups.json +++ b/templates/swagger/v1_groups.json @@ -1,94 +1,5 @@ { "paths": { - "/admin/unadopted/{owner}/group/{group_id}/{repo}": { - "delete": { - "operationId": "adminDeleteUnadoptedRepository", - "parameters": [ - { - "description": "owner of the repo", - "in": "path", - "name": "owner", - "required": true, - "type": "string" - }, - { - "description": "name of the repo", - "in": "path", - "name": "repo", - "required": true, - "type": "string" - }, - { - "description": "group ID of the repo", - "format": "int64", - "in": "path", - "name": "group_id", - "required": true, - "type": "integer" - } - ], - "produces": [ - "application/json" - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - } - }, - "summary": "Delete unadopted files", - "tags": [ - "admin" - ] - }, - "post": { - "operationId": "adminAdoptRepository", - "parameters": [ - { - "description": "owner of the repo", - "in": "path", - "name": "owner", - "required": true, - "type": "string" - }, - { - "description": "name of the repo", - "in": "path", - "name": "repo", - "required": true, - "type": "string" - }, - { - "description": "group ID of the repo", - "format": "int64", - "in": "path", - "name": "group_id", - "required": true, - "type": "integer" - } - ], - "produces": [ - "application/json" - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "summary": "Adopt unadopted files as a repository", - "tags": [ - "admin" - ] - } - }, "/repos/{owner}/group/{group_id}/{repo}": { "delete": { "operationId": "repoDelete", diff --git a/templates/swagger/v1_json.tmpl b/templates/swagger/v1_json.tmpl index 4c466616f9..a892491e1e 100644 --- a/templates/swagger/v1_json.tmpl +++ b/templates/swagger/v1_json.tmpl @@ -662,7 +662,7 @@ "admin" ], "summary": "Adopt unadopted files as a repository", - "operationId": "adminAdoptRepositoryMixin0", + "operationId": "adminAdoptRepositoryInGroup", "parameters": [ { "type": "string", @@ -707,7 +707,7 @@ "admin" ], "summary": "Delete unadopted files", - "operationId": "adminDeleteUnadoptedRepositoryMixin0", + "operationId": "adminDeleteUnadoptedRepositoryInGroup", "parameters": [ { "type": "string", @@ -742,79 +742,6 @@ } } }, - "/admin/unadopted/{owner}/{group_id}/{repo}": { - "post": { - "produces": [ - "application/json" - ], - "tags": [ - "admin" - ], - "summary": "Adopt unadopted files as a repository", - "operationId": "adminAdoptRepository", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - }, - "delete": { - "produces": [ - "application/json" - ], - "tags": [ - "admin" - ], - "summary": "Delete unadopted files", - "operationId": "adminDeleteUnadoptedRepository", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - } - } - } - }, "/admin/unadopted/{owner}/{repo}": { "post": { "produces": [