Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

Frozen dict cannot use flatten, unflatten, subset or filter

已关闭
#613 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 2 天内回复

已经有一个关联 PR 被合并了。

  • #614 来自 @itzzdev09 —— 已合并

评估

难度
3/5
预计耗时
1-2 天
新手友好度
78/100
Issue 类型
缺陷
描述清晰度
描述清楚
活跃度
活跃
技术栈
python
领域
backend

调研方向

Start with core/clone.py, especially the empty=True path and BaseDict.deepcopy, then inspect the affected call sites in core/filter.py, core/flatten.py, core/invert.py, core/subset.py, and core/unflatten.py. Done means these derivation methods work on frozen dictionaries without modifying the source, while ordinary clone() remains frozen.

由索引模型根据 Issue 内容生成。

描述

Summary

flatten, unflatten, subset and filter raise TypeError on a frozen dict, although all four are documented as returning a new dict and none of them mutate the source.

from benedict import benedict

d = benedict({"a": 1, "nested": {"x": 1}}).freeze()

d.flatten()
# TypeError: 'benedict' object is frozen and cannot be modified.

clone, keypaths, search, match, groupby and to_json all work fine on the same frozen dict, so the behaviour is inconsistent — freezing blocks some read-only derivations but not others.

method mutates source on a frozen dict
clone no works
keypaths, search, match, groupby, to_json no works
flatten no TypeError
unflatten no TypeError
subset no TypeError
filter no TypeError

Cause

All four build their result with clone(d, empty=True). In benedict/core/clone.py:

d = copy.deepcopy(obj, memo)
if empty and isinstance(d, MutableMapping):
    d.clear()
return d

BaseDict.__deepcopy__ deliberately carries the frozen flag over:

if self._frozen:
    obj.freeze()

so the deep copy is frozen, and the following clear() hits _check_frozen() and raises. The exception therefore comes from the throwaway internal copy rather than from the dict the caller passed in — which is why the error message is a little misleading too.

Plain clone() is unaffected because it never clears.

Affected call sites: core/filter.py (x2), core/flatten.py, core/invert.py, core/subset.py, core/unflatten.py.

Expected

Freezing is meant to prevent modification of the dict. Deriving a new dict from it is a read, so it should be allowed, the way clone() already is. This matters for the obvious use of freeze() — holding an immutable config and taking subsets or flattened views of it.

Notes

Propagating frozen through __deepcopy__ looks intentional and worth keeping: a full clone() of an immutable dict staying immutable is reasonable. The issue is only the empty=True path, where the copy is emptied and refilled, so the source's frozen state has no meaning.

Reproduced on main at e9641ec, Python 3.12. PR follows.

主要语言
Python
星标
1.6k
派生
63
平均合并
1 天 23 小时
30 天内合并 PR
21

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

fabiocaccamo/python-benedict 的其他 Issue

查看 fabiocaccamo/python-benedict 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。