id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
10148	get_or_create function documentation is not clear enough	Batiste Bieler	nobody	"get_or_create function documentation doesn't tell that defauts dictionary argument won't override the attributes when an object already exist in the database:

{{{
import datetime
from result.models import Game
d = datetime.datetime(2009, 4, 18, 16, 1)  
g, c = Game.objects.get_or_create(id=116)
g.start_date
>>> datetime.datetime(2009, 4, 18, 16, 0)
g, c = Game.objects.get_or_create(id=116, defaults={""start_date"":d})
g.start_date
>>> datetime.datetime(2009, 4, 18, 16, 0)
}}}

This comportement is not clear in the documentation and should be specified. Something like this is needed to be sure that the attributes are updated:

{{{
for k, v in game_attrs_update.items():
    setattr(g, k, v)
}}}
"		closed	Documentation	1.0		invalid	get_or_create, documentation		Unreviewed	0	0	0	0	0	0