モジュール:Effective protection expiry

モジュールの解説かいせつ[表示ひょうじ] [編集へんしゅう] [履歴りれき] [キャッシュを破棄はき]

ページに対たいする特定とくてい操作そうさの制限せいげん（いわゆる保護ほご）の有効ゆうこう期限きげんを取得しゅとくするためのモジュールです。

使つかい方かた

このモジュールは呼よび出だされる毎ごとに高こう負荷ふかパーサー関数かんすうを1回かいまで呼よび出だします。すでにモジュール:Effective protection levelを呼よび出だしている場合ばあいは高こう負荷ふかパーサー関数かんすうを呼よび出だしません。

ほかのモジュールからの利用りよう

下記かきのようにモジュールを呼よび出だしてください。

local effectiveProtectionExpiry = require('モジュール:Effective protection expiry')._main

この関数かんすうは引数ひきすうを2つ使用しようします。第だい1引数ひきすうはページに対たいする操作そうさ（"edit"、"create"、"move"、"upload"、"autoreview"のどれか）を指定していします。第だい2引数ひきすうは操作そうさを行おこなうページ名めいを指定していします。第だい2引数ひきすうを省略しょうりゃくした場合ばあい、モジュールが呼よび出だされたページのページ名めいが使用しようされます。

この関数かんすうの戻もどり値ちは有効ゆうこう期限きげんのタイムスタンプ（書式しょしき：YY-MM-DDThh:mm:ss）の文字もじ列れつです。ただし、下記かきの例外れいがいがあります。

infinity - 無む期限きげん保護ほごの場合ばあいか、保護ほごされていないページ（ページが存在そんざいする場合ばあい）
unknown - 有効ゆうこう期限きげんが不明ふめいな場合ばあい、保護ほごされていないページ（ページが存在そんざいしない場合ばあい）

ページが存在そんざいし、かつ保護ほごされていない場合ばあいはinfinityを返かえすので、一般いっぱん的てきには保護ほごレベルを調しらべるモジュール:Effective protection levelと併用へいようします。

ウィキテキストからの利用りよう

下記かきのように呼よび出だします。引数ひきすうはモジュールから呼よび出だす場合ばあいと同おなじです。

{{#invoke:Effective protection expiry|操作そうさ|ページ名めい}}

関連かんれん項目こうもく

モジュール:Effective protection level

この解説かいせつは、モジュール:Effective protection expiry/docから呼よび出だされています。
編集へんしゅう者しゃは、このモジュールをサンドボックスとテストケースで試ためすことができます。（解説かいせつ）
このモジュールのサブページ一覧いちらん。

local p = {}

-- Returns the expiry of a restriction of an action on a given title, or unknown if it cannot be known.
-- If no title is specified, the title of the page being displayed is used.
function p._main(action, pagename)
	local title
	if type(pagename) == 'table' and pagename.prefixedText then
		title = pagename
	elseif pagename then
		title = mw.title.new(pagename)
	else
		title = mw.title.getCurrentTitle()
	end
	pagename = title.prefixedText
	if action == 'autoreview' then
		local stabilitySettings = mw.ext.FlaggedRevs.getStabilitySettings(title)
		return stabilitySettings and stabilitySettings.expiry or 'unknown'
	elseif action ~= 'edit' and action ~= 'move' and action ~= 'create' and action ~= 'upload' then
		error( '第だい1引数ひきすうにはedit、move、create、upload、autoreviewのどれかを指定していしてください', 2 )
	end
	local rawExpiry = mw.getCurrentFrame():callParserFunction('PROTECTIONEXPIRY', action, pagename)
	if rawExpiry == 'infinity' then
		return 'infinity'
	elseif rawExpiry == '' then
		return 'unknown'
	else
		local year, month, day, hour, minute, second = rawExpiry:match(
			'^(%d%d%d%d)(%d%d)(%d%d)(%d%d)(%d%d)(%d%d)$'
		)
		if year then
			return string.format(
				'%s-%s-%sT%s:%s:%s',
				year, month, day, hour, minute, second
			)
		else
			error('[[モジュール:Effective protection expiry]]のエラー; 有効ゆうこう期限きげんのタイムスタンプの書式しょしきが不正ふせいです')
		end
	end
end

setmetatable(p, { __index = function(t, k)
	return function(frame)
		return t._main(k, frame.args[1])
	end
end })

return p