Commit 448295c3 authored by Adrian Wuillemet's avatar Adrian Wuillemet
Browse files

Add testing information for codebase version to project readme

parent 432c04a5
Pipeline #3888 passed with stage
in 13 seconds
![SSG](media/ssg.png)
# Simple State Generator
___
Projekt zur Erzeugung von Code aus Fine State Machines.
# Simple State Generator
**Autoren**: Jakob Baatz, Pavel Nepke, Rico Possienka, Marco Wenning, Adrian Wuillemet
<br/>
## Userguide to Testing the tool
### 1. Requirements
The following requirements need to be installed on your system:
+ Python 3.x.x
+ Chrome or Chromium
If you do not have those installed you can download them here: [Python](https://www.python.org/downloads/) & [Chromium](https://chromium.woolyss.com)
<br/>
### 2. Setup
To get the pogram up and running open a terminal and follow the steps below:
First: Make sure you have the proper version of Python installed:
```shell
$ python --version
Python 3.7.3
```
Running the command should print something like the example python version. If a version of 2.x.x is printed try:
```shell
$ python3 --version
```
Second: To make life easier we recommend creating a temporary alias by doing the following:
```shell
$ alias ssg="python main.py"
#or if both versions are available
$ alias ssg="python3 main.py"
```
Then checkout the source code and navigate to the source/package directory. If you do not mind installing python libraries globally on your system
skip the first three commands:
```shell
# create a virtual environment for testing
$ python3 -m venv .
$ source bin/activate #Linux/Mac
$ .\Scripts\activate.bat #Windows
# install all python dependencies [this may take several seconds]
$ pip3 install click eel python-interface
# checkout the source code and navigate to the right folder
$ git clone https://gitlab.beuth-hochschule.de/s40242/stategen.git
$ cd stategen/source/package
```
Now you can start testing the tool!
<br/>
### 3. Running commands
You can now test the tool by running the following commands from the commandline:
```shell
# with alias ssg in place, other substitute ss with python3 main.py
$ ssg --help
# from here on you can navigate with all information provided by the help function.
# For convenience here are some things to try out:
$ ssg languages
$ ssg parse somefile.txt --language javascript -v
Projekt zur Erzeugung von Code aus Fine State Machines
\ No newline at end of file
$ ssg gui
```
\ No newline at end of file
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment