The pursuit of ’app’yness

Author: mxcl

.github/workflows/ci.yml

@@ -5,7 +5,7 @@ on:
   pull_request:
 
 jobs:
-  test:
+  test-action:
     runs-on: ubuntu-latest
     strategy:
       matrix:
@@ -20,3 +20,14 @@ jobs:
       - run: echo $PATH
       - run: env
       - run: deno --version
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: denolib/setup-deno@v2
+        with:
+          deno-version: v2.x
+      - run: deno fmt --check .
+      - run: deno lint .
+      - run: deno check ./app.ts

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+  "deno.enable": true
+}

app.ts

@@ -0,0 +1,78 @@
+#!/usr/bin/env -S pkgx deno^2 run -A
+
+//TODO if you step into dev-dir/subdir does it work?
+//TODO `dev` and `dev off` shellcode
+//TODO dev off uses PWD which may not be correct if in
+
+import { Path, utils } from "libpkgx";
+import shellcode from "./src/shellcode().ts";
+import sniff from "./src/sniff.ts";
+import shell_escape from "./src/shell-escape.ts";
+
+switch (Deno.args[0]) {
+  case "--help":
+    console.log("https://github.com/pkgxdev/dev");
+    Deno.exit(0);
+    break; // deno lint insists
+  case "--shellcode":
+    console.log(shellcode());
+    Deno.exit(0);
+    break; // deno lint insists
+}
+
+const snuff = await sniff(Path.cwd());
+
+const pkgspecs = snuff.pkgs.map((pkg) => `+${utils.pkg.str(pkg)}`);
+
+const cmd = new Deno.Command("pkgx", {
+  args: [...pkgspecs],
+  stdout: "piped",
+  env: { CLICOLOR_FORCE: "1" }, // unfortunate
+}).spawn();
+
+await cmd.status;
+
+const stdout = (await cmd.output()).stdout;
+let env = new TextDecoder().decode(stdout).trim();
+
+// add any additional env that we sniffed
+for (const [key, value] of Object.entries(snuff.env)) {
+  env += `${key}=${shell_escape(value)}\n`;
+}
+
+//TODO moustaches aren’t being expanded
+
+let undo = "";
+for (const envln of env.split("\n")) {
+  const [key] = envln.split("=", 2);
+  const value = Deno.env.get(key);
+  if (value) {
+    undo += `    export ${key}=${shell_escape(value)}\n`;
+  } else {
+    undo += `    unset ${key}\n`;
+  }
+}
+
+const dir = Deno.cwd();
+
+const bye_bye_msg = pkgspecs.map((pkgspec) => `-${pkgspec.slice(1)}`).join(" ");
+
+console.log(`
+set -a
+${env}
+set +a
+
+_pkgx_dev_try_bye() {
+  suffix="\${PWD#"${dir}"}"
+  if test "$PWD" != "${dir}$suffix"; then
+    ${undo.trim()}
+    unset -f _pkgx_dev_try_bye
+    echo "\\033[31m${bye_bye_msg}\\033[0m" >&2
+    return 0
+  else
+    return 1
+  fi
+}
+`.trim());
+
+console.error("%c%s", "color: green", pkgspecs.join(" "));

deno.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "strict": true
+  },
+  "pkgx": "deno^2.1",
+  "lint": {
+    "include": ["src/", "./app.ts"],
+    "exclude": ["**/*.test.ts"]
+  },
+  "test": {
+    "include": ["src/"]
+  },
+  "imports": {
+    "libpkgx": "https://raw.githubusercontent.com/pkgxdev/libpkgx/refs/tags/v0.20.1/mod.ts",
+    "libpkgx/": "https://raw.githubusercontent.com/pkgxdev/libpkgx/refs/tags/v0.20.1/src/",
+    "is-what": "https://deno.land/x/is_what@v4.1.15/src/index.ts",
+    "outdent": "https://deno.land/x/outdent@v0.8.0/mod.ts"
+  }
+}

deno.lock

@@ -1,39 +1,43 @@
-const fs = require('fs');
-const readline = require('readline');
+const fs = require("fs");
+const readline = require("readline");
 
 const readInterface = readline.createInterface({
-    input: fs.createReadStream(process.argv[2]),
-    output: process.stdout,
-    terminal: false
+  input: fs.createReadStream(process.argv[2]),
+  output: process.stdout,
+  terminal: false,
 });
 
-const stripQuotes = (str) => str.startsWith('"') || str.startsWith("'") ? str.slice(1, -1) : str;
+const stripQuotes = (str) =>
+  str.startsWith('"') || str.startsWith("'") ? str.slice(1, -1) : str;
 
 const replaceEnvVars = (str) => {
-    const value = str
-      .replaceAll(/\$\{([a-zA-Z0-9_]+):\+:\$[a-zA-Z0-9_]+\}/g, (_, key) => (v => v ? `:${v}` : '')(process.env[key]))
-      .replaceAll(/\$\{([a-zA-Z0-9_]+)\}/g, (_, key) => process.env[key] ?? '')
-      .replaceAll(/\$([a-zA-Z0-9_]+)/g, (_, key) => process.env[key] ?? '')
-    console.error("FOO", str, value)
-    return value
+  const value = str
+    .replaceAll(
+      /\$\{([a-zA-Z0-9_]+):\+:\$[a-zA-Z0-9_]+\}/g,
+      (_, key) => ((v) => v ? `:${v}` : "")(process.env[key]),
+    )
+    .replaceAll(/\$\{([a-zA-Z0-9_]+)\}/g, (_, key) => process.env[key] ?? "")
+    .replaceAll(/\$([a-zA-Z0-9_]+)/g, (_, key) => process.env[key] ?? "");
+  console.error("FOO", str, value);
+  return value;
 };
 
