Changelog
This changelog is generated automatically from GitHub Releases.
v0.1.3
2026-11-07 · GitHub
Released to PyPI on 2026-11-07: https://pypi.org/project/chameleon-robyn/0.1.3/
Fixed
- Bare
[@template](https://github.com/template)on a handler in a script run directly (python app.py) now derives the template directory from the script’s file name, soindex()inapp.pymaps toapp/index.ptinstead of the literal module name__main__/index.pt. An existing__main__/index.htmlor.ptis still used when the script-named file is absent, so apps relying on the old name keep working. - A template variable named
encodingpassed to render(), response(), a decorated handler or ChameleonTemplate.render_template() now raises ChameleonRobynException with a clear message. The name is a parameter of Chameleon’s own render(), so it previously failed with aTypeErrorfrom inside Chameleon.
Documentation
- Added a user guide to the docs site: getting started, the
[@template](https://github.com/template)decorator, writing templates, friendly 404 pages, rendering outside handlers, configuration, testing, errors and how to fix them, how it works, and an FAQ. The guide is included inllms-full.txt. - Replaced the auto-generated agent skill with a hand-written
skills/chameleon-robyn/SKILL.mdcovering the package’s rules, a decision table and the API in one page. - Added an
Examplessection to every public docstring, and a module docstring naming the entry points. - The README now links each section to the guide page that expands it, and documents raising ChameleonRobynNotFoundException directly to pass a custom 404 message.
scripts/build_docs.pyruns the latest Great Docs release throughuvxwith the project installed alongside it, and fails ifllms.txt,llms-full.txtorskill.mdis missing from the output.- The user guide and README now follow one running example, the podcast site in
example/, with each section opening on the problem the feature solves. Code samples are unchanged. - The docs site has a changelog page, generated from GitHub Releases and linked from the navbar. Releases 0.1.0 through 0.1.2 were tagged and published as GitHub Releases retroactively.
Full changelog: https://github.com/mikeckennedy/chameleon-robyn/blob/main/CHANGELOG.md
v0.1.2
2026-11-07 · GitHub
Released to PyPI on 2026-06-11: https://pypi.org/project/chameleon-robyn/0.1.2/
Review pass that fixed several decorator bugs reported in #1, added docstrings and a documentation site, and broadened the test suite.
Fixed
- Auto-named templates are now resolved lazily at the first request instead of at decoration time, so global_init() can run after routes are decorated and the
.html-or-.ptcheck looks in the real template folder rather than a working-directory-relativetemplatesdefault. - Reusing one
[@template](https://github.com/template)()decorator instance across several handlers no longer leaks the first handler’s auto-derived template name into the others. - The handler’s returned dict is copied before
__response_callback__is popped, so handlers returning a shared or module-level dict are never mutated. - A non-callable
__response_callback__now raises ChameleonRobynException instead of being silently ignored. - The message carried by not_found() and ChameleonRobynNotFoundException is now passed to the 404 template as
message. Previously the 404 template was rendered with an empty model. - The README and the template() docstring described auto-naming backwards. Both now say
.htmlis tried first with.ptas the fallback, which is what the code has always done. The README also no longer claims ChameleonTemplate subclasses Robyn’s ABC.
Changed
- Tightened type annotations across the public API: not_found() returns
NoReturn, template data isAny, and parameters have explicitbool,strandinttypes. The library, tests and examples type-check clean under both ty and pyrefly. - The development status classifier on PyPI is now Alpha, matching the README notice.
- Dropped the unused
hatch-vcsbuild requirement and the unusedpytest-asynciodev dependency.great-docsis now a dev dependency. - Expanded the PyPI keywords and added Documentation, Source, Issues, PyPI and Funding project URLs.
Added
- Google-style docstrings on every public function, class and exception.
- Documentation site generated by Great Docs at https://mkennedy.codes/docs/chameleon-robyn/, including
llms.txt,llms-full.txtand an agent skill page, plusscripts/build_docs.pyandscripts/serve_docs.py. - README section on
__response_callback__with a set-a-session-cookie example, and a matching/cookie-exampleroute inexample/app.py. - Test suite grew from 22 to 39 tests, with
view_style,make_viewandcall_viewfixtures that run the decorator contract tests through both the sync and async wrappers.
Full changelog: https://github.com/mikeckennedy/chameleon-robyn/blob/main/CHANGELOG.md
v0.1.1
2026-11-07 · GitHub
Released to PyPI on 2026-03-20: https://pypi.org/project/chameleon-robyn/0.1.1/
Added
__response_callback__reserved model key. A handler can include a callable under this key in its returned dict and the decorator calls it with the builtResponseafter rendering, so apps can set cookies or headers. The key is removed from the model before the template is rendered and is never passed to the template.
Full changelog: https://github.com/mikeckennedy/chameleon-robyn/blob/main/CHANGELOG.md
v0.1.0
2026-11-07 · GitHub
Released to PyPI on 2026-03-19: https://pypi.org/project/chameleon-robyn/0.1.0/
Initial release.
Added
- global_init() points Chameleon at a template folder, with
auto_reload,cache_initandrestricted_namespaceoptions. [@template](https://github.com/template)decorator for Robyn handlers: explicit template paths, auto-naming from the module and function name (.htmlfirst, then.pt), sync and async handlers, custom status codes and content types, and pass-through of handlers that return a RobynResponse.- not_found() renders a friendly 404 page (default
errors/404.pt) from inside a decorated handler. - render() and response() for rendering templates outside of handlers.
- ChameleonTemplate class implementing Robyn’s
TemplateInterfacethrough a local Protocol, so the library does not pull in Jinja2. - Example apps in
example/andexample-partials/.
Full changelog: https://github.com/mikeckennedy/chameleon-robyn/blob/main/CHANGELOG.md