xpdc 0.1.1__py3-none-any.whl → 0.1.2__py3-none-any.whl

xpdc/_base/device.py

@@ -41,6 +41,10 @@ class DeviceBase(ABC):
     def launch_app(self, bundle: str, ability: str) -> str:
         pass
 
+    @abstractmethod
+    def stop_app(self, bundle: str) -> str:
+        pass
+
     @abstractmethod
     def type_text(self, text: str) -> str:
         pass
@@ -56,3 +60,19 @@ class DeviceBase(ABC):
     @abstractmethod
     def get_current_app(self) -> str:
         pass
+
+    @abstractmethod
+    def dump_bundles(self) -> str:
+        pass
+
+    @abstractmethod
+    def dump_bundle(self, bundle: str, *, shortcut: bool = False) -> str:
+        pass
+
+    @abstractmethod
+    def clean_cache(self, bundle: str) -> str:
+        pass
+
+    @abstractmethod
+    def clean_data(self, bundle: str) -> str:
+        pass

xpdc/adb/connection.py

@@ -38,5 +38,5 @@ class ADBConnection(ConnectionBase):
 
         return devices
 
-    def device(self, device_id: str = None) -> 'ADBDevice':
+    def device(self, device_id: str) -> 'ADBDevice':
         return ADBDevice(device_id=device_id, adb=self._adb)

xpdc/adb/device.py

@@ -52,6 +52,9 @@ class ADBDevice(DeviceBase):
     def launch_app(self, bundle: str, ability: str = None) -> str:
         return self.shell(['monkey', '-p', bundle, '-c', 'android.intent.category.LAUNCHER', '1'])
 
+    def stop_app(self, bundle: str) -> str:
+        return self.shell(['am', 'force-stop', bundle])
+
     def type_text(self, text: str) -> str:
         encoded_text = base64.b64encode(text.encode('utf-8')).decode('utf-8')
 
@@ -84,13 +87,11 @@ class ADBDevice(DeviceBase):
     def screenshot(self, path: Path = None) -> Screenshot:
         path = path or Path(f'adb-{self.device_id}-{now_str()}.png')
 
+        cmd = [self._adb, '-s', self.device_id, 'shell', 'screencap', '-p']
+        logger.debug(f'Executing command: {cmd}')
+
         with open(path, 'wb') as f:
-            subprocess.run(  # noqa: S603
-                [self._adb, '-s', self.device_id, 'shell', 'screencap', '-p'],
-                stdout=f,
-                check=True,
-                timeout=30,
-            )
+            subprocess.run(cmd, stdout=f, check=True, timeout=30)  # noqa: S603
 
         return Screenshot(path)
 
@@ -104,3 +105,17 @@ class ADBDevice(DeviceBase):
             return m['bundle']
 
         return ''
+
+    def dump_bundles(self) -> str:
+        return self.shell(['pm', 'list', 'packages'])
+
+    def dump_bundle(self, bundle: str, *, shortcut: bool = False) -> str:
+        cmd = ['dumpsys', 'package', '--checkin', bundle] if shortcut else ['dumpsys', 'package', bundle]
+
+        return self.shell(cmd)
+
+    def clean_cache(self, bundle: str) -> str:
+        return self.shell(['pm', 'clear', '--cache-only', bundle])
+
+    def clean_data(self, bundle: str) -> str:
+        return self.shell(['pm', 'clear', bundle])

xpdc/hdc/connection.py

@@ -31,7 +31,7 @@ class HDCConnection(ConnectionBase):
         devices = []
 
         for line in out.split('\n'):
-            if not line.strip():
+            if not line.strip() or line.strip() == '[Empty]':
                 continue
 
             devices.append(HDCDevice(device_id=line.split()[0], hdc=self._hdc))

xpdc/hdc/device.py

@@ -47,6 +47,9 @@ class HDCDevice(DeviceBase):
     def launch_app(self, bundle: str, ability: str = 'EntryAbility') -> str:
         return self.shell(['aa', 'start', '-b', bundle, '-a', ability])
 
+    def stop_app(self, bundle: str) -> str:
+        return self.shell(['aa', 'force-stop', bundle])
+
     def type_text(self, text: str) -> str:
         return self.shell(['uitest', 'uiInput', 'text', text])
 
@@ -84,3 +87,19 @@ class HDCDevice(DeviceBase):
                 current_bundle = None
 
         return foreground_bundle or ''
