Add option to GRIT to provide a resource ordering input file.

tools/grit/grit/grd_reader.py

 #!/usr/bin/env python
 # Copyright (c) 2012 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
 '''Class for reading GRD files into memory, without processing them.
 '''
 
 import os.path
 import types
 import xml.sax
 import xml.sax.handler
 
 from grit import exception
 from grit import util
+from grit.format import rc_header
 from grit.node import base
 from grit.node import mapping
 from grit.node import misc
 
 
 class StopParsingException(Exception):
   '''An exception used to stop parsing.'''
   pass
 
 
@@ skipping 106 matching lines @@
       self.parent.endElement(name)
 
   def characters(self, content):
     self.parent.characters(content)
 
   def ignorableWhitespace(self, whitespace):
     self.parent.ignorableWhitespace(whitespace)
 
 
 def Parse(filename_or_stream, dir=None, stop_after=None, first_ids_file=None,
-          debug=False, defines=None, tags_to_ignore=None, target_platform=None):
+          debug=False, defines=None, tags_to_ignore=None, target_platform=None,
+          predetermined_ids_file=None):
   '''Parses a GRD file into a tree of nodes (from grit.node).
 
   If filename_or_stream is a stream, 'dir' should point to the directory
   notionally containing the stream (this feature is only used in unit tests).
 
   If 'stop_after' is provided, the parsing will stop once the first node
   with this name has been fully parsed (including all its contents).
 
   If 'debug' is true, lots of information about the parsing events will be
   printed out during parsing of the file.
 
   If 'first_ids_file' is non-empty, it is used to override the setting for the
   first_ids_file attribute of the <grit> root node. Note that the first_ids_file
   parameter should be relative to the cwd, even though the first_ids_file
   attribute of the <grit> node is relative to the grd file.
 
   If 'target_platform' is set, this is used to determine the target
   platform of builds, instead of using |sys.platform|.
 
   Args:
     filename_or_stream: './bla.xml'
     dir: None (if filename_or_stream is a filename) or '.'
     stop_after: 'inputs'
     first_ids_file: 'GRIT_DIR/../gritsettings/resource_ids'
     debug: False
     defines: dictionary of defines, like {'chromeos': '1'}
     target_platform: None or the value that would be returned by sys.platform
         on your target platform.
+    predetermined_ids_file: File path to a file containing a pre-determined
+        mapping from resource names to resource ids which will be used to assign
+        resource ids to those resources.
 
   Return:
     Subclass of grit.node.base.Node
 
   Throws:
     grit.exception.Parsing
   '''
 
   if dir is None and isinstance(filename_or_stream, types.StringType):
     dir = util.dirname(filename_or_stream)
 
+  rc_header.SetPredeterminedIdsFile(predetermined_ids_file)
   handler = GrdContentHandler(stop_after=stop_after, debug=debug, dir=dir,
                               defines=defines, tags_to_ignore=tags_to_ignore,
                               target_platform=target_platform)
   try:
     xml.sax.parse(filename_or_stream, handler)
   except StopParsingException:
     assert stop_after
     pass
   except:
     if not debug:
@@ skipping 20 matching lines @@
       handler.root.attrs['first_ids_file'] = first_ids_file
     # Assign first ids to the nodes that don't have them.
     handler.root.AssignFirstIds(filename_or_stream, defines)
 
   return handler.root
 
 
 if __name__ == '__main__':
   util.ChangeStdoutEncoding()
   print unicode(Parse(sys.argv[1]))