Jira-Flow

Jira-Flow is a CLI tool designed to link git commits with JIRA issues.

Installation

Using NPM (or any other package manager)

npm install -g jira-flow

From Source

To install Jira-Flow from source, including all associated binaries (jiraflow, commitmsg, postco), follow these steps:

1. Clone the repository:

   git clone https://github.com/JaleelB/jira-flow.git
   cd jira-flow

2. Build the project (assuming Go is installed):

   go build -o jiraflow ./cmd/jiraflow/main.go
   go build -o commitmsg ./hooks/commitmsg/main.go
   go build -o postco ./hooks/postco/main.go

3. Optionally, install the binary to a location in your PATH:

   sudo mv jiraflow /usr/local/bin
   sudo mv commitmsg /usr/local/bin
   sudo mv postco /usr/local/bin

   On Windows, move the .exe files to a directory that is included in your PATH.

Manual Installation

If you prefer not to use npm, you can manually download the binaries from the GitHub Releases page.

1. Navigate to the Releases page of Jira-Flow.
2. Download the appropriate binary for your operating system and architecture.
3. Extract the downloaded archive and place the binary in a directory included in your system's PATH.

For example, on Unix-like systems:

tar -zxvf jiraflow_vX.X.X_os_arch.tar.gz
sudo mv jiraflow /usr/local/bin
tar -zxvf commitmsg_vX.X.X_os_arch.tar.gz
sudo mv commitmsg /usr/local/bin
tar -zxvf postco_vX.X.X_os_arch.tar.gz
sudo mv postco /usr/local/bin

On Windows, extract the files and add the folder to your PATH using the environment settings.

Usage

Once installed, you can start using Jira-Flow with the following command:

jira-flow init

A Quick Example

Here's a glimpse of how Jira-Flow will work:

# Running Jira-Flow for the first time in a repository
$ jira-flow init

# The interactive CLI will present the user with a menu:
1. Auto-detect JIRA issue key from branch name.
2. Manually enter the JIRA issue key.

# User selects option 1 and the tool configures the Git hook automatically.

Once set up, Jira-Flow will prepend commit messages with the JIRA issue key, either detected from the branch name or entered manually, enhancing the integration between the developer's code repository and the JIRA tracking system.

Linking Commits to JIRA Issues

For more information on how JIRA issue keys can be used to reference issues in your development work, including commits, branches, and pull requests, see the official Atlassian documentation.

Contributing

• Fork the repository
• Create a branch

  git checkout -b fix/amazingFix

• Commit your changes and push to your branch

  git commit -m "made an amazingFix"
  git push origin fix/amazingFix

• Open a pull request