Yaba GitHub Release CLI
Yaba is a simple CLI tool that helps you manage releases of your GitHub projects.
npm in order to run the project on your local environment.
Installing / Updating / Uninstalling
To install CLI package globally:
npm i -g yaba-release-cli
npm update -g yaba-release-cli
npm uninstall -g yaba-release-cli
Create Personal Access Token
Go to Personal Access Tokens page on GitHub and generate new token to
yaba CLI to access your repos.
- Give your desired name to your personal access token with
reposcope is enough to use
Now, your personal access token is generated. Copy that token and define that one as an environment variable:
You can define that env variable into
~/.zshrc file, choose which one is suitable
for you. After defining the env variable, open new terminal or simply run
source ~/.zshrc(here again choose where you
defined your env variable).
If the repository owner is another GitHub account or organisation, you can define that like below instead of passing the owner to the command in every run.
--owner has precedence over authenticated user. Presendence is
-o > GITHUB_REPO_OWNER > authenticated-user.
If you want to announce your release/changelog to the specific Slack channel, you have to define below environment variable with the appropriate value.
Also, multiple hook URLs allowed to be defined like below:
If the above variable is set and the
-p command given while running the command, an announcement will be post to the
given Slack channel. You can find detailed information in the Command Line Usage section.
Command Line Usage
➜ ~ yaba --help Usage: yaba -o <owner> -r <repository> -t <tag> -n <release-name> -b <body> -d <draft> -c <changelog> -i <interactive> -s <sound> -p <publish> Options: -o, --owner The repository owner. [string] -r, --repo The repository name. [string] -t, --tag The name of the tag. [string] -n, --release-name The name of the release. [string] -b, --body Text describing the contents of the tag. If not provided, the default changelog will be generated with the usage of the difference of master and latest release. [string] -d, --draft Creates the release as draft. [boolean] -c, --changelog Shows only changelog without creating the release. [boolean] -i, --interactive Prompt before (draft) release is created (default true) [boolean] -s, --sound Play sound when the release created [boolean] -p, --publish Publishes the release announcement to the defined Slack channel [boolean] -h, --help Show help [boolean] -v, --version Show version number [boolean]
You can run
yaba from a git directory or any other directories which is not a git repo.
If you are in a git repo and if you want to prepare the release for that repo, you don't need to specify the repo name
with the command. The command will automatically detect the current directory and if it is a git repository
use it as
repo for the command.
By default, if you don't specify
-b the command will prepare default values for them with the
-o: authenticated_user -t: prod_global_YYYYMMDD.1 -n: Global release YYYY-MM-DD -b: Commits between last release and master/main branch
💡If you want to bypass the prompt that is before creating the actual release, you can use
-i falseflag. This could be useful if you use
yabain your automation tools.
You have to clone the repository to your local machine
git clone email@example.com:volkanto/yaba.git
Go to project folder
You have to install globally in order to run your
npm install -g .
You can create an issue if you find any problem or feel free to create a PR with a possible fix or any other feature. Also, you can create an issue if you have any idea that you think it will be nice if we have it.
- Volkan Tokmak - volkanto