quick-workflow

The shell command based on jira-cli and github-cli for quick work

Two quick commands for streamlined workflow:

1. pr-create: Automatically create a Git branch, submit a PR (Pull Request), capture PR details, link the PR to Jira, and update its status.
2. pr-merge: Automatically merge a PR, delete the Git branch, and update the Jira status in one swift command.

Why use it

Are you tired of the hassle of changing the status every time you create a PR, such as 'code review,' 'merged,' and dealing with repetitive tasks?

Especially when you're busy and have opened multiple browser windows, waiting for pages to load just to complete these mundane tasks can be time-consuming, diverting our focus from more important matters.

Highlighted Benefits:

• Efficiency: Streamline the process by automating status updates and repetitive tasks.
• Time-Saving: Eliminate the need to open multiple browser tabs and wait for pages to load.
• Enhanced Focus: Allow users to concentrate on more crucial tasks.
• Reduced Manual Work: Minimize the need for manual status updates for each PR.
• Standardized Workflow: Ensures a consistent and error-free process.

How to use it

2.0.md Upgradation

Fortunately, we have two powerful tools, github-cli and jira-cli. I use shell scripts to standardize our PR workflow and achieve the above with just one command. You only need to complete the following steps step by step:

1. Install github-cli, here are some verifications, please refer to the official documentation see: https://github.com/cli/cli,

brew install gh

Then need to auth it:

gh auth login

2. use gh command to clone this project to your local computer:

  gh repo clone Wangggym/quick-workflow

3. Install jira-cli, here are some verifications, please refer to the official documentation see: https://github.com/ankitpokhrel/jira-cli

brew tap ankitpokhrel/jira-cli
brew install jira-cli

Then need to auth it:

• Get a Jira API token and export it to your shell as a JIRA_API_TOKEN variable. Add it to your shell configuration file, for instance, $HOME/.bashrc, so that the variable is always available. Alternatively, you can also use .netrc file or keychain to set the token. Learn more here.
• Run jira init, select installation type as Cloud, and provide required details to generate a config file required for the tool.

4. Add global variables and alias to your .zshrc or .bash_profile

vim ~/.zshrc

alias pr-create=/Users/xxx/xxx/quick-workflow/pr-create.sh
alias pr-merge=/Users/xxx/xxx/quick-workflow/pr-merge.sh

export JIRA_SERVICE_ADDRESS=https://xxx.xx # Your Jira network address
export JIRA_API_TOKEN=xxx

# Optional
# Generate the custom branch prefix name
# export GH_BRANCH_PREFIX=xx # xx/jira_ticket--desc
# alias to set proxy
# alias proxy=/Users/xxx/xxx/quick-workflow/check-set-proxy.sh

5. Install jq for shell because we need to deal with JSON structure.

brew install jq

6. Make them to be able to execute:

chmod +x /Users/xxx/xxx/quick-workflow/pr-create.sh
chmod +x /Users/xxx/xxx/quick-workflow/pr-merge.sh

Now you can use it just input pr-create or pr-merge in your command.

Automated Installation

To simplify the installation process, you can use the provided install.sh script. This script will automatically set up the necessary aliases and make all scripts executable. Here's how to use it:

1. Navigate to the quick-workflow directory:

   cd path/to/quick-workflow

2. Make the install script executable:

   chmod +x install.sh

3. Run the install script:

   ./install.sh

The script will:

• Make all .sh files in the directory executable
• Add the following aliases to your shell's rc file (.zshrc for Zsh or .bashrc for Bash) if they don't already exist:
  • qkupdate: For quick updates (linked to get-pr-titile.sh)
  • proxy: For checking and setting proxy (linked to check-set-proxy.sh)
• If an alias already exists, it will be left unchanged
• Provide instructions on how to apply the changes

After running the script, remember to source your rc file or restart your terminal to use the new aliases:

source ~/.zshrc  # For Zsh
# or
source ~/.bashrc  # For Bash

Using the Proxy Alias

The proxy alias is linked to the check-set-proxy.sh script, which helps you check and set up proxy settings. To use it, simply type:

proxy

This command will check your current proxy settings and, if not set, will copy the appropriate proxy command to your clipboard for easy setup.

Updates

See todolist.md, you can see the latest updates and other important info.

Thank you very much for your valuable feedback and PR, let's work together to make these commands better