Formatter improvements

[nonprofittechy]

No description provided.

[nonprofittechy]

This is too big a PR, but looking to see what else can be effectively pulled from it to avoid divergence.

Note: we already pulled in switch to ruamel.yaml

I do not want to change the basic syntax or add the dayaml multi-command line; will stick with dayamlchecker-fmt

Do not want to change most of the errors (most of which will stop interview from compiling, some only break or have unexpected behavior at runtime) into warnings

[Copilot]

Pull request overview

This PR expands the project’s CLI/formatter/checker functionality by introducing structured message codes, Jinja-aware processing, and a new top-level dayaml command, along with substantial new test coverage and fixtures.

Changes:

• Added a message registry (MessageCode + templates) and refactored validators/checker output to use stable [E/W/C###] codes.
• Added Jinja2 header detection + preprocessing for the checker, and text-based formatting for # use jinja files in the formatter.
• Introduced shared YAML file collection utilities and a new dayaml multi-command CLI; updated docs and test suite/fixtures accordingly.

Reviewed changes

Copilot reviewed 20 out of 23 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
src/dayamlchecker/yaml_structure.py	Refactors validation to emit coded findings, adds Jinja preprocessing, improves CLI output and summary handling.
src/dayamlchecker/messages.py	New central registry of message codes, severity, templates, and experimental/real-error semantics.
src/dayamlchecker/_jinja.py	Adds Jinja header detection, syntax detection, and safe rendering for static analysis.
src/dayamlchecker/_files.py	Adds shared _collect_yaml_files used by checker/formatter.
src/dayamlchecker/code_formatter.py	Adds Jinja-aware formatting path; refactors CLI to use shared collection and improved output.
src/dayamlchecker/cli.py	New dayaml command dispatcher for check and format.
src/dayamlchecker/__main__.py	Keeps module entrypoint as checker CLI with a standard SystemExit(main()) guard.
src/dayamlchecker/py.typed	Continues to mark the package as typed for type checkers.
tests/test_yaml_structure_cli.py	Adds CLI/process_file integration tests for checker behavior and output formatting.
tests/test_yaml_structure.py	Greatly expands unit coverage for message codes, Jinja handling, and many validator edge cases.
tests/test_code_formatter_cli.py	Adds formatter CLI integration tests (quiet/no-summary/check mode, Jinja behavior, error handling).
tests/test_code_formatter.py	Adds extensive formatter unit tests including Jinja utilities and file collection.
tests/test_dayaml_cli.py	Adds tests for the new dayaml command dispatcher behavior.
tests/_cli_helpers.py	Adds a shared RunResult helper for CLI tests.
tests/__init__.py	Marks tests as a package to support shared helpers.
tests/fixtures/large_valid_interview.yml	Adds a “known-good” large fixture used by tests.
tests/fixtures/large_invalid_interview.yml	Adds a large “covers registry” fixture for error-code coverage assertions.
tests/fixtures/large_invalid_jinja_syntax.yml	Adds fixture for Jinja syntax error coverage.
tests/fixtures/large_invalid_jinja_template.yml	Adds fixture for Jinja template/runtime error coverage.
requirements.txt	Updates dependencies (adds Jinja2; removes PyYAML/types; retains ruamel.yaml/black/mypy).
pyproject.toml	Adds script entrypoints, dependency groups, and coverage config; updates dependency declarations.
README.md	Documents new dayaml CLI usage and the message code catalog.
.gitignore	Expands coverage ignore pattern and adds .vscode/.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[jpagh]

@nonprofittechy I didn't realize that you were doing this until just now.

I just merged/your main branch into this and then rebased it into a few clean, logical commits. Hopefully it helps.

I am just curious why you don't like the dayaml check / dayaml format multi-command syntax vs dayamlchecker / dayamlchecker-fmt?

Let me know if there's anything else I can do to bring these features into the main line. Eventually I want to use this in my docassemblecli3 to pre-check yaml files before uploading them with watch.

Anyways, I've been quite happy using my branch for my own work, but now I'll be testing this new combined branch.