lamda 7.52__tar.gz → 7.57__tar.gz

{lamda-7.52 → lamda-7.57}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lamda
-Version: 7.52
+Version: 7.57
 Summary: Android reverse engineering & automation framework
 Home-page: https://github.com/rev1si0n/lamda
 Author: rev1si0n

{lamda-7.52 → lamda-7.57}/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-<img src="image/logo.svg" alt="LAMDA" width="365">
+<img src="image/logo.svg" alt="LAMDA" width="345">
 </p>
 
 <p align="center">Android reverse engineering & automation framework, the super power.</p>
@@ -8,14 +8,19 @@
 <img src="https://img.shields.io/badge/python-3.6+-blue.svg?logo=python&labelColor=yellow" />
 <img src="https://img.shields.io/badge/android-6.0+-blue.svg?logo=android&labelColor=white" />
 <img src="https://img.shields.io/badge/root%20require-red.svg?logo=android&labelColor=black" />
+<img src="https://img.shields.io/github/downloads/rev1si0n/lamda/total" />
 <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></p>
-<br>
+<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>
 
 LAMDA 是一个用于逆向及自动化的辅助框架，设计为减少安全分析以及应用测试人员的时间及琐碎问题，以编程化的接口替代大量手动操作，它并不是一个单一功能的框架，他是 Appium、uiautomator 的超集同时具备逆向领域的能力。为了让你大概了解它的用处：你是否会在手机上安装各类代理、插件或者点来点去的设置来完成你的工作？你是否要在异地操作远在千里之外的手机？你是否有编程控制手机的需求？是否还在某些云手机厂商那里购买昂贵的**IP切换**、**远程ADB调试**、**RPA自动化**甚至连 **logcat 日志**都要付费的服务？如果有，那么对了，只需一个 LAMDA 即可解决这些问题。并且，LAMDA 更注重**分布式**，事实上，你可以在一台公网服务器上管理散布在世界各地各种网络环境中的设备。当然，LAMDA 可以做到的不止于此。
 
+<p align="center">
+<img src="image/wx.png" alt="公众号" width="234">
+</p>
+<p align="center"><small>关注公众号查看视频教程以及更多使用方法</small><br><small><b>知识应该是共享的，我们不会要求你为相关知识付费</b></small><br><small>文字版文档请查看<a href="https://github.com/rev1si0n/lamda/wiki">使用文档</a></small></p>
+
 经过超 500 台设备的稳定生产环境考验，具有近乎商业级软件的质量和稳定性，仅需 root 权限即可正常运行。具备 ARM/X86 全架构，安卓 6.0-14 的广泛兼容性，支持模拟器、真机、云手机、 WSA（Windows Subsystem for Android™️）、无头开发板以及 Redroid。提供大量可编程接口，支持界面布局检视、获取/重放系统中最近的 Activity、唤起应用的 Activity 等功能。除此之外，它支持大文件上传下载，远程桌面，以及UI自动化编程接口，点击、截图、获取界面元素、执行 shell 命令、设备状态、资源读取、系统配置、属性读写、一键中间人等，可通过 SSH 或内置 ADB 登录设备终端。具备 socks5、OpenVPN 代理并可通过接口轻松设置根证书，实现中间人攻击，以及 Frida、IDA 等工具等等，同时支持定时任务、Magisk开机自启动，你可以在任何地方通过网络连接运行着 LAMDA 设备。
 
 ![动图演示](image/demo.gif)
@@ -26,4 +31,6 @@ LAMDA 是一个用于逆向及自动化的辅助框架，设计为减少安全
 
 ![中间人流量分析动图演示](image/mitm.gif)
 
