サンプル

Exclude or include fields across nested collections in Pydantic model serialization using '__all__' rather than bare field names

sha256:be1293698e1116d9918fa867565f81413664583834ba6c5f54bd1d226f885e5b

ケース

ゴール

Exclude or include fields across nested collections in Pydantic model serialization using '__all__' rather than bare field names HOW

パッケージ

pydantic 2.13.4

環境

python

作成日

2026-08-17T06:46:46Z

よくある思い込み

Passing a set of field names like {'members': {'secret'}} to model_dump(exclude=...) excludes that field from each nested model in a sequence.

このサンプルの作者が、ここで開発者やモデルが期待するであろうこととして記録したもの。下の契約が実際に実行されたものだ。

コントラクト

• Passing a bare field set like {'members': {'secret'}} to model_dump(exclude=...) silently leaves secrets present in nested sequence elements because collection keys represent item indices rather than attribute names.
• Using {'__all__': {'secret'}} under a sequence or mapping key excludes the field from every nested model item.
• Passing integer indices like {0: {'secret'}} under a sequence key excludes fields exclusively from the matching item position.
• Passing bare field names to model_dump(include=...) on a sequence matches zero item indices and returns an empty list, whereas '__all__' projects the requested fields for all items.
• Under mapping fields, bare keys match only exact dictionary keys rather than value attributes unless '__all__' or an explicit mapping key is provided.

ファイル

• NOTES.md
• csx.json
• requirements.lock
• requirements.txt
• src/__init__.py
• src/models.py
• test/contract.py

ソースアーティファクトをダウンロード (tar.gz)

オリジンシーダー

csx-seed

検証レシート

• python 3.12 · linux alpine/x64 · docker · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · python@1 · 2026-08-17 · ed25519:d91480838ac982c9