3 Commits

Author SHA1 Message Date
martin 0c5774f695 install.sh: interaktive Abfragen bei Installation verbessert
- .env-Verschiebung aus Projektverzeichnis wird angeboten und bei Bestätigung automatisch ausgeführt
- Lokales Foto-Verzeichnis wird interaktiv abgefragt (mit Hinweis falls es bereits existiert)
- Ausführlicher Hinweis nach Anlegen der Default-.env mit Pflichtfeldern und nächsten Schritten
- bats-Hinweis entfernt (nur für Entwickler relevant)
- Tests: Umlaut-Mismatch in security.bats behoben, teardown() für Lock-Isolation ergänzt

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-20 12:47:10 +02:00
martin bc63739399 Merge pull request 'Robustheit: Error-Handling, Validation und Strukturverbesserungen' (#3) from feat/improve-sync-robustness into main 2026-04-19 21:05:41 +02:00
martin c4a9b4a33d Robustheit: Error-Handling, Validation und Strukturverbesserungen
- Neue darktable_common.sh mit gemeinsamen Funktionen (Logging, Validierung, Lock-Management)
- Verbesserte Fehlerbehandlung und aussagekräftige Error-Messages
- Explizite Validierung von SSH-Schlüssel, Pfaden und Konfiguration beim Start
- Sperrmechanismus zur Verhinderung paralleler Sync-Instanzen
- Bessere Strukturierung des Sync-Prozesses mit sauberer Fehlertoleranz

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-19 21:05:14 +02:00
5 changed files with 187 additions and 41 deletions
+42 -7
View File
@@ -37,9 +37,18 @@ CONFIG_ENV="$CONFIG_DIR/.env"
if [[ -f "$ENV_FILE" ]]; then
echo "Hinweis: .env im Projektverzeichnis gefunden."
echo " Bitte nach $CONFIG_ENV verschieben:"
read -r -p " Jetzt nach $CONFIG_ENV verschieben? [J/n]: " MOVE_ENV
if [[ "${MOVE_ENV,,}" != "n" ]]; then
mkdir -p "$CONFIG_DIR"
cp "$ENV_FILE" "$CONFIG_ENV"
chmod 600 "$CONFIG_ENV"
rm "$ENV_FILE"
echo " Erledigt: .env wurde verschoben."
else
echo " Nicht verschoben. Bitte manuell ausfuehren:"
echo " cp .env $CONFIG_ENV && chmod 600 $CONFIG_ENV"
fi
fi
if [[ -f "$CONFIG_ENV" ]]; then
echo "Konfiguration laden aus $CONFIG_ENV..."
@@ -49,6 +58,18 @@ if [[ -f "$CONFIG_ENV" ]]; then
set +a
fi
### Lokales Foto-Verzeichnis interaktiv abfragen
echo ""
if [[ -d "$LOCAL_PHOTO_DIR" ]]; then
read -r -p "Lokales Foto-Verzeichnis [${LOCAL_PHOTO_DIR}] (Verzeichnis existiert bereits): " INPUT_PHOTO_DIR
else
read -r -p "Lokales Foto-Verzeichnis [${LOCAL_PHOTO_DIR}]: " INPUT_PHOTO_DIR
fi
if [[ -n "$INPUT_PHOTO_DIR" ]]; then
LOCAL_PHOTO_DIR="$INPUT_PHOTO_DIR"
fi
### Konfiguration anzeigen
echo ""
@@ -84,11 +105,6 @@ if ! command -v zenity >/dev/null 2>&1 && ! command -v kdialog >/dev/null 2>&1;
echo " (Ohne Dialog-Tool wird ein Text-Fallback verwendet)"
fi
if ! command -v bats >/dev/null 2>&1; then
echo "Hinweis: 'bats' nicht gefunden (nur fuer Tests benoetigt)."
echo " sudo apt install bats"
fi
### Verzeichnisse pruefen
if [ ! -d "$LOCAL_PHOTO_DIR" ]; then
@@ -166,8 +182,27 @@ if [ ! -f "$CONFIG_ENV" ]; then
cp "$SCRIPT_DIR/.env.example" "$CONFIG_ENV"
chmod 600 "$CONFIG_ENV"
echo ""
echo "WICHTIG: Konfiguration anpassen:"
echo "=========================================================="
echo "WICHTIG: Konfiguration anpassen, bevor du Darktable startest"
echo "=========================================================="
echo ""
echo "Eine Vorlage wurde angelegt:"
echo " $CONFIG_ENV"
echo ""
echo "Mindestens diese Felder musst du eintragen:"
echo " SERVER_USER - dein SSH-Benutzer auf dem Server"
echo " SERVER_IP - IP-Adresse oder Hostname des Servers"
echo " SERVER_DB_DIR - Pfad zur Darktable-Datenbank auf dem Server"
echo " SERVER_PHOTO_DIR - Pfad zum Fotoverzeichnis auf dem Server"
echo ""
echo "LOCAL_PHOTO_DIR ist bereits auf '${LOCAL_PHOTO_DIR}' gesetzt."
echo ""
echo "Jetzt bearbeiten:"
echo " nano $CONFIG_ENV"
echo ""
echo "Danach install.sh erneut ausfuehren, damit die Verbindung"
echo "zum Server geprueft wird."
echo "=========================================================="
fi
### Desktop-Shortcuts installieren
+67
View File
@@ -93,6 +93,19 @@ ssh_server() {
-p "$SERVER_SSH_PORT" "$SERVER_USER@$SERVER_IP" "$@"
}
# Liefert den Unix-Timestamp (mtime) von library.db auf dem Server, oder "0" wenn nicht vorhanden.
server_db_mtime() {
ssh_server "stat -c '%Y' '$SERVER_DB_DIR/library.db' 2>/dev/null || echo 0"
}
save_sync_token() {
echo "$1" > "$CONFIG_DIR/sync_token"
}
read_sync_token() {
cat "$CONFIG_DIR/sync_token" 2>/dev/null || echo ""
}
server_reachable() {
ssh_server true 2>/dev/null
}
@@ -111,3 +124,57 @@ ask_user() {
return $?
fi
}
# Fragt den User wie mit einem Sync-Token-Konflikt umgegangen werden soll.
# Gibt "download", "upload" oder "abort" aus.
ask_conflict_resolution() {
local TITLE="Darktable Sync Konflikt"
local EXPLAIN="Ein anderer Rechner hat die Datenbank seit deinem letzten Sync verändert.\nDeine lokalen Änderungen wurden noch NICHT auf den Server übertragen.\n\nWas soll passieren?"
if command -v zenity &>/dev/null; then
local choice
choice=$(zenity --list \
--title="$TITLE" \
--text="$EXPLAIN" \
--radiolist \
--column="" --column="Aktion" --column="Beschreibung" \
TRUE "Herunterladen" "Server-Stand übernehmen (empfohlen)" \
FALSE "Hochladen erzwingen" "Lokale Version auf Server schreiben Server-Änderungen gehen verloren!" \
FALSE "Abbrechen" "Nichts tun Sync wird übersprungen" \
--width=520 --height=260 2>/dev/null) || true
case "$choice" in
"Hochladen erzwingen") echo "upload" ;;
"Abbrechen") echo "abort" ;;
*) echo "download" ;;
esac
elif command -v kdialog &>/dev/null; then
local btn
btn=$(kdialog --title "$TITLE" \
--menu "$EXPLAIN" \
download "Herunterladen (empfohlen)" \
upload "Hochladen erzwingen (Server-Änderungen gehen verloren!)" \
abort "Abbrechen" 2>/dev/null) || true
case "$btn" in
upload|abort) echo "$btn" ;;
*) echo "download" ;;
esac
else
echo ""
echo "=== $TITLE ==="
echo "Ein anderer Rechner hat die Datenbank seit deinem letzten Sync verändert."
echo "Deine lokalen Änderungen wurden noch NICHT auf den Server übertragen."
echo ""
echo " 1) Herunterladen (empfohlen) Server-Stand übernehmen"
echo " 2) Hochladen erzwingen lokale Version gewinnt, Server-Änderungen gehen verloren"
echo " 3) Abbrechen"
local ans
read -r -p "Auswahl [1/2/3, Standard: 1]: " ans || true
case "$ans" in
2) echo "upload" ;;
3) echo "abort" ;;
*) echo "download" ;;
esac
fi
}
+39
View File
@@ -117,6 +117,34 @@ if [ -n "$SERVER_VERSION" ]; then
log "Versionen übereinstimmend ($LOCAL_MM)."
fi
log "Sync-Token prüfen..."
SAVED_TOKEN=$(read_sync_token)
SERVER_TOKEN=$(server_db_mtime)
log " Gespeicherter Token: ${SAVED_TOKEN:-keiner (erster Sync)}"
log " Aktueller Server-Token: $SERVER_TOKEN"
UPLOAD_ALLOWED=true
if [ -n "$SAVED_TOKEN" ] && [ "$SAVED_TOKEN" != "$SERVER_TOKEN" ]; then
log "WARNUNG: Token-Konflikt (gespeichert=$SAVED_TOKEN, server=$SERVER_TOKEN) Benutzer wird gefragt."
RESOLUTION=$(ask_conflict_resolution)
log "Benutzerentscheidung: $RESOLUTION"
case "$RESOLUTION" in
upload)
log "Upload erzwungen lokale Version überschreibt Server."
;;
abort)
log "Sync abgebrochen durch Benutzer."
exit 0
;;
*)
log "Nur Download Server-Stand wird übernommen."
UPLOAD_ALLOWED=false
;;
esac
else
log "Token stimmt überein Upload erlaubt."
fi
log_step "Datenbank-Backup"
log " $LOCAL_DARKTABLE_DB_DIR/library.db → library.db.bak"
cp "$LOCAL_DARKTABLE_DB_DIR/library.db" "$LOCAL_DARKTABLE_DB_DIR/library.db.bak"
@@ -127,6 +155,10 @@ log "Backup abgeschlossen."
SYNC_LOG=$(mktemp)
TMPFILES+=("$SYNC_LOG")
SENT_DB=0
SENT_PHOTOS=0
if [ "$UPLOAD_ALLOWED" = true ]; then
log_step "Upload: Datenbank"
log " Quelle: $LOCAL_DARKTABLE_DB_DIR/"
log " Ziel: $SERVER_USER@$SERVER_IP:$SERVER_DB_DIR/"
@@ -161,6 +193,9 @@ if ! rsync -uavh --itemize-changes \
fi
SENT_PHOTOS=$(count_synced_files "$UPLOAD_LOG_PHOTOS" "up")
log "Foto-Upload abgeschlossen: $SENT_PHOTOS Datei(en) übertragen."
else
log "Upload übersprungen (Token-Konflikt)."
fi
log_step "Download: Datenbank"
log " Quelle: $SERVER_USER@$SERVER_IP:$SERVER_DB_DIR/"
@@ -196,6 +231,10 @@ fi
RECEIVED_PHOTOS=$(count_synced_files "$DOWNLOAD_LOG_PHOTOS" "down")
log "Foto-Download abgeschlossen: $RECEIVED_PHOTOS Datei(en) empfangen."
NEW_TOKEN=$(server_db_mtime)
save_sync_token "$NEW_TOKEN"
log "Sync-Token gespeichert: $NEW_TOKEN"
log "Versionsdatei aktualisieren: $LOCAL_DARKTABLE_DB_DIR/darktable_version"
echo "$LOCAL_VERSION" > "$LOCAL_DARKTABLE_DB_DIR/darktable_version"
+5
View File
@@ -23,6 +23,11 @@ SYNC_BIN=$HOME/.local/bin/darktable_sync.sh
EOF
}
# Raeumt nach jedem Test auf (verhindert Lock-Leakage zwischen Tests)
teardown() {
rm -rf "$CONFIG_DIR/sync.lock"
}
# Fuehrt ein Script mit dem Stubs-Verzeichnis vorne im PATH aus
run_with_stubs() {
run env PATH="$STUBS_DIR:$PATH" "$@"
+1 -1
View File
@@ -80,7 +80,7 @@ EOF
mkdir -p "$CONFIG_DIR/sync.lock"
run_with_stubs env SSH_STUB_FAIL=0 bash "$SYNC_SCRIPT"
[ "$status" -eq 1 ]
[[ "$output" == *"laeuft bereits"* ]]
[[ "$output" == *"läuft bereits"* ]]
rmdir "$CONFIG_DIR/sync.lock"
}