============
gitchangelog
============
.. image:: https://img.shields.io/pypi/v/gitchangelog.svg?style=flat
:target: https://pypi.python.org/pypi/gitchangelog/
:alt: Latest PyPI version
.. image:: https://img.shields.io/pypi/dm/gitchangelog.svg?style=flat
:target: https://pypi.python.org/pypi/gitchangelog/
:alt: Number of PyPI downloads
.. image:: https://img.shields.io/travis/vaab/gitchangelog/master.svg?style=flat
:target: https://travis-ci.org/vaab/gitchangelog/
:alt: Travis CI build status
.. image:: https://img.shields.io/appveyor/ci/vaab/gitchangelog.svg
:target: https://ci.appveyor.com/project/vaab/gitchangelog/branch/master
:alt: Appveyor CI build status
.. image:: https://img.shields.io/codecov/c/github/vaab/gitchangelog.svg
:target: https://codecov.io/gh/vaab/gitchangelog
:alt: Test coverage
Use your commit log to make beautifull and configurable changelog file.
Feature
=======
- fully driven by a config file that can be tailored with your changelog
policies. (see for example the `reference configuration file`_)
- filter out commits/tags based on regexp matching
- refactor commit summary, or commit body on the fly with replace regexp
- classify commit message into sections (ie: New, Fix, Changes...)
- any output format supported thanks to templating, you can even choose
your own preferred template engine (mako, mustache, full python ...).
- support your merge or rebase workflows and complicated git histories
- support full or incremental changelog generation to match your needs.
- support easy access to `trailers key values`_ (if you use them)
- support of multi-authors for one commit through ``Co-Authored-By`` `trailers key values`_
- support standard python installation or dep-free single executable.
(this last feature is not yet completely pain free to use on Windows)
.. _trailers key values: https://git.wiki.kernel.org/index.php/CommitMessageConventions
Requirements
============
``gitchangelog`` is compatible Python 2 and Python 3 on
Linux/BSD/MacOSX and Windows.
Please submit an issue if you encounter incompatibilities.
Installation
============
full package
------------
Gitchangelog is published on PyPI, thus:
pip install gitchangelog
\.. is the way to go for install the full package on any platform.
If you are installing from source, please note that the development tools
are not working fully yet on Windows.
The full package provides the ``gitchangelog.py`` executable as long as:
- a `reference configuration file`_ that provides system wide defaults for
all values.
- some example templates in ``mustache`` and ``mako`` templating
engine's language. Ideal to bootstrap your variations.
from source
-----------
If you'd rather work from the source repository, it supports the common
idiom to install it on your system::
python setup.py install
Note that for linux/BSD, there's a link to the executable in the root of the
source. This can be a convenient way to work on the source version.
single executable installation
------------------------------
The file ``gitchangelog.py`` is a full blown executable and can be used
without any other files. This is easier to use naturally on Linux/BSD
systems. For instance, you could type in::
curl -sSL https://raw.githubusercontent.com/vaab/gitchangelog/master/src/gitchangelog/gitchangelog.py > /usr/local/bin/gitchangelog &&
chmod +x /usr/local/bin/gitchangelog
It'll install ``gitchangelog`` to be accessible for all users and will
use the default python interpreter of your running session.
Please note: if you choose to install it in this standalone mode, then
you must make sure to value at least all the required configuration
keys in your config file. As a good start you should probably copy the
`reference configuration file`_ as you base configuration file.
This is due to the fact that ``gitchangelog`` can not anymore reach
the reference configuration file to get default values.
Sample
======
The default output is ReSTructured text, so it should be readable in ASCII.
Here is a small sample of the ``gitchangelog`` changelog at work.
Current ``git log`` output so you can get an idea of the log history::
* 59f902a Valentin Lab new: dev: sections in changelog are now in the order given in ``gitchangelog.rc`` in the ``section_regexps`` option. (0.1.2)
* c6f72cc Valentin Lab chg: dev: commented code to toggle doctest mode.
* a9c38f3 Valentin Lab fix: dev: doctests were failing on this.
* 59524e6 Valentin Lab new: usr: added ``body_split_regexp`` option to attempts to format correctly body of commit.
* 5883f07 Valentin Lab new: usr: use a list of tuple instead of a dict for ``section_regexps`` to be able to manage order between section on find match.
* 7c1d480 Valentin Lab new: dev: new ``unreleased_version_label`` option in ``gitchangelog.rc`` to change label of not yet released code.
* cf29c9c Valentin Lab fix: dev: bad sorting of tags (alphanumerical). Changed to commit date sort.
* 61d8f80 Valentin Lab fix: dev: support of empty commit message.
* eeca31b Valentin Lab new: dev: use ``gitchangelog`` section in ``git config`` world appropriately.
* 6142b71 Valentin Lab chg: dev: cosmetic removal of trailing whitespaces
* 3c3edd5 Valentin Lab fix: usr: ``git`` in later versions seems to fail on ``git config <key>`` with errlvl 255, that was not supported.
* 3f9617d Valentin Lab fix: usr: removed Traceback when there were no tags at all in the current git repository.
* e0db9ae Valentin Lab new: usr: added section classifiers (ie: New, Change, Bugs) and updated the sample rc file. (0.1.1)
* 0c66d59 Valentin Lab fix: dev: Fixed case where exception was thrown if two tags are on the same commit.
* d2fae0d Valentin Lab new: usr: added a succint ``--help`` support.
And here is the ``gitchangelog`` output::
0.1.2 (2011-05-17)
------------------
New
~~~
- Sections in changelog are now in the order given in ``git-
changelog.rc`` in the ``section_regexps`` option. [Valentin Lab]
- Added ``body_split_regexp`` option to attempts to format correctly
body of commit. [Valentin Lab]
- Use a list of tuple instead of a dict for ``section_regexps`` to be
able to manage order between section on find match. [Valentin Lab]
- New ``unreleased_version_label`` option in ``gitchangelog.rc`` to
change label of not yet released code. [Valentin Lab]
- Use ``gitchangelog`` section in ``git config`` world appropriately.
[Valentin Lab]
Changes
~~~~~~~
- Commented code to toggle doctest mode. [Valentin Lab]
- Cosmetic removal of trailing whitespaces. [Valentin Lab]
Fix
~~~
- Doctests were failing on this. [Valentin Lab]
- Bad sorting of tags (alphanumerical). Changed to commit date sort.
[Valentin Lab]
- Support of empty commit message. [Valentin Lab]
- ``git`` in later versions seems to fail on ``git config <key>`` with
errlvl 255, that was not supported. [Valentin Lab]
- Removed Traceback when there were no tags at all in the current git
repository. [Valentin Lab]
0.1.1 (2011-04-07)
------------------
New
~~~
- Added section classifiers (ie: New, Change, Bugs) and updated the
sample rc file. [Valentin Lab]
- Added a succint ``--help`` support. [Valentin Lab]
Fix
~~~
- Fixed case where exception was thrown if two tags are on the same
commit. [Valentin Lab]
And the rendered full result is directly used to generate the HTML webpage of
the `changelog of the PyPI page`_.
Usage
=====
The `reference configuration file`_ is delivered within
``gitchangelog`` package and is used to provides defaults to
settings. If you didn't install the package and used the standalone
file, then chances are that ``gitchangelog`` can't access these
defaults values. This is not a problem as long as you provided all the
required values in your config file.
The recommended location for ``gitchangelog`` config file is the root
of the current git repository with the name ``.gitchangelog.rc``.
However you could put it elsewhere, and here are the locations checked
(first match will prevail):
- in the path given thanks to the environment variable
``GITCHANGELOG_CONFIG_FILENAME``
- in the path stored in git config's entry ``gitchangelog.rc-path`` (which
could be stored in system location or per repository)
- (RECOMMENDED) in the root of the current git repository with the name
``.gitchangelog.rc``
Then, you'll be able to call ``gitchangelog`` in a GIT repository and it'll
print changelog on its standard output.
Configuration file format
-------------------------
The `reference configuration file`_ is quite heavily commented and is quite
simple. You should be able to use it as required.
.. _reference configuration file: https://github.com/vaab/gitchangelog/blob/master/src/gitchangelog/gitchangelog.rc.reference
The changelog of gitchangelog is generated with himself and with the reference
configuration file. You'll see the output in the `changelog of the PyPI page`_.
.. _changelog of the PyPI page: http://pypi.python.org/pypi/gitchangelog
Output Engines
--------------
At the end of the configuration file, you'll notice a variable called
``output_engine``. By default, it's set to ``rest_py``, which is the
legacy python engine to produce the `ReSTructured Text` output format
that is shown in above samples. If this engine fits your needs, you
won't need to fiddle with this option.
To render the template, ``gitchangelog`` will generate a data structure that
will then be rendered thanks to the output engine. This should help you get
the exact output that you need.
As people might have different needs and knowledge, a templating
system using ``mustache`` is available. ``mustache`` templates are
provided to render both `ReSTructured Text` or `markdown` formats. If
you know ``mustache`` templating, then you could easily add or modify
these existing templates.
A ``mako`` templating engine is also provided. You'll find also a ``mako``
template producing the same `ReSTructured Text` output than the legacy one.
It's provided for reference and/or further tweak if you would rather use `mako`_
templates.
Mustache
~~~~~~~~
The ``mustache`` output engine uses `mustache templates`_.
The `mustache`_ templates are powered via `pystache`_ the python
implementation of the `mustache`_ specifications. So `mustache`_ output engine
will only be available if you have `pystache`_ module available in your python
environment.
There are `mustache templates`_ bundled with the default installation
of gitchangelog. These can be called by providing a simple label to the
``mustache(..)`` output_engine, for instance (in your ``.gitchangelog.rc``)::
output_engine = mustache("markdown")
Or you could provide your own mustache template by specifying an
absolute path (or a relative one, starting from the git toplevel of
your project by default, or if set, the
``git config gitchangelog.template-path``
location) to your template file, for instance::
output_engine = mustache(".gitchangelog.tpl")
And feel free to copy the bundled templates to use them as bases for
your own variations. In the source code, these are located in
``src/gitchangelog/templates/mustache`` directory, once installed they
are in ``templates/mustache`` directory starting from where your
``gitchangelog.py`` was installed.
.. _mustache: http://mustache.github.io
.. _pystache: https://pypi.python.org/pypi/pystache
.. _mustache templates: http://mustache.github.io/mustache.5.html
Mako
~~~~
The ``makotemplate`` output engine templates for ``gitchangelog`` are
powered via `mako`_ python templating system. So `mako`_ output engine
will only be available if you have `mako`_ module available in your
python environment.
There are `mako`_ templates bundled with the default installation
of gitchangelog. These can be called by providing a simple label to the
``makotemplate(..)`` output_engine, for instance (in your ``.gitchangelog.rc``)::
output_engine = makotemplate("markdown")
Or you could provide your own mustache template by specifying an
absolute path (or a relative one, starting from the git toplevel of
your project by default, or if set, the
``git config gitchangelog.template-path``
location) to your template file, for instance::
output_engine = makotemplate(".gitchangelog.tpl")
And feel free to copy the bundled templates to use them as bases for
your own variations. In the source code, these are located in
``src/gitchangelog/templates/mako`` directory, once installed they
are in ``templates/mako`` directory starting from where your
``gitchangelog.py`` was installed.
.. _mako: http://www.makotemplates.org
Changelog data tree
~~~~~~~~~~~~~~~~~~~
This is a sample of the current data structure sent to output engines::
{'title': 'Changelog',
'versions': [{'label': '%%version%% (unreleased)',
'date': None,
'tag': None
'sections': [{'label': 'Changes',
'commits': [{'author': 'John doe',
'body': '',
'subject': 'Adding some extra values.'},
{'author': 'John Doe',
'body': '',
'subject': 'Some more changes'}]},
{'label': 'Other',
'commits': [{'author': 'Jim Foo',
'body': '',
'subject': 'classic modification'},
{'author': 'Jane Done',
'body': '',
'subject': 'Adding some stuff to do.'}]}]},
{'label': 'v0.2.5 (2013-08-06)',
'date': '2013-08-06',
'tag': 'v0.2.5'
'sections': [{'commits': [{'author': 'John Doe',
'body': '',
'subject': 'Updating Changelog installation.'}],
'label': 'Changes'}]}]}
Merged branches history support
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Commit attribution to a specific version could be tricky. Suppose you have
this typical merge tree (spot the tags!)::
* new: something (HEAD, tag: 0.2, develop)
* Merge tag '0.1.1' into develop
|\
| * fix: out-of-band hotfix (tag: 0.1.1)
* | chg: continued development
|/
* fix: something (tag: 0.1)
* first commit (tag: 0.0.1, master)
Here's a minimal draft of gitchangelog to show how commit are
attributed to versions::
0.2
* new: something.
* Merge tag '0.1.1' into develop.
* chg: continued development.
0.1.1
* fix: out-of-band hotfix.
0.1
* fix: something.
.. note:: you can remove automatically all merge commit from
gitchangelog output by using ``include_merge = False`` in the
``.gitchangelog.rc`` file.
Use cases
=========
No sectionning
--------------
If you want to remove sectionning but keep anything else, you should
probably use::
section_regexps = [
('', None)
]
subject_process = (strip | ucfirst | final_dot)
This will disable sectionning and won't remove the prefixes
used for sectionning from the commit's summary.
Incremental changelog
---------------------
Also known as partial changelog generation, this feature allows to
generate only a subpart of your changelog, and combined with
configurable publishing actions, you can insert the result inside
an existing changelog. Usually this makes sense:
- When wanting to switch to ``gitchangelog``, or change your
conventions:
- part of your history is not following conventions.
- you have a previous CHANGELOG you want to blend in.
- You'd rather commit changes to your changelog file for each release:
- For performance reason, you can then generate changelog only for
the new commit and save the result.
- Because you want to be able to edit it to make some minor
edition if needed.
Generating partial changelog is as simple as ``gitchangelog
REVLIST``. Examples follows::
## will output only tags between 0.0.2 (excluded) and 0.0.3 (included)
gitchangelog 0.0.2..0.0.3
## will output only tags since 0.0.3 (excluded)
gitchangelog ^0.0.3 HEAD
## will output all tags up to 0.0.3 (included)
gitchangelog 0.0.3
Additionally, ``gitchangelog`` can figure out automatically which
revision is the last for you (with some little help). This is done by
specifying the ``revs`` config option. This config file option will be
used as if specified on the command line.
Here is an example that fits the current changelog format::
revs = [
Caret(
FileFirstRegexMatch(
"CHANGELOG.rst",
r"(?P<rev>[0-9]+\.[0-9]+(\.[0-9]+))\s+\([0-9]+-[0-9]{2}-[0-9]{2}\)\n--+\n")),
]
This will look into the file ``CHANGELOG.rst`` for the first match of
the given regex and return the match of the ``rev`` regex sub-pattern
it as a string. The ``Caret`` function will simply prefix the given
string with a ``^``. As a consequence, this code will prevent
recreating any previously generated changelog section (more information
about the `REVLIST syntax`_ from ``git rev-list`` arguments.)
.. _REVLIST syntax: https://git-scm.com/docs/git-rev-list#_description
Note that the data structure provided to the template will set the
``title`` to ``None`` if you provided no REVLIST through command-line
or the config file (or if the revlist was equivalently set to
``["HEAD", ]``). This a good way to make your template detect it is
in "incremental mode".
By default, this will only output to standard output the new sections
of your changelog, you might want to insert it directly in your existing
changelog. This is where ``publish`` parameters will help you. By default
it is set to ``stdout``, and you might want to set it to::
publish = FileInsertIntoFirstRegexMatch(
"CHANGELOG.rst",
r'/(?P<rev>[0-9]+\.[0-9]+(\.[0-9]+)?)\s+\([0-9]+-[0-9]{2}-[0-9]{2}\)\n--+\n/',
idx=lambda m: m.start(1)
)
The full recipe could be::
OUTPUT_FILE = "CHANGELOG.rst"
INSERT_POINT = r"\b(?P<rev>[0-9]+\.[0-9]+)\s+\([0-9]+-[0-9]{2}-[0-9]{2}\)\n--+\n"
revs = [
Caret(FileFirstRegexMatch(OUTPUT_FILE, INSERT_POINT)),
"HEAD"
]
action = FileInsertAtFirstRegexMatch(
OUTPUT_FILE, INSERT_POINT,
idx=lambda m: m.start(1)
)
Alternatively, you can use this other recipe, using ``FileRegexSubst``, that has
the added advantage of being able to update the unreleased part if you had it already
generated and need a re-fresh because you added new commits or amended some commits::
OUTPUT_FILE = "CHANGELOG.rst"
INSERT_POINT_REGEX = r'''(?isxu)
^
(
\s*Changelog\s*(\n|\r\n|\r) ## ``Changelog`` line
==+\s*(\n|\r\n|\r){2} ## ``=========`` rest underline
)
( ## Match all between changelog and release rev
(
(?!
(?<=(\n|\r)) ## look back for newline
%(rev)s ## revision
\s+
\([0-9]+-[0-9]{2}-[0-9]{2}\)(\n|\r\n|\r) ## date
--+(\n|\r\n|\r) ## ``---`` underline
)
.
)*
)
(?P<rev>%(rev)s)
''' % {'rev': r"[0-9]+\.[0-9]+(\.[0-9]+)?"}
revs = [
Caret(FileFirstRegexMatch(OUTPUT_FILE, INSERT_POINT_REGEX)),
"HEAD"
]
publish = FileRegexSubst(OUTPUT_FILE, INSERT_POINT_REGEX, r"\1\o\g<rev>")
As a second example, here is the same recipe for mustache markdown format::
OUTPUT_FILE = "CHANGELOG.rst"
INSERT_POINT_REGEX = r'''(?isxu)
^
(
\s*\#\s+Changelog\s*(\n|\r\n|\r) ## ``Changelog`` line
)
( ## Match all between changelog and release rev
(
(?!
(?<=(\n|\r)) ## look back for newline
\#\#\s+%(rev)s ## revision
\s+
\([0-9]+-[0-9]{2}-[0-9]{2}\)(\n|\r\n|\r) ## date
)
.
)*
)
(?P<tail>\#\#\s+(?P<rev>%(rev)s))
''' % {'rev': r"[0-9]+\.[0-9]+(\.[0-9]+)?"}
revs = [
Caret(FileFirstRegexMatch(OUTPUT_FILE, INSERT_POINT_REGEX)),
"HEAD"
]
publish = FileRegexSubst(OUTPUT_FILE, INSERT_POINT_REGEX, r"\1\o\n\g<tail>")
Contributing
============
Any suggestion or issue is welcome. Push request are very welcome,
please check out the guidelines.
Push Request Guidelines
-----------------------
You can send any code. I'll look at it and will integrate it myself in
the code base while leaving you as the commit(s) author. This process
can take time and it'll take less time if you follow the following
guidelines:
- check your code with PEP8 or pylint. Try to stick to 80 columns wide.
- separate your commits per smallest concern
- each functionality/bugfix commit should contain the code, tests,
and doc.
- each commit should pass the tests (to allow easy bisect)
- prior minor commit with typographic or code cosmetic changes are
very welcome. These should be tagged in their commit summary with
``!minor``.
- the commit message should follow gitchangelog rules (check the git
log to get examples)
- if the commit fixes an issue or finished the implementation of a
feature, please mention it in the summary.
If you have some questions about guidelines which is not answered here,
please check the current ``git log``, you might find previous commit that
would show you how to deal with your issue. Otherwise, just send your PR
and ask your question. I won't bite. Promise.
License
=======
Copyright (c) 2012-2018 Valentin Lab.
Licensed under the `BSD License`_.
.. _BSD License: http://raw.github.com/vaab/gitchangelog/master/LICENSE
Changelog
=========
3.0.4 (2018-03-17)
------------------
Fix
~~~
- Conform to PEP479 as required by python 3.7 (fixes #101) [Valentin
Lab]
3.0.3 (2017-04-23)
------------------
Fix
~~~
- API cli change not documented about implicit ``HEAD`` removed in
revision list specifier. (fixes #81) [Valentin Lab]
In 2.5.1, ``gitchangelog show ^3.0.0`` command would implicitly add a
``HEAD`` in the revlist specifiers, effectively being equivalent to
``0.0.3..HEAD``.
This behavior is removed in 3.0.0+ to stick to ``git rev-list REVLIST``
syntax. As a consequence, ``gitchangelog ^3.0.0`` won't select any
revision and thus will cast an error about no commits matching revlist.
3.0.2 (2017-04-21)
------------------
Fix
~~~
- [mustache/markdown] template is now compatible with incremental
changelog generation patterns. (fixes #80) [Valentin Lab]
3.0.1 (2017-03-17)
------------------
Fix
~~~
- Support of commits with empty message. (fixes #76) [Valentin Lab]
3.0.0 (2017-03-17)
------------------
New
~~~
- Template path can now be specified in ``git config``. (fixes #73)
[Valentin Lab]
- Added ``FileRegexSubst`` to allow updatable incremental recipe.
[Valentin Lab]
With the added function and recipe as an example, you can update a
current unreleased changelog additionaly to the traditional incremental
behavior. ``FileRegexSubst`` might prove itself to be more powerfull
tahn ``FileInsertAtFirstRegexMatch`` if you handle fairly complex regexes.
- Configurable ``publish`` action to allow more automated changelog
scenarios (fixes #39) [Valentin Lab]
In particular, projects using incremental changelog generation can now
fully automate the process by using a ``publish`` action that inserts
new sections in an existing changelog file.
- ``unreleased_version_label`` can now be computed on the fly. [Valentin
Lab]
This can let you rename the first section about non yet tagged commit
more precisely. For instance by using the commit hash or any git
property.
- Full tested windows support added. [Valentin Lab]
- Reference config file is not anymore required. (fixes #54) [Valentin
Lab]
- New ``revs`` config file option allowing dynamically setting target
rev-list. (fixes #61) [Valentin Lab]
With this option, incremental changelog become more streamlined. With
prior behavior, you had to know which was the last version prior to
calling ``gitchangelog``. Now, calling ``gitchangelog`` alone can generate
the exact last missing part thanks to this new config option.
- Templates now support direct path to files (fixes #46, fixes #63).
[Héctor Pablos, Valentin Lab]
Note that relative paths will be searched from the git toplevel.
- Provide helpers to integrate ``Co-Authored-By`` trailer value. (fixes
#69) [Valentin Lab]
You can use now ``commit["authors"]`` in templates to get a list of all
authors of a commit. See the mako template ``restructuredtext.tpl`` for
example of usage. Mustache templates gets also their own baked in joined
list of authors through ``commit["author_names_joined"]``.
- Provide complete access on commit API to templates (fixes #18)
[Valentin Lab]
- Supports trailer key values support. [Valentin Lab]
- Windows compatibility. [Jean-Baptiste Lab, Laurent LAPORTE, Michele,
Valentin Lab]
Changes
~~~~~~~
- Use tagger date when tags are annotated instead of commit date. (fixes
#60) [Valentin Lab]
- Removed the need of the ``show`` positional argument. [Valentin Lab]
- Suppression of the obsolete ``gitchangelog init`` command. [Valentin
Lab]
Fix
~~~
- Support closed or closing pipes on gitchangelog's stdout gracefully.
[Valentin Lab]
Python would output some angry comments for instance when using::
gitchangelog | head
Now it is much more graceful and will let the process finish earlier
without complaining.
- Revlist would not work as expected on windows. [Valentin Lab]
Windows does not support single quotes in command line as linux
does. Fortunately there is no requirements on singles quotes so they
were removed everywhere, ensuring a better windows compatibility.
- Using revlists could display unwanted commits or no commits. [Valentin
Lab]
This was happening when specifying revisions that didn't match
commits tagged by tags matching the ``tag_filter_regexp``.
- Ability to specify rev-lists for partial changelogs creation was not
working on windows. [Valentin Lab]
- Encoding issues prevented log to be outputed on specific windows
versions. [Valentin Lab]
- Fixed encoding issue when reading UTF-8 git logs with a different
default locale. [Valentin Lab]
Windows platform were more likely to get hit by this bug as their
default code page is not ``utf-8``. It was fixed by using an explicit
encoding when reading git logs. The default value for this encoding
can now be set in the ``gitchangelog``'s config file, per-repository.
Although, this option should be only set in pathological configuration
as the default behavior is to use ``git config i18n.logOutputEncoding``
when set, or if not set, ``utf-8``, which is the default log encoding
of git.
2.5.1 (2015-11-11)
------------------
Fix
~~~
- Reference config is used for defaults. [Tuukka Mustonen]
- Error message when called in non-git directories was not correctly
displayed on python 3. [Valentin Lab]
- ``--debug`` argument would generate command line arguments parsing
errors on python 2.7. (fixes #66) [Valentin Lab]
2.5.0 (2016-10-16)
------------------
New
~~~
- Hide unexpected traceback per default and allow them to be displayed
if wanted. [Valentin Lab]
- New lines fixes in current default ReST format (fixes #62) [Stavros
Korokithakis]
These were modified:
- no new line between list element, except when there's some
body message to display, then use only one new line at the
beginning of the body to issues with possible lists in body.
- one new line before section titles.
- two new lines before versions titles.
Fix
~~~
- Output warning on stderr in some weird cases (fixes #52) [Valentin
Lab]
If no tag are found in the repository, or no tag matches the filter
regex, or if all commits are ignored... this will lead to disturbing but
legit outputs from ``gitchangelog``. So as to help diagnose what is
going on, additional warnings are then printed when edge cases are
encountered.
- [mustache/restructuredtext] avoid HTML-escaping content of variables
(fixes #64) [Mark Milstein]
2.4.0 (2015-11-10)
------------------
New
~~~
- Add optional positional argument ``REVLIST`` to allow incremental
changelog output (fixes #26) [Valentin Lab]
See use cases documentations for more information.
2.3.0 (2015-09-25)
------------------
Fix
~~~
- Nasty hidden bug that would break python3 (fixes #27) [Valentin Lab]
Actually this bug was revealed by python3 random hashes (thanks to
@rschoon for the hint) and could be reproduced on python2.7 with ``-R``
mode.
The ``git show`` command actually will behave differently if given a tag
reference and print random unexpected information before using the
format string. This would prefix a lot of mess to the first field being
asked in the format string.
And this first field is dependent on the internal order of a dict, and
this order is not important as such, and so nothing was done on this
part.
On python2.7, somehow, it would always be the same order that revealed
to have no consequence (probably one of the rare field not used in
current changelogs).
Python3 or Python2.7 -R would shuffle this order and then trigger the
error whenever this prefix would be appended to actually important
fields that went into some further processing (as casted to int for
the timestamp for instance).
2.2.1 (2015-06-09)
------------------
Fix
~~~
- Fix: doc: ``ìnclude_merge`` options was wrongly typed in sample config
files (reported by @tuukkamustonen, fixed #29). [Valentin Lab]
- Updated doc to reflec that there are no support of windows for now.
(fixes #28) [Valentin Lab]
Actually windows will fail on ``subprocess`` call. (see #28)
- Remove commit's meta-information footer from changelog output. (fixes
#25) [Valentin Lab]
Some various tools (thinking of Gerrit) might leave some
meta-information in the footer of your commit message's body that you do
not want to be repeated in your changelog. So all values in the footer
are removed (This concerns ``Change-Id``, ``Acked-by``, ``CC``,
``Signed-off-by``, ``Bug`` ... and any other value).
2.2.0 (2015-01-27)
------------------
New
~~~
- Provide support for older config file format. [Valentin Lab]
- Added 'octobercms-plugin' mako template. (fixes #16) [Valentin Lab]
- Added ``body_process`` and ``subject_process`` options. (fixes #22)
[Valentin Lab]
These options superseeds ``replace_regexps`` and ``body_split_regexp``
as they provide a full control over text transformation of the subject
or the body of the commit before they get included in the changelog.
- Added ``include_merge`` option to filter out merge commit. [Casey
Duquette]
Changes
~~~~~~~
- Produce a more linear commit history (fixes #14) [Casey Duquette]
Instead of retrieving the git log ordered by date, retrieve the log as
a difference between tags to produce a more accurate view of changes
between releases.
For instance, imagine this git graph::
* 6c0fd62 (HEAD, tag: sprint-6, origin/smoke, smoke, develop)
* 5292a28 Merge back to develop
|\
| * 6612fce (tag: sprint-5.1, origin/master, origin/HEAD, master) super important hotfix
* | 7d6286f more development work
* | 8c1e3d6 continued development work
* | fa3d4bd development work
|/
* ec1a19c (tag: sprint-5)
Previously, commits ``fa3d4bd``, ``8c1e3d6``, ``7d6286f`` that
occurred on the develop branch before the hotfix that led to tagging
``sprint-5.1``, were captured in the changelog under release
``sprint-5.1`` because of the order of the commits. But it is obvious
that these commits were not included in a release until
``sprint-6``. The new method of calculating the changelog will capture
this and reflect it properly, assigning those changes to ``sprint-6``.
Fix
~~~
- Last commit was omitted (fixes #23). [Valentin Lab]
- Bogus messages when template didn't exist. [Valentin Lab]
Refactored out the common code and corrected the bad error message.
- Removed hypothetical memory exhaust while parsing ``git log``.
[Valentin Lab]
Parse stdout as it's produced by git log by chunks.
2.1.2 (2014-04-25)
------------------
Fix
~~~
- Fail with error message when config path exists but is not a file.
(fixes #11) [Casey Duquette]
For example, the config file could be a directory.
2.1.1 (2014-04-15)
------------------
Fix
~~~
- Removed exception if you had file which name that matched a tag's
name. (fixes #9) [Valentin Lab]
2.1.0 (2014-03-25)
------------------
New
~~~
- Python3 compatibility. [Valentin Lab]
- Much greater performance on big repository by issuing only one shell
command for all the commits. (fixes #7) [Valentin Lab]
- Add ``init`` argument to create a full ``.gitchangelog.rc`` in current
git repository. [Valentin Lab]
- Remove optional first argument that could specify the target git
repository to consider. [Valentin Lab]
This is to remove duplicate way to do things. ``gitchangelog`` should be run
from within a git repository.
Any usage of ``gitchangelog MYREPO`` can be written ``(cd MYREPO;
gitchangelog)``.
- Use a standard formatting configuration by default. [Valentin Lab]
A default `standard` way of formatting is used if you don't provide
any configuration file. Additionaly, any option you define in your
configuration file will be added "on-top" of the default configuration
values. This can reduce config file size or even remove the need of
one if you follow the standard.
And, thus, you can tweak the standard for your needs by providing only partial
configuration file. See tests for examples.
- Remove user or system wide configuration file lookup. [Valentin Lab]
This follows reflexion that you build a changelog for a repository and
that the rules to make the changelog should definitively be explicit and
thus belongs to the repository itself.
Not a justification, but removing user and system wide configuration files
also greatly simplifies testability.
Fix
~~~
- Encoding issues with non-ascii chars. [Valentin Lab]
- Avoid using pipes for windows compatibility and be more performant by
avoiding to unroll full log to get the last commit. [Valentin Lab]
- Better support of exotic features of git config file format. (fixes
#4) [Valentin Lab]
git config file format allows ambiguous keys:
[a "b.c"]
d = foo
[a.b "c"]
e = foo
[a.b.c]
f = foo
Are all valid. So code was simplified to use directly ``git config``.
This simplification will deal also with cases where section could be
attributed values:
[a "b"]
c = foo
[a]
b = foo
By avoiding to parse the entire content of the file, and relying on
``git config`` implementation we ensure to remain compatible and not
re-implement the parsing of this file format.
- Gitchangelog shouldn't fail if it fails to parse your git config.
[Michael Hahn]
2.0.0 (2013-08-20)
------------------
New
~~~
- Added a ``mako`` output engine with standard ReSTructured text format
for reference. [Valentin Lab]
- Added some information on path lookup scheme to find
``gitchangelog.rc`` configuration file. [Valentin Lab]
- Added templating system and examples with ``mustache`` template
support for restructured text and markdown output format. [David
Loureiro]
Changes
~~~~~~~
- Removed ``pkg`` and ``dev`` commits from default sample changelog
output. [Valentin Lab]
Fix
~~~
- Some error message weren't written on stderr. [Valentin Lab]
1.1.0 (2012-05-03)
------------------
New
~~~
- New config file lookup scheme which adds a new possible default
location ``.gitchangelog.rc`` in the root of the git repository.
[Valentin Lab]
- Added a new section to get a direct visual of ``gitchangelog`` output.
Reworded some sentences and did some other minor additions. [Valentin
Lab]
Changes
~~~~~~~
- Removed old ``gitchangelog.rc.sample`` in favor of the new documented
one. [Valentin Lab]
Fix
~~~
- The sample file was not coherent with the doc, and is now accepting
'test' and 'doc' audience. [Valentin Lab]
1.0.2 (2012-05-02)
------------------
New
~~~
- Added a new sample file heavily documented. [Valentin Lab]
Fix
~~~
- ``ignore_regexps`` where bogus and would match only from the beginning
of the line. [Valentin Lab]
- Display author date rather than commit date. [Valentin Lab]
0.1.2 (2011-06-29)
------------------
New
~~~
- Added ``body_split_regexp`` option to attempts to format correctly
body of commit. [Valentin Lab]
- Use a list of tuple instead of a dict for ``section_regexps`` to be
able to manage order between section on find match. [Valentin Lab]
Fix
~~~
- ``git`` in later versions seems to fail on ``git config <key>`` with
errlvl 255, that was not supported. [Valentin Lab]
- Removed Traceback when there were no tags at all in the current git
repository. [Valentin Lab]
0.1.1 (2011-06-29)
------------------
New
~~~
- Added section classifiers (ie: New, Change, Bugs) and updated the
sample rc file. [Valentin Lab]
- Added a succint ``--help`` support. [Valentin Lab]
Raw data
{
"_id": null,
"home_page": "http://github.com/vaab/gitchangelog",
"name": "gitchangelog",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Valentin LAB",
"author_email": "valentin.lab@kalysto.org",
"download_url": "https://files.pythonhosted.org/packages/12/e3/9b5c8f1c80a675da2bba0a131427273f255d6e8fa767553f30f2bdf1d557/gitchangelog-3.0.4.tar.gz",
"platform": "",
"description": "============\ngitchangelog\n============\n\n.. image:: https://img.shields.io/pypi/v/gitchangelog.svg?style=flat\n :target: https://pypi.python.org/pypi/gitchangelog/\n :alt: Latest PyPI version\n\n.. image:: https://img.shields.io/pypi/dm/gitchangelog.svg?style=flat\n :target: https://pypi.python.org/pypi/gitchangelog/\n :alt: Number of PyPI downloads\n\n.. image:: https://img.shields.io/travis/vaab/gitchangelog/master.svg?style=flat\n :target: https://travis-ci.org/vaab/gitchangelog/\n :alt: Travis CI build status\n\n.. image:: https://img.shields.io/appveyor/ci/vaab/gitchangelog.svg\n :target: https://ci.appveyor.com/project/vaab/gitchangelog/branch/master\n :alt: Appveyor CI build status\n\n.. image:: https://img.shields.io/codecov/c/github/vaab/gitchangelog.svg\n :target: https://codecov.io/gh/vaab/gitchangelog\n :alt: Test coverage\n\n\nUse your commit log to make beautifull and configurable changelog file.\n\n\nFeature\n=======\n\n- fully driven by a config file that can be tailored with your changelog\n policies. (see for example the `reference configuration file`_)\n- filter out commits/tags based on regexp matching\n- refactor commit summary, or commit body on the fly with replace regexp\n- classify commit message into sections (ie: New, Fix, Changes...)\n- any output format supported thanks to templating, you can even choose\n your own preferred template engine (mako, mustache, full python ...).\n- support your merge or rebase workflows and complicated git histories\n- support full or incremental changelog generation to match your needs.\n- support easy access to `trailers key values`_ (if you use them)\n- support of multi-authors for one commit through ``Co-Authored-By`` `trailers key values`_\n- support standard python installation or dep-free single executable.\n (this last feature is not yet completely pain free to use on Windows)\n\n.. _trailers key values: https://git.wiki.kernel.org/index.php/CommitMessageConventions\n\n\nRequirements\n============\n\n``gitchangelog`` is compatible Python 2 and Python 3 on\nLinux/BSD/MacOSX and Windows.\n\nPlease submit an issue if you encounter incompatibilities.\n\n\nInstallation\n============\n\n\nfull package\n------------\n\nGitchangelog is published on PyPI, thus:\n\n pip install gitchangelog\n\n\\.. is the way to go for install the full package on any platform.\n\nIf you are installing from source, please note that the development tools\nare not working fully yet on Windows.\n\nThe full package provides the ``gitchangelog.py`` executable as long as:\n\n- a `reference configuration file`_ that provides system wide defaults for\n all values.\n- some example templates in ``mustache`` and ``mako`` templating\n engine's language. Ideal to bootstrap your variations.\n\n\nfrom source\n-----------\n\nIf you'd rather work from the source repository, it supports the common\nidiom to install it on your system::\n\n python setup.py install\n\nNote that for linux/BSD, there's a link to the executable in the root of the\nsource. This can be a convenient way to work on the source version.\n\n\nsingle executable installation\n------------------------------\n\nThe file ``gitchangelog.py`` is a full blown executable and can be used\nwithout any other files. This is easier to use naturally on Linux/BSD\nsystems. For instance, you could type in::\n\n curl -sSL https://raw.githubusercontent.com/vaab/gitchangelog/master/src/gitchangelog/gitchangelog.py > /usr/local/bin/gitchangelog &&\n chmod +x /usr/local/bin/gitchangelog\n\nIt'll install ``gitchangelog`` to be accessible for all users and will\nuse the default python interpreter of your running session.\n\nPlease note: if you choose to install it in this standalone mode, then\nyou must make sure to value at least all the required configuration\nkeys in your config file. As a good start you should probably copy the\n`reference configuration file`_ as you base configuration file.\n\nThis is due to the fact that ``gitchangelog`` can not anymore reach\nthe reference configuration file to get default values.\n\n\nSample\n======\n\nThe default output is ReSTructured text, so it should be readable in ASCII.\n\nHere is a small sample of the ``gitchangelog`` changelog at work.\n\nCurrent ``git log`` output so you can get an idea of the log history::\n\n * 59f902a Valentin Lab new: dev: sections in changelog are now in the order given in ``gitchangelog.rc`` in the ``section_regexps`` option. (0.1.2)\n * c6f72cc Valentin Lab chg: dev: commented code to toggle doctest mode.\n * a9c38f3 Valentin Lab fix: dev: doctests were failing on this.\n * 59524e6 Valentin Lab new: usr: added ``body_split_regexp`` option to attempts to format correctly body of commit.\n * 5883f07 Valentin Lab new: usr: use a list of tuple instead of a dict for ``section_regexps`` to be able to manage order between section on find match.\n * 7c1d480 Valentin Lab new: dev: new ``unreleased_version_label`` option in ``gitchangelog.rc`` to change label of not yet released code.\n * cf29c9c Valentin Lab fix: dev: bad sorting of tags (alphanumerical). Changed to commit date sort.\n * 61d8f80 Valentin Lab fix: dev: support of empty commit message.\n * eeca31b Valentin Lab new: dev: use ``gitchangelog`` section in ``git config`` world appropriately.\n * 6142b71 Valentin Lab chg: dev: cosmetic removal of trailing whitespaces\n * 3c3edd5 Valentin Lab fix: usr: ``git`` in later versions seems to fail on ``git config <key>`` with errlvl 255, that was not supported.\n * 3f9617d Valentin Lab fix: usr: removed Traceback when there were no tags at all in the current git repository.\n * e0db9ae Valentin Lab new: usr: added section classifiers (ie: New, Change, Bugs) and updated the sample rc file. (0.1.1)\n * 0c66d59 Valentin Lab fix: dev: Fixed case where exception was thrown if two tags are on the same commit.\n * d2fae0d Valentin Lab new: usr: added a succint ``--help`` support.\n\nAnd here is the ``gitchangelog`` output::\n\n 0.1.2 (2011-05-17)\n ------------------\n\n New\n ~~~\n - Sections in changelog are now in the order given in ``git-\n changelog.rc`` in the ``section_regexps`` option. [Valentin Lab]\n - Added ``body_split_regexp`` option to attempts to format correctly\n body of commit. [Valentin Lab]\n - Use a list of tuple instead of a dict for ``section_regexps`` to be\n able to manage order between section on find match. [Valentin Lab]\n - New ``unreleased_version_label`` option in ``gitchangelog.rc`` to\n change label of not yet released code. [Valentin Lab]\n - Use ``gitchangelog`` section in ``git config`` world appropriately.\n [Valentin Lab]\n\n Changes\n ~~~~~~~\n - Commented code to toggle doctest mode. [Valentin Lab]\n - Cosmetic removal of trailing whitespaces. [Valentin Lab]\n\n Fix\n ~~~\n - Doctests were failing on this. [Valentin Lab]\n - Bad sorting of tags (alphanumerical). Changed to commit date sort.\n [Valentin Lab]\n - Support of empty commit message. [Valentin Lab]\n - ``git`` in later versions seems to fail on ``git config <key>`` with\n errlvl 255, that was not supported. [Valentin Lab]\n - Removed Traceback when there were no tags at all in the current git\n repository. [Valentin Lab]\n\n\n 0.1.1 (2011-04-07)\n ------------------\n\n New\n ~~~\n - Added section classifiers (ie: New, Change, Bugs) and updated the\n sample rc file. [Valentin Lab]\n - Added a succint ``--help`` support. [Valentin Lab]\n\n Fix\n ~~~\n - Fixed case where exception was thrown if two tags are on the same\n commit. [Valentin Lab]\n\nAnd the rendered full result is directly used to generate the HTML webpage of\nthe `changelog of the PyPI page`_.\n\n\nUsage\n=====\n\nThe `reference configuration file`_ is delivered within\n``gitchangelog`` package and is used to provides defaults to\nsettings. If you didn't install the package and used the standalone\nfile, then chances are that ``gitchangelog`` can't access these\ndefaults values. This is not a problem as long as you provided all the\nrequired values in your config file.\n\nThe recommended location for ``gitchangelog`` config file is the root\nof the current git repository with the name ``.gitchangelog.rc``.\nHowever you could put it elsewhere, and here are the locations checked\n(first match will prevail):\n\n- in the path given thanks to the environment variable\n ``GITCHANGELOG_CONFIG_FILENAME``\n- in the path stored in git config's entry ``gitchangelog.rc-path`` (which\n could be stored in system location or per repository)\n- (RECOMMENDED) in the root of the current git repository with the name\n ``.gitchangelog.rc``\n\nThen, you'll be able to call ``gitchangelog`` in a GIT repository and it'll\nprint changelog on its standard output.\n\n\nConfiguration file format\n-------------------------\n\nThe `reference configuration file`_ is quite heavily commented and is quite\nsimple. You should be able to use it as required.\n\n.. _reference configuration file: https://github.com/vaab/gitchangelog/blob/master/src/gitchangelog/gitchangelog.rc.reference\n\nThe changelog of gitchangelog is generated with himself and with the reference\nconfiguration file. You'll see the output in the `changelog of the PyPI page`_.\n\n.. _changelog of the PyPI page: http://pypi.python.org/pypi/gitchangelog\n\n\nOutput Engines\n--------------\n\nAt the end of the configuration file, you'll notice a variable called\n``output_engine``. By default, it's set to ``rest_py``, which is the\nlegacy python engine to produce the `ReSTructured Text` output format\nthat is shown in above samples. If this engine fits your needs, you\nwon't need to fiddle with this option.\n\nTo render the template, ``gitchangelog`` will generate a data structure that\nwill then be rendered thanks to the output engine. This should help you get\nthe exact output that you need.\n\nAs people might have different needs and knowledge, a templating\nsystem using ``mustache`` is available. ``mustache`` templates are\nprovided to render both `ReSTructured Text` or `markdown` formats. If\nyou know ``mustache`` templating, then you could easily add or modify\nthese existing templates.\n\nA ``mako`` templating engine is also provided. You'll find also a ``mako``\ntemplate producing the same `ReSTructured Text` output than the legacy one.\nIt's provided for reference and/or further tweak if you would rather use `mako`_\ntemplates.\n\n\nMustache\n~~~~~~~~\n\nThe ``mustache`` output engine uses `mustache templates`_.\n\nThe `mustache`_ templates are powered via `pystache`_ the python\nimplementation of the `mustache`_ specifications. So `mustache`_ output engine\nwill only be available if you have `pystache`_ module available in your python\nenvironment.\n\nThere are `mustache templates`_ bundled with the default installation\nof gitchangelog. These can be called by providing a simple label to the\n``mustache(..)`` output_engine, for instance (in your ``.gitchangelog.rc``)::\n\n output_engine = mustache(\"markdown\")\n\nOr you could provide your own mustache template by specifying an\nabsolute path (or a relative one, starting from the git toplevel of\nyour project by default, or if set, the\n``git config gitchangelog.template-path``\nlocation) to your template file, for instance::\n\n output_engine = mustache(\".gitchangelog.tpl\")\n\nAnd feel free to copy the bundled templates to use them as bases for\nyour own variations. In the source code, these are located in\n``src/gitchangelog/templates/mustache`` directory, once installed they\nare in ``templates/mustache`` directory starting from where your\n``gitchangelog.py`` was installed.\n\n\n.. _mustache: http://mustache.github.io\n.. _pystache: https://pypi.python.org/pypi/pystache\n.. _mustache templates: http://mustache.github.io/mustache.5.html\n\n\nMako\n~~~~\n\nThe ``makotemplate`` output engine templates for ``gitchangelog`` are\npowered via `mako`_ python templating system. So `mako`_ output engine\nwill only be available if you have `mako`_ module available in your\npython environment.\n\nThere are `mako`_ templates bundled with the default installation\nof gitchangelog. These can be called by providing a simple label to the\n``makotemplate(..)`` output_engine, for instance (in your ``.gitchangelog.rc``)::\n\n output_engine = makotemplate(\"markdown\")\n\nOr you could provide your own mustache template by specifying an\nabsolute path (or a relative one, starting from the git toplevel of\nyour project by default, or if set, the\n``git config gitchangelog.template-path``\nlocation) to your template file, for instance::\n\n output_engine = makotemplate(\".gitchangelog.tpl\")\n\nAnd feel free to copy the bundled templates to use them as bases for\nyour own variations. In the source code, these are located in\n``src/gitchangelog/templates/mako`` directory, once installed they\nare in ``templates/mako`` directory starting from where your\n``gitchangelog.py`` was installed.\n\n.. _mako: http://www.makotemplates.org\n\n\nChangelog data tree\n~~~~~~~~~~~~~~~~~~~\n\nThis is a sample of the current data structure sent to output engines::\n\n {'title': 'Changelog',\n 'versions': [{'label': '%%version%% (unreleased)',\n 'date': None,\n 'tag': None\n 'sections': [{'label': 'Changes',\n 'commits': [{'author': 'John doe',\n 'body': '',\n 'subject': 'Adding some extra values.'},\n {'author': 'John Doe',\n 'body': '',\n 'subject': 'Some more changes'}]},\n {'label': 'Other',\n 'commits': [{'author': 'Jim Foo',\n 'body': '',\n 'subject': 'classic modification'},\n {'author': 'Jane Done',\n 'body': '',\n 'subject': 'Adding some stuff to do.'}]}]},\n {'label': 'v0.2.5 (2013-08-06)',\n 'date': '2013-08-06',\n 'tag': 'v0.2.5'\n 'sections': [{'commits': [{'author': 'John Doe',\n 'body': '',\n 'subject': 'Updating Changelog installation.'}],\n 'label': 'Changes'}]}]}\n\n\nMerged branches history support\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nCommit attribution to a specific version could be tricky. Suppose you have\nthis typical merge tree (spot the tags!)::\n\n * new: something (HEAD, tag: 0.2, develop)\n * Merge tag '0.1.1' into develop\n |\\\n | * fix: out-of-band hotfix (tag: 0.1.1)\n * | chg: continued development\n |/\n * fix: something (tag: 0.1)\n * first commit (tag: 0.0.1, master)\n\nHere's a minimal draft of gitchangelog to show how commit are\nattributed to versions::\n\n 0.2\n * new: something.\n * Merge tag '0.1.1' into develop.\n * chg: continued development.\n\n 0.1.1\n * fix: out-of-band hotfix.\n\n 0.1\n * fix: something.\n\n\n.. note:: you can remove automatically all merge commit from\n gitchangelog output by using ``include_merge = False`` in the\n ``.gitchangelog.rc`` file.\n\n\nUse cases\n=========\n\n\nNo sectionning\n--------------\n\nIf you want to remove sectionning but keep anything else, you should\nprobably use::\n\n section_regexps = [\n ('', None)\n ]\n\n subject_process = (strip | ucfirst | final_dot)\n\nThis will disable sectionning and won't remove the prefixes\nused for sectionning from the commit's summary.\n\n\nIncremental changelog\n---------------------\n\nAlso known as partial changelog generation, this feature allows to\ngenerate only a subpart of your changelog, and combined with\nconfigurable publishing actions, you can insert the result inside\nan existing changelog. Usually this makes sense:\n\n- When wanting to switch to ``gitchangelog``, or change your\n conventions:\n\n - part of your history is not following conventions.\n - you have a previous CHANGELOG you want to blend in.\n\n- You'd rather commit changes to your changelog file for each release:\n\n - For performance reason, you can then generate changelog only for\n the new commit and save the result.\n - Because you want to be able to edit it to make some minor\n edition if needed.\n\n\nGenerating partial changelog is as simple as ``gitchangelog\nREVLIST``. Examples follows::\n\n ## will output only tags between 0.0.2 (excluded) and 0.0.3 (included)\n gitchangelog 0.0.2..0.0.3\n\n ## will output only tags since 0.0.3 (excluded)\n gitchangelog ^0.0.3 HEAD\n\n ## will output all tags up to 0.0.3 (included)\n gitchangelog 0.0.3\n\n\nAdditionally, ``gitchangelog`` can figure out automatically which\nrevision is the last for you (with some little help). This is done by\nspecifying the ``revs`` config option. This config file option will be\nused as if specified on the command line.\n\nHere is an example that fits the current changelog format::\n\n revs = [\n Caret(\n FileFirstRegexMatch(\n \t \"CHANGELOG.rst\",\n \t r\"(?P<rev>[0-9]+\\.[0-9]+(\\.[0-9]+))\\s+\\([0-9]+-[0-9]{2}-[0-9]{2}\\)\\n--+\\n\")),\n ]\n\nThis will look into the file ``CHANGELOG.rst`` for the first match of\nthe given regex and return the match of the ``rev`` regex sub-pattern\nit as a string. The ``Caret`` function will simply prefix the given\nstring with a ``^``. As a consequence, this code will prevent\nrecreating any previously generated changelog section (more information\nabout the `REVLIST syntax`_ from ``git rev-list`` arguments.)\n\n.. _REVLIST syntax: https://git-scm.com/docs/git-rev-list#_description\n\nNote that the data structure provided to the template will set the\n``title`` to ``None`` if you provided no REVLIST through command-line\nor the config file (or if the revlist was equivalently set to\n``[\"HEAD\", ]``). This a good way to make your template detect it is\nin \"incremental mode\".\n\nBy default, this will only output to standard output the new sections\nof your changelog, you might want to insert it directly in your existing\nchangelog. This is where ``publish`` parameters will help you. By default\nit is set to ``stdout``, and you might want to set it to::\n\n publish = FileInsertIntoFirstRegexMatch(\n \"CHANGELOG.rst\",\n r'/(?P<rev>[0-9]+\\.[0-9]+(\\.[0-9]+)?)\\s+\\([0-9]+-[0-9]{2}-[0-9]{2}\\)\\n--+\\n/',\n idx=lambda m: m.start(1)\n )\n\nThe full recipe could be::\n\n OUTPUT_FILE = \"CHANGELOG.rst\"\n INSERT_POINT = r\"\\b(?P<rev>[0-9]+\\.[0-9]+)\\s+\\([0-9]+-[0-9]{2}-[0-9]{2}\\)\\n--+\\n\"\n revs = [\n Caret(FileFirstRegexMatch(OUTPUT_FILE, INSERT_POINT)),\n \"HEAD\"\n ]\n\n action = FileInsertAtFirstRegexMatch(\n OUTPUT_FILE, INSERT_POINT,\n idx=lambda m: m.start(1)\n )\n\n\nAlternatively, you can use this other recipe, using ``FileRegexSubst``, that has\nthe added advantage of being able to update the unreleased part if you had it already\ngenerated and need a re-fresh because you added new commits or amended some commits::\n\n OUTPUT_FILE = \"CHANGELOG.rst\"\n INSERT_POINT_REGEX = r'''(?isxu)\n ^\n (\n \\s*Changelog\\s*(\\n|\\r\\n|\\r) ## ``Changelog`` line\n ==+\\s*(\\n|\\r\\n|\\r){2} ## ``=========`` rest underline\n )\n\n ( ## Match all between changelog and release rev\n (\n (?!\n (?<=(\\n|\\r)) ## look back for newline\n %(rev)s ## revision\n \\s+\n \\([0-9]+-[0-9]{2}-[0-9]{2}\\)(\\n|\\r\\n|\\r) ## date\n --+(\\n|\\r\\n|\\r) ## ``---`` underline\n )\n .\n )*\n )\n\n (?P<rev>%(rev)s)\n ''' % {'rev': r\"[0-9]+\\.[0-9]+(\\.[0-9]+)?\"}\n\n revs = [\n Caret(FileFirstRegexMatch(OUTPUT_FILE, INSERT_POINT_REGEX)),\n \"HEAD\"\n ]\n\n publish = FileRegexSubst(OUTPUT_FILE, INSERT_POINT_REGEX, r\"\\1\\o\\g<rev>\")\n\n\nAs a second example, here is the same recipe for mustache markdown format::\n\n OUTPUT_FILE = \"CHANGELOG.rst\"\n INSERT_POINT_REGEX = r'''(?isxu)\n ^\n (\n \\s*\\#\\s+Changelog\\s*(\\n|\\r\\n|\\r) ## ``Changelog`` line\n )\n\n ( ## Match all between changelog and release rev\n (\n (?!\n (?<=(\\n|\\r)) ## look back for newline\n \\#\\#\\s+%(rev)s ## revision\n \\s+\n \\([0-9]+-[0-9]{2}-[0-9]{2}\\)(\\n|\\r\\n|\\r) ## date\n )\n .\n )*\n )\n\n (?P<tail>\\#\\#\\s+(?P<rev>%(rev)s))\n ''' % {'rev': r\"[0-9]+\\.[0-9]+(\\.[0-9]+)?\"}\n\n revs = [\n Caret(FileFirstRegexMatch(OUTPUT_FILE, INSERT_POINT_REGEX)),\n \"HEAD\"\n ]\n\n publish = FileRegexSubst(OUTPUT_FILE, INSERT_POINT_REGEX, r\"\\1\\o\\n\\g<tail>\")\n\n\nContributing\n============\n\nAny suggestion or issue is welcome. Push request are very welcome,\nplease check out the guidelines.\n\n\nPush Request Guidelines\n-----------------------\n\nYou can send any code. I'll look at it and will integrate it myself in\nthe code base while leaving you as the commit(s) author. This process\ncan take time and it'll take less time if you follow the following\nguidelines:\n\n- check your code with PEP8 or pylint. Try to stick to 80 columns wide.\n- separate your commits per smallest concern\n- each functionality/bugfix commit should contain the code, tests,\n and doc.\n- each commit should pass the tests (to allow easy bisect)\n- prior minor commit with typographic or code cosmetic changes are\n very welcome. These should be tagged in their commit summary with\n ``!minor``.\n- the commit message should follow gitchangelog rules (check the git\n log to get examples)\n- if the commit fixes an issue or finished the implementation of a\n feature, please mention it in the summary.\n\nIf you have some questions about guidelines which is not answered here,\nplease check the current ``git log``, you might find previous commit that\nwould show you how to deal with your issue. Otherwise, just send your PR\nand ask your question. I won't bite. Promise.\n\n\nLicense\n=======\n\nCopyright (c) 2012-2018 Valentin Lab.\n\nLicensed under the `BSD License`_.\n\n.. _BSD License: http://raw.github.com/vaab/gitchangelog/master/LICENSE\n\nChangelog\n=========\n\n\n3.0.4 (2018-03-17)\n------------------\n\nFix\n~~~\n- Conform to PEP479 as required by python 3.7 (fixes #101) [Valentin\n Lab]\n\n\n3.0.3 (2017-04-23)\n------------------\n\nFix\n~~~\n- API cli change not documented about implicit ``HEAD`` removed in\n revision list specifier. (fixes #81) [Valentin Lab]\n\n In 2.5.1, ``gitchangelog show ^3.0.0`` command would implicitly add a\n ``HEAD`` in the revlist specifiers, effectively being equivalent to\n ``0.0.3..HEAD``.\n\n This behavior is removed in 3.0.0+ to stick to ``git rev-list REVLIST``\n syntax. As a consequence, ``gitchangelog ^3.0.0`` won't select any\n revision and thus will cast an error about no commits matching revlist.\n\n\n3.0.2 (2017-04-21)\n------------------\n\nFix\n~~~\n- [mustache/markdown] template is now compatible with incremental\n changelog generation patterns. (fixes #80) [Valentin Lab]\n\n\n3.0.1 (2017-03-17)\n------------------\n\nFix\n~~~\n- Support of commits with empty message. (fixes #76) [Valentin Lab]\n\n\n3.0.0 (2017-03-17)\n------------------\n\nNew\n~~~\n- Template path can now be specified in ``git config``. (fixes #73)\n [Valentin Lab]\n- Added ``FileRegexSubst`` to allow updatable incremental recipe.\n [Valentin Lab]\n\n With the added function and recipe as an example, you can update a\n current unreleased changelog additionaly to the traditional incremental\n behavior. ``FileRegexSubst`` might prove itself to be more powerfull\n tahn ``FileInsertAtFirstRegexMatch`` if you handle fairly complex regexes.\n- Configurable ``publish`` action to allow more automated changelog\n scenarios (fixes #39) [Valentin Lab]\n\n In particular, projects using incremental changelog generation can now\n fully automate the process by using a ``publish`` action that inserts\n new sections in an existing changelog file.\n- ``unreleased_version_label`` can now be computed on the fly. [Valentin\n Lab]\n\n This can let you rename the first section about non yet tagged commit\n more precisely. For instance by using the commit hash or any git\n property.\n- Full tested windows support added. [Valentin Lab]\n- Reference config file is not anymore required. (fixes #54) [Valentin\n Lab]\n- New ``revs`` config file option allowing dynamically setting target\n rev-list. (fixes #61) [Valentin Lab]\n\n With this option, incremental changelog become more streamlined. With\n prior behavior, you had to know which was the last version prior to\n calling ``gitchangelog``. Now, calling ``gitchangelog`` alone can generate\n the exact last missing part thanks to this new config option.\n- Templates now support direct path to files (fixes #46, fixes #63).\n [He\u0301ctor Pablos, Valentin Lab]\n\n Note that relative paths will be searched from the git toplevel.\n- Provide helpers to integrate ``Co-Authored-By`` trailer value. (fixes\n #69) [Valentin Lab]\n\n You can use now ``commit[\"authors\"]`` in templates to get a list of all\n authors of a commit. See the mako template ``restructuredtext.tpl`` for\n example of usage. Mustache templates gets also their own baked in joined\n list of authors through ``commit[\"author_names_joined\"]``.\n- Provide complete access on commit API to templates (fixes #18)\n [Valentin Lab]\n- Supports trailer key values support. [Valentin Lab]\n- Windows compatibility. [Jean-Baptiste Lab, Laurent LAPORTE, Michele,\n Valentin Lab]\n\nChanges\n~~~~~~~\n- Use tagger date when tags are annotated instead of commit date. (fixes\n #60) [Valentin Lab]\n- Removed the need of the ``show`` positional argument. [Valentin Lab]\n- Suppression of the obsolete ``gitchangelog init`` command. [Valentin\n Lab]\n\nFix\n~~~\n- Support closed or closing pipes on gitchangelog's stdout gracefully.\n [Valentin Lab]\n\n Python would output some angry comments for instance when using::\n\n gitchangelog | head\n\n Now it is much more graceful and will let the process finish earlier\n without complaining.\n- Revlist would not work as expected on windows. [Valentin Lab]\n\n Windows does not support single quotes in command line as linux\n does. Fortunately there is no requirements on singles quotes so they\n were removed everywhere, ensuring a better windows compatibility.\n- Using revlists could display unwanted commits or no commits. [Valentin\n Lab]\n\n This was happening when specifying revisions that didn't match\n commits tagged by tags matching the ``tag_filter_regexp``.\n- Ability to specify rev-lists for partial changelogs creation was not\n working on windows. [Valentin Lab]\n- Encoding issues prevented log to be outputed on specific windows\n versions. [Valentin Lab]\n- Fixed encoding issue when reading UTF-8 git logs with a different\n default locale. [Valentin Lab]\n\n Windows platform were more likely to get hit by this bug as their\n default code page is not ``utf-8``. It was fixed by using an explicit\n encoding when reading git logs. The default value for this encoding\n can now be set in the ``gitchangelog``'s config file, per-repository.\n Although, this option should be only set in pathological configuration\n as the default behavior is to use ``git config i18n.logOutputEncoding``\n when set, or if not set, ``utf-8``, which is the default log encoding\n of git.\n\n\n2.5.1 (2015-11-11)\n------------------\n\nFix\n~~~\n- Reference config is used for defaults. [Tuukka Mustonen]\n- Error message when called in non-git directories was not correctly\n displayed on python 3. [Valentin Lab]\n- ``--debug`` argument would generate command line arguments parsing\n errors on python 2.7. (fixes #66) [Valentin Lab]\n\n\n2.5.0 (2016-10-16)\n------------------\n\nNew\n~~~\n- Hide unexpected traceback per default and allow them to be displayed\n if wanted. [Valentin Lab]\n- New lines fixes in current default ReST format (fixes #62) [Stavros\n Korokithakis]\n\n These were modified:\n\n - no new line between list element, except when there's some\n body message to display, then use only one new line at the\n beginning of the body to issues with possible lists in body.\n - one new line before section titles.\n - two new lines before versions titles.\n\nFix\n~~~\n- Output warning on stderr in some weird cases (fixes #52) [Valentin\n Lab]\n\n If no tag are found in the repository, or no tag matches the filter\n regex, or if all commits are ignored... this will lead to disturbing but\n legit outputs from ``gitchangelog``. So as to help diagnose what is\n going on, additional warnings are then printed when edge cases are\n encountered.\n- [mustache/restructuredtext] avoid HTML-escaping content of variables\n (fixes #64) [Mark Milstein]\n\n\n2.4.0 (2015-11-10)\n------------------\n\nNew\n~~~\n- Add optional positional argument ``REVLIST`` to allow incremental\n changelog output (fixes #26) [Valentin Lab]\n\n See use cases documentations for more information.\n\n\n2.3.0 (2015-09-25)\n------------------\n\nFix\n~~~\n- Nasty hidden bug that would break python3 (fixes #27) [Valentin Lab]\n\n Actually this bug was revealed by python3 random hashes (thanks to\n @rschoon for the hint) and could be reproduced on python2.7 with ``-R``\n mode.\n\n The ``git show`` command actually will behave differently if given a tag\n reference and print random unexpected information before using the\n format string. This would prefix a lot of mess to the first field being\n asked in the format string.\n\n And this first field is dependent on the internal order of a dict, and\n this order is not important as such, and so nothing was done on this\n part.\n\n On python2.7, somehow, it would always be the same order that revealed\n to have no consequence (probably one of the rare field not used in\n current changelogs).\n\n Python3 or Python2.7 -R would shuffle this order and then trigger the\n error whenever this prefix would be appended to actually important\n fields that went into some further processing (as casted to int for\n the timestamp for instance).\n\n\n2.2.1 (2015-06-09)\n------------------\n\nFix\n~~~\n- Fix: doc: ``\u00ecnclude_merge`` options was wrongly typed in sample config\n files (reported by @tuukkamustonen, fixed #29). [Valentin Lab]\n- Updated doc to reflec that there are no support of windows for now.\n (fixes #28) [Valentin Lab]\n\n Actually windows will fail on ``subprocess`` call. (see #28)\n- Remove commit's meta-information footer from changelog output. (fixes\n #25) [Valentin Lab]\n\n Some various tools (thinking of Gerrit) might leave some\n meta-information in the footer of your commit message's body that you do\n not want to be repeated in your changelog. So all values in the footer\n are removed (This concerns ``Change-Id``, ``Acked-by``, ``CC``,\n ``Signed-off-by``, ``Bug`` ... and any other value).\n\n\n2.2.0 (2015-01-27)\n------------------\n\nNew\n~~~\n- Provide support for older config file format. [Valentin Lab]\n- Added 'octobercms-plugin' mako template. (fixes #16) [Valentin Lab]\n- Added ``body_process`` and ``subject_process`` options. (fixes #22)\n [Valentin Lab]\n\n These options superseeds ``replace_regexps`` and ``body_split_regexp``\n as they provide a full control over text transformation of the subject\n or the body of the commit before they get included in the changelog.\n- Added ``include_merge`` option to filter out merge commit. [Casey\n Duquette]\n\nChanges\n~~~~~~~\n- Produce a more linear commit history (fixes #14) [Casey Duquette]\n\n Instead of retrieving the git log ordered by date, retrieve the log as\n a difference between tags to produce a more accurate view of changes\n between releases.\n\n For instance, imagine this git graph::\n\n * 6c0fd62 (HEAD, tag: sprint-6, origin/smoke, smoke, develop)\n * 5292a28 Merge back to develop\n |\\\n | * 6612fce (tag: sprint-5.1, origin/master, origin/HEAD, master) super important hotfix\n * | 7d6286f more development work\n * | 8c1e3d6 continued development work\n * | fa3d4bd development work\n |/\n * ec1a19c (tag: sprint-5)\n\n Previously, commits ``fa3d4bd``, ``8c1e3d6``, ``7d6286f`` that\n occurred on the develop branch before the hotfix that led to tagging\n ``sprint-5.1``, were captured in the changelog under release\n ``sprint-5.1`` because of the order of the commits. But it is obvious\n that these commits were not included in a release until\n ``sprint-6``. The new method of calculating the changelog will capture\n this and reflect it properly, assigning those changes to ``sprint-6``.\n\nFix\n~~~\n- Last commit was omitted (fixes #23). [Valentin Lab]\n- Bogus messages when template didn't exist. [Valentin Lab]\n\n Refactored out the common code and corrected the bad error message.\n- Removed hypothetical memory exhaust while parsing ``git log``.\n [Valentin Lab]\n\n Parse stdout as it's produced by git log by chunks.\n\n\n2.1.2 (2014-04-25)\n------------------\n\nFix\n~~~\n- Fail with error message when config path exists but is not a file.\n (fixes #11) [Casey Duquette]\n\n For example, the config file could be a directory.\n\n\n2.1.1 (2014-04-15)\n------------------\n\nFix\n~~~\n- Removed exception if you had file which name that matched a tag's\n name. (fixes #9) [Valentin Lab]\n\n\n2.1.0 (2014-03-25)\n------------------\n\nNew\n~~~\n- Python3 compatibility. [Valentin Lab]\n- Much greater performance on big repository by issuing only one shell\n command for all the commits. (fixes #7) [Valentin Lab]\n- Add ``init`` argument to create a full ``.gitchangelog.rc`` in current\n git repository. [Valentin Lab]\n- Remove optional first argument that could specify the target git\n repository to consider. [Valentin Lab]\n\n This is to remove duplicate way to do things. ``gitchangelog`` should be run\n from within a git repository.\n\n Any usage of ``gitchangelog MYREPO`` can be written ``(cd MYREPO;\n gitchangelog)``.\n- Use a standard formatting configuration by default. [Valentin Lab]\n\n A default `standard` way of formatting is used if you don't provide\n any configuration file. Additionaly, any option you define in your\n configuration file will be added \"on-top\" of the default configuration\n values. This can reduce config file size or even remove the need of\n one if you follow the standard.\n\n And, thus, you can tweak the standard for your needs by providing only partial\n configuration file. See tests for examples.\n- Remove user or system wide configuration file lookup. [Valentin Lab]\n\n This follows reflexion that you build a changelog for a repository and\n that the rules to make the changelog should definitively be explicit and\n thus belongs to the repository itself.\n\n Not a justification, but removing user and system wide configuration files\n also greatly simplifies testability.\n\nFix\n~~~\n- Encoding issues with non-ascii chars. [Valentin Lab]\n- Avoid using pipes for windows compatibility and be more performant by\n avoiding to unroll full log to get the last commit. [Valentin Lab]\n- Better support of exotic features of git config file format. (fixes\n #4) [Valentin Lab]\n\n git config file format allows ambiguous keys:\n\n [a \"b.c\"]\n d = foo\n [a.b \"c\"]\n e = foo\n [a.b.c]\n f = foo\n\n Are all valid. So code was simplified to use directly ``git config``.\n This simplification will deal also with cases where section could be\n attributed values:\n\n [a \"b\"]\n c = foo\n [a]\n b = foo\n\n By avoiding to parse the entire content of the file, and relying on\n ``git config`` implementation we ensure to remain compatible and not\n re-implement the parsing of this file format.\n- Gitchangelog shouldn't fail if it fails to parse your git config.\n [Michael Hahn]\n\n\n2.0.0 (2013-08-20)\n------------------\n\nNew\n~~~\n- Added a ``mako`` output engine with standard ReSTructured text format\n for reference. [Valentin Lab]\n- Added some information on path lookup scheme to find\n ``gitchangelog.rc`` configuration file. [Valentin Lab]\n- Added templating system and examples with ``mustache`` template\n support for restructured text and markdown output format. [David\n Loureiro]\n\nChanges\n~~~~~~~\n- Removed ``pkg`` and ``dev`` commits from default sample changelog\n output. [Valentin Lab]\n\nFix\n~~~\n- Some error message weren't written on stderr. [Valentin Lab]\n\n\n1.1.0 (2012-05-03)\n------------------\n\nNew\n~~~\n- New config file lookup scheme which adds a new possible default\n location ``.gitchangelog.rc`` in the root of the git repository.\n [Valentin Lab]\n- Added a new section to get a direct visual of ``gitchangelog`` output.\n Reworded some sentences and did some other minor additions. [Valentin\n Lab]\n\nChanges\n~~~~~~~\n- Removed old ``gitchangelog.rc.sample`` in favor of the new documented\n one. [Valentin Lab]\n\nFix\n~~~\n- The sample file was not coherent with the doc, and is now accepting\n 'test' and 'doc' audience. [Valentin Lab]\n\n\n1.0.2 (2012-05-02)\n------------------\n\nNew\n~~~\n- Added a new sample file heavily documented. [Valentin Lab]\n\nFix\n~~~\n- ``ignore_regexps`` where bogus and would match only from the beginning\n of the line. [Valentin Lab]\n- Display author date rather than commit date. [Valentin Lab]\n\n\n0.1.2 (2011-06-29)\n------------------\n\nNew\n~~~\n- Added ``body_split_regexp`` option to attempts to format correctly\n body of commit. [Valentin Lab]\n- Use a list of tuple instead of a dict for ``section_regexps`` to be\n able to manage order between section on find match. [Valentin Lab]\n\nFix\n~~~\n- ``git`` in later versions seems to fail on ``git config <key>`` with\n errlvl 255, that was not supported. [Valentin Lab]\n- Removed Traceback when there were no tags at all in the current git\n repository. [Valentin Lab]\n\n\n0.1.1 (2011-06-29)\n------------------\n\nNew\n~~~\n- Added section classifiers (ie: New, Change, Bugs) and updated the\n sample rc file. [Valentin Lab]\n- Added a succint ``--help`` support. [Valentin Lab]\n\n\n\n",
"bugtrack_url": null,
"license": "BSD 3-Clause License",
"summary": "gitchangelog generates a changelog thanks to git log.",
"version": "3.0.4",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "6712388ba0239926ce812118ab4b272f",
"sha256": "45f8b8e64cece0d9bb03a35ecd8ee62c1c7157f8dac0ef3cb68381bfcc1bde29"
},
"downloads": -1,
"filename": "gitchangelog-3.0.4-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "6712388ba0239926ce812118ab4b272f",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 54625,
"upload_time": "2018-12-21T14:01:05",
"upload_time_iso_8601": "2018-12-21T14:01:05.011801Z",
"url": "https://files.pythonhosted.org/packages/9d/f9/554f9d1e2031a330148299b81ed7d6d5f1ef8969154384ca4ae8dd403b7a/gitchangelog-3.0.4-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "ca9970682315034697f42b25b9a82f08",
"sha256": "3d8d6a730450fbd5b0a9bc58d0dd3e269c967d7eb4fece0c5cff4372a3f77421"
},
"downloads": -1,
"filename": "gitchangelog-3.0.4.tar.gz",
"has_sig": false,
"md5_digest": "ca9970682315034697f42b25b9a82f08",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 72565,
"upload_time": "2018-12-21T14:01:07",
"upload_time_iso_8601": "2018-12-21T14:01:07.783060Z",
"url": "https://files.pythonhosted.org/packages/12/e3/9b5c8f1c80a675da2bba0a131427273f255d6e8fa767553f30f2bdf1d557/gitchangelog-3.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2018-12-21 14:01:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "vaab",
"github_project": "gitchangelog",
"travis_ci": true,
"coveralls": true,
"github_actions": false,
"appveyor": true,
"lcname": "gitchangelog"
}
JSON
