summaryrefslogtreecommitdiff
path: root/subplot/vendored/daemon.md
diff options
context:
space:
mode:
authorLars Wirzenius <liw@liw.fi>2020-12-31 11:02:32 +0200
committerLars Wirzenius <liw@liw.fi>2020-12-31 11:02:32 +0200
commit8c4729010511d7bd491675522378507c2af0b583 (patch)
tree2cbff9a84d0c401828ebd7c9129068600b3cb9ea /subplot/vendored/daemon.md
parent89c2c522682ea0490f3512e43bf855b254cd924f (diff)
downloadobnam2-8c4729010511d7bd491675522378507c2af0b583.tar.gz
chore: update vendored subplot librarires: runcmd, daemon
Diffstat (limited to 'subplot/vendored/daemon.md')
-rw-r--r--subplot/vendored/daemon.md38
1 files changed, 38 insertions, 0 deletions
diff --git a/subplot/vendored/daemon.md b/subplot/vendored/daemon.md
new file mode 100644
index 0000000..131dcb1
--- /dev/null
+++ b/subplot/vendored/daemon.md
@@ -0,0 +1,38 @@
+# Introduction
+
+The [Subplot][] library `daemon` for Python provides scenario steps
+and their implementations for running a background process and
+terminating at the end of the scenario.
+
+[Subplot]: https://subplot.liw.fi/
+
+This document explains the acceptance criteria for the library and how
+they're verified. It uses the steps and functions from the
+`lib/daemon` library. The scenarios all have the same structure: run a
+command, then examine the exit code, verify the process is running.
+
+# Daemon is started and terminated
+
+This scenario starts a background process, verifies it's started, and
+verifies it's terminated after the scenario ends.
+
+~~~scenario
+given there is no "/bin/sleep 12765" process
+when I start "/bin/sleep 12765" as a background process as sleepyhead
+then a process "/bin/sleep 12765" is running
+when I stop background process sleepyhead
+then there is no "/bin/sleep 12765" process
+~~~
+
+
+
+---
+title: Acceptance criteria for the lib/daemon Subplot library
+author: The Subplot project
+bindings:
+- daemon.yaml
+template: python
+functions:
+- daemon.py
+- runcmd.py
+...