/readme-repos-list

๐Ÿ–‡๏ธ GitHub Action to list repositories in a README (fork of readme-repos-list by koj-co)

Primary LanguageTypeScriptMIT LicenseMIT

๐Ÿ–‡๏ธ README Repositories List

GitHub Action to list repositories in a README

Build CI Node CI

โญ 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 list

By 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:
    # run every day at midnight
    - cron: "0 0 * * *"
jobs:
  list:
    runs-on: ubuntu-latest
    steps:
      - name: Run readme-repos-list
        uses: DenverCoderOne/readme-repos-list@v2.0.0
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
          query: "Octocat in:readme"
          max: 5

This will create a README like so:

  • awesome-design-systems - ๐Ÿ’…๐Ÿป โš’ A collection of awesome design systems

  • awesome-kotlin - A curated list of awesome Kotlin related stuff Inspired by awesome-java.

  • Bombers - SMS/Email/Whatsapp/Twitter/Instagram bombers Collection ๐Ÿ’ฃ๐Ÿ’ฃ๐Ÿ’ฃ ๐Ÿ’ฅ Also added collection of some Fake SMS utilities which helps in skip phone number based SMS verification by using a temporary phone number that acts like a proxy.

  • HelloGitHub - :octocat: ๅˆ†ไบซ GitHub ไธŠๆœ‰่ถฃใ€ๅ…ฅ้—จ็บง็š„ๅผ€ๆบ้กน็›ฎใ€‚Share interesting, entry-level open source projects on GitHub.

  • patchwork - All the Git-it Workshop completers!

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:DenverCoder1

Optional 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
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"

๐Ÿ“„ License