List changelog entries from repository

Description

This plugin displays the changelog for a repository path. As an example, it displays the changes applied to software products as shown in the Recent changes section of this page below.

The ChangeLog macro writes a log of the latest changes of a repository at a given path. Following variants are possible to use:

1. [[ChangeLog(/path)]]
2. [[ChangeLog(/path@rev)]]
3. [[ChangeLog(/path@rev, limit)]]
4. [[ChangeLog(/path@from-to)]]
5. [[ChangeLog(/path, limit, rev)]]

1. Default repository is used if the reponame is left out. To show the last five changes of the default repository:

   [[ChangeLog(/)]]
   

To show the last five changes of the trunk folder in a named otherrepo:

[[ChangeLog(/otherrepo/trunk)]]

2. The ending revision can be set. To show the last five changes up to revision 99:

   [[ChangeLog(/otherrepo/trunk@99)]]
   

3. The maximum amount of changes to display can be set by an optional parameter. To show the last 10 changes, up to revision 99:

   [[ChangeLog(/otherrepo/trunk@99, 10)]]
   

4. A range of revisions can be logged:

   [[ChangeLog(/otherrepo/trunk@90-99)]]
   

To list all changes:

[[ChangeLog(/otherrepo/trunk@1-HEAD)]]

Note that HEAD can be left out:

[[ChangeLog(/otherrepo/trunk@1-)]]

5. For backwards compatibility, the revision can be stated as a third parameter:

   [[ChangeLog(/otherrepo/trunk, 10, 99)]]
   

Both limit and rev may be keyword arguments:

[[ChangeLog(/otherrepo/trunk, limit=10, rev=99)]]

Examples:

1. Display change log for this plugin, back 3 revisions:

[[ChangeLog(/changelogmacro, 3)]]

Results in this:

18148 by Cinc-th on 2021-04-04 17:05:44

ChangeLogMacro: Python 3 fixes for !StringIO and string/bytes handling. Some minimal testing indicates the macro does work with Trac 1.5/Trac 1.6.

17610 by rjollos on 2019-12-03 12:43:50

TracChangeLog 0.6dev: Add classifiers metadata

Version 0.5 has been published to ​pypi:TracChangeLog/0.5

Fixes #13672.

16913 by rjollos on 2017-10-25 01:49:37

TracChangeLog 0.5dev: Make compatible with Trac 1.3.x and fix "(more)" link

Refs #13313.

(more)

2. Display change log starting at specific revision:

[[ChangeLog(/changelogmacro, 1, 7471)]]

Results in this:

7471 by rjollos on 2010-01-25 04:06:04

Copied from changelogplugin/0.11

(more)

Bugs/Feature Requests

Existing bugs and feature requests for ChangeLogMacro are here.

If you have any issues, create a new ticket.

defect	13 / 14
enhancement	11 / 15
task	3 / 3

Download

Download the zipped source from here.

The macro is also available on ​PyPI.

Source

You can check out ChangeLogMacro from here using Subversion, or browse the source​ with Trac.

The 0.11 branch should be used with Trac 0.11 and 0.12. The trunk currently supports Trac 1.0+.

Installation

General instructions on installing Trac plugins can be found on the TracPlugins page.

Recent Changes

18148 by Cinc-th on 2021-04-04 17:05:44

ChangeLogMacro: Python 3 fixes for !StringIO and string/bytes handling. Some minimal testing indicates the macro does work with Trac 1.5/Trac 1.6.

17610 by rjollos on 2019-12-03 12:43:50

TracChangeLog 0.6dev: Add classifiers metadata

Version 0.5 has been published to ​pypi:TracChangeLog/0.5

Fixes #13672.

16913 by rjollos on 2017-10-25 01:49:37

TracChangeLog 0.5dev: Make compatible with Trac 1.3.x and fix "(more)" link

Refs #13313.

(more)

Author/Contributors

Author: athomas
Maintainer: Ryan J Ollos
Contributors: mwehr, Andor, watho, theist, mrelbe