repols: List GitHub repositories filtered by team
repols is a CLI application that lists GitHub repositories and optionally repository metadata.
Installation
Create a GitHub personal access token. The application reads the value of your token from standard input each time you run it.
The application is available at PyPI. Install it from there using the following command:
pip install repols
You can also install directly from the source code by issuing the following command in the project root:
pip install .
Usage
By default, the application simply outputs a list of repository names. The following command will pipe the list to a file:
repols ORGANISATION TEAM > CSV_FILE
If the include option is used, the application outputs the fields indicated by the user instead. The following example, for instance, will display a list containing the repository names and information on whether the repositories have been archived.
repols --include name --include archived ORGANISATION TEAM > CSV_FILE
Any of the following fields can be included: "archived", "created_at", "description", "name".
The application reads the personal access token from standard input. In the following example the password is piped from a password manager:
pass git-pat | repols ...
Type the following command for more documentation:
repols --help
