Installation

Pythons: Python 3.4, 3.5, 3.6, 3.7, 3.8, PyPy3

Platforms: Unix/Posix and Windows

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

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

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

And in the Path from User Variables:

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

Prerequisites

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 8 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 https://github.com/GraphWalker/graphwalker-project/releases/download/4.2.0/graphwalker-cli-4.2.0.jar && \
  mkdir -p ~/graphwalker && \
  mv graphwalker-cli-4.2.0.jar ~/graphwalker/ && \
  echo -e '#!/bin/bash\njava -jar ~/graphwalker/graphwalker-cli-4.2.0.jar "$@"' > ~/graphwalker/graphwalker-cli.sh && \
  chmod +x ~/graphwalker/graphwalker-cli.sh && \
  ln -s ~/graphwalker/graphwalker-cli.sh /usr/local/bin/gw

Here is a more detailed tutorial for macOS/linux.

$ setx PATH "%PATH%;C:\graphwalker" & :: Adds graphwalker to current user PATH
  cd C:\
  mkdir graphwalker
  cd graphwalker
  powershell -Command "[Net.ServicePointManager]::SecurityProtocol = 'tls12'; Invoke-WebRequest -Uri 'https://github.com/GraphWalker/graphwalker-project/releases/download/4.2.0/graphwalker-cli-4.2.0.jar' -outfile 'graphwalker-cli-4.2.0.jar'" & :: Downloads graphwalker using powershell command Invoke-Request
  @echo off
  @echo @echo off> gw.bat
  @echo java -jar C:\graphwalker\graphwalker-cli-4.2.0.jar %*>> gw.bat
  @echo on

After installing GraphWalker check that you installed the correct version:

$ gw --version
org.graphwalker version: 4.2.0-9395540

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.2.0-9395540
...

Install altwalker

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

$ pip3 install altwalker

Or:

$ python<version> -m pip install altwalker

Check that you installed the correct version:

$ altwalker --version
AltWalker, version 0.2.7

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:

$ pip3 install -U git+https://gitlab.com/altom/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