mark rebaseline.py as deprecated

tools/rebaseline.py

 #!/usr/bin/python
 
 '''
 Copyright 2012 Google Inc.
 
 Use of this source code is governed by a BSD-style license that can be
 found in the LICENSE file.
 '''
 
 '''
@@ skipping 378 matching lines @@
 parser.add_argument('--builders', metavar='BUILDER', nargs='+',
                     help=('which platforms to rebaseline; '
                           'if unspecified, rebaseline all known platforms '
                           '(see below for a list)'))
 # TODO(epoger): Add test that exercises --configs argument.
 parser.add_argument('--configs', metavar='CONFIG', nargs='+',
                     help=('which configurations to rebaseline, e.g. '
                           '"--configs 565 8888", as a filter over the full set '
                           'of results in ACTUALS_FILENAME; if unspecified, '
                           'rebaseline *all* configs that are available.'))
+parser.add_argument('--deprecated', action='store_true',
+                    help=('run the tool even though it has been deprecated; '
+                          'see http://tinyurl.com/SkiaRebaselineServer for '
+                          'the recommended/supported process'))
 parser.add_argument('--expectations-filename',
                     help=('filename (under EXPECTATIONS_ROOT) to read '
                           'current expectations from, and to write new '
                           'expectations into (unless a separate '
                           'EXPECTATIONS_FILENAME_OUTPUT has been specified); '
                           'defaults to %(default)s'),
                     default='expected-results.json')
 parser.add_argument('--expectations-filename-output',
                     help=('filename (under EXPECTATIONS_ROOT) to write '
                           'updated expectations into; by default, overwrites '
@@ skipping 30 matching lines @@
                           gm_json.JSONKEY_ACTUALRESULTS_FAILUREIGNORED))
 parser.add_argument('--from-trybot', action='store_true',
                     help=('pull the actual-results.json file from the '
                           'corresponding trybot, rather than the main builder'))
 parser.add_argument('--skimage', action='store_true',
                     help=('Rebaseline skimage results instead of gm. Defaults '
                           'to False. If True, TESTS and CONFIGS are ignored, '
                           'and ACTUALS_BASE_URL and EXPECTATIONS_ROOT are set '
                           'to alternate defaults, specific to skimage.'))
 args = parser.parse_args()
+if not args.deprecated:
+  raise Exception(
+      'This tool has been deprecated; see'
+      ' http://tinyurl.com/SkiaRebaselineServer for the recommended/supported'
+      ' process, or re-run with the --deprecated option to press on.')
 exception_handler = ExceptionHandler(
     keep_going_on_failure=args.keep_going_on_failure)
 if args.builders:
   builders = args.builders
   missing_json_is_fatal = True
 else:
   builders = sorted(TEST_BUILDERS)
   missing_json_is_fatal = False
 if args.skimage:
   # Use a different default if --skimage is specified.
@@ skipping 29 matching lines @@
     except:
       exception_handler.RaiseExceptionOrContinue()
   else:
     try:
       raise _InternalException('expectations_json_file %s not found' %
                                expectations_json_file)
     except:
       exception_handler.RaiseExceptionOrContinue()
 
 exception_handler.ReportAllFailures()