PyPI - moosey-cms - Versions diffs - 0.5.0__tar.gz → 0.7.0__tar.gz - Mend

moosey-cms 0.5.0tar.gz → 0.7.0tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (33) hide show

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moosey-cms
-Version: 0.5.0
+Version: 0.7.0
 Summary: Add your description here
 Requires-Python: >=3.9
 Requires-Dist: cachetools>=6.2.4
@@ -259,6 +259,8 @@ Moosey CMS comes packed with a comprehensive library of Jinja2 filters to help y
 ---
+[Read More On Filters](docs/filters.md) and how to use some interesting ones such as stripping comments.
 ## ⚙️ Configuration Reference
 The `init_cms` function accepts the following parameters:

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/README.md RENAMED Viewed

@@ -242,6 +242,8 @@ Moosey CMS comes packed with a comprehensive library of Jinja2 filters to help y
 ---
+[Read More On Filters](docs/filters.md) and how to use some interesting ones such as stripping comments.
 ## ⚙️ Configuration Reference
 The `init_cms` function accepts the following parameters:

moosey_cms-0.7.0/docs/filters.md ADDED Viewed

@@ -0,0 +1,184 @@
+<!--
+ Copyright (c) 2026 Anthony Mugendi
+ This software is released under the MIT License.
+ https://opensource.org/licenses/MIT
+-->
+# Template Filters
+Moosey CMS comes equipped with a powerful suite of Jinja2 filters. These allow you to format data, manipulate text, and clean up HTML directly within your Markdown files or HTML templates.
+## Usage
+Filters are applied using the pipe symbol (`|`). You can chain multiple filters together.
+```jinja
+{{ variable | filter_name }}
+{{ variable | filter1 | filter2 }}
+```
+---
+## 🧹 HTML & Structure
+### `strip_comments`
+**Type:** Block Filter
+Removes HTML comments (`<!-- ... -->`) from the enclosed content. This is useful for keeping production code clean while leaving comments in for development.
+**Arguments:**
+*   `enabled` (bool): If `False`, comments are preserved. Default is `True`.
+**Usage:**
+You typically wrap your entire `base.html` layout with this.
+```jinja
+<!-- example/templates/layout/base.html -->
+<!-- Only strip comments if not in development mode -->
+{% filter strip_comments(enabled=(mode != 'development')) %}
+    <!DOCTYPE html>
+    <html>
+        <head>
+            <!-- This comment will vanish in production -->
+            <title>{{ title }}</title>
+        </head>
+        <body>
+            {{ content }}
+        </body>
+    </html>
+{% endfilter %}
+```
+### `minify_html`
+**Type:** Block Filter
+Reduces file size by removing newlines, tabs, and extra spaces. It collapses multiple spaces into one and removes whitespace between HTML tags.
+**Arguments:**
+*   `enabled` (bool): Default `True`.
+**⚠️ Important Note:**
+This filter is "aggressive." It does not detect `<pre>` or `<textarea>` tags. If you use code blocks where indentation must be preserved exactly, consider disabling this filter or handling those blocks separately.
+**Usage Example:**
+```jinja
+{% minify_html(enabled=(mode != 'development')) %}
+    <html>
+      ...
+    </html>
+{% endfilter %}
+```
+**Combined Usage Example:**
+This is the recommended setup for your `base.html` file to ensure maximum performance in production while keeping development easy.
+```jinja
+{% filter strip_comments(enabled=(mode != 'development')) | minify_html(enabled=(mode != 'development')) %}
+    <html>
+      ...
+    </html>
+{% endfilter %}
+```
+---
+## 📅 Date & Time
+Assuming `date_obj` is a Python datetime object (e.g., from `date: 2026-01-21` in frontmatter).
+| Filter | Description | Example Input | Output |
+| :--- | :--- | :--- | :--- |
+| **`fancy_date`** | Formats date with ordinal suffix. | `2026-01-21 18:00` | 21st Jan, 2026 at 6:00 PM |
+| **`short_date`** | Standard clean date format. | `2026-01-21` | Jan 21, 2026 |
+| **`iso_date`** | ISO 8601 format (good for meta tags). | `2026-01-21` | 2026-01-21 |
+| **`time_only`** | Extracts just the time. | `2026-01-21 18:00` | 6:00 PM |
+| **`relative_time`** | Human readable time difference. | `(Now - 2 hours)` | 2 hours ago |
+**Usage:**
+```jinja
+<time>{{ date.created | fancy_date }}</time>
+```
+---
+## 📝 Text Manipulation
+| Filter | Description | Example Input | Output |
+| :--- | :--- | :--- | :--- |
+| **`truncate_words`** | Cuts text after N words. | `{{ "one two three four" | truncate_words(2) }}` | one two... |
+| **`excerpt`** | Smart truncation that tries to break at the end of a sentence. | *Long paragraph* | *First few sentences...* |
+| **`title_case`** | Capitalizes words intelligently (skips "and", "the", etc). | `a tale of two cities` | A Tale of Two Cities |
+| **`slugify`** | Converts text to URL-friendly format. | `Hello World!` | `hello-world` |
+| **`smart_quotes`** | Converts straight quotes to curly quotes. | `"Hello"` | “Hello” |
+| **`read_time`** | Calculates reading time (approx 200 wpm). | *500 words text* | 3 min read |
+**Usage:**
+```jinja
+<h1>{{ title | title_case }}</h1>
+<p>{{ content | excerpt(150) }}</p>
+```
+---
+## 💰 Currency & Finance
+| Filter | Description | Arguments | Output |
+| :--- | :--- | :--- | :--- |
+| **`currency`** | Formats number with symbol. | `code` (default 'USD') | `$1,234.56` |
+| **`compact_currency`** | Shortens large numbers. | `code` (default 'USD') | `$1.5M`, `$45K` |
+| **`currency_name`** | Converts ISO code to name. | - | `KES` → `Kenyan Shilling` |
+**Usage:**
+```jinja
+<!-- Custom Currency -->
+Price: {{ 4500 | currency('EUR') }}
+<!-- Output: €4,500.00 -->
+```
+---
+## 🌍 Geography & Locale
+Requires valid ISO 3166-1 alpha-2 or alpha-3 codes.
+| Filter | Description | Example Input | Output |
+| :--- | :--- | :--- | :--- |
+| **`country_flag`** | Converts country code to Emoji flag. | `US` | 🇺🇸 |
+| **`country_name`** | Converts code to full name. | `DE` | Germany |
+| **`language_name`** | Converts language code to name. | `fr` | French |
+**Usage:**
+```jinja
+<span>Made in {{ 'JP' | country_flag }} {{ 'JP' | country_name }}</span>
+```
+---
+## 🔢 Numbers & Math
+| Filter | Description | Example Input | Output |
+| :--- | :--- | :--- | :--- |
+| **`number_format`** | Adds thousand separators. | `10000` | `10,000` |
+| **`percentage`** | Formats float as percent. | `50.5` | `50.5%` |
+| **`ordinal`** | Adds ordinal suffix to integer. | `3` | `3rd` |
+---
+## 🛠 Utilities
+| Filter | Description | Example Input | Output |
+| :--- | :--- | :--- | :--- |
+| **`filesize`** | Bytes to human readable size. | `1048576` | `1.0 MB` |
+| **`yesno`** | Boolean to text. | `True` | `Yes` (or custom) |
+| **`default_if_none`** | Fallback if value is None. | `None` | *(Default string)* |
+**Usage:**
+```jinja
+<!-- Custom Yes/No labels -->
+Active: {{ is_active | yesno("Online", "Offline") }}
+<!-- File Size -->
+Download size: {{ 2500000 | filesize }}
+```

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/pyproject.toml RENAMED Viewed

