render-engine 2025.10.1a1__tar.gz → 2025.10.1a2__tar.gz

{render_engine-2025.10.1a1 → render_engine-2025.10.1a2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: render_engine
-Version: 2025.10.1a1
+Version: 2025.10.1a2
 Summary: A Flexible Static Site Generator for Python
 Project-URL: homepage, https://github.com/render-engine/render-engine/
 Project-URL: repository, https://github.com/render-engine/render-engine/

{render_engine-2025.10.1a1 → render_engine-2025.10.1a2}/docs/docs/page.md

@@ -63,17 +63,18 @@ When you create a page, you specify variables passed into rendering template.
 
 **Attributes:**
 
-| Name | Type | Description |
-| --- | --- | --- |
-| `content_path` | `str | None` |The path to the file that will be used to generate the Page's `content`. |
-| `extension` | `str | None` |The suffix to use for the page. Defaults to `.html`. |
-| `engine` | `str | None` | If present, the engine to use for rendering the page. **This is normally not set and the `Site` 's engine will be used.** |
-| `reference` | `str | None` |Used to determine how to reference the page in the `Site`'s route_list. Defaults to `slug`. |
-| `routes` | `str | None` |The routes to use for the page. Defaults to `["./"]`. |
-| `template` | `str | None` |The template used to render the page. If not provided, the `Site`'s `content`will be used. |
-| `Parser` | `type[BasePageParser]` |The parser to generate the page's `raw_content`. Defaults to `BasePageParser`. |
-| `title` | `str` |The title of the page. Defaults to the class name. |
-| `skip_site_map`    | `False` | When set to `True` the `Page` will not be included in the generated `SiteMap` |
+| Name | Type                     | Description                                                                                                                                  |
+| --- |--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------|
+| `content_path` | `str \| None`            | The path to the file that will be used to generate the Page's `content`.                                                                     |
+| `extension` | `str \| None`            | The suffix to use for the page. Defaults to `.html`.                                                                                         |
+| `engine` | `str \| None`            | If present, the engine to use for rendering the page. **This is normally not set and the `Site` 's engine will be used.**                    |
+| `reference` | `str \| None`            | Used to determine how to reference the page in the `Site`'s route_list. Defaults to `slug`.                                                  |
+| `routes` | `str \| None`            | The routes to use for the page. Defaults to `["./"]`.                                                                                        |
+| `template` | `str \| None`            | The template used to render the page. If not provided, the `Site`'s `content`will be used.                                                   |
+| `Parser` | `type[BasePageParser]`   | The parser to generate the page's `raw_content`. Defaults to `BasePageParser`.                                                               |
+| `title` | `str`                    | The title of the page. Defaults to the class name.                                                                                           |
+| `skip_site_map`    | `bool`                   | When set to `True` the `Page` will not be included in the generated `SiteMap`. Defaults to `False`.                                          |
+| `no_prerender` | `bool`           | When set to `True` the `Page`'s `content` will not be pre-rendered as a `Template` even if `{{ site_map }}` is present. Defaults to `False`. |
 
 ## About Page Attributes
 
@@ -109,8 +110,8 @@ By default Page._content will return the result of `Page.Parser.parse(Page.conte
 ### Accessing URLs for other pages in the site from within the page content
 
 In order to allow lookup of URLs for other pages within a Site the `content` of a page may be
-a template. If the `content` matches the pattern `{{.*?}}` we will render the `content` as a
-template prior to rendering the page itself.
+a template. If the `content` matches the pattern `{{.*?site_map.*?}}` we will render the `content` as a
+template prior to rendering the page itself unless the `no_prerender` attribute of the page is `True`.
 
 Example:
 

{render_engine-2025.10.1a1 → render_engine-2025.10.1a2}/src/render_engine/page.py

@@ -1,3 +1,4 @@
+import logging
 import re
 from pathlib import Path
 from typing import Any
@@ -10,6 +11,8 @@ from render_engine.themes import ThemeManager
 from ._base_object import BaseObject
 from .plugins import PluginManager
 
+logger = logging.getLogger("Page")
+
 
 class BasePage(BaseObject):
     """
@@ -28,6 +31,8 @@ class BasePage(BaseObject):
         extension (str): The file extension for the page. Defaults to ".html".
         routes (list[str] | Path): The list of routes for the page. Defaults to ["./"].
         template (str | Template | None): The template to use for rendering the page.
+        site: The Site object that owns the page.
+        no_prerender: Flag to not prerender the content
     """
 
     extension: str = ".html"
@@ -36,7 +41,8 @@ class BasePage(BaseObject):
     rendered_content: str | None
     _reference: str = "_slug"
     plugin_manager: PluginManager | None
-    site = None
+    site = None  # This is a Site but circular imports so we can't actually type hint it.
+    no_prerender: bool = False
 
     @property
     def _content(self) -> any:
@@ -69,20 +75,35 @@ class BasePage(BaseObject):
             return f"/{route}/{self.path_name}"
 
     def _render_from_template(self, template: Template, **kwargs) -> str:
-        """Renders the page from a template."""
+        """
+        Renders the page from a template.
+
+        If the content looks like a template that
+
+        :param template: Template to render
+        :param **kwargs: Data to pass into the template for rendering.
+        :return: The rendered page
+        """
         template_data = {"data": self._data, "content": self._content}
         if site := getattr(self, "site", None):
             template_data["site_map"] = site.site_map
-        if isinstance(self._content, str) and re.search(r"{{.*}}", self._content):
+        if not self.no_prerender and isinstance(self._content, str) and re.search(r"{{.*?site_map.*?}}", self._content):
             # If the content looks like a template, try to render it.
-            content_template = Template(self._content)
-            template_data["content"] = content_template.render(
-                **{
-                    **self.to_dict(),
-                    **template_data,
-                    **kwargs,
-                }
-            )
+            try:
+                content_template = Template(self._content)
+            except Exception:
+                logger.info(f"Failed to parse {repr(self.path_name)} as a template.", exc_info=True)
+            else:
+                try:
+                    template_data["content"] = content_template.render(
+                        **{
+                            **self.to_dict(),
+                            **template_data,
+                            **kwargs,
+                        }
+                    )
+                except Exception:
+                    logger.info(f"Failed to pre-render {repr(self.path_name)}.", exc_info=True)
 
         return template.render(
             **{

{render_engine-2025.10.1a1 → render_engine-2025.10.1a2}/src/render_engine.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: render_engine
-Version: 2025.10.1a1
+Version: 2025.10.1a2
 Summary: A Flexible Static Site Generator for Python
 Project-URL: homepage, https://github.com/render-engine/render-engine/
 Project-URL: repository, https://github.com/render-engine/render-engine/

{render_engine-2025.10.1a1 → render_engine-2025.10.1a2}/tests/test_page.py

@@ -1,3 +1,4 @@
+import logging
 import pathlib
 
 import jinja2
@@ -96,3 +97,71 @@ def test_rendered_page_from_template_has_data():
         data = [1, 2, 3, 4]
 
     assert CustomPage()._render_from_template(template=CustomPage.template) == "1234"
+
+
+def test_page_fails_to_render_content_as_template(caplog):
+    """Tests handling content that fails to render as a template"""
+    caplog.set_level(logging.INFO)
+
+    template = "{% for d in data %}{{d}}{% endfor %}\n{{content}}"
+
+    environment = jinja2.Environment(loader=jinja2.DictLoader({"test.html": template}))
+
+    class CustomPage(Page):
+        template = environment.get_template("test.html")
+        data = [1, 2, 3, 4]
+        content = "{{ site_map.find('test') }}"
+
+    assert CustomPage()._render_from_template(template=CustomPage.template) == "1234\n{{ site_map.find('test') }}"
+    assert "Failed to pre-render" in caplog.messages[0]
+
+
+def test_braces_ignored_without_sitemap():
+    """Tests that braces in content are ignored without `site_map`"""
+    template = "{% for d in data %}{{d}}{% endfor %}\n{{content}}"
+
+    environment = jinja2.Environment(loader=jinja2.DictLoader({"test.html": template}))
+
+    class CustomPage(Page):
+        template = environment.get_template("test.html")
+        data = [1, 2, 3, 4]
+        content = "{{ example }}"
+
+    assert CustomPage()._render_from_template(template=CustomPage.template) == "1234\n{{ example }}"
+
+
+def test_exception_in_parsing_content_as_template(monkeypatch, caplog):
+    """Test failing to parse content as template"""
+
+    def mock_template():
+        raise jinja2.exceptions.UndefinedError("Mocked error")
+
+    monkeypatch.setattr("render_engine.page.Template", mock_template)
+    caplog.set_level(logging.INFO)
+
+    template = "{% for d in data %}{{d}}{% endfor %}\n{{content}}"
+
+    environment = jinja2.Environment(loader=jinja2.DictLoader({"test.html": template}))
+
+    class CustomPage(Page):
+        template = environment.get_template("test.html")
+        data = [1, 2, 3, 4]
+        content = "{{ site_map.find('test') }}"
+
+    assert CustomPage()._render_from_template(template=CustomPage.template) == "1234\n{{ site_map.find('test') }}"
+    assert "Failed to parse" in caplog.messages[0]
+
+
+def test_no_prerender():
+    """Test pre-rendering does not occur when no_prerender is True"""
+    template = "{% for d in data %}{{d}}{% endfor %}\n{{content}}"
+
+    environment = jinja2.Environment(loader=jinja2.DictLoader({"test.html": template}))
+
+    class CustomPage(Page):
+        template = environment.get_template("test.html")
+        data = [1, 2, 3, 4]
+        content = "{{ site_map.find('test') }}"
+        no_prerender = True
+
+    assert CustomPage()._render_from_template(template=CustomPage.template) == "1234\n{{ site_map.find('test') }}"