Fantom

 

abstract class

util::AbstractMain

sys::Obj
  util::AbstractMain

AbstractMain provides conveniences for writing the main routine of an app. Command line arguments are configured as fields with the @arg facet:

@arg="source file to process"
File? src

Arguments are ordered by the field declaration order. The last argument may be declared as a list to handle a variable numbers of arguments.

Command line options are configured as fields with the @opt facet and with an optional @optAliases facet:

@opt="http port"
@optAliases=["p"]
Int port := 8080

Bool fields should always default to false and are considered flag options. All other arg and opt fields must be a Str, File, or have a type which supports a fromStr method.

Option fields may include the "Opt" suffix, and arguments the "Arg" suffix. These suffixes can be used when a field conflicts with an existing slot name.

AbstractMain will automatically implement usage and parseArgs based on the fields which are declared as options and arguments. In general subclasses only need to override run. If writing a daemon main, then you'll probably want to configure your services then call runServices.

See example.

Slots

appNameSource

virtual Str appName()

Get the application name. If this is a script it is the name of the script file. For a precompiled class called "Main" this is the pod name, otherwise it is the type name.

argFieldsSource

virtual Field[] argFields()

Get all the fields annotated with the @arg facet.

helpOptSource

@optAliases = ["?"]
@opt = "print usage help"
Bool helpOpt := false

The help option -help or -? is used print usage.

homeDirSource

virtual File homeDir()

Home directory for the application. For a script this defaults to directory of the script. For pods the default is "{Env.cur.workDir}/etc/{pod}".

logSource

virtual Log log()

Log for this application; defaults to appName.

mainSource

virtual Int main(Str[] args := Env.cur().args())

Main performs the following tasks:

  1. Calls parseArgs to parse command line
  2. If args were incomplete or -help was specified then dump usage and return 1
  3. Call run and return 0
  4. If an exception is raised log it and return 1
optFieldsSource

virtual Field[] optFields()

Get all the fields annotated with the @opt facet.

parseArgsSource

virtual Bool parseArgs(Str[] toks)

Parse the command line and set this instances fields. Return false if not all of the arguments were passed.

runSource

abstract Int run()

Run the application. This method is called after the command line has been parsed. See runServices to launch a deamon application. Return status code, zero for success.

runServicesSource

virtual Int runServices(Service[] services)

Run the set of services:

  1. call install on each service
  2. call start on each service
  3. put main thread to sleep.
usageSource

virtual Int usage(OutStream out := Env.cur().out())

Print usage of arguments and options. Return non-zero.