database::testing::expectation Class Reference

Single query expectation with configurable behavior. More...

#include <mock_expectations.h>

Collaboration diagram for database::testing::expectation:

Public Member Functions
	expectation ()
expectation &	for_query (const std::string &query, match_type type=match_type::EXACT)
expectation &	for_pattern (const std::string &pattern)
expectation &	for_any ()
expectation &	returning (const core::database_result &result)
expectation &	returning_rows_affected (uint64_t count)
expectation &	throwing (const std::string &error_message)
expectation &	returning_execute_result (bool result)
expectation &	times (int count)
expectation &	at_least (int count)
expectation &	at_most (int count)
expectation &	once ()
expectation &	never ()
bool	matches (const std::string &query) const
bool	is_satisfied () const
bool	can_be_invoked () const
core::database_result	get_result ()
uint64_t	get_rows_affected ()
bool	get_execute_result ()
bool	should_throw () const
std::string	get_error_message () const

Private Attributes
std::string	query_
match_type	match_type_
std::regex	pattern_
std::optional< core::database_result >	result_
std::optional< uint64_t >	rows_affected_
std::optional< bool >	execute_result_
std::optional< std::string >	error_message_
int	min_invocations_
int	max_invocations_
int	actual_invocations_

Detailed Description

Single query expectation with configurable behavior.

Definition at line 34 of file mock_expectations.h.

Constructor & Destructor Documentation

expectation()

database::testing::expectation::expectation

(

)

Definition at line 12 of file mock_expectations.cpp.

    : match_type_(match_type::ANY)
    , min_invocations_(0)
    , max_invocations_(std::numeric_limits<int>::max())
    , actual_invocations_(0)
{
}

Member Function Documentation

at_least()

expectation & database::testing::expectation::at_least

(

int

count

)

Definition at line 64 of file mock_expectations.cpp.

                                            {
    min_invocations_ = count;
    return *this;
}

References min_invocations_.

Referenced by database::testing::expectation_builder::any_times().

Here is the caller graph for this function:

at_most()

expectation & database::testing::expectation::at_most

(

int

count

)

Definition at line 69 of file mock_expectations.cpp.

                                           {
    max_invocations_ = count;
    return *this;
}

References max_invocations_.

can_be_invoked()

bool database::testing::expectation::can_be_invoked

(

)

const

Definition at line 99 of file mock_expectations.cpp.

                                       {
    return actual_invocations_ < max_invocations_;
}

References actual_invocations_, and max_invocations_.

for_any()

expectation & database::testing::expectation::for_any

(

)

Definition at line 33 of file mock_expectations.cpp.

                                  {
    match_type_ = match_type::ANY;
    return *this;
}

References database::testing::ANY, and match_type_.

Referenced by database::testing::mock_database::expect_any().

Here is the caller graph for this function:

for_pattern()

expectation & database::testing::expectation::for_pattern

(

const std::string &

pattern

)

Definition at line 29 of file mock_expectations.cpp.

                                                              {
    return for_query(pattern, match_type::PATTERN);
}

References for_query(), and database::testing::PATTERN.

Referenced by database::testing::mock_database::expect_pattern().

Here is the call graph for this function:

Here is the caller graph for this function:

for_query()

expectation & database::testing::expectation::for_query	(	const std::string &	query,
		match_type	type = match_type::EXACT )

Definition at line 20 of file mock_expectations.cpp.

                                                                           {
    query_ = query;
    match_type_ = type;
    if (type == match_type::PATTERN) {
        pattern_ = std::regex(query);
    }
    return *this;
}

References match_type_, database::testing::PATTERN, pattern_, and query_.

Referenced by database::testing::mock_database::expect_query(), and for_pattern().

Here is the caller graph for this function:

get_error_message()

std::string database::testing::expectation::get_error_message

(

)

const

Definition at line 131 of file mock_expectations.cpp.

                                               {
    return error_message_.value_or("");
}

References error_message_.

get_execute_result()

bool database::testing::expectation::get_execute_result

(

)

Definition at line 119 of file mock_expectations.cpp.

                                     {
    ++actual_invocations_;
    if (error_message_) {
        throw database_exception(*error_message_);
    }
    return execute_result_.value_or(true);
}

References actual_invocations_, error_message_, and execute_result_.

get_result()

core::database_result database::testing::expectation::get_result

(

)

Definition at line 103 of file mock_expectations.cpp.

                                            {
    ++actual_invocations_;
    if (error_message_) {
        throw database_exception(*error_message_);
    }
    return result_.value_or(core::database_result{});
}

References actual_invocations_, error_message_, and result_.

get_rows_affected()

uint64_t database::testing::expectation::get_rows_affected

(

)

Definition at line 111 of file mock_expectations.cpp.

                                        {
    ++actual_invocations_;
    if (error_message_) {
        throw database_exception(*error_message_);
    }
    return rows_affected_.value_or(0);
}

References actual_invocations_, error_message_, and rows_affected_.

is_satisfied()

