fry-return

A structured return object for Python functions. Instead of returning bare dicts or raising exceptions for every non-happy path, wrap your result in a FryReturnObj — it carries a typed status code, a human-readable message, optional data payload, and a list of detail strings.

Installation

pip install fry-return

Quick start

from fry_return import FryReturnObj, FryReturnCode

Direct usage — data goes into data_dict

Simple but less IDE-friendly: you get no autocomplete on the payload fields.

def get_user(user_id: int) -> FryReturnObj:
    user = db.find(user_id)
    if user is None:
        return FryReturnObj.failed("用户不存在")
    return FryReturnObj.success("查询成功").set_data("user", user)

result = get_user(42)
if result.is_success:
    print(result.data_dict["user"])
else:
    print(result.message_str)

Inheritance — core data as typed attributes (recommended)

Define a subclass and add your payload as proper typed fields. Editors will autocomplete everything.

from dataclasses import dataclass, field
from fry_return import FryReturnObj, FryReturnCode

@dataclass
class GetUserResult(FryReturnObj):
    user_id: int = 0
    username: str = ""
    email: str = ""

def get_user(user_id: int) -> GetUserResult:
    user = db.find(user_id)
    if user is None:
        return GetUserResult(code=FryReturnCode.FAILED, message_str="用户不存在")

    result = GetUserResult(code=FryReturnCode.SUCCESS, message_str="查询成功")
    result.user_id = user.id
    result.username = user.name
    result.email = user.email
    return result

result = get_user(42)
if result.is_success:
    print(result.username)   # 编辑器可以自动补全
    print(result.email)

Chaining

result = (
    FryReturnObj.info("开始处理")
    .add_detail("步骤1完成")
    .add_detail("步骤2完成")
    .set_success("全部完成")
    .set_data("count", 10)
)

Serialization

d = result.to_dict()          # -> dict，可直接 JSON 序列化
r = FryReturnObj.from_dict(d) # 从 dict 还原

Status codes (FryReturnCode)

Key properties

License

MIT