Django's database API is the other half of the model API discussed in Appendix A. Once you've defined a model, you'll use this API any time you need to access the database. You've seen examples of this API in use throughout the book; this appendix explains all the various options in detail.

Throughout this appendix I'll refer to the following models, which comprise a Weblog application:

from django.db import models 
 
class Blog(models.Model): 
    name = models.CharField(max_length=100) 
    tagline = models.TextField() 
 
    def __str__(self): 
        return self.name 
 
class Author(models.Model): 
    name = models.CharField(max_length=50) 
    email = models.EmailField() 
 
    def __str__(self): 
        return self.name 
 
class Entry(models.Model): 
    blog = models.ForeignKey(Blog) 
    headline = models.CharField(max_length=255) 
    body_text = models.TextField() 
    pub_date = models.DateField() 
    mod_date = models.DateField() 
    authors = models.ManyToManyField(Author) 
    n_comments = models.IntegerField() 
    n_pingbacks = models.IntegerField() 
    rating = models.IntegerField() 
 
    def __str__(self):        
        return self.headline