{"id":19925284,"url":"https://github.com/altwalker/live-viewer","last_synced_at":"2025-05-03T08:30:59.985Z","repository":{"id":195783841,"uuid":"561687901","full_name":"altwalker/live-viewer","owner":"altwalker","description":"A web application for visualizing the progress of an AltWalker test run.","archived":false,"fork":false,"pushed_at":"2024-04-08T12:02:32.000Z","size":2664,"stargazers_count":3,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-04-08T13:26:21.953Z","etag":null,"topics":["altwalker","javascript","model-based-testing","python","test-automation","testing","testing-tools"],"latest_commit_sha":null,"homepage":"https://altwalker.github.io/live-viewer/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/altwalker.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.rst","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-11-04T09:03:41.000Z","updated_at":"2024-04-08T13:26:22.781Z","dependencies_parsed_at":"2023-10-10T19:38:10.986Z","dependency_job_id":"3b1506d4-82aa-4652-a082-cec38d4b46a5","html_url":"https://github.com/altwalker/live-viewer","commit_stats":null,"previous_names":["altwalker/live-viewer"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/altwalker%2Flive-viewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/altwalker%2Flive-viewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/altwalker%2Flive-viewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/altwalker%2Flive-viewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/altwalker","download_url":"https://codeload.github.com/altwalker/live-viewer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224355832,"owners_count":17297631,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["altwalker","javascript","model-based-testing","python","test-automation","testing","testing-tools"],"created_at":"2024-11-12T22:21:39.488Z","updated_at":"2024-11-12T22:21:40.122Z","avatar_url":"https://github.com/altwalker.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AltWalker's LiveViewer\n\nA web application for visualizing the progress of an AltWalker test run.\n\nAltWalker'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\nyour test models and ensure the success of your testing endeavors.\n\n![Screenshot](https://raw.githubusercontent.com/altwalker/live-viewer/main/img/screenshot.png)\n\n## Setup\n\nBefore 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/).\n\nInstall the AltWalker LiveViewer command-line tool:\n\n```bash\npip install altwalker-live-viewer\n```\n\nTo verify that the CLI was installed correctly, run:\n\n```bash\naltwalker-viewer --version\n```\n\nYou should see the version information displayed:\n\n```bash\naltwalker-viewer, version 0.4s.0\n```\n\n## Running\n\nTo use `altwalker-viewer`, you'll need the following prerequisites:\n\n* Test model(s)\n* Test code for the model(s)\n\nIf you can run your tests using `altwalker online`, you already have everything you need for the LiveViewer.\n\nThe `altwalker-viewer online` command shares arguments and options with `altwalker online`. However, it includes the `-p` option to set up the WebSocket port.\n\nTo start the WebSocket server:\n\n```bash\naltwalker-viewer online path/to/tests/ -m path/to/model.json \"generator(stop_condition)\" -x [python|dotnet]\n```\n\nFor example:\n\n```bash\naltwalker-viewer online tests -m models/default.json \"random(never)\"\n```\n\nNow, open your web browser and visit: \u003chttps://altwalker.github.io/live-viewer/\u003e.\n\nIf you want to run the frontend locally, you'll need to start a WebServer, which serves the LiveViewer frontend.\n\n```bash\naltwalker-viewer open\n```\n\nNow, open your web browser and visit: \u003chttp://localhost:8000/\u003e.\n\nPlease 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.\n\nFor example:\n\n```bash\naltwalker-viewer walk -m models/main.json -m models/navigation.json steps.json\n```\n\n## Troubleshooting\n\nIf you encounter any issues while using the LiveViewer, consider the following steps:\n\n1. **Check Model and Code Validity**: First, ensure that your models and code are valid by using the following commands:\n\n    * `altwalker check` for the model(s)\n    * `altwalker verify` for code\n\n1. **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.\n\n## Documentation\n\n### Getting help on commands and option names\n\n* `-h`, `--help`: Show a help message and exit.\n\n```bash\naltwalker-viewer --help\n```\n\n```bash\naltwalker-viewer online --help\n```\n\n```bash\naltwalker-viewer open --help\n```\n\n## Development Setup\n\n* python3\n* node\n* npm\n\n### Install npm dependencies\n\n```bash\nnpm install\n```\n\n### Install PyPi dependencies\n\n```bash\npip install -r requirements\n```\n\n### Build the Frontend\n\n```bash\nnpm run build\n```\n\n```bash\nnpm run start\n```\n\n### Install the CLI\n\n```bash\npip install -e .\n```\n\n### Community\n\nFor help, discussion about best practices, sharing ideas, projects, or any other conversation that benefits from being searchable:\n\n* [Discuss AltWalker on GitHub](https://github.com/orgs/altwalker/discussions)\n* [Google Group](https://groups.google.com/g/altwalker)\n\nFor casual chit-chat with us or with other members of the community:\n\n* [Gitter Chat Room](https://groups.google.com/g/altwalker)\n\n## License\n\nThis project is licensed under the [GNU General Public License v3.0](https://github.com/altwalker/live-viewer/blob/main/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faltwalker%2Flive-viewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faltwalker%2Flive-viewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faltwalker%2Flive-viewer/lists"}