pdfwright 0.1.2__tar.gz → 0.2.1__tar.gz

pdfwright-0.2.1/.gitignore

@@ -0,0 +1,33 @@
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+dist/
+build/
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+bandit-report.json
+
+# Node / 前端
+node_modules/
+pdfwright-web/frontend/dist/
+pdfwright-web/frontend/.vite/
+
+# 前端构建产物（由 pdfwright-web 构建时生成，不入库；构建命令见 README）
+pdfwright-web/src/pdfwright_web/static/
+
+# 示例生成的输出文件
+pdfwright/examples/output/
+
+# 其它
+.DS_Store
+*.log
+.idea/
+.vscode/
+
+# 本地发布凭据（scripts/publish.sh --config 默认读它）
+.publish.env

pdfwright-0.2.1/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.5
+Name: pdfwright
+Version: 0.2.1
+Summary: 配置驱动的 PDF 生成基础库：JSON 配置 → 模板求值（变量/循环/条件）→ 高保真 PDF。纯 Python 引擎（ReportLab + fontTools + Jinja2 + pikepdf），无外部软件依赖。
+License: Proprietary
+Requires-Python: >=3.12
+Requires-Dist: fonttools>=4.53
+Requires-Dist: httpx>=0.27
+Requires-Dist: jinja2>=3.1
+Requires-Dist: jsonschema>=4.23
+Requires-Dist: openpyxl>=3.1
+Requires-Dist: pikepdf>=8.0
+Requires-Dist: pillow>=10.0
+Requires-Dist: python-barcode>=0.16.1
+Requires-Dist: python-docx>=1.1
+Requires-Dist: reportlab<6,>=5.0
+Requires-Dist: segno>=1.6.6
+Description-Content-Type: text/markdown
+
+# pdfwright — 配置驱动的 PDF 生成基础库
+
+纯 Python 引擎（ReportLab + fontTools + Jinja2 + pikepdf），**无外部软件依赖**
+（不依赖 pango/cairo/Chromium/LibreOffice 等系统级软件）。
+
+## 定位
+
+`pdfwright` 是**基础库**：输入「页面 JSON 配置（schema）+ 数据（data）」，输出
+高保真 PDF 或 HTML 预览。**不包含任何 web 服务与存储**。
+
+- 需要可视化配置编辑器 / 对外 API 服务 → 使用 [`pdfwright-web`](../pdfwright-web/)。
+- 只需本地渲染 → 直接 import 本库即可。
+
+## 使用
+
+```python
+from pdfwright import DocumentConfig, SchemaError, render_pdf, render_pdf_to_file
+
+config = {
+    "version": "1.0",
+    "page": {"size": "A4", "margin": {"top": 40, "bottom": 40, "left": 40, "right": 40}},
+    "variables": [
+        {"name": "title", "type": "string", "label": "标题", "default": "示例文档"},
+        {"name": "items", "type": "array", "label": "明细"},
+    ],
+    "body": [
+        {"type": "heading", "text": "{{ title }}", "style": {"textAlign": "center", "fontSize": 18}},
+        {"type": "for", "each": "items", "as": "item",
+         "children": [{"type": "paragraph", "text": "{{ loop.index }}. {{ item.name }}"}],
+        },
+    ],
+}
+doc = DocumentConfig.from_dict(config)   # 解析 + 校验
+data = {"items": [{"name": "A"}, {"name": "B"}]}
+pdf_bytes = render_pdf(doc, data=data)   # 服务器端生成，需要字体目录可用
+render_pdf_to_file(doc, "out.pdf", data=data)
+```
+
+## 核心能力
+
+- **Schema 嵌套模型**：`table > thead/tbody/tfoot > tr > td/th`，单元格内容为任意元素树
+  （可再嵌表格 / 文本 / 控件 / for / if）。
+- **模板引擎（Jinja2）**：`{{ }}` 表达式、`{% for %}` / `{% if %}` 标签任意层级摆放、
+  内置过滤器（数字/百分比/货币/截断/日期…），空变量宽松求值。
+- **字体系统**：枚举系统字体（macOS/Linux/Windows），字符级回退
+  （CJK / 数字 / 拉丁 各自回退，类似 Word 字体绑定），中文字号（初号~八号），
+  TTC 抽取嵌入，PDF/A 输出。
+- **双样式**：元素 `style`（通用/HTML 预览）+ `pdfStyle`（PDF 覆盖）；
+  文档级 `html` / `pdf` 配置节。
+- **布局**：流式布局 + 绝对定位（`position: "absolute"` + x/y）并存；
+  A4/A3/自定义任意尺寸；分页符、页眉页脚、页码。
+
+## 开发
+
+```bash
+uv sync --all-extras   # 安装（含 dev 依赖）
+uv run pytest          # 跑测试（真实渲染 PDF，禁止 mock）
+uv run ruff check .    # lint
+uv run mypy src        # 类型检查
+```
+
+质量红线：测试必须真实跑渲染（在 tmp_path 生成 PDF 并断言存在/页数/内容），
+禁止 mock 渲染对象。

