Merge the `create a file in a repository` API and the `update a file in a repository` API

[lchrennew]

Feature Description

The update a file in a repostory API should compatible with the corresponding Github API:
https://docs.github.com/en/rest/reference/repos#create-or-update-file-contents

Creates a new file or replaces an existing file in a repository.

PUT /repos/{owner}/{repo}/contents/{path}

Screenshots

[smallfish06]

I wrote a preview pr as #29419 (test and swagger are not well prepared)

While using popular repository https://github.com/google/go-github. I found create/upsert file API is yet different with Github API

Since I don't know history of this feature, but also curious that creating contents is quite important API when using git with code. (https://github.com/go-gitea/gitea/blob/main/CONTRIBUTING.md#github-api-compatibility)

Can somebody tell me about this?

As @lunny mentioned, this is breaking change of API

[lunny]

I think you can mark one as deprecated first but not remove it.

[smallfish06]

Thank you for replying. That would be nice.
I'll open pr with POST Create marked as deprecated

[wxiaoguang]

It is implemented, now there is a new operation: "upload" for "create/update"

[wxiaoguang]

To make it compatible with GitHub API: Make "update file" API can create a new file when SHA is not set #35738