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

render_engine/__version__.py

@@ -0,0 +1,34 @@
+# file generated by setuptools-scm
+# don't change, don't track in version control
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+    COMMIT_ID = Union[str, None]
+else:
+    VERSION_TUPLE = object
+    COMMIT_ID = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+commit_id: COMMIT_ID
+__commit_id__: COMMIT_ID
+
+__version__ = version = '2025.11.1'
+__version_tuple__ = version_tuple = (2025, 11, 1)
+
+__commit_id__ = commit_id = None

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):
         """
@@ -279,6 +288,24 @@ class Collection(BaseObject):
             feed.site = self.site
             feed.render(route="./", theme_manager=self.site.theme_manager)
 
+    def create_entry(
+        self, filepath: Path = None, editor: str = None, content: str = None, metadata: dict = None
+    ) -> str:
+        """
+        Create a new entry for the Collection
+
+        :param filepath: Path object for the new entry
+        :param editor: Editor to open to edit the entry.
+        :param content: Content for the new entry
+        :param metadata: Metadata for the new entry
+        """
+        context = copy.deepcopy(self._metadata_attrs())
+        if metadata:
+            context.update(metadata)
+        return self.content_manager.create_entry(
+            filepath=filepath, editor=editor, metadata=context, content=content or "Hello, world!"
+        )
+
 
 def render_archives(archive, **kwargs) -> list[Archive]:
     return [archive.render(pages=archive.pages, **kwargs) for archive in archive]

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,22 @@
+from abc import ABC, abstractmethod
+from collections.abc import Generator, Iterable
+from pathlib import Path
+
+
+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
+
+    @abstractmethod
+    def create_entry(self, filepath: Path = None, editor: str = None, metadata: dict = None, content: str = None):
+        """Create a new entry"""
+        ...

render_engine/content_managers/file_content_manager.py

@@ -0,0 +1,57 @@
+import subprocess
+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
+
+    def create_entry(
+        self, filepath: Path = None, editor: str = None, metadata: dict = None, content: str = None
+    ) -> str:
+        """
+        Create a new entry for the Collection
+
+        :param filepath: Path object for the new entry
+        :param editor: Editor to open to edit the entry.
+        :param content: The content for the entry
+        :param metadata: Metadata for the new entry
+        """
+        if not filepath:
+            raise ValueError("filepath needs to be specified.")
+
+        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} ."

render_engine/site.py

@@ -3,6 +3,7 @@ import logging
 from collections import defaultdict
 from pathlib import Path
 
+import rich
 from jinja2 import FileSystemLoader, PrefixLoader
 from rich.progress import Progress
 
@@ -13,6 +14,12 @@ from .plugins import PluginManager, handle_plugin_registration
 from .site_map import SiteMap
 from .themes import Theme, ThemeManager
 
+try:
+    # Get the RE version for display. If it's not set it means we're working locally.
+    from render_engine.__version__ import __version__ as re_version
+except ImportError:
+    re_version = "development"
+
 
 class Site:
     """
@@ -251,7 +258,10 @@ class Site:
         You can choose to call it manually in your file or
         use the CLI command [`render-engine build`][src.render_engine.cli.build]
         """
-
+        rich.print(
+            f"[green]Building {repr(self.site_vars.get('SITE_TITLE', 'your site'))} "
+            f"with Render Engine version {re_version}"
+        )
         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", ""))

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.1a2.dist-info → render_engine-2025.11.1.dist-info}/METADATA

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

@@ -1,10 +1,11 @@
 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=s8M9-UvQuY0Oq3E-DpMy-7tuQGi8g1QtU5RnILzjZ7c,712
 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=eqeVxZ_ASrOra7kayhAkPSHocpM1mbxwhsH6ZtK-oMk,11294
 render_engine/engine.py,sha256=GOtUiq4ny5GHaLSCeH5u1Zk1JnWJVh63vK7etJiwS20,2843
 render_engine/feeds.py,sha256=i-VHsb6pRplMzaenBn6oeqh9yI_N4WVUAExPox6iJgw,921
 render_engine/hookspecs.py,sha256=GhOpw0zTQjfwWOFYYbJ4P7Cvq-oy1MmTPHmd90dr0kg,2292
@@ -12,9 +13,12 @@ render_engine/links.py,sha256=pKmQMTz8-yGX8IecHcrlF3Dkejk7cptaO3qCkQiHB9I,2560
 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.py,sha256=aarHkveSVDOy7hRPzrx_ga3DmmirZQcLvcJdyw-b8lY,13329
+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/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 +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.10.1a2.dist-info/METADATA,sha256=7zx7Hwwq03zUMWfBOP2FfsFVOdIF4AiJKjEqsazJvOk,11895
-render_engine-2025.10.1a2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-render_engine-2025.10.1a2.dist-info/top_level.txt,sha256=aNGALDMsFyrusho04AvUjSivsgEE9tQp_LP_jGr312Q,14
-render_engine-2025.10.1a2.dist-info/RECORD,,
+render_engine-2025.11.1.dist-info/METADATA,sha256=RQFVPrcI7wh8jq6DaDPSS5Rlv-s8r1zqeSeRhlJU7Zk,11893
+render_engine-2025.11.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+render_engine-2025.11.1.dist-info/top_level.txt,sha256=aNGALDMsFyrusho04AvUjSivsgEE9tQp_LP_jGr312Q,14
+render_engine-2025.11.1.dist-info/RECORD,,