Skip to content

service

Service Builder 🏗️

Builder for the service section of a systemd service file.

ServiceBuilder

Bases: _Builder

Builder for the service section of a systemd service file.

Source code in systemd_py/builders/service.py 
 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
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
class ServiceBuilder(_Builder):
    """
    Builder for the `service` section of a systemd service file.
    """

    __slots__ = (
        '_type',
        '_remain_after_exit',
        '_pid_file',
        '_bus_name',
        '_notify_access',
        '_exec_start',
        '_exec_start_pre',
        '_exec_start_post',
        '_exec_reload',
        '_exec_stop',
        '_exec_stop_post',
        '_restart_sec',
        '_restart',
        '_timeout_sec',
        '_user',
        '_group',
        '_nice'
    )

    @property
    def allowed_none_fields(self) -> List[str]:
        """
        Returns a list of fields that are allowed to be None


        :return: List of fields that are allowed to be None
        :rtype: List[str]
        """

        return [
            "_type", "_remain_after_exit", "_pid_file", "_bus_name", "_notify_access",
            "_exec_start", "_exec_start_pre", "_exec_start_post", "_exec_reload", "_exec_stop",
            "_exec_stop_post", "_restart_sec", "_restart", "_timeout_sec", "_user", "_group",
            "_nice"
        ]

    def __init__(self):
        self._type: Optional[TypeType] = None
        self._remain_after_exit: Optional[bool] = None
        self._pid_file: Optional[str] = None
        self._bus_name: Optional[str] = None
        self._notify_access: Optional[str] = None
        self._exec_start: Optional[List[str]] = None
        self._exec_start_pre: Optional[List[str]] = None
        self._exec_start_post: Optional[List[str]] = None
        self._exec_reload: Optional[List[str]] = None
        self._exec_stop: Optional[List[str]] = None
        self._exec_stop_post: Optional[List[str]] = None
        self._restart_sec: Optional[int] = None
        self._restart: Optional[RestartType] = None
        self._timeout_sec: Optional[int] = None
        self._user: Optional[str] = None
        self._group: Optional[str] = None
        self._nice: Optional[int] = None

    def build(self) -> Service:
        """
        Builds the `service` section of a systemd service file.

        :return: The `service` section of a systemd service file
        :rtype: Service
        """

        self._check()
        return Service(
            type=self._type,
            remain_after_exit=self._remain_after_exit,
            pid_file=self._pid_file,
            bus_name=self._bus_name,
            notify_access=self._notify_access,
            exec_start=self._exec_start,
            exec_start_pre=self._exec_start_pre,
            exec_start_post=self._exec_start_post,
            exec_reload=self._exec_reload,
            exec_stop=self._exec_stop,
            exec_stop_post=self._exec_stop_post,
            restart_sec=self._restart_sec,
            restart=self._restart,
            timeout_sec=self._timeout_sec,
            user=self._user,
            group=self._group,
            nice=self._nice
        )

    def with_type(self, type: TypeType) -> 'ServiceBuilder':
        """
        Sets the `type` field of the `service` section of a systemd service file.

        :param type: The `type` field of the `service` section of a systemd service file
        :type type: TypeType

        :return: The `ServiceBuilder` object
        :rtype: ServiceBuilder
        """

        self._type = type
        return self

    def with_remain_after_exit(self, remain_after_exit: bool) -> 'ServiceBuilder':
        """
        Sets the `remain_after_exit` field of the `service` section of a systemd service file.

        :param remain_after_exit: The `remain_after_exit` field of the `service` section of a systemd service file
        :type remain_after_exit: bool

        :return: The `ServiceBuilder` object
        :rtype: ServiceBuilder
        """

        self._remain_after_exit = remain_after_exit
        return self

    def with_pid_file(self, pid_file: str) -> 'ServiceBuilder':
        """
        Sets the `pid_file` field of the `service` section of a systemd service file.

        :param pid_file: The `pid_file` field of the `service` section of a systemd service file
        :type pid_file: str

        :return: The `ServiceBuilder` object
        :rtype: ServiceBuilder
        """

        self._pid_file = pid_file
        return self

    def with_bus_name(self, bus_name: str) -> 'ServiceBuilder':
        """
        Sets the `bus_name` field of the `service` section of a systemd service file.

        :param bus_name: The `bus_name` field of the `service` section of a systemd service file
        :type bus_name: str

        :return: The `ServiceBuilder` object
        :rtype: ServiceBuilder
        """

        self._bus_name = bus_name
        return self

    def with_notify_access(self, notify_access: str) -> 'ServiceBuilder':
        """
        Sets the `notify_access` field of the `service` section of a systemd service file.

        :param notify_access: The `notify_access` field of the `service` section of a systemd service file
        :type notify_access: str

        :return: The `ServiceBuilder` object
        :rtype: ServiceBuilder
        """

        self._notify_access = notify_access
        return self

    def with_exec_start(self, exec_start: List[str]) -> 'ServiceBuilder':
        """
        Sets the `exec_start` field of the `service` section of a systemd service file.

        :param exec_start: The `exec_start` field of the `service` section of a systemd service file
        :type exec_start: List[str]

        :return: The `ServiceBuilder` object
        :rtype: ServiceBuilder
        """

        self._exec_start = exec_start
        return self

    def with_exec_start_pre(self, exec_start_pre: List[str]) -> 'ServiceBuilder':
        """
        Sets the `exec_start_pre` field of the `service` section of a systemd service file.

        :param exec_start_pre: The `exec_start_pre` field of the `service` section of a systemd service file
        :type exec_start_pre: List[str]

        :return: The `ServiceBuilder` object
        :rtype: ServiceBuilder
        """

        self._exec_start_pre = exec_start_pre
        return self

    def with_exec_start_post(self, exec_start_post: List[str]) -> 'ServiceBuilder':
        """
        Sets the `exec_start_post` field of the `service` section of a systemd service file.

        :param exec_start_post: The `exec_start_post` field of the `service` section of a systemd service file
        :type exec_start_post: List[str]

        :return: The `ServiceBuilder` object
        :rtype: ServiceBuilder
        """

        self._exec_start_post = exec_start_post
        return self

    def with_exec_reload(self, exec_reload: List[str]) -> 'ServiceBuilder':
        """
        Sets the `exec_reload` field of the `service` section of a systemd service file.

        :param exec_reload: The `exec_reload` field of the `service` section of a systemd service file
        :type exec_reload: List[str]

        :return: The `ServiceBuilder` object
        :rtype: ServiceBuilder
        """

        self._exec_reload = exec_reload
        return self

    def with_exec_stop(self, exec_stop: List[str]) -> 'ServiceBuilder':
        """
        Sets the `exec_stop` field of the `service` section of a systemd service file.

        :param exec_stop: The `exec_stop` field of the `service` section of a systemd service file
        :type exec_stop: List[str]

        :return: The `ServiceBuilder` object
        :rtype: ServiceBuilder
        """

        self._exec_stop = exec_stop
        return self

    def with_exec_stop_post(self, exec_stop_post: List[str]) -> 'ServiceBuilder':
        """
        Sets the `exec_stop_post` field of the `service` section of a systemd service file.

        :param exec_stop_post: The `exec_stop_post` field of the `service` section of a systemd service file
        :type exec_stop_post: List[str]

        :return: The `ServiceBuilder` object
        :rtype: ServiceBuilder
        """

        self._exec_stop_post = exec_stop_post
        return self

    def with_restart_sec(self, restart_sec: int) -> 'ServiceBuilder':
        """
        Sets the `restart_sec` field of the `service` section of a systemd service file.

        :param restart_sec: The `restart_sec` field of the `service` section of a systemd service file
        :type restart_sec: int

        :return: The `ServiceBuilder` object
        :rtype: ServiceBuilder
        """

        self._restart_sec = restart_sec
        return self

    def with_restart(self, restart: RestartType) -> 'ServiceBuilder':
        """
        Sets the `restart` field of the `service` section of a systemd service file.

        :param restart: The `restart` field of the `service` section of a systemd service file
        :type restart: RestartType

        :return: The `ServiceBuilder` object
        :rtype: ServiceBuilder
        """

        self._restart = restart
        return self

    def with_timeout_sec(self, timeout_sec: int) -> 'ServiceBuilder':
        """
        Sets the `timeout_sec` field of the `service` section of a systemd service file.

        :param timeout_sec: The `timeout_sec` field of the `service` section of a systemd service file
        :type timeout_sec: int

        :return: The `ServiceBuilder` object
        :rtype: ServiceBuilder
        """

        self._timeout_sec = timeout_sec
        return self

    def with_user(self, user: str) -> 'ServiceBuilder':
        """
        Sets the `user` field of the `service` section of a systemd service file.

        :param user: The `user` field of the `service` section of a systemd service file
        :type user: str

        :return: The `ServiceBuilder` object
        :rtype: ServiceBuilder
        """

        self._user = user
        return self

    def with_group(self, group: str) -> 'ServiceBuilder':
        """
        Sets the `group` field of the `service` section of a systemd service file.

        :param group: The `group` field of the `service` section of a systemd service file
        :type group: str

        :return: The `ServiceBuilder` object
        :rtype: ServiceBuilder
        """

        self._group = group
        return self

    def with_nice(self, nice: int) -> 'ServiceBuilder':
        """
        Sets the `nice` field of the `service` section of a systemd service file.

        :param nice: The `nice` field of the `service` section of a systemd service file
        :type nice: int

        :return: The `ServiceBuilder` object
        :rtype: ServiceBuilder
        """

        self._nice = nice
        return self

