droidline 0.1.2__tar.gz

droidline-0.1.2/.gitignore

@@ -0,0 +1,6 @@
+__pycache__/
+.pytest_cache/
+.mypy_cache/
+build/
+dist/
+*.egg-info/

droidline-0.1.2/PKG-INFO

@@ -0,0 +1,59 @@
+Metadata-Version: 2.5
+Name: droidline
+Version: 0.1.2
+Summary: Control Android phones from Python without ADB or root: find elements, tap, type, take screenshots and read notifications.
+Project-URL: Homepage, https://droidline.dev
+Project-URL: Documentation, https://droidline.dev/docs
+Project-URL: Repository, https://github.com/KnifeLemon/Droidline
+Project-URL: Issues, https://github.com/KnifeLemon/Droidline/issues
+Project-URL: Changelog, https://github.com/KnifeLemon/Droidline/blob/main/CHANGELOG.md
+Author: Droidline contributors
+License-Expression: MIT
+Keywords: accessibility,adb,android,android-automation,appium,device-farm,droidline,mcp,mobile-automation,pytest,rpa,test-automation,testing,ui-automation,uiautomator
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Pytest
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Software Development :: Testing :: Acceptance
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# droidline
+
+Python SDK for [Droidline](https://droidline.dev). Control Android phones from your code with one-line commands, without ADB.
+
+The SDK talks to the Droidline server on your PC (`droidline serve`, port 8780). The server and the phone do the waiting, retries and fallbacks; this package sends commands and turns errors into exceptions. Python 3.9+, no dependencies.
+
+## Install
+
+```sh
+pip install droidline
+```
+
+## Example
+
+```python
+from droidline import connect
+
+d = connect()
+d.launch("com.kakao.talk")
+d.dump("screen.json")
+d.touchById("com.kakao.talk:id/login")
+d.input("id", "com.kakao.talk:id/email", "knife")
+d.sendkey("enter")
+if d.exists("text", "광고 닫기"):
+    d.touch("text", "광고 닫기")
+d.intent("android.settings.WIFI_SETTINGS")    # open a Settings page by its intent action
+d.wait_idle()
+```
+
+`connect()` uses the only online phone. With several, pass an ID or name: `connect("shelf-01")`, or use `Droidline().device("shelf-01")` for each. `DROIDLINE_HOST`, `DROIDLINE_PORT`, `DROIDLINE_TOKEN` and `DROIDLINE_DEVICE` set the defaults.
+
+A failed command raises a subclass of `DroidlineError`, such as `NotFoundError`, with `code`, `retryable` and the server's extra fields in `data`.
+
+Docs: https://droidline.dev/docs

droidline-0.1.2/README.md

@@ -0,0 +1,34 @@
+# droidline
+
+Python SDK for [Droidline](https://droidline.dev). Control Android phones from your code with one-line commands, without ADB.
+
+The SDK talks to the Droidline server on your PC (`droidline serve`, port 8780). The server and the phone do the waiting, retries and fallbacks; this package sends commands and turns errors into exceptions. Python 3.9+, no dependencies.
+
+## Install
+
+```sh
+pip install droidline
+```
+
+## Example
+
+```python
+from droidline import connect
+
+d = connect()
+d.launch("com.kakao.talk")
+d.dump("screen.json")
+d.touchById("com.kakao.talk:id/login")
+d.input("id", "com.kakao.talk:id/email", "knife")
+d.sendkey("enter")
+if d.exists("text", "광고 닫기"):
+    d.touch("text", "광고 닫기")
+d.intent("android.settings.WIFI_SETTINGS")    # open a Settings page by its intent action
+d.wait_idle()
+```
+
+`connect()` uses the only online phone. With several, pass an ID or name: `connect("shelf-01")`, or use `Droidline().device("shelf-01")` for each. `DROIDLINE_HOST`, `DROIDLINE_PORT`, `DROIDLINE_TOKEN` and `DROIDLINE_DEVICE` set the defaults.
+
+A failed command raises a subclass of `DroidlineError`, such as `NotFoundError`, with `code`, `retryable` and the server's extra fields in `data`.
+
+Docs: https://droidline.dev/docs

droidline-0.1.2/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["hatchling>=1.26"]
+build-backend = "hatchling.build"
+
+[project]
+name = "droidline"
+version = "0.1.2"
+description = "Control Android phones from Python without ADB or root: find elements, tap, type, take screenshots and read notifications."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [{ name = "Droidline contributors" }]
+keywords = [
+    "android", "android-automation", "mobile-automation", "ui-automation", "test-automation", "testing",
+    "appium", "uiautomator", "adb", "accessibility", "rpa", "device-farm", "mcp", "pytest", "droidline",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Framework :: Pytest",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Software Development :: Testing",
+    "Topic :: Software Development :: Testing :: Acceptance",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://droidline.dev"
+Documentation = "https://droidline.dev/docs"
+Repository = "https://github.com/KnifeLemon/Droidline"
+Issues = "https://github.com/KnifeLemon/Droidline/issues"
+Changelog = "https://github.com/KnifeLemon/Droidline/blob/main/CHANGELOG.md"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/droidline"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src", "tests"]
+testpaths = ["tests"]

droidline-0.1.2/src/droidline/__init__.py

@@ -0,0 +1,30 @@
+"""Control Android phones through a local Droidline server, without ADB.
+
+    from droidline import connect
+
+    d = connect()
+    d.touch("id", "com.kakao.talk:id/login")
+
+Docs: https://droidline.dev/docs
+"""
+
+from . import _generated
+from ._client import Device, Droidline, LeasedDevice, connect, lease
+from ._element import Element
+from ._errors import ConnectionLostError, DroidlineError, ServerNotRunningError
+from ._generated import *  # noqa: F401,F403
+
+__version__ = "0.1.2"
+
+__all__ = [
+    "connect",
+    "lease",
+    "Droidline",
+    "Device",
+    "LeasedDevice",
+    "Element",
+    "DroidlineError",
+    "ServerNotRunningError",
+    "ConnectionLostError",
+]
+__all__ += _generated.__all__