# bureau import configparser import functools import inspect import json import logging import os.path import subprocess import tempfile import textwrap import threading import time import lmdb import PIL import zmq from escpos import printer from mako.template import Template def update_commands(cls): """ this is some internal magic to keep track of our commands """ for name, method in cls.__dict__.items(): print("name %s method %s" % (name, method)) if hasattr(method, "command"): comstr = method.command cls.commands[comstr] = method return cls def add_command(comstr, name=""): """ decorator for making a method into a command """ def decorator(func): """ the decorator itself """ @functools.wraps(func) def func_wrap(*args, **kwargs): """ this is to avoid roaching the namespace """ return func(*args, **kwargs) func_wrap.command = comstr func_wrap.name = name return func_wrap return decorator def add_api(apistr, name=""): """ decorator for making a method into a public bureau api method""" def decorator(func): """ the decorator itself """ @functools.wraps(func) def func_wrap(*args, **kwargs): """ this is to avoid roaching the namespace """ return func(*args, **kwargs) func_wrap.api = apistr func_wrap.name = name return func_wrap return decorator class Bureau(object): """ Bureau is a base class that implements standard methods for inter-bureau communication, IO, registration and some convenient stuff for printing. """ name = "TEST" prefix = "00" version = 0 default_config = {"smallprinter": "/dev/usb/lp0"} def __init__(self): """ set up ZeroMQ connections and register commands""" self.commands = {} self.api = {} modpath = os.path.dirname(__file__) xvfb = "xvfb-run" slimerjs = os.path.join(modpath, "..", "lib", "slimerjs", "slimerjs") renderer = os.path.join(modpath, "..", "slimerjs", "rasterize.js") self.slimerjs = os.path.abspath(slimerjs) self.html2pdf = xvfb + " " + self.slimerjs + " " + \ os.path.abspath(renderer) + " " mypath = inspect.getfile(self.__class__) self.mdir = os.path.dirname(mypath) basepath = os.path.expanduser("~/.screenless") if not os.path.exists(basepath): os.mkdir(basepath) os.chdir(basepath) # setup log file # TODO: make log level globally and bureau-specific via config # TODO: custom handler to print errors to small printer logfile = os.path.join(basepath, self.prefix + ".log") logging.basicConfig(filename=logfile, level=logging.DEBUG) self.log = logging.getLogger(self.prefix) self.config = configparser.ConfigParser() self.load_config() # setup a dir to store files and data self.datadir = os.path.join(basepath, self.prefix) if not os.path.exists(self.datadir): os.mkdir(self.datadir) # set up a basic key-value store with LMDB - max 10 sub-dbs # if a bureau needs more then just import lmdb and roll your own dbfile = os.path.join(self.datadir, self.prefix + ".lmdb") self.dbenv = lmdb.open(dbfile, max_dbs=10) self.context = zmq.Context() self._recv = self.context.socket(zmq.REP) self._recv.bind("ipc://" + self.prefix + ".ipc") self.log.debug("bureau " + self.name + " waiting for messages") self.log.debug("commands: ") self.log.debug(str(self.commands)) def load_config(self): """ load (or reload) config data from file """ cfgfile = self.prefix + ".ini" if os.path.exists(cfgfile): self.config.read(cfgfile) else: self.config["DEFAULT"] = self.default_config self.config["bureau"] = self.default_config with open(cfgfile, "w") as configfile: self.config.write(configfile) def send(self, recipient, message, data=None): """ send commands or API calls to another bureau. recipient: the 2-character bureau ID message: a text based message as used in many commands data: an optional dict, used in API calls returns either empty string, text or a json object """ # clean up for sloppy offices message = message.strip() if not message.endswith("."): message += "." if data: message += json.dumps(data) sender = self.context.socket(zmq.REQ) sender.connect("ipc://" + recipient + ".ipc") sender.send_string(message) events = sender.poll(timeout=10000) if events is not 0: resp = sender.recv_string() if len(resp) == 0: return None elif resp[0] == "0": if len(resp) == 1: return None else: return json.loads(resp[1:]) else: # TODO: this may need some better error handling return resp else: self.log.warning("message" + message + " sent... timed out after 10 seconds.") return None def _publish_methods(self): """ this internal method registers all public commands and bureau API methods. Inhuman Resources module can then display menus and docs. """ # register bureau with Inhuman Resources bureau_detail = {"name": self.name, "prefix": self.prefix, "desc": self.__doc__} # slight hack to avoid messy self-reference and chicken-egg waiting if self.prefix == "IR": method = getattr(self, "add_bureau") method(bureau_detail) else: self.send("IR", "addbureau", bureau_detail) # find and store all published methods for member in dir(self): method = getattr(self, member) # ignore anything that is not a method with command or api details if not (callable(method) and (hasattr(method, "command") or hasattr(method, "api"))): continue if hasattr(method, "command"): self.commands[method.command] = method cmd_detail = {"cmdname": method.name, "prefix": self.prefix, "cmd": method.command, "desc": method.__doc__} if self.prefix == "IR": method = getattr(self, "add_cmd") method(cmd_detail) else: self.send("IR", "addcommand", cmd_detail) elif hasattr(method, "api"): self.api[method.api] = method api_detail = {"apiname": method.name, "prefix": self.prefix, "api": method.api, "desc": method.__doc__} if self.prefix == "IR": method = getattr(self, "add_api_method") method(api_detail) else: self.send("IR", "addapi", api_detail) self.log.debug("registered:") self.log.debug(str(self.commands)) self.log.debug(str(self.api)) def print_full(self, template, **kwargs): """print a full page (A4) document """ # TODO: look up the printer LPR name / allow multiple printers/non-default # lpname = kwargs.get("printer", "default") htmlfile, htmlpath = tempfile.mkstemp(".html") htmlfile = os.fdopen(htmlfile, "w") # run template with kwargs templfile = os.path.join(self.mdir, template) self.log.debug("printing with template: %s", templfile) templ = Template(filename=templfile, strict_undefined=True) htmlfile.write(templ.render_unicode(**kwargs)) htmlfile.close() #.encode('utf-8', # 'replace')) # texfile, texfilepath = tempfile.mkstemp(".tex") # texfile.write(templ.render_unicode( # **kwargs).encode('utf-8', 'replace')) # texdir = os.path.dirname(texfilepath) # subprocess.call("cd " + texdir + "; xelatex " + texfilepath) # TODO: make paper size a config variable pdfpath = tempfile.mkstemp(".pdf")[1] self.log.debug("rendering with: " + self.html2pdf + htmlpath + " " + pdfpath) subprocess.call(self.html2pdf + htmlpath + " " + pdfpath + " A4 1920px", shell=True) subprocess.call("lpr " + pdfpath, shell=True) # TODO: make this asynchronous def print_small(self, text, cut=True): """ print on Thermal Line printer. """ # TODO: look up device and width in config prn = printer.Usb(0x416, 0x5011, in_ep=0x81, out_ep=0x03) text = textwrap.fill(text, width=48) text += "\r\n" * 2 prn.text(text + "\r\n\r\n") if cut: prn.cut() def print_small_image(self, img): """ print an image on the mini thermal printer. """ # TODO: make printer id/width configured and easy prn = printer.Usb(0x416, 0x5011, in_ep=0x81, out_ep=0x03) im = PIL.Image.open(img) # NOTE: might be worth tring to push up brightness im = PIL.ImageOps.equalize(im) # stretch histogram for nicer dither im.thumbnail((576, 576), PIL.Image.ANTIALIAS) # resize to fit printer prn.image(im, impl="bitImageColumn") # not using this impl crashes ?? @add_command("test") def test(self, data=None): """ Standard test command. """ # stupid test to see if modules work print(("hi! testing. " + self.name + " bureau seems to work!")) return "seems to work." def run_io(self): """process hardware or timed input This method can be ignored for most Bureaus. It should be overloaded for any services that need to independently generate messages as this is just a placeholder. It is run in a separate thread and should handle any input or timed events. Messages are then sent to other Bureaus via the self.send connection to the OfficeManager. Don't forget to to consier thread safety issues when accessing data! """ pass def run(self): """ main loop for processing messages This runs all relelvant event processing loops. """ # start the hardware input handler io_handler = threading.Thread(target=self.run_io) io_handler.start() # register commands and api methods self._publish_methods() poller = zmq.Poller() poller.register(self._recv, zmq.POLLIN) while True: msgs = dict(poller.poll(500)) if msgs: if msgs.get(self._recv) == zmq.POLLIN: msg = self._recv.recv_string(flags=zmq.NOBLOCK) else: continue # msg = self._recv.recv_string(flags=zmq.NOBLOCK) #except zmq.ZMQError: # time.sleep(0.05) # don't waste CPU # continue try: self.log.debug("got message:" + msg) dot = msg.find(".") ref = msg[:dot] if (dot < len(msg) - 1) and (dot > 0): self.log.debug("msg length: %d", len(msg)) self.log.debug("dot at %d", dot) # TODO: maybe trim off the trailing "." for convenience data = msg[dot + 1:] # data = str(data) # force to be a string else: data = None self.log.debug("data: " + str(data)) except IndexError as err: self.log.warning("invalid message: %s", err) continue self.log.debug("got method: " + ref) if (ref in self.commands) or (ref in self.api): # catch TypeErrors for case of bogus params try: if ref in self.api: if data: data = json.loads(data) ret = json.dumps(self.api[ref](data)) else: ret = json.dumps(self.api[ref]()) else: if data: ret = self.commands[ref](data) else: ret = self.commands[ref]() if ret is None: ret = "" ret = "0" + ret self._recv.send_string(ret) #except TypeError as err: # print(err) # print("invalid data for command '{}': {}".format(ref, data)) # self._recv.send_unicode("Error. Invalid or missing data.") except KeyError as err: self.log.warning(str(err)) self.log.warning("You are calling a command as an API or vice-versa.") self._recv.send_unicode( "Error. Command called as API or API as command.") else: self.log.warning("error! Command/API %s not found", ref) self._recv.send_unicode("Error! Command/API not found.") def main(): buro = Bureau() buro.run() if __name__ == "__main__": main()