render-engine 2025.11.1a1__py3-none-any.whl → 2026.1.1a2__py3-none-any.whl

render_engine/__version__.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '2025.11.1a1'
-__version_tuple__ = version_tuple = (2025, 11, 1, 'a1')
+__version__ = version = '2026.1.1a2'
+__version_tuple__ = version_tuple = (2026, 1, 1, 'a2')
 
 __commit_id__ = commit_id = None

render_engine/_base_object.py

@@ -27,6 +27,7 @@ class BaseObject:
     plugins: list[Callable] | None
     plugin_settings: dict = {"plugins": defaultdict(dict)}
     skip_site_map: bool = False
+    metadata: dict = dict()
 
     @property
     def _title(self) -> str:

render_engine/collection.py

@@ -1,7 +1,9 @@
 import copy
 import datetime
 import logging
+import os
 from collections.abc import Callable, Generator
+from multiprocessing.pool import ThreadPool
 from pathlib import Path
 from typing import Any
 
@@ -10,10 +12,9 @@ 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 .content_managers import ContentManager, FileContentManager
 from .feeds import RSSFeed
 from .page import Page
 from .plugins import PluginManager
@@ -245,6 +246,28 @@ class Collection(BaseObject):
     def __iter__(self):
         yield from self.content_manager
 
+    def __len__(self):
+        return len(self.content_manager)
+
+    @property
+    def all_content(self) -> Generator:
+        """All of the content that is associated with the Collection including Pages, Feed, and Archives"""
+        yield from self
+
+        if getattr(self, "has_archive", False):
+            for archive in self.archives:
+                yield archive
+                if archive.is_index:
+                    # In order to avoid collision with parallel processing we need to do a copy.
+                    # A deepcopy is not necessary because we only care about not overwriting the
+                    # slug on the original.
+                    index = copy.copy(archive)
+                    index.slug = "index"
+                    yield index
+
+        if feed := getattr(self, "feed", None):
+            yield feed
+
     def _run_collection_plugins(self, site, hook_type: str):
         """
         Run plugins for a collection
@@ -261,32 +284,28 @@ class Collection(BaseObject):
             return
         method(collection=self, site=site, settings=self.plugin_manager.plugin_settings)
 
-    def render(self) -> None:
-        """Iterate through Pages and Check for Collections and Feeds"""
+    def _render(self, entry):
+        """
+        Renders 1 entry in the Collection
 
-        for entry in self:
+        :param entry: The entry to process
+        """
+        if not isinstance(entry, RSSFeed) and not isinstance(entry, Archive):
             entry.plugin_manager = copy.deepcopy(self.plugin_manager)
 
-            for route in entry.routes:
-                entry.site = self.site
-                entry.render(route, self.site.theme_manager)
+        entry.site = self.site
+        entry.render(self.site.theme_manager)
 
-        if getattr(self, "has_archive", False):
-            for archive in self.archives:
-                archive.site = self.site
-                logging.debug("Adding Archive: %s", archive.__class__.__name__)
-
-                for _ in self.routes:
-                    archive.render(self.routes[0], self.site.theme_manager)
-
-                if archive.is_index:
-                    archive.slug = "index"
-                    archive.render(self.routes[0], self.site.theme_manager)
-        feed: RSSFeed
-        if hasattr(self, "Feed"):
-            feed = self.feed
-            feed.site = self.site
-            feed.render(route="./", theme_manager=self.site.theme_manager)
+    def render(self) -> None:
+        """Iterate through Pages and Check for Archives and Feeds"""
+
+        # Use a ThreadPool to process all of the entries in the collection in parallel.
+        # This is limited to the number of CPUs available. The easiest way to implement
+        # this parallelization for a single task is to use the imap_unordered method of
+        # the ThreadPool. This is, effectively, a generator so we need to loop over it
+        # for them to run. Since there is no actual return value to look at we just `pass`.
+        for entry in ThreadPool(processes=os.cpu_count()).imap_unordered(self._render, self.all_content):
+            pass
 
     def create_entry(
         self, filepath: Path = None, editor: str = None, content: str = None, metadata: dict = None

render_engine/content_managers/base_content_manager.py

@@ -19,4 +19,21 @@ class ContentManager(ABC):
     @abstractmethod
     def create_entry(self, filepath: Path = None, editor: str = None, metadata: dict = None, content: str = None):
         """Create a new entry"""
-        ...
+        pass
+
+    def find_entry(self, **kwargs):
+        """
+        Find an entry
+
+        :param kwargs: List of attributes to search by
+        :return: Page if it was found otherwise None
+        """
+        for page in self:
+            if all(getattr(page, attr, None) == value for attr, value in kwargs.items()):
+                return page
+        return None
+
+    @abstractmethod
+    def update_entry(self, *, page, **kwargs):
+        """Update an entry"""
+        pass

render_engine/content_managers/file_content_manager.py

@@ -36,8 +36,16 @@ class FileContentManager(ContentManager):
     def pages(self, value: Iterable):
         self._pages = value
 
+    def __len__(self):
+        return len(list(self.pages))
+
     def create_entry(
-        self, filepath: Path = None, editor: str = None, metadata: dict = None, content: str = None
+        self,
+        filepath: Path = None,
+        editor: str = None,
+        metadata: dict = None,
+        content: str = None,
+        update: bool = False,
     ) -> str:
         """
         Create a new entry for the Collection