+
+    def dump_bundles(self) -> str:
+        return self.shell(['bm', 'dump', '-a'])
+
+    def dump_bundle(self, bundle: str, *, shortcut: bool = False) -> str:
+        cmd = ['bm', 'dump', '-n', bundle]
+        if shortcut:
+            cmd.append('-s')
+
+        return self.shell(cmd)
+
+    def clean_cache(self, bundle: str) -> str:
+        return self.shell(['bm', 'clean', '-c', '-n', bundle])
+
+    def clean_data(self, bundle: str) -> str:
+        return self.shell(['bm', 'clean', '-d', '-n', bundle])

xpdc/screenshot.py

@@ -6,8 +6,7 @@ from PIL import Image
 from PIL.ImageFile import ImageFile
 
 
-# https://lanbaoshen.github.io/blog/2025/10/13/subclassing-of-pathlibpath/#solution
-class Screenshot(type(Path()), Path):
+class Screenshot(Path):
     def __init__(self, *args):
         super().__init__(*args)
 

xpdc-0.1.2.dist-info/METADATA

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: xpdc
+Version: 0.1.2
+Summary: XPDC (X-Platform Device Connector) is designed to bridge the gap between devices across multiple platforms (Android, HarmonyOS, iOS).
+Author-email: lanbaoshen <lanbaoshen@icloud.com>
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: pillow>=12.1.0
+Dynamic: license-file
+
+<p align="center">
+    <img src="logo.png" alt="pyecharts logo" width=200 />
+</p>
+
+# Introduction
+
+XPDC (X-Platform Device Connector) is designed to bridge the gap between devices across multiple platforms (Android, HarmonyOS, iOS).
+
+It allows users to operate devices on different platforms with the same set of code.
+
+**Before using XPDC, you need to install the corresponding debug environment separately for each platform's device.**
+
+Android is `adb`, HarmonyOS is `hdc`
+
+# Installation
+
+```shell
+# Using uv
+pip install uv
+uv add xpdc
+
+# Using pip
+pip install xpdc
+```
+
+# Quick Start
+
+## Install Dependencies
+
+```python
+from xpdc import connection, DeviceType
+
+# Specify connect device type
+conn = connection(DeviceType.ADB)
+# conn = connection(DeviceType.HDC)
+# iOS will support it in the future.
+
+conn.cmd(['devices'])
+
+device = conn.devices[0]
+# You can also specify the device by its device id
+# device = conn.device(device_id='device_id')
+
+device.tap(500, 500)
+device.type_text(text='lanbaoshen')
+device.screenshot()
+device.cmd(cmd=['shell', 'ls'])
+device.shell(cmd=['ls'])
+
+# For Android devices, additionally install ADBKeyboard.apk and enable it to support Chinese input.
+device.install_and_set_adb_keyboard()
+```

xpdc-0.1.2.dist-info/RECORD

@@ -0,0 +1,18 @@
+xpdc/__init__.py,sha256=n3sAVfyh4Zo9O4TA3hrrtWmq26hEUAV_6xjI_fs5O7Y,477
+xpdc/screenshot.py,sha256=sZ6_zm2fAtz5hOngarv66VQsKuTop4pHuVOzDD7puEA,674
+xpdc/utils.py,sha256=7qBcoxMRnvK5SvGeWK0fbVP1zhw53X0SNJwxNIcUUiQ,1635
+xpdc/_base/__init__.py,sha256=PLNJFgzcMgKcgPLp1sg-D00DN51kq9PHbFpABER6k_E,114
+xpdc/_base/connection.py,sha256=Ck-PN9GsvyI1UqjL53aiEhog0kKmxHOloe_uKmkb6Hk,375
+xpdc/_base/device.py,sha256=lgnHDtoxz_SdARz1QVcuATNiBtPmqlvctCPBfbgunHQ,1676
+xpdc/adb/__init__.py,sha256=8Jxa4VCB5y7wRQ7wFvF3Uri4xfKN_sjukLtWi1nLdoY,67
+xpdc/adb/connection.py,sha256=Pj-REYcP7hCScHqnvbmPtYG73Uxd1q2zbDWtt0bI46Y,1196
+xpdc/adb/device.py,sha256=aqOPPdoxD_Om6AJtseyN-EVh9FC3QQqSVjhWl5e9klo,4651
+xpdc/hdc/__init__.py,sha256=06bkaAgl_nfc9rBS3h68BtAFx_jatEXnYQ4Xx4PLc-A,67
+xpdc/hdc/connection.py,sha256=umrEUPJQZpoacprvjITdaPGinPXLx403s3F5IDQLPUA,1188
+xpdc/hdc/device.py,sha256=IAdYqP7BJlMzjp4jy39CBn8-EdS0B3I-j2RG6nOFFHU,3757
+xpdc/resource/__init__.py,sha256=-Le9f22S3-Y74Z2uZfuYE4rcja3F0bjWyzK_y1cB_aU,102
+xpdc-0.1.2.dist-info/licenses/LICENSE,sha256=hYRaJ2ed2IMo9RmO96UxUSTt9iwL49leBY5kVtDymRo,1063
+xpdc-0.1.2.dist-info/METADATA,sha256=ymDTkmglIFxNltIz8QHOeSxwQn8NxcCrFY-lwqAsCUg,1635
+xpdc-0.1.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+xpdc-0.1.2.dist-info/top_level.txt,sha256=qL-jSSwHZ5jrk_TEAvaHIX5_ienD6wrJfsCZDZ86Ji4,5
+xpdc-0.1.2.dist-info/RECORD,,

