From 9b11b6434948c0ca1647a817c7bb65de16ab639f Mon Sep 17 00:00:00 2001
From: Colin <colin@uninsane.org>
Date: Thu, 22 Aug 2024 09:00:14 +0000
Subject: [PATCH] haredoc: ship

---
 hosts/common/programs/assorted.nix | 1 +
 hosts/common/programs/default.nix  | 1 +
 hosts/common/programs/haredoc.nix  | 9 +++++++++
 3 files changed, 11 insertions(+)
 create mode 100644 hosts/common/programs/haredoc.nix

diff --git a/hosts/common/programs/assorted.nix b/hosts/common/programs/assorted.nix
index fc935a5de..012e5bb66 100644
--- a/hosts/common/programs/assorted.nix
+++ b/hosts/common/programs/assorted.nix
@@ -181,6 +181,7 @@ in
 
     pcConsoleUtils = declPackageSet [
       # "gh"  # MS GitHub cli
+      "haredoc"
       "nix-index"
       "nixpkgs-review"
       "qmk-udev-rules"
diff --git a/hosts/common/programs/default.nix b/hosts/common/programs/default.nix
index 0b0f8fc38..64d5461b2 100644
--- a/hosts/common/programs/default.nix
+++ b/hosts/common/programs/default.nix
@@ -79,6 +79,7 @@
     ./gthumb.nix
     ./gvfs.nix
     ./handbrake.nix
+    ./haredoc.nix
     ./helix.nix
     ./htop
     ./iio-sensor-proxy.nix
diff --git a/hosts/common/programs/haredoc.nix b/hosts/common/programs/haredoc.nix
new file mode 100644
index 000000000..8481a2241
--- /dev/null
+++ b/hosts/common/programs/haredoc.nix
@@ -0,0 +1,9 @@
+# use like `haredoc bufio::read_line`
+{ pkgs, ... }:
+{
+  sane.programs.haredoc = {
+    sandbox.method = "bwrap";
+    sandbox.whitelistPwd = true;  #< search for function documentation below the current directory
+    env.HAREPATH = "${pkgs.hare}/src/hare/stdlib";
+  };
+}