Module:File

Module documentation[ view · edit · history · purge ]

This documentation is transcluded from Module:File/doc.

Scope

File title and file information. If the code here grows beyond a border line, this should be converted to an interface and the processing code should be outsourced.^{[Please clarify – October 2024]}

Usage

Note that an error is thrown if the title can't be constructed (e.g. a title containing invalid characters is supplied) or metadata isn't available (e.g. due to missing file or extraction error). It is your responsibility to catch them; in Lua through pcall(); from Wikitext as {{#iferror: {{#invoke:File|function|file=File:P%bar]baz.qqq}} | meaningful message}}.

From Wikitext

Examples:

{{#invoke:File|woExtension|file=File:Test.C.JpeG}} →

{{#invoke:File|extension|file=File:Test.C.JpeG}} →

{{#invoke:File|csExtension|file=File:Test.C.JpeG}} →

{{#invoke:File|mime|file=File:DOESNOTEXIST-0a8de8c83.Png}} → deprecated (but works even if the file does not exist and has no metadata)

{{#invoke:File|mimeType|file=File:DOESNOTEXIST-0a8de8c83.Png}} → preferred (but will not work if the file does not exist to parse its metadata)

{{#invoke:File|fileExists|file=File:Commons-logo.png}} →

{{#invoke:File|fileExists|file=File:DOESNOTEXIST-0a8de8c83.png}} →

{{#invoke:File|fileExistsRelaxed|file=File:Ba[!#llot-sprite.png}} →

{{#invoke:File|width|file=File:Commons-logo.png}} →

{{#invoke:File|height|file=File:Commons-logo.png}} →

{{#invoke:File|dimensions|file=File:Commons-logo.png}} →

{{#invoke:File|size|file=File:Commons-logo.png}} →

-- Module for handling Media files (Origin: Wikimedia Commons)
local File = function(title)
	local funcs = {}
	funcs.extension = function()
		local parts = mw.text.split( title, '.', true )
		return parts[#parts]:lower()
	end
	return funcs
end

local p = {}
p.File = File
p.fileExtension = function(frame)
    return File(frame.args[1] or frame.args["file"] or frame.args["title"]).extension()
end

return p