rsplotlib 0.1.4__cp313-cp313-macosx_11_0_arm64.whl

rsplotlib/__init__.py

@@ -0,0 +1,15 @@
+"""rsplotlib 包顶层导出。建议通过导入自 `rsplotlib.api` 使用公开 API。"""
+
+from .api import *
+from .api import __all__ as _api_all
+from .rsplotlib import register_sans_serif_font
+from . import pyplot, style, gridspec, ticker
+
+GridSpec = gridspec.GridSpec
+MaxNLocator = ticker.MaxNLocator
+MultipleLocator = ticker.MultipleLocator
+AutoMinorLocator = ticker.AutoMinorLocator
+
+# 从内部 Rust 模块导出字体注册函数
+
+__all__ = list(_api_all) + ['pyplot', 'style', 'gridspec', 'ticker', 'GridSpec', 'MaxNLocator', 'MultipleLocator', 'AutoMinorLocator', 'register_sans_serif_font']

rsplotlib/_figure_defaults.py

@@ -0,0 +1,10 @@
+"""rsplotlib._figure_defaults - 图形创建相关的默认值
+
+集中管理 figure 尺寸、DPI 等默认值，避免散落在 pyplot 模块中。
+"""
+
+# 默认图形尺寸（英寸），与 matplotlib 默认一致
+DEFAULT_FIGSIZE = (6.4, 4.8)
+
+# 默认 DPI
+DEFAULT_DPI = 100.0

rsplotlib/_font_resolver.py

@@ -0,0 +1,167 @@
+"""rsplotlib._font_resolver - 字体族名 → 字体文件路径解析
+
+将 matplotlib 风格的无衬线字体族名（如 "Arial Unicode MS"、"Helvetica Neue"）
+映射到本地字体文件路径。找不到时返回 None，由调用方决定回退到默认字体。
+"""
+import os
+from typing import Optional, List
+import sys
+
+
+# ====== 字体族名 → 候选文件路径映射（按平台分别维护）======
+
+_FONT_NAME_TO_PATHS = {
+    # macOS
+    "Arial Unicode MS": [
+        "/Library/Fonts/Arial Unicode.ttf",
+        "/System/Library/Fonts/Supplemental/Arial Unicode.ttf",
+    ],
+    "Arial": [
+        "/Library/Fonts/Arial.ttf",
+        "/System/Library/Fonts/Supplemental/Arial.ttf",
+    ],
+    "Helvetica": [
+        "/System/Library/Fonts/Helvetica.ttc",
+        "/System/Library/Fonts/HelveticaNeue.ttc",
+    ],
+    "Helvetica Neue": [
+        "/System/Library/Fonts/HelveticaNeue.ttc",
+    ],
+    "PingFang SC": [
+        "/System/Library/Fonts/PingFang.ttc",
+    ],
+    "Heiti SC": [
+        "/System/Library/Fonts/STHeiti Light.ttc",
+        "/System/Library/Fonts/STHeiti Medium.ttc",
+    ],
+    "Hiragino Sans GB": [
+        "/System/Library/Fonts/Hiragino Sans GB W3.otf",
+        "/System/Library/Fonts/Hiragino Sans GB W6.otf",
+    ],
+    # Linux
+    "DejaVu Sans": [
+        "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf",
+        "/usr/share/fonts/dejavu/DejaVuSans.ttf",
+    ],
+    "Liberation Sans": [
+        "/usr/share/fonts/truetype/liberation/LiberationSans-Regular.ttf",
+    ],
+    "Noto Sans CJK SC": [
+        "/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc",
+        "/usr/share/fonts/truetype/noto/NotoSansCJK-Regular.ttc",
+        "/usr/share/fonts/noto-cjk/NotoSansCJK-Regular.ttc",
+    ],
+    "WenQuanYi Micro Hei": [
+        "/usr/share/fonts/truetype/wqy/wqy-microhei.ttc",
+    ],
+    # Windows
+    "Microsoft YaHei": [
+        "C:/Windows/Fonts/msyh.ttc",
+        "C:/Windows/Fonts/msyh.ttf",
+        "C:/Windows/Fonts/msyhbd.ttc",
+    ],
+    "SimHei": [
+        "C:/Windows/Fonts/simhei.ttf",
+    ],
+    "SimSun": [
+        "C:/Windows/Fonts/simsun.ttc",
+    ],
+}
+
+
+# 跨平台按系统名归一化的额外兜底字体路径
+
+def _system_fallback_paths() -> List[str]:
+    """按当前操作系统返回一组"通用全功能字体"候选路径"""
+    system = sys.platform
+    if system == "darwin":
+        return [
+            "/Library/Fonts/Arial Unicode.ttf",
+            "/System/Library/Fonts/Supplemental/Arial Unicode.ttf",
+        ]
+    elif system == "linux":
+        return [
+            "/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc",
+            "/usr/share/fonts/truetype/noto/NotoSansCJK-Regular.ttc",
+            "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf",
+            "/usr/share/fonts/dejavu/DejaVuSans.ttf",
+        ]
+    elif system == "win32":
+        return [
+            "C:/Windows/Fonts/msyh.ttc",
+            "C:/Windows/Fonts/msyh.ttf",
+            "C:/Windows/Fonts/msyhbd.ttc",
+        ]
+    elif system == "cygwin":
+        return [
+            "C:/Windows/Fonts/msyh.ttc",
+            "C:/Windows/Fonts/arial.ttf",
+        ]
+    return []
+
+
+def resolve_font_path(family: str) -> Optional[str]:
+    """根据字体族名查找本地的字体文件路径。
+
+    找不到时返回 None。
+    """
+    if not family:
+        return None
+    # 精确匹配
+    candidates = _FONT_NAME_TO_PATHS.get(family, [])
+    for path in candidates:
+        if os.path.isfile(path):
+            return path
+    # 大小写不敏感匹配
+    lower_map = {k.lower(): v for k, v in _FONT_NAME_TO_PATHS.items()}
+    candidates = lower_map.get(family.lower(), [])
+    for path in candidates:
+        if os.path.isfile(path):
+            return path
+    # 平台回退
+    for path in _system_fallback_paths():
+        if os.path.isfile(path):
+            return path
+    return None
+
+
+def apply_rcparams_font() -> Optional[str]:
+    """读取 rcParams["font.sans-serif"]，把第一个能解析到本地文件的字体注册到 plotters。
+
+    返回实际注册的字体文件路径，如果没找到任何字体则返回 None。
+    """
+    try:
+        # 延迟导入避免循环依赖
+        from . import rsplotlib as _rsplotlib
+        from .pylab import mpl
+    except Exception:
+        return None
+
+    sans_serif = mpl.rcParams.get("font.sans-serif")
+    if not sans_serif:
+        return None
+
+    if isinstance(sans_serif, str):
+        candidates = [sans_serif]
+    else:
+        try:
+            candidates = list(sans_serif)
+        except TypeError:
+            candidates = [str(sans_serif)]
+
+    # "sans-serif" 关键字跳过：让 plotters 使用内部默认
+    candidates = [c for c in candidates if c and c.lower() != "sans-serif"]
+
+    for family in candidates:
+        path = resolve_font_path(family)
+        if path is None:
+            # 可能是直接的字体文件路径
+            if os.path.isfile(family):
+                path = family
+        if path is not None:
+            try:
+                _rsplotlib.register_sans_serif_font(path)
+                return path
+            except Exception:
+                continue
+    return None

