Skip to content

Improve NuGet API Parity (#21291)#34940

Merged
wxiaoguang merged 4 commits into
go-gitea:mainfrom
ScionOfDesign:improve-nuget-api-parity
Jul 7, 2025
Merged

Improve NuGet API Parity (#21291)#34940
wxiaoguang merged 4 commits into
go-gitea:mainfrom
ScionOfDesign:improve-nuget-api-parity

Conversation

@ScionOfDesign
Copy link
Copy Markdown
Contributor

@ScionOfDesign ScionOfDesign commented Jul 3, 2025 •
edited
Loading

Summary

Fixes #21291, allowing icons and other missing attributes to appear for NuGet packages from inside Visual Studio like they do with GitHub Nuget packages.

Adds additional NuGet package information, particularly IconURL, to bring the Gitea NuGet API more in-line with GitHub's NuGet API.

  • Adds the following .nuspec values to the NuGet query responses:
    • copyright
    • iconUrl
      • Adding this allows Visual Studio to display and Icon for the package.
    • isPrerelease
    • language
    • licenseUrl
      • The license now appears in Visual Studio.
    • summary
    • tags
      • Tags now appear in Visual Studio.
    • dependencyGroups
      • Now appears in all requests for a package like with GitHub.
    • totalDownloads
      • Now calculated while gathering the different package versions.
  • Re-orders the values in the response to more closely align with GitHub.

References

Octopus Samples - Examples of NuGet packages being pushed to GitHub.
When querying for packages, Visual Studio makes a request to a route like this one:
https://nuget.pkg.github.com/OctopusSamples/OctopusSamples.accept-message/index.json

Gitea was missing the properties that GitHub responds with.
Both Gitea and Github should now look like the following with the attached package, for example. (Rename it to .nupkg)
image

It should be noted that GitHub also has a boolean property called verified, but this is not part of the NuGet specification.

Please let me know if anything else should be changed.

@ScionOfDesign
Adds additional NuGet package information, particularly IconURL, to…
343d912 
… bring the Gitea NuGet api more in-line with GitHub's NuGet API.

This allows fixes go-gitea#21291, allowing icons to appear for NuGet packages from inside Visual Studio.
@ScionOfDesign
Made it so that Tags and the License display is Visual Studio.
71f2ed2
@GiteaBot GiteaBot added the lgtm/need 2 This PR needs two approvals by maintainers to be considered for merging. label Jul 3, 2025
@lunny lunny added this to the 1.25.0 milestone Jul 3, 2025
@wxiaoguang
Copy link
Copy Markdown
Contributor

wxiaoguang commented Jul 5, 2025

Can we have some tests? Existing tests are in api_packages_nuget_test.go

@ScionOfDesign
Copy link
Copy Markdown
Contributor Author

ScionOfDesign commented Jul 6, 2025

Alright, let me look into updating the tests.

@ScionOfDesign
Copy link
Copy Markdown
Contributor Author

ScionOfDesign commented Jul 7, 2025

I have updated the tests to check for the additional values present in the API response.

wxiaoguang
wxiaoguang approved these changes Jul 7, 2025
View reviewed changes
Copy link
Copy Markdown
Contributor

@wxiaoguang wxiaoguang left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you very much!

@GiteaBot 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 7, 2025
@wxiaoguang wxiaoguang added the type/enhancement An improvement of existing functionality label Jul 7, 2025
@GiteaBot GiteaBot added lgtm/done This PR has enough approvals to get merged. There are no important open reservations anymore. and removed lgtm/need 1 This PR needs approval from one additional maintainer to be merged. labels Jul 7, 2025
@wxiaoguang wxiaoguang enabled auto-merge (squash) July 7, 2025 10:20
@wxiaoguang wxiaoguang merged commit f88800d into go-gitea:main Jul 7, 2025
26 checks passed
@ScionOfDesign ScionOfDesign deleted the improve-nuget-api-parity branch July 7, 2025 19:09
zjjhot added a commit to zjjhot/gitea that referenced this pull request Jul 9, 2025
@zjjhot
Merge remote-tracking branch 'giteaofficial/main'
158f99e 
* giteaofficial/main:
  Refactor mail template and support preview (go-gitea#34990)
  [skip ci] Updated translations via Crowdin
  Fix bug when displaying git user avatar in commits list (go-gitea#35003)
  Tweak placement of diff file menu (go-gitea#34999)
  Start automerge check again after the conflict check and the schedule (go-gitea#34989)
  Refactor time tracker UI (go-gitea#34983)
  [skip ci] Updated translations via Crowdin
  Improve NuGet API Parity (go-gitea#21291) (go-gitea#34940)
@wxiaoguang wxiaoguang mentioned this pull request Aug 23, 2025
Open
@go-gitea go-gitea locked as resolved and limited conversation to collaborators Oct 6, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Reviewers

@lunny lunny lunny approved these changes

@wxiaoguang wxiaoguang wxiaoguang approved these changes

Assignees

No one assigned

Labels

lgtm/done This PR has enough approvals to get merged. There are no important open reservations anymore. topic/packages type/enhancement An improvement of existing functionality

Projects

None yet

Milestone

1.25.0

Development

Successfully merging this pull request may close these issues.

Nuget extra Catalog entries

5 participants

@ScionOfDesign @wxiaoguang @lunny @techknowlogick @GiteaBot