wechat-formatter 1.0.0__py3-none-any.whl

wechat_formatter/__init__.py

@@ -0,0 +1,65 @@
+"""wechat_formatter — Markdown → WeChat Official Account styled HTML.
+
+A Markdown article template engine that renders Markdown into inline-styled
+HTML suitable for pasting into the WeChat Official Account (公众号) editor.
+Six visual categories × twelve color themes = 72 ready-to-use templates.
+
+Public API::
+
+    from wechat_formatter import (
+        all_templates,
+        grouped_templates,
+        get_template,
+        render_article,
+        TemplateConfig,
+        FormatTweaks,
+    )
+
+    # Pick by Chinese style name + color name:
+    tpl = get_template("极简风", "经典")
+    html = render_article("# Hello", tpl, FormatTweaks())
+"""
+
+from __future__ import annotations
+
+from .colors import (
+    categories_list,
+    color_palettes,
+    hex_to_rgb,
+    hex_to_rgba,
+    names,
+)
+from .renderer import render_article
+from .style_utils import bg_fallback, ensure_style_value, get_style_value
+from .templates import (
+    all_templates,
+    build_template,
+    generate_templates,
+    get_styles_by_category,
+    get_template,
+    grouped_templates,
+)
+from .types import BaseStyle, FormatTweaks, TemplateConfig
+
+__all__ = [
+    "BaseStyle",
+    "FormatTweaks",
+    "TemplateConfig",
+    "all_templates",
+    "build_template",
+    "categories_list",
+    "color_palettes",
+    "generate_templates",
+    "get_styles_by_category",
+    "get_template",
+    "grouped_templates",
+    "hex_to_rgb",
+    "hex_to_rgba",
+    "names",
+    "render_article",
+    "bg_fallback",
+    "ensure_style_value",
+    "get_style_value",
+]
+
+__version__ = "1.0.0"

wechat_formatter/colors.py

@@ -0,0 +1,150 @@
+"""Color palettes, template names, and hex/ rgba helpers.
+
+Translated from the top-level constants and helpers in the TypeScript source.
+"""
+
+from __future__ import annotations
+
+from typing import Dict, List, Tuple
+
+# ---------------------------------------------------------------------------
+# Palettes / names / categories
+# ---------------------------------------------------------------------------
+
+color_palettes: Dict[str, List[str]] = {
+    "neoBrutalism": [
+        "#ff6f9f",
+        "#3b82f6",
+        "#10b981",
+        "#f59e0b",
+        "#8b5cf6",
+        "#ef4444",
+        "#06b6d4",
+        "#f43f5e",
+        "#14b8a6",
+        "#f97316",
+        "#d946ef",
+        "#84cc16",
+    ],
+    "minimalist": [
+        "#3b82f6",
+        "#10b981",
+        "#6366f1",
+        "#f59e0b",
+        "#ef4444",
+        "#8b5cf6",
+        "#14b8a6",
+        "#f43f5e",
+        "#64748b",
+        "#000000",
+        "#2dd4bf",
+        "#fb923c",
+    ],
+    "business": [
+        "#1e40af",
+        "#0f766e",
+        "#4338ca",
+        "#b45309",
+        "#be123c",
+        "#6d28d9",
+        "#0e7490",
+        "#9f1239",
+        "#334155",
+        "#111827",
+        "#1d4ed8",
+        "#047857",
+    ],
+    "literary": [
+        "#059669",
+        "#d97706",
+        "#be185d",
+        "#7c3aed",
+        "#0284c7",
+        "#ea580c",
+        "#4d7c0f",
+        "#c026d3",
+        "#0891b2",
+        "#86198f",
+        "#db2777",
+        "#7c2d12",
+    ],
+    "tech": [
+        "#2563eb",
+        "#0ea5e9",
+        "#06b6d4",
+        "#10b981",
+        "#8b5cf6",
+        "#a855f7",
+        "#d946ef",
+        "#f43f5e",
+        "#6366f1",
+        "#14b8a6",
+        "#f97316",
+        "#84cc16",
+    ],
+    "festive": [
+        "#ef4444",
+        "#dc2626",
+        "#b91c1c",
+        "#f59e0b",
+        "#d97706",
+        "#ea580c",
+        "#c2410c",
+        "#be123c",
+        "#9f1239",
+        "#fbbf24",
+        "#e11d48",
+        "#ca8a04",
+    ],
+}
+
+names: List[str] = [
+    "经典",
+    "雅致",
+    "先锋",
+    "深邃",
+    "晨光",
+    "星穹",
+    "暖阳",
+    "暮色",
+    "清泉",
+    "破晓",
+    "璀璨",
+    "幽蓝",
+]
+
+categories_list: List[Dict[str, str]] = [
+    {"id": "neo-brutalism", "name": "新粗野风"},
+    {"id": "minimalist", "name": "极简风"},
+    {"id": "business", "name": "商务风"},
+    {"id": "literary", "name": "文艺风"},
+    {"id": "tech", "name": "科技风"},
+    {"id": "festive", "name": "节庆风"},
+]
+
+
+# ---------------------------------------------------------------------------
+# Color helpers
+# ---------------------------------------------------------------------------
+
+
+def hex_to_rgb(hex_color: str) -> Tuple[int, int, int]:
+    """Convert a ``#rrggbb`` or ``#rgb`` hex string to an ``(r, g, b)`` tuple."""
+    normalized = hex_color.replace("#", "").strip()
+    if len(normalized) == 3:
+        normalized = "".join(ch + ch for ch in normalized)
+    value = int(normalized, 16)
+    r = (value >> 16) & 255
+    g = (value >> 8) & 255
+    b = value & 255
+    return r, g, b
+
+
+def hex_to_rgba(hex_color: str, alpha: float) -> str:
+    """Convert a hex color + alpha into a CSS ``rgba(...)`` string."""
+    r, g, b = hex_to_rgb(hex_color)
+    # Mirror the TS rounding: Number(alpha.toFixed(3)) then clamped to [0, 1].
+    # ``:g`` drops trailing zeros so 0.0 renders as "0" and 1.0 as "1", exactly
+    # like JS's Number-to-string coercion.
+    safe_alpha = max(0.0, min(1.0, round(float(alpha), 3)))
+    return f"rgba({r}, {g}, {b}, {safe_alpha:g})"

