Skip to main content

Client library for S.C.I.L.E.R.

Project description

Developing with scclib

Client computer library for S.C.I.L.E.R. system

This is the library to create devices to work together with the SCILER system


  • pip install with pip install scclib

Using this library

  • import lib with from scclib.device import Device
create a class that extends Device
  • in order to do this:
    • implement getStatus() which should return a dictionary of the current status
    • implement performInstruction(action) which should return a boolean of whether the instruction can be performed, where action has:
      • instruction: string with the name of the instruction
      • value: any type with a value specific for this instruction
      • component_id: string with the name of the component for which the instruction is meant (can be undefined)
    • implement test() which returns nothing, this method should do something visible so the operator can test this device works correctly
    • implement reset() which returns nothing, this method should make the device return to its starting state so that the escape room can be started again
    • create a constructor which calls the constructor of Device with super(config, logger) where:
      • config is a dictionary which has keys:
        • id: this is the id of a device. Write it in camelCase, e.g. "controlBoard".
        • host: the IP address of the host for the broker, formatted as a string.
        • port the port of the host for the broker, formatted as a number.
        • labels: these are the labels to which this device should also subscribe, labels is an array of strings,
      • logger is a function(date, level, message) in which an own logger is implemented where
        • date is an Date object
        • level is one of the following strings: 'debug', 'info', 'warn', 'error', 'fatal'
        • message is a custom string containing more information
      • it should also add event listeners to GPIO for all input components.
    • implement main() which should call start(loop, stop) with an optional event loop and ending function.
Now in your class which implements Device
  • you can call:
    • log(level, message) which logs using the logger provided in Device where level one of the following strings: 'debug', 'info', 'warn', 'error', 'fatal' and message custom string containing more information
    • statusChanged() which can be called to signal to Device that the status is changed, this will send a new status to SCILER
To now start the system
  • initialize the device in your main program and call device.main()


import os

from scclib.device import Device

class Display(Device):
    def __init__(self):
        two_up = os.path.abspath(os.path.join(__file__, ".."))
        rel_path = "display_config.json"
        abs_file_path = os.path.join(two_up, rel_path)
        abs_file_path = os.path.abspath(os.path.realpath(abs_file_path))
        config = open(file=abs_file_path)
        self.hint = ""

    def get_status(self):
        return {"hint": self.hint}

    def perform_instruction(self, action):
        instruction = action.get("instruction")
        if instruction == "hint":
            return False, action
        return True, None

    def test(self):
        self.hint = "test"

    def show_hint(self, data):
        self.hint = data.get("value")

    def reset(self):
        self.hint = ""

    def main(self):

if __name__ == "__main__":
    device = Display()

where display_config.json is

  "id": "display",
  "description": "Display can print hints",
  "host": "",
  "labels": ["hint"],
  "port": 1883

example of main() with loop and stop:

    def loop(self):
        previous = self.get_sliders_analog_reading()
        while True:
            positions = self.get_sliders_analog_reading()
            if previous != positions:
                previous = positions

    def main(self):
        self.start(loop=self.loop, stop=GPIO.cleanup)


This library is licensed with GNU GPL v3, see

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scclib-0.1.3.tar.gz (7.9 kB view hashes)

Uploaded Source

Built Distribution

scclib-0.1.3-py3-none-any.whl (20.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page