Testy

prawie jednostkowe w Django

Przemek Lewandowski

@haxoza

O mnie

Przegląd prezentacji

• Dlaczego testy jednostkowe
• Testowanie z Django
  • Narzędzia
  • Problemy
• Djet na ratunek
  • Przegląd
  • Przykłady
• Jak zacząć z Djet

Testy jednostkowe

• Wczesne wykrywanie błędów
• Odeseparowują implementacje
• Szybkie w wykonaniu
• Żywa dokumentacja

Testowanie w Django

• Modele
• Formulrze
• Widoki
• ...

Testowanie widoków

• django.tests.TestCase

• django.tests.Client

• django.tests.RequestFactory

django.tests.TestCase

• Dodatkowe asercje
• Wczytywanie fixture-ów
• Każdy test jako transakcja
• Tworzy instancję django.tests.Client

django.tests.testcases

Django fixtures

factory_boy

https://github.com/rbarrois/factory_boy

django.tests.Client

• Udaje przeglądarkę
• Integruje się z django.contrib.auth
• Przechodzi przez wszystkie
  warstwy Django
• Do testów integracyjnych

Django Middlewares

django.tests.RequestFactory

• Samodzielnie wywołanie widoku 
• Omijamy middleware-y
• Nadzieja na testy jednostkowe
• Trudne w użyciu

Problemy 

• Testy integracyjne widoków
• Wszystkie warstwy aplikacji
• Mocne związanie komponentów
• Narzut middleware-ów
• Domyślny FileStorage pisze po dysku

Djet

na ratunek

Django Extended Tests

https://github.com/sunscrapers/djet

Cechy Djet

• Pozwala łatwo testować jednostkowo widoki
• Wspiera widoki klasowe i funkcyjne
• Uruchamia tylko podane middleware-y
• Wspiera autoryzację django.contrib.auth

Djet w akcji

class YourViewTest(assertions.StatusCodeAssertionsMixin,
                   assertions.MessagesAssertionsMixin,
                   testcases.ViewTestCase):
    view_class = YourView
    view_kwargs = {'some_kwarg': 'value'}
    middleware_classes = [
        SessionMiddleware,
        (MessageMiddleware, testcases.MiddlewareType.PROCESS_REQUEST),
    ]

    def test_post_should_redirect_and_add_message_when_next_parameter(self):
        user = UserFactory()
        request = self.factory.post(data={'next': '/'}, user=user)

        response = self.view(request)

        self.assert_redirect(response, '/')
        self.assert_message_exists(request, messages.SUCCESS, 'Success!')

Cechy Djet - cd.

• Ułatwia operacje na plikach
• Integruje się z Django Rest Framework
• Zawiera dodatkowe asercje
• Jeszcze więcej asercji

Djet combo

class TestModel(models.Model):
    field = models.CharField(max_length=100)
    file = models.FileField(upload_to='files')

class CreateAPIView(generics.CreateAPIView):
    model = models.TestModel

class CreateAPIViewTest(assertions.StatusCodeAssertionsMixin,
                        files.InMemoryStorageMixin,
                        restframework.APIViewTestCase):
    view_class = CreateAPIView

    def test_post_should_create_model(self):
        data = {
            'field': 'test value',
            'file': files.create_inmemory_file('test.txt', content=b'Hello multipart!'),
        }
        request = self.factory.post(data=data, format='multipart')

        response = self.view(request)

        self.assert_status_equal(response, status.HTTP_201_CREATED)

Asercje w Djet

• response status codes (StatusCodeAssertionsMixin)
• emails (EmailAssertionsMixin)
• messages (MessagesAssertionsMixin)
• model instances (InstanceAssertionsMixin)

Dlaczego używać Djet?

• Zwięzły kod testujący widoki
• Szybsze wykonanie testów
• Naprawiony domyślny
  FileStorage w testach
• Wiele funkcji pomocniczych

Co dalej?

pip install djet

Django >= 1.3

Python >= 2.6

Fork & pull request

Zadowoleni użytkownicy

Contributors

Inspiracje

• http://pyvideo.org/video/699/testing-and-django
• http://www.rkblog.rk.edu.pl/w/p/temporary-files-django-tests-and-fly-file-manipulation/
• http://www.django-rest-framework.org/api-guide/testing
• https://docs.djangoproject.com/en/dev/topics/testing/

Python Developer

Wanted

http://startupworks.co/kariera/

Dziękuję!

Pytania?

https://github.com/sunscrapers/djet