ZZ Tools Ant Library Documentation

Tasks summary

Task	Description
<zzdiff>	Computes the differences between files, directory trees, archive file entries and compressed files, and prints them in various formats.
<zzfind>	Recurses through a set of directories, files, archive files and nested archives and executes a set of tests and actions for each file and archive entry.
<zzgrep>	Finds lines in files in directory trees, archives an compressed files by regular expressions.
<zzpack>	Creates an (optionally compressed) archive file from a set of files and archives.
<zzpatch>	Adds, removes, renames and/or changes the contents of files and archives.

Chainable readers summary

Chainable reader	Description
<patch>	An ANT filter which modifies the data by applying a patch file.

FIND expressions summary

FIND expression	Description
<and>	Combines subexpressions logically: Evaluates its subexpressions sequentially; if one of them evaluates to false, then the remaining subexpressions are not evaluated, and false is returned.
<cat>	Copies the contents of the current file to STDOUT and evaluates to TRUE.
<checksum>	Calculates a "checksum" of the contents, prints it and returns true.
<comma>	Evaluates subexpressions sequentially; returns the value of the last subexpression.
<copy>	Copies the contents of the current file to the named file and evaluates to TRUE.
<digest>	Calculates a "message digest" of the contents, prints it and returns true.
<disassemble>	Disassembles a Java .class file to STDOUT or a given file and evaluates to true.
<echo>	Prints a text and evaluates to true.
<exec>	Executes an external command; the special string '{}' within the command is replaced with the full path of the current file/directory/archive entry.
<executable>	Evaluates to true iff the current file/directory is executable.
<false>	Evaluates to false.
<ls>	Prints the file type ("d" or "-"), readability ("r" or "-"), writability ("w" or "-"), executability ("x" or "-"), size, modification time and path, and evaluates to true.
<modificationTime>	Checks the modification time of the current file or archive entry.
<name>	Evaluates to true iff the name of the current file/directory/archive entry matches the given glob.
<not>	Negates its subelement expression.
<or>	Combines subexpressions logically: Evaluates its subexpressions sequentially; if one of them evaluates to true, then the remaining subexpressions are not evaluated, and true is returned.
<path_>	Evaluates to true iff the path of the current file/directory/archive entry matches the given glob.
<pipe>	Copies the contents of the current file/archive entry to the STDIN of a command and returns whether the command exited with status 0.
<print>	Prints the path of the current file/directory/archive entry and evaluates to true.
<property>	Sets an ANT property.
<readable>	Evaluates to true iff the current file/directory is readable.
<size>	Checks the size of the current file or archive entry.
<true>	Evaluates to true.
<type>	Evaluates to whether the type of the current file/directory/archive entry matches.
<writable>	Evaluates to true iff the current file/directory is writable.

A set of ANT tasks and other ANT types that handle not only directories and files, but also archive files and compressed content, and even nested archives. They can even disassemble Java .class files on-the fly and operate on the disassembly.

License

de.unkrig.diff - An advanced version of the UNIX DIFF utility de.unkrig.find - An advanced version of the UNIX FIND utility de.unkrig.grep - An advanced version of the UNIX GREP utility de.unkrig.pack - An advanced archive creation utility de.unkrig.patch - An enhanced version of the UNIX PATCH utility

Copyright (c) 2014, Arno Unkrig
All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.