dotpromptz-handlebars 0.2.0__tar.gz

dotpromptz_handlebars-0.2.0/.gitignore

@@ -0,0 +1,32 @@
+*$py.class
+*.egg
+*.egg-info/
+*.py[cod]
+*.so
+.DS_Store
+.Python
+.cache/
+.coverage
+.eggs/
+.genkit
+.idea/
+.installed.cfg
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.venv
+ENV/
+__pycache__/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+lib/
+lib64/
+parts/
+sdist/
+site/
+var/
+venv/
+wheels/

dotpromptz_handlebars-0.2.0/BUILD.bazel

@@ -0,0 +1,25 @@
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# SPDX-License-Identifier: Apache-2.0
+
+load("@rules_python//python:defs.bzl", "py_library")
+
+package(default_visibility = ["//visibility:public"])
+
+py_library(
+    name = "handlebars",
+    srcs = glob(["dotpromptz_handlebars/**/*.py"]),
+    imports = ["."],
+)

dotpromptz_handlebars-0.2.0/CHANGELOG.md

@@ -0,0 +1,157 @@
+# Changelog
+
+## [0.2.0](https://github.com/google/dotprompt/compare/dotpromptz-handlebars-0.1.10...dotpromptz-handlebars-0.2.0) (2026-10-05)
+
+### ⚠ BREAKING CHANGES
+
+* **imports:** Python import module is now `dotpromptz_handlebars`, replacing `handlebarrz` (`import handlebarrz` -> `import dotpromptz_handlebars`).
+
+### Features
+
+* **engine:** rewrite Handlebars template engine in pure Python with zero native dependencies ([#620](https://github.com/google/dotprompt/pull/620)).
+* **helpers:** `options.fn([context])` and `options.inverse([context])` accept an optional context argument to render block bodies with explicit scope, matching Handlebars.js.
+* **helpers:** `HelperOptions.context` provides direct attribute access to the active scope, while maintaining `options.context()` callable compatibility for dictionary scopes.
+
+## [0.1.9](https://github.com/google/dotprompt/compare/dotpromptz-handlebars-0.1.8...dotpromptz-handlebars-0.1.9) (2026-09-18)
+
+
+### Bug Fixes
+
+* add Apache-2.0 license metadata to all packages ([#528](https://github.com/google/dotprompt/issues/528)) ([c76c663](https://github.com/google/dotprompt/commit/c76c6639fb77b39ef5b45a1a8dbebacc4c9bd422))
+* **python:** expire helper options on return and pass through helper exits in render_template ([#607](https://github.com/google/dotprompt/issues/607)) ([df61290](https://github.com/google/dotprompt/commit/df612903a8777ce626b926f5c840c6d4758874f1))
+* **python:** isolate runtime context from input and reject cyclic partials ([#604](https://github.com/google/dotprompt/issues/604)) ([6b97598](https://github.com/google/dotprompt/commit/6b97598cb33bf9433ae7ad6cff63ced15299de0d))
+
+## [0.1.8](https://github.com/google/dotprompt/compare/dotpromptz-handlebars-0.1.7...dotpromptz-handlebars-0.1.8) (2026-01-30)
+
+
+### Bug Fixes
+
+* **docs:** remove incorrect OpenSSF Best Practices badge ([#490](https://github.com/google/dotprompt/issues/490)) ([6cdabd7](https://github.com/google/dotprompt/commit/6cdabd7e4d09e5b71034d0bae183af4cfc94fe1d))
+
+
+### Documentation
+
+* **dotpromptz-handlebars:** improve PyPI package description ([#487](https://github.com/google/dotprompt/issues/487)) ([b693e6c](https://github.com/google/dotprompt/commit/b693e6c52b19ba746b505c30a705419281e4d8ce))
+
+## [0.1.7](https://github.com/google/dotprompt/compare/dotpromptz-handlebars-0.1.6...dotpromptz-handlebars-0.1.7) (2026-01-30)
+
+
+### Bug Fixes
+
+* **ci:** auto-update lockfiles and label release PRs ([#483](https://github.com/google/dotprompt/issues/483)) ([3ae17e4](https://github.com/google/dotprompt/commit/3ae17e44b9acbd4efe5aab53b30a5c81694cbe4e))
+
+## [0.1.6](https://github.com/google/dotprompt/compare/dotpromptz-handlebars-0.1.5...dotpromptz-handlebars-0.1.6) (2026-01-30)
+
+
+### Bug Fixes
+
+* **handlebarrz:** add toggleable platform flags and Unicode tests ([#481](https://github.com/google/dotprompt/issues/481)) ([7130b4c](https://github.com/google/dotprompt/commit/7130b4ce172bf70513d55417f6bcc309511d83f0))
+
+## [0.1.5](https://github.com/google/dotprompt/compare/dotpromptz-handlebars-0.1.4...dotpromptz-handlebars-0.1.5) (2026-01-30)
+
+
+### Bug Fixes
+
+* **ci:** add RUSTUP_MAX_RETRIES and use native ARM64 runners ([#479](https://github.com/google/dotprompt/issues/479)) ([aefd33a](https://github.com/google/dotprompt/commit/aefd33a7a595ae4fc31a7f1b1f28692d7addc046))
+
+## [0.1.4](https://github.com/google/dotprompt/compare/dotpromptz-handlebars-0.1.3...dotpromptz-handlebars-0.1.4) (2026-01-30)
+
+
+### Features
+
+* **dotpromptz-handlebars:** add package_name function for smoke testing ([#457](https://github.com/google/dotprompt/issues/457)) ([681cc52](https://github.com/google/dotprompt/commit/681cc527dfd2d534ba5e0b6b2d73c52ead267b59))
+* **py:** add bazel build/test support and automate requirements ([#399](https://github.com/google/dotprompt/issues/399)) ([efd7fe0](https://github.com/google/dotprompt/commit/efd7fe0592e2491c34e8fd399e756de375c802eb))
+* **py:** switch to using ty for type checking ([#376](https://github.com/google/dotprompt/issues/376)) ([7f1c026](https://github.com/google/dotprompt/commit/7f1c0268e5de5a2d6d887ac590d110dea7d3ed07))
+
+
+### Bug Fixes
+
+* **dotpromptz-handlebars:** version mismatch in handlebarrz ([#428](https://github.com/google/dotprompt/issues/428)) ([1cf8e01](https://github.com/google/dotprompt/commit/1cf8e019a1c4b94254c5819ceb312df2b8c1e889))
+* **handlebarrz:** correct register_helper type stub signature ([#434](https://github.com/google/dotprompt/issues/434)) ([7bc7e2a](https://github.com/google/dotprompt/commit/7bc7e2a72f792940481fdf180961c7508b3ae389))
+* update package name references to dotpromptz-handlebars ([#403](https://github.com/google/dotprompt/issues/403)) ([8bbd99d](https://github.com/google/dotprompt/commit/8bbd99debe511a5b7327d80aeb40b6a854d57630)), closes [#344](https://github.com/google/dotprompt/issues/344)
+
+## [0.1.3](https://github.com/google/dotprompt/compare/handlebarrz-0.1.2...handlebarrz-0.1.3) (2025-12-12)
+
+
+### Features
+
+* **py:** add support for python 3.14 ([#365](https://github.com/google/dotprompt/issues/365)) ([53db722](https://github.com/google/dotprompt/commit/53db722352d360c9097028d63eb1b7e9576d3d24))
+
+
+### Bug Fixes
+
+* **py/handlebarrz:** remove redundant lock file ([#360](https://github.com/google/dotprompt/issues/360)) ([db5416a](https://github.com/google/dotprompt/commit/db5416a4f7ce508a3d684b7c56ea8a50f46ee65d))
+
+## [0.1.2](https://github.com/google/dotprompt/compare/handlebarrz-0.1.1...handlebarrz-0.1.2) (2025-11-13)
+
+
+### Features
+
+* cargo workspace configuration and bazel build files for hermetic environment ([#257](https://github.com/google/dotprompt/issues/257)) ([aef822e](https://github.com/google/dotprompt/commit/aef822ed484d256ba95a3544e132a9b33e0dc02d))
+* **handlebarrz:** CI to publish rust python package ([#152](https://github.com/google/dotprompt/issues/152)) ([20765d8](https://github.com/google/dotprompt/commit/20765d83c50537cf935fe461a24f5c86d970d787))
+* **handlebarrz:** native ifEquals, unlessEquals, and json helpers ([#121](https://github.com/google/dotprompt/issues/121)) ([e3619e9](https://github.com/google/dotprompt/commit/e3619e906cd0b69d854ca50d798e36cf44c130bd))
+* partial test runner implementation now loads tests ([#139](https://github.com/google/dotprompt/issues/139)) ([b09dd2f](https://github.com/google/dotprompt/commit/b09dd2f9b8029317ce484d6f32d5a3fb89f5f7e1))
+* **py/dotprompt:** render and compile implementations ([#263](https://github.com/google/dotprompt/issues/263)) ([961d0db](https://github.com/google/dotprompt/commit/961d0dbbd9c2ce522252bc3d92f6dde4b7fe9cc1))
+* **py/dotpromptz:** add initial Dotprompt._resolve_partials implementation ([#215](https://github.com/google/dotprompt/issues/215)) ([03a161c](https://github.com/google/dotprompt/commit/03a161c3440a680bc0df472f35efa155fe0d5151))
+* **py/dotpromptz:** configure handlebars to not escape by default ([#163](https://github.com/google/dotprompt/issues/163)) ([f7c33e1](https://github.com/google/dotprompt/commit/f7c33e1303476fd473e803f930ac1e1f9e1d87c9))
+* **py/dotpromptz:** construct test-specific dotprompt instance with partials and partial resolver set up ([#275](https://github.com/google/dotprompt/issues/275)) ([0af9a64](https://github.com/google/dotprompt/commit/0af9a64acf50278bdffda337e19c66fbb97e43a3))
+* **py/dotpromptz:** implement helpers in terms of the rust implementation of handlebars-rust and fix go flakiness ([#115](https://github.com/google/dotprompt/issues/115)) ([314c0b5](https://github.com/google/dotprompt/commit/314c0b5182aaad25bf4cfccb8207faa60f63256f))
+* **py/dotpromptz:** initial bits of Dotprompt class ([#148](https://github.com/google/dotprompt/issues/148)) ([90f7838](https://github.com/google/dotprompt/commit/90f78384a958d41d78dee48497a78dfde11f4476))
+* **py/handlebarrz:** add a Template.compile method to the Python wrapper to make it easier to port the JS implementation ([#201](https://github.com/google/dotprompt/issues/201)) ([9295972](https://github.com/google/dotprompt/commit/92959720fbf2e8ee410d5b8c0c174c6ef464e667))
+* **py/handlebarrz:** Python bindings for handlebars-rust ([#113](https://github.com/google/dotprompt/issues/113)) ([6b6a97e](https://github.com/google/dotprompt/commit/6b6a97e01acc49f53586eb5b8b2b410ae82ce6ce))
+* **py:** local variables support workaround ([#318](https://github.com/google/dotprompt/issues/318)) ([d09598b](https://github.com/google/dotprompt/commit/d09598b969d5dbeaed3ca4136e903b4a2dc80531))
+* python implementations of helpers ([#129](https://github.com/google/dotprompt/issues/129)) ([79c6ef3](https://github.com/google/dotprompt/commit/79c6ef3e9cc472fed3a832c00a1515ceef0981da))
+* **python:** support lower versions of python (>=3.10) ([#187](https://github.com/google/dotprompt/issues/187)) ([4240f9d](https://github.com/google/dotprompt/commit/4240f9d720891e350f9116aa4401ce6ea7fac5a3))
+* use the HEAD version of addlicense ([#280](https://github.com/google/dotprompt/issues/280)) ([bdf0d36](https://github.com/google/dotprompt/commit/bdf0d36a430a363de4163f48394546cba884eaaf))
+* use the more maintained YAML parsing lib at https://github.com/goccy/go-yaml ([#151](https://github.com/google/dotprompt/issues/151)) ([910b3a7](https://github.com/google/dotprompt/commit/910b3a72f3756296c3b01b96936a5bc4c9fa88ef))
+
+
+### Bug Fixes
+
+* change project name for pypi publish ([#200](https://github.com/google/dotprompt/issues/200)) ([2c07132](https://github.com/google/dotprompt/commit/2c0713264fb2c30bdc43f1bd9e51d416f96d1b7e))
+* **docs:** update docs for handlebarrz ([#116](https://github.com/google/dotprompt/issues/116)) ([ce643b1](https://github.com/google/dotprompt/commit/ce643b1f5299ba2a6b214fb57965980d412c1a7b))
+* **handlebarrz:** Compatibility tests for python 3.10 ([#190](https://github.com/google/dotprompt/issues/190)) ([e459e9c](https://github.com/google/dotprompt/commit/e459e9ce94f76d42615593987f99221b0f55a0d3))
+* **license:** add license header to stub types file ([#144](https://github.com/google/dotprompt/issues/144)) ([0abd498](https://github.com/google/dotprompt/commit/0abd49848548f2148a37ec686d703126d8fe8504))
+* **license:** use the full license header in rust source, script files and yaml spec files ([#143](https://github.com/google/dotprompt/issues/143)) ([77ccec9](https://github.com/google/dotprompt/commit/77ccec93a4bf5ccd65932a701676554866e68c6f))
+* **license:** use the full license header in source code ([#142](https://github.com/google/dotprompt/issues/142)) ([64894ef](https://github.com/google/dotprompt/commit/64894ef898876b861c6c244d522f634cd8fcc842))
+* **py/dotpromptz:** address compatibility with python 3.10 and add tox configuration for parallelized tests ([#188](https://github.com/google/dotprompt/issues/188)) ([d2ba21f](https://github.com/google/dotprompt/commit/d2ba21ff3e54f4ca4328b7e574bb6492699095bc))
+* **py/handlebarrz:** helpers support in handlebarrz ([#291](https://github.com/google/dotprompt/issues/291)) ([d5d66a3](https://github.com/google/dotprompt/commit/d5d66a35858a068c2995b82fe54b62f0be4d057f))
+* **scripts:** do not allow running scripts as root; prevent accidental mishaps; update rust checks ([#259](https://github.com/google/dotprompt/issues/259)) ([5cc067d](https://github.com/google/dotprompt/commit/5cc067dc44eaacab2e2dfa387bc79aa3f23d62c8))
+* some lint in the rust code ([#250](https://github.com/google/dotprompt/issues/250)) ([3ef3dd8](https://github.com/google/dotprompt/commit/3ef3dd8ed98c0f5402b22fdba0e852074d2923e7))
+
+## [0.1.1](https://github.com/google/dotprompt/compare/handlebarrz-v0.1.0...handlebarrz-0.1.1) (2025-10-24)
+
+
+### Features
+
+* cargo workspace configuration and bazel build files for hermetic environment ([#257](https://github.com/google/dotprompt/issues/257)) ([aef822e](https://github.com/google/dotprompt/commit/aef822ed484d256ba95a3544e132a9b33e0dc02d))
+* **handlebarrz:** CI to publish rust python package ([#152](https://github.com/google/dotprompt/issues/152)) ([20765d8](https://github.com/google/dotprompt/commit/20765d83c50537cf935fe461a24f5c86d970d787))
+* **handlebarrz:** native ifEquals, unlessEquals, and json helpers ([#121](https://github.com/google/dotprompt/issues/121)) ([e3619e9](https://github.com/google/dotprompt/commit/e3619e906cd0b69d854ca50d798e36cf44c130bd))
+* partial test runner implementation now loads tests ([#139](https://github.com/google/dotprompt/issues/139)) ([b09dd2f](https://github.com/google/dotprompt/commit/b09dd2f9b8029317ce484d6f32d5a3fb89f5f7e1))
+* **py/dotprompt:** render and compile implementations ([#263](https://github.com/google/dotprompt/issues/263)) ([961d0db](https://github.com/google/dotprompt/commit/961d0dbbd9c2ce522252bc3d92f6dde4b7fe9cc1))
+* **py/dotpromptz:** add initial Dotprompt._resolve_partials implementation ([#215](https://github.com/google/dotprompt/issues/215)) ([03a161c](https://github.com/google/dotprompt/commit/03a161c3440a680bc0df472f35efa155fe0d5151))
+* **py/dotpromptz:** configure handlebars to not escape by default ([#163](https://github.com/google/dotprompt/issues/163)) ([f7c33e1](https://github.com/google/dotprompt/commit/f7c33e1303476fd473e803f930ac1e1f9e1d87c9))
+* **py/dotpromptz:** construct test-specific dotprompt instance with partials and partial resolver set up ([#275](https://github.com/google/dotprompt/issues/275)) ([0af9a64](https://github.com/google/dotprompt/commit/0af9a64acf50278bdffda337e19c66fbb97e43a3))
+* **py/dotpromptz:** implement helpers in terms of the rust implementation of handlebars-rust and fix go flakiness ([#115](https://github.com/google/dotprompt/issues/115)) ([314c0b5](https://github.com/google/dotprompt/commit/314c0b5182aaad25bf4cfccb8207faa60f63256f))
+* **py/dotpromptz:** initial bits of Dotprompt class ([#148](https://github.com/google/dotprompt/issues/148)) ([90f7838](https://github.com/google/dotprompt/commit/90f78384a958d41d78dee48497a78dfde11f4476))
+* **py/handlebarrz:** add a Template.compile method to the Python wrapper to make it easier to port the JS implementation ([#201](https://github.com/google/dotprompt/issues/201)) ([9295972](https://github.com/google/dotprompt/commit/92959720fbf2e8ee410d5b8c0c174c6ef464e667))
+* **py/handlebarrz:** Python bindings for handlebars-rust ([#113](https://github.com/google/dotprompt/issues/113)) ([6b6a97e](https://github.com/google/dotprompt/commit/6b6a97e01acc49f53586eb5b8b2b410ae82ce6ce))
+* **py:** local variables support workaround ([#318](https://github.com/google/dotprompt/issues/318)) ([d09598b](https://github.com/google/dotprompt/commit/d09598b969d5dbeaed3ca4136e903b4a2dc80531))
+* python implementations of helpers ([#129](https://github.com/google/dotprompt/issues/129)) ([79c6ef3](https://github.com/google/dotprompt/commit/79c6ef3e9cc472fed3a832c00a1515ceef0981da))
+* **python:** support lower versions of python (>=3.10) ([#187](https://github.com/google/dotprompt/issues/187)) ([4240f9d](https://github.com/google/dotprompt/commit/4240f9d720891e350f9116aa4401ce6ea7fac5a3))
+* use the HEAD version of addlicense ([#280](https://github.com/google/dotprompt/issues/280)) ([bdf0d36](https://github.com/google/dotprompt/commit/bdf0d36a430a363de4163f48394546cba884eaaf))
+* use the more maintained YAML parsing lib at https://github.com/goccy/go-yaml ([#151](https://github.com/google/dotprompt/issues/151)) ([910b3a7](https://github.com/google/dotprompt/commit/910b3a72f3756296c3b01b96936a5bc4c9fa88ef))
+
+
+### Bug Fixes
+
+* change project name for pypi publish ([#200](https://github.com/google/dotprompt/issues/200)) ([2c07132](https://github.com/google/dotprompt/commit/2c0713264fb2c30bdc43f1bd9e51d416f96d1b7e))
+* **docs:** update docs for handlebarrz ([#116](https://github.com/google/dotprompt/issues/116)) ([ce643b1](https://github.com/google/dotprompt/commit/ce643b1f5299ba2a6b214fb57965980d412c1a7b))
+* **handlebarrz:** Compatibility tests for python 3.10 ([#190](https://github.com/google/dotprompt/issues/190)) ([e459e9c](https://github.com/google/dotprompt/commit/e459e9ce94f76d42615593987f99221b0f55a0d3))
+* **license:** add license header to stub types file ([#144](https://github.com/google/dotprompt/issues/144)) ([0abd498](https://github.com/google/dotprompt/commit/0abd49848548f2148a37ec686d703126d8fe8504))
+* **license:** use the full license header in rust source, script files and yaml spec files ([#143](https://github.com/google/dotprompt/issues/143)) ([77ccec9](https://github.com/google/dotprompt/commit/77ccec93a4bf5ccd65932a701676554866e68c6f))
+* **license:** use the full license header in source code ([#142](https://github.com/google/dotprompt/issues/142)) ([64894ef](https://github.com/google/dotprompt/commit/64894ef898876b861c6c244d522f634cd8fcc842))
+* **py/dotpromptz:** address compatibility with python 3.10 and add tox configuration for parallelized tests ([#188](https://github.com/google/dotprompt/issues/188)) ([d2ba21f](https://github.com/google/dotprompt/commit/d2ba21ff3e54f4ca4328b7e574bb6492699095bc))
+* **py/handlebarrz:** helpers support in handlebarrz ([#291](https://github.com/google/dotprompt/issues/291)) ([d5d66a3](https://github.com/google/dotprompt/commit/d5d66a35858a068c2995b82fe54b62f0be4d057f))
+* **scripts:** do not allow running scripts as root; prevent accidental mishaps; update rust checks ([#259](https://github.com/google/dotprompt/issues/259)) ([5cc067d](https://github.com/google/dotprompt/commit/5cc067dc44eaacab2e2dfa387bc79aa3f23d62c8))
+* some lint in the rust code ([#250](https://github.com/google/dotprompt/issues/250)) ([3ef3dd8](https://github.com/google/dotprompt/commit/3ef3dd8ed98c0f5402b22fdba0e852074d2923e7))

dotpromptz_handlebars-0.2.0/PKG-INFO

@@ -0,0 +1,158 @@
+Metadata-Version: 2.5
+Name: dotpromptz-handlebars
+Version: 0.2.0
+Summary: A pure Python implementation of the Handlebars template engine.
+Author: Google
+License-Expression: Apache-2.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Text Processing :: Markup
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# dotpromptz-handlebars
+
+A pure-Python Handlebars implementation, owned by the Genkit team. It implements the subset of Handlebars that [Dotprompt](https://github.com/google/dotprompt) templates use, not the full language.
+
+Dotprompt is language-agnostic. A `.prompt` file should render the same way in every SDK, so what a prompt does is defined by the file, not by the language running it. To keep that true, this package treats Handlebars.js 4.7.9 as the spec. Handlebars has no standalone spec. Handlebars.js is the reference implementation that the other ports follow, so where implementations disagree, Handlebars.js wins. 4.7.9 is the latest Handlebars.js release, and it's what the Dotprompt JS SDK's `^4.7.8` range resolves to on a fresh install. Conformance tests check this package's output against it.
+
+No Rust or Node at runtime.
+
+```
+uv add dotpromptz-handlebars
+```
+
+## Quick start
+
+```python
+from dotpromptz_handlebars import Handlebars
+
+# 1. Compile once
+hb = Handlebars()
+render = hb.compile(
+    'Table for {{party}}. '
+    '{{#if allergies}}Avoid: {{#each allergies}}{{this}}{{#unless @last}}, {{/unless}}{{/each}}.{{/if}}'
+)
+
+# 2. Render many times
+print(render({'party': 4, 'allergies': ['peanuts', 'shellfish']}))
+# => Table for 4. Avoid: peanuts, shellfish.
+
+print(render({'party': 2, 'allergies': []}))
+# => Table for 2.
+```
+
+`compile()` returns a function. Call it with your input dict. Pass `data=` for values the template reads with `@`:
+
+```python
+render = hb.compile('{{name}} / {{@request_id}}')
+print(render({'name': 'Ana'}, data={'request_id': 'r-42'}))
+# => Ana / r-42
+```
+
+## Helpers
+
+A helper is `fn(args, options)`. `args` holds the positional arguments and `options.hash` holds the `key=value` ones.
+
+```python
+def price(args, options):
+    cents = args[0]
+    currency = options.hash.get('currency', 'USD')
+    return f'{cents / 100:.2f} {currency}'
+
+
+hb.register_helper('price', price)
+print(hb.compile('Salmon: {{price cents currency="EUR"}}')({'cents': 1850}))
+# => Salmon: 18.50 EUR
+```
+
+For a block helper (`{{#name}}...{{/name}}`), `options.fn(context)` renders the body and `options.inverse(context)` renders the `{{else}}` body:
+
+```python
+def loud(args, options):
+    return options.fn(options.context).upper()
+
+
+hb.register_helper('loud', loud)
+print(hb.compile('{{#loud}}chef says {{dish}}{{/loud}}')({'dish': 'tartine'}))
+# => CHEF SAYS TARTINE
+```
+
+`options.context` holds the current scope. For backward compatibility with `handlebarrz`, calling `options.context()` returns the dictionary.
+
+Helper output gets escaped like any other value. Return a `SafeString` to insert markup as written. Escaping is then up to you.
+
+`if`, `unless`, `each`, `with`, `lookup`, and `log` are built in. You can't override them with `register_helper`.
+
+## Partials
+
+```python
+hb.register_partial('dish', '- {{name}} ({{price}})\n')
+render = hb.compile('Menu:\n{{#each dishes}}{{> dish}}{{/each}}')
+print(render({'dishes': [{'name': 'Tartine', 'price': 14}, {'name': 'Soup', 'price': 9}]}))
+# => Menu:
+#    - Tartine (14)
+#    - Soup (9)
+```
+
+A missing partial raises. `{{#> name}}fallback{{/name}}` renders the fallback instead. Inline partials (`{{#*inline "name"}}`) and dynamic partials (`{{> (helperName)}}`) work too.
+
+## Escaping
+
+`{{value}}` HTML-escapes by default. `{{{value}}}` doesn't.
+
+```python
+render = Handlebars().compile('{{note}} | {{{note}}}')
+print(render({'note': 'Fish & <b>Chips</b>'}))
+# => Fish &amp; &lt;b&gt;Chips&lt;/b&gt; | Fish & <b>Chips</b>
+```
+
+Prompts usually go to a model, not a browser. To turn escaping off everywhere, use `Handlebars(escape_html=False)`.
+
+## Strict mode
+
+`Handlebars(strict=True)` raises when the template prints a path that isn't in the input:
+
+```python
+from dotpromptz_handlebars import Handlebars, StrictModeError
+
+try:
+    Handlebars(strict=True).compile('Hello {{user.name}}')({'user': {}})
+except StrictModeError as err:
+    print(err.path)
+# => user.name
+```
+
+Conditions don't raise. `{{#if user.name}}` on a missing path takes the else branch.
+
+## Values that surprise Python developers
+
+Dotprompt defines what a template means, independent of the language that renders it. Dotprompt templates use Handlebars semantics, and this package takes them from Handlebars.js 4.7.9. Conditionals and printed values follow those semantics, not Python's `bool()` or `str()`:
+
+- `0` fails `{{#if}}` but enters `{{#with}}`. Use `{{#if n includeZero=true}}` to keep `0`.
+- `{}` enters `{{#if}}`. `{{#if}}` takes the else branch only for a missing key, `None`, `False`, `""`, `0`, or `[]`.
+- Lists print as `1,2` and dicts print as `[object Object]`. Format structured data with a helper. Dotprompt ships `{{json value}}` for this.
+- `1.0` prints as `1`, and `False` prints as `false`.
+
+## What's not supported
+
+These raise `ValueError`:
+
+- Decorators (`{{* name}}`).
+- Functions in the input dict. Register them with `register_helper`, so a template can only call code you chose.
+- Broken templates. Which templates fail matches Handlebars.js, but the error messages are worded differently.
+
+Everything else a prompt uses is supported:
+- **Paths:** `user.name`, `../name`, `items.[0]`
+- **Blocks:** `if`, `unless`, `each`, `with`, with `else` and `else if`
+- **Block parameters:** `as |item index|`
+- **Data:** `@index`, `@key`, `@first`, `@last`, `@root`
+- **Syntax:** subexpressions, comments, `~` whitespace control, and raw blocks (`{{{{raw}}}}`)

dotpromptz_handlebars-0.2.0/README.md

@@ -0,0 +1,138 @@
+# dotpromptz-handlebars
+
+A pure-Python Handlebars implementation, owned by the Genkit team. It implements the subset of Handlebars that [Dotprompt](https://github.com/google/dotprompt) templates use, not the full language.
+
+Dotprompt is language-agnostic. A `.prompt` file should render the same way in every SDK, so what a prompt does is defined by the file, not by the language running it. To keep that true, this package treats Handlebars.js 4.7.9 as the spec. Handlebars has no standalone spec. Handlebars.js is the reference implementation that the other ports follow, so where implementations disagree, Handlebars.js wins. 4.7.9 is the latest Handlebars.js release, and it's what the Dotprompt JS SDK's `^4.7.8` range resolves to on a fresh install. Conformance tests check this package's output against it.
+
+No Rust or Node at runtime.
+
+```
+uv add dotpromptz-handlebars
+```
+
+## Quick start
+
+```python
+from dotpromptz_handlebars import Handlebars
+
+# 1. Compile once
+hb = Handlebars()
+render = hb.compile(
+    'Table for {{party}}. '
+    '{{#if allergies}}Avoid: {{#each allergies}}{{this}}{{#unless @last}}, {{/unless}}{{/each}}.{{/if}}'
+)
+
+# 2. Render many times
+print(render({'party': 4, 'allergies': ['peanuts', 'shellfish']}))
+# => Table for 4. Avoid: peanuts, shellfish.
+
+print(render({'party': 2, 'allergies': []}))
+# => Table for 2.
+```
+
+`compile()` returns a function. Call it with your input dict. Pass `data=` for values the template reads with `@`:
+
+```python
+render = hb.compile('{{name}} / {{@request_id}}')
+print(render({'name': 'Ana'}, data={'request_id': 'r-42'}))
+# => Ana / r-42
+```
+
+## Helpers
+
+A helper is `fn(args, options)`. `args` holds the positional arguments and `options.hash` holds the `key=value` ones.
+
+```python
+def price(args, options):
+    cents = args[0]
+    currency = options.hash.get('currency', 'USD')
+    return f'{cents / 100:.2f} {currency}'
+
+
+hb.register_helper('price', price)
+print(hb.compile('Salmon: {{price cents currency="EUR"}}')({'cents': 1850}))
+# => Salmon: 18.50 EUR
+```
+
+For a block helper (`{{#name}}...{{/name}}`), `options.fn(context)` renders the body and `options.inverse(context)` renders the `{{else}}` body:
+
+```python
+def loud(args, options):
+    return options.fn(options.context).upper()
+
+
+hb.register_helper('loud', loud)
+print(hb.compile('{{#loud}}chef says {{dish}}{{/loud}}')({'dish': 'tartine'}))
+# => CHEF SAYS TARTINE
+```
+
+`options.context` holds the current scope. For backward compatibility with `handlebarrz`, calling `options.context()` returns the dictionary.
+
+Helper output gets escaped like any other value. Return a `SafeString` to insert markup as written. Escaping is then up to you.
+
+`if`, `unless`, `each`, `with`, `lookup`, and `log` are built in. You can't override them with `register_helper`.
+
+## Partials
+
+```python
+hb.register_partial('dish', '- {{name}} ({{price}})\n')
+render = hb.compile('Menu:\n{{#each dishes}}{{> dish}}{{/each}}')
+print(render({'dishes': [{'name': 'Tartine', 'price': 14}, {'name': 'Soup', 'price': 9}]}))
+# => Menu:
+#    - Tartine (14)
+#    - Soup (9)
+```
+
+A missing partial raises. `{{#> name}}fallback{{/name}}` renders the fallback instead. Inline partials (`{{#*inline "name"}}`) and dynamic partials (`{{> (helperName)}}`) work too.
+
+## Escaping
+
+`{{value}}` HTML-escapes by default. `{{{value}}}` doesn't.
+
+```python
+render = Handlebars().compile('{{note}} | {{{note}}}')
+print(render({'note': 'Fish & <b>Chips</b>'}))
+# => Fish &amp; &lt;b&gt;Chips&lt;/b&gt; | Fish & <b>Chips</b>
+```
+
+Prompts usually go to a model, not a browser. To turn escaping off everywhere, use `Handlebars(escape_html=False)`.
+
+## Strict mode
+
+`Handlebars(strict=True)` raises when the template prints a path that isn't in the input:
+
+```python
+from dotpromptz_handlebars import Handlebars, StrictModeError
+
+try:
+    Handlebars(strict=True).compile('Hello {{user.name}}')({'user': {}})
+except StrictModeError as err:
+    print(err.path)
+# => user.name
+```
+
+Conditions don't raise. `{{#if user.name}}` on a missing path takes the else branch.
+
+## Values that surprise Python developers
+
+Dotprompt defines what a template means, independent of the language that renders it. Dotprompt templates use Handlebars semantics, and this package takes them from Handlebars.js 4.7.9. Conditionals and printed values follow those semantics, not Python's `bool()` or `str()`:
+
+- `0` fails `{{#if}}` but enters `{{#with}}`. Use `{{#if n includeZero=true}}` to keep `0`.
+- `{}` enters `{{#if}}`. `{{#if}}` takes the else branch only for a missing key, `None`, `False`, `""`, `0`, or `[]`.
+- Lists print as `1,2` and dicts print as `[object Object]`. Format structured data with a helper. Dotprompt ships `{{json value}}` for this.
+- `1.0` prints as `1`, and `False` prints as `false`.
+
+## What's not supported
+
+These raise `ValueError`:
+
+- Decorators (`{{* name}}`).
+- Functions in the input dict. Register them with `register_helper`, so a template can only call code you chose.
+- Broken templates. Which templates fail matches Handlebars.js, but the error messages are worded differently.
+
+Everything else a prompt uses is supported:
+- **Paths:** `user.name`, `../name`, `items.[0]`
+- **Blocks:** `if`, `unless`, `each`, `with`, with `else` and `else if`
+- **Block parameters:** `as |item index|`
+- **Data:** `@index`, `@key`, `@first`, `@last`, `@root`
+- **Syntax:** subexpressions, comments, `~` whitespace control, and raw blocks (`{{{{raw}}}}`)

dotpromptz_handlebars-0.2.0/dotpromptz_handlebars/__init__.py

@@ -0,0 +1,67 @@
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# SPDX-License-Identifier: Apache-2.0
+
+"""A pure Python Handlebars template engine."""
+
+from dotpromptz_handlebars._compiler import (
+    EscapeFunction,
+    Handlebars,
+    HelperFn,
+    RuntimeOptions,
+)
+from dotpromptz_handlebars._render import StrictModeError
+from dotpromptz_handlebars._types import (
+    Block,
+    BlockFn,
+    Context,
+    ContextDict,
+    ElseNode,
+    HelperOptions,
+    InlinePartial,
+    Mustache,
+    Node,
+    Partial,
+    PartialBlock,
+    Program,
+    SafeString,
+    TagToken,
+    TemplateRecursionError,
+    Text,
+)
+
+__all__ = [
+    'Block',
+    'BlockFn',
+    'Context',
+    'ContextDict',
+    'ElseNode',
+    'EscapeFunction',
+    'Handlebars',
+    'HelperFn',
+    'HelperOptions',
+    'InlinePartial',
+    'Mustache',
+    'Node',
+    'Partial',
+    'PartialBlock',
+    'Program',
+    'RuntimeOptions',
+    'SafeString',
+    'StrictModeError',
+    'TagToken',
+    'TemplateRecursionError',
+    'Text',
+]