Project and source code statistics plugin for Trac.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs Adding some screenshots. Jun 10, 2010
tracstats
.gitignore adding MANIFEST to gitignore Feb 1, 2017
BUGS Initial version. Apr 30, 2010
COPYRIGHT Update copyright. Apr 30, 2010
LICENSE
MANIFEST.in making sure license and copyright and readme are included. Feb 1, 2017
Makefile Fixes some whitespace issues. Nov 12, 2010
README.md tag ini sections in readme. Jan 11, 2017
TODO
setup.py

README.md

TracStats

The TracStats project is a plugin for the trac project management tool.

The TracStats plugin adds a "Stats" tab to the trac project. Underneath this tab can be found statistics about changesets, wiki pages, and tickets.

Some features include:

  • Recent activity (last 30 days) showing top 10 developers, projects, and paths within the repository.

  • Detailed statistics of source code development:

    • Total files by time
    • Commits by time, author, month, day of week, hour of day
    • Recent commits
    • Activity by time, author, project, filetype, change type
    • Most active paths, files
    • Commit cloud (built from checkin comments)
  • Detailed statistics of Trac wiki pages:

    • Total pages by time
    • Edits by author
    • Latest wiki pages changed
    • Most active wiki pages
    • Largest wiki pages
  • Detailed statistics of Trac tickets:

    • Open tickets by time
    • Tickets by author, component
    • Most active tickets
    • Oldest open tickets
    • Latest tickets reported, changed
  • Drill down by author or path within the repository for more information.

The TracStats plugin supports Trac installations with SQLite, MySQL, and PostgreSQL database backends.

The TracStats plugin has been tested with Subversion, Mercurial, and Git version control systems.

Installation

The TracStats plugin can be installed using standard:

$ pip install tracstats

Or, grab the sources and build using:

$ python setup.py install

Configuration

It is configured in the trac.ini file by enabling and configuring:

[components]
tracstats.* = enabled

The STATS_VIEW permission is used to control access to the statistics pages.

In addition, an optional "project root" within your repository can be configured as the base for all projects and source code statistics:

[stats]
root = path/to/projects

Troubleshooting

If you use Git (i.e. the GitPlugin for Trac) and are not able to see any of the code statistics, you likely need to configure it to cache the repository to make it work:

[git]
cached_repository = true
persistent_cache = true

You might need to run trac-admin <project-env> repository resync <reponame> after the change.