pdfwright-0.2.1/README.md

@@ -0,0 +1,63 @@
+# pdfwright — 配置驱动的 PDF 生成基础库
+
+纯 Python 引擎（ReportLab + fontTools + Jinja2 + pikepdf），**无外部软件依赖**
+（不依赖 pango/cairo/Chromium/LibreOffice 等系统级软件）。
+
+## 定位
+
+`pdfwright` 是**基础库**：输入「页面 JSON 配置（schema）+ 数据（data）」，输出
+高保真 PDF 或 HTML 预览。**不包含任何 web 服务与存储**。
+
+- 需要可视化配置编辑器 / 对外 API 服务 → 使用 [`pdfwright-web`](../pdfwright-web/)。
+- 只需本地渲染 → 直接 import 本库即可。
+
+## 使用
+
+```python
+from pdfwright import DocumentConfig, SchemaError, render_pdf, render_pdf_to_file
+
+config = {
+    "version": "1.0",
+    "page": {"size": "A4", "margin": {"top": 40, "bottom": 40, "left": 40, "right": 40}},
+    "variables": [
+        {"name": "title", "type": "string", "label": "标题", "default": "示例文档"},
+        {"name": "items", "type": "array", "label": "明细"},
+    ],
+    "body": [
+        {"type": "heading", "text": "{{ title }}", "style": {"textAlign": "center", "fontSize": 18}},
+        {"type": "for", "each": "items", "as": "item",
+         "children": [{"type": "paragraph", "text": "{{ loop.index }}. {{ item.name }}"}],
+        },
+    ],
+}
+doc = DocumentConfig.from_dict(config)   # 解析 + 校验
+data = {"items": [{"name": "A"}, {"name": "B"}]}
+pdf_bytes = render_pdf(doc, data=data)   # 服务器端生成，需要字体目录可用
+render_pdf_to_file(doc, "out.pdf", data=data)
+```
+
+## 核心能力
+
+- **Schema 嵌套模型**：`table > thead/tbody/tfoot > tr > td/th`，单元格内容为任意元素树
+  （可再嵌表格 / 文本 / 控件 / for / if）。
+- **模板引擎（Jinja2）**：`{{ }}` 表达式、`{% for %}` / `{% if %}` 标签任意层级摆放、
+  内置过滤器（数字/百分比/货币/截断/日期…），空变量宽松求值。
+- **字体系统**：枚举系统字体（macOS/Linux/Windows），字符级回退
+  （CJK / 数字 / 拉丁 各自回退，类似 Word 字体绑定），中文字号（初号~八号），
+  TTC 抽取嵌入，PDF/A 输出。
+- **双样式**：元素 `style`（通用/HTML 预览）+ `pdfStyle`（PDF 覆盖）；
+  文档级 `html` / `pdf` 配置节。
+- **布局**：流式布局 + 绝对定位（`position: "absolute"` + x/y）并存；
+  A4/A3/自定义任意尺寸；分页符、页眉页脚、页码。
+
+## 开发
+
+```bash
+uv sync --all-extras   # 安装（含 dev 依赖）
+uv run pytest          # 跑测试（真实渲染 PDF，禁止 mock）
+uv run ruff check .    # lint
+uv run mypy src        # 类型检查
+```
+
+质量红线：测试必须真实跑渲染（在 tmp_path 生成 PDF 并断言存在/页数/内容），
+禁止 mock 渲染对象。

pdfwright-0.2.1/examples/contract.json

