SYNOPSIS

       ejs
           --class className
           --cmd literalScript
           --debug
           --files "files..."
           --log logSpec
           --method methodName
           --nodebug
           --optimize level
           --search ejsPath
           --standard
           --stats
           --strict
           --use 'module, ...'
           --version
           --warn level
           file [arguments ...]

DESCRIPTION

       The ejs command is an Ejscript command shell that can interpret and run
       JavaScript programs.

       Ejscript  is  an enhanced implementation of the JavaScript language for
       use in embedded applications such as web servers, embedded devices  and
       mobile  phones. It is especially well suited for Server-Side JavaScript
       web applications.

INVOCATION

       The ejs command can be used as a shell to interactively interpret  com-
       mands typed at the console or to run script files. When invoked with no
       files on the command line, ejs runs in interactive mode.   In  interac-
       tive  mode,  ejs  reads  input from the console and parses and executes
       script code as it is entered. In this mode, ejs command will read input
       until  it has a complete block of code and will then execute the block.
       The last result value computed will be echoed to the console. For exam-
       ple:

       ejs-0>; if (true) {
       ejs-2>;     print("Hello World");
       ejs-2>; }
       Hello World

       ejs-0>;

       Note:  the  input prompt includes a level of nest indicator starting at
       zero and increasing upward as commands nest. This is a hint as to  when
       you  have  closed sufficient braces for ejs to execute your command. As
       this is an internal compiler nest value, it  will  sometimes  increment
       more than 1 for each brace.

       The  ejs  command  can also invoke a specific static method on startup.
       If either the --class or --method switches are supplied, then ejs  will
       run  the requested static method after the input file script statements
       have been executed.

COMPLIANCE

       Ejscript is fully compliant with the JavaScript  (ECMA-262  3.X)  stan-
       dards,  but  it also offers a set of enhancements and fixes designed to
       improve the language and correct some  longstanding  JavaScript  design
       issues.

OPTIONS

       --class className
              Use  the  given  className when searching for the startup method
              specified via --method or "main" by default.

       --cmd literalCommand
              Evaluate a literal command string.

       --debug
              Run in debug mode and  generate  symbolic  stack  backtraces  if
              required.

       --files "files ..."
              Specifies  an extra set of files to be compiled. The ejs command
              normally takes just one script file on the  command  line.   The
              --files switch allows extra script to be compiled after the pri-
              mary script, but before the scripts are run.

       --log logName[:logLevel]
              Specify a file to log internal execution messages. Ejs will  log
              execution related trace to the log file. The log level specifies
              the desired verbosity of output. Level 0 is  the  least  verbose
              and  level  9  is  the  most. Level 2 will include trace of each
              source statement and assembler  instruction  executed  (provided
              --nodebug is not specifiec).

       ---method methodName
              Set the startup method name. Defaults to "main" if a --className
              is specified and --method is not.

       --nodebug
              Run the script without debug information. This  will  result  in
              exceptions not having symbolic stack backtraces.

       --optimize level
              Set  the code optimization level. Level values must be between 0
              (least) and 9 (most). Default is level 9.

       --search ejsPath
              Set the module search path. The module search path is a  set  of

              1. Search for a module file named "a.b.c.mod"

              2. Search for a module file named "a/b/c.mod"

              3. Search for a module file named "a.b.c.mod" in the search path

              4. Search for a module file named c.mod in the search path

       --standard
              Run  scripts  in  standard  mode.  Ejscript supports two parsing
              modes: strict and standard. Standard mode does not require vari-
              ables be declared and typed before use.

       --stats
              Print various statistics on exit.

       --strict
              Run  scripts  in  standard  mode.  Ejscript supports two parsing
              modes: strict and standard. Strict mode requires that all  vari-
              ables be declared and typed.

       --use 'module, ...'
              List of modules to preload before compiling input files.

       --warn level
              Set  the  compiler warning verbosity level. Level values must be
              between 0 (least verbose) and 9 (most). Default is 0.

       --version
              Print the ejs command version and exit.

REPORTING BUGS

       Report bugs to dev@embedthis.com.

COPYRIGHT

       Copyright (C) Embedthis Software. Ejscript is a trademark of  Embedthis
       Software.

SEE ALSO

       ejsc, ejsmod



ejs                               March 2014                            EJS(1)