اكتشاف الإضافات وتحميلها

ما هي بنية الإضافات؟

اكتشاف الإضافات وفق اصطلاح التسمية

local function discoverPlugins(dir)
  local plugins = {}
  -- platform-specific dir scan; here a mock example
  for _, name in ipairs({"logger", "cache", "auth"}) do
    local ok, mod = pcall(require, dir .. "." .. name)
    if ok then plugins[name] = mod end
  end
  return plugins
end

استخدام package.path للاكتشاف

package.path = package.path .. ";./plugins/?.lua"
local plugin = require("myplugin")

استخدام loadfile للتحميل الديناميكي

local function loadPlugin(path)
  local chunk, err = loadfile(path)
  if not chunk then return nil, err end
  local ok, result = pcall(chunk)
  if not ok then return nil, result end
  return result
end

بيان الإضافة

-- plugins/logger.lua
return {
  name    = "logger",
  version = "1.0",
  deps    = {},
  init    = function(app) app:on("log", print) end,
}

حل التبعيات

local function initPlugin(app, plugins, name)
  local p = plugins[name]
  if not p then error("Plugin not found: " .. name) end
  for _, dep in ipairs(p.deps or {}) do
    if not plugins[dep] then
      error(("Plugin %s requires %s"):format(name, dep))
    end
  end
  if p.init then p.init(app) end
end

إعادة تحميل الإضافات أثناء التشغيل

package.loaded["plugins.logger"] = nil
plugins.logger = require("plugins.logger")
plugins.logger.init(app)

سجل الإضافات

عزل الأخطاء

local ok, err = pcall(function()
  plugins[name] = loadPlugin(path)
  initPlugin(app, plugins, name)
end)
if not ok then
  print("Plugin load failed:", name, err)
end

البيانات الوصفية للإضافة

التحميل الكسول

سؤال حول تحميل الإضافات

مراجعة: اكتشاف الإضافات وتحميلها