blob: f140484f4b6d0c7e1210ea315045262f4535e0c2 [file] [log] [blame]
# 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', '',
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_info = []
for prop in props_to_get:
# Find the property in the outputs
search_str = r'%s=(\S+)' % prop
match =, output)
if not match:
value = '<Unknown>'
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
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))
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
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
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?
adb = os.environ.get('ADB')
if subprocess.Popen([adb, 'version'], stdout=subprocess.PIPE).wait() == 0:
return adb
# 4. If ANDROID_SDK_ROOT is set, try to find ADB in the SDK directory.
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
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:]
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']
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))
if __name__ == '__main__':