README

External JIRA smart commiter built with Laravel Zero.

How it works

• run manually or lachunched via task scheduler(crontab, windows task manager, etc...)
• connect DVCS Repository(gitlab, github, bitbucket, etc...) and check out new commit and scan commit message .
• commenting and status transition on the relative jira issue.

Pros

• Support gitlab integration with smart commit.
• Don't need DVCS commit hook.
• Don't need JIRA DVCS Connector settings per project.
• Customizable smart commit keyword and workflow.

Cons

• Need PHP
• to many jira issue comment.

Requirements

• PHP >= 7.1 with bottom extensions.
  • sqlite
  • curl
• php jira-rest-client
• laravel zero

Installation

Build from Source

1. clone repository

   git clone https://github.com/lesstif/jira-smart-commiter.git && cd jira-smart-commiter

2. install composer dependency

   composer install

3. Perform an application build

   php jira-smart-commiter app:build jira-smart-commiter.phar    

   you can find built binary in builds directory.

download

Recommended method

1. download pre-built binary

   using wget

   wget https://github.com/lesstif/jira-smart-commiter/releases/download/0.1-alpha/jira-smart-commiter.phar

   using curl

   curl -k -L -O https://github.com/lesstif/jira-smart-commiter/releases/download/0.1-alpha/jira-smart-commiter.phar

2. change mod

   chmod +x jira-smart-commiter.phar

Usage

1. generate initial configuration

   php jira-smart-commiter.phar init

2. change DVCS Info(URL, Type and API Version) field and JIRA Server Info in the $HOME/.smartcommit/settings.json file.

   vim ~/.smartcommit/settings.json

3. generate dvcs project list.* $HOME/.smartcommit/projects.json*:

    php jira-smart-commiter.phar project:create-list

4. fetch commit & sync to JIRA.

    php jira-smart-commiter.phar fetch:commit --since=DATETIMEString --until=DATETIMEString

See also

• https://confluence.atlassian.com/adminjiraserver/enable-smart-commits-938846894.html
• https://docs.gitlab.com/ee/user/project/integrations/jira.html