reproto 0.1.1__tar.gz → 0.1.3__tar.gz

reproto-0.1.3/.git/COMMIT_EDITMSG

@@ -0,0 +1,29 @@
+feat: 实施智能导入系统并优化README
+
+🚀 主要更新:
+- 实施智能导入方案，同时支持开发环境和包安装环境
+- 使用try/except块自动切换相对导入和绝对导入
+- 解决ModuleNotFoundError导入错误问题
+
+📝 代码改进:
+- 所有模块文件添加智能导入语句
+- 统一导入格式，提升代码兼容性
+- 优化包结构，支持作为Python包使用
+
+📖 文档优化:
+- 简化README内容，去除冗余技术细节
+- 突出核心使用方法和注意事项
+- 特别强调内部类()的正确使用方法
+- 移除特定应用相关内容，使用通用示例
+
+🔧 技术特性:
+- 开发环境: 使用绝对导入 (from core import)
+- 包环境: 使用相对导入 (from .core import)
+- 自动检测环境并选择合适的导入方式
+- 完全向后兼容，无破坏性变更
+
+✅ 测试验证:
+- 开发环境测试通过 ✅
+- 包安装环境测试通过 ✅
+- 命令行工具正常运行 ✅
+- 导入系统工作正常 ✅

{reproto-0.1.1 → reproto-0.1.3}/.git/logs/HEAD

@@ -12,3 +12,7 @@ fce15b9dbffd9f37b1f2d46944ee2d0394df6565 70ded03ee69f30850c938a8129be308cb30772d
 e41e5aa2bc3074c2014d01ab1f603f69c327a83f b07a43f0462bf25a8b1f4c0ca60c1b533dae1dde iyue <ys1231@126.com> 1751010729 +0800	commit: fix: 改进日志级别和错误处理
 b07a43f0462bf25a8b1f4c0ca60c1b533dae1dde 3d3cc6aab4eefed46c77dda27503bebcce88962c iyue <ys1231@126.com> 1751011389 +0800	commit: release: v2.1.0 - 重大性能优化和功能增强
 3d3cc6aab4eefed46c77dda27503bebcce88962c 7e5935774ee7a85f2523427c9100f9c578ac172f iyue <ys1231@126.com> 1751011558 +0800	commit: feat(build): update version
+7e5935774ee7a85f2523427c9100f9c578ac172f 07b71df33935c14ddf99e3480c04eca4685028bc iyue <ys1231@126.com> 1751093937 +0800	commit: feat: 完善proto重构系统 - 硬编码移除与智能分析优化
+07b71df33935c14ddf99e3480c04eca4685028bc 12f9cc4ad0b4f0af4f7bae379f281b2cebe7cc7f iyue <ys1231@126.com> 1751096494 +0800	commit: feat: 代码优化
+12f9cc4ad0b4f0af4f7bae379f281b2cebe7cc7f 9368f2c32f83054ab072b7c9686d8baa0bad7f12 iyue <ys1231@126.com> 1751101028 +0800	commit: 重构: 将print_results_summary函数移动到utils.report_utils模块
+9368f2c32f83054ab072b7c9686d8baa0bad7f12 2de8ecbb5ab5de1a032bef3f4606ce5fa7c6c4e8 iyue <ys1231@126.com> 1751103208 +0800	commit: feat: 实施智能导入系统并优化README

{reproto-0.1.1 → reproto-0.1.3}/.git/logs/refs/heads/iyue

@@ -12,3 +12,7 @@ fce15b9dbffd9f37b1f2d46944ee2d0394df6565 70ded03ee69f30850c938a8129be308cb30772d
 e41e5aa2bc3074c2014d01ab1f603f69c327a83f b07a43f0462bf25a8b1f4c0ca60c1b533dae1dde iyue <ys1231@126.com> 1751010729 +0800	commit: fix: 改进日志级别和错误处理
 b07a43f0462bf25a8b1f4c0ca60c1b533dae1dde 3d3cc6aab4eefed46c77dda27503bebcce88962c iyue <ys1231@126.com> 1751011389 +0800	commit: release: v2.1.0 - 重大性能优化和功能增强
 3d3cc6aab4eefed46c77dda27503bebcce88962c 7e5935774ee7a85f2523427c9100f9c578ac172f iyue <ys1231@126.com> 1751011558 +0800	commit: feat(build): update version