-当然，LAMDA 的能力不止于如上种种，他是你强有力的控制及管理工具，如果您感兴趣，请转到 [使用文档](https://github.com/rev1si0n/lamda/wiki)。
+<p align="center">
+当然，LAMDA 提供的能力不止于这些，由于篇幅较长将不在此罗列，他是你强有力的设备控制及管理工具，如果你感兴趣，请转到 使用文档。
+</p>

{lamda-7.52 → lamda-7.57}/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.52"
+__version__ = "7.57"

{lamda-7.52 → lamda-7.57}/lamda/client.py

@@ -67,6 +67,8 @@ __all__ = [
                 "Keys",
                 "KeyCode",
                 "KeyCodes",
+                "MetaKeyCode",
+                "MetaKeyCodes",
                 "BaseCryptor",
                 "FernetCryptor",
                 "OpenVPNAuth",
@@ -182,6 +184,9 @@ Keys = protos.Key # make an alias
 KeyCode = protos.KeyCode
 KeyCodes = protos.KeyCode # make an alias
 
+MetaKeyCode = protos.MetaKeyCode
+MetaKeyCodes = protos.MetaKeyCode # make an alias
+
 OpenVPNAuth = protos.OpenVPNAuth
 OpenVPNEncryption = protos.OpenVPNEncryption
 OpenVPNKeyDirection = protos.OpenVPNKeyDirection
@@ -237,6 +242,8 @@ TouchSequence.__iter__ = touchSequenceIter
 Bound.width = property(width)
 Bound.height = property(height)
 
+FindImageMethod = protos.FindImageMethod
+
 Bound.center = center
 Bound.corner = corner
 
@@ -848,6 +855,19 @@ class UiAutomatorStub(BaseServiceStub):
         """
         r = self.stub.getClipboard(protos.Empty())
         return r.value
+    def find_similar_image(self, data, threshold=0,
+                           max_distance=0, bound=None,
+                           method=FindImageMethod.FI_TEMPLATE):
+        """
+        根据提供的目标图片从屏幕中获取相似图片位置
+        """
+        req = protos.FindImageRequest(bound=bound)
+        req.method = method
+        req.max_distance = max_distance
+        req.threshold = threshold
+        req.partial = data
+        r = self.stub.findSimilarImage(req)
+        return r.bounds
     def freeze_rotation(self, freeze=True):
         """
         锁定屏幕旋转
@@ -2017,6 +2037,11 @@ class Device(object):
         return self.stub("UiAutomator").wait_for_idle(timeout)
     def get_last_toast(self):
         return self.stub("UiAutomator").get_last_toast()
+    def find_similar_image(self, data, threshold=0,
+                                max_distance=0, bound=None,
+                                method=FindImageMethod.FI_TEMPLATE):
+        return self.stub("UiAutomator").find_similar_image(data, threshold=threshold,
+                                max_distance=max_distance, bound=bound, method=method)
     # watcher
     def remove_all_watchers(self):
         return self.stub("UiAutomator").remove_all_watchers()

{lamda-7.52 → lamda-7.57}/lamda/rpc/services.proto

@@ -186,6 +186,7 @@ service UiAutomator {
     rpc registerClickUiObjectWatcher(WatcherRegistRequest) returns (Boolean) {}
     rpc registerPressKeysWatcher(WatcherRegistRequest) returns (Boolean) {}
     rpc registerNoneOpWatcher(WatcherRegistRequest) returns (Boolean) {}
+    rpc findSimilarImage(FindImageRequest) returns (FindImageResponse) {}
 }
 
 service Wifi {

{lamda-7.52 → lamda-7.57}/lamda/rpc/uiautomator.proto

@@ -336,6 +336,31 @@ enum KeyCode {
         KEYCODE_PROFILE_SWITCH  = 288;
 }
 
+enum MetaKeyCode {
+        META_UNKNOWN            = 0;
+        META_SHIFT_ON           = 1;
+        META_ALT_ON             = 2;
+        META_SYM_ON             = 4;
+        META_FUNCTION_ON        = 8;
+        META_ALT_LEFT_ON        = 16;
+        META_ALT_RIGHT_ON       = 32;
+        META_ALT_MASK           = 50;
+        META_SHIFT_LEFT_ON      = 64;
+        META_SHIFT_RIGHT_ON     = 128;
+        META_SHIFT_MASK         = 193;
+        META_CTRL_ON            = 4096;
+        META_CTRL_LEFT_ON       = 8192;
+        META_CTRL_RIGHT_ON      = 16384;
+        META_CTRL_MASK          = 28672;
+        META_META_ON            = 65536;
+        META_META_LEFT_ON       = 131072;
+        META_META_RIGHT_ON      = 262144;
+        META_META_MASK          = 458752;
+        META_CAPS_LOCK_ON       = 1048576;
+        META_NUM_LOCK_ON        = 2097152;
+        META_SCROLL_LOCK_ON     = 4194304;
+}
+
 enum Corner {
         COR_CENTER          = 0;
         COR_BOTTOMRIGHT     = 1;
@@ -529,3 +554,20 @@ message WatcherRegistRequest {
                 Key key = 4;
         }
 }
+
+enum FindImageMethod {
+        FI_TEMPLATE             = 0;
+        FI_FEATURE_POINT        = 1;
+}
+
+message FindImageRequest {
+        FindImageMethod method  = 1;
+        Bound bound             = 2;
+        bytes partial           = 3;
+        uint32 max_distance     = 4;
+        float threshold         = 5;
+}
+
+message FindImageResponse {
+        repeated Bound bounds = 1;
+}

{lamda-7.52 → lamda-7.57}/lamda.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lamda
-Version: 7.52
+Version: 7.57
 Summary: Android reverse engineering & automation framework
 Home-page: https://github.com/rev1si0n/lamda
 Author: rev1si0n