export / import

Вызов функций чужого плагина

export / import

Вызов функций чужого плагина.

Плагины изолированы: глобальные переменные одного не видны другому.

вопрос	чем
«выполни то, что умеет вон тот плагин»	эта страница
«сообщи всем, кому интересно»	hook.run

-- в admin_manager
export("open", function(p) ui.root(p) end)

-- в любом другом
local admin = import("admin_manager")
local shop  = optional("shop")

admin.open(p)
if shop then shop.give(p, "vip") end

Прокси резолвит функцию на каждом вызове, поэтому в руках не останется указателя на код исчезнувшего плагина. Ошибка внутри экспорта не роняет вызывающего: она заворачивается в [export плагин.имя] ....

Экспорты снимаются вместе с плагином, поэтому lua_reload <plugin> не натыкается на «export уже зарегистрирован».

Кто что публикует — консольная команда lua_exports.

export

Публикует функцию плагина наружу.

export(name, fn[, opts])

Аргументы

#	имя	тип
1	name	string	имя функции
2	fn	function	что вызывать
3	opts	table | nil	см. Опции

Возвращает

Ничего.

Опции

поле	тип
version	number	версия экспорта, по умолчанию 1
override	boolean	разрешить перерегистрацию имени

import

Возвращает прокси к экспортам плагина; жёсткая зависимость.

import(plugin)

Аргументы

#	имя	тип
1	plugin	string	id плагина — имя его папки

Возвращает

тип
table	прокси к экспортам

Бросает ошибку, если плагина нет: зависимость падает при загрузке, а не через час на nil-вызове.

Плагины грузятся по алфавиту, поэтому import на этапе загрузки видит только тех, кто отсортирован раньше. Если порядок неудобен, бери зависимость лениво — внутри обработчика — или через optional.

optional

То же, что import, но nil вместо ошибки; мягкая зависимость.

optional(plugin)

Аргументы

#	имя	тип
1	plugin	string	id плагина

Возвращает

тип
table | nil	nil, если плагина нет

Пример

local shop = optional("shop")
if shop then
	shop.give(p, "vip")
end