Udev-Rules/src/scripts/python/util/x.py

import subprocess
from typing import List
from multipledispatch import dispatch

ENCODING = 'utf-8'


@dispatch()
def get_list_short():
    """Returns string output of the `xinput --list --short` command encoded as
    UTF-8"""
    completed = subprocess.run(
        ['xinput', '--list', '--short'], capture_output=True)
    return completed.stdout.decode(ENCODING)


@dispatch(int)
def get_list_short(id):
    """Short List of the id

    Args:
        id (int): id registered in xinput

    Rises:
        ValueError: in case of id not found in devices
    """
    completed = subprocess.run(
        ['xinput', '--list', '--short', str(id)], capture_output=True)

    if completed.returncode == 0:
        return completed.stdout.decode(ENCODING)
    else:
        ValueError(f'id[{id}] is not registered')


def reattach(id, master):
    """Reattach a device to a master

    Args:
        id (str|int): name of the slave or id
        master (_type_): _description_

    TODO: Error handling should be done. BUT, if the master is not a master or
    id is not valid, xinput will not do anything and nothing bad will happen :)
    """
    completed = subprocess.run(
        ['xinput', '--reattach', str(id), str(master)], capture_output=True)

    return completed.returncode


def get_ids() -> List[int]:
    """returns list of ids registered in xinput"""
    completed = subprocess.run(
        ['xinput', '--list', '--id-only'], capture_output=True)
    return list(map(int, completed.stdout.decode(ENCODING).split()))


def create_master(name: str = 'touch'):
    """Creates master with specified name

    Args:
        name (str, optional): name of the master. Defaults to 'touch'.
    """
    completed = subprocess.run(
        ['xinput create-master', name]
    )
    
    return completed.returncode


def map_to_output(output, device_id):
    pass