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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: render_engine
-Version: 2026.1.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-2026.1.1a1 → render_engine-2026.1.1a2}/docs/docs/content_manager.md

@@ -65,3 +65,21 @@ prior to committing the entry to the datastore.
 
 !!! Note
     Not every `ContentManager` actually needs all the arguments that are passed.
+
+### `find_entry`
+
+The `find_entry` method is used to find a specific page in a `Collection`. It will search through all the pages
+known to the `ContentManager` until it finds one that has all the attributes specified. Even if multiple entries
+would satisfy the criteria, only the first found will be returned.
+
+### `update_entry`
+
+The `update_entry` is used to update an existing entry in a `ContentManager`.
+
+Parameters:
+
+```python
+page: Page  # The Page to update
+content: str = None  # Updated content
+**kwargs: dict  # The other attributes for the updated page
+```

{render_engine-2026.1.1a1 → render_engine-2026.1.1a2}/requirements.txt

@@ -230,7 +230,7 @@ typing-extensions==4.15.0
     #   typer
 tzdata==2025.3
     # via render_engine (pyproject.toml)
-urllib3==2.6.2
+urllib3==2.6.3
     # via requests
 virtualenv==20.35.4
     # via pre-commit

{render_engine-2026.1.1a1 → render_engine-2026.1.1a2}/src/render_engine/__version__.py

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

{render_engine-2026.1.1a1 → render_engine-2026.1.1a2}/src/render_engine/collection.py

@@ -12,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
@@ -247,6 +246,9 @@ 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"""
@@ -292,8 +294,7 @@ class Collection(BaseObject):
             entry.plugin_manager = copy.deepcopy(self.plugin_manager)
 
         entry.site = self.site
-        for route in entry.routes:
-            entry.render(route, self.site.theme_manager)
+        entry.render(self.site.theme_manager)
 
     def render(self) -> None:
         """Iterate through Pages and Check for Archives and Feeds"""

{render_engine-2026.1.1a1 → render_engine-2026.1.1a2}/src/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-2026.1.1a1 → render_engine-2026.1.1a2}/src/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-2026.1.1a1 → render_engine-2026.1.1a2}/src/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):
@@ -242,6 +245,8 @@ class Page(BasePage):
         for key, val in self.metadata.items():
             setattr(self, key.lower(), val)
 
+        self.content_path = content_path
+
     @property
     def _content(self) -> Any:
         """

{render_engine-2026.1.1a1 → render_engine-2026.1.1a2}/src/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-2026.1.1a1 → render_engine-2026.1.1a2}/src/render_engine.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: render_engine
-Version: 2026.1.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-2026.1.1a1 → render_engine-2026.1.1a2}/src/render_engine.egg-info/SOURCES.txt

@@ -110,6 +110,7 @@ tests/test_base_object.py
 tests/test_blog.py
 tests/test_collections.py
 tests/test_engine.py
+tests/test_file_content_manager.py
 tests/test_page.py
 tests/test_parsers_remove_2024_3_1.py
 tests/test_plugins.py

render_engine-2026.1.1a2/tests/test_file_content_manager.py

