pybridge-sdk-android 0.3.0__py3-none-any.whl

pybridge/__init__.py

@@ -0,0 +1,9 @@
+"""PyBridge Android Bridge Framework"""
+
+__title__ = 'pybridge'
+__version__ = '0.4.0'
+__author__ = 'thewhistledev'
+
+from .bridge import Bridge
+
+bridge = Bridge()

pybridge/android/__init__.py

@@ -0,0 +1 @@
+# Android API modules

pybridge/android/context.py

@@ -0,0 +1,4 @@
+class Context:
+
+    def available(self):
+        return False

pybridge/android/intents.py

@@ -0,0 +1,9 @@
+from pybridge.shell import Shell
+
+
+class Intents:
+
+    def open_url(self, url):
+        return Shell.exec(
+            f'am start -a android.intent.action.VIEW -d {url}'
+        )

pybridge/android/permissions.py

@@ -0,0 +1,7 @@
+class Permissions:
+
+    def check(self, permission):
+        return False
+
+    def request(self, permission):
+        return False

pybridge/backend.py

@@ -0,0 +1,13 @@
+
+from enum import Enum
+
+
+class Backend(Enum):
+
+    ROOT = "root"
+
+    SHIZUKU = "shizuku"
+
+    SHELL = "shell"
+
+    ANDROID = "android_api"

pybridge/backend_manager.py

@@ -0,0 +1,69 @@
+
+import os
+
+from .backend import Backend
+
+from .capabilities import Capabilities
+
+
+
+class BackendManager:
+
+
+    def __init__(self):
+
+        self.capabilities = Capabilities()
+
+        self.backend = self.detect()
+
+
+
+    def detect(self):
+
+        if self.root():
+
+            self.capabilities.root = True
+
+            return Backend.ROOT
+
+
+
+        if self.shizuku():
+
+            self.capabilities.shizuku = True
+
+            return Backend.SHIZUKU
+
+
+
+        return Backend.SHELL
+
+
+
+    def root(self):
+
+        return os.system(
+            "su -c id >/dev/null 2>&1"
+        ) == 0
+
+
+
+    def shizuku(self):
+
+        return os.system(
+            "which rish >/dev/null 2>&1"
+        ) == 0
+
+
+
+    def info(self):
+
+        return {
+
+            "backend":
+                self.backend.value,
+
+            "capabilities":
+                self.capabilities.as_dict()
+
+        }

pybridge/bridge.py

@@ -0,0 +1,43 @@
+from .backend_manager import BackendManager
+from .device.info import Device
+from .device.battery import Battery
+
+from .android.intents import Intents
+from .android.permissions import Permissions
+
+from .system.apps import Apps
+from .system.clipboard import Clipboard
+from .system.notifications import Notifications
+from .system.settings import Settings
+
+from .hardware.camera import Camera
+from .hardware.bluetooth import Bluetooth
+from .hardware.sensors import Sensors
+from .hardware.location import Location
+
+
+class Bridge:
+
+    def __init__(self):
+
+        self.backend = BackendManager()
+
+        self.device = Device()
+        self.battery = Battery()
+
+        self.intents = Intents()
+        self.permissions = Permissions()
+
+        self.apps = Apps()
+        self.clipboard = Clipboard()
+        self.notifications = Notifications()
+        self.settings = Settings()
+
+        self.camera = Camera()
+        self.bluetooth = Bluetooth()
+        self.sensors = Sensors()
+        self.location = Location()
+
+
+    def info(self):
+        return self.backend.info()

pybridge/capabilities.py

@@ -0,0 +1,29 @@
+
+class Capabilities:
+
+
+    def __init__(self):
+
+        self.root = False
+
+        self.shizuku = False
+
+        self.android = False
+
+        self.shell = True
+
+
+
+    def as_dict(self):
+
+        return {
+
+            "root": self.root,
+
+            "shizuku": self.shizuku,
+
+            "android": self.android,
+
+            "shell": self.shell
+
+        }

pybridge/config.py

