parameters: ()
docstring: Generate .js files defining Blockly core and language messages.
docstring_summary: Generate .js files defining Blockly core and language messages.
docstring_tokens: Generate . js files defining Blockly core and language messages .
function: def main():
    """Generate .js files defining Blockly core and language messages."""
  
    # Process command-line arguments.
    parser = argparse.ArgumentParser(description='Convert JSON files to JS.')
    parser.add_argument('--source_lang', default='en',
                        help='ISO 639-1 source language code')
    parser.add_argument('--source_lang_file',
                        default=os.path.join('json', 'en.json'),
                        help='Path to .json file for source language')
    parser.add_argument('--source_synonym_file',
                        default=os.path.join('json', 'synonyms.json'),
                        help='Path to .json file with synonym definitions')
    parser.add_argument('--output_dir', default='js/',
                        help='relative directory for output files')
    parser.add_argument('--key_file', default='keys.json',
                        help='relative path to input keys file')
    parser.add_argument('--quiet', action='store_true', default=False,
                        help='do not write anything to standard output')
    parser.add_argument('files', nargs='+', help='input files')
    args = parser.parse_args()
    if not args.output_dir.endswith(os.path.sep):
      args.output_dir += os.path.sep
  
    # Read in source language .json file, which provides any values missing
    # in target languages' .json files.
    source_defs = read_json_file(os.path.join(os.curdir, args.source_lang_file))
    # Make sure the source file doesn't contain a newline or carriage return.
    for key, value in source_defs.items():
      if _NEWLINE_PATTERN.search(value):
        print('ERROR: definition of {0} in {1} contained a newline character.'.
              format(key, args.source_lang_file))
        sys.exit(1)
    sorted_keys = source_defs.keys()
    sorted_keys.sort()
  
    # Read in synonyms file, which must be output in every language.
    synonym_defs = read_json_file(os.path.join(
        os.curdir, args.source_synonym_file))
    synonym_text = '\n'.join(['Blockly.Msg.{0} = Blockly.Msg.{1};'.format(
        key, synonym_defs[key]) for key in synonym_defs])
  
    # Create each output file.
    for arg_file in args.files:
      (_, filename) = os.path.split(arg_file)
      target_lang = filename[:filename.index('.')]
      if target_lang not in ('qqq', 'keys', 'synonyms'):
        target_defs = read_json_file(os.path.join(os.curdir, arg_file))
  
        # Verify that keys are 'ascii'
        bad_keys = [key for key in target_defs if not string_is_ascii(key)]
        if bad_keys:
          print(u'These keys in {0} contain non ascii characters: {1}'.format(
              filename, ', '.join(bad_keys)))
  
        # If there's a '\n' or '\r', remove it and print a warning.
        for key, value in target_defs.items():
          if _NEWLINE_PATTERN.search(value):
            print(u'WARNING: definition of {0} in {1} contained '
                  'a newline character.'.
                  format(key, arg_file))
            target_defs[key] = _NEWLINE_PATTERN.sub(' ', value)
  
        # Output file.
        outname = os.path.join(os.curdir, args.output_dir, target_lang + '.js')
        with codecs.open(outname, 'w', 'utf-8') as outfile:
          outfile.write(
              """// This file was automatically generated.  Do not modify.
  
  'use strict';
  
  goog.provide('Blockly.Msg.{0}');
  
  goog.require('Blockly.Msg');
  
  """.format(target_lang.replace('-', '.')))
          # For each key in the source language file, output the target value
          # if present; otherwise, output the source language value with a
          # warning comment.
          for key in sorted_keys:
            if key in target_defs:
              value = target_defs[key]
              comment = ''
              del target_defs[key]
            else:
              value = source_defs[key]
              comment = '  // untranslated'
            value = value.replace('"', '\\"')
            outfile.write(u'Blockly.Msg.{0} = "{1}";{2}\n'.format(
                key, value, comment))
  
          # Announce any keys defined only for target language.
          if target_defs:
            extra_keys = [key for key in target_defs if key not in synonym_defs]
            synonym_keys = [key for key in target_defs if key in synonym_defs]
            if not args.quiet:
              if extra_keys:
                print(u'These extra keys appeared in {0}: {1}'.format(
                    filename, ', '.join(extra_keys)))
              if synonym_keys:
                print(u'These synonym keys appeared in {0}: {1}'.format(
                    filename, ', '.join(synonym_keys)))
  
          outfile.write(synonym_text)
  
        if not args.quiet:
          print('Created {0}.'.format(outname))