allowed_none_fields: List[str] property

Returns a list of fields that are allowed to be None

Returns:

Type Description
List[str]

List of fields that are allowed to be None

build()

Builds the service section of a systemd service file.

Returns:

Type Description
Service

The service section of a systemd service file
Source code in systemd_py/builders/service.py 
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
def build(self) -> Service:
    """
    Builds the `service` section of a systemd service file.

    :return: The `service` section of a systemd service file
    :rtype: Service
    """

    self._check()
    return Service(
        type=self._type,
        remain_after_exit=self._remain_after_exit,
        pid_file=self._pid_file,
        bus_name=self._bus_name,
        notify_access=self._notify_access,
        exec_start=self._exec_start,
        exec_start_pre=self._exec_start_pre,
        exec_start_post=self._exec_start_post,
        exec_reload=self._exec_reload,
        exec_stop=self._exec_stop,
        exec_stop_post=self._exec_stop_post,
        restart_sec=self._restart_sec,
        restart=self._restart,
        timeout_sec=self._timeout_sec,
        user=self._user,
        group=self._group,
        nice=self._nice
    )

with_bus_name(bus_name)

Sets the bus_name field of the service section of a systemd service file.

Parameters:

Name Type Description Default
bus_name str

The bus_name field of the service section of a systemd service file

 required

