lamda 7.73__tar.gz → 7.76__tar.gz

{lamda-7.73 → lamda-7.76}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lamda
-Version: 7.73
+Version: 7.76
 Summary: Android reverse engineering & automation framework (Client API)
 Home-page: https://github.com/firerpa/lamda
 Author: rev1si0n
@@ -12,10 +12,10 @@ Classifier: Intended Audience :: Science/Research
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: Android
 Classifier: Topic :: Security
-Requires-Python: >=3.6,<=3.12
-Requires-Dist: grpcio-tools<1.60.0,>=1.35.0
-Requires-Dist: grpc-interceptor<=0.15.2,>=0.13.0
-Requires-Dist: grpcio<1.60.0,>=1.35.0
+Requires-Python: >=3.6,<3.13
+Requires-Dist: grpcio-tools<=1.68.0,>=1.35.0
+Requires-Dist: grpc-interceptor<=0.15.4,>=0.13.0
+Requires-Dist: grpcio<=1.68.0,>=1.35.0
 Requires-Dist: cryptography>=35.0.0
 Requires-Dist: msgpack>=1.0.0
 Requires-Dist: asn1crypto<2,>=1.0.0

{lamda-7.73 → lamda-7.76}/README.md

@@ -12,11 +12,11 @@
 <img src="https://img.shields.io/github/v/release/rev1si0n/lamda" />
 </p>
 
-<p align="center"><a href="https://github.com/rev1si0n/lamda/wiki">使用文档</a> | <a href="https://t.me/lamda_dev">TELEGRAM</a> | <a href="https://lamda.run/join/qq">QQ 群组</a> | <a href="https://github.com/rev1si0n/lamda/blob/HEAD/CHANGELOG.txt">更新历史</a></p>
+<p align="center"><a href="https://device-farm.com/doc/index.html">使用文档</a> | <a href="https://t.me/lamda_dev">TELEGRAM</a> | <a href="https://lamda.run/join/qq">QQ 群组</a> | <a href="https://github.com/rev1si0n/lamda/blob/HEAD/CHANGELOG.txt">更新历史</a></p>
 
 智能机的崛起，传统网页端的普及度也开始显著减弱，数据与应用正加速向移动端转移。越来越多的人选择通过智能手机和平板等移动设备来获取信息和服务。随着移动设备的普及，用户享受到更便捷、更即时的访问体验，传统的网页内容消费模式面临重新审视。与此同时，数据采集的技术也亟需适应这一趋势。过去，许多数据采集工具专注于网页内容，但在移动端环境中，尤其是在移动端封闭的黑盒中，现今的常规采集技术也面临着新的挑战。LAMDA 的诞生，为这一切创造了可能。
 
-LAMDA 是一个**安卓领域的集大成者框架**，设计为减少**安全分析**及**应用测试**工作的时间和琐碎问题，为**移动端RPA数据采集**提供稳定的解决方案，以**编程化**的**接口**替代大量手动操作，**易部署**，没有那些复杂花哨不跨平台的安装流程，你所需要的能力他大概率能做到并且做的更好。他并不是一个单一功能的框架，他是集 Appium、uiautomator **自动化**的超集同时具备**逆向**领域如 **Hook** **抓包** **证书安装** **组网** **API跟踪** **手机自控** 等等各种能力的框架。为了让你大概了解它的用处：你是否会在手机上安装各类代理、插件或者点来点去的设置来完成你的工作？你是否要在异地操作远在千里之外的手机？你是否有编程控制手机的需求？是否还在某些云手机厂商那里购买昂贵的 **IP切换**、**远程ADB调试**、**RPA自动化**甚至连 **logcat 日志** 都要付费的服务？如果有，那么对了，只需一个 LAMDA 即可解决所有问题。并且，他更注重**分布式**，事实上，你可以在一台公网服务器上管理散布在世界各地各种网络环境中的设备。当然，LAMDA 可以做到的远不止于此，你可以阅读使用文档尽情探索他的所有能力。
+LAMDA 是一个**安卓领域的集大成者**，设计为减少**安全分析**及**应用测试**工作的时间和琐碎问题，为**移动端RPA数据采集**提供稳定的解决方案，以**编程化**的**接口**替代大量手动操作，**易部署**，没有那些复杂花哨不跨平台的安装流程，你所需要的能力他大概率能做到并且做的更好。他并不是一个单一功能的框架，他是集 Appium、uiautomator **自动化**的超集同时具备**逆向**领域如 **Hook** **抓包** **证书安装** **组网** **API跟踪** **手机自控** 等等各种能力的框架。为了让你大概了解它的用处：你是否会在手机上安装各类代理、插件或者点来点去的设置来完成你的工作？你是否要在异地操作远在千里之外的手机？你是否有编程控制手机的需求？是否还在某些云手机厂商那里购买昂贵的 **IP切换**、**远程ADB调试**、**RPA自动化**甚至连 **logcat 日志** 都要付费的服务？如果有，那么对了，只需一个 LAMDA 即可解决所有问题。并且，他更注重**分布式**，事实上，你可以在一台公网服务器上管理散布在世界各地各种网络环境中的设备。当然，LAMDA 可以做到的远不止于此，你可以阅读使用文档尽情探索他的所有能力。
 
 <p align="center"><b>长期维护及更新，质量稳定，安全可靠，生产环境可用<br>现稳定应用于多个外部大型系统，包括自动化取证，云平台，数据采集，涉诈应用分析系统等<br>本框架已稳定运行于各种数据生产环境五年以上</b></p>
 
