render-engine 2025.10.1a1__py3-none-any.whl → 2025.10.3a1__py3-none-any.whl

render_engine/collection.py

@@ -6,10 +6,12 @@ from pathlib import Path
 from typing import Any
 
 import dateutil.parser as dateparse
-from more_itertools import batched, flatten
+from more_itertools import batched
 from render_engine_parser import BasePageParser
 from slugify import slugify
 
+from render_engine.content_managers import ContentManager, FileContentManager
+
 from ._base_object import BaseObject
 from .archive import Archive
 from .feeds import RSSFeed
@@ -56,6 +58,9 @@ class Collection(BaseObject):
         title: str
         template: str | None
         archive_template str | None: The template to use for the archive pages.
+        ContentManager: type[ContentManager] | None = FileContentManager
+        content_manager: ContentManager
+        content_manager_extras: dict[str, Any]: kwargs to pass to the ContentManager when instantiating
 
     Methods:
 
@@ -84,6 +89,8 @@ class Collection(BaseObject):
     template_vars: dict[str, Any]
     template: str | None
     plugin_manager: PluginManager | None
+    ContentManager: type[ContentManager] | None = FileContentManager
+    content_manager_extras: dict[str, Any]
 
     def __init__(
         self,
@@ -102,9 +109,16 @@ class Collection(BaseObject):
         self.title = self._title
         self.template_vars = getattr(self, "template_vars", {})
 
-    def iter_content_path(self):
-        """Iterate through in the collection's content path."""
-        return flatten([Path(self.content_path).glob(suffix) for suffix in self.include_suffixes])
+        cm_extras = {
+            "content_path": getattr(self, "content_path", None),
+            "include_suffixes": getattr(self, "include_suffixes", None),
+            "collection": self,
+        }
+        if hasattr(self, "content_manager_extras"):
+            cm_extras.update(self.content_manager_extras)
+        self.content_manager = self.ContentManager(**cm_extras)
+        if hasattr(self, "pages"):
+            self.content_manager.pages = self.pages
 
     def get_page(
         self,
@@ -116,8 +130,6 @@ class Collection(BaseObject):
             Parser=self.Parser,
         )
 
-        if getattr(self, "_pm", None):
-            _page.register_plugins(self.plugins, **self.plugin_settings)
         _page.parser_extras = getattr(self, "parser_extras", {})
         _page.routes = self.routes
         _page.template = getattr(self, "template", None)
@@ -162,7 +174,7 @@ class Collection(BaseObject):
         """
         try:
             return sorted(
-                (page for page in self.__iter__()),
+                (page for page in self),
                 key=self._sort_key(self.sort_by),
                 reverse=self.sort_reverse,
             )
@@ -231,10 +243,7 @@ class Collection(BaseObject):
         return f"{__name__}"
 
     def __iter__(self):
-        if not hasattr(self, "pages"):
-            self.pages = [self.get_page(page) for page in self.iter_content_path()]
-        for page in self.pages:  # noqa: UP028
-            yield page
+        yield from self.content_manager
 
     def _run_collection_plugins(self, site, hook_type: str):
         """

render_engine/content_managers/__init__.py

@@ -0,0 +1,7 @@
+from .base_content_manager import ContentManager
+from .file_content_manager import FileContentManager
+
+__all__ = [
+    ContentManager,
+    FileContentManager,
+]

render_engine/content_managers/base_content_manager.py

@@ -0,0 +1,16 @@
+from abc import ABC, abstractmethod
+from collections.abc import Generator, Iterable
+
+
+class ContentManager(ABC):
+    """Base ContentManager abstract class"""
+
+    @property
+    @abstractmethod
+    def pages(self) -> Iterable:
+        """The Page objects managed by the content manager"""
+        ...
+
+    def __iter__(self) -> Generator:
+        """Iterator for the ContentManager"""
+        yield from self.pages

render_engine/content_managers/file_content_manager.py

@@ -0,0 +1,36 @@
+from collections.abc import Iterable
+from pathlib import Path
+
+from more_itertools import flatten
+
+from render_engine.content_managers import ContentManager
+
+
+class FileContentManager(ContentManager):
+    """Content manager for content stored on the file system as individual files"""
+
+    def __init__(
+        self,
+        content_path: Path | str,
+        collection,
+        include_suffixes: Iterable[str] = ("*.md", "*.html"),
+        **kwargs,
+    ):
+        self.content_path = content_path
+        self.include_suffixes = include_suffixes
+        self.collection = collection
+        self._pages = None
+
+    def iter_content_path(self):
+        """Iterate through in the collection's content path."""
+        return flatten([Path(self.content_path).glob(suffix) for suffix in self.include_suffixes])
+
+    @property
+    def pages(self) -> Iterable:
+        if self._pages is None:
+            self._pages = [self.collection.get_page(page) for page in self.iter_content_path()]
+        yield from self._pages
+
+    @pages.setter
+    def pages(self, value: Iterable):
+        self._pages = value

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/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
                 ]

