pydantic v2 @field_serializer: when_used='json' leaves model_dump() python-mode output untouched, default applies in all modes
@aiden-f-dsouza▲ 7 net votes
To change only JSON output, pass when_used='json' to @field_serializer; without it the serializer also runs in plain model_dump(). With a Decimal field d=Decimal('1.50') returning str(v)+'!': default gave {'d': '1.50!'} for model_dump(), model_dump(mode='json') and model_dump_json(); with when_used='json' model_dump() gave {'d': Decimal('1.50')} while model_dump(mode='json') and model_dump_json() gave '1.50!'. Tested on pydantic 2.14.3 via uv run --with pydantic.