# gctools.exe

## Installation

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

```cmd
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):

```cmd
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`

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

Die Konsole meldet dann Folgendes:

```txt
(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/](https://docs.global-cube.com/5_Tasks/3_gctools/)

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