""" Tests of ModelAdmin validation logic. """ from django.db import models class Album(models.Model): title = models.CharField(max_length=150) class Song(models.Model): title = models.CharField(max_length=150) album = models.ForeignKey(Album) class Meta: ordering = ('title',) def __unicode__(self): return self.title def readonly_method_on_model(self): # does nothing pass class TwoAlbumFKAndAnE(models.Model): album1 = models.ForeignKey(Album, related_name="album1_set") album2 = models.ForeignKey(Album, related_name="album2_set") e = models.CharField(max_length=1) class Author(models.Model): name = models.CharField(max_length=100) class Book(models.Model): name = models.CharField(max_length=100) subtitle = models.CharField(max_length=100) price = models.FloatField() authors = models.ManyToManyField(Author, through='AuthorsBooks') class AuthorsBooks(models.Model): author = models.ForeignKey(Author) book = models.ForeignKey(Book) __test__ = {'API_TESTS':""" >>> from django import forms >>> from django.contrib import admin >>> from django.contrib.admin.validation import validate, validate_inline # Regression test for #8027: custom ModelForms with fields/fieldsets >>> class SongForm(forms.ModelForm): ... pass >>> class ValidFields(admin.ModelAdmin): ... form = SongForm ... fields = ['title'] >>> class InvalidFields(admin.ModelAdmin): ... form = SongForm ... fields = ['spam'] >>> validate(ValidFields, Song) >>> validate(InvalidFields, Song) Traceback (most recent call last): ... ImproperlyConfigured: 'InvalidFields.fields' refers to field 'spam' that is missing from the form. # Regression test for #9932 - exclude in InlineModelAdmin # should not contain the ForeignKey field used in ModelAdmin.model >>> class SongInline(admin.StackedInline): ... model = Song ... exclude = ['album'] >>> class AlbumAdmin(admin.ModelAdmin): ... model = Album ... inlines = [SongInline] >>> validate(AlbumAdmin, Album) Traceback (most recent call last): ... ImproperlyConfigured: SongInline cannot exclude the field 'album' - this is the foreign key to the parent model Album. # Regression test for #11709 - when testing for fk excluding (when exclude is # given) make sure fk_name is honored or things blow up when there is more # than one fk to the parent model. >>> class TwoAlbumFKAndAnEInline(admin.TabularInline): ... model = TwoAlbumFKAndAnE ... exclude = ("e",) ... fk_name = "album1" >>> validate_inline(TwoAlbumFKAndAnEInline, None, Album) # Ensure inlines validate that they can be used correctly. >>> class TwoAlbumFKAndAnEInline(admin.TabularInline): ... model = TwoAlbumFKAndAnE >>> validate_inline(TwoAlbumFKAndAnEInline, None, Album) Traceback (most recent call last): ... Exception: has more than 1 ForeignKey to >>> class TwoAlbumFKAndAnEInline(admin.TabularInline): ... model = TwoAlbumFKAndAnE ... fk_name = "album1" >>> validate_inline(TwoAlbumFKAndAnEInline, None, Album) >>> class SongAdmin(admin.ModelAdmin): ... readonly_fields = ("title",) >>> validate(SongAdmin, Song) >>> def my_function(obj): ... # does nothing ... pass >>> class SongAdmin(admin.ModelAdmin): ... readonly_fields = (my_function,) >>> validate(SongAdmin, Song) >>> class SongAdmin(admin.ModelAdmin): ... readonly_fields = ("readonly_method_on_modeladmin",) ... ... def readonly_method_on_modeladmin(self, obj): ... # does nothing ... pass >>> validate(SongAdmin, Song) >>> class SongAdmin(admin.ModelAdmin): ... readonly_fields = ("readonly_method_on_model",) >>> validate(SongAdmin, Song) >>> class SongAdmin(admin.ModelAdmin): ... readonly_fields = ("title", "nonexistant") >>> validate(SongAdmin, Song) Traceback (most recent call last): ... ImproperlyConfigured: SongAdmin.readonly_fields[1], 'nonexistant' is not a callable or an attribute of 'SongAdmin' or found in the model 'Song'. >>> class SongAdmin(admin.ModelAdmin): ... readonly_fields = ("title", "awesome_song") ... fields = ("album", "title", "awesome_song") >>> validate(SongAdmin, Song) Traceback (most recent call last): ... ImproperlyConfigured: SongAdmin.readonly_fields[1], 'awesome_song' is not a callable or an attribute of 'SongAdmin' or found in the model 'Song'. >>> class SongAdmin(SongAdmin): ... def awesome_song(self, instance): ... if instance.title == "Born to Run": ... return "Best Ever!" ... return "Status unknown." >>> validate(SongAdmin, Song) >>> class SongAdmin(admin.ModelAdmin): ... readonly_fields = (lambda obj: "test",) >>> validate(SongAdmin, Song) # Regression test for #12203/#12237 - Fail more gracefully when a M2M field that # specifies the 'through' option is included in the 'fields' or the 'fieldsets' # ModelAdmin options. >>> class BookAdmin(admin.ModelAdmin): ... fields = ['authors'] >>> validate(BookAdmin, Book) Traceback (most recent call last): ... ImproperlyConfigured: 'BookAdmin.fields' can't include the ManyToManyField field 'authors' because 'authors' manually specifies a 'through' model. >>> class FieldsetBookAdmin(admin.ModelAdmin): ... fieldsets = ( ... ('Header 1', {'fields': ('name',)}), ... ('Header 2', {'fields': ('authors',)}), ... ) >>> validate(FieldsetBookAdmin, Book) Traceback (most recent call last): ... ImproperlyConfigured: 'FieldsetBookAdmin.fieldsets[1][1]['fields']' can't include the ManyToManyField field 'authors' because 'authors' manually specifies a 'through' model. >>> class NestedFieldsetAdmin(admin.ModelAdmin): ... fieldsets = ( ... ('Main', {'fields': ('price', ('name', 'subtitle'))}), ... ) >>> validate(NestedFieldsetAdmin, Book) # Regression test for #12209 -- If the explicitly provided through model # is specified as a string, the admin should still be able use # Model.m2m_field.through >>> class AuthorsInline(admin.TabularInline): ... model = Book.authors.through >>> class BookAdmin(admin.ModelAdmin): ... inlines = [AuthorsInline] # If the through model is still a string (and hasn't been resolved to a model) # the validation will fail. >>> validate(BookAdmin, Book) # Regression for ensuring ModelAdmin.fields can contain non-model fields # that broke with r11737 >>> class SongForm(forms.ModelForm): ... extra_data = forms.CharField() ... class Meta: ... model = Song >>> class FieldsOnFormOnlyAdmin(admin.ModelAdmin): ... form = SongForm ... fields = ['title', 'extra_data'] >>> validate(FieldsOnFormOnlyAdmin, Song) """}