Returns:

Type Description
ServiceBuilder

The ServiceBuilder object
Source code in systemd_py/builders/service.py 
147
148
149
150
151
152
153
154
155
156
157
158
159
def with_bus_name(self, bus_name: str) -> 'ServiceBuilder':
    """
    Sets the `bus_name` field of the `service` section of a systemd service file.

    :param bus_name: The `bus_name` field of the `service` section of a systemd service file
    :type bus_name: str

    :return: The `ServiceBuilder` object
    :rtype: ServiceBuilder
    """

    self._bus_name = bus_name
    return self

with_exec_reload(exec_reload)

Sets the exec_reload field of the service section of a systemd service file.

Parameters:

Name Type Description Default
exec_reload List[str]

The exec_reload field of the service section of a systemd service file

 required

Returns:

Type Description
ServiceBuilder

The ServiceBuilder object
Source code in systemd_py/builders/service.py 
217
218
219
220
221
222
223
224
225
226
227
228
229
def with_exec_reload(self, exec_reload: List[str]) -> 'ServiceBuilder':
    """
    Sets the `exec_reload` field of the `service` section of a systemd service file.

    :param exec_reload: The `exec_reload` field of the `service` section of a systemd service file
    :type exec_reload: List[str]

    :return: The `ServiceBuilder` object
    :rtype: ServiceBuilder
    """

    self._exec_reload = exec_reload
    return self

