VERSION:0.1.1
Published 7 months ago by @cto.ai
cto.ai/
repo

Repo Op 🚀

Repo is an Op designed to manage a user's repos on Bitbucket, Gitlab, or Github allowing users to archive, create, delete, and list their repos. This Op will require Gitlab and Github users to access their account through a personal access token while Bitbucket uses a username and password combination. This Op can also be used in Slack allowing users to easily perform these functions without having to navigate to the respective websites.

Requirements

To run this or any other Op, install the Ops Platform.

Find information about how to run and build Ops via the Ops Platform Documentation.

This Op uses a personal access token for Github and Gitlab authentication. These can be obtained by following the guides below.

Github Personal Access Token

  • The following scopes need to be selected: repo, delete_repo

Gitlab Personal Access token

  • The following scopes need to be selected: api, read_user, read_repository, write_repository, read_registry

Usage

The very first time you run this Op, you'll want to set up the appropriate secrets so you don't have to manually enter it in each time.

To set secrets, run:

ops secrets:set

Follow the prompts and enter in the name of the key and its value. This will save the secret so it can be accessed the next time you use the Op.

This will set the secret to the team which you're currently on (The default is your personal team which is the same as your username). You can also check which team you're currently on by running:

ops whoami

In order to use the secrets you just set, the Op needs to be published to this team.

To run the public version of the Op in the command line, enter in:

ops run @cto.ai/repo

To run the public version of the Op in a public Slack channel:

/ops run cto.ai/repo

Local Development/Running from Source

1. 👯 Clone the repo:

git clone <git url>

2. 🔨 Navigate into the directory and build the image:

cd repo && ops build . 

3. ⚙️ Run the Op from your current working directory with:

ops run .

4. ⚙️ To publish the Op to your team:

ops publish .

To run the Op in Slack, make sure that you have the CTO.ai Bot installed in your Slack workspace.

To run the Op in a Slack channel, enter: /ops run repo

Debugging Issues

When submitting issues or requesting help, be sure to also include the version information. To get your Ops version run:

ops -v

You can reach us at the CTO.ai Community Slack or email us at [email protected].

Limitations & Future Improvements

Currently, this Op will not work on accounts with company domains.

Future iterations of this Op can include the ability to create issues, list MRs a user is assigned to, and the list goes on.

Contributing

See the Contributing Docs for more information.

Contributors

The following people have contributed to this project:


_juliehuang

LICENSE

MIT