157 lines
3.7 KiB
Markdown
157 lines
3.7 KiB
Markdown
# Trading Market-Sim End-To-End Tests
|
|
|
|
This direcotry contains end-to-end tests for the trading application using vega-market-sim. This README will guide you through setting up your environment and running the tests.
|
|
|
|
## Prerequisites
|
|
|
|
- [Poetry](https://python-poetry.org/docs/#installing-with-the-official-installer)
|
|
- [Docker](https://www.docker.com/)
|
|
- [Python versions ">=3.9,<3.11"](https://www.python.org/)
|
|
|
|
## Getting Started
|
|
|
|
1. **Install Poetry**: Follow the instructions on the [official Poetry website](https://python-poetry.org/docs/#installing-with-the-official-installer).
|
|
2. **Install Docker**: Follow the instructions on the [official Docker website](https://docs.docker.com/desktop/).
|
|
3. **Install Python**: Follow the instructions on the [official Python website](https://www.python.org/)
|
|
**ensure you install a version between 3.9 and 3.11.**
|
|
4. **Start up a Poetry environment**: Execute the commands below to configure the Poetry environment.
|
|
|
|
### Ensure you are in the tests folder before running commands
|
|
|
|
```bash
|
|
poetry shell
|
|
```
|
|
|
|
5. **Install python dependencies**
|
|
|
|
To make sure you are on the latest version of our market-sim branch.
|
|
|
|
```bash
|
|
poetry update vega-sim
|
|
```
|
|
|
|
```bash
|
|
poetry install
|
|
```
|
|
|
|
6. **Install Playwright Browsers**: Execute the command below to browsers for Playwright.
|
|
|
|
```bash
|
|
playwright install chromium
|
|
```
|
|
|
|
7. **Download necessary binaries**:
|
|
Use the following command within your Python environment. The `--force` flag ensures the binaries are overwritten, and the `--version` specifies the desired version. e.g. `v0.73.4`
|
|
|
|
```bash
|
|
python -m vega_sim.tools.load_binaries --force --version $VEGA_VERSION
|
|
```
|
|
|
|
8. **Pull the desired Docker image**
|
|
|
|
```bash
|
|
docker pull vegaprotocol/trading:develop
|
|
```
|
|
|
|
9. **Run tests**: Poetry/Python will serve the app from docker
|
|
|
|
### Update the .env file with the correct trading image.
|
|
|
|
```bash
|
|
poetry run pytest
|
|
```
|
|
|
|
### Docker images
|
|
|
|
Pull the desired image:
|
|
|
|
**Testnet**
|
|
|
|
```bash
|
|
docker pull vegaprotocol/trading:develop
|
|
```
|
|
|
|
**Mainnet**
|
|
|
|
```bash
|
|
docker pull vegaprotocol/trading:main
|
|
```
|
|
|
|
Find all available images on [Docker Hub](https://hub.docker.com/r/vegaprotocol/trading/tags).
|
|
|
|
#### Create a Docker Image of Your Locally Built Trading App
|
|
|
|
To build your Docker image, use the following commands:
|
|
|
|
```bash
|
|
yarn nx build trading ./docker/prepare-dist.sh
|
|
```
|
|
|
|
```bash
|
|
docker build -f docker/node-outside-docker.Dockerfile --build-arg APP=trading --build-arg ENV_NAME=stagnet1 -t vegaprotocol/trading:latest .
|
|
```
|
|
|
|
## Running Tests 🧪
|
|
|
|
Before running make sure the docker daemon is running.
|
|
|
|
To run a specific test, use the `-k` option followed by the name of the test.
|
|
Run all tests:
|
|
|
|
```bash
|
|
poetry run pytest
|
|
```
|
|
|
|
Run a targeted test:
|
|
|
|
```bash
|
|
poetry run pytest -k "test_name" -s --headed
|
|
```
|
|
|
|
Run from anywhere:
|
|
|
|
```bash
|
|
yarn trading:test -- "test_name" -s --headed
|
|
```
|
|
|
|
Run using your locally served console:
|
|
|
|
Within one terminal
|
|
|
|
```bash
|
|
yarn nx build trading
|
|
```
|
|
|
|
```bash
|
|
yarn nx serve trading
|
|
|
|
```
|
|
|
|
Once console is served you can update the .env file to have local_server to true.
|
|
|
|
## Running Tests in Parallel 🔢
|
|
|
|
To run tests in parallel, use the `--numprocesses auto` option. The `--dist loadfile` setting ensures that multiple runners are not assigned to a single test file.
|
|
|
|
### From within the e2e folder:
|
|
|
|
```bash
|
|
poetry run pytest -s --numprocesses auto --dist loadfile
|
|
```
|
|
|
|
### From anywhere:
|
|
|
|
```bash
|
|
yarn trading:test:all
|
|
```
|
|
|
|
# Things to know
|
|
|
|
If you "intellisense" isn't working follow these steps:
|
|
|
|
1. ```bash
|
|
poetry run which python
|
|
```
|
|
|
|
2. Then open the command menu in vscode (cmd + shift + p) and type `select interpreter` , press enter, select enter interpreter path press enter then paste in the output from that above command you should get the right python again
|