with_exec_start(exec_start)

Sets the exec_start field of the service section of a systemd service file.

Parameters:

Name Type Description Default
exec_start List[str]

The exec_start field of the service section of a systemd service file

 required

Returns:

Type Description
ServiceBuilder

The ServiceBuilder object
Source code in systemd_py/builders/service.py 
175
176
177
178
179
180
181
182
183
184
185
186
187
def with_exec_start(self, exec_start: List[str]) -> 'ServiceBuilder':
    """
    Sets the `exec_start` field of the `service` section of a systemd service file.

    :param exec_start: The `exec_start` field of the `service` section of a systemd service file
    :type exec_start: List[str]

    :return: The `ServiceBuilder` object
    :rtype: ServiceBuilder
    """

    self._exec_start = exec_start
    return self

with_exec_start_post(exec_start_post)

Sets the exec_start_post field of the service section of a systemd service file.

Parameters:

Name Type Description Default
exec_start_post List[str]

The exec_start_post field of the service section of a systemd service file

 required

Returns:

Type Description
ServiceBuilder

The ServiceBuilder object
Source code in systemd_py/builders/service.py 
203
204
205
206
207
208
209
210
211
212
213
214
215
def with_exec_start_post(self, exec_start_post: List[str]) -> 'ServiceBuilder':
    """
    Sets the `exec_start_post` field of the `service` section of a systemd service file.

    :param exec_start_post: The `exec_start_post` field of the `service` section of a systemd service file
    :type exec_start_post: List[str]

    :return: The `ServiceBuilder` object
    :rtype: ServiceBuilder
    """

    self._exec_start_post = exec_start_post
    return self

with_exec_start_pre(exec_start_pre)

Sets the exec_start_pre field of the service section of a systemd service file.

Parameters:

Name Type Description Default
exec_start_pre List[str]

The exec_start_pre field of the service section of a systemd service file

 required

Returns:

Type Description
ServiceBuilder

The ServiceBuilder object
Source code in systemd_py/builders/service.py 
189
190
191
192
193
194
195
196
197
198
199
200
201
def with_exec_start_pre(self, exec_start_pre: List[str]) -> 'ServiceBuilder':
    """
    Sets the `exec_start_pre` field of the `service` section of a systemd service file.

    :param exec_start_pre: The `exec_start_pre` field of the `service` section of a systemd service file
    :type exec_start_pre: List[str]

    :return: The `ServiceBuilder` object
    :rtype: ServiceBuilder
    """

    self._exec_start_pre = exec_start_pre
    return self

with_exec_stop(exec_stop)

Sets the exec_stop field of the service section of a systemd service file.

Parameters:

Name Type Description Default
exec_stop List[str]

The exec_stop field of the service section of a systemd service file

 required

Returns:

Type Description
ServiceBuilder

The ServiceBuilder object
Source code in systemd_py/builders/service.py 
231
232
233
234
235
236
237
238
239
240
241
242
243
def with_exec_stop(self, exec_stop: List[str]) -> 'ServiceBuilder':
    """
    Sets the `exec_stop` field of the `service` section of a systemd service file.

    :param exec_stop: The `exec_stop` field of the `service` section of a systemd service file
    :type exec_stop: List[str]

    :return: The `ServiceBuilder` object
    :rtype: ServiceBuilder
    """

    self._exec_stop = exec_stop
    return self

with_exec_stop_post(exec_stop_post)

Sets the exec_stop_post field of the service section of a systemd service file.

Parameters:

Name Type Description Default
exec_stop_post List[str]

The exec_stop_post field of the service section of a systemd service file

 required

Returns:

Type Description
ServiceBuilder

