Jeffallan/claude-skills / skills/django-expert
django-expert
VerifiedUse when building Django web applications or REST APIs with Django REST Framework. Invoke when working with settings.py, models.py, manage.py, or any Django project file. Creates Django models with proper indexes, optimizes ORM queries using select_related/prefetch_related, builds DRF serializers and viewsets, and configures JWT authentication. Trigger terms: Django, DRF, Django REST Framework, Django ORM, Django model, serializer, viewset, Python web.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.1 KB |
| references/authentication.md | markdown | 3.9 KB |
| references/drf-serializers.md | markdown | 4.0 KB |
| references/models-orm.md | markdown | 3.8 KB |
| references/testing-django.md | markdown | 5.4 KB |
| references/viewsets-views.md | markdown | 4.2 KB |
references/testing-django.md
View on GitHub# Testing Django
## APITestCase
```python
from rest_framework.test import APITestCase
from rest_framework import status
from django.urls import reverse
class ProductAPITest(APITestCase):
def setUp(self):
self.user = User.objects.create_user(
email='test@example.com',
username='testuser',
password='<test-password>'
)
self.category = Category.objects.create(name='Tech', slug='tech')
self.product = Product.objects.create(
name='Laptop',
slug='laptop',
price=999.99,
stock=10,
category=self.category,
created_by=self.user
)
def test_list_products(self):
url = reverse('product-list')
response = self.client.get(url)
self.assertEqual(response.status_code, status.HTTP_200_OK)
self.assertEqual(len(response.data['results']), 1)
def test_create_product_authenticated(self):
self.client.force_authenticate(user=self.user)
url = reverse('product-list')
data = {
'name': 'Phone',
'price': 499.99,
'stock': 5,
'category_id': self.category.id
}
response = self.client.post(url, data)
self.assertEqual(response.status_code, status.HTTP_201_CREATED)
self.assertEqual(Product.objects.count(), 2)
def test_create_product_unauthenticated(self):
url = reverse('product-list')
response = self.client.post(url, {'name': 'Test'})
self.assertEqual(response.status_code, status.HTTP_401_UNAUTHORIZED)
```
## Model Tests
```python
from django.test import TestCase
from django.core.exceptions import ValidationError
class ProductModelTest(TestCase):
def setUp(self):
self.user = User.objects.create_user(
email='test@example.com',
username='test',
password='<test-password>'
)
self.category = Category.objects.create(name='Tech', slug='tech')
def test_product_creation(self):
product = Product.objects.create(
name='Test Product',
slug='test-product',
price=100,
category=self.category,
created_by=self.user
)
self.assertEqual(str(product), 'Test Product')
self.assertEqual(product.stock, 0) # Default
def test_product_slug_unique(self):
Product.objects.create(
name='First', slug='test', price=10,
category=self.category, created_by=self.user
)
with self.assertRaises(Exception):
Product.objects.create(
name='Second', slug='test', price=20,
category=self.category, created_by=self.user
)
```
## Fixtures
```python
# fixtures/products.json
[
{
"model": "products.category",
"pk": 1,
"fields": {"name": "Electronics", "slug": "electronics"}
},
{
"model": "products.product",
"pk": 1,
"fields": {
"name": "Laptop",
"slug": "laptop",
"price": "999.99",
"category": 1
}
}
]
# In test
class ProductTest(TestCase):
fixtures = ['products.json']
def test_with_fixture(self):
product = Product.objects.get(slug='laptop')
self.assertEqual(product.name, 'Laptop')
```
## Factory Boy
```python
import factory
from factory.django import DjangoModelFactory
class UserFactory(DjangoModelFactory):
class Meta:
model = User
email = factory.Sequence(lambda n: f'user{n}@example.com')
username = factory.Sequence(lambda n: f'user{n}')
password = factory.PostGenerationMethodCall('set_password', '<test-password>')
class ProductFactory(DjangoModelFactory):
class Meta:
model = Product
name = factory.Faker('word')
slug = factory.LazyAttribute(lambda o: slugify(o.name))
price = factory.Faker('pydecimal', left_digits=3, right_digits=2, positive=True)
created_by = factory.SubFactory(UserFactory)
# Usage
class ProductTest(TestCase):
def test_with_factory(self):
product = ProductFactory(price=100)
self.assertEqual(product.price, 100)
```
## Testing JWT
```python
class JWTAuthTest(APITestCase):
def setUp(self):
self.user = User.objects.create_user(
email='test@example.com',
username='test',
password='<test-password>'
)
def test_obtain_token(self):
response = self.client.post('/api/token/', {
'email': 'test@example.com',
'password': '<test-password>'
})
self.assertEqual(response.status_code, status.HTTP_200_OK)
self.assertIn('access', response.data)
self.assertIn('refresh', response.data)
def test_access_protected_endpoint(self):
response = self.client.post('/api/token/', {
'email': 'test@example.com',
'password': '<test-password>'
})
token = response.data['access']
self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {token}')
response = self.client.get('/api/protected/')
self.assertEqual(response.status_code, status.HTTP_200_OK)
```
## Quick Reference
| Method | Purpose |
|--------|---------|
| `force_authenticate()` | Skip auth |
| `credentials()` | Set headers |
| `reverse()` | URL by name |
| `fixtures` | Load test data |
| Assertion | Check |
|-----------|-------|
| `assertEqual()` | Exact match |
| `assertContains()` | Response contains |
| `assertRaises()` | Exception raised |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |