ProjectMan commands
EasyAnt cames with a few new switches usable from the command line that allow you to obtain several informations on a given project.
- listTargets : Lists all targets available
- listTargets [arg] : Lists all targets associated with the specified extension-point / plugin as argument
- listExtensionPoints : Lists all extension-points available
- listPugins : Lists all plugins imported in the current project
- listProps [plugin] : Lists all properties available in the specified plugin
- listParameters [plugin] : Lists all parameters available in the specified plugin
- describe [arg] : Describes an extension-point / target / property specified by argument
listTargets
Lists all targets available :
> easyant -listTargets
Should print :
--- Available Targets for current project: standard-java-app ---
No ExtensionPoint / Plugin specified. Listing all targets available in the project.
Target: abstract-test:compute-test-sets
Extension-Point: NONE
Description: compute the set of test cases to run
Depends: abstract-test:test-ready
IF: NONE
UNLESS: NONE
...
Target: test-junit:run-integration
Extension-Point: abstract-test:integration-test-run
Description: run junit integration tests
Depends: -test-junit:integration-test
IF: test.mode.run
UNLESS: skip.test.integration
--- End Of (Targets Listing) ---
listTargets [arg]
Lists all targets associated with the specified extension-point / plugin as argument :
> easyant -listTargets package
Should print :
Project Manual
--------------
--- Available Targets for current project: standard-java-app ---
Targets for ExtensionPoint: package
No targets found.
Targets for Module: package
Target: run-java:init
Extension-Point: NONE
Description: NONE
Depends:
IF: NONE
UNLESS: NONE
Target: abstract-package:compute-metainf
Extension-Point: NONE
Description: NONE
Depends: abstract-package:package-ready
IF: NONE
UNLESS: NONE
Target: abstract-package:register-main-artifact
Extension-Point: abstract-package:package-finished
Description: NONE
Depends:
IF: NONE
UNLESS: ${skip.register.main.artifact}
Target: run-java:run
Extension-Point: NONE
Description: run the application
Depends: run-java:init,abstract-package:package-ready
IF: NONE
UNLESS: NONE
Target: abstract-package:init
Extension-Point: NONE
Description: NONE
Depends:
IF: NONE
UNLESS: NONE
For more information on an ExtensionPoint, run:
easyant -describe <EXTENSION POINT>
--- End Of (Targets Listing) ---
listExtensionPoints
Lists all extensio-points available:
> easyant -listExtensionPoints
Should print :
Project Manual
--------------
--- Available ExtensionPoints for current project: standard-java-app ---
test
verify
package
...
report
For more information on an ExtensionPoint, run:
easyant -describe <EXTENSION POINT>
--- End Of (ExtensionPoints Listing) ---
listPlugins
Lists all plugins imported in the current project:
> easyant -listPlugins
Should print :
Project Manual
--------------
--- Available Plugins for current project: standard-java-app ---
org.apache.easyant.buildtypes#build-std-java;0.2
org.apache.easyant.plugins#run-java;0.1: Known as run
For more information on a Plugin, run:
easyant -describe <PLUGIN>
--- End Of (Plugins Listing) ---
listProps [plugin]
Lists all properties available in the specified plugin:
> easyant -listProps run
Should print :
Project Manual
--------------
--- Available Properties for current project: standard-java-app:: Plugin: run ---
Property: run.main.classname
Property: target.main.classes
For more information on a Property, run:
easyant -describe <PROPERTY>
--- End Of (Properties Listing) ---
listParameters [plugin]
Lists all parameters available in the specified plugin:
> easyant -listParameters junit
Should print :
--- Available parameters for current project: easyant-core ---
--- Filtering parameters declared in the following plugin: abstract-test ---
Parameter (type=PATH): run.test.classpath
For more information on a parameter, run:
easyant -describe <parameter name>
--- End Of (Parameter Listing) ---
describe [arg]
Describes an extension-point / target / property specified by argument:
Example with a property
> easyant -describe run.main.classname
Should print :
Project Manual
--------------
--- Available references for: run.main.classname in current project: standard-java-app ---
No Extension-Point found for name: run.main.classname
No Target found for name: run.main.classname
Property: run.main.classname
Description: name of the main class to run
Default: NONE
Required: true
--- End Of (Describe) ---
Example with a phase
> easyant -describe package
Should print :
Project Manual
--------------
--- Available references for: package in current project: standard-java-app ---
Extension-Point: package
Description: take the compiled code and package it in its distributable format, such as a JAR.
Depends: prepare-package
For information on targets attached to this phase, run:
easyant -listTargets package
No Target found for name: package
No Property found for name: package
--- End Of (Describe) ---
Example with a target
> easyant -describe run-java:run
Should print :
Project Manual
--------------
--- Available references for: run-java:run in current project: standard-java-app ---
No Phase found for name: run-java:run
Target: run-java:run
Phase: NONE
Description: NONE
Depends: validate, compile, process-resources
IF: NONE
UNLESS: NONE
No Property found for name: run-java:run
--- End Of (Describe) ---