= NewbieMistakes =

Please feel free to share the things that tripped you up when you started with Django. We'll try to improve Django's error handling to catch such mistakes in the future.

== URLconf include() misbehaving ==

==== Symptom ====

You're trying to get your URLconf files to work, but getting cryptic errors about how there is no module 'index' (where 'index' is some function you are trying to assign as a view), or module 'foo' has no attribute 'urlpatterns'.

==== Probable cause ====

You may have tried to load your view files using include() in the URLconf file (in tutorial 3, this is myproject/settings/urls/main.py). The include() call assumes that the file it's loading is also a URLconf file.

==== Solution ====

Remove the include(). Just give the module and function name (e.g., {{{'myproject.apps.polls.views.polls.index'}}}) as a string, with no include() around it.


== Blank object names ==

==== Symptom ====

The automatic admin interface is showing nothing (or a single {{{ }}}) in the "Select [object_type] to change" view.

==== Probable cause ====

You may have forgotten to create a {{{__repr__()}}} function for your model. Django calls {{{__repr__()}}} to find out how to display objects in the admin interface.

==== Solution ====

Add a {{{__repr__()}}} function to all your models. Make it a habit so it becomes automatic.

== Integer & NULLS ==

==== Problem ====

When you have a Field: current_zip = meta.IntegerField(maxlength=5,blank=True)

django will create a not nullable field in the DB.  However leaving the field blank (in admin/web) django will try and insert a NULL value in the DB.

==== Solution ====

Add null=True:

current_zip = meta.IntegerField(maxlength=5,null=True,blank=True)


== Appending to a list in session doesn't work ==

==== Problem ====

If you have a list in your session, append operations don't get saved to the object.  

==== Solution ====

Copy the list out of the session object, append to it, then copy it back in:

{{{
sessionlist = request.session['my_list']
sessionlist.append(new_object)
request.session['my_list'] = sessionlist
}}}

== Errors about undefined attributes with one-char names ==

==== Problem ====

You get an !AttributeError with some weird attribute name that's only one char long. You don't have that attribute name anywhere in your code.

==== Solution ====

Search your model and code for situations where you have to pass a tuple of values and want to pass a tuple with one element - and that element is a string like in this sample:

{{{
#!python
class META:	
    ...
    admin = meta.Admin(
        list_display = ('total_price'),
        ...
    )
}}}

It's a standard python error - you are just missing a comma in the list_display assignement like this:

{{{
#!python
class META:	
    ...
    admin = meta.Admin(
        list_display = ('total_price',),
        ...
    )
}}}

Since a tuple is expected but a string provided, the code will merrily iterate over the characters of the string instead of the tuple elements - and that's where the single-char attribute names come from.