re-plugin-pack 2025.6.1b1__tar.gz

re_plugin_pack-2025.6.1b1/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Dan Shernicoff
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

re_plugin_pack-2025.6.1b1/PKG-INFO

@@ -0,0 +1,224 @@
+Metadata-Version: 2.4
+Name: re-plugin-pack
+Version: 2025.6.1b1
+Summary: Plugin pack for render-engine static site generator
+Author: Dan Shernicoff
+Author-email: Dan Shernicoff <dan@brassnet.biz>
+License-Expression: MIT
+License-File: LICENSE.md
+Requires-Dist: render-engine>=2025.6.1b1
+Requires-Python: >=3.10
+Project-URL: Repository, https://github.com/brass75/re-plugin-pack
+Project-URL: homepage, https://github.com/brass75/re-plugin-pack
+Description-Content-Type: text/markdown
+
+# re-plugin-pack
+
+This is a plugin pack for the `render-engine` static site generator. It currently includes the
+following plugins:
+
+- [`LatestEntries`](#latestentries)
+- [`NextPrevPlugin`](#nextprevplugin)
+
+## `LatestEntries`
+
+This plugin will add a list of the latest entries for one or more `Collection`s to a given `Page`.
+It can be configured at the Page or `Site` levels and can be configured to provide the latest entries
+for any number of `Collection`s. The entries used are in the sort order as defined in the `Collection` 
+object.
+
+### Settings
+
+The plugin has the following default settings:
+
+```python
+{
+    "collection": ["url"],
+    "entries": ["title", "url"],
+    "pages": ["index"],
+    "max_entries": 3,
+}
+```
+- `collection` - a list of attributes to include for the collection.
+- `entries` - a list of attributes to include for a given entry.
+- `pages` - a list of pages to add the `COLLECTIONS` entry to it's `template_vars` (Only needed when running as a 
+`Site` plugin)
+- `max_entries` - The maximum number of entries to include for a collection. The default is 3. `-1` indicates 
+that all entries should be populated. 
+
+In addition to the default settings entries can be added for each `Collection` defining how many
+entries it should include:
+
+- Positive integer - Include up to the number specified entries. For example: `'Collection1': 5` 
+will include the 5 latest entries in the `template_vars`.
+- `0` - Exclude this collection. For example: `'Collection2': 0` will not include `Collection2` 
+in the `template_vars`.
+- Negative integer - Include all entries. For example: `'Collection3': -1` will include all
+entries for `Collection3` in the `template_vars`
+
+### `Page` level configuration
+
+To configure at the `Page` level just include `(LatestEntris, <settings_dict)` in the `plugins` 
+attribute when declaring the `Page`. If no settings overrides are needed, include `LatestEntries`
+by itself in the `plugin` attribute.
+
+Example:
+```python
+from render_engine import Site, Page
+from re-plugin-pack import LatestEntries
+
+app = Site()
+@app.page
+class MyPage(Page):
+    plugins = [
+        (
+            LatestEntries,
+            {
+                "Collection1": 5,  # Include the 5 most recent entries
+                "Collection2": 0,  # Exclude this collection
+                "Collection3": -1,  # Include all entries in the collection
+            },
+        )
+    ]
+    ...
+```
+
+### `Site` level configuration
+
+To configure at the `Site` level call `app.register_plugins(LatestEntries, LatestEntries=<settings>)`
+if settings overrides are being used. To configure without additional settings, call
+`app.register_plugin(LatestEntries)`.
+
+Example:
+```python
+from render_engine import Site, Page
+from re-plugin-pack import LatestEntries
+
+app = Site()
+
+# The following will use the default settings overriding the pages to run on to be page1 and page2
+app.register_plugins(LatestEntries, LatestEntries={'pages': ['page1', 'page2']})
+
+# The following will only enable for the Blog collection:
+app.register_plugins(LatestEntries, LatestEntries={'max_entries': 0, 'Blog': 3})
+```
+
+NOTE: If configuring at the `Site` level the registration should be done _after_ adding all 
+`Page` entries to the `Site`. When adding a `Page` to a `Site` all plugins registered to the
+`Site` are automatically registered to the new `Page` object.
+
+### Including in the `Page` template
+
+The latest entries will be added to the `COLLECTIONS` key of the `template_vars` for the `Page`
+and can be accessed in the template as `COLLECTIONS`.
+
+Example template implementation:
+```
+{% for collection, collection_data in COLLECTIONS.items() %}
+    Most recent <a href="{{ collection_data['url'] }}">{{ collection }}</a> entries:
+    <ul>
+    {% for entry in collection_data['entries'] %}
+        <li><a href="{{ entry['url'] }}">{{ entry['title'] }}</a></li>
+    {% endfor %}
+    </ul>
+{% endfor %}
+```
+
+## `NextPrevPlugin`
+
+This plugin will give each page in a `Collection` access to certain attributes of the next and 
+previous pages in the collection. By default, only the URL and title of those pages will be
+made available, however additional attributes may also be requested via the settings. If an
+attributes is in the list to include but does not exist in the page(s) `None` will be used.
+This plugin runs at the `Collection` level and can be registered at the `Site` or `Collection`
+level.
+
+### Settings
+
+This plugin has no default settings. If you wish to add additional attributes, include in the
+registration a settings dictionary with a key of `additional_attributes` having a list of 
+attributes as its value.
+
+### `Site` level configuration
+
+To configure at the `Site` level call `app.register_plugins(NextPrevPlugin, NextPrevPlugin=<settings>)`
+if settings overrides are being used. To configure without additional settings, call
+`app.register_plugin(NextPrevPlugin)`.
+
+Example:
+```python
+from render_engine import Site, Page
+from re-plugin-pack import NextPrevPlugin
+
+app = Site()
+
+# The following will include the date attribute in in the data made available.
+app.register_plugins(NextPrevPlugin, NextPrevPlugin={'additional_attributes': ['date']})
+
+# The following will not include any additional attributes
+app.register_plugins(NextPrevPlugin)
+```
+
+NOTE: If configuring at the `Site` level the registration should be done _after_ adding all 
+`Collection` entries to the `Site`. When adding a `Collection` to a `Site` all plugins 
+registered to the `Site` are automatically registered to the new `Collection` object.
+
+### `Collection` level configuration
+
+To configure at the `Page` level just include `(NextPrevPlugin, <settings_dict)` in the `plugins` 
+attribute when declaring the `Collection`. If no settings overrides are needed, include
+`NextPrevPlugin` by itself in the `plugin` attribute.
+
+Example:
+```python
+from render_engine import Site, Page
+from re-plugin-pack import NextPrevPlugin
+
+app = Site()
+@app.page
+class MyPage(Page):
+    plugins = [
+        (
+            NextPrevPlugin,
+            {
+                'additional_attributes': [  # This will make the date and description attributes available
+                    'date',
+                    'description',
+                ]
+            },
+        )
+    ]
+    ...
+```
+
+### Including in the `Collection` template
+
+When run this plugin will add a dictionary with the requested data to the `template_vars` of 
+each page in the `Collection`. The dictionary added looks like:
+
+```python
+{
+    'collection_url': <url>,
+    'collection_title': <title>,
+    'next_url': <url>,
+    'next_title': <title>,
+    'prev_url': <url>,
+    'prev_title': <title>,
+}
+```
+
+If `additional_attributes` are included in the settings, they will be in the dictionary as:
+`prev_<attr>: <value>` and `next_<attr>: <value>`.
+
+```
+{% if prev_url %}
+<span class="prev_data">
+Previous: <a href="{{ prev_url }}">{{ prev_title }}</a>
+</span>
+{% endif %}
+{% if next_url %}
+<span class="next_data">
+Next: <a href="{{ next_url }}">{{ next_title }}</a>
+</span>
+{% endif %}
+```

re_plugin_pack-2025.6.1b1/README.md

@@ -0,0 +1,210 @@
+# re-plugin-pack
+
+This is a plugin pack for the `render-engine` static site generator. It currently includes the
+following plugins:
+
+- [`LatestEntries`](#latestentries)
+- [`NextPrevPlugin`](#nextprevplugin)
+
+## `LatestEntries`
+
+This plugin will add a list of the latest entries for one or more `Collection`s to a given `Page`.
+It can be configured at the Page or `Site` levels and can be configured to provide the latest entries
+for any number of `Collection`s. The entries used are in the sort order as defined in the `Collection` 
+object.
+
+### Settings
+
+The plugin has the following default settings:
+
+```python
+{
+    "collection": ["url"],
+    "entries": ["title", "url"],
+    "pages": ["index"],
+    "max_entries": 3,
+}
+```
+- `collection` - a list of attributes to include for the collection.
+- `entries` - a list of attributes to include for a given entry.
+- `pages` - a list of pages to add the `COLLECTIONS` entry to it's `template_vars` (Only needed when running as a 
+`Site` plugin)
+- `max_entries` - The maximum number of entries to include for a collection. The default is 3. `-1` indicates 
+that all entries should be populated. 
+
+In addition to the default settings entries can be added for each `Collection` defining how many
+entries it should include:
+
+- Positive integer - Include up to the number specified entries. For example: `'Collection1': 5` 
+will include the 5 latest entries in the `template_vars`.
+- `0` - Exclude this collection. For example: `'Collection2': 0` will not include `Collection2` 
+in the `template_vars`.
+- Negative integer - Include all entries. For example: `'Collection3': -1` will include all
+entries for `Collection3` in the `template_vars`
+
+### `Page` level configuration
+
+To configure at the `Page` level just include `(LatestEntris, <settings_dict)` in the `plugins` 
+attribute when declaring the `Page`. If no settings overrides are needed, include `LatestEntries`
+by itself in the `plugin` attribute.
+
+Example:
+```python
+from render_engine import Site, Page
+from re-plugin-pack import LatestEntries
+
+app = Site()
+@app.page
+class MyPage(Page):
+    plugins = [
+        (
+            LatestEntries,
+            {
+                "Collection1": 5,  # Include the 5 most recent entries
+                "Collection2": 0,  # Exclude this collection
+                "Collection3": -1,  # Include all entries in the collection
+            },
+        )
+    ]
+    ...
+```
+
+### `Site` level configuration
+
+To configure at the `Site` level call `app.register_plugins(LatestEntries, LatestEntries=<settings>)`
+if settings overrides are being used. To configure without additional settings, call
+`app.register_plugin(LatestEntries)`.
+
+Example:
+```python
+from render_engine import Site, Page
+from re-plugin-pack import LatestEntries
+
+app = Site()
+
+# The following will use the default settings overriding the pages to run on to be page1 and page2
+app.register_plugins(LatestEntries, LatestEntries={'pages': ['page1', 'page2']})
+
+# The following will only enable for the Blog collection:
+app.register_plugins(LatestEntries, LatestEntries={'max_entries': 0, 'Blog': 3})
+```
+
+NOTE: If configuring at the `Site` level the registration should be done _after_ adding all 
+`Page` entries to the `Site`. When adding a `Page` to a `Site` all plugins registered to the
+`Site` are automatically registered to the new `Page` object.
+
+### Including in the `Page` template
+
+The latest entries will be added to the `COLLECTIONS` key of the `template_vars` for the `Page`
+and can be accessed in the template as `COLLECTIONS`.
+
+Example template implementation:
+```
+{% for collection, collection_data in COLLECTIONS.items() %}
+    Most recent <a href="{{ collection_data['url'] }}">{{ collection }}</a> entries:
+    <ul>
+    {% for entry in collection_data['entries'] %}
+        <li><a href="{{ entry['url'] }}">{{ entry['title'] }}</a></li>
+    {% endfor %}
+    </ul>
+{% endfor %}
+```
+
+## `NextPrevPlugin`
+
+This plugin will give each page in a `Collection` access to certain attributes of the next and 
+previous pages in the collection. By default, only the URL and title of those pages will be
+made available, however additional attributes may also be requested via the settings. If an
+attributes is in the list to include but does not exist in the page(s) `None` will be used.
+This plugin runs at the `Collection` level and can be registered at the `Site` or `Collection`
+level.
+
+### Settings
+
+This plugin has no default settings. If you wish to add additional attributes, include in the
+registration a settings dictionary with a key of `additional_attributes` having a list of 
+attributes as its value.
+
+### `Site` level configuration
+
+To configure at the `Site` level call `app.register_plugins(NextPrevPlugin, NextPrevPlugin=<settings>)`
+if settings overrides are being used. To configure without additional settings, call
+`app.register_plugin(NextPrevPlugin)`.
+
+Example:
+```python
+from render_engine import Site, Page
+from re-plugin-pack import NextPrevPlugin
+
+app = Site()
+
+# The following will include the date attribute in in the data made available.
+app.register_plugins(NextPrevPlugin, NextPrevPlugin={'additional_attributes': ['date']})
+
+# The following will not include any additional attributes
+app.register_plugins(NextPrevPlugin)
+```
+
+NOTE: If configuring at the `Site` level the registration should be done _after_ adding all 
+`Collection` entries to the `Site`. When adding a `Collection` to a `Site` all plugins 
+registered to the `Site` are automatically registered to the new `Collection` object.
+
+### `Collection` level configuration
+
+To configure at the `Page` level just include `(NextPrevPlugin, <settings_dict)` in the `plugins` 
+attribute when declaring the `Collection`. If no settings overrides are needed, include
+`NextPrevPlugin` by itself in the `plugin` attribute.
+
+Example:
+```python
+from render_engine import Site, Page
+from re-plugin-pack import NextPrevPlugin
+
+app = Site()
+@app.page
+class MyPage(Page):
+    plugins = [
+        (
+            NextPrevPlugin,
+            {
+                'additional_attributes': [  # This will make the date and description attributes available
+                    'date',
+                    'description',
+                ]
+            },
+        )
+    ]
+    ...
+```
+
+### Including in the `Collection` template
+
+When run this plugin will add a dictionary with the requested data to the `template_vars` of 
+each page in the `Collection`. The dictionary added looks like:
+
+```python
+{
+    'collection_url': <url>,
+    'collection_title': <title>,
+    'next_url': <url>,
+    'next_title': <title>,
+    'prev_url': <url>,
+    'prev_title': <title>,
+}
+```
+
+If `additional_attributes` are included in the settings, they will be in the dictionary as:
+`prev_<attr>: <value>` and `next_<attr>: <value>`.
+
+```
+{% if prev_url %}
+<span class="prev_data">
+Previous: <a href="{{ prev_url }}">{{ prev_title }}</a>
+</span>
+{% endif %}
+{% if next_url %}
+<span class="next_data">
+Next: <a href="{{ next_url }}">{{ next_title }}</a>
+</span>
+{% endif %}
+```

re_plugin_pack-2025.6.1b1/pyproject.toml

@@ -0,0 +1,57 @@
+[project]
+name = "re_plugin_pack"
+version = "2025.6.1b1"
+description = "Plugin pack for render-engine static site generator"
+readme = "README.md"
+authors = [{name = "Dan Shernicoff", email = "dan@brassnet.biz"}]
+license = "MIT"
+license-files = ["LICENSE.md"]
+requires-python = ">=3.10"
+dependencies = [
+    "render-engine>=2025.6.1b1",
+]
+
+[dependency-groups]
+dev = [
+    "coverage>=7.8.0",
+    "freezegun>=1.5.2",
+    "pytest>=8.4.0",
+    "uv-build>=0.7.12,<0.8.0",
+    "ruff"
+]
+
+[project.urls]
+homepage = "https://github.com/brass75/re-plugin-pack"
+Repository = "https://github.com/brass75/re-plugin-pack"
+
+[tool.ruff]
+target-version = "py312"
+# Allow lines to be as long as 120 characters.
+line-length = 120
+lint.select = [
+  "E",   # pycodestyle
+  "F",   # pyflakes
+  "UP",  # pyupgrade
+  "I",   # imports
+]
+
+
+lint.ignore = [
+]
+
+# Allow fix for all enabled rules (when `--fix`) is provided.
+lint.fixable = ["ALL"]
+lint.unfixable = []
+
+exclude = [
+]
+
+[tool.ruff.format]
+quote-style = "single"
+indent-style = "space"
+docstring-code-format = true
+
+[build-system]
+requires = ["uv_build>=0.7.12,<0.8.0"]
+build-backend = "uv_build"
+

re_plugin_pack-2025.6.1b1/src/re_plugin_pack/__init__.py

@@ -0,0 +1,4 @@
+from .plugins.latest_entries import LatestEntries
+from .plugins.next_prev import NextPrevPlugin
+
+__all__ = [LatestEntries, NextPrevPlugin]

re_plugin_pack-2025.6.1b1/src/re_plugin_pack/plugins/latest_entries.py

@@ -0,0 +1,133 @@
+"""Plugin for giving the latest entries"""
+
+from render_engine import Collection, Page, Site
+from render_engine.plugins import hook_impl
+
+
+class LatestEntries:
+    """
+    Adds a dictionary to the index page's template_vars:
+
+    default_settings = {
+        "collection": ["url"],
+        "entries": ["title", "url"],
+        "pages": ["index"],
+        "max_entries": 3,
+    }
+
+    To override the default number of entries add to the registration:
+    {<collection title>: <max entries>}
+    To disable set max entries to 0 for that collection
+    To print all entries for a given collection set max entries to a negative number
+
+    Can be registered on the Site object:
+    app.register_plugins(LatestEntries, LatestEntries=<settings overrides>)
+
+    Can be registered for an individual Page include it in the definition of the page:
+    @app.page
+    class MyPage(Page):
+        plugins = [
+            (
+                LatestEntries,
+                {
+                    "Collection1": 5,  # Include the 5 most recent entries
+                    "Collection2": 0,  # Exclude this collection
+                    "Collection3": -1,  # Include all entries in the collection
+                },
+            )
+        ]
+    NOTE: If registering the plugin for an individual page the "page" part of the settings
+          is irrelevant and not looked at. That settings is for when registering for the site.
+
+    NOTE: "Most recent" is defined by the sort order for the given collection.
+          The default for a Collection is "title" and the default for a Blog is date.
+          You can override the sort order (which will affect the sorting for everything,
+          just this plugin) by initializing the Collection object with the following attribute:
+                sort_by = <sort attribute>
+
+    To use put this into your index.html template or content:
+    {% for collection, collection_data in COLLECTIONS.items() %}
+        Most recent <a href="{{ collection_data['url'] }}">{{ collection }}</a> entries:
+        <ul>
+        {% for entry in collection_data['entries'] %}
+            <li><a href="{{ entry['url'] }}">{{ entry['title'] }}</a></li>
+        {% endfor %}
+        </ul>
+    {% endfor %}
+
+    NOTE: Above example is using the default settings.
+    """
+
+    default_settings = {
+        'collection': ['url'],
+        'entries': ['title', 'url'],
+        'pages': ['index'],
+        'max_entries': 3,
+    }
+
+    @staticmethod
+    @hook_impl
+    def pre_build_site(site: Site, settings: dict):
+        """
+        Pre-build site hook
+
+        :param site: Site object
+        :param settings: Settings dictionary [Not currently used but required by the hook]
+        """
+        settings = settings['LatestEntries']
+        pages = settings.get('pages', list())
+        for page_entry in pages:
+            page = site.route_list[page_entry]
+            LatestEntries.build_latest_entries(site=site, page=page, settings=settings)
+
+    @staticmethod
+    @hook_impl
+    def render_content(page: Page, settings: dict, site: Site):
+        """
+        Render content hook
+
+        :param page: The page to update
+        :param settings: The settings for the plugin
+        :param site: The Site object.
+        """
+        LatestEntries.build_latest_entries(site, page, settings['LatestEntries'])
+
+    @staticmethod
+    def build_latest_entries(site: Site, page: Page, settings: dict):
+        """
+        Update the page with the latest entries.
+
+        :param page: The page to update
+        :param settings: The settings for the plugin
+        :param site: The Site object.
+        """
+        collections = dict()
+        for name, collection in site.route_list.items():
+            if isinstance(collection, Collection):
+                if not (max_entries := settings.get(collection.title, settings['max_entries'])):
+                    continue
+                if max_entries < 0:
+                    max_entries = len(collection.sorted_pages)
+                collections[collection.title] = {'entries': list()}
+                for attr in settings['collection']:
+                    if attr == 'url':
+                        value = f'/{collection.routes[0]}/'
+                    else:
+                        value = getattr(collection, attr, None)
+                    collections[collection.title][attr] = value
+                for entry in collection.sorted_pages[:max_entries]:
+                    entry_dict = dict()
+                    for attr in settings['entries']:
+                        if attr == 'url':
+                            value = f'/{entry.routes[0]}/{entry._slug}.html'
+                        else:
+                            value = getattr(entry, attr, None)
+                        entry_dict[attr] = value
+                    collections[collection.title]['entries'].append(entry_dict)
+
+        if not hasattr(page, 'template_vars'):
+            page.template_vars = dict()
+        if existing_collections := page.template_vars.get('COLLECTIONS'):
+            existing_collections.update(collections)
+        else:
+            page.template_vars['COLLECTIONS'] = collections

re_plugin_pack-2025.6.1b1/src/re_plugin_pack/plugins/next_prev.py

@@ -0,0 +1,57 @@
+"""Plugin to add next & prev links to items in a collection"""
+
+from render_engine import Collection, Site
+from render_engine.plugins import hook_impl
+
+
+class NextPrevPlugin:
+    default_settings = {}
+
+    @staticmethod
+    @hook_impl
+    def pre_build_collection(collection: Collection, site: Site, settings: dict):
+        """
+        Update a list of pages with links for the previous and next posts abd the URL for the Collection archive.
+
+        Can be registered with the Site or one or more Collections.
+
+        Note that if the sort is reversed for the collection (which is the default for Blog) you will
+             want to have `reversed: true` for the settings of this plugin.
+
+        Example implementation:
+        {% if collection_url %}
+            <hr/>
+            <p style="text-align: center;">
+            {% if prev_url %}
+            Previous: <a href="{{ prev_url }}">{{ prev_title }}</a>&nbsp;&nbsp;&nbsp;&nbsp;
+            {% endif %}
+            {% if next_url %}
+            &nbsp;&nbsp;&nbsp;&nbsp;Next: <a href="{{ next_url }}">{{ next_title }}</a>
+            {% endif %}
+            </p>
+        {% endif %}
+
+        :param collection: Collection instance
+        :param site: Site object - not used but part of the prototype for this hook
+        :param settings: Plugin settings
+        """
+        settings = settings['NextPrevPlugin']
+        reverse = collection.sort_reverse
+        pages = collection.sorted_pages[::-1] if reverse else collection.sorted_pages
+        collection_url = collection.routes[0]
+        max_page = len(pages) - 1
+        for i, page in enumerate(pages):
+            template_vars = dict()
+            if i < max_page:
+                template_vars['next_url'] = pages[i + 1].url_for()
+                template_vars['next_title'] = pages[i + 1].title
+                for attr in settings.get('additional_attributes', list()):
+                    template_vars[f'next_{attr}'] = getattr(pages[i + 1], attr, None)
+            if i > 0:
+                template_vars['prev_url'] = pages[i - 1].url_for()
+                template_vars['prev_title'] = pages[i - 1].title
+                for attr in settings.get('additional_attributes', list()):
+                    template_vars[f'prev_{attr}'] = getattr(pages[i - 1], attr, None)
+            template_vars['collection_url'] = collection_url
+            template_vars['collection_title'] = collection._title
+            page.template_vars = template_vars