frozenlist

Matrix Space — #aio-libs-space:matrix.org

引言

frozenlist.FrozenList 是一个列表状结构，它实现了 collections.abc.MutableSequence。该列表在调用 FrozenList.freeze 之前是可变的，之后任何对列表的修改都会引发 RuntimeError：

>>> from frozenlist import FrozenList
>>> fl = FrozenList([17, 42])
>>> fl.append('spam')
>>> fl.append('Vikings')
>>> fl
<FrozenList(frozen=False, [17, 42, 'spam', 'Vikings'])>
>>> fl.freeze()
>>> fl
<FrozenList(frozen=True, [17, 42, 'spam', 'Vikings'])>
>>> fl.frozen
True
>>> fl.append("Monty")
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "frozenlist/_frozenlist.pyx", line 97, in frozenlist._frozenlist.FrozenList.append
    self._check_frozen()
  File "frozenlist/_frozenlist.pyx", line 19, in frozenlist._frozenlist.FrozenList._check_frozen
    raise RuntimeError("Cannot modify frozen list.")
RuntimeError: Cannot modify frozen list.

FrozenList 也是可散列的，但仅当其被冻结时。否则，它也会抛出 RuntimeError：

>>> fl = FrozenList([17, 42, 'spam'])
>>> hash(fl)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "frozenlist/_frozenlist.pyx", line 111, in frozenlist._frozenlist.FrozenList.__hash__
    raise RuntimeError("Cannot hash unfrozen list.")
RuntimeError: Cannot hash unfrozen list.
>>> fl.freeze()
>>> hash(fl)
3713081631934410656
>>> dictionary = {fl: 'Vikings'} # frozen fl can be a dict key
>>> dictionary
{<FrozenList(frozen=True, [1, 2])>: 'Vikings'}

安装

$ pip install frozenlist

文档

https://frozenlist.aio-libs.org

沟通渠道

我们有一个Matrix Space #aio-libs-space:matrix.org，也可以通过 Gitter 访问。

许可证

frozenlist 以 Apache 2 许可证提供。

源代码

该项目托管在 GitHub

如果您发现了一个 bug 或有什么改进库的建议，请在 bug 跟踪器中提交 issue。