jeffotoni / quick / 284

88%

push

circleci

feat(template/html): add alias support, embedded FS, layout nesting, and full test coverage

This update introduces major enhancements to the HTML template engine:

 Added support for template aliasing:
   - Templates can now be referenced by multiple names:
     - Full path (e.g., "views/index.html")
     - Relative path (e.g., "index.html")
     - Clean name (e.g., "index")

 Support for layouts and nested layouts using `{{ .yield }}`.

 Embedded file system (`embed.FS`) support:
   - Templates can be embedded using `//go:embed`.
   - Dynamic base directory (`engine.Dir`) is respected.
   - `Load()` parses and registers templates from embedded FS or local filesystem.

 Added `AddFunc()` for registering custom template functions.
   - Example: `upper` function used in tests and examples.

 Full test suite:
   - Unit tests for rendering, layouts, aliases, and function registration.
   - Benchmark tests for performance comparison.
   - Temporary test data is created and removed automatically.

 Improved internal template registration logic for consistency across environments.

🛠 Refactored and cleaned up `Load()` for clarity and robustness.
🧪 All tests pass, including alias-related and layout-based renders.
📚 Added detailed usage examples and documentation to README.

This commit finalizes the template engine module to be fully production-ready.

67 of 193 new or added lines in 6 files covered. (34.72%)

2980 of 5866 relevant lines covered (50.8%)

1704.19 hits per line