+7e5935774ee7a85f2523427c9100f9c578ac172f 07b71df33935c14ddf99e3480c04eca4685028bc iyue <ys1231@126.com> 1751093937 +0800	commit: feat: 完善proto重构系统 - 硬编码移除与智能分析优化
+07b71df33935c14ddf99e3480c04eca4685028bc 12f9cc4ad0b4f0af4f7bae379f281b2cebe7cc7f iyue <ys1231@126.com> 1751096494 +0800	commit: feat: 代码优化
+12f9cc4ad0b4f0af4f7bae379f281b2cebe7cc7f 9368f2c32f83054ab072b7c9686d8baa0bad7f12 iyue <ys1231@126.com> 1751101028 +0800	commit: 重构: 将print_results_summary函数移动到utils.report_utils模块
+9368f2c32f83054ab072b7c9686d8baa0bad7f12 2de8ecbb5ab5de1a032bef3f4606ce5fa7c6c4e8 iyue <ys1231@126.com> 1751103208 +0800	commit: feat: 实施智能导入系统并优化README

{reproto-0.1.1 → reproto-0.1.3}/.git/logs/refs/remotes/gitlab/iyue

@@ -11,3 +11,7 @@ fce15b9dbffd9f37b1f2d46944ee2d0394df6565 70ded03ee69f30850c938a8129be308cb30772d
 e41e5aa2bc3074c2014d01ab1f603f69c327a83f b07a43f0462bf25a8b1f4c0ca60c1b533dae1dde iyue <ys1231@126.com> 1751010753 +0800	update by push
 b07a43f0462bf25a8b1f4c0ca60c1b533dae1dde 3d3cc6aab4eefed46c77dda27503bebcce88962c iyue <ys1231@126.com> 1751011478 +0800	update by push
 3d3cc6aab4eefed46c77dda27503bebcce88962c 7e5935774ee7a85f2523427c9100f9c578ac172f iyue <ys1231@126.com> 1751011568 +0800	update by push
+7e5935774ee7a85f2523427c9100f9c578ac172f 07b71df33935c14ddf99e3480c04eca4685028bc iyue <ys1231@126.com> 1751094024 +0800	update by push
+07b71df33935c14ddf99e3480c04eca4685028bc 12f9cc4ad0b4f0af4f7bae379f281b2cebe7cc7f iyue <ys1231@126.com> 1751096510 +0800	update by push
+12f9cc4ad0b4f0af4f7bae379f281b2cebe7cc7f 9368f2c32f83054ab072b7c9686d8baa0bad7f12 iyue <ys1231@126.com> 1751101083 +0800	update by push
+9368f2c32f83054ab072b7c9686d8baa0bad7f12 2de8ecbb5ab5de1a032bef3f4606ce5fa7c6c4e8 iyue <ys1231@126.com> 1751103234 +0800	update by push

{reproto-0.1.1 → reproto-0.1.3}/.git/logs/refs/remotes/origin/iyue

@@ -11,3 +11,7 @@ fce15b9dbffd9f37b1f2d46944ee2d0394df6565 70ded03ee69f30850c938a8129be308cb30772d
 e41e5aa2bc3074c2014d01ab1f603f69c327a83f b07a43f0462bf25a8b1f4c0ca60c1b533dae1dde iyue <ys1231@126.com> 1751010741 +0800	update by push
 b07a43f0462bf25a8b1f4c0ca60c1b533dae1dde 3d3cc6aab4eefed46c77dda27503bebcce88962c iyue <ys1231@126.com> 1751011447 +0800	update by push
 3d3cc6aab4eefed46c77dda27503bebcce88962c 7e5935774ee7a85f2523427c9100f9c578ac172f iyue <ys1231@126.com> 1751011577 +0800	update by push
