Advanced File Output

[pyciko]

This type of file output is mainly targeted for low-cost IoT platforms (like RPi). It optimises some of the aspects of the original File Output, specifically:

• It has an internal temporary buffer which accumulates the logs and prints them out after a certain period. This reduces the frequency of file writes which is good for microSD storages and other types of cheap storages on IoT devices. It is possible to specify the levels of messages which are printed out immediately, without waiting for the next timer tick. By default these are warnings, errors and fatals.
• It has a simple manager for dynamically creating log files instead of using a single one specified by the user. The log files are created in two scenarios: on logger init and when the current log file reaches a size limit. The file names consists of a date+time followed by either "-init" or "-next" suffix depending on the reason why the file was created. This is useful for writing "archives" of telemetry data and logs while keeping them structured.

[Bungeefan]

Hi! Thanks for the nice pull request!

However, before further reviewing your request, unfortunately, the check for Dart 2.17 failed.
Platform.lineTerminator was only introduced in Dart 3.1.0 and this library tries to maintain compatibility with at least 2.17.

I would suggest that you simply replace your usages with the original implementation behind the property:

static String get lineTerminator => isWindows ? '\r\n' : '\n';

https://github.com/dart-lang/sdk/blob/3.1.0/sdk/lib/io/platform.dart#L245

[pyciko]

Done

[Bungeefan]

Thanks for the nice pull request, please check my comments and feel free to ask if you need more clarification!

[Bungeefan]

That was quick, thanks!
I submitted a review (my first ever on GitHub), you should be able to see it now.
Don't be put off by the amount of comments, I still consider your pull request as well-made!

[Bungeefan]

Feel free to overwrite my changes as you see fit.

[Bungeefan]

Please review the new documentation, I tried to implement your description as well as I could!

[pyciko]

Thanks, yeah, English is not my native lang, your text looks much better.

[pyciko]

Thx for approval, can't wait to see it released!

[Bungeefan]

Sure, maybe next time don't close it if you want it to be merged ;)

Anyway, thanks again for the nice FileOutput!
I think it's a fantastic addition to this project, and thank you for keeping up with my repeated change requests!

[Bungeefan]

logger v2.2.0 is now available on pub.dev!

[neiljaywarner]

so sorry if this is a dumb question, but does this library include file logging or is it a possible future thing?

[pyciko]

so sorry if this is a dumb question, but does this library include file logging or is it a possible future thing?

If you're using version 2.2.0 or newer, it does include Advanced File Logging with functions described above. It also includes basic FileLogger that existed even earlier.