@@ -0,0 +1,78 @@
+from pathlib import Path
+
+from render_engine import Collection
+from render_engine.content_managers import FileContentManager
+
+
+def test_find_entry(tmp_path):
+    content_path = Path(tmp_path, "test-collection")
+    content_path.mkdir(parents=True)
+    filepath = content_path / "content.md"
+    content = "Test new content"
+    filepath.write_text(content)
+
+    class TestCollection(Collection):
+        content_path = Path(tmp_path, "test-collection")
+        ContentManager = FileContentManager
+
+    collection = TestCollection()
+    page = collection.content_manager.find_entry(content_path=filepath)
+    assert page is not None
+    assert page.content_path == filepath
+    assert page.content == content
+
+
+def test_find_no_valid_entry(tmp_path):
+    content_path = Path(tmp_path, "test-collection")
+    content_path.mkdir(parents=True)
+    filepath = content_path / "content.md"
+    content = "Test new content"
+    filepath.write_text(content)
+
+    class TestCollection(Collection):
+        content_path = Path(tmp_path, "test-collection")
+        ContentManager = FileContentManager
+
+    collection = TestCollection()
+    page = collection.content_manager.find_entry(content_path=filepath, test_attr="Test")
+    assert page is None
+    page = collection.content_manager.find_entry(content_path=filepath)
+    assert page is not None
+
+
+def test_find_entry_no_entries(tmp_path):
+    content_path = Path(tmp_path, "test-collection")
+    content_path.mkdir(parents=True)
+    filepath = content_path / "content.md"
+
+    class TestCollection(Collection):
+        content_path = Path(tmp_path, "test-collection")
+        ContentManager = FileContentManager
+
+    collection = TestCollection()
+    page = collection.content_manager.find_entry(content_path=filepath)
+    assert page is None
+
+
+def test_update_entry(tmp_path):
+    content_path = Path(tmp_path, "test-collection")
+    content_path.mkdir(parents=True)
+    filepath = content_path / "content.md"
+    content = "Test new content"
+    updated = "Test updated content"
+    filepath.write_text(content)
+
+    class TestCollection(Collection):
+        content_path = Path(tmp_path, "test-collection")
+        ContentManager = FileContentManager
+
+    collection = TestCollection()
+    assert len(collection.content_manager) == 1
+    page = collection.content_manager.find_entry(content_path=filepath)
+    assert filepath.read_text() == page.content
+    collection.content_manager.update_entry(page, content=updated, test_attr="Test")
+    assert filepath.read_text() == f"---\ntest_attr: Test\n---\n\n{updated}"
+    page = collection.content_manager.find_entry(content_path=filepath)
+    assert page.content == updated
+    assert page.test_attr == "Test"
+    assert len(collection.content_manager) == 1

{render_engine-2026.1.1a1 → render_engine-2026.1.1a2}/tests/test_plugins.py

@@ -254,7 +254,7 @@ class TestPlugin:
         print("PreBuild")
         prebuild = PreBuild()
         prebuild.site = site
-        prebuild.render("./", site.theme_manager)
+        prebuild.render(site.theme_manager)
 
     @staticmethod
     @hook_impl
@@ -266,7 +266,7 @@ class TestPlugin:
         print("PostBuild")
         postbuild = PostBuild()
         postbuild.site = site
-        postbuild.render("./", site.theme_manager)
+        postbuild.render(site.theme_manager)
 
     @staticmethod
     @hook_impl
@@ -278,7 +278,7 @@ class TestPlugin:
         print("RenderContent")
         renddercontent = RenderContent()
         renddercontent.site = site
-        renddercontent.render("./", site.theme_manager)
+        renddercontent.render(site.theme_manager)
 
     @staticmethod
     @hook_impl
@@ -290,7 +290,7 @@ class TestPlugin:
         print("PostRenderContent")
         postrendercontent = PostRenderContent()
         postrendercontent.site = site
-        postrendercontent.render("./", site.theme_manager)
+        postrendercontent.render(site.theme_manager)
 
     @staticmethod
     @hook_impl
@@ -303,7 +303,7 @@ class TestPlugin:
         print("PreBuildCollection")
         prebuildcollection = PreBuildCollection()
         prebuildcollection.site = site
-        prebuildcollection.render("./", site.theme_manager)
+        prebuildcollection.render(site.theme_manager)
 
     @staticmethod
     @hook_impl
@@ -315,7 +315,7 @@ class TestPlugin:
         print("PostBuildCollection")
         postbuildcollection = PostBuildCollection()
         postbuildcollection.site = site
-        postbuildcollection.render("./", site.theme_manager)
+        postbuildcollection.render(site.theme_manager)
 
 
 @pytest.fixture(scope="function")

{render_engine-2026.1.1a1 → render_engine-2026.1.1a2}/tests/test_templates/test_base_html.py

@@ -33,7 +33,7 @@ def test_base_html_body_class(theme_site):
 
     theme_site.register_themes(BodyClassTheme)
     theme_site.route_list["testpage"].site = theme_site
-    theme_site.route_list["testpage"].render("./", theme_site.theme_manager)
+    theme_site.route_list["testpage"].render(theme_site.theme_manager)
 
     assert '<body class="my-class">' in (theme_site.output_path / "testpage.html").read_text()
 
@@ -51,7 +51,7 @@ def test_base_html_head_include(theme_site):
     theme_site.register_themes(HeadIncludeTheme)
     theme_site.load_themes()
     theme_site.route_list["testpage"].site = theme_site
-    theme_site.route_list["testpage"].render("./", theme_site.theme_manager)
+    theme_site.route_list["testpage"].render(theme_site.theme_manager)
 
     assert "<script>console.log('test')</script>" in (theme_site.output_path / "testpage.html").read_text()