render-engine 2025.9.1a2__py3-none-any.whl → 2025.10.1__py3-none-any.whl

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/render_engine_templates/sitemap.xml

@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
-{% for item in items %}
+{% for item in site_map %}
 {% include 'sitemap_item.xml' %}
+
 {% endfor %}
 </urlset>

render_engine/render_engine_templates/sitemap_item.xml

@@ -1,10 +1,10 @@
 <url>
-	<loc>{{SITE_URL}}/{{item}}</loc>
+	<loc>{{SITE_URL.rstrip("/")}}/{{item.url_for.lstrip("/")}}</loc>
 	{% if item.lastmod %}
 	<lastmod>{{item.lastmod}}</lastmod>
 	{% endif %}
 	{% if item.changefreq %}
-	<schangefreq>{{item.changefreq}}</changefreq>
+	<changefreq>{{item.changefreq}}</changefreq>
 	{% endif %}
 	{% if item.priority %}
 	<priority>{{item.priority}}</priority>

render_engine/site.py

@@ -21,7 +21,8 @@ class Site:
     Attributes:
         site_vars (dict): A dictionary containing site-wide variables and their values.
         plugin_settings (dict): A dictionary containing plugin settings.
-        render_site_map (bool): Whether to render the generated site map as a page.
+        render_html_site_map (bool): Whether to render the generated site map as an HTML page.
+        render_xml_site_map (bool): Whether to render the generated site map as XML.
 
     Methods:
         update_site_vars(**kwargs): Updates the site-wide variables with the given key-value pairs.
@@ -51,7 +52,8 @@ class Site:
     _template_path: str | Path = "templates"
     _static_paths: set = {"static"}
     plugin_settings: dict = {"plugins": defaultdict(dict)}
