mirror of
https://github.com/jlu5/PyLink.git
synced 2024-12-26 12:43:09 +01:00
c1158fd33a
Closes #639.
227 lines
8.9 KiB
Python
227 lines
8.9 KiB
Python
"""
|
|
exttargets.py - Implements extended targets like $account:xyz, $oper, etc.
|
|
"""
|
|
|
|
from pylinkirc import world
|
|
from pylinkirc.log import log
|
|
|
|
def bind(func):
|
|
"""
|
|
Binds an exttarget with the given name.
|
|
"""
|
|
world.exttarget_handlers[func.__name__] = func
|
|
return func
|
|
|
|
@bind
|
|
def account(irc, host, uid):
|
|
"""
|
|
$account exttarget handler. The following forms are supported, with groups separated by a
|
|
literal colon. Account matching is case insensitive, while network name matching IS case
|
|
sensitive.
|
|
|
|
$account -> Returns True (a match) if the target is registered.
|
|
$account:accountname -> Returns True if the target's account name matches the one given, and the
|
|
target is connected to the local network.
|
|
$account:accountname:netname -> Returns True if both the target's account name and origin
|
|
network name match the ones given.
|
|
$account:*:netname -> Matches all logged in users on the given network.
|
|
"""
|
|
userobj = irc.users[uid]
|
|
homenet = irc.name
|
|
if hasattr(userobj, 'remote'):
|
|
# User is a PyLink Relay pseudoclient. Use their real services account on their
|
|
# origin network.
|
|
homenet, realuid = userobj.remote
|
|
log.debug('(%s) exttargets.account: Changing UID of relay client %s to %s/%s', irc.name,
|
|
uid, homenet, realuid)
|
|
try:
|
|
userobj = world.networkobjects[homenet].users[realuid]
|
|
except KeyError: # User lookup failed. Bail and return False.
|
|
log.exception('(%s) exttargets.account: KeyError finding %s/%s:', irc.name,
|
|
homenet, realuid)
|
|
return False
|
|
|
|
slogin = irc.to_lower(str(userobj.services_account))
|
|
|
|
# Split the given exttarget host into parts, so we know how many to look for.
|
|
groups = list(map(irc.to_lower, host.split(':')))
|
|
log.debug('(%s) exttargets.account: groups to match: %s', irc.name, groups)
|
|
|
|
if len(groups) == 1:
|
|
# First scenario. Return True if user is logged in.
|
|
return bool(slogin)
|
|
elif len(groups) == 2:
|
|
# Second scenario. Return True if the user's account matches the one given.
|
|
return slogin == groups[1] and homenet == irc.name
|
|
else:
|
|
# Third or fourth scenario. If there are more than 3 groups, the rest are ignored.
|
|
# In other words: Return True if the user is logged in, the query matches either '*' or the
|
|
# user's login, and the user is connected on the network requested.
|
|
return slogin and (groups[1] in ('*', slogin)) and (homenet == groups[2])
|
|
|
|
@bind
|
|
def ircop(irc, host, uid):
|
|
"""
|
|
$ircop exttarget handler. The following forms are supported, with groups separated by a
|
|
literal colon. Oper types are matched case insensitively.
|
|
|
|
$ircop -> Returns True (a match) if the target is opered.
|
|
$ircop:*admin* -> Returns True if the target's is opered and their opertype matches the glob
|
|
given.
|
|
"""
|
|
groups = host.split(':')
|
|
log.debug('(%s) exttargets.ircop: groups to match: %s', irc.name, groups)
|
|
|
|
if len(groups) == 1:
|
|
# 1st scenario.
|
|
return irc.is_oper(uid)
|
|
else:
|
|
# 2nd scenario. Use match_host (ircmatch) to match the opertype glob to the opertype.
|
|
return irc.match_host(groups[1], irc.users[uid].opertype)
|
|
|
|
@bind
|
|
def server(irc, host, uid):
|
|
"""
|
|
$server exttarget handler. The following forms are supported, with groups separated by a
|
|
literal colon. Server names are matched case insensitively, but SIDs ARE case sensitive.
|
|
|
|
$server:server.name -> Returns True (a match) if the target is connected on the given server.
|
|
$server:server.glob -> Returns True (a match) if the target is connected on a server matching the glob.
|
|
$server:1XY -> Returns True if the target's is connected on the server with the given SID.
|
|
"""
|
|
groups = host.split(':')
|
|
log.debug('(%s) exttargets.server: groups to match: %s', irc.name, groups)
|
|
|
|
if len(groups) >= 2:
|
|
sid = irc.get_server(uid)
|
|
query = groups[1]
|
|
# Return True if the SID matches the query or the server's name glob matches it.
|
|
return sid == query or irc.match_host(query, irc.get_friendly_name(sid))
|
|
# $server alone is invalid. Don't match anything.
|
|
return False
|
|
|
|
@bind
|
|
def channel(irc, host, uid):
|
|
"""
|
|
$channel exttarget handler. The following forms are supported, with groups separated by a
|
|
literal colon. Channel names are matched case insensitively.
|
|
|
|
$channel:#channel -> Returns True if the target is in the given channel.
|
|
$channel:#channel:op -> Returns True if the target is in the given channel, and is opped.
|
|
Any other supported prefix (owner, admin, op, halfop, voice) can be given, but only one at a
|
|
time.
|
|
"""
|
|
groups = host.split(':')
|
|
log.debug('(%s) exttargets.channel: groups to match: %s', irc.name, groups)
|
|
try:
|
|
channel = groups[1]
|
|
except IndexError: # No channel given, abort.
|
|
return False
|
|
|
|
if channel not in irc.channels:
|
|
# Channel doesn't even exist...
|
|
return False
|
|
|
|
if len(groups) == 2:
|
|
# Just #channel was given as query
|
|
return uid in irc.channels[channel].users
|
|
elif len(groups) >= 3:
|
|
# For things like #channel:op, check if the query is in the user's prefix modes.
|
|
return (uid in irc.channels[channel].users) and (groups[2].lower() in irc.channels[channel].get_prefix_modes(uid))
|
|
|
|
@bind
|
|
def pylinkacc(irc, host, uid):
|
|
"""
|
|
$pylinkacc (PyLink account) exttarget handler. The following forms are supported, with groups
|
|
separated by a literal colon. Account matching is case insensitive.
|
|
|
|
$pylinkacc -> Returns True if the target is logged in to PyLink.
|
|
$pylinkacc:accountname -> Returns True if the target's PyLink login matches the one given.
|
|
"""
|
|
login = irc.to_lower(irc.users[uid].account)
|
|
groups = list(map(irc.to_lower, host.split(':')))
|
|
log.debug('(%s) exttargets.pylinkacc: groups to match: %s', irc.name, groups)
|
|
|
|
if len(groups) == 1:
|
|
# First scenario. Return True if user is logged in.
|
|
return bool(login)
|
|
elif len(groups) == 2:
|
|
# Second scenario. Return True if the user's login matches the one given.
|
|
return login == groups[1]
|
|
|
|
@bind
|
|
def network(irc, host, uid):
|
|
"""
|
|
$network exttarget handler. This exttarget takes one argument: a network name, and returns
|
|
a match for all users on that network.
|
|
|
|
Note: network names are case sensitive.
|
|
"""
|
|
try:
|
|
targetnet = host.split(':')[1]
|
|
except IndexError: # No network arg given, bail.
|
|
return False
|
|
|
|
userobj = irc.users[uid]
|
|
if hasattr(userobj, 'remote'):
|
|
# User is a PyLink Relay client; set the correct network name.
|
|
homenet = userobj.remote[0]
|
|
else:
|
|
homenet = irc.name
|
|
|
|
return homenet == targetnet
|
|
|
|
# Note: "and" can't be a function name so we use this.
|
|
def exttarget_and(irc, host, uid):
|
|
"""
|
|
$and exttarget handler. This exttarget takes a series of exttargets (or hostmasks) joined with
|
|
a "+", and returns True if all sub exttargets match.
|
|
|
|
Examples:
|
|
$and:($ircop:*admin*+$network:ovd) -> Matches all opers on the network ovd.
|
|
$and:($account+$pylinkirc) -> Matches all users logged in to both services and PyLink.
|
|
$and:(*!*@localhost+$ircop) -> Matches all opers with the host `localhost`.
|
|
$and:(*!*@*.mibbit.com+!$ircop+!$account) -> Matches all mibbit users that aren't opered or logged in to services.
|
|
"""
|
|
targets = host.split(':', 1)[-1]
|
|
# For readability, this requires that the exttarget list be wrapped in brackets.
|
|
if not (targets.startswith('(') and targets.endswith(')')):
|
|
return False
|
|
|
|
targets = targets[1:-1]
|
|
targets = list(filter(None, targets.split('+')))
|
|
log.debug('exttargets_and: using raw subtargets list %r (original query=%r)', targets, host)
|
|
# Wrap every subtarget into irc.match_host and return True if all subtargets return True.
|
|
return all(map(lambda sub_exttarget: irc.match_host(sub_exttarget, uid), targets))
|
|
world.exttarget_handlers['and'] = exttarget_and
|
|
|
|
@bind
|
|
def realname(irc, host, uid):
|
|
"""
|
|
$realname exttarget handler. This takes one argument: a glob, which is compared case-insensitively to the user's real name.
|
|
|
|
Examples:
|
|
$realname:*James* -> matches anyone with "James" in their real name.
|
|
"""
|
|
groups = host.split(':')
|
|
if len(groups) >= 2:
|
|
return irc.match_host(groups[1], irc.users[uid].realname)
|
|
|
|
@bind
|
|
def service(irc, host, uid):
|
|
"""
|
|
$service exttarget handler. This takes one optional argument: a glob, which is compared case-insensitively to the target user's service name (if present).
|
|
|
|
Examples:
|
|
$service -> Matches any PyLink service bot.
|
|
$service:automode -> Matches the Automode service bot.
|
|
"""
|
|
if not irc.users[uid].service:
|
|
return False
|
|
|
|
groups = host.split(':')
|
|
|
|
if len(groups) >= 2:
|
|
return irc.match_host(groups[1], irc.users[uid].service)
|
|
return True # It *is* a service bot because of the check at the top.
|