LUMIERA.clone/tests/library/diff/diff-virtualised-application-test.cpp
Ichthyostega 5744244f73 considerations how to access the "tree mutator building closure"
this is at the core of the integration problem: how do we expose
the ability of some opaque data structure to create a TreeMutator?

The idea is
 - to use a marker/capability interface
 - to use template specialisation to fabricate an instance of that interface
   based on the given access point to the opaque data structure
2016-06-14 02:33:28 +02:00

243 lines
8.5 KiB
C++
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/*
DiffVirtualisedApplication(Test) - apply structural changes to unspecific private data structures
Copyright (C) Lumiera.org
2016, 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/format-util.hpp"
#include "lib/diff/tree-diff-mutator-binding.hpp"
#include "lib/iter-adapter-stl.hpp"
#include "lib/time/timevalue.hpp"
#include "lib/format-cout.hpp" //////////TODO necessary?
#include "lib/format-string.hpp"
//#include "lib/format-util.hpp"
#include "lib/util.hpp"
#include <string>
#include <vector>
#include <memory>
using lib::iter_stl::snapshot;
using util::isnil;
using util::join;
using util::_Fmt;
using util::join;
using std::unique_ptr;
using std::string;
using std::vector;
using lib::time::Time;
namespace lib {
namespace diff{
namespace test{
namespace {//Test fixture....
// define some GenNode elements
// to act as templates within the concrete diff
// NOTE: everything in this diff language is by-value
const GenNode ATTRIB1("α", 1), // attribute α = 1
ATTRIB2("β", int64_t(2)), // attribute α = 2L (int64_t)
ATTRIB3("γ", 3.45), // attribute γ = 3.45 (double)
TYPE_X("type", "ξ"), // a "magic" type attribute "Xi"
TYPE_Z("type", "ζ"), //
CHILD_A("a"), // unnamed string child node
CHILD_B('b'), // unnamed char child node
CHILD_T(Time(12,34,56,78)), // unnamed time value child
SUB_NODE = MakeRec().genNode(), // empty anonymous node used to open a sub scope
ATTRIB_NODE = MakeRec().genNode("δ"), // empty named node to be attached as attribute δ
GAMMA_PI("γ", 3.14159265); // happens to have the same identity (ID) as ATTRIB3
/**
* opaque private data structure to apply the diff.
* This class offers to build a binding for diff messages,
* which basically maps its internal structures onto the
* generic "object" scheme underlying the diff language.
*/
class Opaque
{
int alpha_ = -1;
string beta_ = "NIL";
double gamma_ = -1;
unique_ptr<Opaque> delta_;
vector<Opaque> nestedObj_;
vector<string> nestedData_;
public:
Opaque() { }
operator string() const
{
return _Fmt{"%s (α:%d β:%s γ:%7.5f δ:%s\n......|nested:%s\n......|data:%s\n )"}
% idi::instanceTypeID (this)
% alpha_
% beta_
% gamma_
% delta_
% join (nestedObj_, "\n......|")
% join (nestedData_)
;
}
void
buildMutator (TreeMutator::Handle buff)
{
UNIMPLEMENTED("construct the concrete Binding, using the TreeMutator::Builder DSL");
buff.create (
TreeMutator::build()
.attach (collection(nestedData_)
));
}
};
}//(End)Test fixture
/***********************************************************************//**
* @test Demonstration: apply a structural change to unspecified private
* data structures, with the help of an [dynamic adapter](\ref TreeMutator)
* - we use private data classes, defined here in the test fixture
* to represent "just some" pre-existing data structure.
* - we re-assign some attribute values
* - we add, re-order and delete child "elements", without knowing
* what these elements actually are and how they are to be handled.
* - we recurse into mutating such an _"unspecified"_ child element.
*
* @todo this test is WIP as of 6/2016 !! What has to be done, is to work out a way how to create a TreeMutator binding. And of course, we need the Implementation of DiffApplicator<DiffMutable>
* @note this test uses the same verb sequence as is assumed for the
* coverage of diff building blocks in TreeMutatorBinding_test
*
* @see DiffTreeApplication_test generic variant of tree diff application
* @see TreeMutatorBinding_test coverage of the "building blocks"
* @see TreeMutator_test base operations of the adapter
* @see tree-diff-mutator-binding.hpp
* @see diff-tree-application.hpp
* @see tree-diff.hpp
*/
class DiffVirtualisedApplication_test
: public Test
, TreeDiffLanguage
{
using DiffSeq = iter_stl::IterSnapshot<DiffStep>;
DiffSeq
populationDiff()
{
return snapshot({ins(ATTRIB1)
, ins(ATTRIB3)
, ins(ATTRIB3)
, ins(CHILD_B)
, ins(CHILD_B)
, ins(CHILD_T)
});
} // ==> ATTRIB1, ATTRIB3, ATTRIB3, CHILD_B, CHILD_B, CHILD_T
DiffSeq
reorderingDiff()
{
return snapshot({find(ATTRIB3)
, pick(ATTRIB1)
, skip(ATTRIB3)
, ins(ATTRIB2)
, pick(ATTRIB3)
, del(CHILD_B)
, ins(SUB_NODE)
, pick(CHILD_B)
, pick(CHILD_T)
});
} // ==> ATTRIB3, ATTRIB1, ATTRIB2, ATTRIB3, SUB_NODE, CHILD_B, CHILD_T
DiffSeq
mutationDiff()
{
return snapshot({after(CHILD_B)
, after(Ref::END)
, set(GAMMA_PI)
, mut(SUB_NODE)
, ins(TYPE_X)
, ins(ATTRIB2)
, ins(CHILD_B)
, ins(CHILD_A)
, emu(SUB_NODE)
, ins(ATTRIB_NODE)
, mut(ATTRIB_NODE)
, ins(TYPE_Z)
, ins(CHILD_A)
, ins(CHILD_A)
, ins(CHILD_A)
, emu(ATTRIB_NODE)
});
} // ==> ATTRIB3 := π, ATTRIB1, ATTRIB2, ATTRIB3,
// ATTRIB_NODE{ type ζ, CHILD_A, CHILD_A, CHILD_A }
// SUB_NODE{ type ξ, ATTRIB2, CHILD_B, CHILD_A },
// CHILD_B, CHILD_T,
virtual void
run (Arg)
{
Opaque subject;
DiffMutable& target = mutatorBinding (subject);
DiffApplicator<DiffMutable> application(target);
//
// TODO verify results
cout << "before..."<<endl << subject<<endl;
// Part I : apply attribute changes
application.consume(populationDiff());
//
// TODO verify results
cout << "after...I"<<endl << subject<<endl;
// Part II : apply child population
application.consume(reorderingDiff());
//
// TODO verify results
cout << "after...II"<<endl << subject<<endl;
// Part II : apply child mutations
application.consume(mutationDiff());
//
// TODO verify results
cout << "after...III"<<endl << subject<<endl;
}
};
/** Register this test class... */
LAUNCHER (DiffVirtualisedApplication_test, "unit common");
}}} // namespace lib::diff::test