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.
@@ -0,0 +1,6 @@
1
+ # frozen_string_literal: true
2
+
3
+ module PowerTom
4
+ # 设计文档 §6:v0.2 系列首个正式发布
5
+ VERSION = "0.2.2"
6
+ end
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: []