@@ -46,12 +54,33 @@ class FileContentManager(ContentManager):
         :param editor: Editor to open to edit the entry.
         :param content: The content for the entry
         :param metadata: Metadata for the new entry
+        :param update: Allow overwriting the existing file
         """
         if not filepath:
             raise ValueError("filepath needs to be specified.")
 
+        if not update and filepath.exists():
+            raise RuntimeError(f"File at {filepath} exists and update is disabled.")
+
         parsed_content = self.collection.Parser.create_entry(content=content, **metadata)
         filepath.write_text(parsed_content)
         if editor:
             subprocess.run([editor, filepath])
         return f"New entry created at {filepath} ."
+
+    def update_entry(self, page, *, content: str = None, **kwargs) -> str:
+        """
+        Update an entry
+
+        :param page: Page object to update
+        :param content: Content for the updated page
+        :param kwargs: Attributes to be included in the updated page
+        :return: String indicating that the page was updated.
+        """
+        self.create_entry(filepath=page.content_path, metadata=kwargs, content=content, update=True)
+        if self._pages:
+            self._pages = [
+                existing_page for existing_page in self._pages if page.content_path != existing_page.content_path
+            ]
+            self._pages.append(self.collection.get_page(page.content_path))
+        return f"Entry at {page.content_path} updated."

render_engine/page.py

@@ -149,20 +149,23 @@ class BasePage(BaseObject):
     def __repr__(self) -> str:
         return f"<Page: {self._title}>"
 
-    def render(self, route: str | Path, theme_manager: ThemeManager) -> int:
+    def render(self, theme_manager: ThemeManager) -> int:
         """Render the page to the file system"""
-        path = Path(self.site.output_path) / Path(route) / Path(self.path_name)
-        path.parent.mkdir(parents=True, exist_ok=True)
-        settings = dict()
-        if (pm := getattr(self, "plugin_manager", None)) and pm is not None:
-            settings = {**self.site.plugin_manager.plugin_settings, "route": route}
-            pm.hook.render_content(page=self, settings=settings, site=self.site)
-        self.rendered_content = self._render_content(theme_manager.engine)
-        # pass the route to the plugin settings
-        if pm is not None:
-            pm.hook.post_render_content(page=self.__class__, settings=settings, site=self.site)
-
-        return path.write_text(self.rendered_content)
+        rc = 0
+        for route in self.routes:
+            path = Path(self.site.output_path) / Path(route) / Path(self.path_name)
+            path.parent.mkdir(parents=True, exist_ok=True)
+            settings = dict()
+            if (pm := getattr(self, "plugin_manager", None)) and pm is not None:
+                settings = {**self.site.plugin_manager.plugin_settings, "route": route}
+                pm.hook.render_content(page=self, settings=settings, site=self.site)
+            self.rendered_content = self._render_content(theme_manager.engine)
+            # pass the route to the plugin settings
+            if pm is not None:
+                pm.hook.post_render_content(page=self.__class__, settings=settings, site=self.site)
+
+            rc += path.write_text(self.rendered_content)
+        return rc
 
 
 class Page(BasePage):
@@ -204,10 +207,10 @@ class Page(BasePage):
 
     content: Any
     content_path: Path | str | None
-    Parser: type[BasePageParser] = BasePageParser
     inherit_plugins: bool
     parser_extras: dict[str, Any] | None
     title: str
+    Parser: type[BasePageParser] = BasePageParser
 
     def __init__(
         self,
@@ -229,19 +232,21 @@ class Page(BasePage):
 
         # Parse Content from the Content Path or the Content
         if content_path := (content_path or getattr(self, "content_path", None)):
-            attrs, self.content = self.Parser.parse_content_path(content_path)
+            self.metadata, self.content = self.Parser.parse_content_path(content_path)
 
         elif content := (content or getattr(self, "content", None)):
-            attrs, self.content = self.Parser.parse_content(content)
+            self.metadata, self.content = self.Parser.parse_content(content)
 
         else:
-            attrs = {}
+            self.metadata = {}
             self.content = None
 
         # Set the attributes
-        for key, val in attrs.items():
+        for key, val in self.metadata.items():
             setattr(self, key.lower(), val)
 
+        self.content_path = content_path
+
     @property
     def _content(self) -> Any:
         """

render_engine/site.py

