Module:Unsigned/sandbox: Difference between revisions

Module documentation[view] [edit] [history] [purge]

This module implements {{unsigned}}. It has a few functions:

• main called by {{unsigned}}; not intended for broader use
• getTimestamp find a timestamp from a string. If only a date is found, it returns the date. If only a time is found, it returns the empty string. If a time and a date are both found, it appends (UTC).
• getUsername gets the username from a string containing a timestamp. It currently assumes that everything besides a timestamp is part of the username.

The above documentation is transcluded from Module:Unsigned/doc. (edit | history)
Editors can experiment in this module's sandbox (edit | diff) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this module.

local p = {}
-- alternative module title: HouseBlaster attempts to get around Lua patterns being awful
-- There's probably a way to use strptime or some other more sophisticated way, but you're not supposed to be using a non-timestamp as input anyway.

local function endswith(String,End)
	return End == '' or string.sub(String,-string.len(End)) == End
end

local function trim(s)
	return s:gsub("^%s+", ""):gsub("%s+$", ""):gsub("\226\128\142", "")
end

local function addUtcToStringIfItDoesNotEndWithUtc(s)
	if s == "" or endswith(s, "~~~~") then return s end
	if not endswith(s, "(UTC)") then
		return s .. " (UTC)"
	end
	return s
end

local function _main(args)
	local hopefullyTimestamp = args[1] or os.date('%H:%M, %d %B %Y (%Z)')
	return addUtcToStringIfItDoesNotEndWithUtc(trim(hopefullyTimestamp))
end

function p.getTimestamp(s)
	--gets the timestamp in the input
	--if nothing is found, returns the empty string
	--we search for time and date seperately to allow for a time-less addition of date
	local toReturn
	--match on a nil is a bad thing
	local sOrBlank = s or ''
	toReturn = mw.ustring.match( sOrBlank, '%d%d:%d%d,?', 0 ) or ''
	if toReturn then
		toReturn = toReturn .. ' '
	end
	toReturn = toReturn .. (mw.ustring.match( sOrBlank, '%d%d? %u%l+ %d%d%d%d', 0 ) or '')
	toReturn = toReturn .. (mw.ustring.match( sOrBlank, ' %(UTC%)', 0 ) or '')
	return toReturn
end

function p.getUsername(s)
	--gets the username in the input
	--------WARNING--------
	--this method assumes that *everything* besides the timestamp is, in fact, part of the username
	--it does no further username validation
	--if you try putting random garbage in, you **will** get garbage out
	--------YOU HAVE BEEN WARNED--------
	local toReturn = s or ''
	--remove the date
	toReturn = mw.ustring.gsub( toReturn, '%d%d? %u%l+ %d%d%d%d', '', 1 ) or ''
	--remove the time
	toReturn = mw.ustring.gsub( toReturn, '%d%d:%d%d,?', '', 1) or ''
	--remove (UTC)
	toReturn = mw.ustring.gsub( toReturn, '%(UTC%)', '', 1) or ''
	--concat the empty string to ensure we only return the string and not the number of matches
	return trim(toReturn) .. ''
end

local function makeUnsigned(args)
	local isIP
	local username
	local timestamp
	local toReturn
	
	if args[2] then
		-- we have multiple parameters
		-- so we can be less janky
		timestamp = p.getTimestamp(args[2])
		if timestamp then
			username = args[1]
		else
			username = args[2]
			timestamp = args[1]
		end
	else
		-- be very janky; this has a high probability of GIGO-ing
		-- due to the way getUsername is implemented
		username = p.getUsername(args[1])
		timestamp = p.getTimestamp(args[1])
	end
	--isIp = require('Module:IPAddress').isIP(username)
	
	return mw.getCurrentFrame():expandTemplate{ title = 'unsigned/core', args = { username , timestamp or '' } } 
end

function p.main(frame)
	local args
	if type(frame.args) == 'table' then
		-- We're being called via #invoke. The args are passed through to the module
		-- from the template page, so use the args that were passed into the template.
		args = require('Module:Arguments').getArgs(frame)
	else
		-- We're being called from another module or from the debug console, so assume
		-- the args are passed in directly.
		args = frame
	end
	return makeUnsigned(args)
end

return p