render-engine 2025.10.3a1__tar.gz → 2025.11.1a1__tar.gz

{render_engine-2025.10.3a1 → render_engine-2025.11.1a1}/.gitignore

@@ -166,3 +166,5 @@ untitled-site/
 
 .DS_Store
 .python-version
+
+__version__.py

{render_engine-2025.10.3a1 → render_engine-2025.11.1a1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: render_engine
-Version: 2025.10.3a1
+Version: 2025.11.1a1
 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.3a1 → render_engine-2025.11.1a1}/pyproject.toml

@@ -42,9 +42,9 @@ dev = [
   "watchfiles",
 ]
 
-
 [tool.setuptools_scm]
 local_scheme = "no-local-version"
+version_file = "src/render_engine/__version__.py"
 # version_scheme = "python-simplified-semver"
 
 [project.urls]

render_engine-2025.11.1a1/src/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.1a1'
+__version_tuple__ = version_tuple = (2025, 11, 1, 'a1')
+
+__commit_id__ = commit_id = 'g5ed5705d6'

{render_engine-2025.10.3a1 → render_engine-2025.11.1a1}/src/render_engine/collection.py

@@ -288,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-2025.10.3a1 → render_engine-2025.11.1a1}/src/render_engine/content_managers/base_content_manager.py

@@ -1,5 +1,6 @@
 from abc import ABC, abstractmethod
 from collections.abc import Generator, Iterable
+from pathlib import Path
 
 
 class ContentManager(ABC):
@@ -14,3 +15,8 @@ class ContentManager(ABC):
     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-2025.10.3a1 → render_engine-2025.11.1a1}/src/render_engine/content_managers/file_content_manager.py

@@ -1,3 +1,4 @@
+import subprocess
 from collections.abc import Iterable
 from pathlib import Path
 
@@ -34,3 +35,23 @@ class FileContentManager(ContentManager):
     @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-2025.10.3a1 → render_engine-2025.11.1a1}/src/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-2025.10.3a1 → render_engine-2025.11.1a1}/src/render_engine.egg-info/PKG-INFO

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

@@ -63,6 +63,7 @@ docs/docs/getting-started/layout.md
 src/render_engine/.gitignore
 src/render_engine/__init__.py
 src/render_engine/__main__.py
+src/render_engine/__version__.py
 src/render_engine/_base_object.py
 src/render_engine/archive.py
 src/render_engine/blog.py

{render_engine-2025.10.3a1 → render_engine-2025.11.1a1}/tests/test_collections.py

@@ -1,4 +1,5 @@
 import pathlib
+import textwrap
 
 import pluggy
 import pytest
@@ -360,3 +361,58 @@ def test_collection_custom_sort_by_list_with_date():
 
     # Verify the sorted order by checking custom_sort_content values
     assert [page.custom_sort_content for page in sorted_pages] == [page.custom_sort_content for page in expected_pages]
+
+
+@pytest.mark.parametrize(
+    "content, context, expected",
+    [
+        (
+            "",
+            {"title": "title"},
+            textwrap.dedent("""---
+title: title
+---
+
+Hello, world!"""),
+        ),
+        (
+            "test",
+            {},
+            textwrap.dedent("""---
+title: Untitled Entry
+---
+
+test"""),
+        ),
+        (
+            "",
+            {},
+            textwrap.dedent("""---
+title: Untitled Entry
+---
+
+Hello, world!"""),
+        ),
+    ],
+)
+def test_create_entry(tmp_path: pathlib.Path, content, context, expected):
+    """Test the create_entry method"""
+    tmp_dir = tmp_path / "content"
+    tmp_dir.mkdir()
+
+    class BasicCollection(Collection):
+        content_path = tmp_dir.absolute()
+
+    filename = "test.md"
+    filepath = tmp_dir / filename
+    assert str(filepath) in BasicCollection().create_entry(
+        filepath=filepath, editor=None, content=content, metadata=context
+    )
+    assert filepath.read_text().strip() == expected
+
+
+def test_create_entry_no_filename():
+    """Test create_entry with no filename raises an exception"""
+    # Since the base Collection object uses a FileContentManager
+    with pytest.raises(ValueError):
+        Collection().create_entry()