About

About Loggifier

This plugin-in defines a new ANT task 'de.unkrig.loggify' which can be used from build scripts executed in the same JRE as the workspace.

selector: If defined, then only those .class files which match the 'combined wildcard pattern' are loggified.
outdir: If not defined, then the input files and dirs are processed 'in-place'. Otherwise, the input files and dirs are copied to the given output directory while being loggified.
keeporiginals: If 'outdir' is not set ('in-place loggification') and 'keeporiginals=true', then copies of the original (unloggified) input files are kept with names similar to the original file names.
debug

rule: Inject logging code according to the given rule.
The rule format is:
action[,action]...=level[:expression]
action is one of [ CLINIT ENTRY RETURN THROW LOAD STORE INVOKE RESULT ]
level is one of [ OFF SEVERE WARNING INFO CONFIG FINE FINER FINEST ]
expression is like '(eq || eq) && !eq', where
eq is 'var == cwp', where
var is one of [ class source line ] (for action 'STORE' also 'name')
cwd is a 'combined wildcard pattern' in single quotes
fileset: Set of files to loggify. '.class' files are loggified, ZIP format files are scanned recursively for '.class' files, and all other files are left unmodified (in-place loggification) or copied unmodified to 'outdir'.
dirset: Set of directories to loggify. All '.class' files in each directory tree (and also in ZIP files and nested ZIP files) are loggified (if they match the 'selector').

or: Returns true iff any of the discriminator subelements returns true.
and: Returns true iff all of the discriminator subelements returns true.
class: Returns true iff the declaring class matches the 'name' (combined wildcard pattern) or the 'regex'.
method: Returns true iff the declaring method matches the 'name' (combined wildcard pattern) or the 'regex'.
line: Returns true iff the line number matches the 'number' (integer pattern).

Examples:

Pattern character	Matches
*	Any sequence of characters except '/' and '!'
**	Any sequence of characters except '!'
***	Any sequence of characters
?	Any character except '/' and '!'
[abc]	'a', 'b' and 'c'
[^abc]	Any character except 'a', 'b' and 'c'
[A-Z]	All characters from 'A' to 'Z'
any-other-character	That character
\any-character	That character

Examples:

Pattern character	Matches
7	7
7;9	7 and 9
7-9	7 through 9
7-	7 and up
-9	9 and less
x;y	x and y (where x and y are integer patterns)

Version 1.0.0

Changes since the previous version: