nntoan/gojira

PHP client for JIRA software based on the Symfony2 Components

GoJIRA, a PHP client for JIRA

, _(*1)

GoJIRA is a PHP client for JIRA based on Symfony2 components:, _(*2)

Gojira works with PHP 5.5.9 or later and is heavily inspired by the Silex web micro-framework by Fabien Potencier., _(*3)

Why this name?

From JIRA team, I think it's funny :), _(*4)

Like all good names in the software industry, it started as an in-house code name., _(*5)

We originally used Bugzilla for bug tracking and the developers in the office started calling it by the Japanese name for Godzilla, Gojira (the original black-and-white Japanese Godzilla films are also office favourites). As we developed our own bug tracker, and then it became an issue tracker, the name stuck, but the Go got dropped - hence JIRA!, _(*6)

Further investigation into the name has revealed that Gorira is Japanese for "gorilla", whilst Kujira is Japanese for "whale". So Gojira is roughly translated to mean "gorilla the size of a whale"! (Thanks to yusuke_arclamp — Oct 2002), _(*7)

For those who care - it sounds best if you yell it loudly, as though charging into battle. C'mon - try it!, _(*8)

Installation

1. Downloads latest GoJIRA. (wget -O /usr/local/bin/jira https://gojira.nntoan.com/get/gojira.phar)
2. Make it executable chmod +x /usr/local/bin/jira

Usage

First use

$ jira
Jira URL: https://jira.atlassian.com/
Username: john.doe
Password: xxxxxxxx

Your top secret information has been sent to our server successfully!

This save your credentials (base64 encoded) in your $HOME/.gorira folder., _(*9)

Help

Usage: jira [options] [command], _(*10)

Commands:, _(*11)

ls [options]           List my issues
start <issue>          Start working on an issue.
stop <issue>           Stop working on an issue.
review <issue> [assignee] Mark issue as being reviewed [by assignee(optional)].
done [options] <issue> Mark issue as finished.
running                List issues in progress.
jql <query>            Run JQL query
search <term>          Find issues.
assign <issue> [user]  Assign an issue to <user>. Provide only issue# to assign to me
comment <issue> [text] Comment an issue.
show [options] <issue> Show info about an issue
open <issue>           Open an issue in a browser
worklogshow <issue>        Show worklog about an issue
worklogadd [options] <issue> <timeSpent> [comment] Log work for an issue
create [project[-issue]] Create an issue or a sub-task
config [options]       Change configuration
sprint [options]       Works with sprint boards
With no arguments, displays all rapid boards
With -r argument, attempt to find a single rapid board and display its active sprints
With both -r and -s arguments attempt to get a single rapidboard/ sprint and show its issues. If a single sprint board isnt found, show all matching sprint boards

Options:, _(*12)

-h, --help     output usage information
-V, --version  output the version number

Each command have individual usage help (using --help or -h), _(*13)

Advanced options

Checkout ~/.gorira/config.json for more options., _(*14)

License

GoJIRA is licensed under the [MIT license][5]., _(*15)