feat(api): add tag prefix filtering to releases API #38513 by gomitrah · Pull Request #38681 · go-gitea/gitea

gomitrah · 2026-07-28T07:33:38Z

Add tag prefix filtering to `/repos/{owner}/{repo}/releases` API

Root Cause

The releases API endpoint currently returns all releases without a way to filter by tag prefix. In repositories with multiple artifacts or monorepo release tags, clients must fetch many pages and filter releases locally, causing unnecessary API requests and server-side processing.

Fixes #38513

Before This Change

API users could only fetch all releases from /repos/{owner}/{repo}/releases.
No query parameter was available to filter releases by tag prefix.
Projects with multiple release streams needed extra requests to find relevant releases.

Solution

Add support for a tag_filter query parameter in the releases API.

The API now filters releases and returns only releases whose tag names start with the provided prefix.

Implementation Details

Added query parameter handling for tag_filter in the releases API.
Applied filtering at the API/database query level instead of requiring clients to filter responses.
Preserved existing API behavior when tag_filter is not provided.
Regenerated Swagger templates (make generate-swagger) to reflect the new parameter.

The pre-release param was missing its boolean type and tag_prefix had a stray duplicate type line, causing swagger-check to fail. Assisted-by: Claude Code:claude-sonnet-5

silverwind · 2026-07-28T10:13:57Z

How does this compare to similar GitHub APIs for releases?
What about other matching mechanisms? What if someone needs suffix etc? Can we find a solution that works flexibly?

gomitrah · 2026-07-29T06:30:07Z

How does this compare to similar GitHub APIs for releases?

What about other matching mechanisms? What if someone needs suffix etc? Can we find a solution that works flexibly?

@silverwind
Thanks for the suggestion!

I checked the GitHub API. GitHub's Releases API doesn't support tag prefix or other tag-based filtering; it only supports exact tag lookup (/releases/tags/{tag}) and pagination.
I agree with your feedback. Based on that, I've updated the implementation to support a more flexible tag_filter instead of only prefix matching. It now supports exact, prefix, suffix, and substring matching within the same API, without introducing a new endpoint. I've pushed the changes to the existing PR. Please review and let me know if any.

silverwind · 2026-07-29T10:01:52Z

LIKE filter is better, thank. But with those %, precise matching is not possible. Likely not an issue in practice but maybe worth a short investigation if any other APIs in gitea have solved this problem yet so that it could be adapted here.

gomitrah · 2026-07-29T13:12:42Z

LIKE filter is better, thank. But with those %, precise matching is not possible. Likely not an issue in practice but maybe worth a short investigation if any other APIs in gitea have solved this problem yet so that it could be adapted here.

@silverwind
I looked for similar implementations in Gitea and found a reference in models/packages/conan/search.go, where wildcard matching is implemented by converting * to % (while escaping _) before using builder.Like.

I followed the same approach for tag_filter, allowing a single wildcard-based filter to support exact, prefix, suffix, and substring matching. I've updated the implementation and pushed the changes.

silverwind

Nice solution with *, thanks.

wxiaoguang · 2026-07-29T14:55:06Z

+	link.RawQuery = url.Values{"tag_filter": {"*1.0*"}}.Encode()
+	resp = MakeRequest(t, NewRequest(t, "GET", link.String()).AddTokenAuth(token), http.StatusOK)
+	apiReleases = DecodeJSON(t, resp, []*api.Release{})
+
+	if assert.Len(t, apiReleases, 1) {
+		for _, release := range apiReleases {
+			assert.Contains(t, release.TagName, "1.0")
+		}
+	}


I believe the testFilterByLen should be refactored to testFilterByTagNames and make it accept an expected names slice to "assert".

@wxiaoguang

I've refactored the test helper from testFilterByLen to testFilterByTagNames as suggested. The helper now accepts the expected tag names and validates the returned tag list directly using assert.ElementsMatch, making the test verify the actual API response instead of only the number of results. . Please review and let me know if any.