-readInterface.on('line', (line) => {
-    const match = line.match(/^export ([^=]+)=(.*)$/);
-    if (match) {
-        const [_, key, value_] = match;
-        const value = stripQuotes(value_);
-        if (key === 'PATH') {
-            value
-              .replaceAll('${PATH:+:$PATH}', '')
-              .replaceAll('$PATH', '')
-              .replaceAll('${PATH}', '')
-              .split(':').forEach(path => {
-                fs.appendFileSync(process.env['GITHUB_PATH'], `${path}\n`);
-            });
-        } else {
-            let v = replaceEnvVars(value);
-            fs.appendFileSync(process.env['GITHUB_ENV'], `${key}=${v}\n`);
-        }
+readInterface.on("line", (line) => {
+  const match = line.match(/^export ([^=]+)=(.*)$/);
+  if (match) {
+    const [_, key, value_] = match;
+    const value = stripQuotes(value_);
+    if (key === "PATH") {
+      value
+        .replaceAll("${PATH:+:$PATH}", "")
+        .replaceAll("$PATH", "")
+        .replaceAll("${PATH}", "")
+        .split(":").forEach((path) => {
+          fs.appendFileSync(process.env["GITHUB_PATH"], `${path}\n`);
+        });
+    } else {
+      let v = replaceEnvVars(value);
+      fs.appendFileSync(process.env["GITHUB_ENV"], `${key}=${v}\n`);
     }
+  }
 });

parse.js

@@ -0,0 +1,8 @@
+export default function (x: string) {
+  /// `$` because we add some env vars recursively
+  if (!/\s/.test(x) && !/['"$><]/.test(x)) return x;
+  if (!x.includes('"')) return `"${x}"`;
+  if (!x.includes("'")) return `'${x}'`;
+  x = x.replaceAll('"', '\\"');
+  return `"${x}"`;
+}

src/shell-escape.ts

@@ -0,0 +1,79 @@
+import { Path } from "libpkgx";
+
+export default function shellcode() {
+  const datadir = new Path(
+    Deno.env.get("XDG_DATA_HOME")?.trim() || platform_data_home_default(),
+  ).join("pkgx", "dev");
+
+  return `
+_pkgx_chpwd_hook() {
+  if ! type _pkgx_dev_try_bye >/dev/null 2>&1 || _pkgx_dev_try_bye; then
+    dir="$PWD"
+    while [ "$dir" != "/" ]; do
+      if [ -f "${datadir}/$dir/dev.pkgx.activated" ]; then
+        eval "$(command dev)"
+        break
+      fi
+      dir="$(dirname "$dir")"
+    done
+  fi
+}
+
+dev() {
+  case "$1" in
+  off)
+    if type -f _pkgx_dev_try_bye >/dev/null 2>&1; then
+      rm "${datadir}$PWD/dev.pkgx.activated"
+      _pkgx_dev_try_bye
+    else
+      echo "no devenv" >&2
+    fi;;
+  ''|on)
+    mkdir -p "${datadir}$PWD"
+    touch "${datadir}$PWD/dev.pkgx.activated"
+    eval "$(command dev)";;
+  *)
+    return 2;;
+  esac
+}
+
+if [ -n "$ZSH_VERSION" ] && [ $(emulate) = zsh ]; then
+  eval 'typeset -ag chpwd_functions
+
+        if [[ -z "\${chpwd_functions[(r)_pkgx_chpwd_hook]+1}" ]]; then
+          chpwd_functions=( _pkgx_chpwd_hook \${chpwd_functions[@]} )
+        fi
+
+        if [ "$TERM_PROGRAM" != Apple_Terminal ]; then
+          _pkgx_chpwd_hook
+        fi'
+elif [ -n "$BASH_VERSION" ] && [ "$POSIXLY_CORRECT" != y ] ; then
+  eval 'cd() {
+          builtin cd "$@" || return
+          _pkgx_chpwd_hook
+        }
+        _pkgx_chpwd_hook'
+else
+  POSIXLY_CORRECT=y
+  echo "pkgx: dev: warning: unsupported shell" >&2
+fi
+`.trim();
+}
+
+function platform_data_home_default() {
+  const home = Path.home();
+  switch (Deno.build.os) {
+    case "darwin":
+      return home.join("Library/Application Support");
+    case "windows": {
+      const LOCALAPPDATA = Deno.env.get("LOCALAPPDATA");
+      if (LOCALAPPDATA) {
+        return new Path(LOCALAPPDATA);
+      } else {
+        return home.join("AppData/Local");
+      }
+    }
+    default:
+      return home.join(".local/share");
+  }
+}