Experimental package to automatically extract test plugins for Home Assistant custom components
Project description
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
- home-assistant/core native test:
- If your integration is inside a
custom_components
folder, acustom_components/__init__.py
file or changes tosys.path
may be required. enable_custom_integrations
fixture is required (versions >=2021.6.0b0)- Some fixtures, e.g.
recorder_mock
, need to be initialized beforeenable_custom_integrations
. See https://github.com/MatthewFlamm/pytest-homeassistant-custom-component/issues/132.
- Some fixtures, e.g.
- pytest-asyncio might now require
asyncio_mode = auto
config, see #129. - If using
load_fixture
, the files need to be in afixtures
folder colocated with the tests. For example, a test intest_sensor.py
can load data fromsome_data.json
usingload_fixture
from this structure:
tests/
fixtures/
some_data.json
test_sensor.py
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for pytest-homeassistant-custom-component-0.13.90.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9c9aeb317a0e8dbc61d052ce6f855769a958afca3a1e04a824b154eea5ca367c |
|
MD5 | 2e46f9ccaabd3d3483a70d0a4b0e0b26 |
|
BLAKE2b-256 | 38c99519a215e1822b4f1c023efdf2359d125fc6c870c62f09ed97cc16ad9eb3 |
Close
Hashes for pytest_homeassistant_custom_component-0.13.90-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 75e1c803a0b61deefcbe1184065e02917e7efc360cc4a0d5d506df5c4b4f1cc3 |
|
MD5 | c1c61f8191e4ef099906c401f1c68061 |
|
BLAKE2b-256 | 12c4d54dd1b89f83007b8399ff6c08dac704c6402e94e227b4f708992464cf18 |