Flower

← Alle Module · Daten & Formate

toml

Liest, durchsucht und ändert TOML-Konfigurationsdateien (z.B. App- oder Tool-Einstellungen). Einzelne Werte lassen sich über Punkt-Pfade gezielt auslesen oder setzen, ganze Dateien speichern und zwischen TOML und JSON umwandeln.

Block-Einstellungen

Gelten für den ganzen Modul-Block (im Editor oben im Inspektor, in YAML direkt unter dem Modulnamen).

FeldTypPflichtBeschreibung
dateiText—Optionaler Pfad zur .toml-Datei. Existiert sie nicht, startet das Modul mit einer leeren Tabelle und 'speichern' legt sie an. Ohne 'datei' funktionieren nur 'parsen' und 'serialisieren'.

Aktionen

lesenlesend

Liest den gesamten Inhalt der geöffneten TOML-Datei als verschachteltes Objekt.

Ausgaben (über ergebnis:)

inhaltDie komplette TOML-Struktur als Objekt/Liste.

wert-lesenlesend

Liest einen einzelnen Wert über einen Punkt-Pfad, mit optionalem Standardwert falls nicht vorhanden.

Eingaben

FeldTypPflichtBeschreibung
pfadText—Punkt-Pfad zum Wert, z.B. 'server.host' oder 'server.0.port'. Leer = Wurzel.
standardText—Rückgabewert, falls der Pfad nicht existiert (sonst Nichts).

Ausgaben (über ergebnis:)

wertDer gefundene Wert oder der Standardwert.

existiertlesend

Prüft, ob an einem Punkt-Pfad ein Wert vorhanden ist.

Eingaben

FeldTypPflichtBeschreibung
pfadText—Punkt-Pfad, der geprüft wird.

Ausgaben (über ergebnis:)

vorhandenWahr, wenn der Pfad existiert, sonst falsch.

typlesend

Ermittelt den Datentyp des Werts an einem Punkt-Pfad.

Eingaben

FeldTypPflichtBeschreibung
pfadText—Punkt-Pfad zum zu prüfenden Wert.

Ausgaben (über ergebnis:)

typTyp-Name: 'text', 'zahl', 'wahrheitswert', 'objekt', 'array' oder 'null'.

abfragenlesend

Sucht Werte per JSONPath-Ausdruck über die gesamte Struktur.

Eingaben

FeldTypPflichtBeschreibung
abfrageTextjaJSONPath-Ausdruck, z.B. '$.server[*].port'.

Ausgaben (über ergebnis:)

trefferListe aller passenden Werte.

schlüssel-listelesend

Listet die Schlüssel-Namen eines Objekts an einem Punkt-Pfad auf.

Eingaben

FeldTypPflichtBeschreibung
pfadText—Punkt-Pfad zum Objekt. Leer = Wurzel.

Ausgaben (über ergebnis:)

schlüsselListe der Schlüssel-Namen des Objekts.

array-längelesend

Liefert die Anzahl der Elemente eines Arrays an einem Punkt-Pfad.

Eingaben

FeldTypPflichtBeschreibung
pfadText—Punkt-Pfad zum Array. Leer = Wurzel.

Ausgaben (über ergebnis:)

anzahlAnzahl der Array-Elemente als Zahl.

parsenlesend

Wandelt einen TOML-Text in eine verschachtelte Datenstruktur um (ohne Datei).

Eingaben

FeldTypPflichtBeschreibung
textText—TOML-Quelltext, der geparst wird.

Ausgaben (über ergebnis:)

inhaltDie geparste Struktur als Objekt/Liste.

serialisierenlesend

Wandelt einen Wert in TOML-Text um (ohne Datei).

Eingaben

FeldTypPflichtBeschreibung
wertObjekt—Der zu serialisierende Wert; Skalare/Arrays werden als {wert = ...} gewrappt.

Ausgaben (über ergebnis:)

textDer erzeugte TOML-Text.

nach-jsonlesend

Gibt den Inhalt der geöffneten TOML-Datei als formatierten JSON-Text aus.

Ausgaben (über ergebnis:)

textDie Struktur als eingerückter JSON-Text.

von-jsonverändernd

Ersetzt die gesamte Struktur durch einen geparsten JSON-Text (im Speicher).

Eingaben

FeldTypPflichtBeschreibung
textTextjaJSON-Text, der die bisherige Wurzel ersetzt.

schreibenverändernd

Ersetzt die gesamte Struktur durch einen übergebenen Wert (im Speicher).

Eingaben

FeldTypPflichtBeschreibung
inhaltObjekt—Neuer Inhalt, der die bisherige Wurzel ersetzt.

wert-setzenverändernd

Setzt einen Wert an einem Punkt-Pfad und legt fehlende Zwischen-Ebenen an (im Speicher).

Eingaben

FeldTypPflichtBeschreibung
pfadTextjaPunkt-Pfad zur Zielposition, z.B. 'kunde.adresse.stadt'.
wertText—Der zu setzende Wert.

feld-entfernenverändernd

Entfernt das Feld oder Array-Element an einem Punkt-Pfad (im Speicher).

Eingaben

FeldTypPflichtBeschreibung
pfadTextjaPunkt-Pfad zum zu entfernenden Feld/Element.

array-anhängenverändernd

Hängt einen Wert an ein Array an; legt das Array bei Bedarf an (im Speicher).

Eingaben

FeldTypPflichtBeschreibung
pfadText—Punkt-Pfad zum Array. Leer/fehlend = Wurzel-Array.
wertText—Der anzuhängende Wert.

speichernverändernd

Schreibt die aktuelle Struktur als TOML in die geöffnete Datei zurück.

speichern-unterverändernd

Schreibt die aktuelle Struktur als TOML in eine angegebene Zieldatei.

Eingaben

FeldTypPflichtBeschreibung
pfadTextjaPfad der Zieldatei.

Beispiele

Einen Konfigurationswert auslesen

Öffnet eine config.toml und liest den Server-Port; falls der Eintrag fehlt, wird 8080 verwendet.

toml
toml öffnen
dateiC:\app\config.toml
toml
wert-lesen
pfadserver.port
standard8080
ergebnisport
- toml:
    datei: "C:\\app\\config.toml"
    aktionen:
      - wert-lesen:
          pfad: server.port
          standard: "8080"
          ergebnis: port

Port ändern und Datei speichern

Setzt in der config.toml den Port auf 9090 und schreibt die Datei zurück.

toml
toml öffnen
dateiC:\app\config.toml
toml
wert-setzen
pfadserver.port
wert9090
- toml:
    datei: "C:\\app\\config.toml"
    aktionen:
      - wert-setzen:
          pfad: server.port
          wert: 9090
      - speichern: {}