Skip to content

Installation

gamster steht als Package auf pypi.org zur Verfügung. Nach der Installation (z.B. via uv oder pip) steht das gamster Programm zur Verfügung.

Normale Verwendung

Soll gamster zur normalen Verwendung installiert werden, empfehlen wir, das mit dem Programm uv zu erledigen. uv ist ein alternativer Paketmanager, der das Leben mit Python erheblich erleichtert. Allerdings muss uv zuerst installiert werden. Wie das geht, wird hier beschrieben.

Temporäre Installation

Ist uv installiert, kann gamster so ausprobiert werden:

uvx gamster

Die Installation wird gecached, so dass wiederholte Aufrufe weniger lange dauern.

Dauerhafte Installation

Mit Hilfe von uv kann man gamster auch dauerhaft installieren, so dass das Programm danach direkt via gamster (d.h. ohne davor gestelltes uvx) gestartet werden kann:

uv tool install gamster

Das bedeutet aber auch, dass auch eine neuere Version explizit installiert werden muss:

uv tool upgrade gamster

gamster deinstallieren

Wurde gamster via uv tool install kann es mit diesem Befehl wieder deinstalliert werden:

uv tool uninstall gamster

Installation ohne uv

Falls auch welchen Gründen auch immer uv nicht installiert werden kann, kann gamster auch ganz normal mit pip installiert werden:

pip install gamster

Danach muss aber immer zuerst das virtuelle Environment aktiviert werden, in dem gamster installiert worden ist.

Installation für Development

Soll weiter an gamspreprocessor gearbeitet werden, lässt sich eine dafür geeignete Umgebung mit wenigen Schritten herstellen:

  1. git clone https://zimlab.uni-graz.at/gams5/production/gamster.git
  2. cd gamster
  3. uv sync

Bitte beachten Sie, dass die eigentliche Entwicklung auf einer privaten GitLab Instanz stattfindet. Es gibt zwar einen Mirror auf Github, dieser akzeptiert aber keine Pull-Requests.