Get File List from GitHub

Usage

github_files(repo, dir = "", recursive = FALSE)

Arguments

repo: The URL of the repository (in the format "username/repo" or "https://github.com/username/repo")
dir: an optional directory name to search
recursive: whether to search the files recursively

Value

a data frame of files

Examples

# \donttest{
if (online("api.github.com")) {
  # GitHub can refuse when its request limit is reached; then this says why
  tryCatch(github_files("scienceverse/metacheck"),
           error = function(e) message(conditionMessage(e)))
}
#>                      repo             clean_repo               name
#> 1  scienceverse/metacheck scienceverse/metacheck      .Rbuildignore
#> 2  scienceverse/metacheck scienceverse/metacheck     .gitattributes
#> 3  scienceverse/metacheck scienceverse/metacheck            .github
#> 4  scienceverse/metacheck scienceverse/metacheck         .gitignore
#> 5  scienceverse/metacheck scienceverse/metacheck            .vscode
#> 6  scienceverse/metacheck scienceverse/metacheck CODE_OF_CONDUCT.md
#> 7  scienceverse/metacheck scienceverse/metacheck    CONTRIBUTING.md
#> 8  scienceverse/metacheck scienceverse/metacheck        DESCRIPTION
#> 9  scienceverse/metacheck scienceverse/metacheck         LICENSE.md
#> 10 scienceverse/metacheck scienceverse/metacheck          NAMESPACE
#> 11 scienceverse/metacheck scienceverse/metacheck            NEWS.md
#> 12 scienceverse/metacheck scienceverse/metacheck                  R
#> 13 scienceverse/metacheck scienceverse/metacheck          README.md
#> 14 scienceverse/metacheck scienceverse/metacheck   _metacheck.Rproj
#> 15 scienceverse/metacheck scienceverse/metacheck        codecov.yml
#> 16 scienceverse/metacheck scienceverse/metacheck               data
#> 17 scienceverse/metacheck scienceverse/metacheck           data-raw
#> 18 scienceverse/metacheck scienceverse/metacheck               inst
#> 19 scienceverse/metacheck scienceverse/metacheck           makefile
#> 20 scienceverse/metacheck scienceverse/metacheck                man
#> 21 scienceverse/metacheck scienceverse/metacheck            pkgdown
#> 22 scienceverse/metacheck scienceverse/metacheck              tests
#>                  path
#> 1       .Rbuildignore
#> 2      .gitattributes
#> 3             .github
#> 4          .gitignore
#> 5             .vscode
#> 6  CODE_OF_CONDUCT.md
#> 7     CONTRIBUTING.md
#> 8         DESCRIPTION
#> 9          LICENSE.md
#> 10          NAMESPACE
#> 11            NEWS.md
#> 12                  R
#> 13          README.md
#> 14   _metacheck.Rproj
#> 15        codecov.yml
#> 16               data
#> 17           data-raw
#> 18               inst
#> 19           makefile
#> 20                man
#> 21            pkgdown
#> 22              tests
#>                                                                        download_url
#> 1       https://raw.githubusercontent.com/scienceverse/metacheck/main/.Rbuildignore
#> 2      https://raw.githubusercontent.com/scienceverse/metacheck/main/.gitattributes
#> 3                                                                              <NA>
#> 4          https://raw.githubusercontent.com/scienceverse/metacheck/main/.gitignore
#> 5                                                                              <NA>
#> 6  https://raw.githubusercontent.com/scienceverse/metacheck/main/CODE_OF_CONDUCT.md
#> 7     https://raw.githubusercontent.com/scienceverse/metacheck/main/CONTRIBUTING.md
#> 8         https://raw.githubusercontent.com/scienceverse/metacheck/main/DESCRIPTION
#> 9          https://raw.githubusercontent.com/scienceverse/metacheck/main/LICENSE.md
#> 10          https://raw.githubusercontent.com/scienceverse/metacheck/main/NAMESPACE
#> 11            https://raw.githubusercontent.com/scienceverse/metacheck/main/NEWS.md
#> 12                                                                             <NA>
#> 13          https://raw.githubusercontent.com/scienceverse/metacheck/main/README.md
#> 14   https://raw.githubusercontent.com/scienceverse/metacheck/main/_metacheck.Rproj
#> 15        https://raw.githubusercontent.com/scienceverse/metacheck/main/codecov.yml
#> 16                                                                             <NA>
#> 17                                                                             <NA>
#> 18                                                                             <NA>
#> 19           https://raw.githubusercontent.com/scienceverse/metacheck/main/makefile
#> 20                                                                             <NA>
#> 21                                                                             <NA>
#> 22                                                                             <NA>
#>      size           ext   type
#> 1     376  rbuildignore   file
#> 2    1017 gitattributes   file
#> 3       0        github    dir
#> 4    1394     gitignore config
#> 5       0        vscode    dir
#> 6    5240            md   text
#> 7    6620            md   text
#> 8    3333                 file
#> 9   34303            md   text
#> 10   7191                 file
#> 11 274526            md   text
#> 12      0                  dir
#> 13   1319            md   text
#> 14    462         rproj config
#> 15    134           yml config
#> 16      0                  dir
#> 17      0                  dir
#> 18      0                  dir
#> 19   1407                 file
#> 20      0                  dir
#> 21      0                  dir
#> 22      0                  dir
# }