drf-universal-api-test-mixins 0.1.0

Универсальные миксины для тестирования DRF API

DRF Universal API Test Mixins

Универсальные миксины для автоматизации тестирования REST API на Python/Django REST Framework.

Описание

Этот пакет содержит три миксина, которые:

• Сокращают количество ручного кода в тестах
• Увеличивают покрытие тестами
• Облегчают поддержку тестов при изменениях в проекте
• Могут применяться в любом проекте на Django/DRF

Основные миксины

1. CRUDAPITestMixin
   Автоматизирует тесты для CRUD-эндпоинтов: проверяет разрешённые/запрещённые HTTP-методы, разрешение URL, аутентификацию, поведение при пустых данных.

2. ResponseStructureMixin
   Проверяет структуру и содержимое ответов API для list/retrieve-запросов.

3. ValidationErrorTestMixin
   Стандартизирует проверку ошибок валидации для POST/PUT/PATCH-запросов.

Пример использования

from mixins import CRUDAPITestMixin, ResponseStructureMixin
from rest_framework.test import APITestCase

class MyModelListView:
   ...


class MyModelAPITestCase(CRUDAPITestMixin, ResponseStructureMixin, APITestCase):
    list_url_name = "my-model-list"
    list_view_class = MyModelListView
    allowed_list_methods = ["get"]
    model = MyModel
    expected_item_fields = {"id", "name", "created_at"}

    def setUp(self):
        MyModel.objects.create(name="Test 1")
        MyModel.objects.create(name="Test 2")

Установка

Пакет можно устанавливать как через Poetry, так и через pip.

Через Poetry

poetry add drf-universal-api-test-mixins

Через pip

pip install drf-universal-api-test-mixins

или напрямую из репозитория:

pip install git+https://github.com/Altair788/drf-universal-api-test-mixins.git

Почему это удобно?

• Миксины универсальны — подходят для любого DRF-проекта.
• Минимум кода — только настройка атрибутов и минимум ручных тестов.
• Лёгкая поддержка — изменения в API требуют правки только в одном месте.

Автор: Eduard Slobodyanik
Telegram: @eslobodyanik
GitHub: Altair788

Дополнительно (по желанию)

• Можно добавить раздел "Лицензия" (например, MIT).
• Можно добавить "Системные требования" (Python >= 3.12, Django >= 5.2.4, DRF >= 3.16.0).
• Можно добавить "Contributing" — как предлагать улучшения.

Ваш README уже отлично подходит для публикации и использования!
Если потребуется расширенный шаблон или дополнительные разделы — дайте знать!