whathappened 0.2.0

A changelog generator using simply structured git commit messages.

whathappened

A changelog generator using simply structured git commit messages

Inspired by

• SemVer
• Angular Commit Message Format
• Auto Changelog
• git_commits.py

Install and Run

Installation is as simple as it gets:

$ pip install whathappened

To generate a changelog, run:

$ whathappened

Make sure to activate any virtual envrionment that you might be using first.

Package Changelog

Created by Whathappened itself - very meta.

For the complete changelog, please see CHANGELOG.md.

Whathappened Commit Message Format

Whathappened expects git commit messages in the format outlined below:

[optional breaking ]<type>[ optional (<scope>)]: <description>

[optional body]

<type> is recommended to be one of:

fix
feat
build
ci
docs
style
refactor
perf
test

<scope> is recommended to be a module, file, or folder name as appropiate.

For a nice summary of types and what they mean, please see Understanding Semantic Commit Messages Using Git and Angular.

Examples

All of the examples below are acceptable commit message formats:

The simplest message:

style: isn't it neat

Defining scope:

docs(gadgets): remember the gizmos

Signalling a breaking change

breaking feat: add the whozits

Defining scope, including a space:

fix (whatsits): repair the thingamabobs

Multiple lines:

test: How many have I got?

I've got twenty
But who cares?

I want more

For more examples, please see whathappened's own commits.