{"id":58,"date":"2026-10-24T21:40:00","date_gmt":"2026-10-24T19:40:00","guid":{"rendered":"https:\/\/www.bloy.info\/?p=58"},"modified":"2026-10-24T18:19:33","modified_gmt":"2026-10-24T16:19:33","slug":"nextcloud-nach-einem-umzug-pruefen-mit-einem-python-skript","status":"publish","type":"post","link":"https:\/\/www.bloy.info\/index.php\/2026\/10\/24\/nextcloud-nach-einem-umzug-pruefen-mit-einem-python-skript\/","title":{"rendered":"Nextcloud nach einem Umzug pr\u00fcfen \u2013 mit einem Python-Skript"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Die neue Nextcloud ist eingerichtet, die Datenbank importiert und die Dateien liegen wieder an ihrem Platz. Die Anmeldeseite l\u00e4sst sich \u00f6ffnen. Aber funktioniert auch das, was im Alltag gebraucht wird?<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ein kleiner Funktionstest hilft, diese Frage systematisch anzugehen. Das Skript <code>nextcloud_basistest.py<\/code> f\u00fchrt typische Zugriffe aus und zeigt jeden Schritt mit Zeitstempel an. Parallel lassen sich die Nextcloud- und Webserver-Logs beobachten. So wird aus dem eher zuf\u00e4lligen Ausprobieren ein nachvollziehbarer Testlauf.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Was wird gepr\u00fcft?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Zun\u00e4chst fragt das Skript den Serverstatus ab. Es pr\u00fcft, ob Nextcloud als installiert gemeldet wird, der Wartungsmodus ausgeschaltet ist und kein Datenbank-Upgrade angefordert wird. Anschlie\u00dfend ruft es die Anmeldeseite ab, authentifiziert den Benutzer \u00fcber die API und liest die vom Server bereitgestellten F\u00e4higkeiten ab. Der Abruf der Anmeldeseite ist dabei noch kein Test einer Anmeldung im Browser.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Danach folgen Dateioperationen \u00fcber WebDAV. Diese Schnittstelle erlaubt es Programmen, Dateien und Ordner auf dem Server zu verwalten. Das Skript erstellt einen eigenen Testordner und pr\u00fcft darin Upload, Download, Aktualisierung, Kopieren, Verschieben und L\u00f6schen. Ein Dateiname mit Umlauten und Leerzeichen pr\u00fcft zus\u00e4tzlich den Umgang mit Sonderzeichen. Eine zuf\u00e4llig erzeugte Bin\u00e4rdatei mit standardm\u00e4\u00dfig acht MiB wird hochgeladen und wieder heruntergeladen. Der Vergleich ihrer SHA-256-Pr\u00fcfsummen pr\u00fcft, ob der Inhalt unver\u00e4ndert zur\u00fcckkommt.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">F\u00fcr Termine und Aufgaben legt das Skript einen eigenen Kalender an, f\u00fcr Kontakte ein eigenes Adressbuch. Die Eintr\u00e4ge werden erstellt, gelesen, \u00fcber DAV-Abfragen gesucht, aktualisiert und gel\u00f6scht. Daf\u00fcr verwendet das Programm CalDAV und CardDAV, zwei Erweiterungen von WebDAV.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">So wird das Skript gestartet<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Ben\u00f6tigt werden Python 3, die erreichbare HTTPS-Adresse der Nextcloud und ein Benutzerkonto. Zus\u00e4tzliche Python-Pakete sind nicht erforderlich. Das Skript kann auf einem normalen Arbeitsplatzrechner laufen; ein Start direkt auf dem Server ist nicht n\u00f6tig.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Nach dem Herunterladen im Terminal in den betreffenden Ordner wechseln und starten:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>python3 nextcloud_basistest.py https:\/\/cloud.example.de --user vorname.nachname<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Die Beispieladresse und den Benutzernamen durch die eigenen Angaben ersetzen. Bei einer Installation in einem Unterverzeichnis geh\u00f6rt dieses zur Adresse, etwa <code>https:\/\/example.de\/nextcloud<\/code>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Das Passwort wird verdeckt abgefragt. Vorzugsweise wird daf\u00fcr ein eigenes App-Passwort verwendet. Es muss nicht im Skript hinterlegt werden und erscheint auch nicht in der Befehlszeile. Die Verbindung pr\u00fcft das HTTPS-Zertifikat; automatische Weiterleitungen werden nicht verfolgt. Deshalb sollte direkt die endg\u00fcltige Adresse angegeben werden.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">F\u00fcr das Beobachten der Logs kann der Lauf langsamer erfolgen, indem das Skript durch Pausen unterbroche wird. Die Zahl hinten gibt die L\u00e4nge der Pause in Sekunden an (siehe Tabelle):<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>python3 nextcloud_basistest.py https:\/\/cloud.example.de \\\n  --user vorname.nachname --pause 3<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Die Pause folgt auf jede erfolgreiche Pr\u00fcfung. Sie gilt nicht f\u00fcr jede einzelne HTTP-Anfrage.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Option<\/th><th>Bedeutung<\/th><\/tr><\/thead><tbody><tr><td><code>--pause 3<\/code><\/td><td>Drei Sekunden Pause nach erfolgreichen Pr\u00fcfungen<\/td><\/tr><tr><td><code>--mib 32<\/code><\/td><td>Bin\u00e4rdatei mit 32 MiB verwenden; erlaubt sind 1 bis 128 MiB<\/td><\/tr><tr><td><code>--timeout 120<\/code><\/td><td>Socket-Timeout f\u00fcr Netzwerkoperationen auf 120 Sekunden setzen; kein Gesamtzeitlimit des Laufs<\/td><\/tr><tr><td><code>--no-dav<\/code><\/td><td>Kalender-, Aufgaben- und Kontakttests auslassen; Datei-WebDAV wird weiterhin gepr\u00fcft<\/td><\/tr><tr><td><code>--help<\/code><\/td><td>Hilfe anzeigen<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Zum Mitschreiben der Ausgabe eignet sich unter Bash:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>set -o pipefail\npython3 nextcloud_basistest.py https:\/\/cloud.example.de \\\n  --user vorname.nachname --pause 3 2&gt;&amp;1 | tee nextcloud-test.log<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><code>tee<\/code> zeigt die Ausgabe an und schreibt sie gleichzeitig in eine Datei. <code>pipefail<\/code> sorgt daf\u00fcr, dass ein Fehlerstatus des Python-Skripts trotz der Weiterleitung an <code>tee<\/code> im Status der Befehlskette ber\u00fccksichtigt wird. Das Protokoll enth\u00e4lt unter anderem Serveradresse, Benutzerpfade und Testnamen, aber kein Passwort.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Die Ausgabe verstehen<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Jeder Test erh\u00e4lt ein <code>OK<\/code> oder <code>FEHLER<\/code>. Zus\u00e4tzlich erscheinen die HTTP-Methode, der angefragte Pfad, der HTTP-Status und die gemessene Dauer. Eine abschlie\u00dfende \u00dcbersicht fasst die ausgef\u00fchrten Pr\u00fcfungen zusammen. Nicht gestartete Folgepr\u00fcfungen werden nicht als eigene Ergebnisse aufgef\u00fchrt: Scheitert beispielsweise das Anlegen des Testordners, werden die davon abh\u00e4ngigen Dateioperationen ausgelassen.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Typische Statuscodes sind <code>200<\/code> f\u00fcr einen erfolgreichen Abruf, <code>201<\/code> f\u00fcr ein neu angelegtes Objekt und <code>204<\/code> f\u00fcr eine erfolgreiche Operation ohne Antwortinhalt. DAV-Abfragen liefern h\u00e4ufig <code>207<\/code>, weil ihre Antwort mehrere Teilergebnisse enth\u00e4lt.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ein <code>404<\/code> ist beim gezielten Kontrollabruf nach einer L\u00f6schung ausdr\u00fccklich erwartet: Die Datei soll dann nicht mehr vorhanden sein. Solche erfolgreichen Negativpr\u00fcfungen k\u00f6nnen trotzdem in Zugriffslogs auftauchen.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Bei Fehlern helfen Zeitstempel und Pfad beim Vergleich mit den Serverlogs. Der Zeitstempel nutzt die lokale Zeitzone des Rechners; Serverlogs k\u00f6nnen UTC verwenden. Die Testkennung beginnt mit <code>NC-Test-<\/code> und steht au\u00dferdem in den Namen der Testdaten. Das Skript sendet sie als <code>X-Request-ID<\/code>; ob diese Kennung im Serverlog erscheint, h\u00e4ngt von Server und Proxy ab. Eine vom Server zur\u00fcckgelieferte Request-ID wird ebenfalls angezeigt. Fehlende Logmeldungen allein beweisen daher keinen erfolgreichen Test.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Das Python-Programm nachvollziehen<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Zum Einstieg lohnt sich das Lesen von <code>main()<\/code> und <code>run()<\/code> am Dateiende. <code>main()<\/code> verarbeitet die Startparameter und fragt das Passwort ab. <code>run()<\/code> legt die Reihenfolge fest und st\u00f6\u00dft das Aufr\u00e4umen an.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Die Klasse <code>Test<\/code> b\u00fcndelt die Einstellungen und Ergebnisse eines Laufs. <code>self<\/code> steht innerhalb ihrer Methoden f\u00fcr das aktuelle Testobjekt. <code>self.results<\/code> ist beispielsweise die Ergebnisliste, auf die mehrere Methoden zugreifen.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Zwei Methoden tragen den gr\u00f6\u00dften Teil der Arbeit: <code>req()<\/code> sendet eine HTTP-Anfrage und kontrolliert den Statuscode. <code>check()<\/code> f\u00fchrt einen einzelnen Pr\u00fcfauftrag aus, f\u00e4ngt normale Fehler ab und schreibt das Ergebnis in die Liste.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ein h\u00e4ufiger Ausdruck lautet:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>self.check('Testordner auflisten', lambda: self.prop(folder, '1'))<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><code>lambda<\/code> erzeugt hier eine kleine Funktion ohne Namen. Sie wird an <code>check()<\/code> \u00fcbergeben. Erst dort wird sie ausgef\u00fchrt, damit Erfolg und Fehler einheitlich behandelt werden k\u00f6nnen. Die Einr\u00fcckung legt in Python fest, welche Zeilen zu einer Funktion, Schleife oder Bedingung geh\u00f6ren.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Weitere Kommentare im Skript erkl\u00e4ren unter anderem den Unterschied zwischen Text und Bytes, JSON- und XML-Antworten, Schleifen, Pr\u00fcfsummen und die Fehlerbehandlung mit <code>try<\/code>, <code>except<\/code> und <code>finally<\/code>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Aufr\u00e4umen und Grenzen<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Vorhandene Dateien und Eintr\u00e4ge werden nicht bearbeitet. Das Skript arbeitet mit eigenen, praktisch eindeutig benannten Testsammlungen. Am Ende versucht ein <code>finally<\/code>-Block, diese wieder zu entfernen \u2013 auch bei vielen Fehlern oder einem normalen Abbruch. Ein nicht erreichbarer Server oder ein hart beendeter Prozess kann das verhindern. In diesem Fall lassen sich verbliebene Sammlungen an ihrem Namen erkennen. Im Papierkorb und in Dateiversionen k\u00f6nnen ebenfalls Testreste bleiben; diese Bereiche werden nicht pauschal geleert.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ein erfolgreicher Lauf best\u00e4tigt die ausgef\u00fchrten Operationen mit diesem Benutzerkonto. Er best\u00e4tigt nicht, dass alle importierten Dateien lesbar, alle alten Freigaben korrekt oder s\u00e4mtliche Kalender vollst\u00e4ndig sind. Auch Mailversand, Hintergrundjobs, externe Speicher, Browserbedienung und Collabora werden nicht getestet. F\u00fcr die Abnahme einer Migration sollten deshalb zus\u00e4tzlich einige vorhandene Dateien, Kalender und Freigaben gezielt mit dem vorherigen Stand verglichen werden.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Warnung:<\/strong> F\u00fchre fremde Skripte nur aus, wenn du ihre Funktionsweise verstehst und dem Code vertraust!<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Dieses Skript wurde mit KI erstellt, kurz durchgesehen und bisher ausschlie\u00dflich auf einem Testsystem erprobt. Eine umfassende Pr\u00fcfung hat nicht stattgefunden.<\/p>\n<\/blockquote>\n\n\n\n<pre class=\"wp-block-code\"><code>#!\/usr\/bin\/env python3\n\"\"\"Nextcloud-Basistest \u2013 ausf\u00fchrlich kommentierte Lernfassung.\n\nAufruf:\n    python3 nextcloud_basistest.py https:\/\/cloud.example.org --user NAME\n\nVoraussetzungen: Python 3, erreichbare HTTPS-Adresse, Benutzerkonto und\nvorzugsweise ein App-Passwort. Zus\u00e4tzliche Python-Pakete sind nicht n\u00f6tig.\n\nAblauf: Status und Anmeldung -&gt; Dateien -&gt; Kalender\/Aufgaben -&gt; Kontakte\n        -&gt; eigene Testdaten entfernen -&gt; Ergebnis\u00fcbersicht.\n\nBestehende Nutzdaten werden nicht bearbeitet. Gel\u00f6schte Testdateien k\u00f6nnen\nim Papierkorb oder als Versionen verbleiben. Bei Verbindungsabbr\u00fcchen oder\nhartem Beenden k\u00f6nnen auch Testsammlungen zur\u00fcckbleiben.\n\nNicht gepr\u00fcft: Browserbedienung, Mail, Cron, externe Speicher, Freigaben\nzwischen Benutzern, Collabora sowie die Vollst\u00e4ndigkeit des Datenimports.\n\nR\u00fcckgabewerte f\u00fcr die Shell:\n    0 = alle ausgef\u00fchrten Pr\u00fcfungen erfolgreich\n    1 = mindestens ein Fehler bzw. unerwarteter Abbruch\n    2 = ung\u00fcltige Kommandozeilenargumente\n    130 = Abbruch durch Strg+C oder SIGTERM\n\nLesetipp: Zuerst main() und run() am Dateiende lesen. Danach check() und\nreq(): Diese beiden Methoden organisieren fast alle einzelnen Pr\u00fcfungen.\n\"\"\"\n# Alle folgenden Module geh\u00f6ren zur Python-Standardbibliothek.\n# argparse verarbeitet --user usw.; getpass liest ein Passwort ohne Anzeige.\nimport argparse\nimport base64\nimport datetime as dt\nimport getpass\nimport hashlib\nimport json\nimport os\nimport signal\nimport sys\nimport time\n# urllib \u00fcbernimmt HTTPS-Anfragen, URL-Kodierung und HTTP-Fehler.\n# Die Kurzformen U und R sind frei gew\u00e4hlte Abk\u00fcrzungen f\u00fcr Module.\nimport urllib.error\nimport urllib.parse as U\nimport urllib.request as R\nimport uuid\n# ElementTree (hier E) liest XML, das DAV f\u00fcr Anfragen und Antworten nutzt.\nimport xml.etree.ElementTree as E\n\n# Diese Klasse erweitert den HTTPRedirectHandler aus urllib.\n# Bei einer Weiterleitung soll der Benutzer die endg\u00fcltige URL angeben.\n# So werden Zugangsdaten nicht automatisch an eine andere Zieladresse geschickt.\nclass NoRedirect(R.HTTPRedirectHandler):\n    def redirect_request(self, req, fp, code, msg, headers, newurl):\n        \"\"\"Verhindert das automatische Folgen von HTTP-Weiterleitungen.\"\"\"\n        return None\n\n# Eine Klasse b\u00fcndelt Daten und dazugeh\u00f6rige Funktionen (Methoden).\n# self bezeichnet jeweils das aktuelle Test-Objekt. self.results bleibt\n# beispielsweise auch zwischen zwei Methodenaufrufen erhalten.\nclass Test:\n    def __init__(self, args, password):\n        \"\"\"Speichert Einstellungen und bereitet einen einzelnen Testlauf vor.\"\"\"\n        self.a = args\n        # rstrip entfernt abschlie\u00dfende Schr\u00e4gstriche, damit URL-Teile zusammenpassen.\n        self.base = args.url.rstrip('\/')\n        # Datum plus zuf\u00e4llige UUID ergibt eine praktisch eindeutige Testkennung.\n        # Mit dieser Kennung hei\u00dfen auch Ordner, Kalender und Adressbuch.\n        self.tag = 'NC-Test-' + dt.datetime.now().strftime('%Y%m%d-%H%M%S-') + uuid.uuid4().hex&#91;:10]\n        # HTTP Basic Auth kodiert Benutzername:Passwort als Base64.\n        # Base64 ist KEINE Verschl\u00fcsselung; den Transport sch\u00fctzt hier HTTPS.\n        # encode() macht Text zu Bytes, decode() macht Bytes wieder zu Text.\n        self.auth = 'Basic ' + base64.b64encode((args.user + ':' + password).encode()).decode()\n        # Der Opener ist der HTTP-Client. Die normale TLS-Zertifikatspr\u00fcfung bleibt aktiv.\n        self.http = R.build_opener(NoRedirect())\n        # Eine leere Liste f\u00fcr Ergebnis-Tupel: (Testname, Status, Fehlerbeschreibung).\n        self.results = &#91;]\n        # Hier merken wir nur Sammlungen, deren Erstellung erfolgreich best\u00e4tigt wurde.\n        # Die Liste ist sp\u00e4ter der Arbeitsauftrag zum Aufr\u00e4umen.\n        self.cleanup = &#91;]\n        self.uid = args.user\n\n    def log(self, text):\n        \"\"\"Schreibt eine Meldung mit lokaler Uhrzeit sofort ins Terminal.\"\"\"\n        # Ein fester ISO-Zeitstempel mit Zeitzone erleichtert den Logvergleich.\n        # flush=True verhindert, dass Meldungen lange im Ausgabepuffer liegen.\n        print(dt.datetime.now().astimezone().isoformat(timespec='seconds'), text, flush=True)\n\n    def req(self, method, path, data=None, headers=None, codes=(200,), auth=True):\n        \"\"\"Sendet eine HTTP-Anfrage und pr\u00fcft ihren Statuscode. Liefert Inhalt und Header.\"\"\"\n        url = self.base + path\n        # Header sind Zusatzinformationen zur Anfrage, gespeichert als Dictionary.\n        # X-Request-ID tr\u00e4gt die Testkennung; Server\/Proxy k\u00f6nnen sie ersetzen.\n        # Die Antwortkennung wird deshalb ebenfalls ausgegeben.\n        h = {'User-Agent': 'Nextcloud-Basistest\/1.0', 'X-Request-ID': self.tag}\n        if auth:\n            h&#91;'Authorization'] = self.auth\n        # Optionale zus\u00e4tzliche Header \u00fcberschreiben bzw. erg\u00e4nzen die Vorgaben.\n        # None bedeutet: nicht angegeben. headers or {} nimmt dann ein leeres Dictionary.\n        h.update(headers or {})\n        # Textk\u00f6rper werden vor dem Versenden in UTF-8-Bytes umgewandelt.\n        if isinstance(data, str):\n            data = data.encode()\n        self.log(f'  {method} {path}')\n        # Eine monotone Uhr misst Dauer unabh\u00e4ngig von \u00c4nderungen der Systemzeit.\n        start = time.monotonic()\n        try:\n            # with schlie\u00dft die Antwort auch bei einem Fehler zuverl\u00e4ssig.\n            # r.read() l\u00e4dt den gesamten Antwortinhalt in den Arbeitsspeicher.\n            with self.http.open(R.Request(url, data=data, headers=h, method=method), timeout=self.a.timeout) as r:\n                status, body, rh = r.status, r.read(), r.headers\n        # urllib behandelt z. B. 404 als Ausnahme. F\u00fcr einen L\u00f6schtest ist 404\n        # aber gewollt. Deshalb lesen wir den HTTP-Fehler wie eine normale Antwort.\n        # Netzwerk- und TLS-Fehler gehen weiter an die aufrufende Fehlerbehandlung.\n        except urllib.error.HTTPError as e:\n            status, body, rh = e.code, e.read(), e.headers\n        self.log(f'  HTTP {status}; {time.monotonic()-start:.2f}s; Request-ID: {rh.get(\"X-Request-ID\", \"-\")}')\n        # codes ist ein Tupel erlaubter Statuscodes; (200,) enth\u00e4lt genau einen Wert.\n        # Ein unerwarteter Status l\u00f6st eine Ausnahme aus, die check() protokolliert.\n        if status not in codes:\n            # Do not print response bodies: they may contain personal information.\n            raise RuntimeError(f'HTTP {status}, erwartet {codes}; bei 3xx kanonische HTTPS-URL verwenden')\n        # Zwei Werte werden als Tupel zur\u00fcckgegeben: Antwort-Bytes und Antwort-Header.\n        return body, rh\n\n    def check(self, label, fn):\n        \"\"\"F\u00fchrt eine Pr\u00fcfung aus, protokolliert Erfolg oder Fehler und gibt True\/False zur\u00fcck.\"\"\"\n        self.log('TEST: ' + label)\n        try:\n            # fn ist eine \u00fcbergebene Funktion. Erst die Klammern f\u00fchren sie aus.\n            fn()\n        # Ein normaler Testfehler wird aufgezeichnet, statt den gesamten Lauf zu stoppen.\n        # Strg+C (KeyboardInterrupt) geh\u00f6rt nicht zu diesen normalen Exceptions.\n        except Exception as e:\n            self.results.append((label, 'FEHLER', str(e)))\n            self.log('FEHLER: ' + str(e))\n            return False\n        self.results.append((label, 'OK', ''))\n        self.log('OK: ' + label)\n        # Die eingestellte Pause folgt erfolgreichen Pr\u00fcfungen, nicht jeder HTTP-Anfrage.\n        time.sleep(self.a.pause)\n        return True\n\n    def ocs(self, path):\n        \"\"\"Ruft die Nextcloud-API auf und entpackt deren JSON-Antwort.\"\"\"\n        # OCS ist eine Nextcloud-API. Der Header kennzeichnet den API-Aufruf.\n        # Der Unterstrich _ hei\u00dft hier: Den zweiten R\u00fcckgabewert brauchen wir nicht.\n        raw, _ = self.req('GET', '\/ocs\/v2.php\/' + path + '?format=json', headers={'OCS-APIRequest': 'true'})\n        # JSON ist ein Textformat f\u00fcr strukturierte Daten.\n        # json.loads wandelt es in Python-Dictionaries und Listen um.\n        obj = json.loads(raw)&#91;'ocs']\n        # Der API-Status im JSON wird zus\u00e4tzlich zum HTTP-Status gepr\u00fcft.\n        if str(obj&#91;'meta']&#91;'statuscode']) not in ('100', '200'):\n            raise RuntimeError('OCS-Anfrage meldet keinen Erfolg')\n        return obj&#91;'data']\n\n    def prop(self, path, depth='0'):\n        \"\"\"Liest DAV-Eigenschaften; Depth 0 betrifft das Objekt, Depth 1 auch direkte Kinder.\"\"\"\n        body, _ = self.req('PROPFIND', path,\n            '&lt;d:propfind xmlns:d=\"DAV:\"&gt;&lt;d:prop&gt;&lt;d:resourcetype\/&gt;&lt;d:getetag\/&gt;&lt;d:getcontentlength\/&gt;&lt;\/d:prop&gt;&lt;\/d:propfind&gt;',\n            {'Depth': depth, 'Content-Type': 'application\/xml'}, (207,))\n        # XML wird als Baum gelesen. {DAV:} ist ein XML-Namensraum.\n        # Bei 207 Multi-Status m\u00fcssen auch die Teilergebnisse betrachtet werden.\n        root = E.fromstring(body)\n        responses = root.findall('{DAV:}response')\n        if not responses:\n            raise RuntimeError('Leere DAV-Multistatus-Antwort')\n        for response in responses:\n            # Eine List Comprehension erzeugt hier die Liste der Statuszeilen.\n            # Nicht jede angefragte Eigenschaft ist bei jedem Objekttyp vorhanden;\n            # mindestens eine erfolgreiche Eigenschaft je Antwort ist hier erforderlich.\n            statuses = &#91;s.text or '' for s in response.findall('.\/\/{DAV:}status')]\n            if not statuses or not any(' 200 ' in s for s in statuses):\n                raise RuntimeError('DAV-Teilergebnis ohne erfolgreiche Eigenschaften')\n        return root\n\n    def status(self):\n        \"\"\"Pr\u00fcft die \u00f6ffentliche Statusantwort auf grundlegende Betriebsprobleme.\"\"\"\n        raw, _ = self.req('GET', '\/status.php', auth=False)\n        s = json.loads(raw)\n        if not s.get('installed') or s.get('maintenance') or s.get('needsDbUpgrade'):\n            raise RuntimeError('Nicht installiert, Wartungsmodus oder Datenbank-Upgrade erforderlich')\n        self.log('Nextcloud-Version: ' + str(s.get('versionstring', '?')))\n\n    def user(self):\n        \"\"\"Ermittelt die interne Benutzer-ID f\u00fcr die folgenden DAV-Adressen.\"\"\"\n        # Anmeldename und interne ID k\u00f6nnen sich unterscheiden.\n        # F\u00fcr die DAV-Pfade verwenden wir die ID aus der Serverantwort.\n        self.uid = self.ocs('cloud\/user')&#91;'id']\n\n    def equal(self, path, expected):\n        \"\"\"L\u00e4dt eine Datei herunter und vergleicht ihren Inhalt \u00fcber SHA-256.\"\"\"\n        body, _ = self.req('GET', path)\n        # Ein Hash ist ein Fingerabdruck der Bytes. Gleiche SHA-256-Werte sind hier\n        # ein sehr zuverl\u00e4ssiger Inhaltsvergleich, aber kein eigener Sicherheitstest.\n        if hashlib.sha256(body).digest() != hashlib.sha256(expected).digest():\n            raise RuntimeError('Heruntergeladener Inhalt stimmt nicht \u00fcberein')\n\n    def files(self):\n        \"\"\"Pr\u00fcft Dateioperationen in einem eigens erzeugten Testordner.\"\"\"\n        # quote macht Sonderzeichen URL-tauglich. safe=\"\" kodiert auch \/ in der ID.\n        root = '\/remote.php\/dav\/files\/' + U.quote(self.uid, safe='') + '\/'\n        folder = root + self.tag + '\/'\n        # lambda: ... ist eine kleine Funktion ohne Namen.\n        # check bekommt damit einen Arbeitsauftrag, den es kontrolliert ausf\u00fchrt.\n        self.check('Dateiliste und Metadaten im Benutzerverzeichnis', lambda: self.prop(root, '1'))\n        # Nur wenn der neue Ordner best\u00e4tigt wurde, werden dort Schreibtests gestartet.\n        if not self.check('Testordner anlegen', lambda: self.req('MKCOL', folder, codes=(201,))):\n            return\n        self.cleanup.append(folder)\n        file = folder + U.quote('Pr\u00fcfung mit Leerzeichen \u00e4\u00f6\u00fc.txt')\n        content = ('Nextcloud Migrationstest ' + self.tag + '\\nGr\u00fc\u00dfe aus dem Basistest.\\n').encode()\n        # PUT l\u00e4dt Daten hoch. If-None-Match: * verbietet das \u00dcberschreiben\n        # einer bereits vorhandenen Datei bei diesem ersten Upload.\n        if self.check('Textdatei hochladen', lambda: self.req('PUT', file, content, {'If-None-Match': '*'}, (201,))):\n            self.check('Download mit Inhaltsvergleich', lambda: self.equal(file, content))\n            # Das b vor dem Text erzeugt direkt Bytes. + h\u00e4ngt weitere Bytes an.\n            changed = content + b'Updated\\n'\n            if self.check('Eigene Testdatei aktualisieren', lambda: self.req('PUT', file, changed, codes=(204,))):\n                self.check('Aktualisierten Inhalt pr\u00fcfen', lambda: self.equal(file, changed))\n            # COPY dupliziert, MOVE verschiebt. Destination ist die vollst\u00e4ndige Ziel-URL.\n            # Overwrite: F verhindert das \u00dcberschreiben vorhandener Ziele.\n            copied, moved = folder + 'Kopie.txt', folder + 'Verschoben.txt'\n            if self.check('Datei kopieren', lambda: self.req('COPY', file, headers={'Destination': self.base+copied, 'Overwrite':'F'}, codes=(201,))):\n                if self.check('Kopie verschieben', lambda: self.req('MOVE', copied, headers={'Destination':self.base+moved,'Overwrite':'F'}, codes=(201,))):\n                    # Der bedingte Ausdruck X if Bedingung else Y w\u00e4hlt den erwarteten Inhalt.\n                    # any(...) pr\u00fcft, ob der Aktualisierungstest zuvor erfolgreich war.\n                    self.check('Verschobene Datei lesen', lambda: self.equal(moved, changed if any(x&#91;0]=='Eigene Testdatei aktualisieren' and x&#91;1]=='OK' for x in self.results) else content))\n                    self.check('Einzeldatei l\u00f6schen', lambda: self.req('DELETE', moved, codes=(204,)))\n                    # 404 ist HIER Erfolg: Die gerade gel\u00f6schte Datei soll nicht mehr abrufbar sein.\n                    self.check('L\u00f6schung pr\u00fcfen (404 hier erwartet)', lambda: self.req('GET', moved, codes=(404,)))\n        self.check('Testordner auflisten', lambda: self.prop(folder, '1'))\n        # Zufallsbytes pr\u00fcfen auch nicht textbasierte Inhalte.\n        # 1 MiB = 1024 * 1024 Bytes. Upload und Download liegen jeweils im RAM.\n        # Dies ist ein einzelner PUT-Upload, kein Chunk-Upload wie bei manchen Clients.\n        blob = os.urandom(self.a.mib * 1024 * 1024)\n        big = folder + 'Binaertest.bin'\n        if self.check(f'Bin\u00e4rdatei hochladen ({self.a.mib} MiB)', lambda: self.req('PUT', big, blob, {'If-None-Match':'*'}, (201,))):\n            self.check('Bin\u00e4rdatei vollst\u00e4ndig vergleichen', lambda: self.equal(big, blob))\n\n    def collection(self, kind):\n        \"\"\"Erzeugt einen eigenen Testkalender oder ein eigenes Testadressbuch.\"\"\"\n        # == vergleicht zwei Werte; das Ergebnis ist True oder False.\n        # Ein gemeinsamer Ablauf bedient Kalender und Adressb\u00fccher.\n        cal = kind == 'calendar'\n        parent = '\/remote.php\/dav\/' + ('calendars\/' if cal else 'addressbooks\/users\/') + U.quote(self.uid, safe='') + '\/'\n        self.check(('CalDAV' if cal else 'CardDAV') + ' Sammlungen abrufen', lambda: self.prop(parent, '1'))\n        path = parent + self.tag + '\/'\n        # Kalender werden mit MKCALENDAR angelegt, Adressb\u00fccher mit erweitertem MKCOL.\n        if cal:\n            method = 'MKCALENDAR'\n            xml = '&lt;c:mkcalendar xmlns:c=\"urn:ietf:params:xml:ns:caldav\" xmlns:d=\"DAV:\"&gt;&lt;d:set&gt;&lt;d:prop&gt;&lt;d:displayname&gt;'+self.tag+'&lt;\/d:displayname&gt;&lt;c:supported-calendar-component-set&gt;&lt;c:comp name=\"VEVENT\"\/&gt;&lt;c:comp name=\"VTODO\"\/&gt;&lt;\/c:supported-calendar-component-set&gt;&lt;\/d:prop&gt;&lt;\/d:set&gt;&lt;\/c:mkcalendar&gt;'\n        else:\n            method = 'MKCOL'\n            xml = '&lt;d:mkcol xmlns:d=\"DAV:\" xmlns:c=\"urn:ietf:params:xml:ns:carddav\"&gt;&lt;d:set&gt;&lt;d:prop&gt;&lt;d:resourcetype&gt;&lt;d:collection\/&gt;&lt;c:addressbook\/&gt;&lt;\/d:resourcetype&gt;&lt;d:displayname&gt;'+self.tag+'&lt;\/d:displayname&gt;&lt;\/d:prop&gt;&lt;\/d:set&gt;&lt;\/d:mkcol&gt;'\n        if not self.check('Eigene Testsammlung anlegen: '+kind, lambda: self.req(method, path, xml, {'Content-Type':'application\/xml'}, (201,))):\n            return\n        self.cleanup.append(path)\n        # Kalender werden mit MKCALENDAR angelegt, Adressb\u00fccher mit erweitertem MKCOL.\n        if cal:\n            # iCalendar erwartet hier UTC; das Z am Ende steht f\u00fcr UTC.\n            stamp = dt.datetime.now(dt.timezone.utc).strftime('%Y%m%dT%H%M%SZ')\n            # VEVENT ist ein Termin, VTODO eine Aufgabe. Beide liegen im Testkalender.\n            # Das feste Termindatum ist Testinhalt; Einladungen werden nicht erzeugt.\n            items = &#91;('termin.ics', 'VEVENT', 'DTSTART:20300101T120000Z\\r\\nDTEND:20300101T123000Z'), ('aufgabe.ics','VTODO','STATUS:NEEDS-ACTION\\r\\nPERCENT-COMPLETE:0')]\n            # Die for-Schleife verarbeitet Termin und Aufgabe nacheinander.\n            # Das Tupel wird dabei direkt in drei benannte Variablen zerlegt.\n            for name, component, fields in items:\n                # f-Strings setzen Ausdr\u00fccke in {geschweiften Klammern} in Text ein.\n                # \\r\\n erzeugt die vom Austauschformat verwendeten Zeilenenden.\n                text = f'BEGIN:VCALENDAR\\r\\nVERSION:2.0\\r\\nPRODID:-\/\/NC Basistest\/\/DE\\r\\nBEGIN:{component}\\r\\nUID:{uuid.uuid4()}\\r\\nDTSTAMP:{stamp}\\r\\nSUMMARY:{self.tag}\\r\\n{fields}\\r\\nEND:{component}\\r\\nEND:VCALENDAR\\r\\n'\n                self.dav_item(path+name, text, 'text\/calendar', component, 'calendar')\n        else:\n            # vCard ist das Austauschformat f\u00fcr Kontakte. Die .invalid-Adresse ist Testinhalt.\n            text = f'BEGIN:VCARD\\r\\nVERSION:3.0\\r\\nUID:{uuid.uuid4()}\\r\\nFN:{self.tag}\\r\\nN:Test;Nextcloud;;;\\r\\nEMAIL:nextcloud-test@example.invalid\\r\\nEND:VCARD\\r\\n'\n            self.dav_item(path+'kontakt.vcf', text, 'text\/vcard', 'VCARD', 'addressbook')\n\n    def dav_item(self, path, text, mime, component, kind):\n        \"\"\"Pr\u00fcft ein einzelnes Kalender-, Aufgaben- oder Kontaktobjekt.\"\"\"\n        if not self.check(component+' anlegen', lambda: self.req('PUT', path, text, {'Content-Type':mime,'If-None-Match':'*'}, (201,))):\n            return\n        def read():\n            \"\"\"Pr\u00fcft, ob das gelesene Objekt Testkennung und erwarteten Objekttyp enth\u00e4lt.\"\"\"\n            raw, _ = self.req('GET', path)\n            if self.tag not in raw.decode() or ('BEGIN:'+component) not in raw.decode():\n                raise RuntimeError('DAV-Inhalt fehlt')\n        self.check(component+' lesen', read)\n        # CalDAV f\u00fcr Kalender, CardDAV f\u00fcr Kontakte: beide erweitern WebDAV.\n        ns = 'urn:ietf:params:xml:ns:caldav' if kind=='calendar' else 'urn:ietf:params:xml:ns:carddav'\n        # REPORT sucht Objekte innerhalb einer Sammlung; GET liest ein einzelnes Objekt.\n        # Die XML-Abfrage filtert bei Kalendern nach Termin oder Aufgabe.\n        query = f'&lt;c:{kind}-query xmlns:c=\"{ns}\" xmlns:d=\"DAV:\"&gt;&lt;d:prop&gt;&lt;d:getetag\/&gt;&lt;\/d:prop&gt;'\n        query += ('&lt;c:filter&gt;&lt;c:comp-filter name=\"VCALENDAR\"&gt;&lt;c:comp-filter name=\"'+component+'\"\/&gt;&lt;\/c:comp-filter&gt;&lt;\/c:filter&gt;' if kind=='calendar' else '&lt;c:filter\/&gt;')\n        query += f'&lt;\/c:{kind}-query&gt;'\n        def report():\n            \"\"\"Fragt die Sammlung ab und sucht das zuvor angelegte Objekt in der Antwort.\"\"\"\n            raw, _ = self.req('REPORT', path.rsplit('\/',1)&#91;0]+'\/', query, {'Content-Type':'application\/xml','Depth':'1'}, (207,))\n            root = E.fromstring(raw)\n            # href enth\u00e4lt die Adresse eines gefundenen Objekts.\n            # unquote wandelt URL-kodierte Zeichen wieder in normalen Text um.\n            hrefs = &#91;U.unquote(e.text or '') for e in root.findall('.\/\/{DAV:}href')]\n            if not any(h.endswith(path.rsplit('\/',1)&#91;1]) for h in hrefs):\n                raise RuntimeError('Angelegtes Objekt fehlt in REPORT-Abfrage')\n        self.check(component+' per DAV-REPORT finden', report)\n        # replace erzeugt neuen Text mit ge\u00e4nderter Zusammenfassung bzw. ge\u00e4ndertem Namen.\n        updated = text.replace('SUMMARY:'+self.tag, 'SUMMARY:'+self.tag+' aktualisiert') if kind=='calendar' else text.replace('FN:'+self.tag, 'FN:'+self.tag+' aktualisiert')\n        if self.check(component+' aktualisieren', lambda: self.req('PUT', path, updated, {'Content-Type':mime}, (204,))):\n            def verify_update():\n                \"\"\"Liest erneut und sucht die Markierung der vorgenommenen \u00c4nderung.\"\"\"\n                raw, _ = self.req('GET', path)\n                if (self.tag+' aktualisiert').encode() not in raw:\n                    raise RuntimeError('Aktualisierung fehlt im gelesenen Objekt')\n            self.check(component+' Aktualisierung pr\u00fcfen', verify_update)\n        if self.check(component+' l\u00f6schen', lambda: self.req('DELETE', path, codes=(204,))):\n            self.check(component+' L\u00f6schung pr\u00fcfen (404 erwartet)', lambda: self.req('GET', path, codes=(404,)))\n\n    def run(self):\n        \"\"\"Steuert den Gesamtbetrieb und versucht im finally-Block aufzur\u00e4umen.\"\"\"\n        self.log('START '+self.tag+' | '+self.base)\n        self.log('Nur eigene Testdaten; Papierkorb\/Versionen k\u00f6nnen Testreste enthalten.')\n        try:\n            self.check('\u00d6ffentlicher Serverstatus', self.status)\n            self.check('Login-Seite abrufen', lambda: self.req('GET','\/index.php\/login',auth=False))\n            if not self.check('Authentifizierung und Benutzerkennung', self.user):\n                return 1\n            self.check('OCS Capabilities', lambda: self.ocs('cloud\/capabilities'))\n            self.check('WebDAV-Einstieg', lambda: self.prop('\/remote.php\/dav\/'))\n            self.files()\n            if not self.a.no_dav:\n                self.collection('calendar')\n                self.collection('addressbook')\n        # finally l\u00e4uft auch bei einer Ausnahme und normalerweise auch bei Strg+C.\n        # Ein harter Prozessabbruch oder nicht erreichbarer Server kann Aufr\u00e4umen verhindern.\n        finally:\n            self.log('AUFR\u00c4UMEN')\n            # In umgekehrter Reihenfolge werden die best\u00e4tigten Testsammlungen gel\u00f6scht.\n            # lambda p=path h\u00e4lt den aktuellen Schleifenwert als Standardargument fest.\n            # 404 beim Aufr\u00e4umen ist akzeptiert: Die Sammlung ist dann schon nicht mehr da.\n            for path in reversed(self.cleanup):\n                self.check('Testsammlung entfernen: '+path, lambda p=path: self.req('DELETE',p,codes=(204,404)))\n            self.log('ERGEBNIS '+self.tag)\n            for label, state, detail in self.results:\n                self.log(f'{state}: {label}'+(' \u2014 '+detail if detail else ''))\n            self.log(f'{sum(x&#91;1]==\"OK\" for x in self.results)} OK; {sum(x&#91;1]==\"FEHLER\" for x in self.results)} Fehler')\n        return int(any(x&#91;1]=='FEHLER' for x in self.results))\n\ndef main():\n    \"\"\"Liest Argumente und Passwort ein und startet den Testlauf.\"\"\"\n    # argparse erzeugt automatisch --help und pr\u00fcft bekannte Argumente.\n    p = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)\n    p.add_argument('url', help='Kanonische HTTPS-URL inklusive Unterverzeichnis, falls vorhanden')\n    p.add_argument('--user', required=True, help='Anmeldename (kein Anzeigename)')\n    p.add_argument('--mib', type=int, default=8, help='Bin\u00e4rtestgr\u00f6\u00dfe, 1\u2013128 MiB; Standard 8')\n    p.add_argument('--pause', type=float, default=1, help='Pause nach jedem Test in Sekunden')\n    p.add_argument('--timeout', type=int, default=90, help='Timeout je Anfrage in Sekunden')\n    # store_true macht aus einem Schalter einen booleschen Wert.\n    # --no-dav \u00fcberspringt NUR Kalender\/Aufgaben\/Kontakte; Datei-WebDAV bleibt aktiv.\n    p.add_argument('--no-dav', action='store_true', help='Kalender-, Aufgaben- und Kontakttests auslassen')\n    # Die Argumente stehen danach z. B. als a.user und a.pause zur Verf\u00fcgung.\n    a = p.parse_args()\n    # Die Adresse wird in Schema, Host, Pfad usw. zerlegt und gepr\u00fcft.\n    u = U.urlsplit(a.url)\n    if u.scheme != 'https' or not u.netloc or u.username or u.password or u.query or u.fragment:\n        p.error('Eine HTTPS-URL ohne Zugangsdaten, Query oder Fragment angeben')\n    if not 1 &lt;= a.mib &lt;= 128 or a.pause &lt; 0 or a.timeout &lt; 1:\n        p.error('Ung\u00fcltige Gr\u00f6\u00dfe, Pause oder Timeout')\n    # Das Passwort steht weder im Programmaufruf noch in dessen Shell-History.\n    # Es bleibt w\u00e4hrend des Laufs im Speicher und wird nicht ins Protokoll geschrieben.\n    password = getpass.getpass('Nextcloud App-Passwort (verdeckte Eingabe): ')\n    if not password:\n        p.error('Passwort fehlt')\n    # SIGTERM ist ein normales Beendigungssignal. sys.exit l\u00f6st SystemExit aus;\n    # dadurch kann der finally-Block des laufenden Tests noch aufr\u00e4umen.\n    signal.signal(signal.SIGTERM, lambda *_: sys.exit(130))\n    try:\n        # Test(...) erzeugt ein Objekt, .run() startet dessen Gesamtpr\u00fcfung.\n        return Test(a,password).run()\n    except KeyboardInterrupt:\n        print('\\nAbgebrochen.', file=sys.stderr)\n        return 130\n    # Ein normaler Testfehler wird aufgezeichnet, statt den gesamten Lauf zu stoppen.\n    # Strg+C (KeyboardInterrupt) geh\u00f6rt nicht zu diesen normalen Exceptions.\n    except Exception as e:\n        print(f'Abbruch: {e}', file=sys.stderr)\n        return 1\n\n# Dieser Block l\u00e4uft nur beim direkten Start der Datei.\n# Beim Importieren f\u00fcr lokale Tests wird main() nicht automatisch aufgerufen.\n# sys.exit gibt den R\u00fcckgabewert als Prozessstatus an die Shell weiter.\nif __name__ == '__main__':\n    sys.exit(main())\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">und eine Fassung ohne Kommentare<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>#!\/usr\/bin\/env python3\n\"\"\"Nextcloud HTTP\/DAV smoke test. Python 3 standard library only.\nRun: python3 nextcloud_basistest.py https:\/\/cloud.example.org --user NAME\nUse an app password. No existing user data is edited. DELETE may leave test\nfiles in Nextcloud's trash and versions. No mail, browser UI, cron, external\nstorage, sharing between users, or Collabora end-to-end test is performed.\nExit codes: 0 successful, 1 failed checks, 2 usage\/configuration error.\n\"\"\"\nimport argparse\nimport base64\nimport datetime as dt\nimport getpass\nimport hashlib\nimport json\nimport os\nimport signal\nimport sys\nimport time\nimport urllib.error\nimport urllib.parse as U\nimport urllib.request as R\nimport uuid\nimport xml.etree.ElementTree as E\n\nclass NoRedirect(R.HTTPRedirectHandler):\n    def redirect_request(self, req, fp, code, msg, headers, newurl):\n        return None\n\nclass Test:\n    def __init__(self, args, password):\n        self.a = args\n        self.base = args.url.rstrip('\/')\n        self.tag = 'NC-Test-' + dt.datetime.now().strftime('%Y%m%d-%H%M%S-') + uuid.uuid4().hex&#91;:10]\n        self.auth = 'Basic ' + base64.b64encode((args.user + ':' + password).encode()).decode()\n        self.http = R.build_opener(NoRedirect())\n        self.results = &#91;]\n        self.cleanup = &#91;]\n        self.uid = args.user\n\n    def log(self, text):\n        print(dt.datetime.now().astimezone().isoformat(timespec='seconds'), text, flush=True)\n\n    def req(self, method, path, data=None, headers=None, codes=(200,), auth=True):\n        url = self.base + path\n        h = {'User-Agent': 'Nextcloud-Basistest\/1.0', 'X-Request-ID': self.tag}\n        if auth:\n            h&#91;'Authorization'] = self.auth\n        h.update(headers or {})\n        if isinstance(data, str):\n            data = data.encode()\n        self.log(f'  {method} {path}')\n        start = time.monotonic()\n        try:\n            with self.http.open(R.Request(url, data=data, headers=h, method=method), timeout=self.a.timeout) as r:\n                status, body, rh = r.status, r.read(), r.headers\n        except urllib.error.HTTPError as e:\n            status, body, rh = e.code, e.read(), e.headers\n        self.log(f'  HTTP {status}; {time.monotonic()-start:.2f}s; Request-ID: {rh.get(\"X-Request-ID\", \"-\")}')\n        if status not in codes:\n            # Do not print response bodies: they may contain personal information.\n            raise RuntimeError(f'HTTP {status}, erwartet {codes}; bei 3xx kanonische HTTPS-URL verwenden')\n        return body, rh\n\n    def check(self, label, fn):\n        self.log('TEST: ' + label)\n        try:\n            fn()\n        except Exception as e:\n            self.results.append((label, 'FEHLER', str(e)))\n            self.log('FEHLER: ' + str(e))\n            return False\n        self.results.append((label, 'OK', ''))\n        self.log('OK: ' + label)\n        time.sleep(self.a.pause)\n        return True\n\n    def ocs(self, path):\n        raw, _ = self.req('GET', '\/ocs\/v2.php\/' + path + '?format=json', headers={'OCS-APIRequest': 'true'})\n        obj = json.loads(raw)&#91;'ocs']\n        if str(obj&#91;'meta']&#91;'statuscode']) not in ('100', '200'):\n            raise RuntimeError('OCS-Anfrage meldet keinen Erfolg')\n        return obj&#91;'data']\n\n    def prop(self, path, depth='0'):\n        body, _ = self.req('PROPFIND', path,\n            '&lt;d:propfind xmlns:d=\"DAV:\"&gt;&lt;d:prop&gt;&lt;d:resourcetype\/&gt;&lt;d:getetag\/&gt;&lt;d:getcontentlength\/&gt;&lt;\/d:prop&gt;&lt;\/d:propfind&gt;',\n            {'Depth': depth, 'Content-Type': 'application\/xml'}, (207,))\n        root = E.fromstring(body)\n        responses = root.findall('{DAV:}response')\n        if not responses:\n            raise RuntimeError('Leere DAV-Multistatus-Antwort')\n        for response in responses:\n            statuses = &#91;s.text or '' for s in response.findall('.\/\/{DAV:}status')]\n            if not statuses or not any(' 200 ' in s for s in statuses):\n                raise RuntimeError('DAV-Teilergebnis ohne erfolgreiche Eigenschaften')\n        return root\n\n    def status(self):\n        raw, _ = self.req('GET', '\/status.php', auth=False)\n        s = json.loads(raw)\n        if not s.get('installed') or s.get('maintenance') or s.get('needsDbUpgrade'):\n            raise RuntimeError('Nicht installiert, Wartungsmodus oder Datenbank-Upgrade erforderlich')\n        self.log('Nextcloud-Version: ' + str(s.get('versionstring', '?')))\n\n    def user(self):\n        self.uid = self.ocs('cloud\/user')&#91;'id']\n\n    def equal(self, path, expected):\n        body, _ = self.req('GET', path)\n        if hashlib.sha256(body).digest() != hashlib.sha256(expected).digest():\n            raise RuntimeError('Heruntergeladener Inhalt stimmt nicht \u00fcberein')\n\n    def files(self):\n        root = '\/remote.php\/dav\/files\/' + U.quote(self.uid, safe='') + '\/'\n        folder = root + self.tag + '\/'\n        self.check('Dateiliste und Metadaten im Benutzerverzeichnis', lambda: self.prop(root, '1'))\n        if not self.check('Testordner anlegen', lambda: self.req('MKCOL', folder, codes=(201,))):\n            return\n        self.cleanup.append(folder)\n        file = folder + U.quote('Pr\u00fcfung mit Leerzeichen \u00e4\u00f6\u00fc.txt')\n        content = ('Nextcloud Migrationstest ' + self.tag + '\\nGr\u00fc\u00dfe aus dem Basistest.\\n').encode()\n        if self.check('Textdatei hochladen', lambda: self.req('PUT', file, content, {'If-None-Match': '*'}, (201,))):\n            self.check('Download mit Inhaltsvergleich', lambda: self.equal(file, content))\n            changed = content + b'Updated\\n'\n            if self.check('Eigene Testdatei aktualisieren', lambda: self.req('PUT', file, changed, codes=(204,))):\n                self.check('Aktualisierten Inhalt pr\u00fcfen', lambda: self.equal(file, changed))\n            copied, moved = folder + 'Kopie.txt', folder + 'Verschoben.txt'\n            if self.check('Datei kopieren', lambda: self.req('COPY', file, headers={'Destination': self.base+copied, 'Overwrite':'F'}, codes=(201,))):\n                if self.check('Kopie verschieben', lambda: self.req('MOVE', copied, headers={'Destination':self.base+moved,'Overwrite':'F'}, codes=(201,))):\n                    self.check('Verschobene Datei lesen', lambda: self.equal(moved, changed if any(x&#91;0]=='Eigene Testdatei aktualisieren' and x&#91;1]=='OK' for x in self.results) else content))\n                    self.check('Einzeldatei l\u00f6schen', lambda: self.req('DELETE', moved, codes=(204,)))\n                    self.check('L\u00f6schung pr\u00fcfen (404 hier erwartet)', lambda: self.req('GET', moved, codes=(404,)))\n        self.check('Testordner auflisten', lambda: self.prop(folder, '1'))\n        blob = os.urandom(self.a.mib * 1024 * 1024)\n        big = folder + 'Binaertest.bin'\n        if self.check(f'Bin\u00e4rdatei hochladen ({self.a.mib} MiB)', lambda: self.req('PUT', big, blob, {'If-None-Match':'*'}, (201,))):\n            self.check('Bin\u00e4rdatei vollst\u00e4ndig vergleichen', lambda: self.equal(big, blob))\n\n    def collection(self, kind):\n        cal = kind == 'calendar'\n        parent = '\/remote.php\/dav\/' + ('calendars\/' if cal else 'addressbooks\/users\/') + U.quote(self.uid, safe='') + '\/'\n        self.check(('CalDAV' if cal else 'CardDAV') + ' Sammlungen abrufen', lambda: self.prop(parent, '1'))\n        path = parent + self.tag + '\/'\n        if cal:\n            method = 'MKCALENDAR'\n            xml = '&lt;c:mkcalendar xmlns:c=\"urn:ietf:params:xml:ns:caldav\" xmlns:d=\"DAV:\"&gt;&lt;d:set&gt;&lt;d:prop&gt;&lt;d:displayname&gt;'+self.tag+'&lt;\/d:displayname&gt;&lt;c:supported-calendar-component-set&gt;&lt;c:comp name=\"VEVENT\"\/&gt;&lt;c:comp name=\"VTODO\"\/&gt;&lt;\/c:supported-calendar-component-set&gt;&lt;\/d:prop&gt;&lt;\/d:set&gt;&lt;\/c:mkcalendar&gt;'\n        else:\n            method = 'MKCOL'\n            xml = '&lt;d:mkcol xmlns:d=\"DAV:\" xmlns:c=\"urn:ietf:params:xml:ns:carddav\"&gt;&lt;d:set&gt;&lt;d:prop&gt;&lt;d:resourcetype&gt;&lt;d:collection\/&gt;&lt;c:addressbook\/&gt;&lt;\/d:resourcetype&gt;&lt;d:displayname&gt;'+self.tag+'&lt;\/d:displayname&gt;&lt;\/d:prop&gt;&lt;\/d:set&gt;&lt;\/d:mkcol&gt;'\n        if not self.check('Eigene Testsammlung anlegen: '+kind, lambda: self.req(method, path, xml, {'Content-Type':'application\/xml'}, (201,))):\n            return\n        self.cleanup.append(path)\n        if cal:\n            stamp = dt.datetime.now(dt.timezone.utc).strftime('%Y%m%dT%H%M%SZ')\n            items = &#91;('termin.ics', 'VEVENT', 'DTSTART:20300101T120000Z\\r\\nDTEND:20300101T123000Z'), ('aufgabe.ics','VTODO','STATUS:NEEDS-ACTION\\r\\nPERCENT-COMPLETE:0')]\n            for name, component, fields in items:\n                text = f'BEGIN:VCALENDAR\\r\\nVERSION:2.0\\r\\nPRODID:-\/\/NC Basistest\/\/DE\\r\\nBEGIN:{component}\\r\\nUID:{uuid.uuid4()}\\r\\nDTSTAMP:{stamp}\\r\\nSUMMARY:{self.tag}\\r\\n{fields}\\r\\nEND:{component}\\r\\nEND:VCALENDAR\\r\\n'\n                self.dav_item(path+name, text, 'text\/calendar', component, 'calendar')\n        else:\n            text = f'BEGIN:VCARD\\r\\nVERSION:3.0\\r\\nUID:{uuid.uuid4()}\\r\\nFN:{self.tag}\\r\\nN:Test;Nextcloud;;;\\r\\nEMAIL:nextcloud-test@example.invalid\\r\\nEND:VCARD\\r\\n'\n            self.dav_item(path+'kontakt.vcf', text, 'text\/vcard', 'VCARD', 'addressbook')\n\n    def dav_item(self, path, text, mime, component, kind):\n        if not self.check(component+' anlegen', lambda: self.req('PUT', path, text, {'Content-Type':mime,'If-None-Match':'*'}, (201,))):\n            return\n        def read():\n            raw, _ = self.req('GET', path)\n            if self.tag not in raw.decode() or ('BEGIN:'+component) not in raw.decode():\n                raise RuntimeError('DAV-Inhalt fehlt')\n        self.check(component+' lesen', read)\n        ns = 'urn:ietf:params:xml:ns:caldav' if kind=='calendar' else 'urn:ietf:params:xml:ns:carddav'\n        query = f'&lt;c:{kind}-query xmlns:c=\"{ns}\" xmlns:d=\"DAV:\"&gt;&lt;d:prop&gt;&lt;d:getetag\/&gt;&lt;\/d:prop&gt;'\n        query += ('&lt;c:filter&gt;&lt;c:comp-filter name=\"VCALENDAR\"&gt;&lt;c:comp-filter name=\"'+component+'\"\/&gt;&lt;\/c:comp-filter&gt;&lt;\/c:filter&gt;' if kind=='calendar' else '&lt;c:filter\/&gt;')\n        query += f'&lt;\/c:{kind}-query&gt;'\n        def report():\n            raw, _ = self.req('REPORT', path.rsplit('\/',1)&#91;0]+'\/', query, {'Content-Type':'application\/xml','Depth':'1'}, (207,))\n            root = E.fromstring(raw)\n            hrefs = &#91;U.unquote(e.text or '') for e in root.findall('.\/\/{DAV:}href')]\n            if not any(h.endswith(path.rsplit('\/',1)&#91;1]) for h in hrefs):\n                raise RuntimeError('Angelegtes Objekt fehlt in REPORT-Abfrage')\n        self.check(component+' per DAV-REPORT finden', report)\n        updated = text.replace('SUMMARY:'+self.tag, 'SUMMARY:'+self.tag+' aktualisiert') if kind=='calendar' else text.replace('FN:'+self.tag, 'FN:'+self.tag+' aktualisiert')\n        if self.check(component+' aktualisieren', lambda: self.req('PUT', path, updated, {'Content-Type':mime}, (204,))):\n            def verify_update():\n                raw, _ = self.req('GET', path)\n                if (self.tag+' aktualisiert').encode() not in raw:\n                    raise RuntimeError('Aktualisierung fehlt im gelesenen Objekt')\n            self.check(component+' Aktualisierung pr\u00fcfen', verify_update)\n        if self.check(component+' l\u00f6schen', lambda: self.req('DELETE', path, codes=(204,))):\n            self.check(component+' L\u00f6schung pr\u00fcfen (404 erwartet)', lambda: self.req('GET', path, codes=(404,)))\n\n    def run(self):\n        self.log('START '+self.tag+' | '+self.base)\n        self.log('Nur eigene Testdaten; Papierkorb\/Versionen k\u00f6nnen Testreste enthalten.')\n        try:\n            self.check('\u00d6ffentlicher Serverstatus', self.status)\n            self.check('Login-Seite abrufen', lambda: self.req('GET','\/index.php\/login',auth=False))\n            if not self.check('Authentifizierung und Benutzerkennung', self.user):\n                return 1\n            self.check('OCS Capabilities', lambda: self.ocs('cloud\/capabilities'))\n            self.check('WebDAV-Einstieg', lambda: self.prop('\/remote.php\/dav\/'))\n            self.files()\n            if not self.a.no_dav:\n                self.collection('calendar')\n                self.collection('addressbook')\n        finally:\n            self.log('AUFR\u00c4UMEN')\n            for path in reversed(self.cleanup):\n                self.check('Testsammlung entfernen: '+path, lambda p=path: self.req('DELETE',p,codes=(204,404)))\n            self.log('ERGEBNIS '+self.tag)\n            for label, state, detail in self.results:\n                self.log(f'{state}: {label}'+(' \u2014 '+detail if detail else ''))\n            self.log(f'{sum(x&#91;1]==\"OK\" for x in self.results)} OK; {sum(x&#91;1]==\"FEHLER\" for x in self.results)} Fehler')\n        return int(any(x&#91;1]=='FEHLER' for x in self.results))\n\ndef main():\n    p = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)\n    p.add_argument('url', help='Kanonische HTTPS-URL inklusive Unterverzeichnis, falls vorhanden')\n    p.add_argument('--user', required=True, help='Anmeldename (kein Anzeigename)')\n    p.add_argument('--mib', type=int, default=8, help='Bin\u00e4rtestgr\u00f6\u00dfe, 1\u2013128 MiB; Standard 8')\n    p.add_argument('--pause', type=float, default=1, help='Pause nach jedem Test in Sekunden')\n    p.add_argument('--timeout', type=int, default=90, help='Timeout je Anfrage in Sekunden')\n    p.add_argument('--no-dav', action='store_true', help='Kalender-, Aufgaben- und Kontakttests auslassen')\n    a = p.parse_args()\n    u = U.urlsplit(a.url)\n    if u.scheme != 'https' or not u.netloc or u.username or u.password or u.query or u.fragment:\n        p.error('Eine HTTPS-URL ohne Zugangsdaten, Query oder Fragment angeben')\n    if not 1 &lt;= a.mib &lt;= 128 or a.pause &lt; 0 or a.timeout &lt; 1:\n        p.error('Ung\u00fcltige Gr\u00f6\u00dfe, Pause oder Timeout')\n    password = getpass.getpass('Nextcloud App-Passwort (verdeckte Eingabe): ')\n    if not password:\n        p.error('Passwort fehlt')\n    signal.signal(signal.SIGTERM, lambda *_: sys.exit(130))\n    try:\n        return Test(a,password).run()\n    except KeyboardInterrupt:\n        print('\\nAbgebrochen.', file=sys.stderr)\n        return 130\n    except Exception as e:\n        print(f'Abbruch: {e}', file=sys.stderr)\n        return 1\n\nif __name__ == '__main__':\n    sys.exit(main())<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"<p>Die neue Nextcloud ist eingerichtet, die Datenbank importiert und die Dateien liegen wieder an ihrem Platz. Die Anmeldeseite l\u00e4sst sich \u00f6ffnen. Aber funktioniert auch das, was im Alltag gebraucht wird? Ein kleiner Funktionstest hilft, diese Frage systematisch anzugehen. Das Skript nextcloud_basistest.py f\u00fchrt typische Zugriffe aus und zeigt jeden Schritt mit Zeitstempel an. Parallel lassen sich [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":65,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-58","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-allgemein"],"_links":{"self":[{"href":"https:\/\/www.bloy.info\/index.php\/wp-json\/wp\/v2\/posts\/58","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.bloy.info\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.bloy.info\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.bloy.info\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.bloy.info\/index.php\/wp-json\/wp\/v2\/comments?post=58"}],"version-history":[{"count":8,"href":"https:\/\/www.bloy.info\/index.php\/wp-json\/wp\/v2\/posts\/58\/revisions"}],"predecessor-version":[{"id":68,"href":"https:\/\/www.bloy.info\/index.php\/wp-json\/wp\/v2\/posts\/58\/revisions\/68"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.bloy.info\/index.php\/wp-json\/wp\/v2\/media\/65"}],"wp:attachment":[{"href":"https:\/\/www.bloy.info\/index.php\/wp-json\/wp\/v2\/media?parent=58"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.bloy.info\/index.php\/wp-json\/wp\/v2\/categories?post=58"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.bloy.info\/index.php\/wp-json\/wp\/v2\/tags?post=58"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}