render.py 5.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152
  1. import argparse
  2. import sys
  3. import subprocess
  4. import multiprocessing
  5. from lib.os_tools import *
  6. from sccd.util.indenting_writer import *
  7. from sccd.model.xml_loader import *
  8. import lxml.etree as ET
  9. if __name__ == '__main__':
  10. parser = argparse.ArgumentParser(
  11. description="Render statecharts as SVG images.")
  12. parser.add_argument('path', metavar='PATH', type=str, nargs='*', help="Models to render. Can be a XML file or a directory. If a directory, it will be recursively scanned for XML files.")
  13. parser.add_argument('--build-dir', metavar='DIR', type=str, default='build', help="As a first step, input XML files first must be compiled to python files. Directory to store these files. Defaults to 'build'")
  14. parser.add_argument('--output-dir', metavar='DIR', type=str, default='', help="Directory for SVG rendered output. Defaults to '.' (putting the SVG files with the XML source files)")
  15. parser.add_argument('--keep-smcat', action='store_true', help="Whether to NOT delete intermediary SMCAT files after producing SVG output. Default = off (delete files)")
  16. parser.add_argument('--no-svg', action='store_true', help="Don't produce SVG output. This option only makes sense in combination with the --keep-smcat option. Default = off")
  17. parser.add_argument('--pool-size', metavar='INT', type=int, default=multiprocessing.cpu_count()+1, help="Number of worker processes. Default = CPU count + 1.")
  18. args = parser.parse_args()
  19. srcs = get_files(args.path,
  20. filter=lambda file: (file.startswith("statechart_") or file.startswith("test_")) and file.endswith(".xml"))
  21. if len(srcs):
  22. if not args.no_svg:
  23. try:
  24. subprocess.run(["state-machine-cat", "-h"], capture_output=True)
  25. except:
  26. print("Failed to run 'state-machine-cat'. Make sure this application is installed on your system.")
  27. exit()
  28. else:
  29. print("No input files specified.")
  30. print()
  31. parser.print_usage()
  32. exit()
  33. def process(src):
  34. statechart_node = ET.parse(src).getroot()
  35. tree_node = statechart_node.find(".//tree")
  36. if tree_node is None:
  37. return # no tree here :(
  38. tree = load_tree(Context(), tree_node)
  39. target_path = lambda ext: os.path.join(args.output_dir, dropext(src)+ext)
  40. smcat_target = target_path('.smcat')
  41. svg_target = target_path('.svg')
  42. make_dirs(smcat_target)
  43. f = open(smcat_target, 'w')
  44. w = IndentingWriter(f)
  45. def name_to_label(name):
  46. label = name.split('/')[-1]
  47. return label if len(label) else "root"
  48. def name_to_name(name):
  49. return name.replace('/','_')
  50. # Used for drawing initial state
  51. class PseudoState:
  52. def __init__(self, name):
  53. self.name = name
  54. # Used for drawing initial state
  55. class PseudoTransition:
  56. def __init__(self, source, targets):
  57. self.source = source
  58. self.targets = targets
  59. self.guard = None
  60. self.trigger = None
  61. self.actions = []
  62. transitions = []
  63. def write_state(s, hide=False):
  64. if not hide:
  65. w.write(name_to_name(s.name))
  66. w.extendWrite(' [label="')
  67. w.extendWrite(name_to_label(s.name))
  68. w.extendWrite('"')
  69. if isinstance(s, ParallelState):
  70. w.extendWrite(' type=parallel')
  71. elif isinstance(s, ShallowHistoryState):
  72. w.extendWrite(' type=history')
  73. elif isinstance(s, DeepHistoryState):
  74. w.extendWrite(' type=deephistory')
  75. else:
  76. w.extendWrite(' type=regular')
  77. w.extendWrite(']')
  78. if s.enter or s.exit:
  79. w.extendWrite(' :')
  80. for a in s.enter:
  81. w.write("onentry/ "+a.render())
  82. for a in s.exit:
  83. w.write("onexit/ "+a.render())
  84. w.write()
  85. if s.children:
  86. if not hide:
  87. w.extendWrite(' {')
  88. w.indent()
  89. if s.default_state:
  90. w.write(name_to_name(s.name)+'_initial [type=initial],')
  91. transitions.append(PseudoTransition(source=PseudoState(s.name+'/initial'), targets=[s.default_state]))
  92. for i, c in enumerate(s.children):
  93. write_state(c)
  94. w.extendWrite(',' if i < len(s.children)-1 else ';')
  95. if not hide:
  96. w.dedent()
  97. w.write('}')
  98. transitions.extend(s.transitions)
  99. write_state(tree.root, hide=True)
  100. ctr = 0
  101. for t in transitions:
  102. label = ""
  103. if t.trigger:
  104. label += t.trigger.render()
  105. if t.guard:
  106. label += ' ['+t.guard.render()+']'
  107. if t.actions:
  108. raises = [a for a in t.actions if isinstance(a, RaiseEvent)]
  109. label += ','.join([r.render() for r in raises])
  110. if len(t.targets) == 1:
  111. w.write(name_to_name(t.source.name) + ' -> ' + name_to_name(t.targets[0].name))
  112. if label:
  113. w.extendWrite(': '+label)
  114. w.extendWrite(';')
  115. else:
  116. w.write(name_to_name(t.source.name) + ' -> ' + ']split'+str(ctr))
  117. if label:
  118. w.extendWrite(': '+label)
  119. w.extendWrite(';')
  120. for tt in t.targets:
  121. w.write(']split'+str(ctr) + ' -> ' + name_to_name(tt.name))
  122. w.extendWrite(';')
  123. ctr += 1
  124. f.close()
  125. if args.keep_smcat:
  126. print("Wrote "+smcat_target)
  127. if not args.no_svg:
  128. subprocess.run(["state-machine-cat", smcat_target, "-o", svg_target])
  129. print("Wrote "+svg_target)
  130. if not args.keep_smcat:
  131. os.remove(smcat_target)
  132. pool_size = min(args.pool_size, len(srcs))
  133. with multiprocessing.Pool(processes=pool_size) as pool:
  134. print("Created a pool of %d processes."%pool_size)
  135. pool.map(process, srcs)