pytest-homeassistant-custom-component

Package to automatically extract testing plugins from Home Assistant for custom component testing. The goal is to provide the same functionality as the tests in home-assistant/core. pytest-homeassistant-custom-component is updated daily according to the latest homeassistant release including beta.

Usage:

• All pytest fixtures can be used as normal, like hass
• For helpers:
• home-assistant/core native test: from tests.common import MockConfigEntry
• custom component test: from pytest_homeassistant_custom_component.common import MockConfigEntry
• If your integration is inside a custom_components folder, a custom_components/__init__.py file or changes to sys.path may be required.
• enable_custom_integrations fixture is required (versions >=2021.6.0b0)
• Some fixtures, e.g. recorder_mock, need to be initialized before enable_custom_integrations. See https://github.com/MatthewFlamm/pytest-homeassistant-custom-component/issues/132.
• pytest-asyncio now requires asyncio_mode = auto config, see https://github.com/MatthewFlamm/pytest-homeassistant-custom-component/issues/129 and https://github.com/MatthewFlamm/pytest-homeassistant-custom-component/issues/247.
• If using load_fixture, the files need to be in a fixtures folder colocated with the tests. For example, a test in test_sensor.py can load data from some_data.json using load_fixture from this structure:

tests/
   fixtures/
      some_data.json
   test_sensor.py

• When using syrupy snapshots, add a snapshot fixture to conftest.py to make sure the snapshots are loaded from snapshot folder colocated with the tests.

    from pytest_homeassistant_custom_component.syrupy import HomeAssistantSnapshotExtension
    from syrupy.assertion import SnapshotAssertion


    @pytest.fixture
    def snapshot(snapshot: SnapshotAssertion) -> SnapshotAssertion:
        """Return snapshot assertion fixture with the Home Assistant extension."""
        return snapshot.use_extension(HomeAssistantSnapshotExtension)

Examples:

• See list of custom components as examples that use this package.
• Also see tests for simple_integration in this repository.
• Use cookiecutter-homeassistant-custom-component to create a custom component with tests by using cookiecutter.
• The github-custom-component-tutorial explaining in details how to create a custom componenent with a test suite using this package.

More Info

This repository is set up to be nearly fully automatic.

• Version of home-assistant/core is given in ha_version, pytest_homeassistant_custom_component.const, and in the README above.
• This package is generated against published releases of homeassistant and updated daily.
• PRs should not include changes to the pytest_homeassistant_custom_component files. CI testing will automatically generate the new files.

Version Strategy

• When changes in extraction are required, there will be a change in the minor version.
• A change in the patch version indicates that it was an automatic update with a homeassistant version.
• This enables tracking back to which versions of pytest-homeassistant-custom-component can be used for extracting testing utilities from which version of homeassistant.

This package was inspired by pytest-homeassistant by @boralyl, but is intended to more closely and automatically track the home-assistant/core library.