xpdc 0.1.1__tar.gz → 0.1.2__tar.gz

xpdc-0.1.2/PKG-INFO

@@ -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.1 → xpdc-0.1.2}/README.md

@@ -2,8 +2,6 @@
     <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).

{xpdc-0.1.1 → xpdc-0.1.2}/pyproject.toml

@@ -1,8 +1,9 @@
 [project]
 name = "xpdc"
-version = "0.1.1"
+version = "0.1.2"
 description = "XPDC (X-Platform Device Connector) is designed to bridge the gap between devices across multiple platforms (Android, HarmonyOS, iOS)."
-requires-python = ">=3.11"
+readme = "README.md"
+requires-python = ">=3.12"
 dependencies = [
     "loguru>=0.7.3",
     "pillow>=12.1.0",

{xpdc-0.1.1 → xpdc-0.1.2}/src/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-0.1.1 → xpdc-0.1.2}/src/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-0.1.1 → xpdc-0.1.2}/src/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-0.1.1 → xpdc-0.1.2}/src/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-0.1.1 → xpdc-0.1.2}/src/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-0.1.1 → xpdc-0.1.2}/src/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/src/xpdc.egg-info/PKG-INFO

@@ -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.1/PKG-INFO

@@ -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/src/xpdc.egg-info/PKG-INFO

@@ -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