asciidoctor-diagram 1.5.19 → 2.0.5

Sign up to get free protection for your applications and to get access to all the features.
Files changed (110) hide show
  1. checksums.yaml +5 -5
  2. data/CHANGELOG.adoc +71 -0
  3. data/README.adoc +66 -20
  4. data/examples/features.adoc +2 -2
  5. data/lib/asciidoctor-diagram.rb +5 -0
  6. data/lib/asciidoctor-diagram/a2s/converter.rb +59 -0
  7. data/lib/asciidoctor-diagram/a2s/extension.rb +6 -52
  8. data/lib/asciidoctor-diagram/blockdiag/converter.rb +37 -0
  9. data/lib/asciidoctor-diagram/blockdiag/extension.rb +9 -116
  10. data/lib/asciidoctor-diagram/bpmn.rb +7 -0
  11. data/lib/asciidoctor-diagram/bpmn/converter.rb +62 -0
  12. data/lib/asciidoctor-diagram/bpmn/extension.rb +14 -0
  13. data/lib/asciidoctor-diagram/bytefield.rb +7 -0
  14. data/lib/asciidoctor-diagram/bytefield/converter.rb +26 -0
  15. data/lib/asciidoctor-diagram/bytefield/extension.rb +14 -0
  16. data/lib/asciidoctor-diagram/diagram_converter.rb +23 -0
  17. data/lib/asciidoctor-diagram/diagram_processor.rb +374 -0
  18. data/lib/asciidoctor-diagram/diagram_source.rb +322 -0
  19. data/lib/asciidoctor-diagram/ditaa/converter.rb +90 -0
  20. data/lib/asciidoctor-diagram/ditaa/extension.rb +6 -71
  21. data/lib/asciidoctor-diagram/dpic.rb +7 -0
  22. data/lib/asciidoctor-diagram/dpic/converter.rb +30 -0
  23. data/lib/asciidoctor-diagram/dpic/extension.rb +14 -0
  24. data/lib/asciidoctor-diagram/erd/converter.rb +31 -0
  25. data/lib/asciidoctor-diagram/erd/extension.rb +6 -35
  26. data/lib/asciidoctor-diagram/gnuplot/converter.rb +63 -0
  27. data/lib/asciidoctor-diagram/gnuplot/extension.rb +6 -62
  28. data/lib/asciidoctor-diagram/graphviz/converter.rb +32 -0
  29. data/lib/asciidoctor-diagram/graphviz/extension.rb +6 -35
  30. data/lib/asciidoctor-diagram/http/converter.rb +99 -0
  31. data/lib/asciidoctor-diagram/http/server.rb +132 -0
  32. data/lib/asciidoctor-diagram/lilypond/converter.rb +54 -0
  33. data/lib/asciidoctor-diagram/lilypond/extension.rb +6 -53
  34. data/lib/asciidoctor-diagram/meme/converter.rb +122 -0
  35. data/lib/asciidoctor-diagram/meme/extension.rb +5 -107
  36. data/lib/asciidoctor-diagram/mermaid/converter.rb +192 -0
  37. data/lib/asciidoctor-diagram/mermaid/extension.rb +6 -159
  38. data/lib/asciidoctor-diagram/msc/converter.rb +35 -0
  39. data/lib/asciidoctor-diagram/msc/extension.rb +6 -36
  40. data/lib/asciidoctor-diagram/nomnoml/converter.rb +25 -0
  41. data/lib/asciidoctor-diagram/nomnoml/extension.rb +6 -28
  42. data/lib/asciidoctor-diagram/pikchr.rb +7 -0
  43. data/lib/asciidoctor-diagram/pikchr/converter.rb +26 -0
  44. data/lib/asciidoctor-diagram/pikchr/extension.rb +14 -0
  45. data/lib/asciidoctor-diagram/plantuml/converter.rb +117 -0
  46. data/lib/asciidoctor-diagram/plantuml/extension.rb +10 -119
  47. data/lib/asciidoctor-diagram/shaape/converter.rb +25 -0
  48. data/lib/asciidoctor-diagram/shaape/extension.rb +6 -28
  49. data/lib/asciidoctor-diagram/smcat/converter.rb +44 -0
  50. data/lib/asciidoctor-diagram/smcat/extension.rb +6 -42
  51. data/lib/asciidoctor-diagram/svgbob/converter.rb +49 -0
  52. data/lib/asciidoctor-diagram/svgbob/extension.rb +6 -28
  53. data/lib/asciidoctor-diagram/symbolator.rb +7 -0
  54. data/lib/asciidoctor-diagram/symbolator/converter.rb +23 -0
  55. data/lib/asciidoctor-diagram/symbolator/extension.rb +14 -0
  56. data/lib/asciidoctor-diagram/syntrax/converter.rb +58 -0
  57. data/lib/asciidoctor-diagram/syntrax/extension.rb +6 -51
  58. data/lib/asciidoctor-diagram/tikz/converter.rb +75 -0
  59. data/lib/asciidoctor-diagram/tikz/extension.rb +6 -60
  60. data/lib/asciidoctor-diagram/umlet/converter.rb +33 -0
  61. data/lib/asciidoctor-diagram/umlet/extension.rb +6 -28
  62. data/lib/asciidoctor-diagram/util/cli.rb +14 -3
  63. data/lib/asciidoctor-diagram/util/cli_generator.rb +19 -1
  64. data/lib/asciidoctor-diagram/util/gif.rb +2 -2
  65. data/lib/asciidoctor-diagram/util/java.rb +114 -1
  66. data/lib/asciidoctor-diagram/util/java_socket.rb +8 -120
  67. data/lib/asciidoctor-diagram/util/pdf.rb +2 -2
  68. data/lib/asciidoctor-diagram/util/png.rb +2 -2
  69. data/lib/asciidoctor-diagram/util/svg.rb +46 -19
  70. data/lib/asciidoctor-diagram/util/which.rb +0 -29
  71. data/lib/asciidoctor-diagram/vega/converter.rb +47 -0
  72. data/lib/asciidoctor-diagram/vega/extension.rb +6 -44
  73. data/lib/asciidoctor-diagram/version.rb +1 -1
  74. data/lib/asciidoctor-diagram/wavedrom/converter.rb +50 -0
  75. data/lib/asciidoctor-diagram/wavedrom/extension.rb +6 -54
  76. data/lib/ditaa-1.3.15.jar +0 -0
  77. data/lib/plantuml-1.3.15.jar +0 -0
  78. data/lib/plantuml.jar +0 -0
  79. data/lib/server-1.3.15.jar +0 -0
  80. data/spec/a2s_spec.rb +2 -140
  81. data/spec/blockdiag_spec.rb +2 -200
  82. data/spec/bpmn_spec.rb +56 -0
  83. data/spec/bytefield_spec.rb +92 -0
  84. data/spec/ditaa_spec.rb +37 -143
  85. data/spec/dpic_spec.rb +19 -0
  86. data/spec/erd_spec.rb +2 -199
  87. data/spec/gnuplot_spec.rb +2 -255
  88. data/spec/graphviz_spec.rb +6 -145
  89. data/spec/lilypond_spec.rb +2 -140
  90. data/spec/mermaid_spec.rb +62 -209
  91. data/spec/msc_spec.rb +2 -199
  92. data/spec/nomnoml_spec.rb +4 -142
  93. data/spec/pikchr_spec.rb +51 -0
  94. data/spec/plantuml_spec.rb +24 -507
  95. data/spec/shaape_spec.rb +9 -221
  96. data/spec/shared_examples.rb +603 -0
  97. data/spec/smcat_spec.rb +2 -140
  98. data/spec/svgbob_spec.rb +2 -140
  99. data/spec/symbolator_spec.rb +23 -0
  100. data/spec/syntrax_spec.rb +5 -215
  101. data/spec/test_helper.rb +1 -21
  102. data/spec/tikz_spec.rb +65 -15
  103. data/spec/umlet_spec.rb +2 -58
  104. data/spec/vega_spec.rb +4 -117
  105. data/spec/wavedrom_spec.rb +2 -199
  106. metadata +58 -8
  107. data/lib/asciidoctor-diagram/extensions.rb +0 -568
  108. data/lib/ditaa-1.3.13.jar +0 -0
  109. data/lib/plantuml-1.3.13.jar +0 -0
  110. data/lib/server-1.3.13.jar +0 -0
