feat: pattern support args and multiple variants; add zed extension for highlight

example/showcase/05-pattern-expansion.jdg

@@ -1,11 +1,20 @@
-// Автогенерация тестов из папки с файлами. Удобно когда тестов много и
-// вручную выписывать каждый через test("...") { stdin = ... stdout = ... }
-// будет слишком громоздко.
+// Автогенерация тестов из файлов/папок. Покрывает четыре типовых сценария:
 //
-// Два режима:
-//   1) file-glob — пары .in/.ans файлов
-//   2) dir-mode — каждый тест лежит в своей подпапке с фиксированными
-//      именами input/output файлов
+//   1. Stdio-режим с парой globs     — классика: stdin из .in, stdout = .ans
+//   2. Shared expected               — N входов, один общий ожидаемый файл
+//   3. File-mode по args             — программа читает файл по аргументу
+//   4. Dir-mode с input+output файлами — программа читает И пишет файлы
+//
+// Плейсхолдеры в `args` pattern'а:
+//   {input_path}  — путь к input-файлу текущего теста (для glob — разный,
+//                   для литерала — один и тот же во всех тестах)
+//   {output_path} — аналогично для output
+//   {name}        — wildcard-часть имени (glob) или basename директории (dir)
+//   {dir}         — dir-mode: полный путь к директории теста
+//
+// Правило режима: наличие `{input_path}` в args → input кладётся как InFile,
+// а не в stdin. Наличие `{output_path}` → expected сравнивается как OutFile,
+// а не stdout.
 
 toolchains {
     gcc { platforms = "linux" }
@@ -19,11 +28,10 @@ build "release" {
     profile  = release
 }
 
-// Режим 1: глобы на input и output файлы.
-// Тестом становится каждая пара (tests/*.in, tests/*.ans) с совпадающим
-// базовым именем. Имя теста — имя файла без расширения.
-group("from-files") {
-    weight = 0.5
+// 1) Классика: каждая пара (*.in, *.ans) → один тест.
+//    Stdin ← .in, Stdout сравнивается с .ans.
+group("stdio-pair") {
+    weight = 0.25
 
     pattern {
         input  = "tests/*.in"
@@ -31,22 +39,42 @@ group("from-files") {
     }
 }
 
-// Режим 2: каждый тест — подкаталог с фиксированным layout'ом.
-// Ожидается структура:
-//   cases/
-//     01-basic/
-//       input.txt
-//       expected.txt
-//     02-edge/
-//       input.txt
-//       expected.txt
-// Имя теста — имя подкаталога.
-group("from-dirs") {
-    weight = 0.5
+// 2) Один общий expected для всех входов.
+//    Удобно для задач где «для любого корректного входа ответ одинаковый»
+//    (edge-case fuzzing) или наоборот «все некорректные входы → error»
+//    (смотрим на один и тот же файл с сообщением об ошибке).
+group("shared-output") {
+    weight = 0.25
 
     pattern {
-        dirs   = "cases/*"
-        input  = "input.txt"
-        output = "expected.txt"
+        input  = "edge/*.in"
+        output = "edge/expected.ans"   // литерал без *
+    }
+}
+
+// 3) Программа читает файл по аргументу командной строки, а не из stdin.
+//    Expander создаёт InFiles[01.in]=..., запускает `./solution 01.in`,
+//    сравнивает stdout программы с содержимым соответствующего .ans.
+group("file-input") {
+    weight = 0.25
+
+    pattern {
+        input  = "file-tests/*.in"
+        output = "file-tests/*.ans"
+        args   = "{input_path}"
+    }
+}
+
+// 4) Программа и читает, и пишет через файлы — никакого stdin/stdout.
+//    Expander кладёт input в InFiles, expected в OutFiles, запускает
+//    `./solution in.txt out.txt` и сравнивает созданный out.txt с expected.
+group("file-io") {
+    weight = 0.25
+
+    pattern {
+        dirs   = "cases/*"          // каждая подпапка — отдельный тест
+        input  = "in.txt"
+        output = "out.txt"
+        args   = "{input_path}" "{output_path}"
     }
 }