This commit is contained in:
1 parent
23b1cb2966
commit
e9532e8878
30 files changed
+1835
-542
No files matched your search
+46
-31
@@ -1,45 +1,60 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""
|
||||
make_test_vault.py — erzeugt einen minimalen, nachvollziehbaren Test-Vault
|
||||
FILE: scripts/make_test_vault.py
|
||||
VERSION: 2.1.0 (2025-12-15)
|
||||
STATUS: Active (Test-Tool)
|
||||
COMPATIBILITY: v2.9.1 (Post-WP14/WP-15b)
|
||||
|
||||
Version: 1.2 (2025-09-09)
|
||||
Änderungen ggü. 1.1:
|
||||
- Fügt **externe Links** (http/mailto) in `exp-two.md` hinzu, damit der Chunk-Payload-Exporter
|
||||
`external_links` realistisch testen kann.
|
||||
- Kleine Textanpassungen zur stabilen Chunk-Bildung (Absatzstruktur).
|
||||
Zweck:
|
||||
-------
|
||||
Erzeugt einen minimalen, nachvollziehbaren Test-Vault für Entwicklung und Tests.
|
||||
Enthält verschiedene Szenarien: leere Links, externe Links, verschiedene Note-Typen.
|
||||
|
||||
Zweck
|
||||
- Kleiner Obsidian-ähnlicher Vault zum Durchspielen des Importers (Chunks/Edges).
|
||||
- Szenarien: leere Links, spätere Anlage fehlender Noten, Chunk-Neuaufteilung, externe Links.
|
||||
Funktionsweise:
|
||||
---------------
|
||||
1. Erstellt Verzeichnisstruktur (concepts, experiences, projects)
|
||||
2. Generiert Test-Notizen mit vollständigem Frontmatter:
|
||||
- concept-alpha.md (Basis-Concept)
|
||||
- exp-one.md (verlinkt auf concept-alpha und missing-note)
|
||||
- exp-two.md (verlinkt auf concept-alpha + externe Links)
|
||||
- project-demo.md (verlinkt auf concept-alpha und exp-one)
|
||||
3. Optional: Erstellt missing-note (mit --with-missing)
|
||||
|
||||
Struktur (Default: ./test_vault)
|
||||
- 40_concepts/concept-alpha.md
|
||||
- 20_experiences/exp-one.md (verlinkt auf [[concept-alpha]] und [[missing-note]])
|
||||
- 20_experiences/exp-two.md (verlinkt auf [[concept-alpha]] + externe Links)
|
||||
- 30_projects/project-demo.md (verlinkt auf [[concept-alpha]] und [[exp-one]])
|
||||
Ergebnis-Interpretation:
|
||||
------------------------
|
||||
- Ausgabe: Erfolgsmeldung mit erstellten Dateien
|
||||
- Exit-Code 0: Erfolgreich
|
||||
- Exit-Code 1: Fehler (z.B. Verzeichnis existiert bereits ohne --force)
|
||||
|
||||
Voraussetzungen
|
||||
- Keine. Rein Dateigenerierung.
|
||||
Verwendung:
|
||||
-----------
|
||||
- Entwicklung und Testing
|
||||
- Demo und Dokumentation
|
||||
- CI/CD-Tests
|
||||
|
||||
Aufruf
|
||||
python3 -m scripts.make_test_vault [--out ./test_vault] [--force] [--with-missing]
|
||||
Hinweise:
|
||||
---------
|
||||
- Erstellt realistische Test-Daten mit verschiedenen Edge-Szenarien
|
||||
- Enthält "Red Links" (missing-note) für Link-Auflösungs-Tests
|
||||
- Externe Links für Chunk-Payload-Tests
|
||||
|
||||
Parameter
|
||||
--out Zielverzeichnis (Standard: ./test_vault)
|
||||
--force Bestehenden Ordner löschen und neu anlegen.
|
||||
--with-missing Auch die 'missing-note' direkt anlegen (Standard: erst im 2. Lauf)
|
||||
Aufruf:
|
||||
-------
|
||||
python3 -m scripts.make_test_vault --out ./test_vault
|
||||
python3 -m scripts.make_test_vault --out ./test_vault --force --with-missing
|
||||
|
||||
Hinweise für Tests
|
||||
1) Erster Import (dry-run oder --apply): Es gibt einen „leeren“ Link [[missing-note]].
|
||||
2) Lege danach eine Datei für „missing-note“ an (mit gleicher ID im YAML) und importiere erneut:
|
||||
-> Erwartung: Edges für ehemals leeren Link werden korrekt nachgezogen (references + backlink).
|
||||
3) Ändere den Body von exp-one.md so, dass andere Chunk-Grenzen entstehen und importiere erneut:
|
||||
-> Erwartung: Chunks/Edges/Note werden für betroffene Noten aktualisiert.
|
||||
4) Prüfe externe Links (verify_chunk_texts.py betrifft nur Text; externe Links siehst du in chunk_payloads).
|
||||
Parameter:
|
||||
----------
|
||||
--out PATH Zielverzeichnis (Default: ./test_vault)
|
||||
--force Löscht bestehenden Ordner und legt neu an
|
||||
--with-missing Erstellt auch missing-note direkt (Standard: erst im 2. Lauf)
|
||||
|
||||
Kompatibel mit:
|
||||
- note.schema.json: 'created'/'updated' müssen strings sein. (Wichtig!)
|
||||
Änderungen:
|
||||
-----------
|
||||
v2.1.0 (2025-12-15): Dokumentation aktualisiert
|
||||
v1.2 (2025-09-09): Externe Links hinzugefügt
|
||||
v1.0.0: Initial Release
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
Reference in new issue
Block a user