How-To: ToolBoxV2 als Developer nutzen¶

TL;DR¶

Developer-Profil für Mod-Entwicklung. Nutze tb manifest pack um Features zu verteilen.

Profil: Developer¶

Das Developer-Profil ist für Mod-Entwicklung und Core-Arbeit.

Mod-Entwicklung starten¶

# Developer-Profil setzen
# In tb-manifest.yaml:
app:
  profile: developer
  environment: development
  debug: true

mods:
  watch_modules:
    - MyMod

Feature packen¶

CLI Command¶

# Einzelnes Feature packen
tb manifest pack <feature>

# Beispiel
tb manifest pack cli
tb manifest pack web
tb manifest pack mymod

Pack-Vorgang¶

Der pack Command:

Liest Feature aus features/{name}/
Erstellt ZIP-Archiv in features_packed/
Inkludiert alle relevanten Dateien

# Feature-Struktur wird gescannt
features/
  cli/
    feature.yaml      ← Metadaten
    bin/              ← Ausführbare Dateien
    lib/              ← Libraries
    docs/             ← Dokumentation

# Output
features_packed/
  cli.zip             ← Verteilbares Archiv

Feature entpacken¶

# Feature aus ZIP entpacken
tb manifest unpack <path-to-zip>

# Beispiel
tb manifest unpack /path/to/myfeature.zip

Mod erstellen¶

Struktur¶

mods_dev/
  MyMod/
    __init__.py
    main.py           ← Mod-Logik
    feature.yaml      ← Mod-Metadaten
    requirements.txt

feature.yaml Beispiel¶

name: MyMod
version: 0.1.0
description: Mein erstes Modul
author: Developer

dependencies:
  - requests

entry_point: MyMod.main:MyTool

Mod laden¶

# Entwicklungsmodus mit Hot-Reload
tb dev

# Mods im Watch-Modus
tb manifest apply
# → mods.watch_modules wird überwacht

Mod registrieren¶

# mods_dev/MyMod/__init__.py
from toolboxv2 import MainTool

class MyTool(MainTool):
    name = "mymod"
    version = "0.1.0"

    async def run(self, args):
        print("MyMod ausgeführt!")

Mod testen¶

# Alle Mods testen
tb --test

Mods installieren¶

# Mod aus Registry installieren
tb registry install mymod

# Mod aus lokaler Datei
tb registry install --from ./mymod.zip

# Mod aus Git
tb registry install --git https://github.com/user/mymod

Manifest für Development¶

mods:
  init_modules:
    - CloudM
    - MyMod

  watch_modules:
    - MyMod         # Auto-Reload bei Änderungen

  open_modules:
    - CloudM.AuthManager

CLI-Tools für Developer¶

Command	Beschreibung
`tb manifest list`	Alle Features anzeigen
`tb manifest pack <f>`	Feature packen
`tb manifest unpack <p>`	Feature entpacken
`tb manifest enable <f>`	Feature aktivieren
`tb manifest disable <f>`	Feature deaktivieren
`tb manifest files <f>`	Feature-Dateien anzeigen

Tipps¶

Hot-Reload: Setze watch_modules für Auto-Reload
Debug: tb dev --debug für verbose Output
Testing: Nutze tb test --mod MyMod
Dokumentation: Erstelle docs/ im Mod-Verzeichnis