adbpy

Python implementation of the Android Debug Bridge (ADB) protocol using libusb and asyncio.

Status

Deprecated

This package has been deprecated in favor the adbpy organization.

Goals

• Provide a mostly pure python implementation of the ADB protocol.
• Communicate directly to adbd running on a device/emulator without the requirements of adb server running on the host.
• Support synchronous and asynchronous (asyncio) APIs.
• Handle command/connection/communication multiplexing, so a caller can run background calls (stream logcat output) while executing other commands.

Installation

To install adbpy from pip:

    $ pip install adbpy

To install adbpy from source:

    $ git clone git@github.com:ahawker/adbpy.git
    $ cd adbpy
    $ python setup.py install

API - TBD

What _should_ the API look like?

# Synchronous Interface
from adb import Device

devices = Device.devices()
[('DEVICE, '12393012'), ('EMULATOR', '???'), ('127.0.0.1', '44444')]

device = Device.from_serial('0123456789ABCDEF')
device = Device.from_tcp('127.0.0.1', 5555)

# ADB Interface
device.adb.push(...)
device.adb.pull(...)

device.adb.sync(...)

device.adb.shell(...)  # Interactive?

device.adb.shell(...)  # Command
device.adb.shell.{command}(...)

# Logcat needs to support both command & interactive...
device.adb.logcat(...)

device.adb.forward(...)
device.adb.forward.remove(...)


# Asynchronous Interface
from adb.aio import AsyncDevice

devices = yield from AsyncDevice.devices()

device = yield from AsyncDevice.from_serial('0123456789ABCDEF')
device = yield from AsyncDevice.from_tcp('127.0.0.1', 5555)_
_

License

Apache 2.0