jeans/developers.home-assistant
jeans/developers.home-assistant
1
0
Fork 0
mirror of https://github.com/home-assistant/developers.home-assistant.git synced 2025-07-27 19:26:29 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add blog post for deprecating supported features magic numbers (#2027)

Browse Source
This commit is contained in:
J. Nick Koston 2023-12-28 11:48:05 -10:00 committed by GitHub
parent 24b7787ac1
commit fc3f2437d5
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 64 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

64
blog/2023-12-28-support-feature-magic-numbers-deprecation.md Normal file
View File

@ -0,0 +1,64 @@
---
author: J. Nick Koston
authorURL: https://github.com/bdraco
title: "Deprecating all magic numbers for supported features"
---
As of Home Assistant Core 2024.1, all usage of magic numbers for supported features is deprecated,
and each entity platform has provided an `EntityFeature` enum to replace them.
There will be a one-year deprecation period, and the magic numbers will stop working in 2025.1 to ensure all custom integration authors have time to adjust.
This applies to, the following platforms:
- **Alarm Control Panel**
Use the new [`AlarmControlPanelEntityFeature`](/docs/core/entity/alarm-control-panel#supported-features) enum instead.
- **Camera**
Use the new [`CameraEntityFeature`](/docs/core/entity/camera#supported-features) enum instead.
- **Cover**
Use the new [`CoverEntityFeature`](/docs/core/entity/cover#supported-features) enum instead.
- **Climate**
Use the new [`ClimateEntityFeature`](/docs/core/entity/climate#supported-features) enum instead.
- **Humidifier**
Use the new [`HumidifierEntityFeature`](/docs/core/entity/humidifier#supported-features) enum instead.
- **Fan**
Use the new [`FanEntityFeature`](/docs/core/entity/fan#supported-features) enum instead.
- **Light**
Use the new [`LightEntityFeature`](/docs/core/entity/light#supported-features) enum instead.
- **Lock**
Use the new [`LockEntityFeature`](/docs/core/entity/lock#supported-features) enum instead.
- **Media Player**
Use the new [`MediaPlayerEntityFeature`](/docs/core/entity/media-player#supported-features) enum instead.
- **Remote**
Use the new [`RemoteEntityFeature`](/docs/core/entity/remote#supported-features) enum instead.
- **Siren**
Use the new [`SirenEntityFeature`](/docs/core/entity/siren#supported-features) enum instead.
- **Vacuum**
Use the new [`VacuumEntityFeature`](/docs/core/entity/vacuum#supported-features) enum instead.
- **Water Heater**
Use the new [`WaterHeaterEntityFeature`](/docs/core/entity/water-heater#supported-features) enum instead.