I believe the testFilterByLen should be refactored to testFilterByTagNames and make it accept an expected names slice to "assert".

I don't understand why it still makes sense to keep the badly-designed "testFilterByLen" function .

gomitrah added 4 commits July 27, 2026 19:11

feat(api): add tag prefix filtering to releases API

39c738f

Removed the extra space

4d199e3

Fixed the linter issues

c538259

fix(api): correct swagger type annotations for release filters

637b738

The pre-release param was missing its boolean type and tag_prefix had a stray duplicate type line, causing swagger-check to fail. Assisted-by: Claude Code:claude-sonnet-5

GiteaBot added the lgtm/need 2 This PR needs two approvals by maintainers to be considered for merging. label Jul 28, 2026

github-actions Bot added topic/api Concerns mainly the API type/feature Completely new functionality. Can only be merged if feature freeze is not active. labels Jul 28, 2026

Implemented the logics for flexible filter matching.

643e79e

Support flexible wildcard matching in release tag_filter

6aa3907

silverwind approved these changes Jul 29, 2026

View reviewed changes

GiteaBot added lgtm/need 1 This PR needs approval from one additional maintainer to be merged. and removed lgtm/need 2 This PR needs two approvals by maintainers to be considered for merging. labels Jul 29, 2026

wxiaoguang reviewed Jul 29, 2026

View reviewed changes

Comment thread models/repo/release.go

wxiaoguang reviewed Jul 29, 2026

View reviewed changes

wxiaoguang marked this pull request as draft July 29, 2026 14:55

Worked on the review comments.

3006454

wxiaoguang marked this pull request as ready for review July 30, 2026 07:16

clean up

ebacc63

wxiaoguang force-pushed the feat/38153-add-tag-prefix-filtering-releases branch from 87998be to ebacc63 Compare July 30, 2026 07:23

wxiaoguang mentioned this pull request Jul 30, 2026

Fix get release draft permission check #36659

Merged

gomitrah requested a review from wxiaoguang July 31, 2026 08:11

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

feat(api): add tag prefix filtering to releases API #38513 - #38681

feat(api): add tag prefix filtering to releases API #38513#38681
gomitrah wants to merge 8 commits into
go-gitea:mainfrom
gomitrah:feat/38153-add-tag-prefix-filtering-releases

gomitrah commented Jul 28, 2026 •

edited

Loading

Uh oh!

silverwind commented Jul 28, 2026 •

edited

Loading

Uh oh!

gomitrah commented Jul 29, 2026 •

edited

Loading

Uh oh!

silverwind commented Jul 29, 2026 •

edited

Loading

Uh oh!

gomitrah commented Jul 29, 2026

Uh oh!

silverwind left a comment

Uh oh!

Uh oh!

wxiaoguang Jul 29, 2026

Uh oh!

gomitrah Jul 30, 2026 •

edited

Loading

Uh oh!

wxiaoguang Jul 30, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

Uh oh!

Conversation

gomitrah commented Jul 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Add tag prefix filtering to /repos/{owner}/{repo}/releases API

Root Cause

Before This Change

Solution

Implementation Details

Uh oh!

silverwind commented Jul 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

gomitrah commented Jul 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

silverwind commented Jul 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

gomitrah commented Jul 29, 2026

Uh oh!

silverwind left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

wxiaoguang Jul 29, 2026

Choose a reason for hiding this comment

Uh oh!

gomitrah Jul 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

wxiaoguang Jul 30, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

gomitrah commented Jul 28, 2026 •

edited

Loading

Add tag prefix filtering to `/repos/{owner}/{repo}/releases` API

silverwind commented Jul 28, 2026 •

edited

Loading

gomitrah commented Jul 29, 2026 •

edited

Loading

silverwind commented Jul 29, 2026 •

edited

Loading

gomitrah Jul 30, 2026 •

edited

Loading