Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/altwalker/live-viewer
A web application for visualizing the progress of an AltWalker test run.
https://github.com/altwalker/live-viewer
altwalker javascript model-based-testing python test-automation testing testing-tools
Last synced: 2 months ago
JSON representation
A web application for visualizing the progress of an AltWalker test run.
- Host: GitHub
- URL: https://github.com/altwalker/live-viewer
- Owner: altwalker
- License: gpl-3.0
- Created: 2022-11-04T09:03:41.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-08T12:02:32.000Z (10 months ago)
- Last Synced: 2024-04-08T13:26:21.953Z (10 months ago)
- Topics: altwalker, javascript, model-based-testing, python, test-automation, testing, testing-tools
- Language: Python
- Homepage: https://altwalker.github.io/live-viewer/
- Size: 2.54 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.rst
- License: LICENSE
Awesome Lists containing this project
README
# AltWalker's LiveViewer
A web application for visualizing the progress of an AltWalker test run.
AltWalker's LiveViewer is a powerful tool designed to enhance your experience with AltWalker. This application provides real-time visualization and monitoring capabilities for your AltWalker test runs, allowing you to gain deeper insights into test execution, track progress, and identify potential issues with ease. With AltWalker's LiveViewer, you can effortlessly keep an eye on the execution of
your test models and ensure the success of your testing endeavors.
## Setup
Before you begin using AltWalker's LiveViewer, make sure you have AltWalker installed. If you haven't already, you can follow the installation instructions [here](https://altwalker.github.io/altwalker/).
Install the AltWalker LiveViewer command-line tool:
```bash
pip install altwalker-live-viewer
```
To verify that the CLI was installed correctly, run:
```bash
altwalker-viewer --version
```
You should see the version information displayed:
```bash
altwalker-viewer, version 0.4s.0
```
## Running
To use `altwalker-viewer`, you'll need the following prerequisites:
* Test model(s)
* Test code for the model(s)
If you can run your tests using `altwalker online`, you already have everything you need for the LiveViewer.
The `altwalker-viewer online` command shares arguments and options with `altwalker online`. However, it includes the `-p` option to set up the WebSocket port.
To start the WebSocket server:
```bash
altwalker-viewer online path/to/tests/ -m path/to/model.json "generator(stop_condition)" -x [python|dotnet]
```
For example:
```bash
altwalker-viewer online tests -m models/default.json "random(never)"
```
Now, open your web browser and visit: .
If you want to run the frontend locally, you'll need to start a WebServer, which serves the LiveViewer frontend.
```bash
altwalker-viewer open
```
Now, open your web browser and visit: .
Please note that unlike the `altwalker walk` command, the `altwalker-viewer walk` command requires the `-m` option to specify the model files for displaying the models correctly.
For example:
```bash
altwalker-viewer walk -m models/main.json -m models/navigation.json steps.json
```
## Troubleshooting
If you encounter any issues while using the LiveViewer, consider the following steps:
1. **Check Model and Code Validity**: First, ensure that your models and code are valid by using the following commands:
* `altwalker check` for the model(s)
* `altwalker verify` for code
1. **Terminating GraphWalker Processes**: If you experience problems when running the `altwalker-viewer online` command, it's essential to check for any existing GraphWalker processes. If any GraphWalker processes are running, you should stop them before running the `altwalker-viewer online` command.
## Documentation
### Getting help on commands and option names
* `-h`, `--help`: Show a help message and exit.
```bash
altwalker-viewer --help
```
```bash
altwalker-viewer online --help
```
```bash
altwalker-viewer open --help
```
## Development Setup
* python3
* node
* npm
### Install npm dependencies
```bash
npm install
```
### Install PyPi dependencies
```bash
pip install -r requirements
```
### Build the Frontend
```bash
npm run build
```
```bash
npm run start
```
### Install the CLI
```bash
pip install -e .
```
### Community
For help, discussion about best practices, sharing ideas, projects, or any other conversation that benefits from being searchable:
* [Discuss AltWalker on GitHub](https://github.com/orgs/altwalker/discussions)
* [Google Group](https://groups.google.com/g/altwalker)
For casual chit-chat with us or with other members of the community:
* [Gitter Chat Room](https://groups.google.com/g/altwalker)
## License
This project is licensed under the [GNU General Public License v3.0](https://github.com/altwalker/live-viewer/blob/main/LICENSE).