testing::TestSharedGlobalResource< RES > Class Template Reference

Utility class providing singleton objects to the derived classes. More...

#include <unit_test_base.h>

Public Types
using	ResourcePtr_t = std::shared_ptr< Resource_t >
using	ResourcePtr_t = std::shared_ptr< Resource_t >

Static Public Member Functions
template<typename... Args>
static ResourcePtr_t	CreateResource (std::string res_name, Args &&...args)
	Constructs and registers a new resource with a specified name. More...
template<typename... Args>
static void	CreateDefaultResource (Args &&...args)
	Constructs and registers a new resource with no name. More...
template<typename... Args>
static ResourcePtr_t	ProposeSharedResource (std::string res_name, Args &&...args)
	Creates a shared resource only if none exists yet. More...
template<typename... Args>
static ResourcePtr_t	ProposeDefaultSharedResource (Args &&...args)
	Creates a shared resource as default only if none exists yet. More...
static Resource_t &	DestroyResource (std::string name="")
	Destroys the specified resource (does nothing if no such resource) More...
template<typename... Args>
static ResourcePtr_t	CreateResource (std::string res_name, Args &&...args)
	Constructs and registers a new resource with a specified name. More...
template<typename... Args>
static void	CreateDefaultResource (Args &&...args)
	Constructs and registers a new resource with no name. More...
template<typename... Args>
static ResourcePtr_t	ProposeSharedResource (std::string res_name, Args &&...args)
	Creates a shared resource only if none exists yet. More...
template<typename... Args>
static ResourcePtr_t	ProposeDefaultSharedResource (Args &&...args)
	Creates a shared resource as default only if none exists yet. More...
static Resource_t &	DestroyResource (std::string name="")
	Destroys the specified resource (does nothing if no such resource) More...
Add and share resources
static void	AddSharedResource (std::string res_name, ResourcePtr_t res_ptr)
	Adds a shared resource to the resource registry. More...
static void	AddDefaultSharedResource (ResourcePtr_t res_ptr)
	Adds a shared resource to the resource registry (empty name) More...
template<typename... Args>
static ResourcePtr_t	ProvideSharedResource (std::string res_name, ResourcePtr_t res_ptr)
	Registers a shared resource only if none exists yet. More...
template<typename... Args>
static ResourcePtr_t	ProvideDefaultSharedResource (ResourcePtr_t res_ptr)
	Creates a shared resource as default only if none exists yet. More...
static bool	ReplaceSharedResource (std::string res_name, Resource_t const *old_res_ptr, ResourcePtr_t res_ptr)
	Adds a shared resource only if it is old_res_ptr. More...
static bool	ReplaceSharedResource (std::string res_name, ResourcePtr_t old_res_ptr, ResourcePtr_t res_ptr)
static void	AddSharedResource (std::string res_name, ResourcePtr_t res_ptr)
	Adds a shared resource to the resource registry. More...
static void	AddDefaultSharedResource (ResourcePtr_t res_ptr)
	Adds a shared resource to the resource registry (empty name) More...
template<typename... Args>
static ResourcePtr_t	ProvideSharedResource (std::string res_name, ResourcePtr_t res_ptr)
	Registers a shared resource only if none exists yet. More...
template<typename... Args>
static ResourcePtr_t	ProvideDefaultSharedResource (ResourcePtr_t res_ptr)
	Creates a shared resource as default only if none exists yet. More...
static bool	ReplaceSharedResource (std::string res_name, Resource_t const *old_res_ptr, ResourcePtr_t res_ptr)
	Adds a shared resource only if it is old_res_ptr. More...
static bool	ReplaceSharedResource (std::string res_name, ResourcePtr_t old_res_ptr, ResourcePtr_t res_ptr)
static bool	ReplaceDefaultSharedResource (Resource_t const *old_res_ptr, ResourcePtr_t res_ptr)
	Adds a shared resource as default resource only if it is old_res_ptr. More...
static bool	ReplaceDefaultSharedResource (ResourcePtr_t old_res_ptr, ResourcePtr_t res_ptr)
Resource access
static bool	hasResource (std::string name="")
static ResourcePtr_t	ShareResource (std::string name="")
	Retrieves the specified resource for sharing (nullptr if none) More...
static Resource_t &	Resource (std::string name="")
	Retrieves the specified resource, or throws if not available. More...
static bool	hasResource (std::string name="")
static ResourcePtr_t	ShareResource (std::string name="")
	Retrieves the specified resource for sharing (nullptr if none) More...
static Resource_t &	Resource (std::string name="")
	Retrieves the specified resource, or throws if not available. More...