@@ -306,14 +306,11 @@ class Site:
                 args = []
                 match entry:
                     case Page():
-                        for route in entry.routes:
-                            progress.update(
-                                task_add_route,
-                                description=f"[blue]Adding[gold]Route: [blue]{entry._slug}",
-                            )
-
-                            # self._render_output(route, entry)
-                            args = [route, self.theme_manager]
+                        progress.update(
+                            task_add_route,
+                            description=f"[blue]Adding[gold]Route: [blue]{entry._slug}",
+                        )
+                        args = [self.theme_manager]
                     case Collection():
                         progress.update(
                             task_add_route,

{render_engine-2025.11.1a1.dist-info → render_engine-2026.1.1a2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: render_engine
-Version: 2025.11.1a1
+Version: 2026.1.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.11.1a1.dist-info → render_engine-2026.1.1a2.dist-info}/RECORD

@@ -1,24 +1,24 @@
 render_engine/.gitignore,sha256=74oa8YR8gNxKxB6lCtoqmgtB2xpZnWM539Qsl4wI_lg,12
 render_engine/__init__.py,sha256=3fgua4ZA9o1pvQ5unhY1gRARLXFqAu019NEYqZTjP20,154
 render_engine/__main__.py,sha256=uI7aBBZz0qSDwwwD11nS5oltWsuLw9hStfYo8O1aNws,144
-render_engine/__version__.py,sha256=BCpwT8NcnBJ07_dARP0flYekyhShasjtVTPdA443a-A,720
-render_engine/_base_object.py,sha256=DIyLdQ6gS4a0DP46zwGYkYIyewh8uRFznJmaUch7d8M,3546
+render_engine/__version__.py,sha256=pI2d9qsCwWR0-5U4R9QwGAWwJN7Kas0dzZtgcWUBLBU,718
+render_engine/_base_object.py,sha256=B05rDWJUe5GM5FF94NeYY71KweBHY-IYel1lSBwLOrU,3574
 render_engine/archive.py,sha256=S3-kCmDNVKkEfKDKxcEk-sXkBD0vS0RDnFfPunYkU8g,2072
 render_engine/blog.py,sha256=f9GqFUFsta0KZnFhCiajobpfQyALqvgI5sbLm6zt1zw,1571
-render_engine/collection.py,sha256=eqeVxZ_ASrOra7kayhAkPSHocpM1mbxwhsH6ZtK-oMk,11294
+render_engine/collection.py,sha256=63KL7kAyJYsS8isbugqT6Ii-CUTxj5GST-f7yZJzZaA,12189
 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=l6sKWNJ4gBtC_ONEc0u479q3znL-8Q7U_phNqXqmh6w,8988
+render_engine/page.py,sha256=o753fqux-VMOHmprp6RFZOHqRt8Gjtc32WX3h5WLohA,9153
 render_engine/plugins.py,sha256=NXM8QTbbRV-DwgpQRoIhILijJBN4SyYg2Rkk1LUAuZM,4703
 render_engine/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-render_engine/site.py,sha256=aarHkveSVDOy7hRPzrx_ga3DmmirZQcLvcJdyw-b8lY,13329
+render_engine/site.py,sha256=22ir1dc2qWpmfRyG2hmTzB8BInZkp37LSaRo97xufto,13186
 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=umb2Tze7UE7ON74hOe_WiykOk9-xTPw40_l3W5Cy5_U,620
-render_engine/content_managers/file_content_manager.py,sha256=pKyldWKGocI2WAY8H_6d9dWY26hUxm4N5_oavO_FxJ0,1884
+render_engine/content_managers/base_content_manager.py,sha256=9DiQFN461jfdmcQF_0rQwgdNcUzaMDQaLFVbbiZf2e8,1088
+render_engine/content_managers/file_content_manager.py,sha256=kD5D99E16pN6PobDo8isqmPYdJyoRSZo9BP9iZaBwRI,2963
 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
@@ -36,7 +36,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.11.1a1.dist-info/METADATA,sha256=xmk3ud0hPXdvQ4Svm3QHsCgwyNYbC6-vU_OBd24PvPA,11895
-render_engine-2025.11.1a1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-render_engine-2025.11.1a1.dist-info/top_level.txt,sha256=aNGALDMsFyrusho04AvUjSivsgEE9tQp_LP_jGr312Q,14
-render_engine-2025.11.1a1.dist-info/RECORD,,
+render_engine-2026.1.1a2.dist-info/METADATA,sha256=FfVYaHJMWBGPe6UDAV97e7y7YHfKLL9fR1KUl1urc8w,11894
+render_engine-2026.1.1a2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+render_engine-2026.1.1a2.dist-info/top_level.txt,sha256=aNGALDMsFyrusho04AvUjSivsgEE9tQp_LP_jGr312Q,14
+render_engine-2026.1.1a2.dist-info/RECORD,,