moosey-cms 0.3.0__py3-none-any.whl

moosey_cms/md.py

@@ -0,0 +1,192 @@
+"""
+Copyright (c) 2026 Anthony Mugendi
+
+This software is released under the MIT License.
+https://opensource.org/licenses/MIT
+"""
+
+import markdown as md
+from markdown.inlinepatterns import InlineProcessor
+from markdown.extensions import Extension
+import xml.etree.ElementTree as etree
+
+
+extensions = [
+    "markdown.extensions.tables",
+    "markdown.extensions.toc",
+    "pymdownx.magiclink",
+    "pymdownx.betterem",
+    "pymdownx.tilde",
+    "pymdownx.emoji",
+    "pymdownx.tasklist",
+    "pymdownx.superfences",
+    "pymdownx.saneheaders",
+    "pymdownx.arithmatex",  # <--- ADD THIS for math support
+]
+
+extension_configs = {
+    "markdown.extensions.toc": {
+        "title": "Table of Contents",
+        "permalink": False,
+        "permalink_leading": True,
+    },
+    "pymdownx.magiclink": {
+        "repo_url_shortener": True,
+        "repo_url_shorthand": True,
+        "provider": "github",
+        "user": "facelessuser",
+        "repo": "pymdown-extensions",
+    },
+    "pymdownx.tilde": {"subscript": False},
+    "pymdownx.arithmatex": {  # <--- ADD THIS configuration
+        "generic": True,  # Use generic mode for flexibility with MathJax/KaTeX
+    },
+}
+
+
+import re
+from markdown.inlinepatterns import InlineProcessor
+from markdown.extensions import Extension
+import xml.etree.ElementTree as etree
+
+# 1. THE EXTENSIVE DICTIONARY
+EXTENDED_EMOTICONS = {
+    # Happy / Smile
+    ":-)": "🙂",
+    ":)": "🙂",
+    "=)": "🙂",
+    ":]": "🙂",
+    ":-]": "🙂",
+    # Grinning / Laughing
+    ":-D": "😃",
+    ":D": "😃",
+    "=D": "😃",
+    "xD": "😆",
+    "XD": "😆",
+    "8-D": "😃",
+    # Sad / Frowning
+    ":-(": "🙁",
+    ":(": "🙁",
+    "=(": "🙁",
+    ":[": "🙁",
+    ":-[": "🙁",
+    # Crying
+    ":'(": "😢",
+    ":'-(": "😢",
+    # Wink
+    ";-)": "😉",
+    ";)": "😉",
+    "*-)": "😉",
+    "*)": "😉",
+    ";-]": "😉",
+    # Tongue Out (Playful)
+    ":-P": "😛",
+    ":P": "😛",
+    "=P": "😛",
+    ":-p": "😛",
+    ":p": "😛",
+    ":b": "😛",
+    # Surprise / Shock
+    ":-O": "😮",
+    ":O": "😮",
+    ":-o": "😮",
+    ":o": "😮",
+    "8-0": "😮",
+    "=O": "😮",
+    # Cool / Sunglasses
+    "8-)": "😎",
+    "B-)": "😎",
+    "B)": "😎",
+    # Love / Affection
+    "<3": "❤️",
+    "&lt;3": "❤️",  # Handle HTML escaped version just in case
+    "</3": "💔",
+    "&lt;/3": "💔",
+    ":-*": "😘",
+    ":*": "😘",
+    # Confused / Skeptical / Annoyed
+    # Note: We avoid ':/' because it breaks http:// URLs. We use ':-/' instead.
+    ":-/": "😕",
+    ":-\\": "😕",
+    ":-|": "😐",
+    ":|": "😐",
+    # Angry
+    ">:(": "😠",
+    ">:-(": "😠",
+    # Embarrassed / Blush
+    ":$": "😳",
+    ":-$": "😳",
+    # Misc
+    "O:-)": "😇",
+    "0:-)": "😇",  # Angel
+    ">:)": "😈",
+    ">:-)": "😈",  # Devil
+    "D:<": "😨",  # Horror
+}
+
+
+class EmoticonInlineProcessor(InlineProcessor):
+    def __init__(self, pattern, md, emoticons):
+        super().__init__(pattern, md)
+        self.emoticons = emoticons
+
+    def handleMatch(self, m, data):
+        emoticon = m.group(1)
+        # Handle case sensitivity for things like xD vs XD if needed,
+        # but the dictionary keys usually handle it.
+        emoji_char = self.emoticons.get(emoticon)
+
+        if not emoji_char:
+            # Fallback for HTML escaped variants if necessary
+            emoji_char = self.emoticons.get(emoticon.replace("&lt;", "<"))
+
+        if emoji_char:
+            el = etree.Element("span")
+            el.text = emoji_char
+            el.set("class", "emoji")
+            el.set("title", emoticon)  # Adds hover text showing original syntax
+            return el, m.start(0), m.end(0)
+        return None, None, None
+
+
+class EmoticonExtension(Extension):
+    def extendMarkdown(self, md):
+        # 2. SORT BY LENGTH DESCENDING
+        # Critical: Ensures ':-((' matches before ':-('
+        sorted_keys = sorted(EXTENDED_EMOTICONS.keys(), key=len, reverse=True)
+
+        # 3. BUILD REGEX
+        # We escape the keys to handle characters like (, ), *, | safely
+        pattern_str = (
+            r"(" + "|".join(re.escape(k) for k in sorted_keys if len(k) > 2) + r")"
+        )
+
+        # 4. REGISTER
+        # Priority 175 is generally safe.
+        # If you find it breaking links (http://), lower it to < 120.
+        md.inlinePatterns.register(
+            EmoticonInlineProcessor(pattern_str, md, EXTENDED_EMOTICONS),
+            "emoticons",
+            175,
+        )
+
+
+
+# Initialize extensions ONCE at module level
+markdown_extensions = extensions + [EmoticonExtension()]
+
+# Create a global instance
+_markdowner = md.Markdown(
+    extensions=markdown_extensions, 
+    extension_configs=extension_configs
+)
+
+def parse_markdown(data):
+    """
+    Returns HTML string.
+    Note: We must reset the instance to clear state (like footnotes) between converts.
+    """
+    _markdowner.reset()
+    html = _markdowner.convert(data)
+    
+    return html

