GitHub Cleaner is a Python script for managing your GitHub repositories. With it, you can list all your repositories, archive them, or delete them in bulk by providing a file with the repository names.
Before you run this script, make sure you have:
- Python 3 installed on your system.
requestslibrary installed in your Python environment (pip install requests).- A GitHub Personal Access Token with appropriate permissions (repo for full control of private repositories). See GitHub documentation on how to generate one.
- Clone this repository or download the
clean.pyscript. - Ensure you have the necessary Python version and packages installed.
- Update the script with your GitHub username and personal access token.
The script clean.py can be run with the following commands:
To list all your personal GitHub repositories:
python3 clean.py listTo archive repositories:
python3 clean.py archive -f FILEReplace FILE with the path to a text file containing the full names of the repositories you want to archive, one per line.
To delete repositories:
python3 clean.py delete -f FILEReplace FILE with the path to a text file containing the full names of the repositories you want to delete, one per line.
-h, --help - Show the help message and exit. -f FILE, --file FILE - File containing the list of repositories to process. This is required for the delete and archive actions.
Use With Caution: Deletion and archiving are significant actions. Ensure you want to perform these actions before running the script. Always double-check the list of repositories in your file.
Rate Limits: Be aware of GitHub's rate limits. If you have a large number of repositories, you might need to handle pagination or rate limiting in your script.
Error Handling: The script provided is a basic example. In a production environment, you should implement comprehensive error handling to manage different failure scenarios gracefully. Contributing
If you have a suggestion or improvement, please fork the repository and create a pull request.