rrojan / Redlog

Fast and easy-to-use CLI for the Redmine project management tool

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Redlog

Redlog is a fast and easy-to-use CLI for the Redmine project management tool.

Teams spend hours every week struggling to navigate around Redmine's clunky UI. With redlog, managing your Redmine issues can be as easy as running a simple command from your terminal.

Installation

Add this line to your application's Gemfile:

gem 'redlog'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install redlog

Usage

If you're using redlog for the first time (or changing your user), set up redlog to with your username, password and redmine server url.

redlog setup

Create issue and log time for issue

redlog '[title]' -l [log-time-in-hours]

Example:

redlog 'ABC-123: Fix XYZ drop-down not working' -l 1.5

This creates a new issue by the title "ABC-123: Fix XYZ drop-down not working" and logs time spent of 1.5 hours into it.

redlog '[title]' -d [description] -l [log-time-in-hours]

This adds a description for the issue (inside quotes)

Defaults:

The default tracker for issue is "Bug". Default assignee is "<< << Me >> >>"(your user). Default status is "In Progress".

You can optionally change any of these using the flags --[bug/feature/support/design/estimation] --assign [assignee-username] and -- [in-progress/resolved/feedback/closed]

Example:

redlog "Add XYZ to ABC" -l 3 --feature --assign another_username --feedback

Changing default preferences

Redlog assumes some defaults to allow for a faster user experience. You can change these at any time by running:

redlog preferences

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/rrojan/redlog.

License

The gem is available as open source under the terms of the MIT License.

About

Fast and easy-to-use CLI for the Redmine project management tool

License:MIT License


Languages

Language:Ruby 98.5%Language:Shell 1.5%