modules

modules/config.nix

@@ -0,0 +1,6 @@
+{ ... }:
+{
+  config = {
+    name = "Boaty McBoatface";
+  };
+}

modules/deep-dive/default.nix

@@ -0,0 +1,18 @@
+{ pkgs, lib, ... }: {
+
+  options = {
+    scripts.output = lib.mkOption {
+      type = lib.types.package;
+    };
+  };
+
+  config = {
+    scripts.output = pkgs.writeShellApplication {
+      name = "map";
+      runtimeInputs = with pkgs; [ curl feh ];
+      text = ''
+        ${./map.sh} size=640x640 scale=2 | feh -
+      '';
+    };
+  };
+}

modules/deep-dive/eval.nix

@@ -0,0 +1,10 @@
+let
+  nixpkgs = fetchTarball "https://github.com/NixOS/nixpkgs/tarball/nixos-25.11";
+  pkgs = import nixpkgs { config = {}; overlays = []; };
+in
+pkgs.lib.evalModules {
+  modules = [
+    ({ config, ... }: { config._module.args = { inherit pkgs; }; })
+    ./default.nix
+  ];
+}

modules/deep-dive/geocode.sh

@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+rational_regex='-?[[:digit:]]+(\.[[:digit:]]+)?'
+result_regex="$rational_regex,$rational_regex"
+
+keyFile=${XDG_DATA_HOME:-~/.local/share}/google-api/key
+
+if [[ ! -f "$keyFile" ]]; then
+    mkdir -p "$(basename "$keyFile")"
+    echo "No Google API key found in $keyFile" >&2
+    echo "For getting one, see https://developers.google.com/maps/documentation/geocoding/overview#before-you-begin" >&2
+    exit 1
+fi
+
+key=$(cat "$keyFile")
+
+tmp=$(mktemp -d)
+trap 'rm -rf "$tmp"' exit
+
+output=$tmp/output
+
+curlArgs=(
+    https://maps.googleapis.com/maps/api/geocode/json
+    --silent --show-error --get --output "$output" --write-out '%{http_code}'
+    --data-urlencode address="$1"
+)
+
+#echo curl ''${curlArgs[@]@Q} >&2
+
+curlArgs+=(--data-urlencode key="$key")
+
+if status=$(curl "${curlArgs[@]}"); then
+    if [[ "$status" == 200 ]]; then
+        result=$(jq -r '.results[0].geometry.location as $loc | "\($loc | .lat),\($loc | .lng)"' "$output")
+        if ! [[ $result =~ $result_regex ]]; then
+            echo "Got a bad result of: '$result'" >&2
+            exit 1
+        else
+            echo "$result"
+        fi
+    else
+        echo "API returned non-200 HTTP status code $status, output is" >&2
+        cat "$output" >&2
+        exit 1
+    fi
+else
+    echo "curl exited with code $?" >&2
+    exit 1
+fi

modules/deep-dive/map.sh

@@ -0,0 +1,47 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+keyFile=${XDG_DATA_HOME:-~/.local/share}/google-api/key
+
+if [[ ! -f "$keyFile" ]]; then
+    mkdir -p "$(basename "$keyFile")"
+    echo "No Google API key found in $keyFile" >&2
+    echo "For getting one, see https://developers.google.com/maps/documentation/maps-static/start#before-you-begin" >&2
+    exit 1
+fi
+
+key=$(cat "$keyFile")
+tmp=$(mktemp -d)
+trap 'rm -rf "$tmp"' exit
+
+output=$tmp/output
+
+curlArgs=(
+    https://maps.googleapis.com/maps/api/staticmap
+    --silent --show-error --get --output "$output" --write-out %{http_code}
+)
+
+for arg in "$@"; do
+    curlArgs+=(--data-urlencode "$arg")
+done
+
+echo curl ''${curlArgs[@]@Q} >&2
+
+curlArgs+=(--data-urlencode key="$key")
+
+if status=$(curl "${curlArgs[@]}"); then
+    if [[ "$status" != 200 ]]; then
+        echo "API returned non-200 HTTP status code $status, output is" >&2
+        cat "$output" >&2
+        exit 1
+    fi
+else
+    echo "curl exited with code $?" >&2
+    exit 1
+fi
+
+if [[ -t 1 ]]; then
+    echo "Successful, but won't output image to tty, pipe to a file or icat instead" >&2
+else
+    cat "$output"
+fi

modules/default.nix

@@ -0,0 +1,10 @@
+let 
+  pkgs = import <nixpkgs> { };
+  result = pkgs.lib.evalModules {
+    modules = [
+      ./options.nix
+      ./config.nix
+    ];
+  };
+in 
+result.config

modules/options.nix

@@ -0,0 +1,7 @@
+{ lib, ... }:
+
+{
+  options = {
+    name = lib.mkOption { type = lib.types.str; };
+  };
+}