This documentation is deprecated and should no longer be used.
Please, check the new documentation at https://altwalker.github.io/altwalker/, which is being actively maintained.
Also note that all projects related to AltWalker were moved from GitLab to GitHub, you can find the new projects at https://github.com/altwalker.
Pythons: Python 3.5, 3.6, 3.7, 3.8, 3.9, PyPy3
Platforms: Unix/Posix and Windows
PyPI package name: altwalker
On Windows, make sure you add Python and Python Scripts in the Path from System Variables:
And your local Python Scripts directory in the Path from User Variables:
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 https://github.com/GraphWalker/graphwalker-project/releases/download/4.3.1/graphwalker-cli-4.3.1.jar && \ mkdir -p ~/.graphwalker && \ mv graphwalker-cli-4.3.1.jar ~/.graphwalker/ && \ echo -e '#!/bin/bash\njava -jar ~/.graphwalker/graphwalker-cli-4.3.1.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.3.1/graphwalker-cli-4.3.1.jar' -outfile 'graphwalker-cli-4.3.1.jar'" & :: Downloads graphwalker using powershell command Invoke-Request @echo off @echo @echo off> gw.bat @echo java -jar C:\graphwalker\graphwalker-cli-4.3.1.jar %*>> gw.bat @echo on
After installing GraphWalker check that you installed the correct version:
$ gw --version org.graphwalker version: 4.3.1-6273494 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.1-6273494 ...
altwalker run the following command in your command line:
$ pip3 install -U altwalker
$ 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:
$ 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.
dotnet command needs to be available under
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