static bool	ReplaceDefaultSharedResource (Resource_t const *old_res_ptr, ResourcePtr_t res_ptr)
	Adds a shared resource as default resource only if it is old_res_ptr. More...
static bool	ReplaceDefaultSharedResource (ResourcePtr_t old_res_ptr, ResourcePtr_t res_ptr)

Private Types
using	Resource_t = RES
using	Resource_t = RES

Static Private Attributes
static std::map< std::string, ResourcePtr_t >	Resources

Detailed Description

template<typename RES>
class testing::TestSharedGlobalResource< RES >

Utility class providing singleton objects to the derived classes.

---

Template Parameters

RES	the type of object (include constantness if needed)

The object is expected to be shared.

Definition at line 386 of file unit_test_base.h.

Member Typedef Documentation

template<typename RES >

using testing::TestSharedGlobalResource< RES >::Resource_t = RES

private

Definition at line 387 of file unit_test_base.h.

template<typename RES >

using testing::TestSharedGlobalResource< RES >::Resource_t = RES

private

Definition at line 389 of file unit_test_base.h.

template<typename RES >

using testing::TestSharedGlobalResource< RES >::ResourcePtr_t = std::shared_ptr<Resource_t>

Definition at line 390 of file unit_test_base.h.

template<typename RES >

using testing::TestSharedGlobalResource< RES >::ResourcePtr_t = std::shared_ptr<Resource_t>

Definition at line 392 of file unit_test_base.h.

Member Function Documentation

template<typename RES >

static void testing::TestSharedGlobalResource< RES >::AddDefaultSharedResource ( ResourcePtr_t  res_ptr )

inlinestatic

Adds a shared resource to the resource registry (empty name)

Definition at line 400 of file unit_test_base.h.

       { AddSharedResource(std::string(), res_ptr); }

template<typename RES >

static void testing::TestSharedGlobalResource< RES >::AddDefaultSharedResource ( ResourcePtr_t  res_ptr )

inlinestatic

Adds a shared resource to the resource registry (empty name)

Definition at line 402 of file unit_test_base.h.

       { AddSharedResource(std::string(), res_ptr); }

template<typename RES >

static void testing::TestSharedGlobalResource< RES >::AddSharedResource ( std::string  res_name, ResourcePtr_t  res_ptr  )

inlinestatic

Adds a shared resource to the resource registry.

Definition at line 396 of file unit_test_base.h.

       { Resources[res_name] = res_ptr; }

template<typename RES >

static void testing::TestSharedGlobalResource< RES >::AddSharedResource ( std::string  res_name, ResourcePtr_t  res_ptr  )

inlinestatic

Adds a shared resource to the resource registry.

Definition at line 398 of file unit_test_base.h.

       { Resources[res_name] = res_ptr; }

template<typename RES >

template<typename... Args>

static void testing::TestSharedGlobalResource< RES >::CreateDefaultResource ( Args &&...  args )

inlinestatic

Constructs and registers a new resource with no name.

Definition at line 456 of file unit_test_base.h.

       { CreateResource(std::string(), std::forward<Args>(args)...); }

template<typename RES >

template<typename... Args>

static void testing::TestSharedGlobalResource< RES >::CreateDefaultResource ( Args &&...  args )

inlinestatic

Constructs and registers a new resource with no name.

Definition at line 458 of file unit_test_base.h.

       { CreateResource(std::string(), std::forward<Args>(args)...); }

template<typename RES >

template<typename... Args>

static ResourcePtr_t testing::TestSharedGlobalResource< RES >::CreateResource ( std::string  res_name, Args &&...  args  )

inlinestatic

Constructs and registers a new resource with a specified name.

Definition at line 447 of file unit_test_base.h.

       {
         ResourcePtr_t res_ptr(new Resource_t(std::forward<Args>(args)...));
         AddSharedResource(res_name, res_ptr);
         return res_ptr;
       }

template<typename RES >

template<typename... Args>

static ResourcePtr_t testing::TestSharedGlobalResource< RES >::CreateResource ( std::string  res_name, Args &&...  args  )

inlinestatic

Constructs and registers a new resource with a specified name.

Definition at line 449 of file unit_test_base.h.

       {
         ResourcePtr_t res_ptr(new Resource_t(std::forward<Args>(args)...));
         AddSharedResource(res_name, res_ptr);
         return res_ptr;
       }

template<typename RES >

static Resource_t& testing::TestSharedGlobalResource< RES >::DestroyResource ( std::string  name = "" )

inlinestatic

Destroys the specified resource (does nothing if no such resource)

Definition at line 505 of file unit_test_base.h.

       { Resources.erase(name); }

template<typename RES >

static Resource_t& testing::TestSharedGlobalResource< RES >::DestroyResource ( std::string  name = "" )