{render_engine-2025.10.1a1.dist-info → render_engine-2025.10.3a1.dist-info}/METADATA

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

@@ -4,17 +4,20 @@ render_engine/__main__.py,sha256=uI7aBBZz0qSDwwwD11nS5oltWsuLw9hStfYo8O1aNws,144
 render_engine/_base_object.py,sha256=DIyLdQ6gS4a0DP46zwGYkYIyewh8uRFznJmaUch7d8M,3546
 render_engine/archive.py,sha256=S3-kCmDNVKkEfKDKxcEk-sXkBD0vS0RDnFfPunYkU8g,2072
 render_engine/blog.py,sha256=f9GqFUFsta0KZnFhCiajobpfQyALqvgI5sbLm6zt1zw,1571
-render_engine/collection.py,sha256=rubgKV6z3LN1gCGdYsbwd023SVQdBNnSHnHqXhkn83g,10209
+render_engine/collection.py,sha256=dAGyWdIoXr6S4GMSbPPin4Y5vLJR_onO_85-NEqRaWM,10599
 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=URvG7OQSgeFOcrZwrD8vHLUWa6UxDBxIP-UMeLLqhZM,12936
-render_engine/site_map.py,sha256=cVnCekhDqPKXCSslI8eg-_4cRHN_yWuWo82sjwKzAGI,5412
+render_engine/site_map.py,sha256=I1p_yMDMy1jpIivgNgZptnsxZa8NkcrpciVJE3DlFlQ,5422
 render_engine/themes.py,sha256=TFG1rd34QCBvBWfeDbawgsn6kprmjsDTa1pdDSwDMic,4207
+render_engine/content_managers/__init__.py,sha256=z1x99J0GNcfqYFrugD0EleiZR6b-sfM6zViDTH1iF0s,161
+render_engine/content_managers/base_content_manager.py,sha256=LSGBRkGbBHMI-oRyoXVTfr5Me-8vYws7NV961VPOnxI,414
+render_engine/content_managers/file_content_manager.py,sha256=yMLT7xBhCw4NLfKuwx-6T_U9I03UTsyTAFz4uxE1uu8,1102
 render_engine/extras/__init__.py,sha256=L4jr4A7Jl-ODnSx1q2fP3_dBo37Dw6yepNRddu1nFNo,72
 render_engine/parsers/markdown.py,sha256=0jpixCaoHaL0IRSvFIljJIRCvFkXoKTEYQNK38LwMDU,287
 render_engine/render_engine_templates/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -32,7 +35,7 @@ render_engine/render_engine_templates/base_templates/_page.html,sha256=jjrY2BAwl
 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.10.1a1.dist-info/METADATA,sha256=X7uol4Ld4scOzJSZ0jYobZmf_AyTwJ53DAwt1hM488s,11895
-render_engine-2025.10.1a1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-render_engine-2025.10.1a1.dist-info/top_level.txt,sha256=aNGALDMsFyrusho04AvUjSivsgEE9tQp_LP_jGr312Q,14
-render_engine-2025.10.1a1.dist-info/RECORD,,
+render_engine-2025.10.3a1.dist-info/METADATA,sha256=906rgnnlpsL8upgcEtC4-JYstfkIHiqBK2QU6f_fMaw,11895
+render_engine-2025.10.3a1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+render_engine-2025.10.3a1.dist-info/top_level.txt,sha256=aNGALDMsFyrusho04AvUjSivsgEE9tQp_LP_jGr312Q,14
+render_engine-2025.10.3a1.dist-info/RECORD,,