set -euo pipefail
export LC_ALL=C
topic_work=$(mktemp -d "${TMPDIR:-/tmp}/regex-topic.XXXXXX")
trap 'rm -rf -- "$topic_work"' EXIT
cd "$topic_work"
cat > topic.json <<'REGEX_TOPIC_SPEC'
{
  "variants": [
    {
      "key": "bre",
      "label": "Plain / BRE (grep)",
      "tool": "grep",
      "engine": "grep BRE (POSIX patterns; GNU/BSD -o)",
      "pattern_block": "RGX-21-001-bre-pattern",
      "replacement_block": null,
      "command_block": "RGX-21-001-bre-command",
      "program_block": "RGX-21-001-bre-run",
      "note": "[.] separates the extension literally; fixed repeats enforce padding."
    },
    {
      "key": "ere",
      "label": "grep -E / ERE",
      "tool": "grep",
      "engine": "grep ERE (GNU/BSD -Eo)",
      "pattern_block": "RGX-21-001-ere-pattern",
      "replacement_block": null,
      "command_block": "RGX-21-001-ere-command",
      "program_block": "RGX-21-001-ere-run",
      "note": "Six captures define the handover; group 5 keeps the original version text."
    },
    {
      "key": "perl",
      "label": "Perl",
      "tool": "perl",
      "engine": "Perl regex",
      "pattern_block": "RGX-21-001-perl-pattern",
      "replacement_block": "RGX-21-001-perl-replacement",
      "command_block": "RGX-21-001-perl-command",
      "program_block": "RGX-21-001-perl-run",
      "note": "Braced numbered references make adjacency to underscores explicit."
    },
    {
      "key": "sed",
      "label": "sed / BRE",
      "tool": "sed",
      "engine": "sed BRE",
      "pattern_block": "RGX-21-001-sed-pattern",
      "replacement_block": "RGX-21-001-sed-replacement",
      "command_block": "RGX-21-001-sed-command",
      "program_block": "RGX-21-001-sed-run",
      "note": "The same six captures can be reordered with \\2, \\3, \\4, \\1, \\5, \\6."
    },
    {
      "key": "emacs",
      "label": "Emacs",
      "tool": "emacs",
      "engine": "Emacs regex",
      "pattern_block": "RGX-21-001-emacs-pattern",
      "replacement_block": "RGX-21-001-emacs-replacement",
      "command_block": "RGX-21-001-emacs-command",
      "program_block": "RGX-21-001-emacs-run",
      "note": "Use the displayed replacement directly; it is not a Lisp string."
    }
  ],
  "experiment": {
    "key": "change",
    "label": "Allow versions with one to three digits",
    "tool": "perl",
    "engine": "Perl regex",
    "pattern_block": "RGX-21-001-change-pattern",
    "replacement_block": "RGX-21-001-change-replacement",
    "command_block": "RGX-21-001-change-command",
    "program_block": "RGX-21-001-change-run",
    "note": "Relax only group 5 from two digits to one through three. The previously excluded v2 record now transforms. Keep the supplied spelling: accepting variable width does not silently zero-pad the version.",
    "goal": "Relax only group 5 from two digits to one through three. The previously excluded v2 record now transforms. Keep the supplied spelling: accepting variable width does not silently zero-pad the version.",
    "kind": "change"
  },
  "aliases": [],
  "compact": true
}
REGEX_TOPIC_SPEC
cat > compare.py <<'REGEX_TOPIC_RUNNER'
#!/usr/bin/env python3
"""Capture the six source-owned programs for one regexp issue."""
import json
import os
from pathlib import Path
import signal
import subprocess
import sys


