dotpromptz 0.1.2__tar.gz

dotpromptz-0.1.2/.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-0.1.2/CHANGELOG.md

@@ -0,0 +1,167 @@
+# Changelog
+
+## [0.1.2](https://github.com/google/dotprompt/compare/dotpromptz-0.1.1...dotpromptz-0.1.2) (2025-10-29)
+
+
+### Features
+
+* add implementation of helpers and util modules; move interfaces into dotpromptz project ([#73](https://github.com/google/dotprompt/issues/73)) ([8c7aea1](https://github.com/google/dotprompt/commit/8c7aea1faffaf823d01b132e55cb175a4fca5ccb))
+* add stub spec_test.py and script to monitor tests. ([#138](https://github.com/google/dotprompt/issues/138)) ([65966e9](https://github.com/google/dotprompt/commit/65966e9bfc077e85d0b83d04d0384150470dbfd3))
+* **go/parse:** parse.go implementation [#62](https://github.com/google/dotprompt/issues/62) ([#87](https://github.com/google/dotprompt/issues/87)) ([d5dc13c](https://github.com/google/dotprompt/commit/d5dc13c0bf0437875a3b133511ffed474a8b3bf9))
+* parseDocument python ([#80](https://github.com/google/dotprompt/issues/80)) ([82ebc36](https://github.com/google/dotprompt/commit/82ebc3672e8de051dfbdd92968ed3f84c79a247f))
+* partial test runner implementation now loads tests ([#139](https://github.com/google/dotprompt/issues/139)) ([b09dd2f](https://github.com/google/dotprompt/commit/b09dd2f9b8029317ce484d6f32d5a3fb89f5f7e1))
+* Port JS types to Python  ([#65](https://github.com/google/dotprompt/issues/65)) ([edcb037](https://github.com/google/dotprompt/commit/edcb03765f3cb6e5743d107a35cf255a60ab0369))
+* **py/dotprompt:** render and compile implementations ([#263](https://github.com/google/dotprompt/issues/263)) ([961d0db](https://github.com/google/dotprompt/commit/961d0dbbd9c2ce522252bc3d92f6dde4b7fe9cc1))
+* **py/dotpromptz:** _resolve_metadata for dotprompt ([#226](https://github.com/google/dotprompt/issues/226)) ([cfcc87b](https://github.com/google/dotprompt/commit/cfcc87b57e49785c2356b03fbc5b7bf773472683))
+* **py/dotpromptz:** add initial Dotprompt._resolve_json_schema implementation ([#217](https://github.com/google/dotprompt/issues/217)) ([0b62136](https://github.com/google/dotprompt/commit/0b621363a394c6b5c0fac6a957098eccff6891ca))
+* **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:** add initial Dotprompt._resolve_tools implementation and raise ValueError when resolver is None ([#214](https://github.com/google/dotprompt/issues/214)) ([57caf5d](https://github.com/google/dotprompt/commit/57caf5d9a9f4fe720c67f99fd10439d5ebe434dc))
+* **py/dotpromptz:** add resolve_json_schema and test case for ResolverCallable that returns an asyncio.Future ([#211](https://github.com/google/dotprompt/issues/211)) ([7bbe80d](https://github.com/google/dotprompt/commit/7bbe80d6a1d9dc18c4d1baacfccf2f33fc8b7e26))
+* **py/dotpromptz:** add resolvers module ([#207](https://github.com/google/dotprompt/issues/207)) ([826f257](https://github.com/google/dotprompt/commit/826f2572e710cebd0138bd757d2bef2e4898d730))
+* **py/dotpromptz:** because the Picoschema parser can resolve schemas at runtime, we make it an async implementation ([#220](https://github.com/google/dotprompt/issues/220)) ([ae285a8](https://github.com/google/dotprompt/commit/ae285a88f3502e0a02c85d04c49c2e2e6ef88766))
+* **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:** directory-based async and sync implementations of PromptStore and PromptStoreWritable ([#164](https://github.com/google/dotprompt/issues/164)) ([ac92fbf](https://github.com/google/dotprompt/commit/ac92fbf3af7ac3207102c94c20d294d8c54b9dd4))
+* **py/dotpromptz:** Dotprompt.{render|compile} with CompileRenderer stub ([#248](https://github.com/google/dotprompt/issues/248)) ([61c578c](https://github.com/google/dotprompt/commit/61c578cf43ac490f8076306a8e2b5eb0ae15f385))
+* **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/dotpromptz:** render_metadata implementation and associated tests ([#229](https://github.com/google/dotprompt/issues/229)) ([e66dc45](https://github.com/google/dotprompt/commit/e66dc453c718222e1633be951923a35335296dd5))
+* **py/dotpromptz:** simpler spec test runner harness ([#266](https://github.com/google/dotprompt/issues/266)) ([89378bf](https://github.com/google/dotprompt/commit/89378bfded004f3b246c90f6474c2fb972037956))
+* **py/dotpromptz:** test harness that creates suites and test case methods dynamically ([#279](https://github.com/google/dotprompt/issues/279)) ([1dc2bda](https://github.com/google/dotprompt/commit/1dc2bdac5de513cb41d32905d20069ab29307a72))
+* **py/dotpromptz:** translate render_metadata for dotprompt.py from ts ([#227](https://github.com/google/dotprompt/issues/227)) ([ae1919b](https://github.com/google/dotprompt/commit/ae1919b3457824241c734fdf8328f61279fb6710))
+* **py/dotpromptz:** use async picoschema_to_json_schema in dotprompt._render_picoschema ([#221](https://github.com/google/dotprompt/issues/221)) ([072d95d](https://github.com/google/dotprompt/commit/072d95deb01d9b09a7f60d9f6b3fb53a8067e497))
+* **py:** add SafeString implementation that works with js2py ([#104](https://github.com/google/dotprompt/issues/104)) ([1ebeca3](https://github.com/google/dotprompt/commit/1ebeca3976faf2dc91d8d7f4a74c218824aac353))
+* **py:** fix picoschema spec test ([#303](https://github.com/google/dotprompt/issues/303)) ([73439c1](https://github.com/google/dotprompt/commit/73439c183f557d7bb67b9cbc060e5602c219fc68))
+* **py:** implement identify_partials in terms of regexps since we do not have an AST to walk [#90](https://github.com/google/dotprompt/issues/90) ([#150](https://github.com/google/dotprompt/issues/150)) ([f802275](https://github.com/google/dotprompt/commit/f8022755d7eef716bbb54dd08a2c3a061250d393))
+* **py:** implementation of parse.py; refactor parse.ts and update tests. ([#79](https://github.com/google/dotprompt/issues/79)) ([47e7245](https://github.com/google/dotprompt/commit/47e7245c0aae710b102178019d1f3449c2f1af66))
+* **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: implement spec test logic ([#285](https://github.com/google/dotprompt/issues/285)) ([944f1fe](https://github.com/google/dotprompt/commit/944f1fee3e0e1f4f8bcd3c9bc4f6104ffbe17f2c))
+* python: picoschema support  ISSUE: [#36](https://github.com/google/dotprompt/issues/36)  CHANGELOG: - [x] Port relevant functionality - [x] Add tests ([#95](https://github.com/google/dotprompt/issues/95)) ([0da188c](https://github.com/google/dotprompt/commit/0da188c52540f041309e39fa6bc798eaf7fd7a81))
+* **python:** add OpenAI adapter implementation for dotprompt [#38](https://github.com/google/dotprompt/issues/38) ([#97](https://github.com/google/dotprompt/issues/97)) ([d171f87](https://github.com/google/dotprompt/commit/d171f8792ecf08f446e18ea3bbd5309cafa1d8a3))
+* **python:** support lower versions of python (>=3.10) ([#187](https://github.com/google/dotprompt/issues/187)) ([4240f9d](https://github.com/google/dotprompt/commit/4240f9d720891e350f9116aa4401ce6ea7fac5a3))
+* **py:** utility function to unquote a string literal coming from js2py handlebars helpers ([#107](https://github.com/google/dotprompt/issues/107)) ([b3672ca](https://github.com/google/dotprompt/commit/b3672ca6192de4895585b28b8bbd301f8294090f))
+* **py:** utility to remove undefined fields from dicts/lists recursively ([#105](https://github.com/google/dotprompt/issues/105)) ([d25c911](https://github.com/google/dotprompt/commit/d25c911bc1e84e5691b961a4c38a8bcd73c80aa0))
+* use the HEAD version of addlicense ([#280](https://github.com/google/dotprompt/issues/280)) ([bdf0d36](https://github.com/google/dotprompt/commit/bdf0d36a430a363de4163f48394546cba884eaaf))
+
+
+### 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:** add documentation explaining yaml spec test format and revert typo ([#267](https://github.com/google/dotprompt/issues/267)) ([20cd71b](https://github.com/google/dotprompt/commit/20cd71bd68c9ec28de7264a72d495ff636e62cff))
+* **docs:** update docs for helpers.py functions ([#118](https://github.com/google/dotprompt/issues/118)) ([40f74d4](https://github.com/google/dotprompt/commit/40f74d4cf75a47d8b7f9f85801a1bb5969bae082))
+* **docs:** update helper docs ([#132](https://github.com/google/dotprompt/issues/132)) ([9b84245](https://github.com/google/dotprompt/commit/9b842459e8faa5f4afe7d389deb6c351ab1271be))
+* **go,py:** type fixes and ensure we build/lint the go code in hooks and ci ([#83](https://github.com/google/dotprompt/issues/83)) ([19a8257](https://github.com/google/dotprompt/commit/19a8257f4f73b776229d5324a0366fd9a79c20aa))
+* **helpers:** use ctx instead of hash to get the fn and inverse ([#131](https://github.com/google/dotprompt/issues/131)) ([8749d1f](https://github.com/google/dotprompt/commit/8749d1f78ee754742ae7fcc9247854021178bdbc))
+* **js:** clean up redundant call to register helpers that have already been registered ([#261](https://github.com/google/dotprompt/issues/261)) ([84e3c0c](https://github.com/google/dotprompt/commit/84e3c0cfd8da3b0292eebb2fe8a771fe41d09038))
+* **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:** add todo about caching resolved schema for later ([#223](https://github.com/google/dotprompt/issues/223)) ([728dbaa](https://github.com/google/dotprompt/commit/728dbaaef1d0569148426a97242edd1f8064cdbe))
+* **py/dotpromptz:** add unit tests for resolver and fix sync resolver error handling ([#208](https://github.com/google/dotprompt/issues/208)) ([5e04e28](https://github.com/google/dotprompt/commit/5e04e28c99eff0f83c9c8a15df5ef56ff3ebd85f))
+* **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/dotpromptz:** dotprompt.define_tool takes just a tool def ([#224](https://github.com/google/dotprompt/issues/224)) ([72039fc](https://github.com/google/dotprompt/commit/72039fc689d82344bfc1300345059340603404bc))
+* **py/dotpromptz:** ensure parser handles {CR, CRLF, LF} line endings ([#256](https://github.com/google/dotprompt/issues/256)) ([18cff7a](https://github.com/google/dotprompt/commit/18cff7af50860c46fb37a2fa9c373bd410f11701))
+* **py/dotpromptz:** fix broken picoschema parser tests ([#232](https://github.com/google/dotprompt/issues/232)) ([4d154aa](https://github.com/google/dotprompt/commit/4d154aaae99f2f31500d86ed6191a05298700b91))
+* **py/dotpromptz:** fix pydantic warnings and tabulate the various types in typing.py ([#196](https://github.com/google/dotprompt/issues/196)) ([24dcfdd](https://github.com/google/dotprompt/commit/24dcfdd320884452ee48fca859619b400fe61327))
+* **py/dotpromptz:** make resolver concrete in resolve, resolve_tool, and resolve_partial ([#210](https://github.com/google/dotprompt/issues/210)) ([3730190](https://github.com/google/dotprompt/commit/37301903c8f26f1b8363ad1f2d515a6df19303e2))
+* **py/dotpromptz:** register initial helpers and partials correctly ([#260](https://github.com/google/dotprompt/issues/260)) ([0752865](https://github.com/google/dotprompt/commit/0752865b415c6cc90c87e3113b537632a52e3423))
+* **py/dotpromptz:** registering partials and start rendering some specs ([#269](https://github.com/google/dotprompt/issues/269)) ([aff3c4b](https://github.com/google/dotprompt/commit/aff3c4b9ee548e61268ca070f6660d51c860619d))
+* **py/dotpromptz:** remove stray reference to inspect.isasyncgenfunction since we dont deal with those as resolvers ([#216](https://github.com/google/dotprompt/issues/216)) ([c300515](https://github.com/google/dotprompt/commit/c3005159aea0af906e3f704d03fd5859a9540d4f))
+* **py/dotpromptz:** remove unused Options type from dotprompt.py and fix typo ([#213](https://github.com/google/dotprompt/issues/213)) ([ae59431](https://github.com/google/dotprompt/commit/ae5943179e77aa6fa775d092254d8adf21b06eb2))
+* **py/dotpromptz:** some lint and add docstrings ([#235](https://github.com/google/dotprompt/issues/235)) ([2e1c893](https://github.com/google/dotprompt/commit/2e1c893bbbe7c29480d67e2d693db90e9bef9b1b))
+* **py/handlebarrz:** helpers support in handlebarrz ([#291](https://github.com/google/dotprompt/issues/291)) ([d5d66a3](https://github.com/google/dotprompt/commit/d5d66a35858a068c2995b82fe54b62f0be4d057f))
+* **py/spec_test:** hex-encoded SHA-256 digest rather than base64-encoded SHA-256 digest for module IDs ([#140](https://github.com/google/dotprompt/issues/140)) ([796c644](https://github.com/google/dotprompt/commit/796c6442a3c1836de2170c466966382a0577a940))
+* **py:** lint reporting missing docstrings in test files ([#199](https://github.com/google/dotprompt/issues/199)) ([4d91514](https://github.com/google/dotprompt/commit/4d9151468ddd13f334454701daae42d5717d4dcf))
+* **py:** metadata purpose support ([#296](https://github.com/google/dotprompt/issues/296)) ([4a0f436](https://github.com/google/dotprompt/commit/4a0f436f1420f738d4fb46a4e5f41129929fb0fd))
+* remove spurious role type `assistant` ([#169](https://github.com/google/dotprompt/issues/169)) ([1b5142c](https://github.com/google/dotprompt/commit/1b5142c4a7ad20ef722d438cefa0b93a82d7adbb))
+
+
+### Documentation
+
+* add initial mkdocs documentation for eng [#43](https://github.com/google/dotprompt/issues/43) ([#44](https://github.com/google/dotprompt/issues/44)) ([31be336](https://github.com/google/dotprompt/commit/31be336d14899acf7ea1cefb4b782f5b2d1c31d1))
+* **py/dotpromptz:** document awaitable type hierarchy as ASCII diagram in comments to make code readable ([#212](https://github.com/google/dotprompt/issues/212)) ([0926749](https://github.com/google/dotprompt/commit/0926749e72d17264b8078151b10f616a906cfd66))
+* **py:** add docstring to parse.py and dotprompt.py modules. ([#246](https://github.com/google/dotprompt/issues/246)) ([c9d53bb](https://github.com/google/dotprompt/commit/c9d53bb3cad96f9d8ef5778ada93ee65276afa09))
+* **py:** add documentation for the resolvers module ([#209](https://github.com/google/dotprompt/issues/209)) ([04b6691](https://github.com/google/dotprompt/commit/04b6691227ef5b01ebf5261d4846a3ba7e723ab2))
+* **py:** ascii diagrams to explain the relationships between the types for easy visualization ([#197](https://github.com/google/dotprompt/issues/197)) ([6d775c4](https://github.com/google/dotprompt/commit/6d775c4bf1301c63d111b0d45db53dba61117555))
+
+## [0.1.1](https://github.com/google/dotprompt/compare/dotpromptz-v0.1.0...dotpromptz-0.1.1) (2025-10-24)
+
+
+### Features
+
+* add implementation of helpers and util modules; move interfaces into dotpromptz project ([#73](https://github.com/google/dotprompt/issues/73)) ([8c7aea1](https://github.com/google/dotprompt/commit/8c7aea1faffaf823d01b132e55cb175a4fca5ccb))
+* add stub spec_test.py and script to monitor tests. ([#138](https://github.com/google/dotprompt/issues/138)) ([65966e9](https://github.com/google/dotprompt/commit/65966e9bfc077e85d0b83d04d0384150470dbfd3))
+* **go/parse:** parse.go implementation [#62](https://github.com/google/dotprompt/issues/62) ([#87](https://github.com/google/dotprompt/issues/87)) ([d5dc13c](https://github.com/google/dotprompt/commit/d5dc13c0bf0437875a3b133511ffed474a8b3bf9))
+* parseDocument python ([#80](https://github.com/google/dotprompt/issues/80)) ([82ebc36](https://github.com/google/dotprompt/commit/82ebc3672e8de051dfbdd92968ed3f84c79a247f))
+* partial test runner implementation now loads tests ([#139](https://github.com/google/dotprompt/issues/139)) ([b09dd2f](https://github.com/google/dotprompt/commit/b09dd2f9b8029317ce484d6f32d5a3fb89f5f7e1))
+* Port JS types to Python  ([#65](https://github.com/google/dotprompt/issues/65)) ([edcb037](https://github.com/google/dotprompt/commit/edcb03765f3cb6e5743d107a35cf255a60ab0369))
+* **py/dotprompt:** render and compile implementations ([#263](https://github.com/google/dotprompt/issues/263)) ([961d0db](https://github.com/google/dotprompt/commit/961d0dbbd9c2ce522252bc3d92f6dde4b7fe9cc1))
+* **py/dotpromptz:** _resolve_metadata for dotprompt ([#226](https://github.com/google/dotprompt/issues/226)) ([cfcc87b](https://github.com/google/dotprompt/commit/cfcc87b57e49785c2356b03fbc5b7bf773472683))
+* **py/dotpromptz:** add initial Dotprompt._resolve_json_schema implementation ([#217](https://github.com/google/dotprompt/issues/217)) ([0b62136](https://github.com/google/dotprompt/commit/0b621363a394c6b5c0fac6a957098eccff6891ca))
+* **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:** add initial Dotprompt._resolve_tools implementation and raise ValueError when resolver is None ([#214](https://github.com/google/dotprompt/issues/214)) ([57caf5d](https://github.com/google/dotprompt/commit/57caf5d9a9f4fe720c67f99fd10439d5ebe434dc))
+* **py/dotpromptz:** add resolve_json_schema and test case for ResolverCallable that returns an asyncio.Future ([#211](https://github.com/google/dotprompt/issues/211)) ([7bbe80d](https://github.com/google/dotprompt/commit/7bbe80d6a1d9dc18c4d1baacfccf2f33fc8b7e26))
+* **py/dotpromptz:** add resolvers module ([#207](https://github.com/google/dotprompt/issues/207)) ([826f257](https://github.com/google/dotprompt/commit/826f2572e710cebd0138bd757d2bef2e4898d730))
+* **py/dotpromptz:** because the Picoschema parser can resolve schemas at runtime, we make it an async implementation ([#220](https://github.com/google/dotprompt/issues/220)) ([ae285a8](https://github.com/google/dotprompt/commit/ae285a88f3502e0a02c85d04c49c2e2e6ef88766))
+* **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:** directory-based async and sync implementations of PromptStore and PromptStoreWritable ([#164](https://github.com/google/dotprompt/issues/164)) ([ac92fbf](https://github.com/google/dotprompt/commit/ac92fbf3af7ac3207102c94c20d294d8c54b9dd4))
+* **py/dotpromptz:** Dotprompt.{render|compile} with CompileRenderer stub ([#248](https://github.com/google/dotprompt/issues/248)) ([61c578c](https://github.com/google/dotprompt/commit/61c578cf43ac490f8076306a8e2b5eb0ae15f385))
+* **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/dotpromptz:** render_metadata implementation and associated tests ([#229](https://github.com/google/dotprompt/issues/229)) ([e66dc45](https://github.com/google/dotprompt/commit/e66dc453c718222e1633be951923a35335296dd5))
+* **py/dotpromptz:** simpler spec test runner harness ([#266](https://github.com/google/dotprompt/issues/266)) ([89378bf](https://github.com/google/dotprompt/commit/89378bfded004f3b246c90f6474c2fb972037956))
+* **py/dotpromptz:** test harness that creates suites and test case methods dynamically ([#279](https://github.com/google/dotprompt/issues/279)) ([1dc2bda](https://github.com/google/dotprompt/commit/1dc2bdac5de513cb41d32905d20069ab29307a72))
+* **py/dotpromptz:** translate render_metadata for dotprompt.py from ts ([#227](https://github.com/google/dotprompt/issues/227)) ([ae1919b](https://github.com/google/dotprompt/commit/ae1919b3457824241c734fdf8328f61279fb6710))
+* **py/dotpromptz:** use async picoschema_to_json_schema in dotprompt._render_picoschema ([#221](https://github.com/google/dotprompt/issues/221)) ([072d95d](https://github.com/google/dotprompt/commit/072d95deb01d9b09a7f60d9f6b3fb53a8067e497))
+* **py:** add SafeString implementation that works with js2py ([#104](https://github.com/google/dotprompt/issues/104)) ([1ebeca3](https://github.com/google/dotprompt/commit/1ebeca3976faf2dc91d8d7f4a74c218824aac353))
+* **py:** fix picoschema spec test ([#303](https://github.com/google/dotprompt/issues/303)) ([73439c1](https://github.com/google/dotprompt/commit/73439c183f557d7bb67b9cbc060e5602c219fc68))
+* **py:** implement identify_partials in terms of regexps since we do not have an AST to walk [#90](https://github.com/google/dotprompt/issues/90) ([#150](https://github.com/google/dotprompt/issues/150)) ([f802275](https://github.com/google/dotprompt/commit/f8022755d7eef716bbb54dd08a2c3a061250d393))
+* **py:** implementation of parse.py; refactor parse.ts and update tests. ([#79](https://github.com/google/dotprompt/issues/79)) ([47e7245](https://github.com/google/dotprompt/commit/47e7245c0aae710b102178019d1f3449c2f1af66))
+* **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: implement spec test logic ([#285](https://github.com/google/dotprompt/issues/285)) ([944f1fe](https://github.com/google/dotprompt/commit/944f1fee3e0e1f4f8bcd3c9bc4f6104ffbe17f2c))
+* python: picoschema support  ISSUE: [#36](https://github.com/google/dotprompt/issues/36)  CHANGELOG: - [x] Port relevant functionality - [x] Add tests ([#95](https://github.com/google/dotprompt/issues/95)) ([0da188c](https://github.com/google/dotprompt/commit/0da188c52540f041309e39fa6bc798eaf7fd7a81))
+* **python:** add OpenAI adapter implementation for dotprompt [#38](https://github.com/google/dotprompt/issues/38) ([#97](https://github.com/google/dotprompt/issues/97)) ([d171f87](https://github.com/google/dotprompt/commit/d171f8792ecf08f446e18ea3bbd5309cafa1d8a3))
+* **python:** support lower versions of python (>=3.10) ([#187](https://github.com/google/dotprompt/issues/187)) ([4240f9d](https://github.com/google/dotprompt/commit/4240f9d720891e350f9116aa4401ce6ea7fac5a3))
+* **py:** utility function to unquote a string literal coming from js2py handlebars helpers ([#107](https://github.com/google/dotprompt/issues/107)) ([b3672ca](https://github.com/google/dotprompt/commit/b3672ca6192de4895585b28b8bbd301f8294090f))
+* **py:** utility to remove undefined fields from dicts/lists recursively ([#105](https://github.com/google/dotprompt/issues/105)) ([d25c911](https://github.com/google/dotprompt/commit/d25c911bc1e84e5691b961a4c38a8bcd73c80aa0))
+* use the HEAD version of addlicense ([#280](https://github.com/google/dotprompt/issues/280)) ([bdf0d36](https://github.com/google/dotprompt/commit/bdf0d36a430a363de4163f48394546cba884eaaf))
+
+
+### 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:** add documentation explaining yaml spec test format and revert typo ([#267](https://github.com/google/dotprompt/issues/267)) ([20cd71b](https://github.com/google/dotprompt/commit/20cd71bd68c9ec28de7264a72d495ff636e62cff))
+* **docs:** update docs for helpers.py functions ([#118](https://github.com/google/dotprompt/issues/118)) ([40f74d4](https://github.com/google/dotprompt/commit/40f74d4cf75a47d8b7f9f85801a1bb5969bae082))
+* **docs:** update helper docs ([#132](https://github.com/google/dotprompt/issues/132)) ([9b84245](https://github.com/google/dotprompt/commit/9b842459e8faa5f4afe7d389deb6c351ab1271be))
+* **go,py:** type fixes and ensure we build/lint the go code in hooks and ci ([#83](https://github.com/google/dotprompt/issues/83)) ([19a8257](https://github.com/google/dotprompt/commit/19a8257f4f73b776229d5324a0366fd9a79c20aa))
+* **helpers:** use ctx instead of hash to get the fn and inverse ([#131](https://github.com/google/dotprompt/issues/131)) ([8749d1f](https://github.com/google/dotprompt/commit/8749d1f78ee754742ae7fcc9247854021178bdbc))
+* **js:** clean up redundant call to register helpers that have already been registered ([#261](https://github.com/google/dotprompt/issues/261)) ([84e3c0c](https://github.com/google/dotprompt/commit/84e3c0cfd8da3b0292eebb2fe8a771fe41d09038))
+* **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:** add todo about caching resolved schema for later ([#223](https://github.com/google/dotprompt/issues/223)) ([728dbaa](https://github.com/google/dotprompt/commit/728dbaaef1d0569148426a97242edd1f8064cdbe))
+* **py/dotpromptz:** add unit tests for resolver and fix sync resolver error handling ([#208](https://github.com/google/dotprompt/issues/208)) ([5e04e28](https://github.com/google/dotprompt/commit/5e04e28c99eff0f83c9c8a15df5ef56ff3ebd85f))
+* **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/dotpromptz:** dotprompt.define_tool takes just a tool def ([#224](https://github.com/google/dotprompt/issues/224)) ([72039fc](https://github.com/google/dotprompt/commit/72039fc689d82344bfc1300345059340603404bc))
+* **py/dotpromptz:** ensure parser handles {CR, CRLF, LF} line endings ([#256](https://github.com/google/dotprompt/issues/256)) ([18cff7a](https://github.com/google/dotprompt/commit/18cff7af50860c46fb37a2fa9c373bd410f11701))
+* **py/dotpromptz:** fix broken picoschema parser tests ([#232](https://github.com/google/dotprompt/issues/232)) ([4d154aa](https://github.com/google/dotprompt/commit/4d154aaae99f2f31500d86ed6191a05298700b91))
+* **py/dotpromptz:** fix pydantic warnings and tabulate the various types in typing.py ([#196](https://github.com/google/dotprompt/issues/196)) ([24dcfdd](https://github.com/google/dotprompt/commit/24dcfdd320884452ee48fca859619b400fe61327))
+* **py/dotpromptz:** make resolver concrete in resolve, resolve_tool, and resolve_partial ([#210](https://github.com/google/dotprompt/issues/210)) ([3730190](https://github.com/google/dotprompt/commit/37301903c8f26f1b8363ad1f2d515a6df19303e2))
+* **py/dotpromptz:** register initial helpers and partials correctly ([#260](https://github.com/google/dotprompt/issues/260)) ([0752865](https://github.com/google/dotprompt/commit/0752865b415c6cc90c87e3113b537632a52e3423))
+* **py/dotpromptz:** registering partials and start rendering some specs ([#269](https://github.com/google/dotprompt/issues/269)) ([aff3c4b](https://github.com/google/dotprompt/commit/aff3c4b9ee548e61268ca070f6660d51c860619d))
+* **py/dotpromptz:** remove stray reference to inspect.isasyncgenfunction since we dont deal with those as resolvers ([#216](https://github.com/google/dotprompt/issues/216)) ([c300515](https://github.com/google/dotprompt/commit/c3005159aea0af906e3f704d03fd5859a9540d4f))
+* **py/dotpromptz:** remove unused Options type from dotprompt.py and fix typo ([#213](https://github.com/google/dotprompt/issues/213)) ([ae59431](https://github.com/google/dotprompt/commit/ae5943179e77aa6fa775d092254d8adf21b06eb2))
+* **py/dotpromptz:** some lint and add docstrings ([#235](https://github.com/google/dotprompt/issues/235)) ([2e1c893](https://github.com/google/dotprompt/commit/2e1c893bbbe7c29480d67e2d693db90e9bef9b1b))
+* **py/handlebarrz:** helpers support in handlebarrz ([#291](https://github.com/google/dotprompt/issues/291)) ([d5d66a3](https://github.com/google/dotprompt/commit/d5d66a35858a068c2995b82fe54b62f0be4d057f))
+* **py/spec_test:** hex-encoded SHA-256 digest rather than base64-encoded SHA-256 digest for module IDs ([#140](https://github.com/google/dotprompt/issues/140)) ([796c644](https://github.com/google/dotprompt/commit/796c6442a3c1836de2170c466966382a0577a940))
+* **py:** lint reporting missing docstrings in test files ([#199](https://github.com/google/dotprompt/issues/199)) ([4d91514](https://github.com/google/dotprompt/commit/4d9151468ddd13f334454701daae42d5717d4dcf))
+* **py:** metadata purpose support ([#296](https://github.com/google/dotprompt/issues/296)) ([4a0f436](https://github.com/google/dotprompt/commit/4a0f436f1420f738d4fb46a4e5f41129929fb0fd))
+* remove spurious role type `assistant` ([#169](https://github.com/google/dotprompt/issues/169)) ([1b5142c](https://github.com/google/dotprompt/commit/1b5142c4a7ad20ef722d438cefa0b93a82d7adbb))
+
+
+### Documentation
+
+* add initial mkdocs documentation for eng [#43](https://github.com/google/dotprompt/issues/43) ([#44](https://github.com/google/dotprompt/issues/44)) ([31be336](https://github.com/google/dotprompt/commit/31be336d14899acf7ea1cefb4b782f5b2d1c31d1))
+* **py/dotpromptz:** document awaitable type hierarchy as ASCII diagram in comments to make code readable ([#212](https://github.com/google/dotprompt/issues/212)) ([0926749](https://github.com/google/dotprompt/commit/0926749e72d17264b8078151b10f616a906cfd66))
+* **py:** add docstring to parse.py and dotprompt.py modules. ([#246](https://github.com/google/dotprompt/issues/246)) ([c9d53bb](https://github.com/google/dotprompt/commit/c9d53bb3cad96f9d8ef5778ada93ee65276afa09))
+* **py:** add documentation for the resolvers module ([#209](https://github.com/google/dotprompt/issues/209)) ([04b6691](https://github.com/google/dotprompt/commit/04b6691227ef5b01ebf5261d4846a3ba7e723ab2))
+* **py:** ascii diagrams to explain the relationships between the types for easy visualization ([#197](https://github.com/google/dotprompt/issues/197)) ([6d775c4](https://github.com/google/dotprompt/commit/6d775c4bf1301c63d111b0d45db53dba61117555))

dotpromptz-0.1.2/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2025 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.

dotpromptz-0.1.2/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: dotpromptz
+Version: 0.1.2
+Summary: Dotpromptz is a language-neutral executable prompt template file format for Generative AI.
+Author: Google
+License: Apache-2.0
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+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: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Requires-Dist: aiofiles>=24.1.0
+Requires-Dist: anyio>=4.9.0
+Requires-Dist: dotprompt-handlebars
+Requires-Dist: pydantic[email]>=2.10.6
+Requires-Dist: strenum>=0.4.15; python_version < '3.11'
+Requires-Dist: structlog>=25.2.0
+Requires-Dist: types-aiofiles>=24.1.0.20250326
+Description-Content-Type: text/markdown
+
+# Dotprompt: Executable GenAI Prompt Templates
+
+**Dotprompt** is an executable prompt template file format for Generative AI. It
+is designed to be agnostic to programming language and model provider to allow
+for maximum flexibility in usage. Dotprompt extends the popular
+[Handlebars](https://handlebarsjs.com) templating language with GenAI-specific
+features.
+
+## What's an executable prompt template?
+
+An executable prompt template is a file that contains not only the text of a
+prompt but also metadata and instructions for how to use that prompt with a
+generative AI model. Here's what makes Dotprompt files executable:
+
+- **Metadata Inclusion**: Dotprompt files include metadata about model
+  configuration, input requirements, and expected output format. This
+  information is typically stored in a YAML frontmatter section at the beginning
+  of the file.
+
+- **Self-Contained Entity**: Because a Dotprompt file contains all the necessary
+  information to execute a prompt, it can be treated as a self-contained entity.
+  This means you can "run" a Dotprompt file directly, without needing additional
+  configuration or setup in your code.
+
+- **Model Configuration**: The file specifies which model to use and how to
+  configure it (e.g., temperature, max tokens).
+
+- **Input Schema**: It defines the structure of the input data expected by the
+  prompt, allowing for validation and type-checking.
+
+- **Output Format**: The file can specify the expected format of the model's
+  output, which can be used for parsing and validation.
+
+- **Templating**: The prompt text itself uses Handlebars syntax, allowing for
+  dynamic content insertion based on input variables.
+
+This combination of features makes it possible to treat a Dotprompt file as an
+executable unit, streamlining the process of working with AI models and ensuring
+consistency across different uses of the same prompt.
+
+## Example `.prompt` file
+
+Here's an example of a Dotprompt file that extracts structured data from provided text:
+
+```handlebars
+---
+model: googleai/gemini-1.5-pro
+input:
+  schema:
+    text: string
+output:
+  format: json
+  schema:
+    name?: string, the full name of the person
+    age?: number, the age of the person
+    occupation?: string, the person's occupation
+---
+Extract the requested information from the given text. If a piece of information is not
+present, omit that field from the output. Text:
+{{text}}
+```
+
+This Dotprompt file:
+
+1. Specifies the use of the `googleai/gemini-1.5-pro` model.
+2. Defines an input schema expecting a `text` string.
+3. Specifies that the output should be in JSON format.
+4. Provides a schema for the expected output, including fields for name, age, and occupation.
+5. Uses Handlebars syntax (`{{text}}`) to insert the input text into the prompt.
+
+When executed, this prompt would take a text input, analyze it using the
+specified AI model, and return a structured JSON object with the extracted
+information.

dotpromptz-0.1.2/README.md

@@ -0,0 +1,73 @@
+# Dotprompt: Executable GenAI Prompt Templates
+
+**Dotprompt** is an executable prompt template file format for Generative AI. It
+is designed to be agnostic to programming language and model provider to allow
+for maximum flexibility in usage. Dotprompt extends the popular
+[Handlebars](https://handlebarsjs.com) templating language with GenAI-specific
+features.
+
+## What's an executable prompt template?
+
+An executable prompt template is a file that contains not only the text of a
+prompt but also metadata and instructions for how to use that prompt with a
+generative AI model. Here's what makes Dotprompt files executable:
+
+- **Metadata Inclusion**: Dotprompt files include metadata about model
+  configuration, input requirements, and expected output format. This
+  information is typically stored in a YAML frontmatter section at the beginning
+  of the file.
+
+- **Self-Contained Entity**: Because a Dotprompt file contains all the necessary
+  information to execute a prompt, it can be treated as a self-contained entity.
+  This means you can "run" a Dotprompt file directly, without needing additional
+  configuration or setup in your code.
+
+- **Model Configuration**: The file specifies which model to use and how to
+  configure it (e.g., temperature, max tokens).
+
+- **Input Schema**: It defines the structure of the input data expected by the
+  prompt, allowing for validation and type-checking.
+
+- **Output Format**: The file can specify the expected format of the model's
+  output, which can be used for parsing and validation.
+
+- **Templating**: The prompt text itself uses Handlebars syntax, allowing for
+  dynamic content insertion based on input variables.
+
+This combination of features makes it possible to treat a Dotprompt file as an
+executable unit, streamlining the process of working with AI models and ensuring
+consistency across different uses of the same prompt.
+
+## Example `.prompt` file
+
+Here's an example of a Dotprompt file that extracts structured data from provided text:
+
+```handlebars
+---
+model: googleai/gemini-1.5-pro
+input:
+  schema:
+    text: string
+output:
+  format: json
+  schema:
+    name?: string, the full name of the person
+    age?: number, the age of the person
+    occupation?: string, the person's occupation
+---
+Extract the requested information from the given text. If a piece of information is not
+present, omit that field from the output. Text:
+{{text}}
+```
+
+This Dotprompt file:
+
+1. Specifies the use of the `googleai/gemini-1.5-pro` model.
+2. Defines an input schema expecting a `text` string.
+3. Specifies that the output should be in JSON format.
+4. Provides a schema for the expected output, including fields for name, age, and occupation.
+5. Uses Handlebars syntax (`{{text}}`) to insert the input text into the prompt.
+
+When executed, this prompt would take a text input, analyze it using the
+specified AI model, and return a structured JSON object with the extracted
+information.