mad – die MAD Designer-KommandozeilenschnittstelleDiese Seite beschreibt das Kommandozeilenwerkzeug mad: die Einbettungsoberfläche der Engine und den schnellsten Weg, ein .mad-Dokument ohne die App durchzuspielen. Lesen Sie zuerst die Formatspezifikation, falls Container und Speicher für Sie neu sind.
Dieses Dokument definiert ein Kommandozeilenwerkzeug, das .mad-Dokumente ohne Benutzeroberfläche öffnet, inspiziert, aktualisiert und exportiert.
Dieser Bericht entstand, als die Präsentationsschicht der Apple-Anwendung vollständig aus UIKit bestand; deshalb konnte sie nicht als native macOS- oder Windows-Anwendung laufen. Die nativen macOS- (AppKit) und Windows-Anwendungen (WPF) existieren inzwischen; das mad-CLI bleibt der Headless-Pfad, der dieselbe Engine ohne UI ausführt. Der Datenpfad – das Dokument öffnen, die Abfrage ausführen, den Cache füllen, den Bericht rendern – ist bereits fast vollständig frei von UIKit (siehe §4); das macht die CLI portabel.
Im Umfang. Eine einzelne Binärdatei, mad, die:
.mad-Dokument öffnen und berichten kann, was darin istBewusst außerhalb des Umfangs. Alles, was ein Dokument bearbeitet. Die CLI liest und führt Dokumente aus; sie entwirft sie nicht. Die Argumentanalyse, die Verben und die Exit-Codes sind die gesamte Oberfläche.
| CLI | Mac-App | |
|---|---|---|
| Braucht ein UI-Toolkit | nein | AppKit (Neuschreiben) oder Catalyst (abgelehnt) |
| Braucht portable Frameworks | ja | ja |
| Braucht einen portablen Zeilen-Cache | ja | ja |
Braucht definiertes .mad |
ja | ja |
| Liefert etwas, das gefragt war | ja | ja |
| Arbeit, die bei einer Formatänderung weggeworfen wird | keine | die UI |
Alles, was die Mac-Anwendung braucht, um zu existieren – portable Frameworks, ein definiertes Dateiformat, für mehr als eine Plattform gebaute Bibliotheken – braucht die CLI zuerst. Den UI-Port zuerst zu machen wäre der teure Weg, dieselben Probleme zu entdecken. Die Mac-Anwendung bleibt eine separate Entscheidung, später getroffen, mit bereits portablen Frameworks.
mad <command> [options] <document.mad>
mad inspect <doc.mad>Liest nur den Container. Keine Datenbankverbindung, kein Core Data.
$ mad inspect London.mad
London.mad
format v0 (bzip2 tar, no magic header)
generator MAD Designer
version 1
store StoreContent/analyitics (SQLite 3.43.2, 126 pages)
wal present, 313152 bytes (not checkpointed)
thumbnail none
elements 14 sections, 63 elements
Das ist das Verb, das beweist, dass MAD_FORMAT.md §7 umgesetzt ist: es muss an einem v0-Beispiel funktionieren. Es ist auch das Verb, das die Gefahren des Formats sichtbar macht – H2 (das nicht gecheckpointete WAL) wird gemeldet, statt still erlitten.
mad schema <doc.mad>Gibt das in der Dokumentdefinition erfasste Datenbankschema aus: den Treiber, die nach Namen sortierten Tabellen und die Felder jeder Tabelle mit ihrem Anzeigetyp und einer pk-Markierung. Es liest den zur Erstellungszeit gespeicherten Snapshot und braucht daher keine Zugangsdaten und keine Quelldatenbank. (Der ursprüngliche Plan war hier, SQL CREATE TABLE auszugeben; der Snapshot speichert die Abstraktion MADDataType statt der Typnamen jedes Quelldialekts, also braucht ein getreues CREATE TABLE eine Zuordnung pro Dialekt, die es noch nicht gibt. Die lesbare Auflistung ist das, was das Werkzeug bis dahin erzeugt.)
mad query <doc.mad>Gibt das SQL aus, das die Abfrage des Dokuments erzeugt, ohne es auszuführen. Das ist die Funktion, um die herum die Anwendung gebaut ist – der Benutzer stellt Tabellen, Joins und Filter zusammen, und die Software schreibt das SQL –, also ist ihre Offenlegung das natürliche erste nicht-triviale Verb.
$ mad query London.mad --format sql
SELECT ... FROM ... WHERE ...
mad refresh <doc.mad>Verbindet sich mit der Quelldatenbank, führt die Abfrage aus und füllt den Zeilen-Cache. Das ist der Datenpfad, und es ist das Verb, auf dem der Rest beruht.
$ mad refresh London.mad --credentials user:pass
refreshed 148,392 rows in 1.21 s (122,638 rows/s)
cache ~/Library/Caches/MADDesigner/<id>/<tag>.maddb
Optionen: --credentials, --host, --port, --database, --no-cache (ohne Persistieren ausführen), --rows N (nach N Zeilen stoppen, für Smoke-Tests).
--rows existiert, weil es das Verb in CI gegen einen echten Server testbar macht, ohne eine Million Zeilen zu ziehen, und weil der Benchmark in MADDataTableFastBenchmarkTests bereits beweist, dass der Pfad im großen Maßstab messbar ist.
mad export <doc.mad>Rendert den Bericht und schreibt ihn aus.
$ mad export London.mad --format pdf --out London.pdf
$ mad export London.mad --format json --out - # to the standard output
Die Formate sind die Naht des Exports (§5.3): jedes ist eine bei MADReportExporterRegistry registrierte Klasse, und der Nutzungstext nennt, was der Build hat.
| Format | Schreibt | Wo es läuft |
|---|---|---|
pdf |
den gerenderten Bericht (Seiten, gezeichnet) | Apple: UIKit’s UIPrintPageRenderer, Core Graphics; Linux sagt, warum nicht |
html |
den gerenderten Bericht als eine HTML-Datei, ein Seitenkasten pro Seite, aus einem Browser gedruckt | beide Plattformen |
html-flow |
den gerenderten Bericht als umbrechbares HTML, eine Tabelle pro Abschnitt | beide Plattformen |
text |
die Zeilen als Tabelle fester Breite | beide Plattformen |
csv |
die Zeilen als RFC-4180-CSV | beide Plattformen |
json |
das Schema und die Zeilen als JSON (§8.3) | beide Plattformen |
json-report |
json plus die Abschnitte des gerenderten Berichts |
beide Plattformen |
--out ist für die Foundation-Formate optional – fehlt es oder ist es -, wird die Standardausgabe geschrieben – und für pdf erforderlich. Die Foundation-Formate schreiben für dasselbe Dokument auf Apple und Linux dieselben Bytes (Linux/README.md; die Exporte der beiden Plattformen des London-Fixtures sind per Digest gleich).
Die definierte Reihenfolge. Die Gruppenreihenfolge des Exports ist Teil dieses Vertrags, also ist sie eine definierte Reihenfolge, nicht die der Plattform: Textschlüssel vergleichen ohne Rücksicht auf Groß-/Kleinschreibung und dann nach Codepunktreihenfolge über die UTF-8-Bytes. Die Case-Fold ist die einfache (eins-zu-eins) Case-Fold von Unicode 17.0.0, gehalten als eingecheckte Tabelle (MADStringOrderingTable in MADFoundation/Source/NSString+Comparison.m, erzeugt aus den Status-C/S-Einträgen der CaseFolding.txt des UCD) – ASCII und jedes Unicode-Paar, das die Tabelle abbildet, folden; alles andere, einschließlich diakritischer Zeichen, vergleicht als eigener Codepunkt. Weil die Fold jeden Buchstaben in den Kleinbuchstabenbereich schickt, der jedem ASCII-Satzzeichenbyte folgt, sortiert ein satzzeichenführender Schlüssel ([1997] Black Light Syndrome) vor einem wortführenden (Core) – dieselbe Stelle, an die SQLites NOCASE ihn setzt. UTF-8 bewahrt die Codepunktreihenfolge, also ist der Bytevergleich der Codepunktvergleich. Ein Comparator (-[NSString mad_orderedCompare:] und sein C-Kern MADStringOrderedCompareUTF8) treibt alle drei Stellen: die Kollation LSASC des Caches, die Sortierdeskriptoren im Speicher (MADDataTypeSelectorForSorting) und den Gruppengrenzenvergleich des Berichtsformatierers. Die Reihenfolge ist deterministisch über Plattformen, OS-Releases und Locales hinweg; sie änderte sich am 2026-10-25 von der lokalisierten Reihenfolge, also sind Exporte vor diesem Datum nicht gleich den Exporten danach.
json-report (MAD_LINUX.md §10.1, §9 Phase E) ist dasselbe Schema mit dem gerenderten Bericht als Mitglied report: Seiten, die Abschnitte jeder Seite in Zeichenreihenfolge (Typ, Gruppenebene, Sichtbarkeit), die Zeilen jedes Abschnitts und Art, Rahmen und aufgelösten Text jedes Elements jeder Zeile. Es ist das, was Tests und ein Renderer lesen, und es ist die eigene Struktur des Renderers – der Seitendurchlauf mit nichts Gezeichnetem –, also kann es nicht von dem abweichen, was ein PDF zeigt. Der Rahmen ist, wo die Zeile auf der Seite sitzt (der Rahmen des Elements, versetzt um seinen Abschnitt), was ein Renderer oder ein Browser braucht. Die Render-Hälfte wird jetzt unter Linux kompiliert, also läuft dieses Format auf beiden Plattformen.
html ist das seitenförmige Artefakt, das ein Browser druckt: ein CSS-Seitenkasten pro durchlaufener Seite, jedes Element absolut an seinem Rahmen positioniert, sein aufgelöster Text in Font, Größe, Gewicht, Neigung, Dekoration und Ausrichtung des Elements selbst. Die Zeilenumbruchregel ist die des Renderers (NSLineBreakByTruncatingTail -> white-space: pre; overflow: hidden; text-overflow: ellipsis). Es ist eine UTF-8-Datei mit einem eingebetteten Style-Block und ohne Skript. html-flow ist derselbe Bericht ohne die Seiten: ein <section> pro Berichtsabschnitt, eine <table> pro Abschnitt, ein <td> pro Element, Seitenzubehör einmal ausgegeben und eine generierte Klasse pro eigenständigem Elementstil. Es ist eine Leseansicht; json ist der Datenvertrag. Keines trägt Farben (die Farbspalten des Speichers haben heute auf keiner Plattform einen Leser) oder unter Linux Bilder (der Apple-Pfad zeichnet sie aus UIImage; ein Linux-Export platziert den leeren Kasten).
Das Rendern nach PDF geht über MADPrintPageRenderer; der Share-Sheet-Wrapper MADActivityItemProviderPdf ist sein anderer Aufrufer, und MADActivityItemProviderDelegate.h ist das Protokoll, mit dem er spricht. Alle drei leben im Framework MAD statt in der App. Was PDF nicht ist, ist headless: es ist UIKit’s UIPrintPageRenderer, weshalb es das eine Format ist, das noch auf der Seite der CLI implementiert wird (siehe §5.3).
mad write <doc.mad> --out <copy.mad>Schreibt das Dokument als .mad aus – eine Kopie: das Verzeichnis mit den Innereien, in das das Dokument gelesen wurde, erneut archiviert mit dem v1-Header. Es bearbeitet nicht das gelesene Dokument, und die CLI entwirft weiterhin keine Dokumente (§1); wofür dieses Verb da ist, ist die Byte-Identitätsanforderung – dasselbe auf zwei Plattformen geschriebene Dokument muss dieselbe Datei sein – und das Round-Trip-Fixture von §6.1, das einen Writer braucht, den ein Skript ausführen kann.
$ mad write London.portable.mad --out copy.mad --reproducible
wrote /tmp/copy.mad (16261 bytes, reproducible)
--reproducible legt fest, was die Uhr und das Dateisystem sonst ins Archiv stempeln würden: eine feste Änderungszeit (2001-01-12T00:00:00Z, derselbe Zeitpunkt, auf den der PDF-Export seine Daten festlegt), Besitzer und Gruppe 0 und einen sortierten Mitgliederdurchlauf (MADArchiveManager.reproducible). Ohne dies wird ein gewöhnliches Speichern geschrieben, mit den echten Metadaten der Mitglieder. Das Dokument wird auf beiden Plattformen headless geöffnet (MADHeadlessDocument), also laufen die beiden Seiten des Vergleichs denselben Writer, und dasselbe Dokument schreibt dort dieselben Bytes (16.261 Bytes beim London-Fixture, Linux/README.md).
| Option | Bedeutung |
|---|---|
--verbose |
den Datenpfad in jeder Stufe protokollieren |
--quiet |
alles außer dem Ergebnis unterdrücken |
--credentials user:pass |
Zugangsdaten der Quelldatenbank; sonst der Schlüsselbund |
--host <name> |
Überschreibung des Hosts der Quelldatenbank (refresh, export) |
--port <n> |
Überschreibung des Ports der Quelldatenbank, 1-65535 (refresh, export) |
--database <name> |
Überschreibung des Namens der Quelldatenbank (refresh, export) |
--no-keychain |
den Schlüsselbund nie berühren |
--format <name> |
Ausgabeformat |
--out <path> |
Ausgabepfad; Standard stdout |
--deterministic |
die Daten und die Kennung des Exports festlegen, damit zwei Läufe über unveränderte Daten byte-identisch sind |
--reproducible |
die Eingaben des .mad-Archivs festlegen – Zeit, Besitz, Mitgliederreihenfolge (write) |
Die Verbindungsdefinition – Host, Port und Datenbankname – ist Teil des portablen Speichers des Dokuments; Benutzername und Passwort sind es nie. --host, --port und --database überschreiben die gespeicherte Verbindung nur für diesen Lauf, sodass ein eingechecktes Dokument gegen einen CI-Service-Container laufen kann, ohne umgeschrieben zu werden. Was nicht angegeben ist, behält seinen gespeicherten Wert. Sie werden bei einem Sqlite3-Dokument, dessen Verbindung eine Datei ist, und bei den Verben, die sich nicht verbinden (inspect, schema, query, write), einfach nicht verwendet. Zugangsdaten bleiben --credentials; der Speicher enthält keinen Benutzernamen und kein Passwort.
| Code | Bedeutung |
|---|---|
| 0 | Erfolg |
| 1 | Nutzungsfehler |
| 2 | Dokument konnte nicht gelesen werden oder ist kein .mad |
| 3 | Quelldatenbank nicht erreichbar oder Zugangsdaten abgelehnt |
| 4 | die Abfrage ist auf dem Server gescheitert |
| 5 | Export gescheitert |
Getrennte Codes zählen, weil die erste echte Verwendung dieses Werkzeugs ein Skript ist, und ein Skript muss „das Dokument ist schlecht“ von „der Server ist aus“ unterscheiden können.
Der Datenpfad ist bereits nahezu frei von UIKit. Das ist gemessen, nicht geschätzt:
| Framework | Dateien mit UIKit-Import | Von der CLI benötigt |
|---|---|---|
MADDataStructures |
0 / 37 | ja |
MADFileManager |
0 / 31 | ja |
MADSqlite3 |
0 / 65 | ja |
MADMySQL |
0 / 42 | ja |
MADTds / MADTdsClient |
0 / 3, 0 / 9 | ja |
Scrimpter |
0 / 48 | nein |
MADFoundation |
4 / 66 | ja |
MADAPI |
3 / 34 | teilweise |
MAD |
28 / 464 | teilweise |
Vier Dateien in MADFoundation tragen die gesamte UIKit-Abhängigkeit des Basisframeworks:
| Datei | UIKit-Verwendung | Behandlung |
|---|---|---|
MADApplication.{h,m} |
ein UIApplication-Wrapper |
von der CLI nicht benötigt; vom headless Target ausgeschlossen |
MADURLFactory.m:32 |
UIScreen.mainScreen.scale > 1.0 |
ein Aufruf; außerhalb von iOS 2.0 zurückgeben |
MADOperation.m:550-563 |
beginBackgroundTaskWithName: |
eine Funktion, geschützt durch #if TARGET_OS_IPHONE |
Der Autor hat die letzte bereits markiert (MADOperation.m:21): „Wish I didn’t have to import UIApplication here, but it’s really the cleanest way.“ Für einen headless Build ist sie nicht der sauberste Weg, und sie ist die einzige Stelle im Basisframework, an der das gilt.
Die drei UIKit-Dateien von MADAPI sind Verbindungs-View-Controller und einfach nicht Teil eines headless Targets.
Die eine substanzielle Arbeit ist diese. Die Refresh-Orchestrierung liegt im App-Target, nicht in einem Framework:
| Datei | Zeilen | UIKit-Symbole | Rolle |
|---|---|---|---|
MADDesigner/Source/MADOperationRefresh.m |
131 | 0 | baut das SQL, führt es aus, schreibt den Cache |
MADDesigner/Source/MADOperationRefreshReload.m |
196 | 3 | Neuladen auf der UI-Seite |
MADDesigner/Source/MADRefreshOperationReload.m |
132 | 1 | Neuladen auf der UI-Seite |
MADOperationRefresh.m importiert nur MADAPI, MADFoundation und MAD und berührt kein UIKit. Es ist bereits das Refresh-Verb der CLI; es liegt nur im falschen Target. Es zieht ins Framework MAD um, und die beiden Reload-Operationen bleiben in der App zurück, was ihre Namen die ganze Zeit gesagt haben.
Eine Buildkonfiguration von MADFoundation, MADAPI und MAD, die ohne UIKit kompiliert, plus das CLI-Target selbst. Mechanisch ist das SUPPORTED_PLATFORMS erweitert um macosx, die Bibliothekssuchpfade pro SDK aus LIBRARIES.md §6 und die drei Dateiausschlüsse oben.
Erledigt unter Linux, 2026-10-16 (MAD_LINUX.md §9 Phase D), und so erledigt: das headless Target sind die zwölf Frameworks, die Linux/CMakeLists.txt gegen GNUstep kompiliert, und die CLI ist ein Target daneben. Das Stück, das §4.1 dem Framework MAD zuwies – die Refresh-Kette –, ist dorthin umgezogen, und das Stück, das er nicht vorhersah – MADocument, ein UIDocument, auf dem MADCLIDocument aufbaute –, wird beantwortet durch MADHeadlessDocument hinter MADDocumentDataProtocol: dieselbe Datenhälfte, ohne Dokumentlebenszyklus und ohne etwas zu rendern. inspect, schema, query und refresh sind auf beiden Plattformen dieselben Quellen; export ist PDF und bleibt auf Apple (§5.2, §9’s Staging). Ein macOS-Target gehört weiterhin zu Track 5.1, aber es hat jetzt die Naht und die Dokumentklasse, die ihm fehlten.
mad linkt die headless Frameworks direkt. Es lädt nicht das App-Bundle und darf nicht verlangen, dass das Core-Data-Modell in einer Build-Phase vorhanden ist – eine Einschränkung, auf die die Testsuite bereits gestoßen ist (siehe die Anmerkung zu MADTestReportFormatter im Projektgedächtnis).
mad refresh muss denselben Code aufrufen, den die Anwendung aufruft:
MADOperationRefresh → MADDatabase executeSQL:fieldKeys:onConnection:intoResultTable:
→ <MADDataTableWriting>. Es darf ihn nicht neu implementieren. Der in MADDataTableFastBenchmarkTests hinzugefügte Benchmark misst genau diesen Pfad bei 200.000 Zeilen (1,16 s Aufnahme, 2,5 MB transient), also zeigt sich eine CLI, die ihn verschlechtert, als fehlschlagender Test statt als Beschwerde eines Nutzers.
MAD_FORMAT.md beschreibt Dokumente; Dokumente enthalten Berichtselemente. Export sollte ein erweiterbarer Punkt sein, passend zum erklärten Ziel des Projekts, dass Entwickler „neue Dokumentexportformate erstellen (z. B. Export nach PDF und JSON)“. Definieren Sie <MADReportExporting> mit einer Methode und registrieren Sie Implementierungen, sodass --format json eine neue Klasse ist statt ein neuer Zweig in einem Switch.
Erledigt 2026-10-16, in der Form, die das Treiberregister von §5.1 bereits hat: MADReportExporting.h ist das Protokoll (Name, Endung, ob es --out braucht, ob dieser Build es erzeugen kann und eine Exportmethode), MADReportExporterRegistry ist das Nachschlagen, und jeder Exporter registriert sich in +load – also hat ein Prozess die Formate, die er linkt, und die CLI fragt eines nach Namen ab. text, csv und json sind die eigenen des Frameworks (MADReportExporterText/CSV/JSON, reines Foundation, beide Plattformen); MADReportExportSource ist die eine Stelle, an der ein Dokument als Spalten und Zeilen gelesen wird, sodass die Formate nicht darüber uneinig sein können, was ein Dokument ist; und MADReportExportWriter ist die eine Stelle, an der Bytes eine Datei oder die Standardausgabe erreichen.
json-report, html und html-flow liegen ebenfalls auf der Naht, gebaut auf dem Protokoll der Render-Hälfte (MADDocumentRenderProtocol: ein Dokument, das seine Zeilen bereitstellen, formatieren und seinen Formatierer übergeben kann) und auf einem Seitendurchlauf (MADReportPageBuilder). pdf liegt jetzt ebenfalls auf der Naht: MADReportExporterPDF registriert sich überall, sein Körper ist der von Core Graphics (Apples), und außerhalb Apples antwortet es mit +isAvailable NO und dem Grund (MAD_LINUX.md §10.2: der Linux-Writer ist der nächste Schritt). Die CLI hat keine lokalen Zweige mehr; jedes Format, pdf eingeschlossen, wird im Register nachgeschlagen.
Die CLI darf nie nachfragen. Sie nimmt --credentials, oder liest den Schlüsselbund, den die Anwendung geschrieben hat, oder scheitert mit Exit-Code 3. --no-keychain existiert, damit ein Testlauf die echten Zugangsdaten eines Entwicklers weder lesen noch schreiben kann.
Linux/build.sh --runtime baut mad-cli:latest, eine reine Laufzeitschicht mit der CLI im PATH, den geteilten Bibliotheken, die sie linkt, und der Sqlite3-Beispieldatenbank – kein Compiler, keine Quellen, keine Test-Binärdateien (283 MB auf der Platte; Linux/README.md enthält den Inhalt). Ein Dokument wird eingebunden, nicht gespeichert:
docker run --rm -v "$PWD/CLI/Fixtures":/docs:ro mad-cli:latest \
mad inspect /docs/London.portable.mad
docker run --rm -v "$PWD/CLI/Fixtures":/docs:ro mad-cli:latest \
mad refresh /docs/MySQL.employees.mad --credentials root:root --rows 50
Das Image wird veröffentlicht (2026-10-26, die frühere Nicht-Veröffentlichungsentscheidung umkehrend) als ghcr.io/mthomason/mad, getaggt mit latest und dem kurzen SHA des Commits, gepusht von .github/workflows/publish-image.yml bei jedem Push auf master (plus workflow_dispatch). Die veröffentlichten Tags sind linux/amd64, von CI auf ubuntu-latest gebaut; das lokale mad-cli:latest des Macs ist arm64, und auf Apple Silicon braucht der veröffentlichte Tag --platform linux/amd64 (Lauf unter Emulation; ohne das Flag scheitert der Pull mit no matching manifest). Dieselben Verben über das veröffentlichte Image:
docker run --rm --platform linux/amd64 -v "$PWD/CLI/Fixtures":/docs:ro \
ghcr.io/mthomason/mad mad inspect /docs/London.portable.mad
Ein Sqlite3-Dokument löst seinen gespeicherten Datenbanknamen gegen das benutzerspezifische Application-Support-Verzeichnis auf, das im Image /root/GNUstep/Library/ApplicationSupport ist; chinook.sqlite3 liegt dort, also aktualisieren sich die Fixtures London und Music ohne Einrichtung. Der Zeilen-Cache lebt unter demselben Home und ist pro Container; jeder Export aktualisiert das Dokument selbst, also muss ein Cache nicht zwischen Läufen bestehen bleiben. Die LGPL-Komponenten im veröffentlichten Image verpflichten zu Relink-Angeboten; das schriftliche Angebot in ThirdParty/Licenses/README.md benennt das Image (THIRD_PARTY_LICENSES.md §9 ist der Registereintrag).
Linux/build.sh --verify baut das Image neu und führt die wiederholbare Prüfung aus: alle sechs Verben auf den Fixtures, den festgeschriebenen Digest jedes Formats, die Verweigerung von pdf, die Bytes des Writers und die Exit-Codes (Linux/verify-cli.sh; --live fügt die drei Live-Datenbanken hinzu).
Das Format und die CLI sind durch Round-Trip-Fixtures festgeschrieben, nicht durch Prosa:
Music.mad und London.mad entpacken, neu packen und prüfen, dass die Mitgliederliste und die Bytes jedes Mitglieds unverändert sind. Das schreibt MAD_FORMAT.md §2 fest und erkennt H4 (verborgene Dateien) sofort. Gelandet 2026-10-16 als Round Trip von Linux/Tests/MADArchiveManagerTests.m – mad write schreibt den Container jetzt auf beiden Plattformen –, mit den Bytes des reproduzierbaren Modus festgeschrieben gegen die des Macs.mad inspect an beiden ausgelieferten Beispielen muss gelingen und die Werte aus MAD_FORMAT.md §2 berichten – einschließlich des nicht gecheckpointeten WAL, was die Prüfung ist, die beweist, dass die WAL-Gefahr gemeldet statt ignoriert wird.mad refresh --rows 200000 gegen eine lokale SQLite-Quelle, geprüft gegen dieselben Obergrenzen, die der Benchmark verwendet, sodass die CLI nicht still zum langsamen Pfad werden kann.Fixtures liegen neben den Beispielen, die sie testen. Tests, die einen echten MySQL-, SQL-Server- oder PostgreSQL-Server brauchen, überspringen sich, wenn keiner erreichbar ist, der bestehenden Konvention in MADMySQLLiveTests.m, MADTdsClientLiveTests.m und MADPostgresLiveTests.m folgend.
| Phase | Lieferung | Hängt ab von |
|---|---|---|
| 0 | MAD_FORMAT.md, MAD_CLI.md, LIBRARIES.md |
– |
| 1 | Buildsystem der Bibliotheken, sqlite-Flags festgeschrieben | Phase 0 |
| 2 | Suchpfade pro SDK; macOS-Slices verdrahtet | Phase 1 |
| 3 | Headless-Teilmenge; MADOperationRefresh nach MAD verschoben |
Phase 2 |
| 4 | Target mad: inspect, schema, query |
Phase 3 |
| 5 | mad refresh |
Phase 4 |
| 6 | mad export (PDF zuerst) |
Phase 5 |
| 7 | Round-Trip-Fixtures in die Testmatrix verdrahtet | Phase 6 |
Die Phasen 4-6 sind nach Abhängigkeit geordnet, nicht nach Schwierigkeit: inspect braucht nur den Container, query braucht das Dokumentmodell, und refresh braucht eine Datenbankverbindung.
--credentials ein Klartextargument akzeptieren darf oder einen Dateideskriptor nehmen muss.mad den Zeilen-Cache aus einer externen Datei akzeptieren? Ein gepacktes .mad (§8.3 des Formatdokuments) würde Offline-Export möglich machen. Noch braucht es niemand.--format json ist der Datenvertrag, --format json-report fügt den gerenderten Bericht als zusätzliches Mitglied hinzu. Die Form liegt in MADReportExporterJSON.h, implementiert von MADReportExporterJSON (die Datenhälfte, beide Plattformen) und MADReportExporterJSONReport (das Berichtsmitglied, wo die Render-Hälfte ist). Ihre Spalten sind die der Abfrage selbst, in der Reihenfolge, die die SELECT-Liste definiert – der Spaltenalias, sortiert (BUGS.md, der SELECT-List-Eintrag) –, und ein Wert behält seinen JSON-Typ: Zahlen sind Zahlen, NULL ist null, Daten sind ISO 8601 und Binäres ist base64.Diese Seite ist eine deutsche Übersetzung des englischen Originals; bei Abweichungen ist der englische Originaltext maßgeblich.