Output closure-compiled JavaScript files

third_party/closure_compiler/checker.py

 #!/usr/bin/python
 # Copyright 2014 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.
 
 """Runs Closure compiler on a JavaScript file to check for errors."""
 
 import argparse
 import os
 import re
 import subprocess
 import sys
 import tempfile
 
 import build.inputs
 import processor
 import error_filter
 
 
 class Checker(object):

[Dan Beam, 2015/03/07 01:55:26]

i guess i'll have to rename this to Compile eventually now that it does more
than just check ;)

   """Runs the Closure compiler on a given source file and returns the
   success/errors."""
 
   _COMMON_CLOSURE_ARGS = [
     "--accept_const_keyword",
     "--jscomp_error=accessControls",
     "--jscomp_error=ambiguousFunctionDecl",
     "--jscomp_error=checkStructDictInheritance",
     "--jscomp_error=checkTypes",
     "--jscomp_error=checkVars",
     "--jscomp_error=constantProperty",
     "--jscomp_error=deprecated",
     "--jscomp_error=externsValidation",
     "--jscomp_error=globalThis",
     "--jscomp_error=invalidCasts",
     "--jscomp_error=missingProperties",
     "--jscomp_error=missingReturn",
     "--jscomp_error=nonStandardJsDocs",
     "--jscomp_error=suspiciousCode",
     "--jscomp_error=undefinedNames",
     "--jscomp_error=undefinedVars",
     "--jscomp_error=unknownDefines",
     "--jscomp_error=uselessCode",
     "--jscomp_error=visibility",
     "--language_in=ECMASCRIPT5_STRICT",
     "--summary_detail_level=3",
+    "--compilation_level=WHITESPACE_ONLY",
+    "--source_map_format=V3",
   ]
 
   # These are the extra flags used when compiling in 'strict' mode.
   # Flags that are normally disabled are turned on for strict mode.
   _STRICT_CLOSURE_ARGS = [
     "--jscomp_error=reportUnknownTypes",
     "--jscomp_error=duplicate",
     "--jscomp_error=misplacedTypeAnnotation",
   ]
 
@@ skipping 113 matching lines @@
     errors = filter(None, errors)
     contents = "\n## ".join("\n\n".join(errors).splitlines())
     return "## %s" % contents if contents else ""
 
   def _create_temp_file(self, contents):
     with tempfile.NamedTemporaryFile(mode="wt", delete=False) as tmp_file:
       self._temp_files.append(tmp_file.name)
       tmp_file.write(contents)
     return tmp_file.name
 
-  def run_js_check(self, sources, externs=None):
+  def _run_js_check(self, sources, out_file=None, externs=None):
     if not self._check_java_path():
       return 1, ""
 
     args = ["--js=%s" % s for s in sources]
+
+    if out_file:
+      args += ["--js_output_file=%s" % out_file]
+      args += ["--create_source_map=%s.map" % out_file]
+
     if externs:
       args += ["--externs=%s" % e for e in externs]
     args_file_content = " %s" % " ".join(self._common_args() + args)
     self._debug("Args: %s" % args_file_content.strip())
 
     args_file = self._create_temp_file(args_file_content)
     self._debug("Args file: %s" % args_file)
 
     runner_args = ["--compiler-args-file=%s" % args_file]
     runner_cmd = self._run_jar(self._runner_jar, args=runner_args)
     _, stderr = runner_cmd.communicate()
 
     errors = stderr.strip().split("\n\n")
     self._debug("Summary: %s" % errors.pop())
 
     self._clean_up()
 
     return errors, stderr
 
-  def check(self, source_file, depends=None, externs=None):
+  def check(self, source_file, out_file=None, depends=None, externs=None):
     """Closure compile a file and check for errors.
 
     Args:
         source_file: A file to check.
+        out_file: A file to output results.

[Dan Beam, 2015/03/07 01:55:26]

A file where the compiled output is written to.

[Theresa, 2015/03/07 02:50:59]

Done.

         depends: Other files that would be included with a <script> earlier in
             the page.
         externs: @extern files that inform the compiler about custom globals.
 
     Returns:
         (has_errors, output) A boolean indicating if there were errors and the
             Closure compiler output (as a string).
     """
     depends = depends or []
     externs = externs or set()
@@ skipping 14 matching lines @@
 
     includes = [rel_path(f) for f in depends + [source_file]]
     contents = ['<include src="%s">' % i for i in includes]
     meta_file = self._create_temp_file("\n".join(contents))
     self._debug("Meta file: %s" % meta_file)
 
     self._processor = processor.Processor(meta_file)
     self._expanded_file = self._create_temp_file(self._processor.contents)
     self._debug("Expanded file: %s" % self._expanded_file)
 
-    errors, stderr = self.run_js_check([self._expanded_file], externs)
+    errors, stderr = self._run_js_check([self._expanded_file],
+                                        out_file=out_file, externs=externs)
 
     # Filter out false-positive promise chain errors.
     # See https://github.com/google/closure-compiler/issues/715 for details.
     errors = self._error_filter.filter(errors);
 
     output = self._format_errors(map(self._fix_up_error, errors))
     if errors:
       prefix = "\n" if output else ""
       self._error("Error in: %s%s%s" % (source_file, prefix, output))
     elif output:
@@ skipping 36 matching lines @@
                       help="Enable strict type checking")
   parser.add_argument("--success-stamp",
                       help="Timestamp file to update upon success")
 
   parser.set_defaults(single_file=True, strict=False)
   opts = parser.parse_args()
 
   depends = opts.depends or []
   externs = opts.externs or set()
 
+  if opts.out_file:
+    out_dir = os.path.dirname(opts.out_file)
+    if not os.path.exists(out_dir):
+      os.makedirs(out_dir)
+
   checker = Checker(verbose=opts.verbose, strict=opts.strict)
   if opts.single_file:
     for source in opts.sources:
       depends, externs = build.inputs.resolve_recursive_dependencies(
           source,
           depends,
           externs)
-      has_errors, _ = checker.check(source, depends=depends, externs=externs)
+      has_errors, _ = checker.check(source, out_file=opts.out_file,
+                                    depends=depends, externs=externs)
       if has_errors:
         sys.exit(1)
 
-      if opts.out_file:
-        out_dir = os.path.dirname(opts.out_file)
-        if not os.path.exists(out_dir):
-          os.makedirs(out_dir)
-        # TODO(dbeam): write compiled file to |opts.out_file|.
-        open(opts.out_file, "w").write("")
   else:
     has_errors, errors = checker.check_multiple(opts.sources)
     if has_errors:
       print errors
       sys.exit(1)
 
   if opts.success_stamp:
     with open(opts.success_stamp, 'w'):
       os.utime(opts.success_stamp, None)