feat: GitHub Search

[soar]

Description

Add GitHub Search API to filter repositories before processing

The repository scope can be narrowed down by using the GitHub Search API. This allows you to select repositories based on various criteria, such as language, topics, or other metadata or file content.

• --github-repository-search to select repositories based on the GitHub Repository Search API
• --github-code-search to select repositories based on the GitHub Code Search API
• --github-org still can be used, it will add org:<name> to the search query

If both, --github-repository-search and --github-code-search are provided, the repositories will be filtered by both criteria.

git-xargs \
  --github-org <your-github-org> \
  --github-repository-search "is:private language:go" \
  --github-code-search "filename:Dockerfile ubuntu" \
  "$(pwd)/scripts/update-copyright-year.sh"

TODOs

Read the Gruntwork contribution guidelines.

• Update the docs.
• Run the relevant tests successfully, including pre-commit checks.
• Ensure any 3rd party code adheres with our license policy or delete this line if its not applicable.
• Include release notes. If this PR is backward incompatible, include a migration guide.

Release Notes (draft)

Added GitHub Search API

Migration Guide

[soar]

@eric-Grunt @Resonance1584 Hello! Found you as reviewers in recent PRs. Do you know whom I can ask to review this?

[Resonance1584]

Hi @soar - thanks for your contributions. This looks good overall, please respond to my questions inline in the review to see if we can reduce some duplicated logic.
Please also take a look at select-repos_test.go and see if you can add some test logic to validate the new select logic.

[Resonance1584]

Can we eliminate this function and call getReposByIntersection etc directly from select-repos?

[Resonance1584]

See above - can we call getReposByRepositorySearch directly?