docs: local dev runner (dev.py) + README install/dev sections - #12
Conversation
- dev.py: stdlib-only local task runner (check/test/cov/guard) so the tight dev loop runs locally for free instead of via paid agents - README: Installation + Development sections documenting the local loop Closes #8.
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: adc3443e5b
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
|
|
||
|
|
||
| def guard() -> int: | ||
| return run(PY, "tools/dep_guard.py") |
There was a problem hiding this comment.
Run the guard with a tomllib-capable interpreter
When dev.py check is run under supported Python 3.9/3.10 interpreters (requires-python = ">=3.9"), this delegates the guard to the same interpreter, but tools/dep_guard.py imports tomllib, which is only in the stdlib from Python 3.11 onward. I reproduced this with PYENV_VERSION=3.10.20 python dev.py guard, which exits with ModuleNotFoundError: No module named 'tomllib', so developers on supported Python versions cannot use the newly documented check loop.
Useful? React with 👍 / 👎.
Closes #8.
Makes the tight dev loop local and free — no agent/token spend for routine test/guard runs.
dev.py— stdlib-only task runner (no third-party runner, per the nativelite ethos):python dev.py {check,test,cov,guard}.check= the exact guard + unittest CI runs.Verified locally
Docs/tooling only — no runtime code changed.