deprecate tools/test_rendering.py and tools/test_pictures.py

tools/test_rendering.py

 '''
 Copyright 2012 Google Inc.
 
 Use of this source code is governed by a BSD-style license that can be
 found in the LICENSE file.
 
 Compares the rendererings of serialized SkPictures to expected result.
 
-TODO(epoger): Combine with overlapping tools/tests/render_pictures_test.py .
+TODO(epoger): We believe this script is no longer used, so we have disabled it
+and will remove it on 1 Feb 2014 if nobody objects.
 See https://code.google.com/p/skia/issues/detail?id=1943#c2
 '''
 # common Python modules
 import os
 import optparse
 import sys
 import shutil
 import tempfile
 
 USAGE_STRING = 'Usage: %s input... expectedDir render_app [reander_app_args]'
 HELP_STRING = '''
 
 Compares the renderings of serialized SkPicture files and directories specified
 by input with the files in expectedDir. Note, files in directoriers are
 expected to end with .skp.
 '''
 
+def _DieBecauseDeprecated():
+    print ('We believe this script is no longer used, so we have disabled it '
+           'and will remove it on 1 Feb 2014 if nobody objects. See '
+           'https://code.google.com/p/skia/issues/detail?id=1943#c2')
+    sys.exit(-1)
+
 def RunCommand(command):
     """Run a command.
 
     @param command the command as a single string
     """
+    _DieBecauseDeprecated()
     print 'running command [%s]...' % command
     os.system(command)
 
 
 def FindPathToProgram(program):
     """Return path to an existing program binary, or raise an exception if we
     cannot find one.
 
     @param program the name of the program that is being looked for
     """
+    _DieBecauseDeprecated()
     trunk_path = os.path.abspath(os.path.join(os.path.dirname(__file__),
                                               os.pardir))
     possible_paths = [os.path.join(trunk_path, 'out', 'Release', program),
                       os.path.join(trunk_path, 'out', 'Debug', program),
                       os.path.join(trunk_path, 'out', 'Release',
                                    program + ".exe"),
                       os.path.join(trunk_path, 'out', 'Debug',
                                    program + ".exe")]
     for try_path in possible_paths:
         if os.path.isfile(try_path):
             return try_path
     raise Exception('cannot find %s in paths %s; maybe you need to '
                     'build %s?' % (program, possible_paths, program))
 
 
 def RenderSkps(inputs, render_dir, render_app, args):
     """Renders the serialized SkPictures.
 
     Uses the render_pictures program to do the rendering.
 
     @param inputs the location(s) to read the serlialized SkPictures
     @param render_dir the location to write out the rendered images
     """
+    _DieBecauseDeprecated()
     renderer_path = FindPathToProgram(render_app)
     inputs_as_string = " ".join(inputs)
     command = '%s %s %s' % (renderer_path, inputs_as_string, render_dir)
 
     command += args
 
     RunCommand(command)
 
 
 def DiffRenderings(expected_dir, comparison_dir, diff_dir):
     """Diffs the rendered SkPicture files with the baseline files.
 
     Uses the skdiff program to do the diffing.
 
     @param expected_dir the location of the baseline images.
     @param comparison_dir the location of the images to comapre with the
            baseline
     @param diff_dir the location to write out the diff results
     """
+    _DieBecauseDeprecated()
     skdiff_path = FindPathToProgram('skdiff')
     RunCommand('%s %s %s %s %s' %
                (skdiff_path, expected_dir, comparison_dir, diff_dir,
                 '--noprintdirs'))
 
 
 def Cleanup(render_dir_option, diff_dir_option, render_dir, diff_dir):
     """Deletes any temporary folders and files created.
 
     @param foo_option The OptionParser parsed render_dir or diff_dir vars.
             If these variables are not passed by user we ended up creating
             temporary directories (render_dir, diff_dir) which we will remove.
     @param render_dir the directory where the rendered images were written
     @param diff_dir the directory where the diff results were written
     """
+    _DieBecauseDeprecated()
     if (not render_dir_option):
         if (os.path.isdir(render_dir)):
             shutil.rmtree(render_dir)
     if (not diff_dir_option):
         if (os.path.isdir(diff_dir)):
             shutil.rmtree(diff_dir)
 
 def TestRenderSkps(inputs, expected_dir, render_dir_option, diff_dir_option,
                    render_app, render_args):
+    _DieBecauseDeprecated()
     if (render_dir_option):
         render_dir = render_dir_option
     else:
         render_dir = tempfile.mkdtemp()
 
     if (diff_dir_option):
         diff_dir = diff_dir_option
     else:
         diff_dir = tempfile.mkdtemp()
     try:    
         RenderSkps(inputs, render_dir, render_app, render_args)
         DiffRenderings(expected_dir, render_dir, diff_dir)
     finally:
         Cleanup(render_dir_option, diff_dir_option, render_dir, diff_dir)