Basics

Logging



Introduction

To print information to the console, you can use one of the following:

  • printInfo(dynamic message)
  • printDebug(dynamic message)
  • printError(dynamic message)

The above helpers will only print to the console if the APP_DEBUG variable in your .env file is set to true.

// .env
APP_DEBUG=true

This is useful when you want to print information to the console during development, but not in production.

Here's an example using the helpers:

import 'package:nylo_framework/nylo_framework.dart';
...

String name = 'Anthony';
String city = 'London';
int age = 18;

printInfo(name); // [info] Anthony
printDebug(age); // [debug] 18
printError(city); // [error] London

You can also use the dump helper to print data to the console.

String city = 'London';
int age = 18;

age.dump(); // 18

dunp(city); // London

Why use NyLogger?

NyLogger may appear similar to print in Flutter, however, there's more to it.

If your application's .env variable APP_DEBUG is set to false, NyLogger will not print to the console.

In some scenarios you may still want to print while your application's APP_DEBUG is false, the showNextLog helper can be used for that.

// .env
APP_DEBUG=false

// usage for showNextLog
String name = 'Anthony';
String country = 'UK';
List<String> favouriteCountries = ['Spain', 'USA', 'Canada'];

printInfo(name); // Will not print
printInfo(country); // Will not print

showNextLog();
printInfo(country); // UK

printDebug(favouriteCountries); // Will not print


Log Levels

You can use the following log levels:

  • [info] - printInfo(dynamic message)
  • [debug] - printDebug(dynamic message)
  • [error] - printError(dynamic message)


Helpers

You can print data easily using the dump or dd extension helpers. They can be called from your objects, like in the below example.

String project = 'Nylo';
List<String> seasons = ['Spring', 'Summer', 'Fall', 'Winter'];

project.dump(); // 'Nylo'
seasons.dump(); // ['Spring', 'Summer', 'Fall', 'Winter']

String code = 'Dart';

code.dd(); // Prints: 'Dart' and exits the code