test-scopes.cpp File Reference

Go to the source code of this file.

Description

Implementation of nested test scopes to cover the placement index.

This translation unit builds mock "session content" with a fixed, known layout, which can be used to verify the behaviour of session query and content discovery

Definition in file test-scopes.cpp.

#include "steam/mobject/session/test-scopes.hpp"
#include "steam/mobject/session/session-service-mock-index.hpp"
#include "steam/mobject/session/session-service-explore-scope.hpp"
#include "steam/mobject/session/scope-query.hpp"

Functions
PPIdx	build_testScopes ()
	helper for tests: create a pseudo-session (actually just a PlacementIndex), which contains some nested placement scopes. More...
ScopeQuery< MObject >::iterator	explore_testScope (PlacementMO const &scopeTop)
	shortcut to explore the contents of a scope within the current index. More...
template<class MO >
PlacementMO &	retrieve_firstElmOfType ()
PlacementMO &	retrieve_firstTestSubMO21 ()
PlacementMO &	retrieve_startElm ()
	complement to the helper: retrieve one of the dummy placements which is a Placement<> and way down into the hierarchy More...

Namespaces
	steam
	Steam-Layer implementation namespace root.
	steam::mobject
	Media-Objects, edit operations and high-level session.
	steam::mobject::session
	Namespace of Session and user visible high-level objects.

Function Documentation

build_testScopes()

PPIdx build_testScopes

(

)

helper for tests: create a pseudo-session (actually just a PlacementIndex), which contains some nested placement scopes.

Note

this dummy index isn't actively connected to the session; the unit tests rely on this dummy index containing a specific tree structure of test-dummy MObjects.

Returns

new PlacementIndex, which has already been activated to be used by all Placements from now on. This activation will be cleared automatically, when this object goes out of scope.

See also

mobject::PlacementIndex

session::SessManagerImpl::getCurrentIndex()

mobject::session::SessionServiceMockIndex::reset_PlacementIndex

Definition at line 38 of file test-scopes.cpp.

References steam::mobject::session::test::build_testScopes(), and SessionServiceMockIndex::install().

Referenced by steam::mobject::session::test::build_testScopes().

Here is the call graph for this function:

Here is the caller graph for this function:

retrieve_startElm()

PlacementMO & retrieve_startElm

(

)

complement to the helper: retrieve one of the dummy placements which is a Placement<> and way down into the hierarchy

Note

this test helper only works if build_testScopes is invoked beforehand, and the returned smart-ptr to the created test/dummy index is retained. Moreover, this function makes assumptions about the actual objects created by the former test function.

Exceptions

lumiera::error::Invalid

if the intended start element doesn't exist (anymore)

Definition at line 87 of file test-scopes.cpp.

References steam::mobject::session::test::retrieve_startElm().

Referenced by steam::mobject::session::test::retrieve_startElm(), and PlacementScope_test::verifyEquality().

Here is the call graph for this function:

Here is the caller graph for this function:

explore_testScope()

_ScopeIterMO explore_testScope

(

PlacementMO const &

scopeTop

)

shortcut to explore the contents of a scope within the current index.

Usually, clients would use QueryFocus or ScopeLocator to perform this task, but for the purpose of testing we're better off to invoke the query directly

Definition at line 100 of file test-scopes.cpp.

References steam::mobject::session::CHILDREN, steam::mobject::session::test::explore_testScope(), and SessionServiceExploreScope::getResolver().

Referenced by steam::mobject::session::test::explore_testScope().

Here is the call graph for this function:

Here is the caller graph for this function: