# arkcompiler_ets_frontend

**Repository Path**: petr-shumilov/arkcompiler_ets_frontend

## Basic Information

- **Project Name**: arkcompiler_ets_frontend
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 155
- **Created**: 2022-08-09
- **Last Updated**: 2024-06-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Es2panda

All in one JavaScript/TypeScript parser and compiler.

## Usage
```sh
es2panda [OPTIONS] [input file] -- [arguments]
```

## Optional arguments
 - `--debug-info`: Compile with debug info
 - `--dump-assembly`: Dump pandasm
 - `--dump-ast`: Dump the parsed AST
 - `--dump-debug-info`: Dump debug info
 - `--dump-size-stat`: Dump binary size statistics
 - `--extension`: Parse the input as the given extension (options: js | ts | as)
 - `--module`: Parse the input as module
 - `--opt-level`: Compiler optimization level (options: 0 | 1 | 2)
 - `--output`: Compiler binary output (.abc)
 - `--parse-only`: Parse the input only
 - `--strict`: Parse the input in strict mode

## Tail arguments
 - `input`: input file

## Running the tests
```sh
pip install tqdm dataclasses python-dotenv
```
```sh
python3 test/runner/runner.py [OPTIONS] [build_directory]
```

### Optional arguments
#### Test sets
 - `--regression`: Run regression tests
 - `--test262`: Run test262. To run tests from test262 set specify environment variables `TEST262_REVISION` and `TEST262_URL` in the `.env` file.
 - `--hermes`: Run Hermes runtime tests. To run tests from hermes set specify environment variables `HERMES_REVISION` and `HERMES_URL` in the `.env` file.

#### Extra arguments
 - `--no-progress`: Don't show progress bar
 - `--verbose`: Generates more detailed output

Other options are described at starter.py file

#### Tail arguments
 - `build_directory`: Path to panda build directory

### Execution time report
It is possible to collect statistics how long separate tests work. In the result report tests are grouped by execution time. 
The grouping edges are set in seconds in the environment variable `TIME_EDGES`. For example the value `1 5 10` specifies
4 groups - less than 1 second, from 1 second to 5 seconds, from 5 seconds to 10 seconds and from 10 seconds and more.
For the last group the report contains real durations.
 - Specify the option `--time-report`
 - Set an environment variable in the `.env` file in the format `TIME_EDGES="1 5 10"` 
 - After test run the short report will be output to the console
 - And full report will be created at the path `test/time_report.txt`

### Skip list
Skip list for the runtime: 
 - test262: `test/test262skiplist.txt, test/test262skiplist-long.txt`
 - hermes: `test/hermes-excluded.txt, test/hermes-excluded-aot-inline-full.txt`.