adbserver

This module includes AdbServer class used for adb server operations.

class simpleadb.adbserver.AdbServer(port: Optional[int] = None, **kwargs)

AdbServer in a class representation for adb server operations.

Parameters: port (Optional[int]) – Port, default is 5555.
Keyword Arguments: path (str) – Adb binary path.
Example

>>> import simpleadb
>>> device = simpleadb.AdbServer(5555)
>>> device = simpleadb.AdbDevice(5555, path='/usr/bin/adb')

connect(address, port: Optional[Union[int, str]] = 5555) → None

Connect a device via TCP/IP.

Parameters

address (str) – Host address.
(Optional[Union[int,str]]) (port) – Port, default 5555.

Raises

CalledProcessError – When failed.

Example

>>> import simpleadb
>>> adb_server = simpleadb.AdbServer(5555)
>>> adb_server.connect('192.168.42.42', 5555)

devices() → List[str]

Get list connected adb devices.

Raise: AdbCommandError: When failed.
Returns: List of connected devices serial numbers.
Return type: List[str]
Example

>>> import simpleadb
>>> adb_server = simpleadb.AdbServer(5555)
>>> adb_server.devices()
['emulator-5554']

disconnect(address, port: Optional[Union[int, str]] = None) → None

Disconnect from given TCP/IP device.

Parameters

str (address) – Host address.
port]) ((Optional[Union[int, str]) – Port.

Raise

AdbCommandError: When failed.

Example

>>> import simpleadb
>>> adb_server = simpleadb.AdbServer(5555)
>>> adb_server.connect('192.168.42.42', 5555)
>>> adb_server.disconnect('192.168.42.42')

kill() → int

Kill the server if it is running.

Raise: AdbCommandError: When failed.
Example

>>> import simpleadb
>>> adb_server = simpleadb.AdbServer(5555)
>>> adb_server.kill()

start(port: Optional[Union[int, str]] = None) → None

Start adb and ensure that there is running.

Parameters

str (address) – Host address.
port]) ((Optional[Union[int, str]) – Port, default adb server port.

Raise

AdbCommandError: When failed.

Example

>>> import simpleadb
>>> adb_server = simpleadb.AdbServer(5555)
>>> adb_server.start()
>>> adb_server.start(5037)