Alog
====

Alog is a stackable logging framework for the Ada programming language. It aims
to be straight forward to use and is easily extendable. It provides support for
various logger types, log facilities, loglevel policies and message
transformations.


Prerequisites
-------------
Alog is written in Ada so you need to have an Ada Compiler such as GNAT
installed to build Alog.


Download
--------

Release Version
~~~~~~~~~~~~~~~
The current release version of alog is available at
https://www.codelabs.ch/download/.

Verify a Release
~~~~~~~~~~~~~~~~
To verify the integrity and authenticity of the distribution tarball type the
following commands:

  $ wget -q https://www.codelabs.ch/keys/0xDBF6D7E1095FD0D9.asc -O - | gpg --import
  $ gpg --verify libalog-{version}.tar.bz2.sig

The key fingerprint of the public key ('0xDBF6D7E1095FD0D9') is:

  Key fingerprint = 298F 4B32 C3C4 1D88 5949  86F3 DBF6 D7E1 095F D0D9

Development Version
~~~~~~~~~~~~~~~~~~~
The current development version of alog is available through its git repository:

  $ git clone https://git.codelabs.ch/git/alog.git

A browsable version of the repository is also available here:
https://git.codelabs.ch/?p=alog.git


Licence
-------
--------------------------------------------------------------------------------
Copyright (C) 2008-2020 Reto Buerki
Copyright (C) 2008-2020 Adrian-Ken Rueegsegger

Alog is free software; you can redistribute it and/or modify it under the terms
of the GNU Lesser General Public License as published by the Free Software
Foundation; either version 2.1 of the License, or (at your option) any later
version.
--------------------------------------------------------------------------------


Installation
------------
The Alog library has no special dependencies. To run the testcases, you need to
have the Ahven Unit Test-Framework installed:

* Ahven (Test-Framework):
  http://ahven.stronglytyped.org/

The building and installation process of Alog is simple. Just type in the
following commands. You must be root to install the library system wide.

  $ tar -xzf libalog-{version}.tar.bz2
  $ cd libalog-{version}
  $ make
  $ make PREFIX=/usr/local install

This will compile and install the Alog library. If no `PREFIX` is specified,
`$(HOME)/libraries` is used as installation directory.


Tests
-----
After compiling and linking Alog, you can test if everything works as
expected by typing the following command:

  $ make tests

You should then see `PASS` behind each of the tests.
