# Should \`frozendict\` be added to Argument Clinic?

**URL:** <https://discuss.python.org/t/should-frozendict-be-added-to-argument-clinic/106237>\
**Category:** Core Development\
**Created:** [February 21, 2026, 4:40pm UTC](https://discuss.python.org/t/should-frozendict-be-added-to-argument-clinic/106237 "2026-02-21T16:40:34Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![bswck](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/bswck/32/34363_2.png) [@bswck](https://discuss.python.org/u/bswck)\
**Post date:** [February 21, 2026, 4:40pm UTC](https://discuss.python.org/t/should-frozendict-be-added-to-argument-clinic/106237/1 "2026-02-21T16:40:34Z")

</div>

Do you have any use case for adding it?

We already have a `set` and `frozenset` pair, and we have `dict`. It is symmetrical to add `&PyFrozenDict_Type` alongside `&PyDict_Type`, but do you think it would be useful?

I’m just wondering.

---

<div class="post-metadata">

**Author:** ![steve.dower](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/steve.dower/32/56_2.png) [@steve.dower](https://discuss.python.org/u/steve.dower)\
**Post date:** [February 23, 2026, 12:19pm UTC](https://discuss.python.org/t/should-frozendict-be-added-to-argument-clinic/106237/2 "2026-02-23T12:19:03Z")

</div>

Presumably if we have APIs that only accept an instance of a frozen dict, then it needs to be available as an argument type. I’d expect some\[1\] of those APIs are going to be part of `frozendict` itself (to accept `self`).

This isn’t really a “should” question - if it’s needed, and I think it is, it’ll be done. If it’s not needed, why would we?

* * *

1. Hedging here, I really expect _all_ of those APIs to be part of `frozendict`, and everywhere else we won’t be so strict. Functions expecting dict-like objects will have to be relaxed to accept “things that behave like mappings”.

---

<div class="post-metadata">

**Author:** ![storchaka](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/storchaka/32/217_2.png) [@storchaka](https://discuss.python.org/u/storchaka)\
**Post date:** [February 23, 2026, 8:10pm UTC](https://discuss.python.org/t/should-frozendict-be-added-to-argument-clinic/106237/3 "2026-02-23T20:10:17Z")

</div>

Note that neither `set`, nor `frozenset` converters are used in the current code (except tests for converters). The `tuple`, `list` and `dict` converters are used a dozen or two times each.

It is likely that we will need to replace some occurrences of the `dict` converter with the converter that accepts `dict` and `frozendict`. But the current syntax just does not support this, and there is no way to extend it. So it will likely be replaced with a simple `object` converter and an explicit check in the code. It was just a syntax sugar.