-    render_site_map: bool = False
+    render_html_site_map: bool = False
+    render_xml_site_map: bool = False
 
     def __init__(
         self,
@@ -253,7 +255,7 @@ class Site:
         with Progress() as progress:
             task_site_map = progress.add_task("Generating site map", total=1)
             self._site_map = SiteMap(self.route_list, self.site_vars.get("SITE_URL", ""))
-            if self.render_site_map:
+            if self.render_html_site_map:
 
                 @self.page
                 class SiteMapPage(Page):
@@ -262,6 +264,13 @@ class Site:
                     content = self._site_map.html
                     template = "page.html"
 
+            if self.render_xml_site_map:
+
+                @self.page
+                class SiteMapXml(Page):
+                    path_name = "site_map.xml"
+                    template = "sitemap.xml"
+
             progress.update(task_site_map, advance=1)
 
             pre_build_task = progress.add_task("Loading Pre-Build Plugins and Themes", total=1)

render_engine/site_map.py

@@ -22,7 +22,7 @@ class SiteMapEntry:
                 self._route = f"/{route.lstrip('/')}/{self.path_name}" if from_collection else f"/{self.path_name}"
                 self.entries = list()
             case Collection():
-                self._route = f"/{route.lstrip('/')}"
+                self._route = f"/{entry.routes[0].lstrip('/')}"
                 self.entries = [
                     SiteMapEntry(collection_entry, self._route, from_collection=True) for collection_entry in entry
                 ]
@@ -34,6 +34,10 @@ class SiteMapEntry:
         """The URL for the given entry"""
         return str(self._route)
 
+    def __str__(self) -> str:
+        """String representation of the entry as its URL"""
+        return self.url_for
+
 
 class SiteMap:
     """Site map"""
@@ -58,6 +62,12 @@ class SiteMap:
                 self._collections[sm_entry.slug] = sm_entry
         self.site_url = site_url
 
+    def __iter__(self):
+        """Iterator for the site map object"""
+        for entry in self._route_map.values():
+            yield entry
+            yield from entry.entries
+
     def find(
         self,
         value: str,
@@ -121,6 +131,8 @@ class SiteMap:
     def html(self) -> str:
         """Build the site map as HTML"""
         html_string = "<ul>\n"
+        # We can't iterate over `self` because that will flatten out the site map and we do not want that for the HTML
+        # version.
         for entry in self._route_map.values():
             html_string += f'\t<li><a href="{urljoin(self.site_url, entry.url_for)}">{entry.title}</a></li>\n'
             if entry.entries:

{render_engine-2025.9.1a2.dist-info → render_engine-2025.10.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: render_engine
-Version: 2025.9.1a2
+Version: 2025.10.1
 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.9.1a2.dist-info → render_engine-2025.10.1.dist-info}/RECORD

@@ -9,11 +9,11 @@ render_engine/engine.py,sha256=GOtUiq4ny5GHaLSCeH5u1Zk1JnWJVh63vK7etJiwS20,2843
 render_engine/feeds.py,sha256=i-VHsb6pRplMzaenBn6oeqh9yI_N4WVUAExPox6iJgw,921
 render_engine/hookspecs.py,sha256=GhOpw0zTQjfwWOFYYbJ4P7Cvq-oy1MmTPHmd90dr0kg,2292
 render_engine/links.py,sha256=pKmQMTz8-yGX8IecHcrlF3Dkejk7cptaO3qCkQiHB9I,2560
-render_engine/page.py,sha256=mIKdOmyQ1zRcaoZej9hMV2xajH_frXllaO-ZpZMzCtM,8091
+render_engine/page.py,sha256=l6sKWNJ4gBtC_ONEc0u479q3znL-8Q7U_phNqXqmh6w,8988
 render_engine/plugins.py,sha256=NXM8QTbbRV-DwgpQRoIhILijJBN4SyYg2Rkk1LUAuZM,4703
 render_engine/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-render_engine/site.py,sha256=86C-LbmONbhmLFDn7uKZokcMpsm6Vd3YcIxaxw1bbjk,12590
-render_engine/site_map.py,sha256=E-Bw563azKHGyACUWe0h48HhCLkJhkKR7V5JKhPLZoo,4975
+render_engine/site.py,sha256=URvG7OQSgeFOcrZwrD8vHLUWa6UxDBxIP-UMeLLqhZM,12936
+render_engine/site_map.py,sha256=I1p_yMDMy1jpIivgNgZptnsxZa8NkcrpciVJE3DlFlQ,5422
 render_engine/themes.py,sha256=TFG1rd34QCBvBWfeDbawgsn6kprmjsDTa1pdDSwDMic,4207
 render_engine/extras/__init__.py,sha256=L4jr4A7Jl-ODnSx1q2fP3_dBo37Dw6yepNRddu1nFNo,72
 render_engine/parsers/markdown.py,sha256=0jpixCaoHaL0IRSvFIljJIRCvFkXoKTEYQNK38LwMDU,287
@@ -24,15 +24,15 @@ render_engine/render_engine_templates/base_collection_path.md,sha256=7PIn5Oxei-b
 render_engine/render_engine_templates/page.html,sha256=p9aZ6_6mouPT1c8FVg-f14MeSt4OB-sH3hcXTY6jGmA,42
 render_engine/render_engine_templates/rss2.0.xml,sha256=Z5LGUdPRr3fQhXtJCjR8uxiPQ_GqYHELleDaS8Tr1oU,1803
 render_engine/render_engine_templates/rss2.0_items.xml,sha256=jxhDG9K2R112-upqq4NZnahDGZcvlWIn_sl9b4ArVEI,1306
-render_engine/render_engine_templates/sitemap.xml,sha256=A4zhyx2Z9RLTwTVyvK5kKpnXGRMJ4xwkf_ueI05Z5Hs,180
-render_engine/render_engine_templates/sitemap_item.xml,sha256=ofZDB8JSrtNEw4Lq2uHgnhX1xll0N_SaXfVJiJlmmg8,283
+render_engine/render_engine_templates/sitemap.xml,sha256=wqtVHwNBLBJrbfScJELHyf2VC3YxjL_cPgnI1xlb67U,184
+render_engine/render_engine_templates/sitemap_item.xml,sha256=8pQ1IHeGO2kDuKhxbQMh8HoDTuaKewtHX2NGt3ztGBY,314
 render_engine/render_engine_templates/base_templates/_archive.html,sha256=eFd62LkMcdxz70g-ksmCmTr2TSnKt2Z2X8zx80JpAPk,189
 render_engine/render_engine_templates/base_templates/_base.html,sha256=piaDrWjE1gG0IvUzpaH1RmHsTeRheeG3S9YmTdIf-CI,710
 render_engine/render_engine_templates/base_templates/_page.html,sha256=jjrY2BAwlJeVSNF4Pa6rd4Kcg0dfYpPpieZE2zeMTOM,163
 render_engine/render_engine_templates/components/footer.html,sha256=HkPGGhfN0HcYm7t8zgXWCQ3bsCbT8FxT4_n2-9e1zUE,74
 render_engine/render_engine_templates/components/page_title.html,sha256=l8aE1TY94UPHXHqAyy6jv4IoN2Hv9cbrTPh7ILkMyxg,137
 render_engine/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-render_engine-2025.9.1a2.dist-info/METADATA,sha256=FQAI3nwN7L-fxj7rzgMGDFgIpT6IHjQaScLnoyeHnkg,11894
-render_engine-2025.9.1a2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-render_engine-2025.9.1a2.dist-info/top_level.txt,sha256=aNGALDMsFyrusho04AvUjSivsgEE9tQp_LP_jGr312Q,14
-render_engine-2025.9.1a2.dist-info/RECORD,,
+render_engine-2025.10.1.dist-info/METADATA,sha256=MMMnXU-jA0JjG9lKbsa-dO5c35Wc4X450rC2_Cstdic,11893
+render_engine-2025.10.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+render_engine-2025.10.1.dist-info/top_level.txt,sha256=aNGALDMsFyrusho04AvUjSivsgEE9tQp_LP_jGr312Q,14
+render_engine-2025.10.1.dist-info/RECORD,,