veroeffentliche_04.py: leserliche Ausgabe, 404-Probe entfernt

Der erste Alltagseinsatz zeigte drei Schoenheitsfehler, alle in der Ausgabe.

Der Bericht stand verkehrt herum: Die rsync-Zeilen erschienen VOR "Ziel:" und
"Vorpruefung bestanden". Python puffert seine Ausgabe blockweise, sobald sie
nicht an ein Terminal geht, waehrend der Unterprozess unmittelbar schreibt.
sys.stdout.reconfigure(line_buffering=True) stellt die Reihenfolge her.

150 Zeilen fuer eine uebertragene Datei: --itemize-changes lief auch im echten
Durchgang mit, obwohl der Probelauf schon berichtet hatte, was passieren wird.
149 der 150 Zeilen besagten nur ".f..t......" - Inhalt gleich, nur Zeitstempel
nachgezogen, die erwartbare Folge von --checksum. Die Auflistung bleibt jetzt
dem Probelauf vorbehalten.

Der Ersatz war zuerst schlimmer als das Problem: --info=progress2 zeigt am
Terminal eine sich selbst ueberschreibende Zeile, in einer Pipe dagegen jeden
Zwischenstand einzeln - gemessen 213 Zeilen fuer 213 Dateien. Die Anzeige
haengt jetzt an sys.stdout.isatty().

Ausserdem: Die 404-Probe auf anhang-glossar-literatur.html ist entfernt. Die
Datei ist geloescht - im Arbeitsbaum, in Git und auf dem Server -, und die
Probe koennte einen Rueckschritt gar nicht mehr entdecken: Sie bliebe auch
dann gruen, wenn jemand --delete aus dem rsync-Aufruf naehme. Was sie belegt
hat, steht in PROGRESS.md. Von vierzehn Adressen bleiben dreizehn.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Operations_Research_mit_Python_Version_04/veroeffentliche_04.py

@@ -56,9 +56,15 @@ QUELLEN = [
     os.path.join(BASIS, WEB_NAME),
 ]
 
-# Was nach dem Hochladen erreichbar sein MUSS bzw. NICHT MEHR erreichbar sein
-# darf. Die 404-Zeile ist die eigentliche Probe darauf, dass --delete gewirkt
-# hat: Sie war der Anlass fuer dieses Skript.
+# Was nach dem Hochladen erreichbar sein muss.
+#
+# Hier stand bis zur ersten Veroeffentlichung eine 404-Zeile fuer
+# 'anhang-glossar-literatur.html' - die Seite, die nach dem Teilen von Anhang
+# E/F verwaist auf dem Server zurueckblieb und der Anlass fuer dieses Skript
+# war. Sie hat ihren Zweck erfuellt und ist wieder entfernt: Die Datei ist
+# geloescht, und die Probe koennte einen Rueckschritt gar nicht mehr
+# entdecken - sie bliebe auch dann 404, wenn jemand --delete aus dem
+# rsync-Aufruf naehme. Was sie belegt hat, steht in PROGRESS.md.
 NACHPRUEFUNG = [
     ("", 200),
     ("index.html", 200),
@@ -73,7 +79,6 @@ NACHPRUEFUNG = [
     ("assets/site.css", 200),
     ("katex/katex.min.js", 200),
     (PDF_DATEINAME, 200),
-    ("anhang-glossar-literatur.html", 404),
 ]
 
 LOESCHGRENZE = 30
@@ -200,10 +205,25 @@ def rsync_befehl(env: dict[str, str], probelauf: bool) -> list[str]:
     # auf beiden Seiten faellt dagegen nicht ins Gewicht.
     befehl = ["rsync", "-rltz", "--checksum", "--delete", "--chmod=D755,F644",
               "--skip-compress=pdf/zip/woff2/png/jpg/svg",
-              "--itemize-changes",
               "-e", ssh_optionen(env)]
     if probelauf:
-        befehl.append("--dry-run")
+        # Nur der Probelauf listet auf - seine Ausgabe wird gelesen und
+        # ausgewertet. Der echte Lauf wiederholte diese Liste sonst auf dem
+        # Bildschirm, obwohl schon berichtet wurde, was passieren wird: beim
+        # ersten Einsatz waren das 150 Zeilen, von denen 149 nur besagten,
+        # dass rsync einen Zeitstempel nachgezogen hat.
+        befehl += ["--dry-run", "--itemize-changes"]
+    elif sys.stdout.isatty():
+        # Eine einzige, sich selbst ueberschreibende Fortschrittszeile - bei
+        # 23 MB ueber eine Hausleitung ist die Frage "laeuft es noch?"
+        # berechtigt.
+        #
+        # Nur am Terminal: progress2 ueberschreibt seine Zeile mit
+        # Wagenruecklauf. Laeuft die Ausgabe in eine Pipe oder Protokolldatei,
+        # bleibt jeder Zwischenstand als eigene Zeile stehen - gemessen
+        # 213 Zeilen fuer 213 Dateien, also genau das Rauschen, das hier
+        # abgestellt werden soll.
+        befehl.append("--info=progress2")
     ziel = env["OR_ZIEL"]
     befehl += [HTML_VERZ + os.sep,
                f'{env["OR_BENUTZER"]}@{env["OR_HOST"]}:{ziel}']
@@ -306,6 +326,13 @@ def main() -> int:
                           help="Schritt 4 ueberspringen (kein Netz zum Server)")
     argumente = zerleger.parse_args()
 
+    # Sonst puffert Python seine Ausgabe blockweise, sobald sie nicht an ein
+    # Terminal geht (Pipe, Protokolldatei, Aufruf aus einer anderen Oberflaeche
+    # heraus). Die Meldungen dieses Skripts erschienen dann NACH der Ausgabe
+    # des rsync-Unterprozesses, der unmittelbar schreibt - der Bericht stand
+    # also verkehrt herum auf dem Bildschirm.
+    sys.stdout.reconfigure(line_buffering=True)
+
     env = lies_env()
     ziel = f'{env["OR_BENUTZER"]}@{env["OR_HOST"]}:{env["OR_ZIEL"]}'
     print(f"Ziel: {ziel}")