@@ -0,0 +1,192 @@
1
+ require_relative '../diagram_converter'
2
+ require_relative '../util/cli'
3
+ require_relative '../util/cli_generator'
4
+ require_relative '../util/platform'
5
+
6
+ module Asciidoctor
7
+ module Diagram
8
+ # @private
9
+ class MermaidConverter
10
+ include DiagramConverter
11
+ include CliGenerator
12
+
13
+
14
+ def supported_formats
15
+ [:png, :svg]
16
+ end
17
+
18
+ def native_scaling?
19
+ true
20
+ end
21
+
22
+ def collect_options(source)
23
+ options = {}
24
+
25
+ options[:css] = source.attr('css')
26
+ options[:gantt_config] = source.attr(['ganttconfig', 'gantt-config'])
27
+ options[:seq_config] = source.attr(['sequenceconfig', 'sequence-config'])
28
+ options[:width] = source.attr('width')
29
+ options[:height] = source.attr('height')
30
+ options[:scale] = source.attr('scale')
31
+ if options[:scale]
32
+ raise "Mermaid only supports integer scale factors: #{options[:scale]}" unless options[:scale] =~ /^[0-9]+$/
33
+ end
34
+ options[:theme] = source.attr('theme')
35
+ options[:background] = source.attr('background')
36
+ options[:config] = source.attr('config')
37
+ options[:puppeteer_config] = source.attr(['puppeteerconfig', 'puppeteer-config'])
38
+
39
+ options
40
+ end
41
+
42
+ def convert(source, format, options)
43
+ opts = {}
44
+
45
+ css = options[:css]
46
+ if css
47
+ opts[:css] = source.resolve_path(css)
48
+ end
49
+
50
+ gantt_config = options[:gantt_config]
51
+ if gantt_config
52
+ opts[:gantt] = source.resolve_path(gantt_config)
53
+ end
54
+
55
+ seq_config = options[:seq_config]
56
+ if seq_config
57
+ opts[:sequence] = source.resolve_path(seq_config)
58
+ end
59
+
60
+ puppeteer_config = options[:puppeteer_config]
61
+ if puppeteer_config
62
+ opts[:puppeteer] = source.resolve_path(puppeteer_config)
63
+ end
64
+
65
+ opts[:width] = options[:width]
66
+
67
+ mmdc = source.find_command('mmdc', :raise_on_error => false)
68
+ node = source.find_command('node', :raise_on_error => false)
69
+ if mmdc && node
70
+ opts[:height] = options[:height]
71
+ opts[:scale] = options[:scale]
72
+ opts[:theme] = options[:theme]
73
+ opts[:background] = options[:background]
74
+ config = options[:config]
75
+ if config
76
+ opts[:config] = source.resolve_path(config)
77
+ end
78
+ run_mmdc(node, mmdc, source, format, opts)
79
+ else
80
+ mermaid = source.find_command('mermaid')
81
+ run_mermaid(mermaid, source, format, opts)
82
+ end
83
+ end
84
+
85
+ private
86
+ def run_mmdc(node, mmdc, source, format, options = {})
87
+ generate_file(node, 'mmd', format.to_s, source.to_s) do |tool_path, input_path, output_path|
88
+ args = [tool_path, '--unhandled-rejections=strict', mmdc, '-i', Platform.native_path(input_path), '-o', Platform.native_path(output_path)]
89
+
90
+ if options[:css]
91
+ args << '--cssFile' << Platform.native_path(options[:css])
92
+ end
93
+
94
+ if options[:theme]
95
+ args << '--theme' << options[:theme]
96
+ end
97
+
98
+ if options[:width]
99
+ args << '--width' << options[:width]
100
+ end
101
+
102
+ if options[:height]
103
+ args << '--height' << options[:height]
104
+ end
105
+
106
+ if options[:scale]
107
+ args << '--scale' << options[:scale]
108
+ end
109
+
110
+ if options[:background]
111
+ bg = options[:background]
112
+ bg = "##{bg}" unless bg[0] == '#'
113
+ args << '--backgroundColor' << bg
114
+ end
115
+
116
+ if options[:config]
117
+ args << '--configFile' << Platform.native_path(options[:config])
118
+ elsif options[:gantt] || options[:sequence]
119
+ mermaidConfig = []
120
+
121
+ if options[:gantt]
122
+ mermaidConfig << "\"gantt\": #{File.read(options[:gantt])}"
123
+ end
124
+
125
+ if options[:sequence]
126
+ configKey = source.config['mmdcSequenceConfigKey'] ||= begin
127
+ version_parts = ::Asciidoctor::Diagram::Cli.run(mmdc, '--version')[:out].split('.').map { |p| p.to_i }
128
+ major = version_parts[0] || 0
129
+ minor = version_parts[1] || 0
130
+ patch = version_parts[2] || 0
131
+ if major > 0 || (major == 0 && minor > 4) || (major == 0 && minor == 4 && patch > 1)
132
+ 'sequence'
133
+ else
134
+ 'sequenceDiagram'
135
+ end
136
+ end
137
+ mermaidConfig << "\"#{configKey}\": #{File.read(options[:sequence])}"
138
+ end
139
+
140
+ config_file = "#{input_path}.json"
141
+
142
+ File.write(config_file, "{#{mermaidConfig.join ','}}")
143
+
144
+ args << '--configFile' << Platform.native_path(config_file)
145
+ end
146
+
147
+ if options[:puppeteer]
148
+ args << '--puppeteerConfigFile' << Platform.native_path(options[:puppeteer])
149
+ end
150
+
151
+ args
152
+ end
153
+ end
154
+
155
+ def run_mermaid(mermaid, source, format, options = {})
156
+ source.config['mermaid>=6'] ||= ::Asciidoctor::Diagram::Cli.run(mermaid, '--version')[:out].split('.')[0].to_i >= 6
157
+ # Mermaid >= 6.0.0 requires PhantomJS 2.1; older version required 1.9
158
+ phantomjs = source.find_command('phantomjs', :alt_attrs => [source.config['mermaid>=6'] ? 'phantomjs_2' : 'phantomjs_19'])
159
+
160
+ generate_file(mermaid, 'mmd', format.to_s, source.to_s) do |tool_path, input_path, output_path|
161
+ output_dir = File.dirname(output_path)
162
+ output_file = File.expand_path(File.basename(input_path) + ".#{format.to_s}", output_dir)
163
+
164
+ args = [tool_path, '--phantomPath', Platform.native_path(phantomjs), "--#{format.to_s}", '-o', Platform.native_path(output_dir)]
165
+
166
+ if options[:css]
167
+ args << '--css' << Platform.native_path(options[:css])
168
+ end
169
+
170
+ if options[:gantt]
171
+ args << '--gantt_config' << Platform.native_path(options[:gantt])
172
+ end
173
+
174
+ if options[:sequence]
175
+ args << '--sequenceConfig' << Platform.native_path(options[:sequence])
176
+ end
177
+
178
+ if options[:width]
179
+ args << '--width' << options[:width]
180
+ end
181
+
182
+ args << Platform.native_path(input_path)
183
+
184
+ {
185
+ :args => args,
186
+ :out_file => output_file
187
+ }
188
+ end
189
+ end
190
+ end
191
+ end
192
+ end
@@ -1,167 +1,14 @@
1
- require_relative '../extensions'
2
- require_relative '../util/cli'
3
- require_relative '../util/cli_generator'
4
- require_relative '../util/platform'
5
- require_relative '../util/which'
1
+ require_relative 'converter'
2
+ require_relative '../diagram_processor'
6
3
 
