event.h

Go to the documentation of this file.

#pragma once
 
#include <cstring>
#include <string>
#include <vector>
 
#include "esphome/core/component.h"
#include "esphome/core/entity_base.h"
#include "esphome/core/helpers.h"
 
namespace esphome {
namespace event {
 
#define LOG_EVENT(prefix, type, obj) \
  if ((obj) != nullptr) { \
    ESP_LOGCONFIG(TAG, "%s%s '%s'", prefix, LOG_STR_LITERAL(type), (obj)->get_name().c_str()); \
    if (!(obj)->get_icon_ref().empty()) { \
      ESP_LOGCONFIG(TAG, "%s  Icon: '%s'", prefix, (obj)->get_icon_ref().c_str()); \
    } \
    if (!(obj)->get_device_class_ref().empty()) { \
      ESP_LOGCONFIG(TAG, "%s  Device Class: '%s'", prefix, (obj)->get_device_class_ref().c_str()); \
    } \
  }
 
class Event : public EntityBase, public EntityBase_DeviceClass {
 public:
  void trigger(const std::string &event_type);
 
  void set_event_types(std::initializer_list<const char *> event_types) {
    this->types_ = event_types;
    this->last_event_type_ = nullptr;  // Reset when types change
  }
  void set_event_types(const FixedVector<const char *> &event_types);
  void set_event_types(const std::vector<const char *> &event_types);
 
  // Deleted overloads to catch incorrect std::string usage at compile time with clear error messages
  void set_event_types(std::initializer_list<std::string> event_types) = delete;
  void set_event_types(const FixedVector<std::string> &event_types) = delete;
  void set_event_types(const std::vector<std::string> &event_types) = delete;
 
  const FixedVector<const char *> &get_event_types() const { return this->types_; }
 
  const char *get_last_event_type() const { return this->last_event_type_; }
 
  void add_on_event_callback(std::function<void(const std::string &event_type)> &&callback);
 
 protected:
  CallbackManager<void(const std::string &event_type)> event_callback_;
  FixedVector<const char *> types_;
 
 private:
  const char *last_event_type_{nullptr};
};
 
}  // namespace event
}  // namespace esphome