Usage
=====

This egg contains a parser for ``AwStats`` files, providing a convenient
``dict`` like API.
::

    >>> from bda.awstatsparser.defaults import (
    ...     PREFIX,
    ...     POSTFIX,
    ...     SECTIONDEFS,
    ... )

``PREFIX`` and ``POSTFIX`` are used to build the target stats file path,
``SECTIONDEFS`` defines the expected structure of the stats file and the keys
to use for providing the several values.

The API is provided due to the ``ParsedStatistics`` class.
::
    
    >>> from bda.awstatsparser.parser import ParsedStatistics
    >>> parser = ParsedStatistics(domain='same_as_awstats_conf_name',
    ...                           dir='/var/lib/awstats',
    ...                           PREFIX, POSTFIX, SECTIONDEFS)

You can ask for ``available`` stats keys.
::

    >>> parser.available
    ['012010', '122009']

You can query the ``latest`` available stats key.
::

    >>> parser.latest
    '012010'

Access some stats information.
::

    >>> sider = parser[parser.latest]['SIDER']
    >>> stat = sider['/path/which/was/logged']
    >>> stat['pages']
    99

Changes
=======


  * 1.2.0
    - added ``available`` property 2010-01-26 - rnix
    - added ``latest`` property 2010-01-26 - rnix
    - added logger and log some warnings and errors 2010-01-26 - rnix

  * 1.1
    - released on pypi ????-??-?? - jensens

  * 1.0
    - initial work - rnix, jensens

Contributors
============

  * Robert Niederreiter <rnix@squarewave.at>
  * Jens Klein <jens@bluedynamics.com>