add flags

Author: alexeagle

8.0.1/flags.mdx

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# Ask Bazel to dump the flags as a binary protobuf, and save in our repo for later rendering.
+set -o errexit -o nounset -o pipefail
+
+cd "$(dirname "${BASH_SOURCE[0]}")"
+
+if [ -z "${USE_BAZEL_VERSION:-}" ]; then
+  export USE_BAZEL_VERSION=rolling
+  OUTPUT_FILE=flags.mdx
+else
+  OUTPUT_FILE=${USE_BAZEL_VERSION}/flags.mdx
+fi
+bazel help flags-as-proto | node flags_to_markdown_converter/convert.js > ${OUTPUT_FILE}

flags-converter.sh

@@ -0,0 +1,7 @@
+---
+title: 'Flags'
+---
+
+import { BazelFlags } from "/snippets/color-generator.jsx"
+
+<BazelFlags />

flags.mdx

@@ -0,0 +1,42 @@
+import { FlagCollectionSchema } from '@buf/bazel_bazel.bufbuild_es/bazel_flags/bazel_flags_pb.js';
+import { fromBinary } from '@bufbuild/protobuf'
+
+const writeLine = (line) => process.stdout.write(line + '\n');
+function escapeHtml(str) {
+    return str
+      .replace(/&/g, "&")
+      .replace(/</g, "&lt;")
+      .replace(/>/g, "&gt;");
+  }
+
+// Read stdin as a stream
+let base64String = '';
+process.stdin.setEncoding('utf8');
+for await (const chunk of process.stdin) {
+    base64String += chunk;
+}
+
+const flags = fromBinary(FlagCollectionSchema, Buffer.from(base64String.trim(), 'base64'));
+
+// Write header
+writeLine('---');
+writeLine('title: Bazel flags');
+writeLine('---');
+writeLine('');
+
+// Write each flag
+for (const flag of flags.flagInfos) {
+    const abbrev = flag.abbreviation ? `(-${flag.abbreviation})` : '';
+    writeLine(`## --${flag.name} ${abbrev}`);
+    writeLine('');
+    // TODO: add history - what version of Bazel introduced this flag?
+    // TODO: this is wrapped in a <pre> tag to avoid invalid markdown like bare html tags
+    writeLine(escapeHtml(flag.documentation));
+    
+    if (flag.commands.length > 0) {
+        writeLine('');
+        writeLine(`_May apply to commands: ${flag.commands.join(', ')}_`);
+    }
+    
+    writeLine('');
+}

flags/index.mdx

@@ -0,0 +1,10 @@
+{
+    
+  "type": "module",
+  "dependencies": {
+    "@buf/bazel_bazel.bufbuild_es": "^2.10.1-20251112223041-697bc75dbe09.1"
+  },
+  "scripts": {
+    "convert": "node convert.js"
+  }
+}

flags_to_markdown_converter/convert.js

@@ -0,0 +1,32 @@
+export const BazelFlags = () => {
+    // const [hue, setHue] = useState(180)
+    // const [saturation, setSaturation] = useState(50)
+    // const [lightness, setLightness] = useState(50)
+    // const [colors, setColors] = useState([])
+  
+    // useEffect(() => {
+    //   const newColors = []
+    //   for (let i = 0; i < 5; i++) {
+    //     const l = Math.max(10, Math.min(90, lightness - 20 + i * 10))
+    //     newColors.push(`hsl(${hue}, ${saturation}%, ${l}%)`)
+    //   }
+    //   setColors(newColors)
+    // }, [hue, saturation, lightness])
+  
+    // const copyToClipboard = (color) => {
+    //   navigator.clipboard
+    //     .writeText(color)
+    //     .then(() => {
+    //       console.log(`Copied ${color} to clipboard!`)
+    //     })
+    //     .catch((err) => {
+    //       console.error("Failed to copy: ", err)
+    //     })
+    // }
+  
+    return (
+      <div className="p-4 border dark:border-zinc-950/80 rounded-xl not-prose">
+        Flag documentation goes here.
+      </div>
+    )
+  }