@@ -0,0 +1,8 @@
+class Config:
+
+    def __init__(self):
+        self.backend = 'auto'
+        self.debug = False
+
+
+config = Config()

pybridge/device/battery.py

@@ -0,0 +1,25 @@
+
+from pybridge.shell import Shell
+
+
+
+class Battery:
+
+
+    @property
+    def level(self):
+
+        result = Shell.exec(
+            "dumpsys battery | grep level"
+        )
+
+
+        try:
+
+            return int(
+                result.stdout.split(":")[1]
+            )
+
+        except:
+
+            return None

pybridge/device/info.py

@@ -0,0 +1,31 @@
+
+from pybridge.shell import Shell
+
+
+
+class Device:
+
+
+    def prop(self, key):
+
+        return Shell.exec(
+            f"getprop {key}"
+        ).stdout
+
+
+
+    @property
+    def model(self):
+
+        return self.prop(
+            "ro.product.model"
+        )
+
+
+
+    @property
+    def android(self):
+
+        return self.prop(
+            "ro.build.version.release"
+        )

pybridge/exceptions.py

@@ -0,0 +1,6 @@
+class PyBridgeError(Exception):
+    pass
+
+
+class BackendError(PyBridgeError):
+    pass

pybridge/hardware/__init__.py

@@ -0,0 +1 @@
+# Hardware modules

pybridge/hardware/bluetooth.py

@@ -0,0 +1,4 @@
+class Bluetooth:
+
+    def available(self):
+        return False

pybridge/hardware/camera.py

@@ -0,0 +1,4 @@
+class Camera:
+
+    def available(self):
+        return False

pybridge/hardware/location.py

@@ -0,0 +1,4 @@
+class Location:
+
+    def available(self):
+        return False

pybridge/hardware/sensors.py

@@ -0,0 +1,4 @@
+class Sensors:
+
+    def available(self):
+        return False

pybridge/intents.py

@@ -0,0 +1,9 @@
+from pybridge.shell import Shell
+
+
+class Intent:
+
+    def open(self, url):
+        return Shell.exec(
+            f'am start -a android.intent.action.VIEW -d {url}'
+        )

pybridge/logger.py

@@ -0,0 +1,8 @@
+import logging
+
+logging.basicConfig(
+    level=logging.INFO,
+    format='[PyBridge] %(message)s'
+)
+
+logger = logging.getLogger('PyBridge')

pybridge/permissions.py

@@ -0,0 +1,9 @@
+class Permissions:
+
+    def check(self, permission):
+        return False
+
+    def request(self, permission):
+        raise NotImplementedError(
+            'Android permission bridge required'
+        )

pybridge/shell.py

@@ -0,0 +1,59 @@
+
+import subprocess
+
+
+
+class ShellResult:
+
+
+    def __init__(
+        self,
+        code,
+        stdout,
+        stderr
+    ):
+
+        self.code = code
+
+        self.stdout = stdout
+
+        self.stderr = stderr
+
+
+
+    @property
+    def success(self):
+
+        return self.code == 0
+
+
+
+
+class Shell:
+
+
+    @staticmethod
+    def exec(command):
+
+        result = subprocess.run(
+
+            command,
+
+            shell=True,
+
+            capture_output=True,
+
+            text=True
+
+        )
+
+
+        return ShellResult(
+
+            result.returncode,
+
+            result.stdout.strip(),
+
+            result.stderr.strip()
+
+        )

pybridge/shizuku/__init__.py

@@ -0,0 +1 @@
+# Shizuku backend

pybridge/shizuku/client.py

@@ -0,0 +1,13 @@
+from pybridge.shell import Shell
+
+
+class ShizukuClient:
+
+    def available(self):
+        return Shell.exec('which rish').success
+
+
+    def run(self, command):
+        return Shell.exec(
+            'rish ' + command
+        )

pybridge/shizuku/executor.py

@@ -0,0 +1,4 @@
+class ShizukuExecutor:
+
+    def execute(self, command):
+        return None

pybridge/system/__init__.py

@@ -0,0 +1 @@
+# System modules

pybridge/system/apps.py

