Make gen files more human-readable by using a string initializer

runtime/tools/create_string_literal.py

 # Copyright (c) 2011, the Dart project authors.  Please see the AUTHORS file
 # for details. All rights reserved. Use of this source code is governed by a
 # BSD-style license that can be found in the LICENSE file.
 #
 # This python script creates a string literal in a C++ source file from a C++
 # source template and text file.
 
 import os
 import sys
 from os.path import join
 import time
 from optparse import OptionParser
 
 
 def makeString(input_files):
+  printable = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ\
+!#$%&'()*+,-./:;<=>?@[]^_`{|}~ "
   result = ' '
+  lineNumber = 1
   for string_file in input_files:
     if string_file.endswith('dart'):
       fileHandle = open(string_file, 'rb')
-      lineCounter = 0
-      result += ' // ' + string_file + '\n   '
+      quoted = False
+      result += '\n  // ----- ' + string_file + ' -----\n\n'
       for byte in fileHandle.read():
-        result += ' %d,' % ord(byte)
-        lineCounter += 1
-        if lineCounter == 10:
-          result += '\n   '
-          lineCounter = 0
-      if lineCounter != 0:
-        result += '\n   '
-  result += ' // Terminating null character.\n    0'
+        if not quoted:
+          result += '  "'
+          quoted = True
+        if byte in printable:
+          result += byte
+        elif byte == '\n':
+          if lineNumber % 10 == 0:
+            result += '\\n" /* L%d */\n' % lineNumber
+          else:
+            result += '\\n"\n'
+          lineNumber += 1
+          quoted = False
+        elif byte == '\"':
+          result += '\\"'
+        else:
+          result += '\\x%02x' % ord(byte)
   return result
 
 
 def makeFile(output_file, input_cc_file, input_files):
   bootstrap_cc_text = open(input_cc_file).read()
   bootstrap_cc_text = bootstrap_cc_text.replace("{{DART_SOURCE}}",
       makeString(input_files))
   open(output_file, 'w').write(bootstrap_cc_text)
   return True
 
@@ skipping 29 matching lines @@
 
     return 0
   except Exception, inst:
     sys.stderr.write('create_string_literal.py exception\n')
     sys.stderr.write(str(inst))
     sys.stderr.write('\n')
     return -1
 
 if __name__ == '__main__':
   sys.exit(main(sys.argv))