@@ -1,6 +1,6 @@
 [project]
 name = "moosey-cms"
-version = "0.5.0"
+version = "0.7.0"
 description = "Add your description here"
 readme = "README.md"
 requires-python = ">=3.9"

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/src/moosey_cms/filters.py RENAMED Viewed

@@ -47,13 +47,15 @@ def iso_date(dt):
     return dt.strftime('%Y-%m-%d')
-def relative_time(dt):
+def relative_time(dt, showAgo=True):
     """Format date as relative time (e.g., '2 hours ago', 'yesterday')"""
     if not dt:
         return ""
     now = datetime.now()
     diff = now - dt
+    ago = " ago" if showAgo else ""
     seconds = diff.total_seconds()
@@ -61,10 +63,10 @@ def relative_time(dt):
         return "just now"
     elif seconds < 3600:
         minutes = int(seconds / 60)
-        return f"{minutes} minute{'s' if minutes != 1 else ''} ago"
+        return f"{minutes} minute{'s' if minutes != 1 else ''}{ago}"
     elif seconds < 86400:
         hours = int(seconds / 3600)
-        return f"{hours} hour{'s' if hours != 1 else ''} ago"
+        return f"{hours} hour{'s' if hours != 1 else ''}{ago}"
     elif seconds < 172800:
         return "yesterday"
     elif seconds < 604800:
@@ -72,13 +74,13 @@ def relative_time(dt):
         return f"{days} days ago"
     elif seconds < 2592000:
         weeks = int(seconds / 604800)
-        return f"{weeks} week{'s' if weeks != 1 else ''} ago"
+        return f"{weeks} week{'s' if weeks != 1 else ''}{ago}"
     elif seconds < 31536000:
         months = int(seconds / 2592000)
-        return f"{months} month{'s' if months != 1 else ''} ago"
+        return f"{months} month{'s' if months != 1 else ''}{ago}"
     else:
         years = int(seconds / 31536000)