bool database::testing::expectation::is_satisfied

(

)

const

Definition at line 95 of file mock_expectations.cpp.

                                     {
    return actual_invocations_ >= min_invocations_;
}

References actual_invocations_, and min_invocations_.

matches()

bool database::testing::expectation::matches

(

const std::string &

query

)

const

Definition at line 82 of file mock_expectations.cpp.

                                                      {
    switch (match_type_) {
        case match_type::EXACT:
            return query == query_;
        case match_type::PATTERN:
            return std::regex_search(query, pattern_);
        case match_type::ANY:
            return true;
        default:
            return false;
    }
}

References database::testing::ANY, database::testing::EXACT, match_type_, database::testing::PATTERN, pattern_, and query_.

never()

expectation & database::testing::expectation::never

(

)

Definition at line 78 of file mock_expectations.cpp.

                                {
    return times(0);
}

References times().

Here is the call graph for this function:

once()

expectation & database::testing::expectation::once

(

)

Definition at line 74 of file mock_expectations.cpp.

                               {
    return times(1);
}

References times().

Referenced by database::testing::expectation_builder::once().

Here is the call graph for this function:

Here is the caller graph for this function:

returning()

expectation & database::testing::expectation::returning

(

const core::database_result &

result

)

Definition at line 38 of file mock_expectations.cpp.

                                                                     {
    result_ = result;
    return *this;
}

References result_.

Referenced by database::testing::expectation_builder::will_return().

Here is the caller graph for this function:

returning_execute_result()

expectation & database::testing::expectation::returning_execute_result

(

bool

result

)

Definition at line 53 of file mock_expectations.cpp.

                                                              {
    execute_result_ = result;
    return *this;
}

References execute_result_.

Referenced by database::testing::expectation_builder::will_succeed().

Here is the caller graph for this function:

returning_rows_affected()

expectation & database::testing::expectation::returning_rows_affected

(

uint64_t

count

)

Definition at line 43 of file mock_expectations.cpp.

                                                                {
    rows_affected_ = count;
    return *this;
}

References rows_affected_.

Referenced by database::testing::expectation_builder::will_return_rows().

Here is the caller graph for this function:

should_throw()

bool database::testing::expectation::should_throw

(

)

const

Definition at line 127 of file mock_expectations.cpp.

                                     {
    return error_message_.has_value();
}

References error_message_.

throwing()

expectation & database::testing::expectation::throwing

(

const std::string &

error_message

)

Definition at line 48 of file mock_expectations.cpp.

                                                                 {
    error_message_ = error_message;
    return *this;
}

References error_message_.

Referenced by database::testing::expectation_builder::will_fail().

Here is the caller graph for this function:

times()

expectation & database::testing::expectation::times

(

int

count

)

Definition at line 58 of file mock_expectations.cpp.

                                         {
    min_invocations_ = count;
    max_invocations_ = count;
    return *this;
}

References max_invocations_, and min_invocations_.

Referenced by never(), once(), and database::testing::expectation_builder::times().

Here is the caller graph for this function:

Member Data Documentation

actual_invocations_

int database::testing::expectation::actual_invocations_

private

Definition at line 82 of file mock_expectations.h.

Referenced by can_be_invoked(), get_execute_result(), get_result(), get_rows_affected(), and is_satisfied().

error_message_

std::optional<std::string> database::testing::expectation::error_message_

private

Definition at line 78 of file mock_expectations.h.

Referenced by get_error_message(), get_execute_result(), get_result(), get_rows_affected(), should_throw(), and throwing().

execute_result_

std::optional<bool> database::testing::expectation::execute_result_

private

Definition at line 77 of file mock_expectations.h.

Referenced by get_execute_result(), and returning_execute_result().

match_type_

match_type database::testing::expectation::match_type_

private

Definition at line 72 of file mock_expectations.h.

Referenced by for_any(), for_query(), and matches().

max_invocations_

int database::testing::expectation::max_invocations_

private

Definition at line 81 of file mock_expectations.h.

Referenced by at_most(), can_be_invoked(), and times().

min_invocations_

int database::testing::expectation::min_invocations_

private

Definition at line 80 of file mock_expectations.h.

Referenced by at_least(), is_satisfied(), and times().

pattern_

std::regex database::testing::expectation::pattern_

private

Definition at line 73 of file mock_expectations.h.

Referenced by for_query(), and matches().

query_

std::string database::testing::expectation::query_

private

Definition at line 71 of file mock_expectations.h.

Referenced by for_query(), and matches().

result_

std::optional<core::database_result> database::testing::expectation::result_

private

Definition at line 75 of file mock_expectations.h.

Referenced by get_result(), and returning().

rows_affected_

std::optional<uint64_t> database::testing::expectation::rows_affected_

private

Definition at line 76 of file mock_expectations.h.

Referenced by get_rows_affected(), and returning_rows_affected().

---

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

• tests/mocks/mock_expectations.h
• tests/mocks/mock_expectations.cpp