moosey_cms/models.py

@@ -0,0 +1,73 @@
+"""
+ Copyright (c) 2026 Anthony Mugendi
+ 
+ This software is released under the MIT License.
+ https://opensource.org/licenses/MIT
+"""
+
+from pydantic import BaseModel, Field, field_validator
+from typing import Dict, Literal, Optional
+from pathlib import Path
+
+
+class OpenGraphConfig(BaseModel):
+    """Open Graph metadata configuration"""
+    og_image: str = Field(..., description="Path to Open Graph image")
+    og_title: Optional[str] = Field(None, description="Open Graph title")
+    og_description: Optional[str] = Field(None, description="Open Graph description")
+    og_url: Optional[str] = Field(None, description="Open Graph URL")
+
+
+class SocialConfig(BaseModel):
+    """Social media links configuration"""
+    twitter: Optional[str] = Field(None, description="Twitter/X profile URL")
+    facebook: Optional[str] = Field(None, description="Facebook profile URL")
+    linkedin: Optional[str] = Field(None, description="LinkedIn profile URL")
+    instagram: Optional[str] = Field(None, description="Instagram profile URL")
+    github: Optional[str] = Field(None, description="GitHub profile URL")
+
+    @field_validator('twitter', 'facebook', 'linkedin', 'instagram', 'github')
+    @classmethod
+    def validate_url(cls, v: Optional[str]) -> Optional[str]:
+        if v and not v.startswith(('http://', 'https://')):
+            raise ValueError('Social media links must be valid URLs starting with http:// or https://')
+        return v
+
+
+class SiteData(BaseModel):
+    """Site metadata and configuration"""
+    name: Optional[str] = Field(..., description="Site name")
+    keywords: Optional[list[str]] = Field(..., description="SEO keywords")
+    description: Optional[str] = Field(..., description="Site description")
+    author: Optional[str] = Field(..., description="Site author")
+    open_graph: Optional[OpenGraphConfig] = Field(..., description="Open Graph configuration")
+    social: Optional[SocialConfig] = Field(..., description="Social media links")
+
+
+
+class Dirs(BaseModel):
+    """Directory paths configuration"""
+    content: Path = Field(..., description="Content directory path")
+    templates: Path = Field(..., description="Templates directory path")
+
+    @field_validator('content', 'templates')
+    @classmethod
+    def validate_path_exists(cls, v: Path) -> Path:
+        if not v.exists():
+            raise ValueError(f'Directory does not exist: {v}')
+        if not v.is_dir():
+            raise ValueError(f'Path is not a directory: {v}')
+        return v
+
+
+class CMSConfig(BaseModel):
+    """Complete CMS initialization configuration"""
+    host: str = Field(..., description="Server host address")
+    port: int = Field(..., ge=1, le=65535, description="Server port number")
+    dirs: Dirs = Field(..., description="Directory configuration")
+    mode: Literal["development", "production", "staging", "testing"] = Field(
+        ..., 
+        description="Application mode"
+    )
+    site_data: Optional[SiteData] = Field(..., description="Site metadata")
+    # site_code: Optional[SiteCode] = Field(..., description="Custom site code")

