Ant-contrib.unkrig.de: Difference between revisions
m (→Abstract) |
(→Tasks) |
||
Line 30: | Line 30: | ||
;<ifYes>, <ifNo>, <ifCancel>, <ifOk>, <ifClosed> (at most one of each) | ;<ifYes>, <ifNo>, <ifCancel>, <ifOk>, <ifClosed> (at most one of each) | ||
:These can have task subelements, which are executed iff the respective dialog button is pressed (<ifYes>, <ifNo>, <ifCancel>, <ifOk>) or the dialog is closed (<ifClosed>). | :These can have task subelements, which are executed iff the respective dialog button is pressed (<ifYes>, <ifNo>, <ifCancel>, <ifOk>) or the dialog is closed (<ifClosed>). | ||
=== <de.unkrig.ant-contrib.jsonproperty> === | |||
Parses a JSON document into a set of properties, in analogy with the standard ANT '<xmlproperty>' task. | |||
==== '''Attributes''' ==== | |||
;file="..." (mandatory) | |||
:The file from which to read the JSON document. | |||
;encoding="..." (optional) | |||
:The encoding of the JSON document. The default is 'UTF-8'. | |||
;name="..." (mandatory) | |||
:The prefix of the names of the properties to set. | |||
== Download and installation == | == Download and installation == |
Revision as of 16:38, 11 November 2013
Abstract
Some contributions to APACHE ANT, e.g. the 'de.unkrig.ant-contrib.swingdialog' task which significantly enhances ANT's <input> task.
Tasks
<de.unkrig.ant-contrib.swingdialog>
Pops up a highly configurable dialog and invites the user to fill in form fields.
This task will fail iff the CANCEL button is pressed or the dialog is closed, except if '<ifCancelTask>'s (or '<ifClosedTask>'s, respectively) are configured.
Attributes
- title="FTP upload of update site" (optional)
- The text to be displayed in the title bar of the dialog.
- optionType="..." (optional)
- DEFAULT (an 'OK' button), YES_NO, YES_NO_CANCEL, OK_CANCEL (the default): Determines which buttons are displayed in the dialog.
- messageType="..." (optional)
- ERROR, INFORMATION, WARNING, QUESTION, PLAIN (the default): If not set to PLAIN, then a respective icon is displayed in the dialog.
- property="..." (optional)
- The named property will be set to YES, NO, CANCEL, OK or CLOSED when the task completes.
Subelements
- <label text="User ID"/> (zero or more)
- Displays the given text.
- <text property="ftp.userid" defaultvalue="www.unkrig.de"/> (zero or more)
- A one-line text input field with an (optional) default value. On return, the named property is set to the text of the field. Iff 'secure="true"' is given, then characters entered into the field are not echoed.
- <checkbox text="Use passive FTP" property="ftp.passive" defaultvalue="true"/> (zero or more)
- A checkbox with a label. On return, the named property is set to 'true' iff the box is checked. Iff 'defaultvalue="true"' is given, then the checkbox is pre-selected.
- <ifYes>, <ifNo>, <ifCancel>, <ifOk>, <ifClosed> (at most one of each)
- These can have task subelements, which are executed iff the respective dialog button is pressed (<ifYes>, <ifNo>, <ifCancel>, <ifOk>) or the dialog is closed (<ifClosed>).
<de.unkrig.ant-contrib.jsonproperty>
Parses a JSON document into a set of properties, in analogy with the standard ANT '<xmlproperty>' task.
Attributes
- file="..." (mandatory)
- The file from which to read the JSON document.
- encoding="..." (optional)
- The encoding of the JSON document. The default is 'UTF-8'.
- name="..." (mandatory)
- The prefix of the names of the properties to set.
Download and installation
The JAR file can be downloaded from http://ant-contrib.unkrig.de/download/.
To make the contributions available in your ANT scripts, write
<taskdef resource="de/unkrig/antcontrib/ant.xml" classpath="lib/de.unkrig.ant-contrib.jar"/>
, or, if you put the JAR file on ANT's default classpath, just
<taskdef resource="de/unkrig/antcontrib/ant.xml"/>
Source code
The source code is available in the SUBVERSION repository. The repository URL is
https://svn.code.sf.net/p/loggifier/code
License
ANT-CONTRIB is published under the "New BSD License".