-        return f"{years} year{'s' if years != 1 else ''} ago"
+        return f"{years} year{'s' if years != 1 else ''}{ago}"
 def time_only(dt):
@@ -90,7 +92,8 @@ def time_only(dt):
         formatted = formatted[1:]
     return formatted
+def strptime(s, fmt):
+    return  datetime.strptime(s, fmt)
 # ============================================================================
 # CURRENCY FILTERS
 # ============================================================================
@@ -472,6 +475,43 @@ def read_time(text: str) -> str:
         return "1 min read"
     return f"{minutes} min read"
+# ============================================================================
+# HTML UTILITIES
+# ============================================================================
+def strip_comments(text, enabled=True):
+    """
+    Removes HTML comments from the output.
+    Usage: {% filter strip_comments(enabled=True) %} ... {% endfilter %}
+    """
+    if not enabled or not text:
+        return text
+    # Regex: Matches <!-- followed by anything (including newlines) until -->
+    # The *? ensures it is non-greedy (stops at the first closing tag)
+    return re.sub(r'<!--[\s\S]*?-->', '', str(text))
+def minify_html(text, enabled=True):
+    """
+    Minifies HTML by removing unnecessary whitespace and newlines.
+    WARNING: This is a regex-based minifier. It does not respect <pre> tags.
+    """
+    if not enabled or not text:
+        return text
+    text = str(text)
+    # 1. Normalize whitespace:
+    # Replace sequences of whitespace (tabs, newlines) with a single space
+    text = re.sub(r'\s+', ' ', text)
+    # 2. Remove space between tags:
+    # Turns "</div> <div..." into "</div><div..."
+    text = re.sub(r'>\s+<', '><', text)
+    return text.strip()
 # ============================================================================
 # REGISTRATION FUNCTION
 # ============================================================================
@@ -492,6 +532,7 @@ def register_filters(jinja_env):
         'short_date': short_date,
         'iso_date': iso_date,
         'relative_time': relative_time,
+        'strptime': strptime,
         'time_only': time_only,
         'currency': currency,
         'compact_currency': compact_currency,
@@ -511,7 +552,10 @@ def register_filters(jinja_env):
         'filesize': filesize,
         'default_if_none': default_if_none,
         'yesno': yesno,
-        'read_time':read_time
+        'read_time':read_time,
+        'strip_comments': strip_comments,
+        'minify_html': minify_html,
     }
     for name, func in filters_dict.items():

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/src/moosey_cms/main.py RENAMED Viewed

@@ -24,6 +24,30 @@ from .hot_reload_script import inject_script_middleware
 from fastapi import WebSocket, WebSocketDisconnect
+from jinja2 import Environment, FileSystemLoader
+from jinja2.ext import Extension
+import re
+class AutoRemoveCommentsExtension(Extension):
+    """Automatically removes HTML comments from all included files"""
+    def __init__(self, environment):
+        super().__init__(environment)
+        # Store original include function
+        original_include = environment.globals['include']
+        # Create wrapper that removes comments
+        def include_no_comments(template_name, **kwargs):
+            # Get the included template
+            included = environment.get_template(template_name)
+            rendered = included.render(**kwargs)
+            # Remove comments
+            return re.sub(r'<!--.*?-->', '', rendered, flags=re.DOTALL)
+        # Replace include function
+        environment.globals['include_no_comments'] = include_no_comments
 class ConnectionManager:
     def __init__(self):
@@ -81,6 +105,7 @@ def init_cms(
     # This ensures site_data is available in 404.html and base.html automatically
     templates.env.globals["site_data"] = site_data
     templates.env.globals["mode"] = mode
     # Register all custom filters once
     filters.register_filters(templates.env)

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/.gitignore RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/.python-version RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/example/assets/example-1.jpeg RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/example/assets/example-2.jpeg RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/example/content/about.md RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/example/content/index.md RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/example/content/pages/features.md RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/example/content/posts/building-modern-apps.md RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/example/content/posts/index.md RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/example/main.py RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/example/templates/404.html RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/example/templates/components/sidebar.html RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/example/templates/index.html RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/example/templates/layout/base.html RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/example/templates/page.html RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/example/templates/post.html RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/example/templates/posts.html RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/src/moosey_cms/__init__.py RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/src/moosey_cms/cache.py RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/src/moosey_cms/file_watcher.py RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/src/moosey_cms/helpers.py RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/src/moosey_cms/hot_reload_script.py RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/src/moosey_cms/md.py RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/src/moosey_cms/models.py RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/src/moosey_cms/seo.py RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/src/moosey_cms/static/js/reload-script.js RENAMED Viewed

File without changes

{moosey_cms-0.5.0 → moosey_cms-0.7.0}/uv.lock RENAMED Viewed

File without changes

moosey-cms 0.5.0__tar.gz → 0.7.0__tar.gz

moosey-cms 0.5.0tar.gz → 0.7.0tar.gz