3 files changed, 28 insertions, 0 deletions

diff --git a/roles/unix_users/subplot.md b/roles/unix_users/subplot.md
new file mode 100644
index 0000000..049bfc2
--- /dev/null
+++ b/roles/unix_users/subplot.md
@@ -0,0 +1,19 @@
+# unix_users – manage Unix users
+
+This role creates or updates Unix users.
+
+## Create user with unix_users
+
+~~~scenario
+given a host running Debian
+when I use role unix_users
+and I use variables from foo.yml
+and I run the playbook
+then the host has user foo
+~~~
+
+~~~{#foo.yml .file .yaml}
+unix_users:
+- username: foo
+  comment: Foo Bar
+~~~
diff --git a/roles/unix_users/subplot.py b/roles/unix_users/subplot.py
new file mode 100644
index 0000000..118d007
--- /dev/null
+++ b/roles/unix_users/subplot.py
@@ -0,0 +1,7 @@
+def host_has_user(ctx, username=None):
+    assert_eq = globals()["assert_eq"]
+    qemu = ctx["qemu"]
+    output, exit = qemu.ssh(["getent", "passwd", username])
+    assert_eq(exit, 0)
+    output = output.decode("UTF8")
+    assert f"\n{username}:" in output
diff --git a/roles/unix_users/subplot.yaml b/roles/unix_users/subplot.yaml
new file mode 100644
index 0000000..9fcc961
--- /dev/null
+++ b/roles/unix_users/subplot.yaml
@@ -0,0 +1,2 @@
+- then: the host has user {username}
+  function: host_has_user