0b28b754b0
## Description - This PR moves all specs from slim to fat container to run tests underneath it - Fat has the actual libraries that are being shipping to customers, hence this PR - Also includes moving Git tests from using GitHub to Gitea ## Type of change - New run (non-breaking change which adds functionality) ## How Has This Been Tested? - Cypress CI Fat runs ## Checklist: ### QA activity: - [X] Test plan has been approved by relevant developers - [X] Test plan has been peer reviewed by QA - [X] Cypress test cases have been added and approved by either SDET or manual QA - [X] Organized project review call with relevant stakeholders after Round 1/2 of QA - [X] Added Test Plan Approved label after reveiwing all Cypress test Co-authored-by: yatinappsmith <84702014+yatinappsmith@users.noreply.github.com>
60 lines
3.8 KiB
Markdown
60 lines
3.8 KiB
Markdown
# How can I contribute to the Cypress Test Suite?
|
|
|
|
1. Follow the setup document to set up [Appsmith locally](/contributions/ClientSetup.md) and go through [the docs](https://docs.appsmith.com). The docs are backed by the [appsmith-docs](https://github.com/appsmithorg/appsmith-docs) repository.
|
|
|
|
1. Once we have the setup in place, all dependencies will be available locally for test execution.
|
|
|
|
1. Cypress tests are located in the `app/client/cypress` directory.
|
|
|
|
1. All the test spec _must_ be in the integration directory only i.e `app/client/cypress/integration`
|
|
|
|
1. You can create directories under `app/client/cypress` but make sure you place the spec within the `app/client/cypress/integration` directory.
|
|
|
|
1. Directory name under `app/client/cypress/integration` suggests the specific area the test belongs to. Example: All our [Regression tests](<https://en.wikipedia.org/wiki/Smoke_testing_(software)>) are in `app/client/cypress/integration/Regression_TestSuite`
|
|
|
|
1. For default settings, check the `app/client/cypress.json` file.
|
|
|
|
1. You can create a local file `app/client/cypress.env.json` to populate `USERNAME` and `PASSWORD` env variables or use one of the methods [from their docs](https://docs.cypress.io/guides/guides/environment-variables.html#Setting).
|
|
|
|
```json
|
|
{
|
|
"USERNAME": "Enter username",
|
|
"PASSWORD": "Enter password"
|
|
}
|
|
```
|
|
|
|
1. Once the `app/client/cypress.env.json` file is ready, we can actually run tests from the cypress client.
|
|
|
|
1. Change your directory to `app/client`.
|
|
|
|
1. Cypress tests can be executed in 2 modes: run mode and open mode.
|
|
If you are willing to execute tests in headless mode through command line follow [run mode](https://docs.cypress.io/guides/guides/command-line.html#How-to-run-commands) else you can use cypress client to run in [open mode](https://docs.cypress.io/guides/guides/launching-browsers.html#Browsers)
|
|
|
|
1. Command to open cypress client `$(npm bin)/cypress open` Cypress supports Chrome/Firefox/electron browsers. Select a suitable browser and check the status of your tests.
|
|
|
|
1. For run mode, you can use CLI args. Example: To run the entire `Regression_TestSuite`, use `$(npm bin)/cypress run --headless --browser chrome --spec "cypress/integration/Regression_TestSuite/*/*"`
|
|
|
|
1. If you need help with writing the tests, their syntax or flow, cypress [getting started docs](https://docs.cypress.io/guides/core-concepts/introduction-to-cypress#What-you-ll-learn) is a great starting point.
|
|
|
|
## A word about env variables in Cypress tests
|
|
|
|
If you want to add a new env variable to cypress tests, add it to the `cypress.env.json` file and also in the documentation above.
|
|
|
|
All ENV variables from your `.env` file and all `APPSMITH_*` env variables from `process.env` are accessible with the `Cypress.env()` method.
|
|
## How do I add environment variables required for Cypress tests?
|
|
|
|
**Note:** This can only be done by the project maintainers. Please contact one of them if you require this step to be accomplished.
|
|
|
|
1. Go to [https://github.com/appsmithorg/appsmith/settings/secrets/actions](https://github.com/appsmithorg/appsmith/settings/secrets/actions).
|
|
1. Click on "New Repository Secret"
|
|
1. Add the secret key & value here. These values will be masked in the CI output logs incase they are printed out.
|
|
1. Save the value.
|
|
1. In the file `.github/workflows/client.yml`, find the steps named: "Setting up the cypress tests" & "Run the cypress test". These steps are responsible for setting up & executing the Cypress tests.
|
|
1. Add the env variable there in the form:
|
|
|
|
```
|
|
YOUR_SECRET_KEY: ${{ secrets.APPSMITH_YOUR_SECRET_KEY }}
|
|
```
|
|
|
|
1. Commit & push the file `.github/workflows/client.yml` to the default branch (`release`). Please remember that the changes to the build file will not take effect unless they are committed against the default branch.
|