Logga

• Overview
• Installation
• Development
  • Prerequisites
  • Getting Started
    • (macOS Users only) Upgrading GNU Make
    • Creating the Local Environment
      • Local Environment Maintenance
  • Help
  • Running the Test Harness

Overview

Python logging made super easy!

Refer to Logga's documentation for detailed instructions.

Installation

With pip:

pip install logga

git-syntax:

logga @ git+https://github.com/loum/logga.git@<release_version>

Development

Prerequisites

• GNU make
• Python 3 Interpreter. We recommend installing pyenv
• Docker

Getting Started

Makester is used as the Integrated Developer Platform.

(macOS Users only) Upgrading GNU Make

Follow these notes to get GNU make.

Creating the Local Environment

Get the code and change into the top level git project directory:

git clone https://github.com/loum/logga.git && cd logga

NOTE: Run all commands from the top-level directory of the git repository.

For first-time setup, get the Makester project:

git submodule update --init

Initialise the environment:

make init-dev

Local Environment Maintenance

Keep Makester project up-to-date with:

git submodule update --remote --merge

Help

There should be a make target to get most things done. Check the help for more information:

make help

Running the Test Harness

We use pytest. To run the tests:

make tests

top