xpdc-0.1.1.dist-info/METADATA

@@ -1,10 +0,0 @@
-Metadata-Version: 2.4
-Name: xpdc
-Version: 0.1.1
-Summary: XPDC (X-Platform Device Connector) is designed to bridge the gap between devices across multiple platforms (Android, HarmonyOS, iOS).
-Author-email: lanbaoshen <lanbaoshen@icloud.com>
-Requires-Python: >=3.11
-License-File: LICENSE
-Requires-Dist: loguru>=0.7.3
-Requires-Dist: pillow>=12.1.0
-Dynamic: license-file

xpdc-0.1.1.dist-info/RECORD

@@ -1,18 +0,0 @@
-xpdc/__init__.py,sha256=n3sAVfyh4Zo9O4TA3hrrtWmq26hEUAV_6xjI_fs5O7Y,477
-xpdc/screenshot.py,sha256=5TMQkGwHMsZDD-dN1CxDnH4qu63sbKRMEa3Ri6QeuS8,772
-xpdc/utils.py,sha256=7qBcoxMRnvK5SvGeWK0fbVP1zhw53X0SNJwxNIcUUiQ,1635
-xpdc/_base/__init__.py,sha256=PLNJFgzcMgKcgPLp1sg-D00DN51kq9PHbFpABER6k_E,114
-xpdc/_base/connection.py,sha256=Ck-PN9GsvyI1UqjL53aiEhog0kKmxHOloe_uKmkb6Hk,375
-xpdc/_base/device.py,sha256=6GMNrVYcM7E2h-PK9nUEWerDbMA2VsMPS4nJuQHKiIg,1260
-xpdc/adb/__init__.py,sha256=8Jxa4VCB5y7wRQ7wFvF3Uri4xfKN_sjukLtWi1nLdoY,67
-xpdc/adb/connection.py,sha256=Foyy6QFStJu3CagdhJKUBHFJE4CCEL9PLAAwK6bdIH0,1203
-xpdc/adb/device.py,sha256=UrD-5s3pKRICr2yQQgnqurimp08kR0W1hDDCUhMDxbI,4044
-xpdc/hdc/__init__.py,sha256=06bkaAgl_nfc9rBS3h68BtAFx_jatEXnYQ4Xx4PLc-A,67
-xpdc/hdc/connection.py,sha256=6ME28WwXr__k3JzbcQrKEs9--O98Mj6Qy81T7JW0iSs,1159
-xpdc/hdc/device.py,sha256=YEK0RtSEGCHqyNd8BjF9ebjUCLeDA30XiLVDKsUKPPQ,3151
-xpdc/resource/__init__.py,sha256=-Le9f22S3-Y74Z2uZfuYE4rcja3F0bjWyzK_y1cB_aU,102
-xpdc-0.1.1.dist-info/licenses/LICENSE,sha256=hYRaJ2ed2IMo9RmO96UxUSTt9iwL49leBY5kVtDymRo,1063
-xpdc-0.1.1.dist-info/METADATA,sha256=mArjTuHmI6xV9lvI58h-0KR9SZs_nDfKfB31ZIP3MMY,367
-xpdc-0.1.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-xpdc-0.1.1.dist-info/top_level.txt,sha256=qL-jSSwHZ5jrk_TEAvaHIX5_ienD6wrJfsCZDZ86Ji4,5
-xpdc-0.1.1.dist-info/RECORD,,