7
4
  module Asciidoctor
8
5
  module Diagram
9
- # @private
10
- module Mermaid
11
- include CliGenerator
12
- include Which
13
-
14
- def self.included(mod)
15
- [:png, :svg].each do |f|
16
- mod.register_format(f, :image) do |parent, source|
17
- mermaid(parent, source, f)
18
- end
19
- end
20
- end
21
-
22
- def mermaid(parent_block, source, format)
23
- inherit_prefix = name
24
-
25
- options = {}
26
-
27
- css = source.attr('css', nil, inherit_prefix)
28
- if css
29
- options[:css] = parent_block.normalize_system_path(css, source.base_dir)
30
- end
31
-
32
- gantt_config = source.attr('ganttConfig', nil, inherit_prefix) || source.attr('ganttconfig', nil, inherit_prefix)
33
- if gantt_config
34
- options[:gantt] = parent_block.normalize_system_path(gantt_config, source.base_dir)
35
- end
36
-
37
- seq_config = source.attr('sequenceConfig', nil, inherit_prefix) || source.attr('sequenceconfig', nil, inherit_prefix)
38
- if seq_config
39
- options[:sequence] = parent_block.normalize_system_path(seq_config, source.base_dir)
40
- end
41
-
42
- options[:width] = source.attr('width', nil, inherit_prefix)
43
-
44
- mmdc = which(parent_block, 'mmdc', :raise_on_error => false)
45
- if mmdc
46
- options[:height] = source.attr('height', nil, inherit_prefix)
47
- options[:theme] = source.attr('theme', nil, inherit_prefix)
48
- options[:background] = source.attr('background', nil, inherit_prefix)
49
- config = source.attr('config', nil, inherit_prefix) || source.attr('config', nil, inherit_prefix)
50
- if config
51
- options[:config] = parent_block.normalize_system_path(config, source.base_dir)
52
- end
53
- run_mmdc(mmdc, source, format, options)
54
- else
55
- mermaid = which(parent_block, 'mermaid')
56
- run_mermaid(mermaid, parent_block, source, format, options)
57
- end
58
- end
59
-
60
- private
61
- def run_mmdc(mmdc, source, format, options = {})
62
- generate_file(mmdc, 'mmd', format.to_s, source.to_s) do |tool_path, input_path, output_path|
63
- args = [tool_path, '-i', Platform.native_path(input_path), '-o', Platform.native_path(output_path)]
64
-
65
- if options[:css]
66
- args << '--cssFile' << Platform.native_path(options[:css])
67
- end
68
-
69
- if options[:theme]
70
- args << '--theme' << options[:theme]
71
- end
72
-
73
- if options[:width]
74
- args << '--width' << options[:width]
75
- end
76
-
77
- if options[:height]
78
- args << '--height' << options[:height]
79
- end
80
-
81
- if options[:background]
82
- bg = options[:background]
83
- bg = "##{bg}" unless bg[0] == '#'
84
- args << '--backgroundColor' << bg
85
- end
86
-
87
- if options[:config]
88
- args << '--configFile' << Platform.native_path(options[:config])
89
- elsif options[:gantt] || options[:sequence]
90
- mermaidConfig = []
91
-
92
- if options[:gantt]
93
- mermaidConfig << "\"gantt\": #{File.read(options[:gantt])}"
94
- end
95
-
96
- if options[:sequence]
97
- configKey = config['mmdcSequenceConfigKey'] ||= begin
98
- version_parts = ::Asciidoctor::Diagram::Cli.run(mmdc, '--version')[:out].split('.').map { |p| p.to_i }
99
- major = version_parts[0] || 0
100
- minor = version_parts[1] || 0
101
- patch = version_parts[2] || 0
102
- if major > 0 || (major == 0 && minor > 4) || (major == 0 && minor == 4 && patch > 1)
103
- 'sequence'
104
- else
105
- 'sequenceDiagram'
106
- end
107
- end
108
- mermaidConfig << "\"#{configKey}\": #{File.read(options[:sequence])}"
109
- end
110
-
111
- config_file = "#{input_path}.json"
112
-
113
- File.write(config_file, "{#{mermaidConfig.join ','}}")
114
-
115
- args << '--configFile' << Platform.native_path(config_file)
116
- end
117
-
118
- args
119
- end
120
- end
121
-
122
- def run_mermaid(mermaid, parent_block, source, format, options = {})
123
- config['mermaid>=6'] ||= ::Asciidoctor::Diagram::Cli.run(mermaid, '--version')[:out].split('.')[0].to_i >= 6
124
- # Mermaid >= 6.0.0 requires PhantomJS 2.1; older version required 1.9
125
- phantomjs = which(parent_block, 'phantomjs', :alt_attrs => [config['mermaid>=6'] ? 'phantomjs_2' : 'phantomjs_19'])
126
-
127
- generate_file(mermaid, 'mmd', format.to_s, source.to_s) do |tool_path, input_path, output_path|
128
- output_dir = File.dirname(output_path)
129
- output_file = File.expand_path(File.basename(input_path) + ".#{format.to_s}", output_dir)
130
-
131
- args = [tool_path, '--phantomPath', Platform.native_path(phantomjs), "--#{format.to_s}", '-o', Platform.native_path(output_dir)]
132
-
133
- if options[:css]
134
- args << '--css' << Platform.native_path(options[:css])
135
- end
136
-
137
- if options[:gantt]
138
- args << '--gantt_config' << Platform.native_path(options[:gantt])
139
- end
140
-
141
- if options[:sequence]
142
- args << '--sequenceConfig' << Platform.native_path(options[:sequence])
143
- end
144
-
145
- if options[:width]
146
- args << '--width' << options[:width]
147
- end
148
-
149
- args << Platform.native_path(input_path)
150
-
151
- {
152
- :args => args,
153
- :out_file => output_file
154
- }
155
- end
156
- end
157
- end
158
-
159
- class MermaidBlockProcessor < Extensions::DiagramBlockProcessor
160
- include Mermaid
6
+ class MermaidBlockProcessor < DiagramBlockProcessor
7
+ use_converter MermaidConverter
161
8
  end