@@ -33,11 +33,6 @@ LAMDA 是一个**安卓领域的集大成者框架**，设计为减少**安全
 
 <p align="center">LAMDA 提供多达 160 条编程 API 接口，让你可以对安卓设备进行无微不至的管理和操作，提供了包括命令执行，系统设置，系统状态，应用相关，自动化相关，代理以及文件等十几个大类的接口。同时提供了封装完整的 Python 库让你可以快速上手使用。</p>
 
-<p align="center">
-<img src="image/api.png" alt="动图演示" width="95%">
-</p>
-
-
 <h3><p align="center">简洁易用的远程桌面</p></h3>
 
 <p align="center">

{lamda-7.73 → lamda-7.76}/lamda/__init__.py

@@ -2,4 +2,4 @@
 #
 # Distributed under MIT license.
 # See file LICENSE for detail or copy at https://opensource.org/licenses/MIT
-__version__ = "7.73"
+__version__ = "7.76"

{lamda-7.73 → lamda-7.76}/lamda/client.py

@@ -44,7 +44,9 @@ except (ImportError, AttributeError):
 
 from . import __version__
 from . types import AttributeDict, BytesIO
-from . exceptions import UnHandledException, DuplicateEntryError, InvalidArgumentError
+from . exceptions import (UnHandledException, DuplicateEntryError,
+                          InvalidArgumentError, UiObjectNotFoundException,
+                          IllegalStateException)
 from . import exceptions
 
 handler = logging.StreamHandler()
