Skip to content

Introducing declarative Python syntax over YAML syntax#9

Merged
woojiahao merged 18 commits intomainfrom
woojiahao/declarative-python-rewrite
Dec 26, 2025
Merged

Introducing declarative Python syntax over YAML syntax#9
woojiahao merged 18 commits intomainfrom
woojiahao/declarative-python-rewrite

Conversation

@woojiahao
Copy link
Copy Markdown
Member

Full RFC: https://docs.google.com/document/d/1kko6PP1A7OjXn6A994XC9M7IQMrzswwRDBs839XW_qQ/edit?tab=t.0

The core idea is for us to migrate away from a clunky and hard to maintain third-party YAML syntax in favor of a more declarative Python syntax so we embed the setup code within the unit tests.

There are hopes for us to use this for setting up repositories, but for now, we are sticking to using these for unit tests

Copy link
Copy Markdown
Contributor

@jovnc jovnc left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Left some comments in case you missed out some minor details.

Also, with this change, it looks like we can do some cleaning on the repository as well, and remove old tests, eg. the YAML test. We also need to update specification.md to reflect this latest change.

Copy link
Copy Markdown
Contributor

@jovnc jovnc left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall LGTM

Should we also clean up the repository to remove traces of old specifications? This can cause confusion to new developers who aren't aware of the previous YAML spec.

  • update specification.md
  • update tests to reflect this changes
  • remove unnecessary tests, eg. spec files, integration tests

@woojiahao
Copy link
Copy Markdown
Member Author

I'm inclined to do these changes after we've merged everything into exercises first. I would want to cut the release for this change ASAP so that if there's any issues, we can immediately test for it.

I'll make a PR to clean everything up and add full unit testing

@woojiahao woojiahao requested a review from jovnc December 26, 2025 08:30
Copy link
Copy Markdown
Contributor

@jovnc jovnc left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@woojiahao
Copy link
Copy Markdown
Member Author

Teardown PR started here: #10

@woojiahao woojiahao merged commit a2cff59 into main Dec 26, 2025
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