PyPI - moosey-cms - Versions diffs - 0.4.0__tar.gz → 0.6.0__tar.gz - Mend

moosey-cms 0.4.0tar.gz → 0.6.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 (36) hide show

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moosey-cms
-Version: 0.4.0
+Version: 0.6.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.4.0 → moosey_cms-0.6.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.6.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.4.0 → moosey_cms-0.6.0}/pyproject.toml RENAMED Viewed

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

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/src/moosey_cms/filters.py RENAMED Viewed

@@ -472,6 +472,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
 # ============================================================================
@@ -511,7 +548,9 @@ 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.4.0 → moosey_cms-0.6.0}/src/moosey_cms/hot_reload_script.py RENAMED Viewed

@@ -17,11 +17,13 @@ class ScriptInjectorMiddleware(BaseHTTPMiddleware):
         self.script = script
     async def dispatch(self, request: Request, call_next):
         # Process the request and get the response
         response = await call_next(request)
         # We only want to touch HTML pages, not JSON APIs or Images
         content_type = response.headers.get("content-type", "")
         # get content length
         content_length = response.headers.get("content-length")
@@ -29,11 +31,10 @@ class ScriptInjectorMiddleware(BaseHTTPMiddleware):
         if "text/html" not in content_type:
             return response
-        # Skip if too big (e.g. > 20KB) to prevent Memory DoS
-        if content_length and int(content_length) > 20 * 1024 :
+        # Skip if too big (e.g. > 10mb) to prevent Memory DoS
+        if content_length and int(content_length) > 10 * 1024 * 1024 :
             return response
         # Read the response body
         # Note: Response body is a stream, we must consume it to modify it
         response_body = [section async for section in response.body_iterator]
@@ -51,6 +52,7 @@ class ScriptInjectorMiddleware(BaseHTTPMiddleware):
             # Fallback: Just append if no body tag found
             full_body += injection
         # Create a NEW Response object
         # We cannot modify the existing response easily because Content-Length
         # would be wrong. Creating a new one recalculates headers.
@@ -69,6 +71,7 @@ class ScriptInjectorMiddleware(BaseHTTPMiddleware):
 def inject_script_middleware(app, host, port):
+    # print('>>>>>>IIIIII')
     # Your custom script to inject
     package_root = Path(__file__).resolve().parent
     javascript_file = package_root / "static" / "js" / "reload-script.js"
@@ -85,6 +88,8 @@ def inject_script_middleware(app, host, port):
         f"{host}:{port}",
     )
+    # print('RELOAD ', script_data)
     # Add the middleware
     app.add_middleware(
         ScriptInjectorMiddleware, script=f"<script>{script_data}</script>"

{moosey_cms-0.4.0 → moosey_cms-0.6.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.4.0/src/moosey_cms/.python-version DELETED Viewed

	@@ -1 +0,0 @@
1	- 3.12

moosey_cms-0.4.0/src/moosey_cms/py.typed DELETED Viewed

File without changes

moosey_cms-0.4.0/src/moosey_cms/pyproject.toml DELETED Viewed

@@ -1,28 +0,0 @@
-[project]
-name = "moosey-cms"
-version = "0.1.0"
-description = "A drop-in Markdown CMS for FastAPI with Hot Reloading"
-readme = "README.md"
-requires-python = ">=3.12"
-dependencies = [
-    "cachetools>=6.2.4",
-    "inflection>=0.5.1",
-    "jinja2>=3.1.6",
-    "markdown>=3.10",
-    "pymdown-extensions>=10.20",
-    "python-frontmatter>=1.1.0",
-    "python-slugify>=8.0.4",
-    "slugify>=0.0.1",
-]
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-# --- CRITICAL: INCLUDE STATIC FILES ---
-[tool.hatch.build.targets.wheel]
-packages = ["src/moosey_cms"]
-# This forces the inclusion of non-python files inside the package
-[tool.hatch.build.targets.wheel.force-include]
-"src/simple_cms/static" = "moosey_cms/static"

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/.gitignore RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/.python-version RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/example/assets/example-1.jpeg RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/example/assets/example-2.jpeg RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/example/content/about.md RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/example/content/index.md RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/example/content/pages/features.md RENAMED Viewed

File without changes

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

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/example/content/posts/index.md RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/example/main.py RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/example/templates/404.html RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/example/templates/components/sidebar.html RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/example/templates/index.html RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/example/templates/layout/base.html RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/example/templates/page.html RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/example/templates/post.html RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/example/templates/posts.html RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/src/moosey_cms/__init__.py RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/src/moosey_cms/cache.py RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/src/moosey_cms/file_watcher.py RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/src/moosey_cms/helpers.py RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/src/moosey_cms/md.py RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/src/moosey_cms/models.py RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/src/moosey_cms/seo.py RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/src/moosey_cms/static/js/reload-script.js RENAMED Viewed

File without changes

{moosey_cms-0.4.0 → moosey_cms-0.6.0}/uv.lock RENAMED Viewed

File without changes

moosey-cms 0.4.0__tar.gz → 0.6.0__tar.gz

moosey-cms 0.4.0tar.gz → 0.6.0tar.gz