moosey_cms/pyproject.toml

@@ -0,0 +1,28 @@
+[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/seo.py

@@ -0,0 +1,153 @@
+"""
+Copyright (c) 2026 Anthony Mugendi
+
+This software is released under the MIT License.
+https://opensource.org/licenses/MIT
+"""
+
+from jinja2 import pass_context
+from markupsafe import Markup, escape
+from typing import Optional
+
+
+@pass_context
+def seo_tags(
+    context,
+    title: Optional[str] = None,
+    description: Optional[str] = None,
+    image: Optional[str] = None,
+    canonical_url: Optional[str] = None,
+    keywords: Optional[str] = None,
+    author: Optional[str] = None,
+    publish_date: Optional[str] = None,  # ISO 8601 format YYYY-MM-DD
+    noindex: bool = False,
+):
+    """
+    Renders full suite of SEO, OpenGraph, and Twitter Card meta tags.
+    """
+    request = context.get("request")
+    app = request.app
+
+    site_data = app.state.site_data
+
+    site_name = site_data.get("name")
+    site_keywords = site_data.get("keywords")
+    site_social = site_data.get("social")
+    open_graph = site_data.get("open_graph")
+
+    if site_social and len(site_social.keys()) > 0:
+        twitter_handle = site_social["twitter"] if "twitter" in site_social else None
+
+    if open_graph:
+        og_image = open_graph["og_image"] if "og_image" in open_graph else None
+
+    # 1. Resolve Data (Priority: Explicit Arg > Context Variable > Default)
+    meta_title = title or context.get("title") or site_name
+    meta_desc = description or context.get("description") or ""
+    meta_author = author or context.get("author") or site_name
+    meta_keywords = (
+        keywords or context.get("keywords") or site_keywords or context.get("tags")
+    )
+
+    meta_keywords = (
+        ", ".join(meta_keywords)
+        if isinstance(meta_keywords, list)
+        else str(meta_keywords)
+    )
+
+    # 2. Handle URLs (Absolute URLs are required for SEO/Social)
+    base_url = str(request.base_url).rstrip("/") if request else ""
+
+    # Resolve Image
+    meta_image = None
+    if og_image:
+
+        raw_image = image or context.get("image") or og_image
+        if raw_image and raw_image.startswith("http"):
+            meta_image = raw_image
+        else:
+            # Ensure path starts with /
+            if not raw_image.startswith("/"):
+                raw_image = "/" + raw_image
+            meta_image = f"{base_url}{raw_image}"
+
+    # Resolve Current URL & Canonical
+    current_url = str(request.url) if request else ""
+    final_canonical = canonical_url or current_url
+
+    # 3. Determine Content Type
+    # If a publish date exists, Google treats it as an Article
+    og_type = "article" if publish_date else "website"
+
+    # 4. Build Tags List
+    tags = []
+
+    # --- Standard SEO ---
+    tags.append(f"<title>{escape(meta_title)}</title>")
+    tags.append(f'<meta name="description" content="{escape(meta_desc)}">')
+    if meta_keywords:
+        tags.append(f'<meta name="keywords" content="{escape(meta_keywords)}">')
+    tags.append(f'<meta name="author" content="{escape(meta_author)}">')
+    tags.append(f'<link rel="canonical" href="{final_canonical}">')
+
+    # Robots (Block indexing if needed, e.g., for search results pages)
+    if noindex:
+        tags.append('<meta name="robots" content="noindex, nofollow">')
+    else:
+        tags.append('<meta name="robots" content="index, follow">')
+
+    # --- Open Graph (Facebook/LinkedIn) ---
+    if site_name:
+        tags.append(f'<meta property="og:site_name" content="{site_name}">')
+
+    tags.append(f'<meta property="og:type" content="{og_type}">')
+    tags.append(f'<meta property="og:title" content="{escape(meta_title)}">')
+    tags.append(f'<meta property="og:description" content="{escape(meta_desc)}">')
+    tags.append(f'<meta property="og:url" content="{current_url}">')
+
+    if meta_image:
+        tags.append(f'<meta property="og:image" content="{meta_image}">')
+
+    # --- Twitter Cards ---
+
+    tags.append('<meta name="twitter:card" content="summary_large_image">')
+    tags.append(f'<meta name="twitter:site" content="{twitter_handle}">')
+    tags.append(f'<meta name="twitter:title" content="{escape(meta_title)}">')
+    tags.append(f'<meta name="twitter:description" content="{escape(meta_desc)}">')
+
+    if meta_image:
+        tags.append(f'<meta name="twitter:image" content="{meta_image}">')
+
+    # --- Article Specifics ---
+    if publish_date:
+        tags.append(
+            f'<meta property="article:published_time" content="{publish_date}">'
+        )
+        tags.append(f'<meta property="article:author" content="{escape(meta_author)}">')
+
+    # --- JSON-LD Structured Data (The "Pro" Touch) ---
+    # This helps Google understand the page structure explicitly
+    json_ld_type = "Article" if og_type == "article" else "WebSite"
+    json_ld = f"""
+    <script type="application/ld+json">
+    {{
+      "@context": "https://schema.org",
+      "@type": "{json_ld_type}",
+      "headline": "{escape(meta_title)}",
+      "image": "{meta_image}",
+      "author": {{
+        "@type": "Person",
+        "name": "{escape(meta_author)}"
+      }},
+      "publisher": {{
+        "@type": "Organization",
+        "name": "{site_name}"
+      }},
+      "description": "{escape(meta_desc)}"
+      {f', "datePublished": "{publish_date}"' if publish_date else ''}
+    }}
+    </script>
+    """
+    tags.append(json_ld.strip())
+
+    return Markup("\n    ".join(tags))

moosey_cms/static/js/reload-script.js

@@ -0,0 +1,77 @@
+/**
+ * Copyright (c) 2026 Anthony Mugendi
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+
+(function () {
+  // Configuration
+  var MAX_RECONNECT_DELAY = 30000; // Max 30 seconds between attempts
+  var INITIAL_RECONNECT_DELAY = 1000; // Start with 1 second
+  
+  var reconnectDelay = INITIAL_RECONNECT_DELAY;
+  var reconnectTimeout;
+  var ws;
+
+  // Dynamic protocol (ws or wss) and host resolution
+  var protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
+  var ws_url = `${protocol}//${window.location.host}/ws/hot-reload`;
+
+  function connect() {
+    console.log('Connecting to:', ws_url);
+    ws = new WebSocket(ws_url);
+
+    ws.onopen = function (event) {
+      console.log('Connected! Ready for hot-reloading');
+      // Reset reconnect delay on successful connection
+      reconnectDelay = INITIAL_RECONNECT_DELAY;
+    };
+
+    ws.onmessage = function (event) {
+      console.log('Received:', event.data);
+
+      // OPTION A: If you want to Reload the page (Hot Reload behavior)
+      if (event.data === 'reload') {
+        window.location.reload();
+        return;
+      }
+
+      // OPTION B: Your original logic (Append to DOM)
+      var messages = document.getElementById('messages');
+      if (messages) {
+        var message = document.createElement('li');
+        var content = document.createTextNode(event.data);
+        message.appendChild(content);
+        messages.appendChild(message);
+      }
+    };
+
+    ws.onclose = function (event) {
+      console.log('WebSocket Disconnected. Attempting to reconnect in ' + (reconnectDelay / 1000) + 's...');
+      scheduleReconnect();
+    };
+
+    ws.onerror = function (error) {
+      console.error('WebSocket error:', error);
+      ws.close();
+    };
+  }
+
+  function scheduleReconnect() {
+    // Clear any existing reconnect timeout
+    if (reconnectTimeout) {
+      clearTimeout(reconnectTimeout);
+    }
+
+    // Schedule reconnection with current delay
+    reconnectTimeout = setTimeout(function () {
+      connect();
+      // Increase delay for next attempt (exponential backoff)
+      reconnectDelay = Math.min(reconnectDelay * 2, MAX_RECONNECT_DELAY);
+    }, reconnectDelay);
+  }
+
+  // Initial connection
+  connect();
+})();