Skip to content

Systemd Generator Example

This example shows how to use the systemd_py.Systemd to create unit file.

install_builder.py
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
from systemd_py import Systemd
from systemd_py import InstallBuilder, ServiceBuilder, SocketBuilder, UnitBuilder
from systemd_py import Install, Service, Socket, Unit


def build_install() -> Install:
    builder = InstallBuilder()
    builder.with_wanted_by(["multi-user.target"])
    builder.with_required_by(["graphical.target"])
    builder.with_alias(["my-alias.service"])

    section = builder.build()

    return section


def build_service() -> Service:
    builder = ServiceBuilder()
    builder.with_type("simple")
    builder.with_exec_start(["/usr/bin/python3", "-m", "http.server", "8000"])
    builder.with_exec_stop(["/usr/bin/kill", "$MAINPID"])
    builder.with_restart("on-failure")

    section = builder.build()

    return section


def build_socket() -> Socket:
    builder = SocketBuilder()
    builder.with_listen_stream(["8000"])
    builder.with_accept(True)

    section = builder.build()

    return section


def build_unit() -> Unit:
    builder = UnitBuilder()
    builder.with_description("Example service")
    builder.with_after(["network.target"])
    builder.with_wants(["network.target"])
    builder.with_requires(["network.target"])

    section = builder.build()

    return section


def main():
    install = build_install()
    service = build_service()
    socket = build_socket()
    unit = build_unit()

    systemd = Systemd("my-service", [install, service, socket, unit])
    my_service = systemd.create()

    print(my_service)


if __name__ == "__main__":
    main()
output
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# my-service.service

[Install]
WantedBy='multi-user.target'
RequiredBy='graphical.target'
Alias='my-alias.service'

[Service]
Type='simple'
ExecStart='/usr/bin/python3 -m http.server 8000'
ExecStop='/usr/bin/kill $MAINPID'
Restart='on-failure'

[Socket]
ListenStream='8000'
Accept='true'

[Unit]
Description='Example service'
Requires='network.target'
Wants='network.target'
After='network.target'

# Via systemd_py