def capture(key):
    program = Path(key + '.sh')
    if not program.is_file() or program.is_symlink():
        raise ValueError('Missing regular comparison program: ' + key)
    with subprocess.Popen(['bash', '--noprofile', '--norc', str(program)],
                          stdin=subprocess.DEVNULL, stdout=subprocess.PIPE,
                          stderr=subprocess.PIPE, text=True, start_new_session=True) as process:
        try:
            stdout, stderr = process.communicate(timeout=20)
        except subprocess.TimeoutExpired:
            os.killpg(process.pid, signal.SIGKILL)
            process.communicate()
            raise RuntimeError('Comparison program timed out: ' + key) from None
    return dict(key=key, stdout=stdout, stderr=stderr, exit=process.returncode)


def main():
    spec = json.loads(Path('topic.json').read_text())
    keys = [entry['key'] for entry in spec['variants']]
    if keys != ['bre', 'ere', 'perl', 'sed', 'emacs'] or spec['experiment']['key'] != 'change':
        raise ValueError('Expected five dialect views and one changed assumption.')
    result = dict(variants=[capture(key) for key in keys], experiment=capture('change'))
    print(json.dumps(result, ensure_ascii=False, indent=2, sort_keys=True))
    return int(any(run['exit'] != 0 for run in result['variants'] + [result['experiment']]))


if __name__ == '__main__':
    try:
        raise SystemExit(main())
    except (OSError, ValueError, RuntimeError) as error:
        raise SystemExit('Regex comparison: ' + str(error)) from None
REGEX_TOPIC_RUNNER
cat > bre.sh <<'REGEX_PROGRAM_BRE'
set -euo pipefail
export LC_ALL=C
regex_work=$(mktemp -d "${TMPDIR:-/tmp}/regex-example.XXXXXX")
trap 'rm -rf -- "$regex_work"' EXIT
cd "$regex_work"
mkdir data
cat > data/filenames.txt <<'RGX_INPUT'
atlas_20261101_v02.csv
atlas_20261031_v12.tsv
rna-seq_20260229_v01.csv
atlas_20261101_v2.csv
my_project_20261101_v02.csv
notes.txt
RGX_INPUT
grep -o '^\([A-Za-z][A-Za-z0-9-]*\)_\([0-9]\{4\}\)\([0-9]\{2\}\)\([0-9]\{2\}\)_v\([0-9]\{2\}\)[.]\([a-z]\{3\}\)$' data/filenames.txt
REGEX_PROGRAM_BRE
cat > ere.sh <<'REGEX_PROGRAM_ERE'
set -euo pipefail
export LC_ALL=C
regex_work=$(mktemp -d "${TMPDIR:-/tmp}/regex-example.XXXXXX")
trap 'rm -rf -- "$regex_work"' EXIT
cd "$regex_work"
mkdir data
cat > data/filenames.txt <<'RGX_INPUT'
atlas_20261101_v02.csv
atlas_20261031_v12.tsv
rna-seq_20260229_v01.csv
atlas_20261101_v2.csv
my_project_20261101_v02.csv
notes.txt
RGX_INPUT
grep -Eo '^([A-Za-z][A-Za-z0-9-]*)_([0-9]{4})([0-9]{2})([0-9]{2})_v([0-9]{2})[.]([a-z]{3})$' data/filenames.txt
REGEX_PROGRAM_ERE
cat > perl.sh <<'REGEX_PROGRAM_PERL'
set -euo pipefail
export LC_ALL=C
regex_work=$(mktemp -d "${TMPDIR:-/tmp}/regex-example.XXXXXX")
trap 'rm -rf -- "$regex_work"' EXIT
cd "$regex_work"
mkdir data
cat > data/filenames.txt <<'RGX_INPUT'
atlas_20261101_v02.csv
atlas_20261031_v12.tsv
rna-seq_20260229_v01.csv
atlas_20261101_v2.csv
my_project_20261101_v02.csv
notes.txt
RGX_INPUT
perl -pe '
s{^([A-Za-z][A-Za-z0-9-]*)_([0-9]{4})([0-9]{2})([0-9]{2})_v([0-9]{2})[.]([a-z]{3})$}{${2}-${3}-${4}_${1}_v${5}.${6}}g;
' data/filenames.txt
REGEX_PROGRAM_PERL
cat > sed.sh <<'REGEX_PROGRAM_SED'
set -euo pipefail
export LC_ALL=C
regex_work=$(mktemp -d "${TMPDIR:-/tmp}/regex-example.XXXXXX")
trap 'rm -rf -- "$regex_work"' EXIT
cd "$regex_work"
mkdir data
cat > data/filenames.txt <<'RGX_INPUT'
atlas_20261101_v02.csv
atlas_20261031_v12.tsv
rna-seq_20260229_v01.csv
atlas_20261101_v2.csv
my_project_20261101_v02.csv
notes.txt
RGX_INPUT
sed 's~^\([A-Za-z][A-Za-z0-9-]*\)_\([0-9]\{4\}\)\([0-9]\{2\}\)\([0-9]\{2\}\)_v\([0-9]\{2\}\)[.]\([a-z]\{3\}\)$~\2-\3-\4_\1_v\5.\6~g' data/filenames.txt
REGEX_PROGRAM_SED
cat > emacs.sh <<'REGEX_PROGRAM_EMACS'
set -euo pipefail
export LC_ALL=C
regex_work=$(mktemp -d "${TMPDIR:-/tmp}/regex-example.XXXXXX")
trap 'rm -rf -- "$regex_work"' EXIT
cd "$regex_work"
mkdir data
cat > data/filenames.txt <<'RGX_INPUT'
atlas_20261101_v02.csv
atlas_20261031_v12.tsv
rna-seq_20260229_v01.csv
atlas_20261101_v2.csv
my_project_20261101_v02.csv
notes.txt
RGX_INPUT
cat > regexp.txt <<'RGX_REGEXP'
^\([A-Za-z][A-Za-z0-9-]*\)_\([0-9]\{4\}\)\([0-9]\{2\}\)\([0-9]\{2\}\)_v\([0-9]\{2\}\)[.]\([a-z]\{3\}\)$
RGX_REGEXP
cat > replacement.txt <<'RGX_REPLACEMENT'
\2-\3-\4_\1_v\5.\6
RGX_REPLACEMENT
cat > example.el <<'RGX_ELISP'
(defun tour-read-editor-field (file)
  "Read one LF-terminated editor field without interpreting its backslashes."
  (with-temp-buffer
    (insert-file-contents-literally file)
    (unless (eq (char-before (point-max)) ?\n)
      (error "Expected an LF-terminated editor field: %s" file))
    (buffer-substring-no-properties (point-min) (1- (point-max)))))
