ThrottledDevice: speed up quick reactivation

When a deactivation is delayed by offdelay and reactivated before the
timer expires, the device is not powered down at all in between. So we
should not incur the ondelay, but immediately transition to ST_ACTIVE
after cancelling the pending deactivation.

fix markdown syntax

README.md: document dependencies

move dbus introspection to dbusutils.list_objects

sispmctl_device: permit selecting a device

README.md: put the implementations in an itemize

Suggested by Joachim Breitner.

rewrite README.md

Thanks to Joachim Breitner for asking good questions. Most of his
questions are answered by this revised version.

fix epydoc markup

add a sispmctl_device

dbus_client: handle multiple transition signals

There bay be multiple changestate signals with ST_ACTIVE|ST_TRANSITION
before a signal for ST_ACTIVE.

must not pass float to GObject.timeout_add

ThrottledDevice: missing state notifiation

When a throttled device is transitioning to off and we activate it,
activation may be a noop on the actual device thus not emitting any
state change. From a users point of view we are transitioning to on now,
so the state has changed.

generalize ThrottledDevice

It gained the capability to delay the activation signal by a specified
amount of time. This should be useful when using it with sispmctl,
because hardware usually takes significant time to power on.

add an example dbus_policy.conf

This can be used when running onoff on the system bus. It should be
placed as /etc/dbus-1/system.d/onoff.conf then.

dbus_client: add --list to list devices

provide a default for --busname

move OnoffControl to onoff.dbusutils

What's left in dbus_service.py now is mainly the configuration part.
Maybe configuring onoff should happen by writing a python script for
now?

document device configuration

change activatefd method and add ThrottledDevice

When activating via activatefd, there is no reason to add an additional
delay. Simply close the socket later. If a device should delay
deactivation, this is a policy decision, that should be made by the
service. This policy decision can be done using the new ThrottledDevice.

move the socketpair utility to dbusutils

add a README

Outline what onoff is about and what problem it aims to solve.

write down some ideas

license the code as BSD-3

add minimal setup.py

dbus_client: improve documentation

dbus_client: make duration configurable

make clients configurable via argparse

ship some documentation

add mpd_watcher

It activates a device when mpd plays music.

change activatefd signature

The method no longer takes a UnixFd, but returns one. This is copied
from the systemd inhibitor interface. Advantages:

 * Not having fds to arbitrary things in the service is probably a good
   thing.
 * Maybe the interfaces can converge?

version dbus interface

The interface is still subject to change. Choosing version 0 as an
unstable version now. Change to 1 on initial release.

deduplicate spawn_async invocations

add an OnoffCommand device

OnoffProcess: don't fail inopportune transitions

Previously a call to activate while transitioning to ST_INACTIVE would
be ignored.

attempt to fix for python3

 * Wrong way to invoke logging.
 * spawn_async returns pid as 0. Bug in library?

implement a redshift device

draft device api

dbus_service: swap print for logging

service: more generic activation

improve dbus api

 * rename state signal to changestate
 * provide a state method returning the current state

change state meanings

The ST_ACTIVE bit is now to define the desired state. The previous
definition of using the state we are coming from does not make much
sense. Consider the case when being deactivated while transitioning to
active. Then we are coming from inactive and transitioning to inactive.

port to python3

initial commit

Proof-of-concept for the dbus interaction of the onoff service.