powertom 0.2.2
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.
- checksums.yaml +7 -0
- data/LICENSE +21 -0
- data/README.md +447 -0
- data/lib/powertom/adapter/page_surgery.rb +229 -0
- data/lib/powertom/adapter/ruby_pptx_adapter.rb +403 -0
- data/lib/powertom/binder.rb +204 -0
- data/lib/powertom/data_loading.rb +45 -0
- data/lib/powertom/formatter.rb +114 -0
- data/lib/powertom/grid_value.rb +53 -0
- data/lib/powertom/path_resolver.rb +52 -0
- data/lib/powertom/render.rb +558 -0
- data/lib/powertom/run_merge.rb +26 -0
- data/lib/powertom/scanner.rb +146 -0
- data/lib/powertom/table_loop.rb +776 -0
- data/lib/powertom/validator.rb +697 -0
- data/lib/powertom/version.rb +6 -0
- data/lib/powertom.rb +63 -0
- metadata +84 -0
data/lib/powertom.rb
ADDED
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
require_relative "powertom/version"
|
|
4
|
+
|
|
5
|
+
module PowerTom
|
|
6
|
+
class Error < StandardError; end
|
|
7
|
+
|
|
8
|
+
# 模板引用了数据中不存在的字段(设计文档 §2.3)
|
|
9
|
+
class MissingDataError < Error; end
|
|
10
|
+
|
|
11
|
+
# 模板标签语法错误,如 {{each kpis}} 缺 #
|
|
12
|
+
class TemplateSyntaxError < Error; end
|
|
13
|
+
|
|
14
|
+
# ruby_pptx 打不开文件 / 不是合法 pptx
|
|
15
|
+
class InvalidTemplateError < Error; end
|
|
16
|
+
end
|
|
17
|
+
|
|
18
|
+
require_relative "powertom/render"
|
|
19
|
+
require_relative "powertom/validator"
|
|
20
|
+
|
|
21
|
+
module PowerTom
|
|
22
|
+
class << self
|
|
23
|
+
# §3.4 注册自定义 formatter:proc 收到 (value, arg),返回值 to_s 后落盘。
|
|
24
|
+
# PowerTom.register_formatter("rmb") { |value, _arg| "人民币#{value}元" }
|
|
25
|
+
def register_formatter(name, &block)
|
|
26
|
+
Formatter.register(name, &block)
|
|
27
|
+
end
|
|
28
|
+
|
|
29
|
+
def unregister_formatter(name)
|
|
30
|
+
Formatter.unregister_formatter(name)
|
|
31
|
+
end
|
|
32
|
+
# §2.1 渲染入口。
|
|
33
|
+
# result = PowerTom.render("templates/x.pptx", data: "data.toml", strict: true)
|
|
34
|
+
# result.save("out/x.pptx")
|
|
35
|
+
# result.warnings # 未使用字段、缺失字段降级、备注标签等
|
|
36
|
+
#
|
|
37
|
+
# data 支持 Hash 或 .toml 文件路径(TOML 是 gem 的默认数据格式)。
|
|
38
|
+
# v0 覆盖:单页多标签、跨 run 标签、{{#each}} 页面克隆、{{#if}} 页面删除(§3.3)。
|
|
39
|
+
def render(template_path, data:, strict: true)
|
|
40
|
+
Render.new(template_path, data: DataLoading.coerce(data), strict: strict).call
|
|
41
|
+
end
|
|
42
|
+
|
|
43
|
+
# §7 模板校验器:对账模板标签 vs 样例数据,报告问题而不抛异常
|
|
44
|
+
# (语法错误也作为 error 条目输出)。返回 CheckResult:
|
|
45
|
+
# result.ok? / result.errors / result.warnings / result.exit_code / result.report
|
|
46
|
+
#
|
|
47
|
+
# data 支持 Hash 或 .toml 路径;缺省时只做语法与结构检查。
|
|
48
|
+
def check(template_path, data: nil)
|
|
49
|
+
data = DataLoading.coerce(data) if data
|
|
50
|
+
adapter = Adapter::RubyPptxAdapter.new
|
|
51
|
+
prs = adapter.open(template_path)
|
|
52
|
+
Validator.check(
|
|
53
|
+
contexts: adapter.paragraph_contexts(prs),
|
|
54
|
+
tables: adapter.table_cell_contexts(prs),
|
|
55
|
+
table_structures: adapter.table_contexts(prs),
|
|
56
|
+
notes: adapter.notes_texts(prs),
|
|
57
|
+
pictures: adapter.picture_contexts(prs),
|
|
58
|
+
data: data,
|
|
59
|
+
template_name: File.basename(template_path)
|
|
60
|
+
)
|
|
61
|
+
end
|
|
62
|
+
end
|
|
63
|
+
end
|
metadata
ADDED
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
--- !ruby/object:Gem::Specification
|
|
2
|
+
name: powertom
|
|
3
|
+
version: !ruby/object:Gem::Version
|
|
4
|
+
version: 0.2.2
|
|
5
|
+
platform: ruby
|
|
6
|
+
authors:
|
|
7
|
+
- PowerTom contributors
|
|
8
|
+
bindir: bin
|
|
9
|
+
cert_chain: []
|
|
10
|
+
date: 1980-01-02 00:00:00.000000000 Z
|
|
11
|
+
dependencies:
|
|
12
|
+
- !ruby/object:Gem::Dependency
|
|
13
|
+
name: ruby_pptx
|
|
14
|
+
requirement: !ruby/object:Gem::Requirement
|
|
15
|
+
requirements:
|
|
16
|
+
- - "~>"
|
|
17
|
+
- !ruby/object:Gem::Version
|
|
18
|
+
version: 0.2.0
|
|
19
|
+
type: :runtime
|
|
20
|
+
prerelease: false
|
|
21
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
22
|
+
requirements:
|
|
23
|
+
- - "~>"
|
|
24
|
+
- !ruby/object:Gem::Version
|
|
25
|
+
version: 0.2.0
|
|
26
|
+
- !ruby/object:Gem::Dependency
|
|
27
|
+
name: tomlrb
|
|
28
|
+
requirement: !ruby/object:Gem::Requirement
|
|
29
|
+
requirements:
|
|
30
|
+
- - "~>"
|
|
31
|
+
- !ruby/object:Gem::Version
|
|
32
|
+
version: '3.0'
|
|
33
|
+
type: :runtime
|
|
34
|
+
prerelease: false
|
|
35
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
36
|
+
requirements:
|
|
37
|
+
- - "~>"
|
|
38
|
+
- !ruby/object:Gem::Version
|
|
39
|
+
version: '3.0'
|
|
40
|
+
description: 设计师在 PowerPoint 里维护模板,工程师传一个 Ruby Hash,产出成品 deck。排版、字体、母版、主题完全由设计工具掌控,代码只负责扫描标签、绑定数据、克隆页面。
|
|
41
|
+
executables: []
|
|
42
|
+
extensions: []
|
|
43
|
+
extra_rdoc_files: []
|
|
44
|
+
files:
|
|
45
|
+
- LICENSE
|
|
46
|
+
- README.md
|
|
47
|
+
- lib/powertom.rb
|
|
48
|
+
- lib/powertom/adapter/page_surgery.rb
|
|
49
|
+
- lib/powertom/adapter/ruby_pptx_adapter.rb
|
|
50
|
+
- lib/powertom/binder.rb
|
|
51
|
+
- lib/powertom/data_loading.rb
|
|
52
|
+
- lib/powertom/formatter.rb
|
|
53
|
+
- lib/powertom/grid_value.rb
|
|
54
|
+
- lib/powertom/path_resolver.rb
|
|
55
|
+
- lib/powertom/render.rb
|
|
56
|
+
- lib/powertom/run_merge.rb
|
|
57
|
+
- lib/powertom/scanner.rb
|
|
58
|
+
- lib/powertom/table_loop.rb
|
|
59
|
+
- lib/powertom/validator.rb
|
|
60
|
+
- lib/powertom/version.rb
|
|
61
|
+
homepage: https://github.com/ixepet/powertom
|
|
62
|
+
licenses:
|
|
63
|
+
- MIT
|
|
64
|
+
metadata:
|
|
65
|
+
source_code_uri: https://github.com/ixepet/powertom
|
|
66
|
+
bug_tracker_uri: https://github.com/ixepet/powertom/issues
|
|
67
|
+
rdoc_options: []
|
|
68
|
+
require_paths:
|
|
69
|
+
- lib
|
|
70
|
+
required_ruby_version: !ruby/object:Gem::Requirement
|
|
71
|
+
requirements:
|
|
72
|
+
- - ">="
|
|
73
|
+
- !ruby/object:Gem::Version
|
|
74
|
+
version: '3.3'
|
|
75
|
+
required_rubygems_version: !ruby/object:Gem::Requirement
|
|
76
|
+
requirements:
|
|
77
|
+
- - ">="
|
|
78
|
+
- !ruby/object:Gem::Version
|
|
79
|
+
version: '0'
|
|
80
|
+
requirements: []
|
|
81
|
+
rubygems_version: 4.0.20
|
|
82
|
+
specification_version: 4
|
|
83
|
+
summary: PowerTom — PowerPoint template engine for Ruby
|
|
84
|
+
test_files: []
|