githubsecrets 0.0.2

A simple CLI to manage GitHub secrets, that are used with GitHub Actions

github-secrets

A simple CLI to manage GitHub secrets, that are used with GitHub Actions

Requirements

• Python v3.6.9 and above

• POSIX - Linux, macOS or Windows with Git Bash

Installation

pip

Available at PyPi

$ pip install githubsecrets

Getting Started

1. Initialize this application - Creates credentials files at ~/.githubsecrets/credentials

   $ ghs init
   

2. Create a GitHub Personal-Access-Token with the following permssions:

   • repo (all)
   • admin:public_key > read:public_key

3. Save the token in a safe place, we'll use it in a second

4. Create a profile

   $ ghs profile-apply -p willy_wonka
   ...
   SUCCESS: Applied the profile willy_wonka
   

   You'll be prompted to insert:

   • Github owner- which is your GitHub Organization or GitHub Account name
   • Personal access token - that you've created in the previous steps

5. Create a GitHub secret

   ghs secret-apply -p willy_wonka -r github-secrets
   

   You'll be prompted to insert:

   • Secret name
   • Secret value

Status codes

• 200 - success
• 204 - success
• 404 - secret or repository not found

Available commands

View all available commands with ghs --help

Usage: ghs [OPTIONS] COMMAND [ARGS]...

All commands can run without providing options, and then you'll be
prompted to insert values.

Secrets' values and Personal-Access-Tokens are hidden when prompted

Options:
--help Show this message and exit.

Commands:
init Create a credentials file to store your profiles
profile-apply Create or modify a profile
profile-delete Delete a profile
profile-list List all profile - truncates personal access tokens
secret-apply Create or modify a secret in a GitHub repository
secret-delete Delete a secret in a GitHub repository
secret-get Get a secret from a GitHub repository
secret-list List all secret in a GitHub repository

Contributing

Report issues/questions/feature requests on in the Issues section.

Pull requests are welcome! Ideally, create a feature branch and issue for every single change you make. These are the steps:

1. Fork this repo
2. Create your feature branch from master (git checkout -b my-new-feature)
3. Commit your remarkable changes (git commit -am 'Added some feature')
4. Push to the branch (git push --set-up-stream origin my-new-feature)
5. Create a new Pull Request and tell us about your changes

Authors

Created and maintained by Meir Gabay

License

This project is licensed under the MIT License - see the LICENSE file for details