@@ -0,0 +1,64 @@
+{
+  "version": "1.0",
+  "meta": { "title": "劳动合同书" },
+  "page": {
+    "size": "A4",
+    "margin": { "top": 60, "right": 60, "bottom": 60, "left": 60 },
+    "header": { "text": "劳动合同书 · 编号 {{ contractNo }}", "pageNumber": true },
+    "footer": { "text": "xxx公司", "pageNumber": true }
+  },
+  "variables": [
+    { "name": "contractNo", "type": "string", "label": "合同编号", "default": "HT-2026-0118" },
+    { "name": "company", "type": "string", "label": "用人单位", "default": "xxx公司" },
+    { "name": "employee", "type": "string", "label": "劳动者姓名", "default": "xxx" },
+    { "name": "idNo", "type": "string", "label": "身份证号", "default": "3301**********1234" },
+    { "name": "position", "type": "string", "label": "岗位", "default": "高级前端工程师" },
+    { "name": "salary", "type": "number", "label": "月薪", "default": 32000 },
+    { "name": "startDate", "type": "date", "label": "入职日期", "default": "2026-02-01" },
+    { "name": "months", "type": "number", "label": "合同期限（月）", "default": 36 },
+    { "name": "terms", "type": "array", "label": "条款", "default": [
+      { "title": "工作内容与地点", "content": "乙方在甲方指定地点从事约定的岗位工作，甲方可根据经营需要合理调整。" },
+      { "title": "劳动报酬", "content": "甲方每月 10 日前以货币形式支付乙方上月工资，依法代扣代缴个人所得税。" },
+      { "title": "社会保险", "content": "甲乙双方依法参加社会保险，甲方为乙方办理参保手续并按时足额缴纳。" },
+      { "title": "保密义务", "content": "乙方对甲方商业秘密、技术资料负有保密义务，该义务在合同终止后继续有效。" }
+    ]},
+    { "name": "signDate", "type": "date", "label": "签署日期", "default": "2026-01-18" },
+    { "name": "signature", "type": "image", "label": "乙方签名" }
+  ],
+  "body": [
+    { "type": "heading", "text": "劳动合同书", "style": { "textAlign": "center", "fontSize": "一号", "fontFamily": "serif", "margin": { "bottom": 6 } } },
+    { "type": "paragraph", "text": "合同编号：{{ contractNo }}", "style": { "textAlign": "center", "fontSize": 10, "color": "#94a3b8", "margin": { "bottom": 14 } } },
+
+    { "type": "section", "style": { "padding": { "top": 8, "bottom": 8, "left": 10, "right": 10 }, "backgroundColor": "#f8fafc", "borderWidth": 0.5, "borderColor": "#cbd5e1" }, "children": [
+      { "type": "paragraph", "text": "甲方（用人单位）：{{ company }}", "style": { "fontSize": 11, "lineHeight": 1.7 } },
+      { "type": "paragraph", "text": "乙方（劳动者）：{{ employee }}    身份证号：{{ idNo }}", "style": { "fontSize": 11, "lineHeight": 1.7 } },
+      { "type": "paragraph", "text": "岗位：{{ position }}    月薪：{{ salary | currency('￥') }}    入职日期：{{ startDate | date('YYYY年MM月DD日') }}", "style": { "fontSize": 11, "lineHeight": 1.7 } }
+    ]},
+
+    { "type": "paragraph", "text": "依据《中华人民共和国劳动法》《中华人民共和国劳动合同法》，甲乙双方经平等协商，订立本合同，共同遵守。", "style": { "fontSize": 11, "lineHeight": 1.8, "margin": { "top": 12, "bottom": 8 } } },
+
+    { "type": "for", "each": "terms", "as": "term", "children": [
+      { "type": "paragraph", "text": "第 {{ loop.index }} 条  {{ term.title }}", "style": { "fontSize": 12, "fontWeight": "bold", "margin": { "top": 8, "bottom": 2 } } },
+      { "type": "paragraph", "text": "{{ term.content }}", "style": { "fontSize": 11, "lineHeight": 1.8, "padding": { "left": 12 } } }
+    ]},
+
+    { "type": "paragraph", "text": "本合同期限 {{ months }} 个月，自 {{ startDate | date('YYYY年MM月DD日') }} 起。", "style": { "fontSize": 11, "lineHeight": 1.8, "margin": { "top": 10 } } },
+
+    { "type": "divider", "style": { "borderWidth": 0.5, "borderColor": "#cbd5e1", "margin": { "top": 16, "bottom": 12 } } },
+
+    { "type": "row", "children": [
+      { "type": "section", "style": { "padding": { "top": 4, "right": 8, "bottom": 4, "left": 0 } }, "children": [
+        { "type": "paragraph", "text": "甲方（盖章）：{{ company }}", "style": { "fontSize": 11, "lineHeight": 1.9 } },
+        { "type": "paragraph", "text": "法定代表人：____________________", "style": { "fontSize": 11, "lineHeight": 1.9 } },
+        { "type": "paragraph", "text": "日期：{{ signDate | date('YYYY年MM月DD日') }}", "style": { "fontSize": 11, "lineHeight": 1.9 } }
+      ]},
+      { "type": "section", "style": { "padding": { "top": 4, "right": 0, "bottom": 4, "left": 8 } }, "children": [
+        { "type": "paragraph", "text": "乙方（签字）：", "style": { "fontSize": 11, "lineHeight": 1.9 } },
+        { "type": "image", "name": "signature", "label": "签名", "style": { "width": 110, "height": 44 } },
+        { "type": "paragraph", "text": "日期：{{ signDate | date('YYYY年MM月DD日') }}", "style": { "fontSize": 11, "lineHeight": 1.9 } }
+      ]}
+    ]},
+
+    { "type": "text", "text": "合同专用", "position": "absolute", "x": 60, "y": 330, "style": { "fontSize": 40, "color": "#fee2e2", "fontWeight": "bold" } }
+  ]
+}