trick17 0.0.3

Systemd utility functions in pure python

trick17

trick17 is a pure python, lightweight package that interfaces with various systemd components.

---

Table of Contents

• Installation
• Modules
• License

Installation

pip install trick17

Modules

trick17.daemon

• daemon.booted() returns True if system was booted by systemd.
• daemon.notify(state) sends a notification to systemd.
• listen_fds() returns an iterator over (fd, name) tuples in case of socket activation, see systemd.socket

trick17.journal

The trick17.journal allows to use the systemd Native Journal Protocol via the Python Logging facility.

• JournalHandler is a logging.Handler subclass that speaks the systemd Native Journal Protocol
• Function stderr_is_journal() can be used to check if logging via sys.stderr should be upgraded to native logging, see Automatic Protocol Upgrading

import logging

from trick17 import journal

if journal.stderr_is_journal():
    handler = journal.JournalHandler()
else:
    handler = logging.StreamHandler()
root = logging.getLogger()
root.addHandler(handler)

logging.error('Something happened')

License

trick17 is distributed under the terms of the MIT license.