Katip

This is a Change Logging gem for a git initialized project.

Katip is a gem which dumps the change log as a list grouped by version tags. It also has an executable ruby file katip, which can be used in any git project. Log rows will contain links to commits, commit note and contributor name.

Installation

To install Katip just use:

gem install katip

When using bundler put it in your Gemfile:

source 'https://rubygems.org'

gem 'katip'

Usage

Using the executable

In your git initialized project directory simply run

  % katip
  Create CHANGELOG.md

If you want to name your log file other than CHANGELOG.md

  % katip MyCustomFile.md
  Create MyCustomFile.md

Also you can easily specify tag ranges:

  % katip --from=0.2.0 --to=0.9.1
  # Or
  % katip --from=0.2.0
  # Or
  % katip --to=0.9.1

Using as a rake

Add gem in your Gemfile:

source 'https://rubygems.org'

gem 'katip'

  % rake katip:create
  Create CHANGELOG.md

If you want to name your log file other than CHANGELOG.md

  % rake katip:create file=MyCustomFile.md
  Create MyCustomFile.md

and that's it. You have your change log file on project root, generated based on your git commits and created release tags.

Sample output

CHANGELOG.md

An unforgettable scene from Yeşilçam

• Wife: Open the door, hey hurry up, Open the door! If you don’t , I will break the door down
• Şakir (performer Şener Şen): take a note, 200 pocket cement, 20 truckland pebble, 15 doors
• Wife: Şakir!
• Şakir: Hey, welcome, 30 trunkland building sand
• Wife: the lowest of the low! rogue! Beneath comtempt guy
• Şakir: What’s up? Why are you shouting?
• Wife: what a shame, don’t answer back. Women chaser! How could you do this to me?
• Şakir: Ooovv. Please don’t start to blame me again
• Wife: Son, Spit in your dad’s face
• Wife: what a poor bitch! The women who steal my husband have not been born yet.

Links to resources

• Disqussion http://stackoverflow.com/questions/7387612/git-changelog-how-to-get-all-changes-up-to-a-specific-tag
• Example bash https://github.com/kandanapp/kandan/blob/master/gen-changelog.sh
• Example output https://github.com/kandanapp/kandan/blob/master/CHANGELOG.md
• https://github.com/pcreux/pimpmychangelog this repo add support github issue and authors

Bugs and Feedback

If you discover any bugs or want to drop a line, feel free to create an issue on GitHub.

http://github.com/lab2023/katip/issues

Contributing

Katip uses TomDoc, rDoc and SemVer, and takes it seriously.

Once you've made your great commits:

1. Fork Template
2. Create a topic branch - git checkout -b my_branch
3. Push to your branch - git push origin my_branch
4. Create a Pull Request from your branch
5. That's it!

Credits

• Katip is maintained and funded by lab2023 - information technologies
• Thank you to all the contributors!
• The names and logos for lab2023 are trademarks of lab2023, inc.

License

Copyright 2014 lab2023 - information technologies