inlinestatic

Destroys the specified resource (does nothing if no such resource)

Definition at line 507 of file unit_test_base.h.

       { Resources.erase(name); }

template<typename RES >

static bool testing::TestSharedGlobalResource< RES >::hasResource ( std::string  name = "" )

inlinestatic

Returns whether a resource exists

Exceptions

std::out_of_range

if not available

Definition at line 485 of file unit_test_base.h.

       {
         auto iRes = Resources.find(name);
         return (iRes != Resources.end()) && bool(iRes->second);
       }

template<typename RES >

static bool testing::TestSharedGlobalResource< RES >::hasResource ( std::string  name = "" )

inlinestatic

Returns whether a resource exists

Exceptions

std::out_of_range

if not available

Definition at line 487 of file unit_test_base.h.

       {
         auto iRes = Resources.find(name);
         return (iRes != Resources.end()) && bool(iRes->second);
       }

template<typename RES >

template<typename... Args>

static ResourcePtr_t testing::TestSharedGlobalResource< RES >::ProposeDefaultSharedResource ( Args &&...  args )

inlinestatic

Creates a shared resource as default only if none exists yet.

Definition at line 472 of file unit_test_base.h.

       {
         return ProposeSharedResource
           (std::string(), std::forward<Args>(args)...);
       }

template<typename RES >

template<typename... Args>

static ResourcePtr_t testing::TestSharedGlobalResource< RES >::ProposeDefaultSharedResource ( Args &&...  args )

inlinestatic

Creates a shared resource as default only if none exists yet.

Definition at line 474 of file unit_test_base.h.

       {
         return ProposeSharedResource
           (std::string(), std::forward<Args>(args)...);
       }

template<typename RES >

template<typename... Args>

static ResourcePtr_t testing::TestSharedGlobalResource< RES >::ProposeSharedResource ( std::string  res_name, Args &&...  args  )

inlinestatic

Creates a shared resource only if none exists yet.

Definition at line 463 of file unit_test_base.h.

       {
         return hasResource(res_name)?
           ResourcePtr_t():
           CreateResource(res_name, std::forward<Args>(args)...);
       }

template<typename RES >

template<typename... Args>

static ResourcePtr_t testing::TestSharedGlobalResource< RES >::ProposeSharedResource ( std::string  res_name, Args &&...  args  )

inlinestatic

Creates a shared resource only if none exists yet.

Definition at line 465 of file unit_test_base.h.

       {
         return hasResource(res_name)?
           ResourcePtr_t():
           CreateResource(res_name, std::forward<Args>(args)...);
       }

template<typename RES >

template<typename... Args>

static ResourcePtr_t testing::TestSharedGlobalResource< RES >::ProvideDefaultSharedResource ( ResourcePtr_t  res_ptr )

inlinestatic

Creates a shared resource as default only if none exists yet.

Definition at line 415 of file unit_test_base.h.

       { return ProvideSharedResource(std::string(), res_ptr); }

template<typename RES >

template<typename... Args>

static ResourcePtr_t testing::TestSharedGlobalResource< RES >::ProvideDefaultSharedResource ( ResourcePtr_t  res_ptr )

inlinestatic

Creates a shared resource as default only if none exists yet.

Definition at line 417 of file unit_test_base.h.

       { return ProvideSharedResource(std::string(), res_ptr); }

template<typename RES >

template<typename... Args>

static ResourcePtr_t testing::TestSharedGlobalResource< RES >::ProvideSharedResource ( std::string  res_name, ResourcePtr_t  res_ptr  )

inlinestatic

Registers a shared resource only if none exists yet.

Definition at line 406 of file unit_test_base.h.

       {
         if (hasResource(res_name)) return ResourcePtr_t();
         AddSharedResource(res_name, res_ptr);
         return res_ptr;
       }

template<typename RES >

template<typename... Args>

static ResourcePtr_t testing::TestSharedGlobalResource< RES >::ProvideSharedResource ( std::string  res_name, ResourcePtr_t  res_ptr  )

inlinestatic

Registers a shared resource only if none exists yet.

Definition at line 408 of file unit_test_base.h.

       {
         if (hasResource(res_name)) return ResourcePtr_t();
         AddSharedResource(res_name, res_ptr);
         return res_ptr;
       }

template<typename RES >

static bool testing::TestSharedGlobalResource< RES >::ReplaceDefaultSharedResource ( Resource_t const *  old_res_ptr, ResourcePtr_t  res_ptr  )

inlinestatic

Adds a shared resource as default resource only if it is old_res_ptr.

Definition at line 438 of file unit_test_base.h.

       { return ReplaceSharedResource(std::string(), old_res_ptr, res_ptr); }

