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 >

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...
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)
	Adds a shared resource to the resource registry. 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)
	Adds a shared resource as default resource only if it is old_res_ptr. More...
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...

Private Types
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 385 of file unit_test_base.h.

Member Typedef Documentation

template<typename RES >

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

private

Definition at line 386 of file unit_test_base.h.

template<typename RES >

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

Definition at line 389 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 401 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 395 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 464 of file unit_test_base.h.

References testing::details::CommandLineArguments::args.

    {
      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 455 of file unit_test_base.h.

References testing::details::CommandLineArguments::args.

    {
      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 510 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 491 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 479 of file unit_test_base.h.

References testing::details::CommandLineArguments::args.

    {
      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 471 of file unit_test_base.h.

References testing::details::CommandLineArguments::args.

    {
      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 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 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 443 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

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

Definition at line 447 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 424 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

Adds a shared resource to the resource registry.

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 505 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 498 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 513 of file unit_test_base.h.

---

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

• larcorealg/v09_13_01/source/larcorealg/TestUtils/unit_test_base.h