proxima_logger 0.6.0

Easy to use, customizable, expandable logger that prints beautiful logs.

Easy to use, customizable, expandable logger that prints beautiful logs.

💎 Proxima Logger - the of logging package for your Flutter / Dart app. ✨ With its beautiful and intuitive design, you'll be up and running in no time.

🎨 Customize your logs to your heart's desire with a range of options and styles. 🐛 Need to print out debug messages? No problem. 🌈 Want to add some color to your logs to make them stand out? Proxima Logger has you covered.

🚀 But that's not all - Flutter Logging is also highly extensible. 🌍 Need to send your logs to a remote server for safekeeping? Proxima Logger makes it possible to integrate with your preferred logging backend. Plus, it's easy to output logs from popular HTTP clients such as Dio.

🙌 In addition, Proxima Logger has no dependencies, meaning it won't add any extra weight to your app or introduce any additional vulnerabilities.

Getting started

1. Add package to the project:

   dependencies:
       proxima_logger: ^0.5.1
   

2. Create an instance of ProximaLogger and set the settings as needed:

    final logger = ProximaLogger(
        settings: LogSettings(
            logParts: [
                LogPart.stack,
                LogPart.error,
                LogPart.time,
                LogPart.divider,
                LogPart.message,
            ],
            printEmoji: true,
            printTitle: true,
            printLogTypeLabel: true,
        ),
        typeSettings: {
            Log.warning: LogSettings(
                logParts: [
                    LogPart.stack,
                    LogPart.message,
                ],
                printEmoji: false,
            ),
        },
    );
   

3. If necessary, you can implement the LogType class and create your own log types.

   enum Log implements LogType {
       info,
       custom;
   
       @override
       String get label {
           switch (this) {
           case Log.info:
               return 'info';
           case Log.custom:
               return 'custom';
           }
       }
   
       @override
       String get emoji {
           switch (this) {
           case Log.info:
               return '💡';
           case Log.custom:
               return '🦄';
           }
       }
   
       @override
       AnsiPen get ansiPen {
           switch (this) {
           case Log.info:
               return AnsiPen.none();
           case Log.custom:
               return AnsiPen.purple();
           }
       }
   
       @override
       AnsiPen get ansiPenOnBackground {
           return AnsiPen.black();
       }
   }
   

Usage

1. Use logger.log() anywhere in the program.

   logger.log(
       Log.info,
       title: 'Log title',
   );
   
   logger.log(
       Log.debug,
       message: 'Debug message'
   );
   
   try {
       //...
   } catch (e, s) {
       logger.log(
           Log.error,
           title: 'Some error',
           error: e,
           stack: s,
       );
   }
   

2. Or write your own wrapper over logger for convenience.

   final logger = MyLogger();
   
   class MyLogger extends ProximaLogger {
       MyLogger({super.settings, super.typeSettings});
   
       void info(String message) {
           log(Log.info, message: message);
       }
   
       void error(Error error, StackTrace stack, [String? message]) {
           log(Log.error, error: error, stack: stack, message: message);
       }
   
       void response(Response response) {
           log(
               Log.response,
               title: '| ${response.requestOptions.method} | ${response.statusCode} | ${response.requestOptions.path}',
               message: response.data,
           );
       }
   }
   

Output