162
9
 
163
- class MermaidBlockMacroProcessor < Extensions::DiagramBlockMacroProcessor
164
- include Mermaid
10
+ class MermaidBlockMacroProcessor < DiagramBlockMacroProcessor
11
+ use_converter MermaidConverter
165
12
  end
166
13
  end
167
14
  end
@@ -0,0 +1,35 @@
1
+ require_relative '../diagram_converter'
2
+ require_relative '../util/cli_generator'
3
+ require_relative '../util/platform'
4
+
5
+ module Asciidoctor
6
+ module Diagram
7
+ # @private
8
+ class MscgenConverter
9
+ include DiagramConverter
10
+ include CliGenerator
11
+
12
+
13
+ def supported_formats
14
+ [:png, :svg]
15
+ end
16
+
17
+ def collect_options(source)
18
+ {:font => source.attr('font')}
19
+ end
20
+
21
+ def convert(source, format, options)
22
+ font = options[:font]
23
+
24
+ generate_stdin(source.find_command('mscgen'), format.to_s, source.to_s) do |tool_path, output_path|
25
+ args = [tool_path, '-o', Platform.native_path(output_path), '-T', format.to_s]
26
+ if font
27
+ args << '-F' << font
28
+ end
29
+ args << '-'
30
+ args
31
+ end
32
+ end
33
+ end
34
+ end
35
+ end
@@ -1,44 +1,14 @@
1
- require_relative '../extensions'
2
- require_relative '../util/cli_generator'
3
- require_relative '../util/platform'
4
- require_relative '../util/which'
1
+ require_relative 'converter'
2
+ require_relative '../diagram_processor'
5
3
 