rsplotlib/_rcparams.py

@@ -0,0 +1,58 @@
+"""rsplotlib._rcparams - Matplotlib 兼容的 rcParams 配置管理
+
+提供类似 matplotlib.rcParams 的全局配置字典，保存绘图相关的默认参数。
+
+**字体钩子**：当用户设置 `rcParams["font.sans-serif"]` 时，会自动调用
+`_font_resolver.apply_rcparams_font()`，把对应的字体文件注册到 plotters 的
+字体数据库中，从而真正影响文本渲染（而不是像普通 dict 一样只更新值）。
+"""
+import copy as _copy
+from typing import Any
+
+# 默认配置：与 matplotlib 保持一致的常用项
+_DEFAULT_RC = {
+    'font.sans-serif': ['Helvetica', 'Arial', 'sans-serif'],
+    'axes.unicode_minus': True,
+    'font.size': 10,
+    'figure.figsize': [6.4, 4.8],
+    'figure.dpi': 100.0,
+}
+
+
+class RcParams(dict):
+    """与 matplotlib.rcParams 兼容的配置字典
+
+    区别于普通 dict：
+    1. 当访问不存在的键时返回 None 而不是抛出 KeyError。
+    2. **设置 `font.sans-serif` 时自动调用字体解析器**，把对应字体文件
+       注册到 plotters 的字体数据库中，使 plotters 真正使用用户指定的字体
+       渲染文字（而不是只更新一个不会生效的字符串列表）。
+    """
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.update(_DEFAULT_RC)
+
+    def __getitem__(self, key):
+        try:
+            return super().__getitem__(key)
+        except KeyError:
+            return None
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        super().__setitem__(key, value)
+        # 字体钩子：用户在 Python 端改字体时同步通知 Rust 端注册
+        if key == 'font.sans-serif':
+            try:
+                # 延迟导入避免循环依赖
+                from ._font_resolver import apply_rcparams_font
+                apply_rcparams_font()
+            except Exception:
+                # 注册失败不影响 rcParams 写入
+                pass
+
+
+# 全局单例
+rcParams = RcParams()
+# 原始默认配置副本（用于 rcParams.reset() 等恢复操作）
+rcParamsOrig = _copy.deepcopy(rcParams)