Add script to update relevant changes to Node.js.

tools/release/update_node.py

+#!/usr/bin/env python
+# Copyright 2017 the V8 project authors. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+import argparse
+import os
+import shutil
+import subprocess
+import sys
+
+TARGET_SUBDIR = os.path.join("deps", "v8")
+
+SUB_REPOSITORIES = [ ["testing", "gtest"],
+                     ["third_party", "jinja2"],
+                     ["third_party", "markupsafe"] ]
+
+DELETE_FROM_GITIGNORE = [ "/base",
+                          "/testing/gtest" ]
+
+# Node.js requires only a single header file from gtest to build V8.
+# Both jinja2 and markupsafe are required to generate part of the inspector.
+ADD_TO_GITIGNORE = [ "/testing/gtest/*",
+                     "!/testing/gtest/include",
+                     "/testing/gtest/include/*",
+                     "!/testing/gtest/include/gtest",
+                     "/testing/gtest/include/gtest/*",
+                     "!/testing/gtest/include/gtest/gtest_prod.h",
+                     "!/third_party/jinja2",
+                     "!/third_party/markupsafe" ]
+
+def RunGclient(path):
+  assert os.path.isdir(path)
+  print ">> Running gclient sync"
+  if subprocess.call("gclient sync --nohooks", cwd=path, shell=True) != 0:

[Michael Achenbach, 2017/03/14 08:20:25]

nit: you can use a check_call to get this behavior.

[Yang, 2017/03/14 08:24:12]

Done.

+    raise Exception("'gclient sync' failed.")
+
+def UninitGit(path):
+  target = os.path.join(path, ".git")
+  if os.path.isdir(target):
+    print ">> Cleaning up %s" % path
+    shutil.rmtree(target)
+
+def UpdateTarget(repository, options):
+  source = os.path.join(options.v8_path, *repository)
+  target = os.path.join(options.node_path, TARGET_SUBDIR, *repository)
+  print ">> Updating target directory %s" % target
+  print ">>     from active branch at %s" % source
+  if not os.path.exists(target):

[Michael Achenbach, 2017/03/14 08:20:25]

just a remark - if we ever add a new folder structure with depth two, e.g.
bar/foo this will fail as it will attempt to make foo in bar and will complain
that bar doesn't exist.

[Yang, 2017/03/14 08:24:12]

os.makedirs creates folders recursively though.

[Michael Achenbach, 2017/03/14 08:37:26]

You're right! Learned something today. Then there's another method in Python
somewhere that had problems with that... maybe something in shutil...

+    os.makedirs(target)
+  # Remove possible remnants of previous incomplete runs.
+  UninitGit(target)
+
+  git_commands = [
+    "git init",                           # initialize target repo
+    "git remote add origin %s" % source,  # point to the source repo
+    "git fetch origin HEAD",              # sync to the current branch
+    "git reset --hard FETCH_HEAD",        # reset to the current branch
+    "git clean -fd"                       # delete removed files
+  ]
+  try:
+    for command in git_commands:
+      if subprocess.call(command, cwd=target, shell=True) != 0:
+        raise Exception("'%s' failed." % command)
+  except:
+    raise
+  finally:
+    UninitGit(target)
+
+def UpdateGitIgnore(options):
+  file_name = os.path.join(options.node_path, TARGET_SUBDIR, ".gitignore")
+  assert os.path.isfile(file_name)
+  print ">> Updating .gitignore with lines"
+  with open(file_name) as gitignore:
+    content = gitignore.readlines()
+  content = [x.strip() for x in content]
+  for x in DELETE_FROM_GITIGNORE:
+    if x in content:
+      print "- %s" % x
+      content.remove(x)
+  for x in ADD_TO_GITIGNORE:
+    if x not in content:
+      print "+ %s" % x
+      content.append(x)
+  content.sort(key=lambda x: x[1:] if x.startswith("!") else x)
+  with open(file_name, "w") as gitignore:
+    for x in content:
+      gitignore.write("%s\n" % x)
+
+def ParseOptions(args):
+  parser = argparse.ArgumentParser(description="Update V8 in Node.js")
+  parser.add_argument("v8_path", help="Path to V8 checkout")
+  parser.add_argument("node_path", help="Path to Node.js checkout")
+  parser.add_argument("--gclient", dest="gclient",
+                      action="store_true", help="Run gclient sync")
+  options = parser.parse_args(args)
+  assert os.path.isdir(options.v8_path)
+  options.v8_path = os.path.abspath(options.v8_path)
+  assert os.path.isdir(options.node_path)
+  options.node_path = os.path.abspath(options.node_path)
+  return options
+
+def Main(args):
+  options = ParseOptions(args)
+  if options.gclient:
+    RunGclient(options.v8_path)
+  # Update main V8 repository.
+  UpdateTarget([""], options)
+  # Patch .gitignore before updating sub-repositories.
+  UpdateGitIgnore(options)
+  for repo in SUB_REPOSITORIES:
+    UpdateTarget(repo, options)
+
+if __name__ == "__main__":
+  Main(sys.argv[1:])