6
4
  module Asciidoctor
7
5
  module Diagram
8
- # @private
9
- module Mscgen
10
- include CliGenerator
11
- include Which
12
-
13
- def self.included(mod)
14
- [:png, :svg].each do |f|
15
- mod.register_format(f, :image) do |parent, source|
16
- mscgen(parent, source, f)
17
- end
18
- end
19
- end
20
-
21
- def mscgen(parent, source, format)
22
- inherit_prefix = name
23
- font = source.attr('font', nil, inherit_prefix)
24
-
25
- generate_stdin(which(parent, 'mscgen'), format.to_s, source.to_s) do |tool_path, output_path|
26
- args = [tool_path, '-o', Platform.native_path(output_path), '-T', format.to_s]
27
- if font
28
- args << '-F' << font
29
- end
30
- args << '-'
31
- args
32
- end
33
- end
34
- end
35
-
36
- class MscBlockProcessor < Extensions::DiagramBlockProcessor
37
- include Mscgen
6
+ class MscBlockProcessor < DiagramBlockProcessor
7
+ use_converter MscgenConverter
38
8
  end
39
9
 
40
- class MscBlockMacroProcessor < Extensions::DiagramBlockMacroProcessor
41
- include Mscgen
10
+ class MscBlockMacroProcessor < DiagramBlockMacroProcessor
11
+ use_converter MscgenConverter
42
12
  end
43
13
  end
44
14
  end