Metadata-Version: 2.4
Name: ret2shell-kit
Version: 0.1.1
Summary: Ret2Shell工具箱
Author-email: Zonglin Xiao <xiaozonglin@stu.xidian.edu.cn>
Project-URL: Homepage, https://github.com/Xiaozonglin/ret2shell-steganography
Project-URL: Bug Tracker, https://github.com/Xiaozonglin/ret2shell-steganography/issues
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pycryptodome
Requires-Dist: Crypto
Requires-Dist: uuid
Dynamic: license-file

# Ret2Shell All-in-One Kit

[![PyPI version](https://badge.fury.io/py/ret2shell-kit.svg)](https://pypi.org/p/ret2shell-kit/)

回归终端 Ret2Shell 工具箱，目前包含动态 FLAG 生成校验、接口管理（计划）等功能。

[Ret2Shell](https://github.com/ret2shell/ret2shell) is a feature-riches CTF challenge platform developed by [Reverier Xu](https://github.com/Reverier-Xu) and other contributors.

This package obeys the same license of Ret2Shell, GNU GPL-3.0.

### 如何使用

```
pip install ret2shell-kit
```

leet mode
```python
from ret2shell_kit import LeetStego
# 初始化一个密钥，需要与平台上设置的相同
stego = LeetStego("your_secret_key")

# 定义 Flag 模板，获取ID（team_id优先，user_id次之）
template = "this-is-an-example"
data_id = 12345

# 生成 Flag 内容
encoded = stego.encode(template, data_id)
print(f"编码结果 {encoded}")

# 解码验证
decoded = stego.decode(template, encoded)
print(f"解码结果 {decoded}")  # 12345
```

uuid mode
```python
from ret2shell_kit import UUIDStego

# 初始化（带连字符格式）
uuid_stego = UUIDStego("your_secret_key", with_hyphen=True)

template = "this-is-an-example"
data_id = 12345

# 生成 UUID
encoded = uuid_stego.encode(template, data_id)
print(f"UUID: {encoded}")

# 解码
decoded = uuid_stego.decode(template, encoded)
print(f"解码结果: {decoded}")  # 12345
```