+7e5935774ee7a85f2523427c9100f9c578ac172f 07b71df33935c14ddf99e3480c04eca4685028bc iyue <ys1231@126.com> 1751093982 +0800	update by push
+07b71df33935c14ddf99e3480c04eca4685028bc 12f9cc4ad0b4f0af4f7bae379f281b2cebe7cc7f iyue <ys1231@126.com> 1751096519 +0800	update by push
+12f9cc4ad0b4f0af4f7bae379f281b2cebe7cc7f 9368f2c32f83054ab072b7c9686d8baa0bad7f12 iyue <ys1231@126.com> 1751101033 +0800	update by push
+9368f2c32f83054ab072b7c9686d8baa0bad7f12 2de8ecbb5ab5de1a032bef3f4606ce5fa7c6c4e8 iyue <ys1231@126.com> 1751103218 +0800	update by push

reproto-0.1.3/.git/objects/24/d78e796570a8572a03bc1dd26608a7cfb506f8

@@ -0,0 +1,2 @@
+x
�RMo�@��_�J�BB�#B=�!�I7�����k�܂��CSZ�Rh U�
�*����L�N���:vQT�=X�7o�̾��F����;w�%		N;P>u{m8hJ8eh|�F�w볟e�}��Ɓ~���xo����}�:r�����G|�Q �;=+����o�Fţ�V��>ކo{�6��7���84~<��FP�S��W�~�Uߚ@�>�fN�J�2T�|�L	#"�!!9
+���
�ǯ�\����5'H���IH�t����R����0E�nʐ��m�
�B9�.�c	YU�rF�<�a�G����M,�Lլ��#�b�����誑�3�x�)󐬊�5Y�X6)�`�"4���U���c$����
]1�X�_P5��z��1*Ş��5�j0�b�֘%[��+4/��6Z�={@)�sϯ��7�vߔ�>Ȋ��?)B�'��<�@4t|�QĚYj
��H��h�,���oA2���T�E+�L�����M

reproto-0.1.3/.git/objects/3f/b8830f516342a0ae1cb7c34b65016827cb9570