The ServiceBuilder object
Source code in systemd_py/builders/service.py 
245
246
247
248
249
250
251
252
253
254
255
256
257
def with_exec_stop_post(self, exec_stop_post: List[str]) -> 'ServiceBuilder':
    """
    Sets the `exec_stop_post` field of the `service` section of a systemd service file.

    :param exec_stop_post: The `exec_stop_post` field of the `service` section of a systemd service file
    :type exec_stop_post: List[str]

    :return: The `ServiceBuilder` object
    :rtype: ServiceBuilder
    """

    self._exec_stop_post = exec_stop_post
    return self

with_group(group)

Sets the group field of the service section of a systemd service file.

Parameters:

Name Type Description Default
group str

The group field of the service section of a systemd service file

 required

Returns:

Type Description
ServiceBuilder

The ServiceBuilder object
Source code in systemd_py/builders/service.py 
315
316
317
318
319
320
321
322
323
324
325
326
327
def with_group(self, group: str) -> 'ServiceBuilder':
    """
    Sets the `group` field of the `service` section of a systemd service file.

    :param group: The `group` field of the `service` section of a systemd service file
    :type group: str

    :return: The `ServiceBuilder` object
    :rtype: ServiceBuilder
    """

    self._group = group
    return self

with_nice(nice)

Sets the nice field of the service section of a systemd service file.

Parameters:

Name Type Description Default
nice int

The nice field of the service section of a systemd service file

 required

Returns:

Type Description
ServiceBuilder

The ServiceBuilder object
Source code in systemd_py/builders/service.py 
329
330
331
332
333
334
335
336
337
338
339
340
341
def with_nice(self, nice: int) -> 'ServiceBuilder':
    """
    Sets the `nice` field of the `service` section of a systemd service file.

    :param nice: The `nice` field of the `service` section of a systemd service file
    :type nice: int

    :return: The `ServiceBuilder` object
    :rtype: ServiceBuilder
    """

    self._nice = nice
    return self

with_notify_access(notify_access)

Sets the notify_access field of the service section of a systemd service file.

Parameters:

Name Type Description Default
notify_access str

The notify_access field of the service section of a systemd service file

 required

Returns:

Type Description
ServiceBuilder

The ServiceBuilder object
Source code in systemd_py/builders/service.py 
161
162
163
164
165
166
167
168
169
170
171
172
173
def with_notify_access(self, notify_access: str) -> 'ServiceBuilder':
    """
    Sets the `notify_access` field of the `service` section of a systemd service file.

    :param notify_access: The `notify_access` field of the `service` section of a systemd service file
    :type notify_access: str

    :return: The `ServiceBuilder` object
    :rtype: ServiceBuilder
    """

    self._notify_access = notify_access
    return self

with_pid_file(pid_file)

Sets the pid_file field of the service section of a systemd service file.

Parameters:

Name Type Description Default
pid_file str

The pid_file field of the service section of a systemd service file

 required

Returns:

Type Description
ServiceBuilder

The ServiceBuilder object
Source code in systemd_py/builders/service.py 
133
134
135
136
137
138
139
140
141
142
143
144
145
def with_pid_file(self, pid_file: str) -> 'ServiceBuilder':
    """
    Sets the `pid_file` field of the `service` section of a systemd service file.

    :param pid_file: The `pid_file` field of the `service` section of a systemd service file
    :type pid_file: str

    :return: The `ServiceBuilder` object
    :rtype: ServiceBuilder
    """

    self._pid_file = pid_file
    return self

with_remain_after_exit(remain_after_exit)

Sets the remain_after_exit field of the service section of a systemd service file.

Parameters:

Name Type Description Default
remain_after_exit bool

The remain_after_exit field of the service section of a systemd service file

 required

Returns:

Type Description
ServiceBuilder

