LUMIERA.clone/tests/components/proc/engine/engine-interface-test.cpp

/*
  EngineInterface(Test)  -  verify basics of the engine (scheduling) service

  Copyright (C)         Lumiera.org
    2011,               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.

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


#include "lib/test/run.hpp"
#include "lib/error.hpp"

#include "proc/engine/calc-stream.hpp"
#include "proc/engine/engine-service.hpp"
#include "proc/engine/engine-diagnostics.hpp"
#include "proc/play/output-slot.hpp"
#include "proc/play/diagnostic-output-slot.hpp"
#include "proc/mobject/model-port.hpp"
#include "proc/asset/pipe.hpp"

//#include <boost/scoped_ptr.hpp>
//#include <iostream>
//#include <ctime>

using test::Test;
//using std::cout;
//using std::rand;


namespace proc  {
namespace engine{
namespace test  {
  
  using asset::Pipe;
  using asset::PPipe;
  using mobject::ModelPort;
  using proc::play::OutputSlot;
  using proc::play::DiagnosticOutputSlot;
  
  typedef asset::ID<Pipe> PID;
  typedef OutputSlot::Allocation Allocation;

  
  namespace { // test fixture...
    
  } // (End) test fixture
  
  
  
  /*******************************************************************
   * @test cover the basic service exposed at the engine interface:
   *       create a calculation stream and verify the translation
   *       into individual jobs.
   * 
   * This test relies on the engine's diagnostic facilities, allowing
   * to log and verify the generated jobs without needing to execute
   * them. So this test doesn't actually run the engine. There are
   * \link OutputSlotProtocol_test other tests \endlink covering
   * the output generation separate from the engine.
   * 
   * @see CalcStream_test more in-depth coverage of the various
   *      flavours of calculation streams supported by the engine
   * @see EngineService
   * @see CalcStream
   * @see OutputSlotProtocol_test
   */
  class EngineInterface_test : public Test
    {
      
      virtual void
      run (Arg) 
        {
          UNIMPLEMENTED ("simple standard case of Engine interface usage");
          
          EngineService& engine = EngineService::instance();
          EngineDiagnostics monitor(engine);
          
          PID pipe = Pipe::query("id(dummy)");
          ModelPort port(pipe);
          
          OutputSlot& oSlot = DiagnosticOutputSlot::build();
          Allocation output = oSlot.allocate();
          Timings timings; /////////TODO
          
          // Invoke test subject...
          CalcStream calc = engine.calculate(port, timings, output);
          
          ////TODO some direct checks on the calculation stream??
          
          CHECK (monitor.has_scheduled_jobs_for(timings));
        }
      
    };
  
  
  /** Register this test class... */
  LAUNCHER (EngineInterface_test, "function engine");
  
  
  
}}} // namespace proc::engine::test