Package: pure-python-adb
The package name has been renamed from ‘adb’ to ‘ppadb’From versionv0.2.1-dev, the package name has been renamed from ‘adb’ to ‘ppadb’ to avoid conflit with Googlegoogle/python-adbIntroductionThis is pure-python implementation of the ADB client.You can use it to communicate with adb server (not the adb daemon on the device/emulator).When you useadbcommandNow you can usepure-python-adbto connect to adb server as adb command lineThis package supports most of the adb command line tool’s functionality.adb devicesadb shelladb forwardadb pull/pushadb install/uninstallRequirementsPython 3.6+Installation$pipinstall-Upure-python-adbExamplesConnect to adb server and get the versionfromppadb.clientimportClientasAdbClient# Default is "127.0.0.1" and 5037client=AdbClient(host="127.0.0.1",port=5037)print(client.version())>>>39Connect to a devicefromppadb.clientimportClientasAdbClient# Default is "127.0.0.1" and 5037client=AdbClient(host="127.0.0.1",port=5037)device=client.device("emulator-5554")List all devices ( adb devices ) and install/uninstall an APK on all devicesfromppadb.clientimportClientasAdbClientapk_path="example.apk"# Default is "127.0.0.1" and 5037client=AdbClient(host="127.0.0.1",port=5037)devices=client.devices()fordeviceindevices:device.install(apk_path)# Check apk is installedfordeviceindevices:print(device.is_installed("example.package"))# Uninstallfordeviceindevices:device.uninstall("example.package")adb shellfromppadb.clientimportClientasAdbClient# Default is "127.0.0.1" and 5037client=AdbClient(host="127.0.0.1",port=5037)device=client.device("emulator-5554")device.shell("echo hello world !")defdump_logcat(connection):whileTrue:data=connection.read(1024)ifnotdata:breakprint(data.decode('utf-8'))connection.close()fromppadb.clientimportClientasAdbClient# Default is "127.0.0.1" and 5037client=AdbClient(host="127.0.0.1",port=5037)device=client.device("emulator-5554")device.shell("logcat",handler=dump_logcat)read logcat line by linefromppadb.clientimportClientdefdump_logcat_by_line(connect):file_obj=connect.socket.makefile()forindexinrange(0,10):print("Line{}:{}".format(index,file_obj.readline().strip()))file_obj.close()connect.close()client=Client()device=client.device("emulator-5554")device.shell("logcat",handler=dump_logcat_by_line)Screenshotfromppadb.clientimportClientasAdbClientclient=AdbClient(host="127.0.0.1",port=5037)device=client.device("emulator-5554")result=device.screencap()withopen("screen.png","wb")asfp:fp.write(result)Push file or folderfromppadb.clientimportClientasAdbClientclient=AdbClient(host="127.0.0.1",port=5037)device=client.device("emulator-5554")device.push("example.apk","/sdcard/example.apk")Pullfromppadb.clientimportClientasAdbClientclient=AdbClient(host="127.0.0.1",port=5037)device=client.device("emulator-5554")device.shell("screencap -p /sdcard/screen.png")device.pull("/sdcard/screen.png","screen.png")Connect to devicefromppadb.clientimportClientasAdbClientclient=AdbClient(host="127.0.0.1",port=5037)client.remote_connect("172.20.0.1",5555)device=client.device("172.20.0.1:5555")# Disconnect all devicesclient.remote_disconnect()##Disconnect 172.20.0.1# client.remote_disconnect("172.20.0.1")##Or# client.remote_disconnect("172.20.0.1", 5555)Enable debug loggerlogging.getLogger("ppadb").setLevel(logging.DEBUG)Async Clientimportasyncioimportaiofilesfromppadb.client_asyncimportClientAsyncasAdbClientasyncdef_save_screenshot(device):result=awaitdevice.screencap()file_name=f"{device.serial}.png"asyncwithaiofiles.open(f"{file_name}",mode='wb')asf:awaitf.write(result)returnfile_nameasyncdefmain():client=AdbClient(host="127.0.0.1",port=5037)devices=awaitclient.devices()fordeviceindevices:print(device.serial)result=awaitasyncio.gather(*[_save_screenshot(device)fordeviceindevices])print(result)asyncio.run(main())How to run test casesPrepareInstall DockerInstall Docker Composepip install docker-composeModifytest/conftest.pyChange the value ofadb_hostto the “emulator”adb_host="emulator"Run testcasesdocker-compose upResultStarting purepythonadb_emulator_1 ... done
Recreating purepythonadb_python_environment_1 ... done
Attaching to purepythonadb_emulator_1, purepythonadb_python_environment_1
emulator_1            | + echo n
emulator_1            | + /home/user/android-sdk-linux/tools/bin/avdmanager create avd -k system-images;android-25;google_apis;x86 -n Docker -b x86 -g google_apis --device 8 --force
Parsing /home/user/android-sdk-linux/emulator/package.xmlParsing /home/user/android-sdk-linux/patcher/v4/package.xmlParsing /home/user/android-sdk-linux/platform-tools/package.xmlParsing /home/user/android-sdk-linux/platforms/android-25/package.xmlParsing /home/user/android-sdk-linux/system-images/android-25/google_apis/x86/package.xmlParsing /home/user/android-sdk-linux/tools/package.xml+ echo hw.keyboard = true
emulator_1            | + adb start-server
emulator_1            | * daemon not running; starting now at tcp:5037
python_environment_1  | ============================= test session starts ==============================
python_environment_1  | platform linux -- Python 3.6.1, pytest-3.6.3, py-1.5.4, pluggy-0.6.0
python_environment_1  | rootdir: /code, inifile:
python_environment_1  | collected 27 items
python_environment_1  |
emulator_1            | * daemon started successfully
emulator_1            | + exec /usr/bin/supervisord
emulator_1            | /usr/lib/python2.7/dist-packages/supervisor/options.py:298: UserWarning: Supervisord is running as root and it is searching for its configuration file in default locations (including its current working directory); you probably want to specify a "-c" argument specifying an absolute path to a configuration file for improved security.
emulator_1            |   'Supervisord is running as root and it is searching '
emulator_1            | 2018-07-07 17:19:47,560 CRIT Supervisor running as root (no user in config file)
emulator_1            | 2018-07-07 17:19:47,560 INFO Included extra file "/etc/supervisor/conf.d/supervisord.conf" during parsing
emulator_1            | 2018-07-07 17:19:47,570 INFO RPC interface 'supervisor' initialized
emulator_1            | 2018-07-07 17:19:47,570 CRIT Server 'unix_http_server' running without any HTTP authentication checking
emulator_1            | 2018-07-07 17:19:47,570 INFO supervisord started with pid 1
emulator_1            | 2018-07-07 17:19:48,573 INFO spawned: 'socat-5554' with pid 74
emulator_1            | 2018-07-07 17:19:48,574 INFO spawned: 'socat-5555' with pid 75
emulator_1            | 2018-07-07 17:19:48,576 INFO spawned: 'socat-5037' with pid 76
emulator_1            | 2018-07-07 17:19:48,578 INFO spawned: 'novnc' with pid 77
emulator_1            | 2018-07-07 17:19:48,579 INFO spawned: 'socat-9008' with pid 78
emulator_1            | 2018-07-07 17:19:48,582 INFO spawned: 'emulator' with pid 80
emulator_1            | 2018-07-07 17:19:49,607 INFO success: socat-5554 entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)
emulator_1            | 2018-07-07 17:19:49,607 INFO success: socat-5555 entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)
emulator_1            | 2018-07-07 17:19:49,607 INFO success: socat-5037 entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)
emulator_1            | 2018-07-07 17:19:49,607 INFO success: novnc entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)
emulator_1            | 2018-07-07 17:19:49,608 INFO success: socat-9008 entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)
emulator_1            | 2018-07-07 17:19:49,608 INFO success: emulator entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)
python_environment_1  | test/test_device.py ..............                                       [ 51%]
python_environment_1  | test/test_host.py ..                                                     [ 59%]
python_environment_1  | test/test_host_serial.py ........                                        [ 88%]
python_environment_1  | test/test_plugins.py ...                                                 [100%]
python_environment_1  |
python_environment_1  | ------------------ generated xml file: /code/test_result.xml -------------------
python_environment_1  | ========================= 27 passed in 119.15 seconds ==========================
purepythonadb_python_environment_1 exited with code 0
Aborting on container exit...
Stopping purepythonadb_emulator_1 ... doneMore InformationA pure Node.js client for the Android Debug BridgeadbkitADB documentsprotocolservicessync0.2.1 (2019-10-14)Fixes #21: Rename the package name from “adb” to “ppadb”Fixes #23: Support push dir to deviceFixes #25: Don’t call logging.basicConfig() in the module0.1.6 (2019-01-21)Fix #4 push does not preserve original timestap unlike equiv adb push from command lineFix #6 forward_list should also check serialFix #8: adb/command/host/__init__.py can take an exception parsing “devices” data0.1.0 (2018-06-23)First release on PyPI.