Add missing example files

example/base.py

@@ -0,0 +1,33 @@
+import decman
+from decman.plugins import aur, pacman
+
+
+class BaseModule(decman.Module):
+    def __init__(self):
+        # I'll intend this module to be a singleton (only one instance ever),
+        # so I'll inline the module name
+        super().__init__("base")
+
+    @pacman.packages
+    def pkgs(self) -> set[str]:
+        return {
+            "base",
+            "btrfs-progs",
+            "dosfstools",
+            "efibootmgr",
+            "grub",
+            "linux",
+            # I'll also include git and base-devel here, they are essential to this system
+            "git",
+            "base-devel",
+        }
+
+    @aur.packages
+    def aurpkgs(self) -> set[str]:
+        return {"decman"}
+
+    def files(self) -> dict[str, decman.File]:
+        return {"/etc/mkinitcpio.conf": decman.File(source_file="./files/mkinitcpio.conf")}
+
+    def on_change(self, store):
+        decman.prg(["mkinitcpio", "-P"])

example/kde.py

@@ -0,0 +1,19 @@
+import decman
+from decman.plugins import pacman, systemd
+
+
+class KDE(decman.Module):
+    def __init__(self):
+        super().__init__("kde")
+
+    @pacman.packages
+    def pkgs(self) -> set[str]:
+        return {
+            "plasma-desktop",
+            "konsole",
+            "sddm",
+        }
+
+    @systemd.units
+    def units(self) -> set[str]:
+        return {"sddm.service"}

example/source.py

@@ -0,0 +1,23 @@
+from base import BaseModule
+from kde import KDE
+
+import decman
+
+decman.pacman.packages |= {"openssh", "qemu-guest-agent", "sudo", "vim"}
+
+decman.modules |= {BaseModule(), KDE()}
+
+decman.files["/home/arch/.vimrc"] = decman.File(
+    source_file="./files/vimrc", owner="arch", permissions=0o600
+)
+
+decman.execution_order = [
+    "files",
+    "pacman",
+    "aur",
+    "flatpak",
+    "systemd",
+]
+
+decman.pacman.packages.add("flatpak")
+decman.flatpak.packages |= {"org.mozilla.firefox", "org.signal.Signal"}