News

13 May 2010: Version 0.1 released!

Description

PacStats is able to analyze the log and the lib directory of the ArchLinux package manager (pacman) and generate statistical charts. The GUI is programmed in Python with PyGTK, the internal database is based on SQLite and the charts are made with Matplotlib. The application is currently in Beta stage, but the user is encouraged to try it and report any issue found.

Screenshots

Screenshots from the remaining charts are on this Picasa Album.

Requirements

• Python (Program)
• GTK2, PyGTK (GUI)
• SQLite, PySQLite if Python <= 2.4 (DB)
• MatplotLib, NumPy (Statistical charts)
• Epydoc and Graphviz (Docs generation)

Package requirements

On ArchLinux most of the users should only need to type:

pacman -S python-matplotlib

to get also python-numpy.

If you haven't it already, install the pygtk package for the GUI to work.

Most of the users should already have a python>=2.5 package installed on their systems, which is enough for SQLite inclusion.

If you want to automatically generate the docs, issue the following command:

pacman -S epydoc graphviz

Installation

This is intended as an application for ArchLinux users only, so the usual way of installing through pacman is the preferred one.

Download the PKGBUILD from AUR: pacstats pacstats-hg

Direct installation

If you want to manually install the the program, type:

$ python setup.py install [ --root=path --prefix=path ]

You can specify a prefix (e.g. /usr) and an alternative root (e.g. /mnt/hdb1).

Docs generation

To generate automatic documentation type:

$ epydoc -o epydoc --name=pacstats --url=http://pacstats.googlecode.com --graph=all PacStats/*.py PacStats/Charts/*.py

Configuration

You can change the configuration through the preferences window, or manually, editing the configuration file.

The program creates a directory called "pacstats" inside $XDG_CONFIG_HOME (usually ~/.config) and then a pacstats.cfg file.

The default content looks like this:

[pacstats]
db = ~/.local/share/pacstats/pacstats.sqlite
log = /var/log/pacman.log
lib = /var/lib/pacman

The db key allows the user to choose the sqlite database. The log and lib keys specify the log and lib directory of pacman, they are best left to their default values.