Enable extraction from '# Commands' block, add fixtures/tests for tabular command data

Author: grega

hdi

@@ -34,7 +34,7 @@ DIR="."
 
 # ── Keyword groups ───────────────────────────────────────────────────────────
 KW_INSTALL="prerequisite|require|depend|install|setup|set.up|set-up|getting.started|quick.start|quickstart"
-KW_RUN="usage|running|run|start|develop|dev.server|launch"
+KW_RUN="usage|running|run|start|develop|dev.server|launch|command"
 KW_TEST="test|spec"
 KW_EXTRA="build|configuration|config|environment|deploy"
 

test/fixtures/table-commands/README.md

@@ -0,0 +1,15 @@
+# my-astro-site
+
+Code for my website.
+
+## Commands
+
+| Command             | Action                                           |
+| :------------------ | :----------------------------------------------- |
+| `npm i`             | Installs dependencies                            |
+| `npm run dev`       | Starts local dev server at `localhost:4321`      |
+| `npm run build`     | Build your production site to `./dist/`          |
+| `npm run preview`   | Preview your build locally, before deploying     |
+| `npm run lint`      | Lint code with eslint                            |
+| `npm run format`    | Format with Prettier                             |
+| `npm run astro ...` | Run CLI commands like `astro add`, `astro check` |

test/hdi.bats

@@ -617,6 +617,29 @@ setup() {
   [[ "$output" == *"npm install"* ]]
 }
 
+# ── Table commands ───────────────────────────────────────────────────────────
+
+@test "table: extracts backtick commands from table rows" {
+  run "$HDI" --raw "$FIXTURES/table-commands"
+  [ "$status" -eq 0 ]
+  [[ "$output" == *"npm i"* ]]
+  [[ "$output" == *"npm run dev"* ]]
+  [[ "$output" == *"npm run build"* ]]
+}
+
+@test "table: 'Commands' heading matches run mode" {
+  run "$HDI" run --raw "$FIXTURES/table-commands"
+  [ "$status" -eq 0 ]
+  [[ "$output" == *"npm run dev"* ]]
+}
+
+@test "table: does not extract non-command text from table cells" {
+  run "$HDI" --raw "$FIXTURES/table-commands"
+  [ "$status" -eq 0 ]
+  [[ "$output" != *"localhost"* ]]
+  [[ "$output" != *"Installs dependencies"* ]]
+}
+
 # ── Interactive: copy to clipboard ───────────────────────────────────────────
 
 @test "interactive: 'c' copies highlighted command to clipboard" {