lumiera_/tests/vault/gear/scheduler-activity-test.cpp

/*
  SchedulerActivity(Test)  -  verify activities processed in the scheduler

  Copyright (C)         Lumiera.org
    2023,               Hermann Vosseler <Ichthyostega@web.de>

  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 2 of
  the License, 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, write to the Free Software
  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

* *****************************************************/

/** @file scheduler-activity-test.cpp
 ** unit test \ref SchedulerActivity_test
 */


#include "lib/test/run.hpp"
#include "lib/test/test-helper.hpp"
#include "activity-detector.hpp"
#include "vault/gear/activity-lang.hpp"
#include "vault/real-clock.hpp"
#include "lib/time/timevalue.hpp"
#include "lib/format-cout.hpp"  /////////////////////////////////////TODO
//#include "lib/util.hpp"

//#include <utility>

using test::Test;
using lib::time::Time;
using lib::time::FSecs;
//using std::move;
//using util::isSameObject;


namespace vault{
namespace gear {
namespace test {
  
//  using lib::time::FrameRate;
//  using lib::time::Offset;
//  using lib::time::Time;
  
  
  
  
  
  /*****************************************************************//**
   * @test verify behaviour of the Scheduler _Activity Language._
   * @see SchedulerCommutator_test
   * @see SchedulerUsage_test
   */
  class SchedulerActivity_test : public Test
    {
      
      virtual void
      run (Arg)
        {
          simpleUsage();
          
          verifyActivity_Invoke();
          verifyActivity_Notify();
          verifyActivity_Post();
          verifyActivity_Gate();
          
          termBuilder();
          
          scenario_RenderJob();
          scenario_IOJob();
          scenario_MetaJob();
        }
      
      
      /** @test TODO demonstrate a simple usage scenario
       * @todo WIP 7/23 🔁 define 🔁 implement
       */
      void
      simpleUsage()
        {
          // Activities are »POD with constructor«
          Activity gate{5, Time{FSecs{3,2}}};
          CHECK (gate.verb_ == Activity::GATE);
          CHECK (gate.next == nullptr);
          CHECK (gate.data_.condition.rest == 5);
          CHECK (gate.data_.condition.dead == Time(500,1));
        }
      
      
      
      /** @test behaviour of Activity::INVOKE
       *        - setup requires two FEED-Activities to be chained up as arguments
       *        - use the rigged execution context provided by ActivityDetector
       *        - can verify this way that the activation leads to JobFunctor invocation
       */
      void
      verifyActivity_Invoke()
        {
          ActivityDetector detector;
          
          size_t x1=rand(), x2=rand();
          Time nomTime = lib::test::randTime();
          Activity feed{x1,x2};
          Activity feed2{x1+1,x1+2};
          feed.next = &feed2;
          Activity invoke{detector.buildMockJobFunctor("job"), nomTime, feed};
          
          Time realTime = RealClock::now();
          CHECK (activity::PASS == invoke.activate (realTime, detector.executionCtx));
          
          cout << detector.showLog()<<endl;
          CHECK (detector.verifyInvocation ("job").arg(nomTime, x1));
        }
      
      
      
      /** @test TODO behaviour of Activity::NOTIFY
       *        - notification entails to schedule a follow-up activation
       *        - implies to pass the `next`-Activity to the execution context's `post()` hook
       *        - use the rigged execution context from ActivityDetector to detect call
       * @todo WIP 7/23 🔁 define ⟶ implement
       */
      void
      verifyActivity_Notify()
        {
        }
      
      
      
      /** @test TODO behaviour of Activity::NOTIFY
       * @todo WIP 7/23 ⟶ define ⟶ implement
       */
      void
      verifyActivity_Post()
        {
        }
      
      
      
      /** @test TODO behaviour of Activity::GATE
       * @todo WIP 7/23 ⟶ define ⟶ implement
       */
      void
      verifyActivity_Gate()
        {
        }
      
      
      
      /** @test TODO verify the Activity term builder
       * @todo WIP 7/23 ⟶ define ⟶ implement
       */
      void
      termBuilder()
        {
        }
      
      
      
      /** @test TODO usage scenario: Activity graph for a render job
       * @todo WIP 7/23 ⟶ define ⟶ implement
       */
      void
      scenario_RenderJob()
        {
        }
      
      
      
      /** @test TODO usage scenario: Activity graph for an async Job
       * @todo WIP 7/23 ⟶ define ⟶ implement
       */
      void
      scenario_IOJob()
        {
        }
      
      
      
      /** @test TODO usage scenario: Activity graph for administrative job
       * @todo WIP 7/23 ⟶ define ⟶ implement
       */
      void
      scenario_MetaJob()
        {
        }
    };
  
  
  /** Register this test class... */
  LAUNCHER (SchedulerActivity_test, "unit engine");
  
  
  
}}} // namespace vault::gear::test