@@ -63,6 +65,8 @@ __all__ = [
                 "GproxyType",
                 "GrantType",
                 "Group",
+                "CustomOcrBackend",
+                "OcrEngine",
                 "Key",
                 "Keys",
                 "KeyCode",
@@ -168,6 +172,18 @@ def center(b):
     y = int(b.top + (b.bottom - b.top)/2)
     return Point(x=x, y=y)
 
+def contain(a, b):
+    return all([b.top >= a.top,
+                b.left >= a.left,
+                b.bottom <= a.bottom,
+                b.right <= a.right])
+
+def equal(a, b):
+    return all([b.top == a.top,
+                b.left == a.left,
+                b.bottom == a.bottom,
+                b.right == a.right])
+
 def corner(b, position):
     ca, cb = position.split("-")
     return Point(x=getattr(b, cb),
@@ -248,6 +264,8 @@ FindImageArea = protos.FindImageArea
 
 Bound.center = center
 Bound.corner = corner
+Bound.__contains__ = contain
+Bound.__eq__ = equal
 
 
 def load_proto(name):
@@ -267,6 +285,13 @@ def Selector(**kwargs):
     return sel
 
 
+class CustomOcrBackend(object):
+    def __init__(self, *args, **kwargs):
+        raise NotImplementedError
+    def ocr(self, image):
+        raise NotImplementedError
+
+
 class BaseCryptor(object):
     def __str__(self):
         return "{}".format(self.__class__.__name__)
@@ -1100,6 +1125,11 @@ class ApplicationStub(BaseServiceStub):
         app = self.__call__(top.packageName)
         app.activity = top.activity
         return app
+    def get_application_by_name(self, name, user=0):
+        req = protos.String(value=name)
+        r = self.stub.getIdentifierByLabel(req)
+        app = self.__call__(r.value, user=user)
+        return app
     def enumerate_running_processes(self):
         """
         列出设备上所有正在运行的安卓应用进程
@@ -1804,6 +1834,140 @@ class WifiStub(BaseServiceStub):
         raise NotImplementedError
 
 
+class OcrOperator(object):
+    def __init__(self, device, elements=None,
+                                    **kwargs):
+        self.elements = elements
+        self.index = kwargs.pop("index", 0)
+        self.func, self.rule = kwargs.popitem()
+        self.match = getattr(self, self.func)
+        self.device = device
+    def text(self, item):
+        return self.rule == item["text"]
+    def textMatches(self, item):
+        return bool(re.match(self.rule, item["text"],
+                                        re.DOTALL))
+    def textContains(self, item):
+        return self.rule in item["text"]
+    def find_target_item(self):
+        m = [e for e in self.elements \
+                            if self.match(e)]
+        o = (m and len(m) > self.index) != True
+        return None if o else m[self.index]
+    def find_item_or_throw(self):
+        item = self.find_target_item()
+        msg = "OcrSelector[{}={}]".format(self.func, self.rule)
+        item or self.throw(UiObjectNotFoundException, msg)
+        return item
+    def find_cb(self, func, ret, *args):
+        item = self.find_target_item()
+        return func(item, *args) if item else ret
+    def find_or_throw_cb(self, func, *args):
+        item = self.find_item_or_throw()
+        return func(item, *args)
+    def throw(self, exception, *args):
+        raise exception(*args)
+    def _screenshot(self, item, quality):
+        return self.device.screenshot(quality,
+                            bound=item["bound"])
+    def _click(self, item):
+        point = item["bound"].center()
+        return self.device.click(point)
+    def __str__(self):
+        return "Ocr: {}={}".format(self.func, self.rule)
+    __repr__ = __str__
+    def exists(self):
+        """
+        OCR - 检查元素是否存在
+        """
+        return bool(self.find_target_item())
+    def exist(self):
+        """
+        OCR - 检查元素是否存在
+        """
+        return self.exists()
+    def click(self):
+        """
+        OCR - 点击元素（不存在则报错）
+        """
+        return self.find_or_throw_cb(self._click)
+    def click_exists(self):
+        """
+        OCR - 点击元素（不存在将不会产生异常）
+        """
+        return self.find_cb(self._click, False)
+    def click_exist(self):
+        """
+        OCR - 点击元素（不存在将不会产生异常）
+        """
+        return self.click_exists()
+    def screenshot(self, quality=100):
+        """
+        OCR - 对元素进行截图
+        """
+        return self.find_or_throw_cb(self._screenshot,
+                                            quality)
+    def take_screenshot(self, quality=100):
+        """
+        OCR - 对元素进行截图
+        """
+        return self.screenshot(quality)
+    def info(self):
+        """
+        OCR - 获取匹配元素的信息
+        """
+        item = self.find_item_or_throw()
+        return item
+
+
+class OcrEngine(object):
+    def __init__(self, service, *args,
+                                     **kwargs):
+        args = list(args)
+        if type(service) == type:
+            args.insert(0, service)
+            service = "custom"
+        func = getattr(self, "init_{}".format(service))
+        func(*args, **kwargs)
+    def init_paddleocr(self, *args, **kwargs):
+        from paddleocr import PaddleOCR
+        self._service = PaddleOCR(*args, **kwargs)
+        self._ocr = self.ocr_paddleocr
+    def init_easyocr(self, *args, **kwargs):
+        from easyocr import Reader
+        self._service = Reader(*args, **kwargs)
+        self._ocr = self.ocr_easyocr
+    def init_custom(self, service, *args, **kwargs):
+        self._service = service(*args, **kwargs)
+        self._ocr = self.ocr_custom
+    def ocr_custom(self, image):
+        result = self._service.ocr(image)
+        return result
+    def ocr_paddleocr(self, image):
+        r = self._service.ocr(image)
+        n = bool(r and r[0] and type(r[0][-1])==float)
+        result = (r if n else r[0]) or []
+        output = [[n[0], n[1][0], n[1][1]] for n in result]
+        return output
+    def ocr_easyocr(self, image):
+        result = self._service.readtext(image)
+        return result
+    def ocr(self, screenshot):
+        img = screenshot.getvalue()
+        result = self._ocr(img) or []
+        output = [self.format(*n) for n in result]
+        return output
+    def format(self, box, text, confidence):
+        bound = Bound()
+        bound.left      = int(min(p[0] for p in box))
+        bound.top       = int(min(p[1] for p in box))
+        bound.bottom    = int(max(p[1] for p in box))
+        bound.right     = int(max(p[0] for p in box))
+        info = dict(text=text, confidence=confidence,
+                                        bound=bound)
+        return info
+
+
 class Device(object):
     def __init__(self, host, port=65000,
                                         certificate=None,
@@ -1827,6 +1991,8 @@ class Device(object):
         interceptors = [ClientSessionMetadataInterceptor(session),
                         GrpcRemoteExceptionInterceptor(),
                         ClientLoggingInterceptor()]
+        self._ocr = None
+        self._ocr_img_quality = 75
         self.channel = grpc.intercept_channel(self._chan,
                         *interceptors)
         self.session = session
@@ -1897,6 +2063,8 @@ class Device(object):
         return self.stub("Application").get_last_activities(count=count)
     def start_activity(self, **activity):
         return self.stub("Application").start_activity(**activity)
+    def get_application_by_name(self, name):
+        return self.stub("Application").get_application_by_name(name)
     def application(self, applicationId, user=0):
         return self.stub("Application")(applicationId, user=user)
     # 快速调用: Util
@@ -2045,6 +2213,26 @@ class Device(object):
         return self.stub("UiAutomator").device_info()
     def __call__(self, **kwargs):
         return self.stub("UiAutomator")(**kwargs)
+    # OCR 功能扩展
+    def ocr(self, index=0, **kwargs):
+        if not isinstance(self._ocr, OcrEngine):
+            raise IllegalStateException("Ocr engine is not setted up")
+        if any(r not in ["text", "textContains", "textMatches"] \
+                                        for r in kwargs.keys()):
+            raise InvalidArgumentError("Only text* matches are supported")
+        if len(kwargs) != 1:
+            raise InvalidArgumentError("Only or at least one rule can be used")
+        image = self.screenshot(self._ocr_img_quality)
+        return OcrOperator(self,
+        elements=self._ocr.ocr(image),
+                            index=index,
+                            **kwargs
+        )
+    def setup_ocr_backend(self, service, *args, quality=75,
+                                                **kwargs):
+        self._ocr_img_quality = quality
+        self._ocr = OcrEngine(service, *args,
+                                    **kwargs)
     # 日志打印
     def set_debug_log_enabled(self, enable):
         level = logging.DEBUG if enable else logging.WARN

{lamda-7.73 → lamda-7.76}/lamda/rpc/services.proto

@@ -49,6 +49,7 @@ service Application {
 
     rpc addToDozeModeWhiteList(ApplicationRequest) returns (Boolean) {}
     rpc removeFromDozeModeWhiteList(ApplicationRequest) returns (Boolean) {}
+    rpc getIdentifierByLabel(String) returns (String) {}
 }
 
 service Debug {

{lamda-7.73 → lamda-7.76}/lamda.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lamda
-Version: 7.73
+Version: 7.76
 Summary: Android reverse engineering & automation framework (Client API)
 Home-page: https://github.com/firerpa/lamda
 Author: rev1si0n
@@ -12,10 +12,10 @@ Classifier: Intended Audience :: Science/Research
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: Android
 Classifier: Topic :: Security
-Requires-Python: >=3.6,<=3.12
-Requires-Dist: grpcio-tools<1.60.0,>=1.35.0
-Requires-Dist: grpc-interceptor<=0.15.2,>=0.13.0
-Requires-Dist: grpcio<1.60.0,>=1.35.0
+Requires-Python: >=3.6,<3.13
+Requires-Dist: grpcio-tools<=1.68.0,>=1.35.0
+Requires-Dist: grpc-interceptor<=0.15.4,>=0.13.0
+Requires-Dist: grpcio<=1.68.0,>=1.35.0
 Requires-Dist: cryptography>=35.0.0
 Requires-Dist: msgpack>=1.0.0
 Requires-Dist: asn1crypto<2,>=1.0.0

{lamda-7.73 → lamda-7.76}/lamda.egg-info/requires.txt

@@ -1,6 +1,6 @@
-grpcio-tools<1.60.0,>=1.35.0
-grpc-interceptor<=0.15.2,>=0.13.0
-grpcio<1.60.0,>=1.35.0
+grpcio-tools<=1.68.0,>=1.35.0
+grpc-interceptor<=0.15.4,>=0.13.0
+grpcio<=1.68.0,>=1.35.0
 cryptography>=35.0.0
 msgpack>=1.0.0
 asn1crypto<2,>=1.0.0

{lamda-7.73 → lamda-7.76}/setup.py

@@ -10,7 +10,7 @@ setuptools.setup(
     description     = "Android reverse engineering & automation framework (Client API)",
     url             = "https://github.com/firerpa/lamda",
     author          = "rev1si0n",
-    python_requires = ">=3.6,<=3.12",
+    python_requires = ">=3.6,<3.13",
     zip_safe        = False,
     extras_require  = {
         "full": ["frida>=16.0.0,<17.0.0"],
@@ -19,9 +19,9 @@ setuptools.setup(
         ],
     },
     install_requires= [
-        "grpcio-tools>=1.35.0,<1.60.0",
-        "grpc-interceptor>=0.13.0,<=0.15.2",
-        "grpcio>=1.35.0,<1.60.0",
+        "grpcio-tools>=1.35.0,<=1.68.0",
+        "grpc-interceptor>=0.13.0,<=0.15.4",
+        "grpcio>=1.35.0,<=1.68.0",
         "cryptography>=35.0.0",
         "msgpack>=1.0.0",
         "asn1crypto>=1.0.0,<2",