Skip to content

Support !exec commands in metadata-file/metadata-files - #14777

Open
jmguzmanc wants to merge 1 commit into
quarto-dev:mainfrom
jmguzmanc:feature/metadata-files-exec
Open

Support !exec commands in metadata-file/metadata-files#14777
jmguzmanc wants to merge 1 commit into
quarto-dev:mainfrom
jmguzmanc:feature/metadata-files-exec

Conversation

@jmguzmanc

Copy link
Copy Markdown

Description

Allow metadata-file(s) entries to run a command instead of naming a static file, using a new !exec <command> YAML tag:

        metadata-file: !exec ./include-chapters.py --lang en

or

        metadata-files:
          - !exec ./include-chapters.py --lang en

The command's stdout is parsed as YAML and merged into the project or document metadata exactly like a regular metadata file, including schema validation and error reporting.

Checklist

I have (if applicable):

AI-assisted PR
  • AI tool used: Claude Code
  • Codebase grounding: e.g., DeepWiki MCP, Context7 MCP, local clone, llms.txt
  • Human review: I have reviewed, tested, and verified the AI-generated content before submitting.

Allow metadata-file(s) entries to run a command instead of naming a
static file, using a new `!exec <command>` YAML tag:

    metadata-files:
      - !exec ./include-chapters.py --lang en

The command's stdout is parsed as YAML and merged into the project or
document metadata exactly like a regular metadata file, including
schema validation and error reporting.

Implementation:
- Register `!exec` as a custom YAML tag in both parser stacks
  (core/yaml.ts and the lib-safe js-yaml-schema.ts), mirroring the
  existing `!expr` tag.
- Extend the shared validation-error suppression (previously only for
  `!expr`) so `!exec`-tagged values don't fail schema checks that
  expect a plain path string.
- Reuse the same script-runner dispatch used by pre-render/post-render
  scripts, so `.py`/`.R`/`.lua`/`.js`/`.ts` commands run through their
  proper interpreter automatically; anything else falls back to a
  plain process spawn.
- Any tag other than `!exec` (e.g. a stray `!expr`) now fails with a
  clear "unsupported tag" error instead of an internal TypeError.

Includes unit tests for the tag parsing and a smoke test covering a
project with both a plain-file and an `!exec` metadata-files entry.
@posit-snyk-bot

posit-snyk-bot commented Aug 15, 2026

Copy link
Copy Markdown
Collaborator

Snyk checks have passed. No issues have been found so far.

Status Scan Engine Critical High Medium Low Total (0)
Open Source Security 0 0 0 0 0 issues
Licenses 0 0 0 0 0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants