Zum Inhalt

Examples

Grundlegende Verwendung

Einfacher Download

form-download-helper /tmp/ozg ck@novareto.de mein-passwort 2 https://formulare.uv-kooperation.de/ozg/rul/ozg-90

Ausgabe:

Downloading from https://formulare.uv-kooperation.de/ozg/rul/ozg-90 (version=2)
  GET .../@@form-version-view?version=2
  GET .../@@uvcx-version-view?version=2&schema=simple
  GET .../@@pydantic-version-view?version=2
  GET .../@@version-view?version=2&schema=ui
  GET .../@@cpt-generator?version=2
    + schema.json
    + ui_schema.json
    + client_ui_schema.json
    + model.py
    + template.pt
    + form.py
    + __init__.py
    + test_ozg_90.py
    + test_acceptance.py
ozg_90 (form, v2_0) - 9 written

Wizard-Formular Download

Bei Wizard-Formularen werden automatisch die einzelnen Steps heruntergeladen:

Downloading from https://example.de/ozg/wizard-form (version=1)
    + schema.json
    + ui_schema.json
    + client_ui_schema.json
    + model.py
    + wizard_template.pt
    + form.py
  Step: step_1
  Step: step_2
  Step: step_3
  3 steps
wizard_form (wizard, v1_0) - 15 written

Batch-Processing

Mehrere Versionen herunterladen

#!/bin/bash
BASE_URI="https://formulare.uv-kooperation.de/ozg/rul/ozg-90"
USERNAME="ck@novareto.de"
PASSWORD="mein-passwort"
TARGET_DIR="/tmp/ozg"

# Versionen 1, 2 und 3 herunterladen
for version in 1 2 3; do
    echo "Downloading version $version..."
    form-download-helper "$TARGET_DIR" "$USERNAME" "$PASSWORD" "$version" "$BASE_URI"
done

Mehrere Formulare herunterladen

#!/bin/bash
USERNAME="ck@novareto.de"
PASSWORD="mein-passwort"
TARGET_DIR="/tmp/ozg"
VERSION=2

# Liste der Formular-URIs
FORMS=(
    "https://formulare.uv-kooperation.de/ozg/rul/ozg-90"
    "https://formulare.uv-kooperation.de/ozg/rul/ozg-91"
    "https://formulare.uv-kooperation.de/ozg/rul/ozg-92"
)

for form_uri in "${FORMS[@]}"; do
    echo "Downloading from $form_uri..."
    form-download-helper "$TARGET_DIR" "$USERNAME" "$PASSWORD" "$VERSION" "$form_uri"
done

CI/CD Integration

GitLab CI Job

download-forms:
  stage: prepare
  script:
    - python -m pip install uv
    - uv tool install "form-download-helper @ git+https://git.bg-kooperation.de/novareto/form_download_helper.git"
    - form-download-helper ./forms $FORM_USERNAME $FORM_PASSWORD 2 $FORM_URI
  artifacts:
    paths:
      - forms/
    expire_in: 1 day
  only:
    - main

GitHub Actions

name: Download Forms
on:
  workflow_dispatch:
  schedule:
    - cron: '0 2 * * *'  # Täglich um 2 Uhr

jobs:
  download:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-python@v4
        with:
          python-version: '3.13'
      - name: Install tool
        run: pip install git+https://git.bg-kooperation.de/novareto/form_download_helper.git
      - name: Download forms
        run: |
          form-download-helper ./forms \
            ${{ secrets.FORM_USERNAME }} \
            ${{ secrets.FORM_PASSWORD }} \
            2 \
            https://formulare.uv-kooperation.de/ozg/rul/ozg-90
      - name: Upload artifacts
        uses: actions/upload-artifact@v3
        with:
          name: forms
          path: forms/

Python Integration

Als Python-Modul verwenden

from pathlib import Path
from form_download_helper import DownloadOZG

# Downloader initialisieren
downloader = DownloadOZG(
    path="/tmp/ozg",
    uri="https://formulare.uv-kooperation.de/ozg/rul/ozg-90",
    username="ck@novareto.de",
    password="mein-passwort",
    version=2,
    package="myapp.forms",  # optional
)

# Download starten
downloader.get()

Mit Umgebungsvariablen

import os
from pathlib import Path
from form_download_helper import download

# Konfiguration aus Umgebung
config = {
    "path": Path(os.getenv("FORM_TARGET_DIR", "/tmp/ozg")),
    "username": os.getenv("FORM_USERNAME"),
    "password": os.getenv("FORM_PASSWORD"),
    "version": os.getenv("FORM_VERSION", "2"),
    "uri": os.getenv("FORM_URI"),
    "package": os.getenv("FORM_PACKAGE"),  # optional
}

# Download mit Fehlerbehandlung
try:
    download(**config)
    print("Download erfolgreich!")
except Exception as e:
    print(f"Fehler beim Download: {e}")

Erweiterte Konfiguration

Mit Docker

FROM python:3.13-slim

RUN pip install git+https://git.bg-kooperation.de/novareto/form_download_helper.git

WORKDIR /app
VOLUME ["/app/forms"]

ENTRYPOINT ["form-download-helper"]
CMD ["/app/forms", "user", "pass", "2", "https://formulare.uv-kooperation.de/ozg/rul/ozg-90"]
# Docker Container ausführen
docker run -v $(pwd)/forms:/app/forms \
  -e FORM_USERNAME=ck@novareto.de \
  -e FORM_PASSWORD=mein-passwort \
  form-downloader

Monitoring und Logging

import logging
from form_download_helper import DownloadOZG

# Logging konfigurieren
logging.basicConfig(
    level=logging.INFO,
    format="%(asctime)s - %(levelname)s - %(message)s",
    handlers=[logging.FileHandler("form_download.log"), logging.StreamHandler()],
)


class MonitoredDownloadOZG(DownloadOZG):
    def get(self):
        logging.info(f"Starting download from {self.uri}")
        try:
            super().get()
            logging.info("Download completed successfully")
        except Exception as e:
            logging.error(f"Download failed: {e}")
            raise


# Verwendung
downloader = MonitoredDownloadOZG(
    "/tmp/ozg",
    "https://formulare.uv-kooperation.de/ozg/rul/ozg-90",
    "ck@novareto.de",
    "mein-passwort",
    2,
)
downloader.get()