(with-temp-buffer
  (insert-file-contents "data/filenames.txt")
  (let ((case-fold-search nil)
        (case-replace nil)
        (replace-regexp-lax-whitespace nil)
        (inhibit-message t))
    (replace-regexp (tour-read-editor-field "regexp.txt")
                    (tour-read-editor-field "replacement.txt")
                    nil (point-min) (point-max)))
  (princ (buffer-string)))
RGX_ELISP
emacs --batch -Q --script example.el
REGEX_PROGRAM_EMACS
cat > change.sh <<'REGEX_PROGRAM_CHANGE'
set -euo pipefail
export LC_ALL=C
regex_work=$(mktemp -d "${TMPDIR:-/tmp}/regex-example.XXXXXX")
trap 'rm -rf -- "$regex_work"' EXIT
cd "$regex_work"
mkdir data
cat > data/filenames.txt <<'RGX_INPUT'
atlas_20261101_v02.csv
atlas_20261031_v12.tsv
rna-seq_20260229_v01.csv
atlas_20261101_v2.csv
my_project_20261101_v02.csv
notes.txt
RGX_INPUT
perl -pe '
s{^([A-Za-z][A-Za-z0-9-]*)_([0-9]{4})([0-9]{2})([0-9]{2})_v([0-9]{1,3})[.]([a-z]{3})$}{${2}-${3}-${4}_${1}_v${5}.${6}}g;
' data/filenames.txt
REGEX_PROGRAM_CHANGE
TMPDIR="$topic_work" python3 compare.py