1.3.2 • Published 5 years ago
readme-repos-list v1.3.2
🖇️ README Repositories List
GitHub Action to list repositories in a README
⭐ Usage
You can create your README.md file with some comments, where this action will add a list of repositories:
This is my fancy README
<!-- start: YOUR_STARTER -->...the list will be added here...<!-- end: YOUR_STARTER -->
Your README continues after the listBy default, "readme-repos-list" is the value for YOUR_STARTER. Then, add the workflow which runs, for example, every day:
name: README Repos List
on:
  schedule:
    - cron: "0 0 * * 1"
jobs:
  list:
    runs-on: ubuntu-latest
    steps:
      - name: Run readme-repos-list
        uses: koj-co/readme-repos-list@master
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
          query: "Octocat in:readme"
          max: 10This will create a README like so:
Inputs
token (required)
Your GitHub token or personal access token. If you don't have a bot account, you should use the default ${{ secrets.GITHUB_TOKEN }}.
query (required)
Search query used to find repositories. See Constructing a search query on GitHub Docs for more information. An example query can look like:
Octocat in:readme user:koj-coOptional inputs
| Input | Description | 
|---|---|
owner | Owner of repository to commit to | 
repo | Name of repository to commit to | 
max | Maximum number of repositories to list | 
prefix | Content to add before the list | 
weserv-query | Image manipulation query parameters | 
no-homepage | Link to repository, not homepage | 
suffix | Content to add at the end of the list | 
path | Path to file to update with content | 
start | Starting comment to look for | 
end | Ending comment | 
commit-message | Updating file commit message | 
one-per-owner | Show only one repo per owner | 
sort | Sort repositories by this parameter | 
order | Order by "asc" or "desc" |