Ret2Shell All-in-One Kit

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

Ret2Shell is a feature-riches CTF challenge platform developed by Reverier Xu and other contributors.

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

如何使用

pip install ret2shell-kit

leet mode

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

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

API 客户端

基于平台接口获取比赛队伍排行榜，按得分降序返回。token 可选，不传则以游客身份访问。

from ret2shell_kit import Ret2ShellClient

with Ret2ShellClient("https://your-platform.example/api", token="your_token") as client:
    # 1. 整场比赛排行榜（分页拉取全部队伍）
    board = client.game.get_leaderboard(game_id=1)

    # 2. 只取前 10 名
    top10 = client.game.get_leaderboard(game_id=1, top_n=10)

    # 3. 按机构 ID 过滤，只取该机构前 10 名
    by_id = client.game.get_leaderboard_by_institute_id(
        game_id=1, institute_id=5, top_n=10
    )

    # 4. 按机构名称过滤（内部先查询机构列表解析出机构 ID）
    by_name = client.game.get_leaderboard_by_institute_name(
        game_id=1, institute_name="西安电子科技大学", top_n=10
    )

各方法返回 Team 模型列表，可按得分/名称等字段访问：

for team in top10:
    print(f"#{team.score:>5}  {team.name:<20} institute_id={team.institute_id}")

说明：top_n=None时返回全部队伍；页面较大时会自动分页拉取。如需排除被禁用的队伍，可传min_state。排行榜默认按 score 字段降序排列。机构名对应不上时会抛出ValueError。

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ret2shell_kit-0.1.2.tar.gz (25.5 kB view details)

Uploaded Aug 11, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ret2shell_kit-0.1.2-py3-none-any.whl (26.9 kB view details)

Uploaded Aug 11, 2026 Python 3

File details

Details for the file ret2shell_kit-0.1.2.tar.gz.

File metadata

Download URL: ret2shell_kit-0.1.2.tar.gz
Upload date: Aug 11, 2026
Size: 25.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ret2shell_kit-0.1.2.tar.gz
Algorithm	Hash digest
SHA256	`b280999ac88e4a1023ea27016e954d2a00897852f1fcbb5631d7adfead2fca7a`
MD5	`6c7846fabd1e1afd61c8a36f4c52114e`
BLAKE2b-256	`d291d4bea5d2d28b619ba0305fe6fe8e75d337ba30c657b1feaaf8712d798833`

See more details on using hashes here.

Provenance

The following attestation bundles were made for ret2shell_kit-0.1.2.tar.gz:

Publisher: publish.yml on Xiaozonglin/ret2shell-steganography

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: ret2shell_kit-0.1.2.tar.gz
- Subject digest: b280999ac88e4a1023ea27016e954d2a00897852f1fcbb5631d7adfead2fca7a
- Sigstore transparency entry: 2418777813
- Sigstore integration time: Aug 11, 2026
Source repository:
- Permalink: Xiaozonglin/ret2shell-steganography@eed1675883cda348dd0275346c30146de1def17b
- Branch / Tag: refs/tags/v0.1.2-fix
- Owner: https://github.com/Xiaozonglin
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@eed1675883cda348dd0275346c30146de1def17b
- Trigger Event: push