add examples to docs site

docs/content/examples/testing/_index.md

@@ -0,0 +1,13 @@
+Testing is still very much in flux but here's a rough example.
+
+{{< source "default.nix" >}}
+
+Where we've defined a might look like:
+
+{{< source "test.nix" >}}
+
+Execute with
+
+```sh
+nix eval -f . config.testing.success
+```

docs/content/examples/testing/default.nix

@@ -0,0 +1,17 @@
+{kubenix ? import ../../../..}:
+kubenix.evalModules.x86_64-linux {
+  module = {kubenix, ...}: {
+    imports = with kubenix.modules; [testing];
+    testing = {
+      tests = [./test.nix];
+      common = [
+        {
+          features = ["k8s"];
+          options = {
+            kubernetes.version = "1.24";
+          };
+        }
+      ];
+    };
+  };
+}

docs/content/examples/testing/test.nix

@@ -0,0 +1,25 @@
+{
+  lib,
+  pkgs,
+  kubenix,
+  test,
+  ...
+}: {
+  imports = [kubenix.modules.test];
+
+  test = {
+    name = "example";
+    description = "can reach deployment";
+    script = ''
+      @pytest.mark.applymanifest('${test.kubernetes.resultYAML}')
+      def test_nginx_deployment(kube):
+          """Tests whether nginx deployment gets successfully created"""
+          kube.wait_for_registered(timeout=30)
+          deployments = kube.get_deployments()
+          nginx_deploy = deployments.get('nginx')
+          assert nginx_deploy is not None
+          status = nginx_deploy.status()
+          assert status.readyReplicas == 10
+    '';
+  };
+}