mycqu.card.EnergyFees

class mycqu.card.EnergyFees(balance: float, electricity_subsidy: Optional[float], water_subsidy: Optional[float], subsidies: Optional[float])

某宿舍的水电费相关信息

Methods

__init__(balance, electricity_subsidy, ...)

fetch(session, is_huxi, room)

从 card.cqu.edu.cn 上获取当前水电费信息,需要登录了统一身份认证的会话

from_dict(data, is_huxi)

从反序列化的(一个)水电费 json 中获取水电费信息

Attributes

balance

账户余额

electricity_subsidy

电剩余补助(仅虎溪校区拥有)

water_subsidy

水剩余补助(仅虎溪校区拥有)

subsidies

补助余额(仅老校区拥有)

Details

balance: float

账户余额

electricity_subsidy: Optional[float]

电剩余补助(仅虎溪校区拥有)

static fetch(session: requests.sessions.Session, is_huxi: bool, room: str) mycqu.card.EnergyFees

从 card.cqu.edu.cn 上获取当前水电费信息,需要登录了统一身份认证的会话

参数
  • session (Session) – 登录了统一身份认证(auth.login())并在 card.cqu.edu.cn 进行了认证(card.access_card())的 requests 会话

  • is_huxi (bool) – 房间号是否为虎溪校区的房间

  • room (str) – 需要获取水电费详情的宿舍

引发
  • NetworkError – 当访问相关网页时statue code不为200时抛出

  • TicketGetError – 当未能从网页对应位置中获取到ticket时抛出

  • ParseError – 当从返回数据解析所需值失败时抛出

  • CQUWebsiteError – 当网页获取水电费状态码不为success时抛出

返回

返回相关宿舍的水电费信息

返回类型

EnergyFees

static from_dict(data: dict[str, typing.Any], is_huxi: bool) mycqu.card.EnergyFees

从反序列化的(一个)水电费 json 中获取水电费信息

参数
  • data (dict[str, Any]) – json 反序列化得到的字典

  • is_huxi (bool) – 目标寝室是否在虎溪校区

返回

学期信息对象

返回类型

EnergyFees

subsidies: Optional[float]

补助余额(仅老校区拥有)

water_subsidy: Optional[float]

水剩余补助(仅虎溪校区拥有)