Skip to content

Latest commit

 

History

History
134 lines (87 loc) · 3.6 KB

usage.md

File metadata and controls

134 lines (87 loc) · 3.6 KB
Raw

Command Line Usage

The evy toolchain is a set of tools that can be used to parse, run, and format Evy source code. It can also be used to serve the Evy web contents locally. You can install the Evy toolchain locally and run it from your command line. The command-line interface for Evy supports all built-in and graphics functions except for event handlers. Events are currently only supported within the web interface, such as on play.evy.dev.

The Evy toolchain has three subcommands:

  • evy run: Parse and run Evy source code.
  • evy fmt: Format Evy source code.
  • evy serve: Serve Evy website(s) locally.

You can also get help for each subcommand by running it with the --help flag.

evy --help

Usage: evy <command> [flags]

evy is a tool for managing evy source code.

Flags:
  -h, --help       Show context-sensitive help.
  -V, --version    Print version information

Commands:
  run [<source>] [flags]
    Run Evy program.

  fmt [<files> ...] [flags]
    Format Evy files.

  serve export <dir> [flags]
    Export embedded content.

  serve start [flags]
    Start web server, default for "evy serve".

Run "evy <command> --help" for more information on a command.

evy run --help

Usage: evy run [<source>] [flags]

Run Evy program.

Arguments:
  [<source>]    Source file. Default: stdin.

Flags:
  -h, --help               Show context-sensitive help.
  -V, --version            Print version information

      --skip-sleep         Skip evy sleep command ($EVY_SKIP_SLEEP).
      --svg-out=FILE       Output drawing to SVG file. Stdout: -.
      --svg-style=STYLE    Style of top-level SVG element.
  -s, --no-test-summary    Do not print test summary, only report failed tests.
      --fail-fast          Stop execution on first failed test.
  -t, --txtar=MEMBER       Read source from txtar file and select select given
                           filename

evy fmt --help

Usage: evy fmt [<files> ...] [flags]

Format Evy files.

Arguments:
  [<files> ...]    Source files. Default: stdin.

Flags:
  -h, --help       Show context-sensitive help.
  -V, --version    Print version information

  -w, --write      Update .evy file.
  -c, --check      Check if already formatted.

evy serve [start] --help

Usage: evy serve start [flags]

Start web server, default for "evy serve".

Flags:
  -h, --help              Show context-sensitive help.
  -V, --version           Print version information

  -p, --port=8080         Port to listen on ($EVY_PORT)
  -a, --all-interfaces    Listen only on all interfaces not just localhost
                          ($EVY_ALL_INTERFACES)
  -d, --dir=DIR           Directory to serve instead of embedded content
      --root=DIR          Directory to use as root for serving, subdirectory of
                          DIR if given, eg "play", "docs"

evy serve export --help

Usage: evy serve export <dir> [flags]

Export embedded content.

Arguments:
  <dir>    Directory to export embedded content to

Flags:
  -h, --help       Show context-sensitive help.
  -V, --version    Print version information

  -f, --force      Use non-empty directory