transiently.hpp

Go to the documentation of this file.

/*
  TRANSIENTLY.hpp  -  temporary manipulations undone when leaving scope
 
   Copyright (C)
     2023,            Hermann Vosseler <Ichthyostega@web.de>
 
 **Lumiera** 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. See the file COPYING for further details.
 
*/
 
 
#ifndef LIB_TEST_TRANSIENTLY_H
#define LIB_TEST_TRANSIENTLY_H
 
 
#include "lib/nocopy.hpp"
#include "lib/meta/function.hpp"
#include "lib/ppmpl.h"
 
#include <utility>
 
namespace lib {
namespace test{
  
  template<typename TAR>
  class Transiently
    : util::NonCopyable
    {
      TAR originalVal_;
      TAR& manipulated_;
      
    public:
      Transiently(TAR& target)
        : originalVal_{target}
        , manipulated_{target}
        { }
      
     ~Transiently()
        {
          manipulated_ = std::move (originalVal_);
        }
      
      template<typename X>
      void
      operator= (X&& x)
        {
          manipulated_ = std::forward<X> (x);
        }
    };
  
  
  template<>
  class Transiently<void(void)>
    : util::NonCopyable
    {
      using Manipulator = std::function<void(void)>;
      
      Manipulator doIt_;
      Manipulator undoIt_;
      
    public:
      Transiently (Manipulator manipulation)
        : doIt_{std::move (manipulation)}
        , undoIt_{}
        { }
      
     ~Transiently()
        {
          CHECK (undoIt_, "REJECT Manipulation -- "
                          "Failed to provide a way "
                          "to undo the manipulation.");
          undoIt_();
        }
      
      void
      cleanUp (Manipulator cleanUp)
        {
          undoIt_ = std::move (cleanUp);
          doIt_(); //  actually perform the manipulation
        }
    };
  
  template<typename FUN,                 typename=lib::meta::enable_if<lib::meta::has_Sig<FUN, void(void)>>>
  Transiently (FUN&&) -> Transiently<void(void)>;
  
}} // namespace lib::test
 
 
 
 
/* === test helper macros === */
 
#define TRANSIENTLY(_OO_) \
  lib::test::Transiently PPMPL_CAT(transientlyManipulated_,__LINE__)(_OO_); PPMPL_CAT(transientlyManipulated_,__LINE__)
 
 
#endif /*LIB_TEST_TRANSIENTLY_H*/