Changelog¶

All notable changes to this project will be documented here.

[0.3.6] — 2026-05-11¶

Dot-Notation Variables: Variables in PromptNode can now be accessed directly using dot notation (e.g., node.variables.MyVariable).
Pydantic Auto-Detection: DynaPrompt now automatically detects if a Pydantic schema is passed in the variables and referenced in the template. If so, it automatically assigns it as the response_schema for the prompt, eliminating the need to explicitly define it in the markdown frontmatter in most cases.

Python Variable Stability: Fixed a crash (TypeError: cannot pickle 'module' object) when loading Python files that contain standard imports (e.g. import math). Modules are now automatically excluded from the variable registry.

template Property Alias: PromptNode now supports .template as a more intuitive alias for the raw .text attribute.

Auto-Render Locking: Fixed a regression where enabling auto_render would "lock" the template and prevent subsequent overrides in .render() calls.

Infinite Loop Protection: Automatically detects and excludes the caller script from the scanning process, preventing infinite recursion when using . as a settings directory.
Python Module Loading: Directory scanning now automatically skips __init__.py files to avoid relative import errors in package-style prompt directories.

Introspection Methods: keys(), __iter__, and .prompts property on DynaPrompt for easier exploration of loaded prompts.

Async Rendering: async_render() and async_rerender() on PromptNode for non-blocking I/O in FastAPI and async agents.
Async Hooks: @async_hookable decorator for asynchronous lifecycle hooks.
Prompt Hashing: Every RenderedPrompt now includes a prompt_hash (SHA-256) for audit logs and LangSmith observability.
Debug Trace: prompts.debug_trace("key") to visualize the full merge hierarchy and identify which environment/file provided specific values.
Python Variable Templates: Templates can be extracted from Python files using the template = "file.py:variable" syntax.

Dotted TOML Headers: Nested TOML headers like [default.gemini.analyzer] were parsed as nested dicts instead of flat prompt namespaces.
Missing File Alerts: Explicit UserWarning when a requested settings file doesn't exist.

README Overhaul: Completely redesigned with side-by-side "before/after" comparisons, YAML frontmatter guides, and advanced examples.
Jinja2 Environment: Enabled enable_async=True globally for transparent sync/async rendering.

structure_mode Parameter: Enables building nested namespaces from directory structures (e.g., prompts.folder.file). Defaults to True.
auto_export Visibility: Improved documentation for the auto_export feature which mirrors the prompt tree to pyprompts.toml.
Enhanced Metadata: Expanded PyPI keywords and Trove classifiers for better discoverability.

auto_render Default: Now True by default. Variables within templates are automatically rendered during initialization.
Modernized Test Suite: Refactored legacy test scripts into a clean pytest suite using tmp_path fixtures.

CI Workflow: Fixed an "Invalid action input" error in GitHub Actions by updating Codecov to v5.

Initial public release with lazy-loading, environment support, and Pydantic schema integration.