tinylog tagging rollingfilewriter

A tinylog rolling filewriter extension to remove arbitrary data defined via custom tags from the log entry.

The main objective is the use in combination with tinylog-coloredconsole, which allows arbitrary colorized logs through custom tags. With tinylog-tagging-rollingfilewriter, you can remove (or replace) those tags before writing the log to file.

The tinylog-tagging-rollingfilewriter is logically equal to the tinylog-tagging-filewriter but uses the tinylog rolling filewriter for writing the file.

Features

The tinylog-tagging-filewriter extends tinylog with the tagging-rollingfilewriter file writer. It allows you to define up to 10 custom tags (an arbitrary string), which are replaced with the corresponding custom parameter. Thus, you can generate some tags in your source-code to further processing (e.g. via the tinylog-coloredconsole) but replaced custom content for file writing.

The following listing outlines the defition of custom tags/parameters. The example will remove customTag1 and customTag2 before file writing (customTag2 via non-provided, i.e. empty, content reducing config size), while customTag3 is replaced with "==3==".

DEFINITION:
   tinylog.writer               = tagging-rollingfilewriter
   tinylog.writer.customTag1    = <custom tag>
   tinylog.writer.customParam1  = <content to replace customTag1>
   
EXAMPLE:    
   tinylog.writer               = tagging-filewriter
   tinylog.writer.customTag1    = [[customTag1]]
   tinylog.writer.customParam1  = 
   tinylog.writer.customTag2    = [[customTag2]]
   #tinylog.writer.customParam2 = 
   tinylog.writer.customTag3    = [[customTag3]]
   tinylog.writer.customParam3  = ==3==
   < and so on ... up to 10 tag/param entries>

The following screenshots show the listing example with some lorem ipsum text (and those three tags).

Console output (sysout in eclipse):

Log file entry:

Try it out

You can reproduce the colored log demo by running mvn clean install and then java -jar target/tinylog-tagging-rollingfilewriter-1.3.1-executable.jar

Uncomment the desired logging of the main method and corresponding tinylog.properties config for the listed example.

Maven artifact

Add the following dependency to your pom.xml to use the tinylog-tagging-rollingfilewriter in your Maven project:

<dependency>
	<groupId>com.github.tobiasrm</groupId>
	<artifactId>tinylog-tagging-rollingfilewriter</artifactId>
	<version>1.3.1</version>
</dependency>

Note: To make sure your IDE takes all files into account (notably the TaggingRollingFileWriter class), clean and rebuild your project.

Comments

• Versioning. The versioning uses the original tinylog versions for clarity about the underlying libary, e.g. tinylog-tagging-rollingfilewriter in version 1.3.1 uses tinylog v1.3.1 (see pom.xml). If needed, you may simply exclude it and use another tinylog version.

Other tinylog writer extensions

See also my other tinylog writer extension projects:

• tinylog-coloredconsole for colored log-level and arbitrary source-code generated data through custom tags
• tinylog-tagging-filewriter writer extension to remove custom strings (e.g. the tinylog-coloredconsole custom tags) before writing (based on filewriter)
• tinylog-singlelevel-cw for console writers being restricted to their levels (e.g. only print trace, warn and error) to support debugging