Installation

  • Pythons: Python 3.5, 3.6, 3.7, 3.8, 3.9, PyPy3

  • Platforms: Unix/Posix and Windows

  • PyPI package name: altwalker

Prerequisites

Python

Note

On Windows, make sure you add Python and Python Scripts in the Path from System Variables:

  • C:\Python<version>\ (e.g., C:\Python39\)

  • C:\Python<version>\Scripts\ (e.g., C:\Python39\Scripts\)

And your local Python Scripts directory in the Path from User Variables:

  • C:\Users\<user-name>\AppData\Local\Programs\Python\Python<version>\Scripts\

GraphWalker

AltWalker relies on GraphWalker to generate paths through your model(s).

AltWalker uses the GraphWalker CLI, the CLI is a standalone jar file. You need to have Java 11 installed to be able to execute the jar file.

You need to download GraphWalker CLI from GitHub Releases and create a script to run the jar file from the command line. We recommend downloading the latest version of GraphWalker CLI.

To install GraphWalker you can run the following command:

$ wget -q -O - https://raw.githubusercontent.com/altwalker/graphwalker-installer/main/install-graphwalker.py
$ python install-graphwalker.py

or

$ git clone https://github.com/altwalker/graphwalker-installer.git
$ cd graphwalker-installer
$ python install-graphwalker.py

Checkout graphwalker-installer for a more detailed tutorial.

After installing GraphWalker check that you installed the correct version:

$ gw --version
org.graphwalker version: 4.3.2-408d9b4

org.graphwalker is open source software licensed under MIT license
The software (and it's source) can be downloaded from http://graphwalker.org
For a complete list of this package software dependencies, see http://graphwalker.org/archive/site/graphwalker-cli/dependencies.html

Currently the latest version is:

org.graphwalker version: 4.3.2-408d9b4
...

Install altwalker

To install altwalker run the following command in your command line:

$ pip install -U altwalker

Or:

$ python<version> -m pip install -U altwalker

Check that you installed the correct version:

$ altwalker --version
AltWalker, version 0.3.1

Living on the edge

If you want to work with the latest code before it’s released, install or update the code from the develop branch:

$ pip install -U git+https://github.com/altwalker/altwalker

Install .NET Core (Optional)

.NET Core is required by AltWalker when you want to write your tests in a .NET supported language.

  • Install .NET Core Runtime - enables AltWalker to execute compiled tests. Preferred in production environment.

  • Install .NET Core SDK - enables AltWalker to use dotnet to compile and run your tests. Preferred in development environment.

The dotnet command needs to be available under /usr/bin/dotnet. Installing .NET Core with snap makes the dotnet command available under a different path. In this case create a symbolic link:

$ ln -s /path/to/dotnet /usr/bin/dotnet