@@ -0,0 +1,11 @@
+from pybridge.shell import Shell
+
+
+class Apps:
+
+    def list(self):
+        result = Shell.exec(
+            'pm list packages'
+        )
+
+        return result.stdout.splitlines()

pybridge/system/clipboard.py

@@ -0,0 +1,7 @@
+class Clipboard:
+
+    def copy(self, text):
+        return False
+
+    def paste(self):
+        return None

pybridge/system/notifications.py

@@ -0,0 +1,4 @@
+class Notifications:
+
+    def send(self, title, message):
+        return False

pybridge/system/packages.py

@@ -0,0 +1,14 @@
+from pybridge.shell import Shell
+
+
+class Packages:
+
+    def list(self):
+        result = Shell.exec(
+            'pm list packages'
+        )
+
+        return [
+            x.replace('package:', '')
+            for x in result.stdout.splitlines()
+        ]

pybridge/system/power.py

@@ -0,0 +1,7 @@
+from pybridge.shell import Shell
+
+
+class Power:
+
+    def reboot(self):
+        return Shell.exec('reboot')

pybridge/system/settings.py

@@ -0,0 +1,9 @@
+from pybridge.shell import Shell
+
+
+class Settings:
+
+    def get(self, name):
+        return Shell.exec(
+            f'settings get system {name}'
+        ).stdout

pybridge/version.py

@@ -0,0 +1,2 @@
+__version__ = '0.4.0'
+__author__ = 'thewhistledev'

pybridge_sdk_android-0.3.0.dist-info/METADATA

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: pybridge-sdk-android
+Version: 0.3.0
+Summary: A modular Android functionality bridge for Python
+Author: thewhistledev
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Dynamic: requires-python
+
+# PyBridge
+
+Android functionality bridge for Python.
+
+Version: 0.4.0
+
+Author: thewhistledev
+
+## Features
+
+- Backend system
+- Root support
+- Shizuku foundation
+- Android intents
+- App management
+- Clipboard foundation
+- Notifications foundation
+- Hardware API foundation
+
+## Example
+
+from pybridge import bridge
+
+bridge.intents.open_url('https://github.com')
+
+## Roadmap
+
+0.5.0:
+- Real Android API bridge
+- Camera support
+- Bluetooth support
+- Sensors
+
+1.0.0:
+Complete Android Python framework.

pybridge_sdk_android-0.3.0.dist-info/RECORD

