surf_logger

Description:

surf logger

Surf Logger #


Made by Surf 🏄‍♂️🏄‍♂️🏄‍♂️






Overview #
Surf Logger is a utility that allows for quick and easy configuration of logging for a production-level application.
This library does not limit your use of third-party loggers. Instead, it provides a tool for configuring logging within your application.
Installation #
Add surf_logger to your pubspec.yaml file:
dependencies:
surf_logger: $currentVersion$
copied to clipboard
At this moment, the current version of surf_logger is .
Example #
Creating your own strategy #
You can create your own logging strategy for different needs: logging to your own server, through Firebase, through Sentry, etc.
class FirebaseLogStrategy implements LogStrategy {
final FirebaseCrashlytics _crashlytics;

CrashlyticsLogStrategy(this._crashlytics);

@override
void e(Exception exception, [StackTrace? stackTrace]) {
_crashlytics.recordError(exception, stackTrace);
}

@override
void log(Object message) {
_crashlytics.log('$message');
print('Message: $message');
}

@override
void w(String message, [Exception? exception]) {
_crashlytics.log('Warning: $message \n Exception: $exception');
}
}
copied to clipboard
Choosing a strategy for the circumstances #
You can configure the logger for the circumstances. For example, for the application flavor:
LogWriter setupLogger(Env env) {
return Logger.withStrategies({
if (env == Env.dev || env == Env.qa) ConsoleLogStrategy(),
if (env == Env.client || env == Env.qa) FileLogStrategy(),
if (env == Env.prod) ...[
FirebaseLogStrategy(),
SentryLogStrategy(),
],
});
}
copied to clipboard
Please note that Logger is a class for configuration, while LogWriter is for usage. This way, we provide access only to the necessary methods for logging, namely log, e, and w.
For instance, the following methods will be available to an instance of LogWriter:
void main() {
final LogWriter logger = _setupLogger();
runApp(MyApp(logger: logger));
logger.log('message');
logger.e(Exception('exception'));
logger.w('message');
}
copied to clipboard
And an instance of Logger will have configuration management methods available. It's important to avoid using this class for other purposes, as it could potentially disrupt the configuration.
void main() {
final Logger logger = _setupLogger();
runApp(MyApp(logger: logger));
logger.log('message');
logger.contains(SomeLogStrategy());
logger.addStrategy(SomeLogStrategy());
logger.clearStrategies();
logger.e(Exception('exception'));
logger.w('message');
}
copied to clipboard
Migrating from 1.x.x to 2.x.x #
1.x.x
void setupLogger() {
RemoteLogger.addStrategy(CrashlyticsRemoteLogStrategy());
Logger.addStrategy(DebugLogStrategy());
Logger.addStrategy(RemoteLogStrategy());
}
copied to clipboard
Starting from version 2.0.0, the logger is no longer a singleton. Now, you need to create an instance of the logger.
RemoteLogger has been removed. Use LogStrategy to create any required strategy.
LogWriter setupLogger() {
return Logger.withStrategies({
CrashlyticsRemoteLogStrategy,
DebugLogStrategy,
RemoteLogStrategy(),
});
}
copied to clipboard
Changelog #
All notable changes to this project will be documented in this file.
Issues #
To report your issues, file directly in the Issues section.
Contribute #
If you would like to contribute to the package (e.g. by improving the documentation, fixing a bug or adding a cool new feature), please read our contribution guide first and send us your pull request.
Your PRs are always welcome.
How to reach us #
Please feel free to ask any questions about this package. Join our community chat on Telegram. We speak English and Russian.

License #
Apache License, Version 2.0