Class SchedulerTest

tests/test-scheduler-basic.cpp:83–127

* @brief Test fixture class for TaskScheduler unit tests * * Provides common setup and teardown functionality for all scheduler tests. * Ensures clean test state between test runs and provides utility methods * for common test operations like running scheduler with timeout conditions. */

 * for common test operations like running scheduler with timeout conditions.
 */
class SchedulerTest : public ::testing::Test {
protected:
    /**
     * @brief Set up test environment before each test
     * 
     * Clears any previous test output and initializes timing system.
     * Called automatically by Google Test framework before each test method.
     * Ensures each test starts with a clean, predictable state.
     */
    void SetUp() override {
        clearTestOutput();
        // Reset time by creating new static start point
        millis(); // Initialize timing
    }
    
    /**
     * @brief Clean up test environment after each test
     * 
     * Clears test output to prevent interference between tests.
     * Called automatically by Google Test framework after each test method.
     * Ensures no test artifacts affect subsequent tests.
     */
    void TearDown() override {
        clearTestOutput();
    }
    
    /**
     * @brief Helper method to run scheduler until condition is met or timeout
     * 
     * Executes the scheduler repeatedly until either the specified condition
     * returns true or the timeout period expires. Essential for testing
     * time-dependent scheduler behavior without creating infinite loops.
     * 
     * @param ts Reference to the Scheduler object to execute
     * @param condition Lambda function that returns true when test condition is met
     * @param timeout_ms Maximum time to wait before giving up (default: 1000ms)
     * @return true if condition was met within timeout, false otherwise
     */
    bool runSchedulerUntil(Scheduler& ts, std::function<bool()> condition, unsigned long timeout_ms = 1000) {
        return waitForCondition([&]() {
            ts.execute();
            return condition();
        }, timeout_ms);
    }
};

/**
 * @brief Test basic scheduler object creation