---

Code

Source code is available here

Documentation

User documentation can be found here

Description

This project aims to ease the use of clock in complex environments, especially distributed environments where latencies measurement has to be precise and reproductible when running unit tests. PhoenixClock provide PGenericClock, a template classe which takes two arguments : - The main clock backend (could be clock, PClockNs for nanoseconds, etc) - A mock of a clock, PClockMock, which can play, register and replay a sequence of clock calls

These clocks are activated with a mode PClockMode::PClockMode which can be : - PClockMode::NO_MOCK : for a normal usage - PClockMode::MOCK : when the mock the desired clock is played - PClockMode::MOCK_RECORD : when the real clock backend is used but the clock mock is recording (could be usefull for debugging or to desing new unit tests quickly)

#include "phoenix_clock.h"

...
///Example of PGenericClock usage
void callingClock(){
    PGenericClock<PClockBackend, PClockMock> myClock;
    //Let's use the normal mode
    myClock.setMode(PClockMode::NO_MOCK);
    //We can get the current time with
    clock.now();    //Returns a time_t such as clock()

    //Once we have a mock file 'clock.clockmock',
    //we can replay it with the same API
    myClock.setMode(PClockMode::MOCK);
    clock.now();    //Returns a time_t such as clock(),
    //but this time, it is from the recorded times in the mock

    //Let's have an example of the recording
    myClock.setMode(PClockMode::MOCK_RECORD);
    clock.now();    //Returns a time_t such as clock(),
    //but this time, it is from the real clock backend but is
    //recorded at the same time in the mock
}

Installation

You can get the installation instructions from phoenix projects consistent installtion procedure.