wechat_formatter/plugins.py

@@ -0,0 +1,65 @@
+"""Custom mistune inline plugins for the extra Markdown syntax.
+
+These mirror the three marked extensions registered in the TypeScript source:
+
+* ``==highlight==``  -> ``<mark>``
+* ``^superscript^``  -> ``<sup>``
+* ``~subscript~``    -> ``<sub>`` (skipping ``~~`` so strikethrough wins)
+
+The render functions themselves are wired up in :mod:`template_engine.renderer`
+because they depend on the active template's theme color.
+"""
+
+from __future__ import annotations
+
+import re
+from typing import TYPE_CHECKING, Any, Match, Optional
+
+if TYPE_CHECKING:  # pragma: no cover
+    from mistune import Markdown
+    from mistune.core import InlineState
+    from mistune.inline_parser import InlineParser
+
+
+def _parse_with_children(inline: "InlineParser", m: Match[str], state: "InlineState",
+                         pattern: str, token_type: str) -> Optional[int]:
+    """Shared helper: match ``pattern`` at the trigger position and emit a
+    token whose children are the recursively-parsed inner text."""
+    src = state.src
+    matched = re.match(pattern, src[m.start():])
+    if not matched:
+        return None
+    child = state.copy()
+    child.src = matched.group(1)
+    children = inline.render(child)
+    state.append_token({"type": token_type, "children": children})
+    return m.start() + matched.end()
+
+
+def parse_highlight(inline: "InlineParser", m: Match[str], state: "InlineState") -> Optional[int]:
+    # TS: /^==([^=]+)==/
+    return _parse_with_children(inline, m, state, r"^==([^=]+)==", "highlight")
+
+
+def parse_superscript(inline: "InlineParser", m: Match[str], state: "InlineState") -> Optional[int]:
+    # TS: /^\^([^^]+)\^/
+    return _parse_with_children(inline, m, state, r"^\^([^^]+)\^", "superscript")
+
+
+def parse_subscript(inline: "InlineParser", m: Match[str], state: "InlineState") -> Optional[int]:
+    # TS: /^~([^~\s][^~]*[^~\s])~/
+    # Guard against ~~ (strikethrough) so the strikethrough plugin owns those.
+    if state.src[m.start():m.start() + 2] == "~~":
+        return None
+    return _parse_with_children(inline, m, state, r"^~([^~\s][^~]*[^~\s])~", "subscript")
+
+
+def register_extra_syntax(md: "Markdown") -> None:
+    """Register the three custom inline rules on a mistune Markdown instance.
+
+    Render methods are expected to be registered on the renderer separately
+    (they need access to the active template).
+    """
+    md.inline.register("highlight", r"==", parse_highlight)
+    md.inline.register("superscript", r"\^", parse_superscript)
+    md.inline.register("subscript", r"~", parse_subscript)