Testing

New in version 0.131

The @djc_test decorator is a powerful tool for testing components created with django-components. It ensures that each test is properly isolated, preventing components registered in one test from affecting others.

Usage¤

The @djc_test decorator can be applied to functions, methods, or classes. When applied to a class, it recursively decorates all methods starting with test_, including those in nested classes. This allows for comprehensive testing of component behavior.

Applying to a Function¤

To apply djc_test to a function, simply decorate the function as shown below:

import django
from django_components.testing import djc_test

django.setup()

@djc_test
def test_my_component():
    @register("my_component")
    class MyComponent(Component):
        template = "..."
    ...

Applying to a Class¤

When applied to a class, djc_test decorates each test_ method individually:

import django
from django_components.testing import djc_test

django.setup()

@djc_test
class TestMyComponent:
    def test_something(self):
        ...

    class Nested:
        def test_something_else(self):
            ...

This is equivalent to applying the decorator to each method individually:

import django
from django_components.testing import djc_test

django.setup()

class TestMyComponent:
    @djc_test
    def test_something(self):
        ...

    class Nested:
        @djc_test
        def test_something_else(self):
            ...

Arguments¤

See the API reference for @djc_test for more details.

Setting Up Django¤

Before using djc_test, ensure Django is set up:

import django
from django_components.testing import djc_test

django.setup()

@djc_test
def test_my_component():
    ...

Example: Parametrizing Context Behavior¤

You can parametrize the context behavior using djc_test:

from django_components.testing import djc_test

@djc_test(
    # Settings applied to all cases
    components_settings={
        "app_dirs": ["custom_dir"],
    },
    # Parametrized settings
    parametrize=(
        ["components_settings"],
        [
            [{"context_behavior": "django"}],
            [{"context_behavior": "isolated"}],
        ],
        ["django", "isolated"],
    )
)
def test_context_behavior(components_settings):
    rendered = MyComponent().render()
    ...