check.hpp

/*
 * This file is part of libtcspc
 * Copyright 2019-2026 Board of Regents of the University of Wisconsin System
 * SPDX-License-Identifier: MIT
 */
 
#pragma once
 
#include "common.hpp"
#include "core.hpp"
#include "event.hpp"
#include "introspect.hpp"
#include "numeric_traits.hpp"
#include "processor.hpp"
 
#include <limits>
#include <ostream>
#include <sstream>
#include <type_traits>
#include <utility>
 
namespace tcspc {
 
namespace internal {
 
template <typename NumericTraits, bool RequireStrictlyIncreasing,
          typename Downstream>
    requires processor<Downstream, warning_event>
class check_monotonic {
    NumericTraits::abstime_type last_seen =
        std::numeric_limits<typename NumericTraits::abstime_type>::min();
 
    Downstream downstream;
 
    LIBTCSPC_NOINLINE void issue_warning(NumericTraits::abstime_type abstime) {
        std::ostringstream stream;
        stream << "non-monotonic abstime: " << last_seen << " followed by "
               << abstime;
        downstream.handle(warning_event{stream.str()});
    }
 
  public:
    explicit check_monotonic(Downstream downstream)
        : downstream(std::move(downstream)) {}
 
    [[nodiscard]] auto introspect_node() const -> processor_info {
        return processor_info(this, "check_monotonic");
    }
 
    [[nodiscard]] auto introspect_graph() const -> processor_graph {
        return downstream.introspect_graph().push_entry_point(this);
    }
 
    template <typename Event>
        requires handler_for<Downstream, std::remove_cvref_t<Event>>
    void handle(Event &&event) {
        if constexpr (abstime_stamped<std::remove_cvref_t<Event>>) {
            static_assert(
                std::is_same_v<decltype(event.abstime),
                               typename NumericTraits::abstime_type>);
            bool const monotonic = RequireStrictlyIncreasing
                                       ? event.abstime > last_seen
                                       : event.abstime >= last_seen;
            if (not monotonic)
                issue_warning(event.abstime);
            last_seen = event.abstime;
        }
        downstream.handle(std::forward<Event>(event));
    }
 
    void flush() { downstream.flush(); }
};
 
} // namespace internal

template <typename NumericTraits = default_numeric_traits,
          bool RequireStrictlyIncreasing = false, typename Downstream>
auto check_monotonic(Downstream downstream) {
    return internal::check_monotonic<NumericTraits, RequireStrictlyIncreasing,
                                     Downstream>(std::move(downstream));
}
 
namespace internal {
 
template <typename Event0, typename Event1, typename Downstream>
    requires processor<Downstream, Event0, Event1, warning_event>
class check_alternating {
    bool last_saw_0 = false;
    Downstream downstream;
 
    LIBTCSPC_NOINLINE void issue_warning() {
        downstream.handle(warning_event{"non-alternating events"});
    }
 
  public:
    explicit check_alternating(Downstream downstream)
        : downstream(std::move(downstream)) {}
 
    [[nodiscard]] auto introspect_node() const -> processor_info {
        return processor_info(this, "check_alternating");
    }
 
    [[nodiscard]] auto introspect_graph() const -> processor_graph {
        return downstream.introspect_graph().push_entry_point(this);
    }
 
    template <typename E>
        requires handler_for<Downstream, std::remove_cvref_t<E>>
    void handle(E &&event) {
        if constexpr (std::is_convertible_v<std::remove_cvref_t<E>, Event0>) {
            if (last_saw_0)
                issue_warning();
            last_saw_0 = true;
        } else if constexpr (std::is_convertible_v<std::remove_cvref_t<E>,
                                                   Event1>) {
            if (not last_saw_0)
                issue_warning();
            last_saw_0 = false;
        }
        downstream.handle(std::forward<E>(event));
    }
 
    void flush() { downstream.flush(); }
};
 
} // namespace internal

template <typename Event0, typename Event1, typename Downstream>
auto check_alternating(Downstream downstream) {
    return internal::check_alternating<Event0, Event1, Downstream>(
        std::move(downstream));
}
 
} // namespace tcspc