changelog-chug

changelog-chug is a parser for project Change Log documents.

changelog-chug ##############

Example

Given a reStructuredText document ChangeLog::

Change Log
##########

Version 1.0.1
=============

:Released: 2020-01-10
:Maintainer: Cathy Morris <[e-mail]>

…

Version 1.0
===========

:Released: 2020-01-10
:Maintainer: Luis Flores <[e-mail]>

…

Version 0.2
===========

:Released: 2019-07-04
:Maintainer: Cathy Morris <[e-mail]>

…

Version 0.2-alpha1
==================

:Released: 2019-07-04
:Maintainer: Cathy Morris <[e-mail]>

…

Version 0.1
===========

:Released: 2019-05-16
:Maintainer: Cathy Morris <[e-mail]>

…

Generate Change Log entry data for all versions from the reStructuredText formatted ChangeLog::

>>> import pathlib
>>> import pprint
>>> import chug.parsers.rest
>>> import chug.writers
>>> infile_path = pathlib.Path(".", "ChangeLog")
>>> document_text = chug.parsers.get_changelog_document_text(infile_path)
>>> document = chug.parsers.rest.parse_rest_document_from_text(
...     document_text)
>>> entries = chug.parsers.rest.make_change_log_entries_from_document(
...     document)
>>> pprint.pprint([entry.as_version_info_entry() for entry in entries])
[OrderedDict([('release_date', '2020-01-10'),
              ('version', '1.0.1'),
              ('maintainer', 'Cathy Morris <[e-mail]>'),
              ('body', '…')]),
 OrderedDict([('release_date', '2020-01-10'),
              ('version', '1.0'),
              ('maintainer', 'Luis Flores <[e-mail]>'),
              ('body', '…')]),
 OrderedDict([('release_date', '2019-07-04'),
              ('version', '0.2'),
              ('maintainer', 'Cathy Morris <[e-mail]>'),
              ('body', '…')]),
 OrderedDict([('release_date', '2019-07-04'),
              ('version', '0.2-alpha1'),
              ('maintainer', 'Cathy Morris <[e-mail]>'),
              ('body', '…')]),
 OrderedDict([('release_date', '2019-05-16'),
              ('version', '0.1'),
              ('maintainer', 'Cathy Morris <[e-mail]>'),
              ('body', '…')])]

Generate a JSON document describing the latest version::

>>> import json
>>> latest_entry = entries[0]
>>> latest_entry_json = json.dumps(
...     latest_entry.as_version_info_entry(), indent=4)
>>> print(latest_entry_json)
{
    "release_date": "2020-01-10",
    "version": "1.0.1",
    "maintainer": "Cathy Morris <[e-mail]>",
    "body": "\u2026"
}

Copying

changelog-chug is free software. See the file COPYING_ for details.

.. _COPYING: COPYING

 .. This document is written using reStructuredText_ markup, and can be rendered with Docutils_ to other formats.

..  _Docutils: http://docutils.sourceforge.net/
..  _reStructuredText: http://docutils.sourceforge.net/rst.html

.. Local variables: coding: utf-8 mode: rst End: vim: fileencoding=utf-8 filetype=rst :