The ServiceBuilder object
Source code in systemd_py/builders/service.py 
119
120
121
122
123
124
125
126
127
128
129
130
131
def with_remain_after_exit(self, remain_after_exit: bool) -> 'ServiceBuilder':
    """
    Sets the `remain_after_exit` field of the `service` section of a systemd service file.

    :param remain_after_exit: The `remain_after_exit` field of the `service` section of a systemd service file
    :type remain_after_exit: bool

    :return: The `ServiceBuilder` object
    :rtype: ServiceBuilder
    """

    self._remain_after_exit = remain_after_exit
    return self

with_restart(restart)

Sets the restart field of the service section of a systemd service file.

Parameters:

Name Type Description Default
restart RestartType

The restart field of the service section of a systemd service file

 required

Returns:

Type Description
ServiceBuilder

The ServiceBuilder object
Source code in systemd_py/builders/service.py 
273
274
275
276
277
278
279
280
281
282
283
284
285
def with_restart(self, restart: RestartType) -> 'ServiceBuilder':
    """
    Sets the `restart` field of the `service` section of a systemd service file.

    :param restart: The `restart` field of the `service` section of a systemd service file
    :type restart: RestartType

    :return: The `ServiceBuilder` object
    :rtype: ServiceBuilder
    """

    self._restart = restart
    return self

with_restart_sec(restart_sec)

Sets the restart_sec field of the service section of a systemd service file.

Parameters:

Name Type Description Default
restart_sec int

The restart_sec field of the service section of a systemd service file

 required

Returns:

Type Description
ServiceBuilder

The ServiceBuilder object
Source code in systemd_py/builders/service.py 
259
260
261
262
263
264
265
266
267
268
269
270
271
def with_restart_sec(self, restart_sec: int) -> 'ServiceBuilder':
    """
    Sets the `restart_sec` field of the `service` section of a systemd service file.

    :param restart_sec: The `restart_sec` field of the `service` section of a systemd service file
    :type restart_sec: int

    :return: The `ServiceBuilder` object
    :rtype: ServiceBuilder
    """

    self._restart_sec = restart_sec
    return self

with_timeout_sec(timeout_sec)

Sets the timeout_sec field of the service section of a systemd service file.

Parameters:

Name Type Description Default
timeout_sec int

The timeout_sec field of the service section of a systemd service file

 required

Returns:

Type Description
ServiceBuilder

The ServiceBuilder object
Source code in systemd_py/builders/service.py 
287
288
289
290
291
292
293
294
295
296
297
298
299
def with_timeout_sec(self, timeout_sec: int) -> 'ServiceBuilder':
    """
    Sets the `timeout_sec` field of the `service` section of a systemd service file.

    :param timeout_sec: The `timeout_sec` field of the `service` section of a systemd service file
    :type timeout_sec: int

    :return: The `ServiceBuilder` object
    :rtype: ServiceBuilder
    """

    self._timeout_sec = timeout_sec
    return self

with_type(type)

Sets the type field of the service section of a systemd service file.

Parameters:

Name Type Description Default
type TypeType

The type field of the service section of a systemd service file

 required

Returns:

Type Description
ServiceBuilder

The ServiceBuilder object
Source code in systemd_py/builders/service.py 
105
106
107
108
109
110
111
112
113
114
115
116
117
def with_type(self, type: TypeType) -> 'ServiceBuilder':
    """
    Sets the `type` field of the `service` section of a systemd service file.

    :param type: The `type` field of the `service` section of a systemd service file
    :type type: TypeType

    :return: The `ServiceBuilder` object
    :rtype: ServiceBuilder
    """

    self._type = type
    return self

with_user(user)

Sets the user field of the service section of a systemd service file.

Parameters:

Name Type Description Default
user str

The user field of the service section of a systemd service file

 required

Returns:

Type Description
ServiceBuilder

The ServiceBuilder object
Source code in systemd_py/builders/service.py 
301
302
303
304
305
306
307
308
309
310
311
312
313
def with_user(self, user: str) -> 'ServiceBuilder':
    """
    Sets the `user` field of the `service` section of a systemd service file.

    :param user: The `user` field of the `service` section of a systemd service file
    :type user: str

    :return: The `ServiceBuilder` object
    :rtype: ServiceBuilder
    """

    self._user = user
    return self