Wikipedia:Lua/Modul/JSONutil/de

Vorlagenprogrammierung	Diskussionen	Lua			Test	Unterseiten
		Modul	Deutsch	English		Modul:	Dokumentation

JSONutil – Modul zur Vorbereitung und Analyse von JSON-Daten, die als Parameterwerte an Lua-Module übergeben werden.

Zeilenumbrüche und Tabulatoren in Zeichenketten werden toleriert.

Statt eines pauschalen „Invalid“ wird versucht, einige typische Fehler zu detektieren und mit auffindbarem Kontext zu melden.

Funktionen für Vorlagen

failsafe

Versionsbezeichnung: 2020-11-08

Optionaler Zusatzparameter 1 – Mindestversionsbezeichnung oder wikidata

Rückgabewert:

• Leer, falls Mindestversionsbezeichnung nicht erfüllt
• Auf Wikidata registrierte Versionsbezeichnung (2020-11-08) bei wikidata, oder lokal falls dort keine gefunden

Funktionen für Lua-Module

Einbindung in andere Module:

local lucky, JSONutil = pcall( require, "Module:JSONutil" )
if type( JSONutil ) == "table" then
    JSONutil = JSONutil.JSONutil()
else
    -- Fehlerfall; JSONutil enthält Fehlermeldung
    return "<span class=\"error\">" .. JSONutil .. "</span>"
end

Danach stehen zur Verfügung:

JSONutil.failsafe(atleast)

Versionsbezeichnung

• atleast
  optional
  nil oder Mindestversion

Rückgabewert: string oder false

JSONutil.fair(apply)

Reduziere freies JSON-Zeilenformat auf strikten JSON-Code und analysiere auf Fehler.

• apply
  JSON-Code

Rückgabewerte:

1. string mit Fehlerkennung, oder false wenn unbeanstandet.
2. string mit Fehlerkontext, oder JSON-Code wenn unbeanstandet.

JSONutil.fault(alert, add, alien)

• alert
  string mit Fehlerkennung
• add
  optional
  string mit Fehlerkontext
• alien
  optional
  string mit Leerzeichen-getrennter Liste gewünschter Sprachcodes.

Stelle Fehlermeldung formatiert und in angepasster Sprache dar.

Rückgabewert:

• string mit HTML-Fehlermeldung.

JSONutil.fetch(apply, always, alien)

Konvertiere JSON robust in Lua

• apply
  JSON-Code
• always
  optional
  true, wenn immer vorbeugend auf freies Zeilenformat und strikten JSON-Code geprüft werden soll
  Sinnvoll für die Migration HHVM→PHP7 2019.
• alien
  optional
  string mit Leerzeichen-getrennter Liste gewünschter Sprachcodes.

Rückgabewert:

• string mit HTML-Fehlermeldung in angepasster Sprache.
• table mit JSON-Inhalt.

Abhängigkeiten

Keine.

Verwendung

Ausschließlich in Lua-Programmierung.

Internationalisierung

commons:Data:I18n/Module:JSONutil.tab

Siehe auch

• jsonDebug@PerfektesChaos – Benutzerskript zur detaillierteren Analyse fataler Fehler