monitor.hpp

Go to the documentation of this file.

/*
 * Copyright (c) 2014-2022 Enrico M. Crisostomo
 *
 * This program is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License as published by the Free Software
 * Foundation; either version 3, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
 * details.
 *
 * You should have received a copy of the GNU General Public License along with
 * this program.  If not, see <http://www.gnu.org/licenses/>.
 */
#ifndef FSW__MONITOR_H
#  define FSW__MONITOR_H
 
#  include "filter.hpp"
#  include <vector>
#  include <string>
#  include <mutex>
#  include <atomic>
#  include <chrono>
#  include <map>
#  include <regex>
#  include "event.hpp"
#  include "libfswatch/c/cmonitor.h"
 
namespace fsw
{
  typedef void FSW_EVENT_CALLBACK(const std::vector<event>&, void *);
 
  struct compiled_monitor_filter;
 
  class monitor
  {
  public:
    monitor(std::vector<std::string> paths,
            FSW_EVENT_CALLBACK *callback,
            void *context = nullptr);
 
    virtual ~monitor();
 
    monitor(const monitor& orig) = delete;
 
    monitor& operator=(const monitor& that) = delete;
 
    void set_property(const std::string& name, const std::string& value);
 
    void set_properties(const std::map<std::string, std::string> options);
 
    std::string get_property(std::string name);
 
    void set_latency(double latency);
 
    void set_fire_idle_event(bool fire_idle_event);
 
    void set_allow_overflow(bool overflow);
 
    void set_recursive(bool recursive);
 
    void set_directory_only(bool directory_only);
 
    void add_filter(const monitor_filter& filter);
 
    void set_filters(const std::vector<monitor_filter>& filters);
 
    void set_filter_mode(fsw_filter_mode mode);
 
    void add_prune_filter(const monitor_filter& filter);
 
    void set_prune_filters(const std::vector<monitor_filter>& filters);
 
    void set_follow_symlinks(bool follow);
 
    void *get_context() const;
 
    void set_context(void *context);
 
    void set_bubble_events(bool bubble_events);
 
    void start();
 
    void stop();
 
    bool is_running();
 
    void add_event_type_filter(const fsw_event_type_filter& filter);
 
    void set_event_type_filters(
      const std::vector<fsw_event_type_filter>& filters);
 
    void set_watch_access(bool access);
 
  protected:
    bool accept_event_type(fsw_event_flag event_type) const;
 
    bool accept_path(const std::string& path) const;
 
    bool should_prune_path(const std::string& path,
                           bool is_dir,
                           bool is_root_path) const;
 
    void notify_events(const std::vector<event>& events) const;
 
    void notify_overflow(const std::string& path) const;
 
    std::vector<fsw_event_flag> filter_flags(const event& evt) const;
 
    virtual void run() = 0;
 
    virtual void on_stop();
 
  protected:
    std::vector<std::string> paths;
 
    std::map<std::string, std::string> properties;
 
    FSW_EVENT_CALLBACK *callback;
 
    void *context = nullptr;
 
    double latency = 1.0;
 
    bool fire_idle_event = false;
 
    bool allow_overflow = false;
 
    bool recursive = false;
 
    bool follow_symlinks = false;
 
    bool directory_only = false;
 
    bool watch_access = false;
 
    bool running = false;
 
    bool should_stop = false;
 
    bool bubble_events = false;
 
    mutable std::mutex run_mutex;
 
    mutable std::mutex notify_mutex;
 
  private:
    std::chrono::milliseconds get_latency_ms() const;
    std::vector<compiled_monitor_filter> filters;
    std::vector<std::regex> prune_filters;
    std::vector<fsw_event_type_filter> event_type_filters;
    fsw_filter_mode filter_mode = fsw_filter_mode::filter_mode_legacy;
 
    static void inactivity_callback(monitor *mon);
    mutable std::atomic<std::chrono::milliseconds> last_notification;
  };
}
 
#endif  /* FSW__MONITOR_H */