Extended Covariant Script (CovScript 4)

ECS is the next generation of Covariant Script Programming Language.

How to install

1. Install CovScript 3 Runtime

Please visit CovScript Official Website and follow the instruction.

2. Install Dependencies via CSPKG

cspkg install ecs_bootstrap --yes

If you are running officially released CovScript runtime version 3.4.1+, ecs is setup ready after this step.

(Optional) 3. Clone this repository to your machine

git clone https://github.com/covscript/ecs

(Optional) 4. Give execution permission to bootstrap script (for *nix only)

chmod +x ecs

(Optional) 5. Add absolute path of ecs to PATH environment variable of your OS

How to use

ecs command is a compiler that will translate ECS to CovScript 3, but can use like an 'interpreter' (will compile your code before run automatically).

Usage:
    ecs [options...] <FILE> [arguments...]
    ecs [options...]

Interpreter Options:
   -f            Disable compile cache
   -m            Disable beautify
   -c            Check grammar only
   -l            Lint check (requires file argument)
   -F            Format source file in-place
   -n            Dry-run format to stdout (implies -F)
   -g            Generate cSYM info
   -d            Run debugger
   -o <PATH>     Set output path
   -- <ARGS>     Pass parameters to CovScript

Interpreter REPL Options:
   -s            Close the command prompt
   -r <ARGS...>  Set arguments for REPL

Common Options:
    Option       Function
   -h            Show help information
   -v            Show version information
   -u <CHARSET>  Set unicode charset
                 CHARSET = {"AUTO", "UTF8", "GBK"}
   -i <PATH>     Append import path

Lint and Format

ECS includes a built-in linter and source formatter:

ecs -l myfile.ecs       # Lint check (naming conventions, unreachable code, etc.)
ecs -F myfile.ecs       # Format source file in-place
ecs -n myfile.ecs       # Dry-run format (print formatted output to stdout)

Compatibility Notice

1. The program translated by ECS Compiler will depend on package ecs.
2. The behavior of Lambda Expression will be very different.
3. Separated exception system. Please call e = ecs.handle_exception(e) to solve compatible problem in CovScript 3 when catch exception from ECS Packages.
4. To support new and gcnew operator with arguments, please define construct function separately.