function_tokens: def main ( ) : # Process command-line arguments. parser = argparse . ArgumentParser ( description = 'Convert JSON files to JS.' ) parser . add_argument ( '--source_lang' , default = 'en' , help = 'ISO 639-1 source language code' ) parser . add_argument ( '--source_lang_file' , default = os . path . join ( 'json' , 'en.json' ) , help = 'Path to .json file for source language' ) parser . add_argument ( '--source_synonym_file' , default = os . path . join ( 'json' , 'synonyms.json' ) , help = 'Path to .json file with synonym definitions' ) parser . add_argument ( '--output_dir' , default = 'js/' , help = 'relative directory for output files' ) parser . add_argument ( '--key_file' , default = 'keys.json' , help = 'relative path to input keys file' ) parser . add_argument ( '--quiet' , action = 'store_true' , default = False , help = 'do not write anything to standard output' ) parser . add_argument ( 'files' , nargs = '+' , help = 'input files' ) args = parser . parse_args ( ) if not args . output_dir . endswith ( os . path . sep ) : args . output_dir += os . path . sep # Read in source language .json file, which provides any values missing # in target languages' .json files. source_defs = read_json_file ( os . path . join ( os . curdir , args . source_lang_file ) ) # Make sure the source file doesn't contain a newline or carriage return. for key , value in source_defs . items ( ) : if _NEWLINE_PATTERN . search ( value ) : print ( 'ERROR: definition of {0} in {1} contained a newline character.' . format ( key , args . source_lang_file ) ) sys . exit ( 1 ) sorted_keys = source_defs . keys ( ) sorted_keys . sort ( ) # Read in synonyms file, which must be output in every language. synonym_defs = read_json_file ( os . path . join ( os . curdir , args . source_synonym_file ) ) synonym_text = '\n' . join ( [ 'Blockly.Msg.{0} = Blockly.Msg.{1};' . format ( key , synonym_defs [ key ] ) for key in synonym_defs ] ) # Create each output file. for arg_file in args . files : ( _ , filename ) = os . path . split ( arg_file ) target_lang = filename [ : filename . index ( '.' ) ] if target_lang not in ( 'qqq' , 'keys' , 'synonyms' ) : target_defs = read_json_file ( os . path . join ( os . curdir , arg_file ) ) # Verify that keys are 'ascii' bad_keys = [ key for key in target_defs if not string_is_ascii ( key ) ] if bad_keys : print ( u'These keys in {0} contain non ascii characters: {1}' . format ( filename , ', ' . join ( bad_keys ) ) ) # If there's a '\n' or '\r', remove it and print a warning. for key , value in target_defs . items ( ) : if _NEWLINE_PATTERN . search ( value ) : print ( u'WARNING: definition of {0} in {1} contained ' 'a newline character.' . format ( key , arg_file ) ) target_defs [ key ] = _NEWLINE_PATTERN . sub ( ' ' , value ) # Output file. outname = os . path . join ( os . curdir , args . output_dir , target_lang + '.js' ) with codecs . open ( outname , 'w' , 'utf-8' ) as outfile : outfile . write ( """// This file was automatically generated.  Do not modify.
  
  'use strict';
  
  goog.provide('Blockly.Msg.{0}');
  
  goog.require('Blockly.Msg');
  
  """ . format ( target_lang . replace ( '-' , '.' ) ) ) # For each key in the source language file, output the target value # if present; otherwise, output the source language value with a # warning comment. for key in sorted_keys : if key in target_defs : value = target_defs [ key ] comment = '' del target_defs [ key ] else : value = source_defs [ key ] comment = '  // untranslated' value = value . replace ( '"' , '\\"' ) outfile . write ( u'Blockly.Msg.{0} = "{1}";{2}\n' . format ( key , value , comment ) ) # Announce any keys defined only for target language. if target_defs : extra_keys = [ key for key in target_defs if key not in synonym_defs ] synonym_keys = [ key for key in target_defs if key in synonym_defs ] if not args . quiet : if extra_keys : print ( u'These extra keys appeared in {0}: {1}' . format ( filename , ', ' . join ( extra_keys ) ) ) if synonym_keys : print ( u'These synonym keys appeared in {0}: {1}' . format ( filename , ', ' . join ( synonym_keys ) ) ) outfile . write ( synonym_text ) if not args . quiet : print ( 'Created {0}.' . format ( outname ) )