Metadata-Version: 2.1
Name: altwalker-live-viewer
Version: 0.4.2
Summary: A web application for visualizing the progress of an AltWalker test run.
Author-email: Altom Consulting <altwalker@altom.com>, Dezmerean Robert <dezmereanrobert@gmail.com>
License: GNU GPLv3
Project-URL: Homepage, https://github.com/altwalker/live-viewer
Project-URL: Repository, https://github.com/altwalker/live-viewer.git
Project-URL: Bug Tracker, https://github.com/altwalker/live-viewer/issues
Keywords: model-based-testing,testing,tests,testing-framework
Classifier: Development Status :: 4 - Beta
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Other Audience
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: C#
Classifier: Programming Language :: Cython
Classifier: Programming Language :: Python :: Implementation
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Software Development :: Testing :: Acceptance
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: altwalker >=0.4.0
Requires-Dist: websockets
Requires-Dist: requests
Provides-Extra: debug
Requires-Dist: rich ; extra == 'debug'

# 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.

![Screenshot](https://raw.githubusercontent.com/altwalker/live-viewer/main/img/screenshot.png)

## 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: <https://altwalker.github.io/live-viewer/>.

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: <http://localhost:8000/>.

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).
