Copy the top level Android directory into trunk.

This CL is the first step in a series needed to move the
android directory into trunk. After the copy we will update
GYP and DEPS to point to the new location and only then
remove the original directory.

git-svn-id: http://skia.googlecode.com/svn/trunk@8891 2bbb7eff-a529-9590-31e7-b0007b416f81

1 files changed, 153 insertions, 0 deletions

diff --git a/platform_tools/android/bin/adb_list_devices.py b/platform_tools/android/bin/adb_list_devices.py
new file mode 100755
index 0000000000..f140484f4b
--- /dev/null
+++ b/platform_tools/android/bin/adb_list_devices.py
@@ -0,0 +1,153 @@
+#!/usr/bin/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.
+
+""" adb_list_devices: list information about attached Android devices. """
+
+
+import os
+import re
+import shlex
+import subprocess
+import sys
+
+# This file, which resides on every Android device, contains a great deal of
+# information about the device.
+INFO_FILE = '/system/build.prop'
+
+# Default set of properties to query about a device.
+DEFAULT_PROPS_TO_GET = ['ro.product.device', 'ro.build.version.release',
+                        'ro.build.type']
+
+
+def GetDeviceInfo(adb, serial, props_to_get):
+  """ Return a list of values (or "<Unknown>" if no value can be found) for the
+  given set of properties for the device with the given serial number.
+
+  adb: path to the ADB program.
+  serial: serial number of the target device.
+  props_to_get: list of strings indicating which properties to determine.
+  """
+  device_proc = subprocess.Popen([adb, '-s', serial, 'shell', 'cat',
+                                  INFO_FILE], stdout=subprocess.PIPE)
+  code = device_proc.wait()
+  if code != 0:
+    raise Exception('Could not query device with serial number %s.' % serial)
+  output = device_proc.stdout.read()
+  device_info = []
+  for prop in props_to_get:
+    # Find the property in the outputs
+    search_str = r'%s=(\S+)' % prop
+    match = re.search(search_str, output)
+    if not match:
+      value = '<Unknown>'
+    else:
+      value = match.group(1)
+    device_info.append(value)
+  return device_info
+
+
+def PrintPrettyTable(data, file=None):
+  """ Print out the given data in a nicely-spaced format. This function scans
+  the list multiple times and uses extra memory, so don't use it for big data
+  sets.
+
+  data: list of lists of strings, where each list represents a row of data.
+      This table is assumed to be rectangular; if the length of any list differs
+      some of the output may not get printed.
+  file: file-like object into which the table should be written. If none is
+      provided, the table is written to stdout.
+  """
+  if not file:
+    file = sys.stdout
+  column_widths = [0 for length in data[0]]
+  for line in data:
+    column_widths = [max(longest_len, len(prop)) for \
+                    longest_len, prop in zip(column_widths, line)]
+  for line in data:
+    for prop, width in zip(line, column_widths):
+      file.write(prop.ljust(width + 1))
+    file.write('\n')
+
+
+def FindADB(hint=None):
+  """ Attempt to find the ADB program using the following sequence of steps.
+  Returns the path to ADB if it can be found, or None otherwise.
+  1. If a hint was provided, is it a valid path to ADB?
+  2. Is ADB in PATH?
+  3. Is there an environment variable for ADB?
+  4. If the ANDROID_SDK_ROOT variable is set, try to find ADB in the SDK
+     directory.
+
+  hint: string indicating a possible path to ADB.
+  """
+  # 1. If a hint was provided, does it point to ADB?
+  if hint:
+    if os.path.basename(hint) == 'adb':
+      adb = hint
+    else:
+      adb = os.path.join(hint, 'adb')
+    if subprocess.Popen([adb, 'version'], stdout=subprocess.PIPE).wait() == 0:
+      return adb
+
+  # 2. Is 'adb' in our PATH?
+  adb = 'adb'
+  if subprocess.Popen([adb, 'version'], stdout=subprocess.PIPE).wait() == 0:
+    return adb
+
+  # 3. Is there an environment variable for ADB?
+  try:
+    adb = os.environ.get('ADB')
+    if subprocess.Popen([adb, 'version'], stdout=subprocess.PIPE).wait() == 0:
+      return adb    
+  except:
+    pass
+
+  # 4. If ANDROID_SDK_ROOT is set, try to find ADB in the SDK directory.
+  try:
+    sdk_dir = os.environ.get('ANDROID_SDK_ROOT')
+    adb = os.path.join(sdk_dir, 'platform-tools', 'adb')
+    if subprocess.Popen([adb, 'version'], stdout=subprocess.PIPE).wait() == 0:
+      return adb 
+  except:
+    pass
+  return None
+
+
+def main(argv):
+  """ Print out information about connected Android devices. By default, print
+  the serial number, status, device name, OS version, and build type of each
+  device. If any arguments are supplied on the command line, print the serial
+  number and status for each device along with values for those arguments
+  interpreted as properties.
+  """
+  if len(argv) > 1:
+    props_to_get = argv[1:]
+  else:
+    props_to_get = DEFAULT_PROPS_TO_GET
+  adb = FindADB()
+  if not adb:
+    raise Exception('Could not find ADB!')
+  proc = subprocess.Popen([adb, 'devices'], stdout=subprocess.PIPE)
+  code = proc.wait()
+  if code != 0:
+    raise Exception('Failure in ADB: could not find attached devices.')
+  header = ['Serial', 'Status']
+  header.extend(props_to_get)
+  output_lines = [header]
+  for line in proc.stdout:
+    line = line.rstrip()
+    if line != 'List of devices attached' and line != '':
+      line_list = shlex.split(line)
+      serial = line_list[0]
+      status = line_list[1]
+      device_info = [serial, status]
+      device_info.extend(GetDeviceInfo(adb, serial, props_to_get))
+      output_lines.append(device_info)
+  PrintPrettyTable(output_lines)
+
+
+if __name__ == '__main__':
+  sys.exit(main(sys.argv))
\ No newline at end of file