test-cotton-components

Testing Django Cotton components with pytest uses fixtures from django-cotton-bs5: cotton_render for HTML output, cotton_render_soup for DOM traversal, cotton_render_string for inline markup, and cotton_render_string_soup for complex structures. Write assertions against the rendered HTML to verify component behavior, context handling, and accessibility.

django-cotton-bs5 provides four core fixtures: cotton_render returns raw HTML from a single component, cotton_render_soup parses it into a BeautifulSoup object for DOM queries, cotton_render_string renders inline Cotton markup, and cotton_render_string_soup combines inline rendering with DOM traversal for complex test scenarios.

Yes. Use cotton_render_string or cotton_render_string_soup to write tests that render multiple components in a single test case, then assert DOM structure, context flow, and interactions between components using BeautifulSoup selectors and HTML assertions.

Yes. Testing Cotton components requires pytest, Django, and django-cotton-bs5 fixtures to be installed and configured in your project. Ensure your test environment can import both Django and the cotton-bs5 fixtures before writing tests.

Use cotton_render_soup or cotton_render_string_soup to get a BeautifulSoup object, then traverse the DOM with selectors to find elements and assert their attributes, text content, and structure. Include accessibility checks and context validation in your assertions for maintainable, comprehensive tests.

Pass context dictionaries directly to the cotton_render fixtures as parameters when rendering components. The fixtures inject context into the component scope so you can test how components respond to different data, then assert the rendered output reflects the context correctly.