tobi-wan-kenobi bd7ff3c8f1 [core] Allow modules to specify default update interval

Expanding on the implementation in d582016, add a decorator
`core.module.every()` that allows a module to specify how often to
update the module's state.

This can still be overridden using the CLI parameter `interval`.

2020-03-29 14:32:47 +02:00

1.2 KiB

Raw Blame History

Writing a bumblebee-status module

Introduction

Adding a new module to bumblebee-status is straight-forward:

Add a new Python module in modules/contrib/. The name of the module will be the name that the user needs to specify when invoking bumblebee-status (i.e. a module called modules/contrib/test.py will be loaded using bumblebee-status -m test)
See below for how to actually write the module
Test (run bumblebee-status in the CLI)
Make sure your changes don't break anything: ./coverage.sh

Pull requests

The project gladly accepts PRs for bugfixes, new functionality, new modules, etc. When you feel comfortable with what you've developed, please just open a PR, somebody will look at it eventually :) Thanks!

Hello world

This example will show "hello world" in the status bar:

"""Short description"""

import core.module
import core.widget

class Module(core.module.Module):
    def __init__(self, config):
        super().__init__(config, core.widget.Widget(self.full_text))

    def full_text(self, widgets):
        return "hello world"

# vim: tabstop=8 expandtab shiftwidth=4 softtabstop=4

`update` vs. `full_text`

TODO

TODOs

default update interval
scrolling

1.2 KiB Raw Blame History