forest_logger 1.1.1 copy "forest_logger: ^1.1.1" to clipboard
forest_logger: ^1.1.1 copied to clipboard

A Logger to create beautiful logs in Flutter.

Forest Logger #

build version

Overview #

Forest Logger is a comprehensive logging tool designed to facilitate easy and efficient logging in software applications. This document provides detailed information on how to use its various functionalities.

Installation #

Using Forest Logger as a Library

$ flutter pub add forest_logger
$ flutter pub get

Features #

  • On Android/Windows/Linux devices it run in color mode, on iOS, macOS it runs in black-white mode
  • Allows logging while in profile/release modes
  • Created timestamps for log events

Functions #

init(options) #

Initializes the Forest Logger library with various logging configurations.

Parameters:

  • isDebugModeEnabled: (bool, default false) Enables debug logs.
  • isProfileModeEnabled: (bool, default false) Enables profile logs.
  • isReleaseModeEnabled: (bool, default false) Enables release logs.
  • useTimestamps: (bool, default false) Enables timestamps in logs.
  • useSeparators: (bool, default false) Enables a dotted separator in the console logs.
  • showSystemLogs: (bool, default true) Enables system logs.

Description:

This function sets up the logger with the specified configurations, allowing for tailored logging experiences in different modes (debug, profile, release). It includes options for timestamps and console separators for enhanced log readability.

Example:

Forest.init(
  isDebugModeEnabled: true,
  useTimestamps: true,
  useSeparators: true,
);

error(string) - and the others #

Initializes the Forest Logger library with various logging configurations.

Parameters:

  • (string) The String to be logged.
Method Description Use Case Log Level Color
critical Logs critical messages indicating serious failures. Code breaking logs. 50 Red
error Logs error messages. When an error occurs, typically in a try-catch block. 40 Red
success Logs success messages. To log successful events. 0 Green
warning Logs warning messages. For warnings, e.g., non-nominal API responses. 30 Yellow
info Logs informational messages. For informational prints. 20 Blue
debug Logs debug messages. For debug prints. 10 Magenta
todo Logs todo messages. For planned or todo texts. 0 Cyan
systemLog Logs system messages. General purpose logging. 0-50 White

Example:

Forest.error("An error occurred in the application.");

Examples description:

The upper line logs an error message in red to the console, typically used within a try-catch block.

License #

MIT Free Software, Hell Yeah!

2
likes
130
pub points
50%
popularity

Publisher

unverified uploader

A Logger to create beautiful logs in Flutter.

Homepage
Repository (GitHub)
View/report issues

Documentation

Documentation
API reference

License

MIT (license)

Dependencies

flutter, logging

More

Packages that depend on forest_logger