template<typename RES >

static bool testing::TestSharedGlobalResource< RES >::ReplaceDefaultSharedResource ( Resource_t const *  old_res_ptr, ResourcePtr_t  res_ptr  )

inlinestatic

Adds a shared resource as default resource only if it is old_res_ptr.

Definition at line 440 of file unit_test_base.h.

       { return ReplaceSharedResource(std::string(), old_res_ptr, res_ptr); }

template<typename RES >

static bool testing::TestSharedGlobalResource< RES >::ReplaceDefaultSharedResource ( ResourcePtr_t  old_res_ptr, ResourcePtr_t  res_ptr  )

inlinestatic

Definition at line 441 of file unit_test_base.h.

       { return ReplaceSharedResource(std::string(), old_res_ptr, res_ptr); }

template<typename RES >

static bool testing::TestSharedGlobalResource< RES >::ReplaceDefaultSharedResource ( ResourcePtr_t  old_res_ptr, ResourcePtr_t  res_ptr  )

inlinestatic

Definition at line 443 of file unit_test_base.h.

       { return ReplaceSharedResource(std::string(), old_res_ptr, res_ptr); }

template<typename RES >

static bool testing::TestSharedGlobalResource< RES >::ReplaceSharedResource ( std::string  res_name, Resource_t const *  old_res_ptr, ResourcePtr_t  res_ptr  )

inlinestatic

Adds a shared resource only if it is old_res_ptr.

Definition at line 420 of file unit_test_base.h.

       {
         ResourcePtr_t current_res_ptr = ShareResource();
         if (current_res_ptr.get() != old_res_ptr) return false;
         AddSharedResource(res_name, res_ptr);
         return true;
       }

template<typename RES >

static bool testing::TestSharedGlobalResource< RES >::ReplaceSharedResource ( std::string  res_name, Resource_t const *  old_res_ptr, ResourcePtr_t  res_ptr  )

inlinestatic

Adds a shared resource only if it is old_res_ptr.

Definition at line 422 of file unit_test_base.h.

       {
         ResourcePtr_t current_res_ptr = ShareResource();
         if (current_res_ptr.get() != old_res_ptr) return false;
         AddSharedResource(res_name, res_ptr);
         return true;
       }

template<typename RES >

static bool testing::TestSharedGlobalResource< RES >::ReplaceSharedResource ( std::string  res_name, ResourcePtr_t  old_res_ptr, ResourcePtr_t  res_ptr  )

inlinestatic

Definition at line 431 of file unit_test_base.h.

       { return ReplaceSharedResource(res_name, old_res_ptr.get(), res_ptr); }

template<typename RES >

static bool testing::TestSharedGlobalResource< RES >::ReplaceSharedResource ( std::string  res_name, ResourcePtr_t  old_res_ptr, ResourcePtr_t  res_ptr  )

inlinestatic

Definition at line 433 of file unit_test_base.h.

       { return ReplaceSharedResource(res_name, old_res_ptr.get(), res_ptr); }

template<typename RES >

static Resource_t& testing::TestSharedGlobalResource< RES >::Resource ( std::string  name = "" )

inlinestatic

Retrieves the specified resource, or throws if not available.

Definition at line 499 of file unit_test_base.h.

       { return *(Resources.at(name).get()); }

template<typename RES >

static Resource_t& testing::TestSharedGlobalResource< RES >::Resource ( std::string  name = "" )

inlinestatic

Retrieves the specified resource, or throws if not available.

Definition at line 501 of file unit_test_base.h.

       { return *(Resources.at(name).get()); }

template<typename RES >

static ResourcePtr_t testing::TestSharedGlobalResource< RES >::ShareResource ( std::string  name = "" )

inlinestatic

Retrieves the specified resource for sharing (nullptr if none)

Definition at line 492 of file unit_test_base.h.

       {
         auto iRes = Resources.find(name);
         return (iRes == Resources.end())? ResourcePtr_t(): iRes->second;
       }

template<typename RES >

static ResourcePtr_t testing::TestSharedGlobalResource< RES >::ShareResource ( std::string  name = "" )

inlinestatic

Retrieves the specified resource for sharing (nullptr if none)

Definition at line 494 of file unit_test_base.h.

       {
         auto iRes = Resources.find(name);
         return (iRes == Resources.end())? ResourcePtr_t(): iRes->second;
       }

Member Data Documentation

template<typename RES >

std::map< std::string, typename TestSharedGlobalResource< RES >::ResourcePtr_t > testing::TestSharedGlobalResource< RES >::Resources

staticprivate

Definition at line 509 of file unit_test_base.h.

---

The documentation for this class was generated from the following file:

• garsoft/TestUtils/unit_test_base.h