@@ -0,0 +1,38 @@
+pybridge/__init__.py,sha256=9bsk6iY2ZrHMq5XudV9HZ0rPiP3Q1CkGFxECRPf8lx8,161
+pybridge/backend.py,sha256=BKEWrvW0UYrt5CerBt-vZ-msCXLTz-FSBMn5cXFHn84,140
+pybridge/backend_manager.py,sha256=1SYDlj6BwNzbj0FLwLunCp4uHKaNssHuK_j4blQulBw,882
+pybridge/bridge.py,sha256=f-Q_IOW_zXW5g8kofYM7Rp-zzcNauKwWu6Cw7f8B1KA,1069
+pybridge/capabilities.py,sha256=CAlEmtkXdpGUzx_DKEbpdERUKJdYt4ALP8xn6N0J5Rw,357
+pybridge/config.py,sha256=rXrZ2LxCCcCXs4S5Xe1u8CXKEAKacH3tbvlOcUEbqu4,115
+pybridge/exceptions.py,sha256=yEjPA62CWCj53XLOzvdlGI0YY5DV9Uh5o5cbyC3SyG4,86
+pybridge/intents.py,sha256=HmSXuIA1tE9AyjEP14lo9HvvPvsxv-PqSDpAYL7iv0s,174
+pybridge/logger.py,sha256=Ksgl2Kfv2hWeZyucAU8FWncW141kzmxexpvZsDBlldI,138
+pybridge/permissions.py,sha256=wEQi-DDqSnHX7XRZahBZkmqfbLt3LK_Bmwdfne-sPlU,203
+pybridge/shell.py,sha256=kijbW79tXyPRie-UbW7fWPTdjDk6480swC2Mo2CmX90,637
+pybridge/version.py,sha256=Ffqdd4x6xPFVl4qI2rtgWHcBfmm1QZbqehAEuXpkgi0,50
+pybridge/android/__init__.py,sha256=X0Srxk0fYUl8Ake0aWQRWlHULAFpGii5nyln5qjxdWU,21
+pybridge/android/context.py,sha256=auuHHIgS7X_l7ZMWRVhK_YR2G4NxyI4hf7X48i7y60g,61
+pybridge/android/intents.py,sha256=XgKMgq9V9A1SQbV2MwVIP6pMWHKwGnUUyPCxHRibiZs,179
+pybridge/android/permissions.py,sha256=_PIuneyAtCDtiib70QgcdoRl2TUMp-tSuROZHfAMzlU,130
+pybridge/device/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pybridge/device/battery.py,sha256=OEeKQv8GYwIuS3hxUxaQ-EtwV9B7sqEmFqXYnQcTok8,312
+pybridge/device/info.py,sha256=Y_ylsG90g6eRCOOrvek1G4qftS2OWArEoiSeivsz0tE,374
+pybridge/hardware/__init__.py,sha256=s5IVjCOY6RbM0wpMRBtaw78F7fxxy0_TEGHGYGwwIeE,18
+pybridge/hardware/bluetooth.py,sha256=8owhVKHbdJ9XqD_ybVaH0ozcywPFKpqRo69eeJwQqKg,63
+pybridge/hardware/camera.py,sha256=ntmyf7JW7kriyA9MJng6EKp4_wHstmT4LtZ3f8k7a9I,60
+pybridge/hardware/location.py,sha256=f5wdS6gAzF-vaOJLUC-s0-TB7VQoUkUNVhET-N0FIjs,62
+pybridge/hardware/sensors.py,sha256=k3F5S2BPnyAoeHRl0Gfd78QtYbKF82gv9d-RT_sS2Ow,61
+pybridge/shizuku/__init__.py,sha256=qqaa5ceeFn8JtH5E_ta7fNYkmAzymqJv4IWXPHMnMvs,17
+pybridge/shizuku/client.py,sha256=zOmmFcFXDV3tTSlHkbEvuwrcefg0LKFDcATlZDFjnwk,226
+pybridge/shizuku/executor.py,sha256=faQXuMeqjJ-GknoDyAQOTOVLIP_uplQ1uWGnfdhZvnw,75
+pybridge/system/__init__.py,sha256=t5n6VskkQ1PSU8N1yyxftYL1BIJImYaShU1HnIzTjpA,16
+pybridge/system/apps.py,sha256=Ed1522D8EHEDoywt5jIiHw8cyMbWHOQ3XjFEhLZOH7M,180
+pybridge/system/clipboard.py,sha256=8FIbTiMdxNgXFDcz3dwqJ8zvy5MYZbj1W_oynbW5fks,106
+pybridge/system/notifications.py,sha256=EQugCIjDrRup80eS9Ye_utwjrbx7CWH8kEGtJbdv65o,78
+pybridge/system/packages.py,sha256=DSmFVHgf-G2agC0F0zQGLBxRzO7N7fDdtL3J50SDm-c,255
+pybridge/system/power.py,sha256=RyJEh7MQsJ5CMXqwaCASdIGV9TlAl-52sazS69sgotI,106
+pybridge/system/settings.py,sha256=aiQpUra_pw-o1PpRxRiCzkJ8AlpBlIWLkclaJLDbnGE,162
+pybridge_sdk_android-0.3.0.dist-info/METADATA,sha256=XflT5r8gaYruVmq9LgADsYoFyLtV1kJDdChaVXK-jFw,741
+pybridge_sdk_android-0.3.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+pybridge_sdk_android-0.3.0.dist-info/top_level.txt,sha256=Xg6g5Bue-9WdrWfUgylpVb5JkgpSHilgAddduW6mKi4,9
+pybridge_sdk_android-0.3.0.dist-info/RECORD,,

pybridge_sdk_android-0.3.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pybridge_sdk_android-0.3.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+pybridge