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 :
> 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) ---