本文介绍一种轻量级、高性能的 AttrView 类，用于创建对对象列表中指定属性的实时只读视图，使 random.choices() 能自动感知属性变更，避免重复构建权重列表。
本文介绍一种轻量级、高性能的 `attrview` 类，用于创建对对象列表中指定属性的实时只读视图，使 `random.choices()` 能自动感知属性变更，避免重复构建权重列表。
在使用 random.choices() 进行加权随机抽样时，若权重来源于对象的可变属性（如 champ.odds），直接预生成 list_odds = [c.odds for c in champs] 会导致权重与对象状态脱节——修改 champ.odds 后，原权重列表不会自动更新，必须手动同步，既易出错又违背 Python 的“显式优于隐式”原则。
理想方案是提供一个惰性、动态、只读的属性视图：它不复制数据，不缓存值，而是在每次访问（如索引或迭代）时实时读取对象当前属性值。这正是 AttrView 的设计目标。
以下是完整、生产就绪的 AttrView 实现（兼容 Python 3.12+，向下兼容 3.9+）：
from collections.abc import Sequence
from typing import overload, Any, TypeVar, Generic
T = TypeVar('T')
class AttrView(Generic[T], Sequence[T]):
def __init__(self, seq: Sequence[Any], attr: str):
self._seq = seq
self._attr = attr
@overload
def __getitem__(self, index: int) -> T:
...
@overload
def __getitem__(self, index: slice) -> list[T]:
...
def __getitem__(self, index):
if isinstance(index, slice):
return [getattr(item, self._attr) for item in self._seq[index]]
return getattr(self._seq[index], self._attr)
def __len__(self) -> int:
return len(self._seq)
def __repr__(self) -> str:
return f"AttrView({self._seq!r}, {self._attr!r})"
✅ 关键特性说明：
- ✅ 零拷贝 & 零延迟：不预先计算或存储任何值，每次 weights[i] 都实时调用 getattr(champ, 'odds')；
- ✅ 完全兼容 random.choices()：AttrView 实现了 Sequence 协议（__len__ 和 __getitem__），被 random.choices 视为合法权重序列；
- ✅ 支持切片与索引：可用于调试、子集采样等场景；
- ✅ 类型安全（配合类型提示）：泛型 T 确保 IDE 和静态检查器能正确推导返回类型（如 float）。
? 使用示例：
import random
class Champ:
def __init__(self, odds: float):
self.odds = odds
def __repr__(self):
return f"Champ(odds={self.odds})"
# 初始化选手列表与动态权重视图
champs = [Champ(0.25), Champ(0.5)]
weights = AttrView[float](champs, "odds") # 显式类型注解提升可读性
# 首次采样（按初始 odds）
print("Initial draw:", random.choices(champs, weights=weights, k=5))
# → 可能输出: [Champ(odds=0.25), Champ(odds=0.5), ...]
# 动态更新某选手 odds
champs[0].odds = 0.99
# 再次采样 —— weights 自动反映新值！无需任何额外操作
print("After update:", random.choices(champs, weights=weights, k=5))
# → 此时 champ0 被选中的概率显著升高
⚠️ 注意事项：
- AttrView 是只读视图，不支持赋值（如 weights[0] = 1.0 会报 TypeError），符合其设计初衷；
- 属性名必须存在且为公共属性（不支持 @property 的 setter 逻辑，但支持 getter）；若属性不存在，首次访问对应索引时抛出 AttributeError；
- 性能上，单次访问开销 ≈ 一次 getattr() 调用，远低于重建整个列表（O(n) → O(1)），尤其在 champs 规模大、更新频繁时优势明显；
- 如需支持 @property 或复杂计算逻辑，可将 AttrView 扩展为 CallableView，传入 lambda 代替属性名（如 lambda c: c.effective_odds()）。
总结：AttrView 是一个简洁、符合 Python 哲学的通用工具——它用最少的代码解决了对象属性与权重解耦的核心痛点，兼顾性能、可维护性与可读性，推荐作为加权随机系统的基础组件复用。
