Module:scripts

Definition from Wiktionary, the free dictionary
Jump to: navigation, search
The following documentation is located at Module:scripts/documentation. [edit]
Nuvola apps important yellow.svg This module is not ready for use.
This module may not work properly, because it has not been completed and is being kept for tests and improvement. Its arguments, functions and results may change without warning.

It is advisable not to use this module as of yet. You may edit this page or discuss possible changes.

This module is used to retrieve and manage Wiktionary's various writing systems and the information associated with them. See Wiktionary:Scripts for more information.

The information itself is stored in Module:scripts/data. This module should not be used directly by any other module, the data should only be accessed through the functions provided by Module:scripts.

Finding and retrieving scripts[edit]

The module exports a number of functions that are used to find scripts.

getScriptByCode[edit]

getScriptByCode(code)

Finds the script whose code matches the one provided. If it exists, it returns a Script object representing the script. Otherwise, it returns nil.

Script objects[edit]

A Script object is returned from one of the functions above. It is a Lua representation of a script and the data associated with it. It has a number of methods that can be called on it, using the : syntax. For example:

local m_scripts = require("Module:scripts")
local sc = m_scripts.getScriptByCode("Latn")
local name = sc:getCanonicalName()
-- "name" will now be "Latin"

Script:getCode[edit]

:getCode()

Returns the script code of the language. Example: "Cyrl" for Cyrillic.

Script:getCanonicalName[edit]

:getCanonicalName()

Returns the canonical name of the script. This is the name used to represent that script on Wiktionary. Example: "Cyrillic" for Cyrillic.

Script:getAllNames[edit]

:getAllNames()

Returns a table of all names that the script is known by, including the canonical name. The names are not guaranteed to be unique, sometimes more than one script is known by the same name. Example: {"Latin", "Roman"} for the Latin script.

Script:isTextIn[edit]

:isTextIn(text)

Checks whether the given text contains one or more characters of this script. Returns true if so, false if not.

Script:getCategoryName[edit]

:getCategoryName()

Returns the name of the main category of that script. Example: "Cyrillic script" for Cyrillic, whose category is at Category:Cyrillic script.


local export = {}
 
local Script = {}
 
function Script:getRawData()
    return self._rawData
end
 
function Script:getCode()
    return self._code
end
 
function Script:getCanonicalName()
    return self._rawData.names[1]
end
 
function Script:getAllNames()
    return self._rawData.names
end
 
function Script:isTextIn(text)
	return mw.ustring.find(text, self._rawData.characters) ~= nil
end
 
function Script:getCategoryName()
	local name = self._rawData.names[1]
 
	-- If the name already has "script" in it, don't add it.
	if name:find("[Ss]script$") then
		return name
	else
		return name .. " script"
	end
end
 
Script.__index = Script
 
-- The object cache implements memoisation, and is used to avoid duplication
-- of objects. If you request the same family code twice, you should also get
-- the same object twice, not two different objects with identical data.
-- It might also speed things up a bit.
local object_cache = {}
 
function export.getScriptByCode(code)
	if object_cache[code] then
		return object_cache[code]
	end
 
    local rawData = mw.loadData("Module:scripts/data")[code]
 
    if rawData then
    	local object = setmetatable({ _rawData = rawData, _code = code }, Script)
    	object_cache[code] = object
        return object
    else
        return nil
    end
end
 
return export