读懂别人的类 —— 看懂库文档和源码片段的能力

from datetime import date

# 一问：怎么造？—— date(年, 月, 日)
d = date(2026, 7, 9)

# 二问：它有什么？—— 属性是名词，直接读，不带括号
print(d.year, d.month, d.day)

# 三问：它会什么？—— 方法是动词，带括号调用
print(d.weekday())        # 星期几（周一是 0）
print(d.isoformat())      # 转成标准字符串
print(d.replace(month=12))  # 换个月份，返回"新对象"，原对象不变
print(d)                  # 打印很友好？说明人家实现了 __str__

from datetime import date

today = date.today()    # 从"类"上直接调用，帮你造一个"今天"的对象
print(today)
print(type(today))      # 造出来的仍是 date 对象

from datetime import date

d = date(2026, 7, 9)

# dir()：列出这个对象的全部属性和方法（忽略 __ 开头的钩子）
members = [m for m in dir(d) if not m.startswith("_")]
print(members)

# help()：看某个方法的说明书（docstring 在此显灵）
help(d.weekday)

class RateLimiter:
  """限流器：max_calls 次配额，用完拒绝"""

  def __init__(self, name, max_calls=3):
      self.name = name
      self.max_calls = max_calls
      self.used = 0

  def hit(self):
      if self.used >= self.max_calls:
          return False
      self.used = self.used + 1
      return True

  def remaining(self):
      return self.max_calls - self.used

  def __str__(self):
      return f"[{self.name}] 剩余 {self.remaining()}/{self.max_calls}"


# 读完再运行验证你的答案：
api = RateLimiter("翻译接口", max_calls=2)
for i in range(3):
  ok = api.hit()
  print(f"第 {i + 1} 次调用：{'通过' if ok else '被限流'}，{api}")

s = "12345"

# 你的代码写在下面

# 按文档实现的 Alarm 已就位（真实场景中这部分在库里，你看不到也不用看）
class Alarm:
  def __init__(self, hour, minute=0):
      self.hour = hour
      self.minute = minute

  def snooze(self, minutes=10):
      total = self.hour * 60 + self.minute + minutes
      self.hour = (total // 60) % 24
      self.minute = total % 60

  def display(self):
      return f"{self.hour:02d}:{self.minute:02d}"


# 你的代码写在下面：造 8:30 的闹钟 → 推迟一次默认时长 → 再推迟 25 分钟 → 打印

# 审查并修改下面的类
class ShoppingCart:
  def __init__(self, owner):
      self.owner = owner

  def add(self, item, price):
      if not hasattr(self, "items"):   # 第一次 add 时才创建 items
          self.items = []
      self.items.append((item, price))

  def Total(self):
      return sum(p for _, p in self.items)


cart = ShoppingCart("小雨")
cart.add("键盘", 299)
cart.add("鼠标", 89)
print(cart.Total())