@@ -0,0 +1,4 @@
+x
�T[kA�y~Ű}�t�4�Rl�ZAAԷ�����vtwf��u��%T�(ZT�E�(�I�4�L6��l�U
+�����\�;�v�ڴ�<r��bۋ,���u�����^�t�.FZ�3�d���6���Z�·y|d��1�˹U��k���X�E$�!�
+�i#�qSD�{��LE�(<�c�mL7�Ӈ��|y\V9h������v�^O�[�퀨W�_d���p���:0�+P�(���9�#���ad*$�2
+���*
z$�<��߂�X;��lO6�Wjx����Y.SZ�I��:��na�
e�iD���Q,{Oʵ�[eo���r�N���`mu�r

reproto-0.1.3/.git/objects/45/fbc774dedb61c7c205ea732f59a8dca8d13555

@@ -0,0 +1,3 @@
+x
m�Ok�0�{֧��v��z=��1��(�A�����֑�8,�B�Ґ�mc��%^�L^˷~�����AH�����)3^��_�
+wsh���\��
+��RG��fPV%�Sb;�B�u�$^���a�\��.LM�fi�A>ڰ��]^�G!B4��G��j󝋥�e͋%���i*�K���R��d:�Q(?��_D��ZO��5 

reproto-0.1.3/.git/objects/60/5cb6fd6a9f8894ad4d43a9b8e4785c1b3b0e17

@@ -0,0 +1 @@
+x
��MO�0�=�S4p��4��#=y7ff�`��ћ�K�R_��|	$��_���_�����=5�����i���3s��H��w̡Pj�F

reproto-0.1.3/.git/objects/93/68f2c32f83054ab072b7c9686d8baa0bad7f12

@@ -0,0 +1,4 @@
+x
���n�@�Y�)�G�3�!�TU��6���d,,�Id��5"m�(�(mP�R���"�"RKC����o�oX���|�sY��=�ؼ'�UD4�5S�F���c�B4�,�s�4�K�R�
�
+w�1�V������k9�k֦K��!�;�b�r���@�W5BL4���j�c[�#RV�2BJ��k	��%k��Y�
+��z�U��0��F�O���r0I�fЍ�3����^��^2��ӡ�<P�s���r�_�To,o��a?[���dv$Ͼ��%v�{����^y2�����U=a۹O^��r�����h�Bg�^Ĺo����>�����"9�s:��Zq{����Z+n-�~�j��z�����˧Ys
{}����:����WOe�Y��QO�r�
+>�_�f/����`y������i���

reproto-0.1.3/.git/refs/heads/iyue

@@ -0,0 +1 @@
+2de8ecbb5ab5de1a032bef3f4606ce5fa7c6c4e8

reproto-0.1.3/.git/refs/remotes/gitlab/iyue

@@ -0,0 +1 @@
+2de8ecbb5ab5de1a032bef3f4606ce5fa7c6c4e8

reproto-0.1.3/.git/refs/remotes/origin/iyue

@@ -0,0 +1 @@
+2de8ecbb5ab5de1a032bef3f4606ce5fa7c6c4e8

{reproto-0.1.1 → reproto-0.1.3}/.gitignore

@@ -142,4 +142,5 @@ poetry.lock
 uv.lock
 
 /out_*
-/init.md
+/init.md
+/logs

reproto-0.1.3/PKG-INFO

@@ -0,0 +1,209 @@
+Metadata-Version: 2.3
+Name: reproto
+Version: 0.1.3
+Summary: 一个强大的逆向工程工具, 能够从任何使用Google Protobuf Lite的Android应用中自动重构出完整的.proto文件结构.
+License: Proprietary
+Keywords: protobuf,reverse-engineering,android,jadx,proto
+Author: iyue
+Author-email: ys1231@126.com
+Requires-Python: >=3.12,<4.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Disassemblers
+Requires-Dist: loguru (>=0.7.3)
+Project-URL: Homepage, https://github.com/ys1231/reproto
+Project-URL: Repository, https://github.com/ys1231/reproto.git
+Description-Content-Type: text/markdown
+
+# Protobuf Reconstructor
+
+🔧 **从JADX反编译的Java源码自动重构Protobuf .proto文件**
+
+一个强大的逆向工程工具，能够从任何使用Google Protobuf Lite的Android应用中自动重构出完整的.proto文件结构。
+
+## ✨ 特性
+
+- 🎯 **精准解析**: 基于Google Protobuf Lite字节码的逆向工程
+- 🔄 **递归依赖**: 自动发现和处理所有依赖的消息和枚举类型
+- 📦 **完整支持**: 支持oneof、repeated、map、枚举等所有Protobuf特性
+- 🌐 **通用性**: 适用于任何Android应用，无需硬编码映射
+- 🧠 **智能推断**: 从Java源码直接读取类型信息，确保高准确性
+- 📝 **标准输出**: 严格遵循Google Proto Style Guide
+
+## 🛠️ 安装
+
+### 方式一：拉取代码
+```bash
+# 克隆项目
+git clone <repository_url>
+cd reproto
+
+# 安装依赖
+pip install -r requirements.txt
+```
+
+### 方式二：pip安装
+```bash
+# 从本地构建安装
+pip install .
+
+# 在线安装
+pip install reproto
+```
+
+## 📖 使用
+
+### 命令行使用
+```bash
+# 基本用法 python main.py or 命令 reproto
+reproto <java_sources_dir> <root_class> <output_dir> [--verbose]
+
+# 示例：重构普通类
+reproto ./out_jadx/sources com.example.messaging.v1.models.MessageData ./protos_generated
+
+# 示例：重构内部类（注意：包含$的类名需要用单引号包裹）
+reproto ./out_jadx/sources 'com.example.account.v1.Models$Onboarded' ./output
+
+# 详细输出
+reproto ./out_jadx/sources com.example.Model ./output --verbose
+```
+
+### 代码使用
+```python
+# 作为包使用
+from core import ProtoReconstructor
+from utils.logger import setup_logger
+from pathlib import Path
+
+# 初始化
+setup_logger("./logs")
+sources_dir = Path("./out_jadx/sources")
+output_dir = Path("./protos_generated")
+
+# 创建重构器并执行
+reconstructor = ProtoReconstructor(sources_dir, output_dir)
+results = reconstructor.reconstruct_from_root("com.example.Model")
+
+# 查看结果
+for class_name, definition in results.items():
+    print(f"生成: {class_name} -> {definition.proto_filename}")
+```
+
+### 参数说明
+- `java_sources_dir`: JADX反编译的Java源码目录路径
+- `root_class`: 要重构的根类完整类名
+- `output_dir`: 生成的proto文件输出目录路径
+- `--verbose`: 显示详细处理信息
+
+## ⚠️ 注意事项
+
+### 重要提醒
+- **内部类命名**: 包含`$`符号的类名（如内部类）必须用**单引号包裹**
+  ```bash
+  # ✅ 正确
+  reproto ./sources 'com.example.Outer$Inner' ./output
+  
+  # ❌ 错误
+  reproto ./sources com.example.Outer$Inner ./output
+  ```
+
+### 使用建议
+1. **JADX反编译**: 先使用JADX反编译APK文件
+   ```bash
+   jadx -d out_jadx app.apk
+   ```
+
+2. **类名查找**: 在JADX GUI中找到目标Protobuf类的完整类名
+
+3. **输出目录**: 确保输出目录有写入权限
+
+4. **日志查看**: 使用`--verbose`参数查看详细处理过程
+
+## 📊 输出示例
+
+### 输入：Java源码
+```java
+public final class SearchResult extends GeneratedMessageLite {
+    private MapFieldLite<String, Contact> contacts_;
+    private Internal.ProtobufList<String> phoneNumbers_;
+    
+    public static final int CONTACTS_FIELD_NUMBER = 1;
+    public static final int PHONE_NUMBERS_FIELD_NUMBER = 2;
+}
+```
+
+### 输出：Proto文件
+```protobuf
+syntax = "proto3";
+
+package com.example.search.v1.models;
+
+option java_package = "com.example.search.v1.models";
+option java_multiple_files = true;
+
+message SearchResult {
+  map<string, Contact> contacts = 1;
+  repeated string phone_numbers = 2;
+}
+```
+
+## 🛠️ 支持的特性
+
+### Protobuf类型支持
+- ✅ 基础类型：`string`, `int32`, `int64`, `bool`, `float`, `double`
+- ✅ 消息类型：嵌套消息和引用消息
+- ✅ 枚举类型：完整的枚举值解析
+- ✅ 重复字段：`repeated` 类型
+- ✅ 映射字段：`map<key, value>` 类型
+- ✅ Oneof字段：互斥字段组
+- ✅ Google Well-Known Types
+
+### 特殊Java类型
+- `MapFieldLite<K, V>` → `map<K, V>`
+- `Internal.ProtobufList<T>` → `repeated T`
+- `Internal.IntList` → `repeated enum` (枚举列表)
+
+## 📁 项目结构
+
+```
+reproto/
+├── main.py                     # 主程序入口
+├── core/                       # 核心组件
+│   ├── reconstructor.py        # 主协调器
+│   └── info_decoder.py         # 字节码解码器
+├── parsing/                    # 解析模块
+│   ├── java_parser.py          # Java文件解析器
+│   └── enum_parser.py          # 枚举解析器
+├── generation/                 # 生成模块
+│   └── proto_generator.py      # Proto文件生成器
+├── models/                     # 数据模型
+│   └── message_definition.py   # 消息和枚举定义
+├── utils/                      # 工具函数
+│   ├── logger.py              # 日志系统
+│   ├── file_cache.py          # 文件缓存系统
+│   ├── type_utils.py          # 类型处理工具
+│   └── report_utils.py        # 结果统计工具
+└── include/                    # Google Protobuf标准文件
+    └── google/protobuf/        # Well-Known Types
+```
+
+## 🔧 开发
+
+```bash
+# 使用Poetry管理依赖
+poetry install
+poetry shell
+
+# 运行测试
+reproto ../out_jadx/sources com.example.TestClass ../test_output --verbose
+```
+
+---
+
+**🚀 立即开始重构你的Protobuf文件！**
+