API: file listing / tree access

[mmarchetti]

The current Repo Contents API supports raw file retrieval, but there doesn't seem to be a way to list the files in the repo. (Both GitHub and GitLab support this via the Tree API or a file access endpoint that also supports directory listing).

The motivation for this is that I would like to access a small subset of files in gitea repos, without cloning the repo or scraping the web interface.

Related to #64.

[necaris]

See #2749, which is an in-progress response to this, using the GitHub Tree API as a model. It follows the structure of code in the UI views (e.g. the directory view), and as I understand it the remaining pieces are:

• validate REST API design
  • do we expose the Git file entry mode (e.g. 0644, 0755)
  • do we expose the Git file size (currently an expensive operation -- perhaps worth adding in a follow-up, or gated behind a query parameter)
• add SDK model types for the resulting file entry and tree listing APIs
• add model and integration tests for this
  • add more content to test fixtures to enable more meaningful (e.g. recursive) tests

Would love feedback from maintainers on whether this will be accepted before we put much more work into it! /cc @lunny since they seem to be a maintainer

[lunny]

@necaris The PR is welcome to be compatible with Github Tree API. And also, we need some unit tests or integration tests on the PR.

[rhaamo]

any update of progress on this issue and associated PR ?

[lunny]

@rhaamo nobody are working on this.

[necaris]

I intend to pick it back up but have limited time.

…

On Sat, Oct 6, 2018, 11:02 Lunny Xiao ***@***.***> wrote: @rhaamo <https://github.com/rhaamo> nobody are working on this. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#1978 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AAcH4fd_eKAIRF9aYxI-XSDq0y8CjFyxks5uiMYfgaJpZM4N7YyQ> .

[HoffmannP]

The current state is somehow confusing:

There are two PRs for solving this:
#2749 and #4185 while the latter one depends on either go-gitea/go-sdk/pull/94 or go-gitea/go-sdk#109 (which seems to depend on go-gitea/git/pull/123).

As I want to build commit API which depends on the tree API I'd be absolutely happy if all authors could come to an agreement or the maintainers would choose one solution over another. (I hope I found everybody working on the tree API)

[lunny]

@HoffmannP see #5403