Entry-Registry

Abfragen und modifizieren Sie registrierte Entries. Zugriff auf Metadaten, Snapshots und Versionshistorie.

Laden

local registry = require("registry")

Entry-Struktur

{
    id = "app.lib:assert",     -- string: "namespace:name"
    kind = "function.lua",     -- string: Entry-Typ
    meta = {type = "test"},    -- table: durchsuchbare Metadaten
    data = {...}               -- any: Entry-Payload
}

Entry abrufen

local entry, err = registry.get("app.lib:assert")

Berechtigung: registry.get auf Entry-ID

Entries finden

local entries, err = registry.find({kind = "function.lua"})
local entries, err = registry.find({kind = "http.endpoint", namespace = "app.api"})

Filterfelder werden gegen Entry-Metadaten abgeglichen.

ID parsen

local id = registry.parse_id("app.lib:assert")
-- id.ns = "app.lib", id.name = "assert"

Snapshots

Zeitpunktbezogene Ansicht der Registry:

local snap, err = registry.snapshot()           -- aktueller Zustand
local snap, err = registry.snapshot_at(5)       -- bei Version 5

Snapshot-Methoden

Versionen

local version, err = registry.current_version()
local versions, err = registry.versions()

print(version:id())       -- numerische ID
print(version:string())   -- Anzeigestring
local prev = version:previous()  -- vorherige Version oder nil

Historie

local hist, err = registry.history()
local versions, err = hist:versions()
local version, err = hist:get_version(5)
local snap, err = hist:snapshot_at(version)

Changesets

Modifikationen aufbauen und anwenden:

local snap, err = registry.snapshot()
local changes = snap:changes()

changes:create({
    id = "test:new_entry",
    kind = "test.kind",
    meta = {type = "test"},
    data = {config = "value"}
})

changes:update({
    id = "test:existing",
    kind = "test.kind",
    meta = {updated = true},
    data = {new_value = true}
})

changes:delete("test:old_entry")

local new_version, err = changes:apply()

Berechtigung: registry.apply für changes:apply()

Changes-Methoden

Version anwenden

Auf eine bestimmte Version vor- oder zurückrollen:

local prev = current_version:previous()
local ok, err = registry.apply_version(prev)

Berechtigung: registry.apply_version

Delta erstellen

Operationen berechnen, um zwischen Zuständen zu wechseln:

local from = {{id = "test:a", kind = "test", meta = {}, data = {}}}
local to = {{id = "test:b", kind = "test", meta = {}, data = {}}}

local ops, err = registry.build_delta(from, to)
for _, op in ipairs(ops) do
    print(op.kind, op.entry.id)  -- "entry.create", "entry.update", "entry.delete"
end

Berechtigungen

Fehler

Siehe Fehlerbehandlung für die Arbeit mit Fehlern.