gctools

gctools.exe

Installation

Zunächst muss uv, der Python-Paketmanager, installiert werden:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Im Anschluss git-Repository klonen (am Beispiel von Ordner C:\Projekte - im Grunde beliebig):

cd C:\Projekte
git clone https://git.global-cube.com/GlobalCube/gctools.git

Git erstellt einen Unterordner C:\Projekte\gctools, in dem das gesamte Projekt abgelegt ist. Jetzt müssen alle Requirements erfüllt werden: passende Python-Version, benötigte Module mit entsprechenden Abhängigkeiten. Das übernimmt uv

cd C:\Projekte\gctools
uv run gctools.py

Die Konsole meldet dann Folgendes:

(gctools) C:\Projekte\gctools>uv run gctools.py

 Usage: gctools.py [OPTIONS] COMMAND [ARGS]...

 gctools.exe - Hilfe unter https://docs.global-cube.com/5_Tasks/3_gctools/
 Version 1.0 vom 25.02.2025

╭─ Options ────────────────────────────────────────────────────────────────────────╮
│ --help          Show this message and exit.                                      │
╰──────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────╮
│ backup                                                                           │
│ c11                                                                              │
│ c7                                                                               │
│ db                                                                               │
│ misc                                                                             │
│ excel                                                                            │
│ status                                                                           │
╰──────────────────────────────────────────────────────────────────────────────────╯

Das Repository ist nun bereit für die Bearbeitung.

Deployment

Um das Package zu erstellen, muss lediglich die gctools.bat ausgeführt werden. Damit werden alle Projektdateien und Module zu einer großen exe-Datei zusammengefasst. Diese wird im Unterordner dist abgelegt.

In der gctools.bat ist noch ein Kopierbefehl für den Ordner P:\GCTools enthalten. Hier sollte immer die neueste Version abgelegt werden.

Dokumentation

Abgesehen von dieser Kurzanleitung ist die Dokumentation unter folgendem Link zu finden: https://docs.global-cube.com/5_Tasks/3_gctools/

Das entsprechende mkdocs-Repository liegt hier: https://github.com/Global-Cube/docs.git