froggius 0.1.4.post2

Froggius is a dumb easy logging tool for python

Froggius

Froggius is a dumb easy logging tool for python

---

Introduction

Froggius is a lightweight python libary, which is designed for easy to use logging for all your programs. It makes it easy for everybody, but also brings a lot of options to configure it like you need it. An very interesting feature for example is the error catching for functions, which makes it easy to log unexpected errors, warnings etc.

Installation

You can install Froggius with following command:

pip install froggius

Alternatively you can clone this repository and install then:

git clone https://github.com/zlElo/Froggius.git
cd Froggius
pip install .

Usage

Here are examples for the usage of Froggius. Import statement is following:

from froggius import Froggius

Using debugger/logger

Use it as debugger/logger with following possible arguments:

• log_msg (log message)
• file_path (None by default, used to set up a log file [...] to append to this file. The file does not have to already exist, if it does not exist, it will be created)
• print_out (True by default, used to setup printing to console and stdout)

# Example normal logging
Froggius.debug('This is a normal debug log')

# This writes the log to a log file
Froggius.debug('This is a normal debug log', 'tests/example.log', print_out=False)

Using with predefinied errors

Use it as error logger with following possible arguments:

• log_msg (log message)
• file_path (None by default, used to set up a log file [...] to append to this file. The file does not have to already exist, if it does not exist, it will be created)
• highliting (True by deafult, used to colorize [DBG] etc.)
• print_out (True by default, used to setup printing to console and stdout)
• line (None by default, expects list with following 3 items in this structure: [line number, file name, function name])

# Example error
Froggius.error('This is an error log')

# This writes the error to a log file
Froggius.error('This is an error log', 'tests/example.log', print_out=False)

Using information logger

Use it as information logger with following possible arguments:

• log_msg (log message)
• file_path (None by default, used to set up a log file [...] to append to this file. The file does not have to already exist, if it does not exist, it will be created)
• highliting (True by default, used to colorize [INF] etc.)
• print_out (True by default, used to setup printing to console and stdout)

# Example information
Froggius.information('This is an information log')

# This writes the information to a log file
Froggius.information('This is an information log', 'tests/example.log', print_out=False)

Using warning logger

Use it as warning logger with following possible arguments:

• log_msg (log message)
• file_path (None by default, used to set up a log file [...] to append to this file. The file does not have to already exist, if it does not exist, it will be created)
• highliting (True by default, used to colorize [WRN] etc.)
• print_out (True by default, used to setup printing to console and stdout)

# Example warning
Froggius.warning('This is a warning log')

# This writes the warning to a log file
Froggius.warning('This is a warning log', 'tests/example.log', print_out=False)

Using catching errors

Use the catching errors methode, to catch and handle unexpected errors, warnings etc:

@Froggius.catch(file_path='tests/example.log')
def example_function():
    """
    Information: Not working function, because of division by zero
    """
    var1 = 5
    var = 0

    result = var1 / var
    print(result)

example_function()

Output in log file: [ERR] [01/04/2024 09:15:00] division by zero | Occured on line: 28 in /Users/username/path/examples.py, example_function()