37 lines
1.4 KiB
Markdown
37 lines
1.4 KiB
Markdown
# 52. Patrol integration test
|
|
|
|
Date: 2024-04-10
|
|
|
|
## Status
|
|
|
|
Accepted
|
|
|
|
## Context
|
|
|
|
- A need for integration testing for Twake Mail mobile arised.
|
|
- The testing tool must be able to handle native UI and webview.
|
|
|
|
## Decision
|
|
|
|
- Patrol was chosen to write and test Twake Mail.
|
|
|
|
## Consequences
|
|
|
|
- Developers are now able to integration test Twake Mail
|
|
- Set up:
|
|
- Run `dart pub global activate patrol_cli` to enable Patrol CLI
|
|
- Install ngrok and jq
|
|
- Open docker and Android emulator/connect Android device
|
|
- Remember to use `dart-define` neccessary for each test command
|
|
- Test individual test locally by edit `scripts/patrol-local-integration-test-with-docker.sh`
|
|
- Replace `patrol test -v` with `patrol test -v -t path/to/test/file`
|
|
- Run the `scripts/patrol-local-integration-test-with-docker.sh`
|
|
- Test every tests locally by running `scripts/patrol-local-integration-test-with-docker.sh` script
|
|
- Read more about Patrol in [Patrol homepage](https://patrol.leancode.co/)
|
|
|
|
## Limitations
|
|
|
|
- Backend docker container is initiated before Patrol tests run, and close after all tests have run. This lead to no data isolation between tests
|
|
- Patrol gives no way of accessing Docker from system, due to when it runs, it bundle all tests into a single apk, and apk cannot access the system's terminal
|
|
- Tried https://github.com/testcontainers/testcontainers-java but also failed, with the same reason as Patrol.
|