If you want to use a custom configuration you can just initialize your Tentacle in this way:

tentacle = Tentacle(path='myconf.yaml')

Yeah, but how the YAML looks like?

Here a quick look at default_configuration.yaml

version: 1
disable_existing_loggers: false

formatters:
  defaultFormatter:
    format: '%(asctime)s - %(filename)s - %(levelname)s - %(name)s - %(message)s'

handlers:
  console:
    class: logging.StreamHandler
    level: DEBUG
    formatter: defaultFormatter
  file:
    class: logging.handlers.TimedRotatingFileHandler
    level: INFO
    formatter: defaultFormatter
    filename: ./logs/log.log
    when: midnight
    interval: 15
    backupCount: 0

loggers:
  root:
    level: DEBUG
    handlers: [console, file]
    propagate: no

coloredlogs:
  active: true
  formatter: defaultFormatter

/*TODO ADD EXPL ON HOW TO CHANGE THE VALUES IN THE YAML FILE*/

We managed to integrate a simplier configuration-flow to ensure a quick integration in every app. You can configure your logging with a YAML file. A simple and light weight logging configuration is provided by default. We brought in this library our logging best practices ready to use with the default configuration.

The Tentacle is the single unit of TentaLog, managing a single logger. To start logging with tentacle you can follow the quick-start guide on GitHub. This code will use the tentalog default configuration, that contains the configuration of two logging handlers, one for the console and one for a time based file rotation of 15 days. If the "mylogger" logger is not found in configuration, the "root" logger will be used and a warning message will be showed. If the name of the logger is not specified, the "root" logger will be used. If you want to use a custom configuration you can just initialize your Tentacle in a similar way with a YAML file.

We decided to release TentaLog as an open source project, in fact you can check and improve the code yourself: https://github.com/nextblu/tentalog

TentaLog has been designed to be used immediately after installation. We propose a basic configuration always available in order to have a logging system in few seconds.

So, where do we start?

The Tentacle is the single unit of TentaLog, managing a single logger. To start logging with tentacle you can do something like this:

from tentalog import Tentacle

tentacle = Tentacle(name='mylogger')

logger = tentacle.logger
logger.info("Hello World")

This code will use the tentalog default configuration, that contains the configuration of two logging handlers, one for the console and one for a time based file rotation of 15 days. If the "mylogger" logger is not found in configuration, the "root" logger will be used and a warning message will be showed. If the name of the logger is specified, the "root" logger will be used.

You can find TentaLog package on .

How to install

To install TentaLog in your environment you can simply type

pip install tentalog

This will install TentaLog in your sistem and you will be able to use the library in matters of second.