Add blog post about deprecation of async_add_job and async_run_job (#2111)

This commit is contained in:
J. Nick Koston 2024-03-14 08:54:58 -10:00 committed by GitHub
parent 8d63819d60
commit b353835ce5
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -0,0 +1,18 @@
---
author: J. Nick Koston
authorURL: https://github.com/bdraco
title: "Deprecating `async_run_job` and `async_add_job`"
---
`async_run_job` and `async_add_job` are deprecated and will be removed in Home Assistant 2025.4. This deprecation does not apply to the sync API `add_job` method, which is not planned to be removed.
Instead, it's more efficient to use one of the other job methods, as the method of calling the job does not ever have to be worked out:
If the callable is a coroutine function running from a config entry:
`entry.async_create_background_task`, `entry.async_create_task`
If the callable is a coroutine function running from another place:
`hass.async_create_background_task`, `hass.async_create_task`
If the callable should run in the executor:
`hass.async_add_executor_job`