Verstehen von `tests.py` für Django-Entwickler

Wenn man eine Django-App erstellt, wird automatisch auch eine tests.py erstellt.
Die meisten Entwickler haben einmal diese Gedanken.

„Kann man diese Datei… einfach löschen?“
„Wie wird sie überhaupt genutzt?“

Tatsächlich ist tests.py der offiziell empfohlene Einstiegspunkt für Tests in Django, und
wenn man sich ein wenig daran gewöhnt, wird es bei Refactorings, Funktionshinzufügungen und Versionsupdates eine echte große Versicherung. (Django-Projekt)

In diesem Beitrag werden wir:

• Was ist die Funktion von tests.py?

• Wie man es schreibt und ausführt

• In welchen Situationen es besonders nützlich ist

• Beispiele aus der Praxis

alles auf einen Blick zusammenfassen.

1. Was ist tests.py?

Django verwendet ein Test-Framework, das auf der unittest-Standardbibliothek von Python basiert.

• Erstelle Testklassen, die von django.test.TestCase erben, und

• schreibe Methoden, die mit test_ beginnen

• und diese werden automatisch mit dem Befehl ./manage.py test gefunden und ausgeführt.

Wenn du mit startapp eine App erstellst, wird standardmäßig tests.py erstellt:

• Kleine Projekte → genügt ein tests.py

• Bei größeren Projekten → wird empfohlen, in ein tests/-Paket zu splitten (test_models.py, test_views.py usw.)

Das heißt, du kannst es als „den Basissitz für tests der App“ verstehen.

2. Wann ist es nützlich? (Warum sollte man Tests verwenden?)

Django-Tests sind besonders in den folgenden Situationen wertvoll.

1. Überprüfung von Modellen/Geschäftslogik

   • Je komplizierter die Berechnung, Statusänderungen und benutzerdefinierte Methoden sind,

   • kann man nach einmaligem Testen mit besserem Gefühl refactoren.

2. Überprüfung von Views/URLs/Berechtigungen

   • Unterscheidet sich der Antwortcode basierend auf der Authentifizierung?

   • Wird bei falschen Eingaben korrekt weitergeleitet bzw. Fehler behandelt?

   • Wird der benötigte Kontext für die Templates korrekt übermittelt?

3. Verhinderung von Rückschritt-Bugs

   • Wenn ein Bug einmal behoben ist, sollte er mit einem Test festgehalten werden, damit das gleiche Problem nicht erneut auftritt.

4. Gewährleistung der Stabilität bei Versionsupdates

   • Wenn die Django-Version oder die Bibliotheksversion aktualisiert wird,

   • kannst du sicherstellen, dass du mit ./manage.py test prüfst.

3. Ein grundlegendes Beispiel für tests.py

3-1. Modell-Test

# myapp/tests.py
from django.test import TestCase
from .models import Article

class ArticleModelTests(TestCase):
    def setUp(self):
        self.article = Article.objects.create(
            title="Testtitel",
            content="Inhalt",
            views=0,
        )

    def test_increase_views(self):
        # gegeben
        self.assertEqual(self.article.views, 0)

        # wenn
        self.article.increase_views()

        # dann
        self.assertEqual(self.article.views, 1)

• TestCase ist eine Klasse für Django, die unittest.TestCase erweitert.

• Jeder Test wird isoliert auf Transaktionsebene durchgeführt, und die Datenbank wird für jeden Test zurückgerollt, sodass sie sich nicht beeinflussen.

4. Wie man Views/URLs testet – Verwendung von Client

Django stellt einen HTTP-Client für Tests zur Verfügung: django.test.Client.
Damit kannst du GET/POST-Anfragen an URLs senden und die Antworten überprüfen, ohne einen tatsächlichen Server zu starten.

4-1. Einfacher View-Test

# myapp/tests.py
from django.test import TestCase
from django.urls import reverse
from .models import Article

class ArticleViewTests(TestCase):
    def setUp(self):
        self.article = Article.objects.create(
            title="Beitrag 1",
            content="Inhalt",
            views=0,
        )

    def test_article_detail_page_returns_200(self):
        url = reverse("article_detail", args=[self.article.id])

        response = self.client.get(url)

        self.assertEqual(response.status_code, 200)
        self.assertContains(response, "Beitrag 1")

Der Schlüssel ist hier:

• self.client : eine Test Client-Instanz, die standardmäßig in TestCase bereitgestellt wird

• reverse("article_detail", args=[...]) : vergangene URLs operiert als URL-Namen anstelle von Hardcodierungen

• assertContains : überprüft, ob ein bestimmter String im Antwortkörper enthalten ist.

4-2. Testen von Login/Berechtigungen

from django.contrib.auth import get_user_model

class ArticlePermissionTests(TestCase):
    def setUp(self):
        self.user = get_user_model().objects.create_user(
            username="tester",
            password="pass1234",
        )
        self.article = Article.objects.create(
            title="geheim",
            content="Geheimtext",
            views=0,
        )

    def test_anonymous_user_redirected_to_login(self):
        url = reverse("article_edit", args=[self.article.id])

        response = self.client.get(url)

        self.assertEqual(response.status_code, 302)
        self.assertIn("/accounts/login", response["Location"])

    def test_logged_in_user_can_access_edit_page(self):
        self.client.login(username="tester", password="pass1234")
        url = reverse("article_edit", args=[self.article.id])

        response = self.client.get(url)

        self.assertEqual(response.status_code, 200)

$ python manage.py test

$ python manage.py test myapp

# Module myapp.tests komplett
$ python manage.py test myapp.tests

# Bestimmtes TestCase
$ python manage.py test myapp.tests.ArticleViewTests

# Bestimmte Testmethode
$ python manage.py test myapp.tests.ArticleViewTests.test_article_detail_page_returns_200

myapp/
    tests/
        __init__.py
        test_models.py
        test_views.py
        test_forms.py
        test_api.py

# myapp/tests/test_models.py
from django.test import TestCase
from myapp.models import Article

class ArticleModelTests(TestCase):
    ...

$ python manage.py test myapp   # alles
$ python manage.py test myapp.tests.test_models  # nur Modelle-Tests

class ArticleApiTests(TestCase):
    def setUp(self):
        self.article = Article.objects.create(
            title="API Titel",
            content="Inhalt",
            views=0,
        )

    def test_article_detail_api_response(self):
        url = reverse("api:article-detail", args=[self.article.id])

        response = self.client.get(url)
        self.assertEqual(response.status_code, 200)

        data = response.json()
        self.assertEqual(data["id"], self.article.id)
        self.assertIn("title", data)
        self.assertIn("content", data)

from .forms import ArticleForm

class ArticleFormTests(TestCase):
    def test_title_is_required(self):
        form = ArticleForm(data={"title": "", "content": "Inhalt"})

        self.assertFalse(form.is_valid())
        self.assertIn("title", form.errors)

    def test_valid_form(self):
        form = ArticleForm(data={"title": "Titel", "content": "Inhalt"})

        self.assertTrue(form.is_valid())