PyLink/coremods/permissions.py

"""
permissions.py - Permissions Abstraction for PyLink IRC Services.
"""

from collections import defaultdict
import threading

# Global variables: these store mappings of hostmasks/exttargets to lists of permissions each target has.
default_permissions = defaultdict(set)
permissions = defaultdict(set, {'$pylinkacc': {'*'}})

# Only allow one thread to change the permissions index at once.
permissions_lock = threading.Lock()

from pylinkirc import conf, utils
from pylinkirc.log import log

def resetPermissions():
    """
    Loads the permissions specified in the permissions: block of the PyLink configuration,
    if such a block exists. Otherwise, fallback to the default permissions specified by plugins.
    """
    with permissions_lock:
        global permissions
        log.debug('permissions.resetPermissions: old perm list: %s', permissions)

        new_permissions = default_permissions.copy()
        log.debug('permissions.resetPermissions: new_permissions %s', new_permissions)
        if not conf.conf.get('permissions_merge_defaults', True):
            log.debug('permissions.resetPermissions: clearing perm list due to permissions_merge_defaults set False.')
            new_permissions.clear()

        # Convert all perm lists to sets.
        for k, v in conf.conf.get('permissions', {}).items():
            new_permissions[k] |= set(v)

        log.debug('permissions.resetPermissions: new_permissions %s', new_permissions)
        permissions.clear()
        permissions.update(new_permissions)
        log.debug('permissions.resetPermissions: new perm list: %s', permissions)

def addDefaultPermissions(perms):
    """Adds default permissions to the index."""
    with permissions_lock:
        global default_permissions
        for target, permlist in perms.items():
            default_permissions[target] |= set(permlist)

def removeDefaultPermissions(perms):
    """Remove default permissions from the index."""
    with permissions_lock:
        global default_permissions
        for target, permlist in perms.items():
            default_permissions[target] -= set(permlist)

def checkPermissions(irc, uid, perms, also_show=[]):
    """
    Checks permissions of the caller. If the caller has any of the permissions listed in perms,
    this function returns True. Otherwise, NotAuthorizedError is raised.
    """
    # Iterate over all hostmask->permission list mappings.
    for host, permlist in permissions.copy().items():
        log.debug('permissions: permlist for %s: %s', host, permlist)
        if irc.matchHost(host, uid):
            # Now, iterate over all the perms we are looking for.
            for perm in permlist:
                # Use irc.matchHost to expand globs in an IRC-case insensitive and wildcard
                # friendly way. e.g. 'xyz.*.#Channel\' will match 'xyz.manage.#channel|' on IRCds
                # using the RFC1459 casemapping.
                log.debug('permissions: checking if %s glob matches anything in %s', perm, permlist)
                if any(irc.matchHost(perm, p) for p in perms):
                    return True
    raise utils.NotAuthorizedError("You are missing one of the following permissions: %s" %
                                   (', '.join(perms+also_show)))