Skip to content

Directivas de inclusión !include_list y !include_dict en Home Assistant

En este artículo, nos centraremos en las directivas de inclusión en YAML específicas de Home Assistant: !include_list y !include_dict. Estas directivas permiten a los usuarios importar archivos YAML adicionales y mantener una configuración organizada y fácil de administrar en sus sistemas Home Assistant.

Puedes ver la página principal del curso o el temario del segundo capítulo.

Índice de contenido

    ¿Qué son las directivas de inclusión en Home Assistant?

    Las directivas !include_list y !include_dict son extensiones específicas de Home Assistant que permiten incluir archivos YAML adicionales en la configuración principal de Home Assistant. Estas directivas hacen que sea más fácil mantener una configuración ordenada, modular y fácil de administrar, dividiendo la configuración en archivos separados basados en la funcionalidad o los dispositivos.

    !include_list se utiliza para importar una lista de elementos desde un archivo YAML externo, mientras que !include_dict importa un diccionario de claves y valores desde otro archivo YAML. Ambas directivas facilitan la organización y la reutilización de código YAML en diferentes partes de la configuración de Home Assistant.

    Cómo utilizar !include_list y !include_dict para importar archivos YAML en Home Assistant

    Para utilizar !include_list y !include_dict en Home Assistant, primero debes crear los archivos YAML adicionales que deseas importar y almacenarlos en el mismo directorio que tu archivo de configuración principal de Home Assistant, llamado configuration.yaml.

    Para importar una lista de elementos desde un archivo YAML externo, utiliza la directiva !include_list seguida del nombre del archivo que deseas importar. Por ejemplo:

    automation:
      !include_list automations.yaml
    

    En este ejemplo, se importan las automatizaciones desde el archivo automations.yaml.

    Para importar un diccionario desde otro archivo YAML, utiliza la directiva !include_dict seguida del nombre del archivo que deseas importar. Por ejemplo:

    sensor:
      !include_dict sensors.yaml
    

    Aquí, se importan los sensores desde el archivo sensors.yaml.

    Ejemplos de directivas de inclusión

    Vamos a ver un ejemplo práctico de cómo utilizar !include_list y !include_dict en la configuración de Home Assistant.

    Imagina que tienes varias automatizaciones y sensores en tu configuración y deseas organizarlos en archivos separados. Primero, crea un archivo llamado automations.yaml y coloca todas tus automatizaciones en él. Luego, crea otro archivo llamado sensors.yaml y coloca la configuración de tus sensores en él.

    En tu archivo configuration.yaml, utiliza las directivas !include_list y !include_dict para importar las configuraciones de los archivos automations.yaml y sensors.yaml. Tu archivo configuration.yaml se verá así:

    homeassistant:
      name: My Home
    
    automation:
      !include_list automations.yaml
    
    sensor:
      !include_dict sensors.yaml
    

    Al utilizar !include_list y !include_dict en tu configuración de Home Assistant, puedes mantener una configuración más organizada y fácil de administrar. Estas directivas facilitan la división de la configuración en archivos separados, lo que resulta en una mejor estructura y mayor facilidad de mantenimiento a medida que tu sistema de automatización del hogar crece y se vuelve más complejo.

    Sígueme a YouTube

    Sígueme en YouTube - Directivas de inclusión
    Ajustes