ripple::Invariants_test Class Reference

Inheritance diagram for ripple::Invariants_test:

Collaboration diagram for ripple::Invariants_test:

Public Member Functions
void	run () override
	Runs the suite. More...
template<class = void>
void	operator() (runner &r)
	Invokes the test using the specified runner. More...
template<class = void>
void	pass ()
	Record a successful test condition. More...
template<class F , class String >
bool	except (F &&f, String const &reason)
template<class F >
bool	except (F &&f)
template<class E , class F , class String >
bool	except (F &&f, String const &reason)
template<class E , class F >
bool	except (F &&f)
template<class F , class String >
bool	unexcept (F &&f, String const &reason)
template<class F >
bool	unexcept (F &&f)
std::string const &	arg () const
	Return the argument associated with the runner. More...
template<class Condition , class String >
bool	unexpected (Condition shouldBeFalse, String const &reason)
template<class Condition >
bool	unexpected (Condition shouldBeFalse)
template<class String >
void	fail (String const &reason, char const *file, int line)
	Record a failure. More...
template<class = void>
void	fail (std::string const &reason="")
template<class Condition >
bool	expect (Condition const &shouldBeTrue)
	Evaluate a test condition. More...
template<class Condition , class String >
bool	expect (Condition const &shouldBeTrue, String const &reason)
template<class Condition >
bool	expect (Condition const &shouldBeTrue, char const *file, int line)
template<class Condition , class String >
bool	expect (Condition const &shouldBeTrue, String const &reason, char const *file, int line)

Static Public Member Functions
static suite *	this_suite ()
	Returns the "current" running suite. More...

Public Attributes
log_os< char >	log
	Logging output stream. More...
testcase_t	testcase
	Memberspace for declaring test cases. More...

Private Types
using	Preclose = std::function< bool(test::jtx::Account const &a, test::jtx::Account const &b, test::jtx::Env &env)>
using	Precheck = std::function< bool(test::jtx::Account const &a, test::jtx::Account const &b, ApplyContext &ac)>

Private Member Functions
void	doInvariantCheck (std::vector< std::string > const &expect_logs, Precheck const &precheck, XRPAmount fee=XRPAmount{}, STTx tx=STTx{ttACCOUNT_SET, [](STObject &) {}}, std::initializer_list< TER > ters={tecINVARIANT_FAILED, tefINVARIANT_FAILED}, Preclose const &preclose={})
	Run a specific test case to put the ledger into a state that will be detected by an invariant. More...
void	testXRPNotCreated ()
void	testAccountRootsNotRemoved ()
void	testAccountRootsDeletedClean ()
void	testTypesMatch ()
void	testNoXRPTrustLine ()
void	testXRPBalanceCheck ()
void	testTransactionFeeCheck ()
void	testNoBadOffers ()
void	testNoZeroEscrow ()
void	testValidNewAccountRoot ()
void	testNFTokenPageInvariants ()
void	testPermissionedDomainInvariants ()
void	propagate_abort ()

Static Private Member Functions
static suite **	p_this_suite ()

Private Attributes
bool	abort_ = false
bool	aborted_ = false
runner *	runner_ = nullptr

Detailed Description

Definition at line 34 of file Invariants_test.cpp.

Member Typedef Documentation

Preclose

using ripple::Invariants_test::Preclose = std::function<bool( test::jtx::Account const& a, test::jtx::Account const& b, test::jtx::Env& env)>

private

Definition at line 40 of file Invariants_test.cpp.

Precheck

using ripple::Invariants_test::Precheck = std::function<bool( test::jtx::Account const& a, test::jtx::Account const& b, ApplyContext& ac)>

private

Definition at line 48 of file Invariants_test.cpp.

Member Function Documentation

doInvariantCheck()

void ripple::Invariants_test::doInvariantCheck ( std::vector< std::string > const &  expect_logs, Precheck const &  precheck, XRPAmount  fee = XRPAmount{}, STTx  tx = STTx{ttACCOUNT_SET, [](STObject&) {}}, std::initializer_list< TER >  ters = {tecINVARIANT_FAILED, tefINVARIANT_FAILED}, Preclose const &  preclose = {}  )

private

Run a specific test case to put the ledger into a state that will be detected by an invariant.

Simulates the actions of a transaction that would violate an invariant.

Parameters

expect_logs

One or more messages related to the failing invariant that should be in the log output @precheck See "Precheck" above @fee If provided, the fee amount paid by the simulated transaction. @tx A mock transaction that took the actions to trigger the invariant. In most cases, only the type matters. @ters The TER results expected on the two passes of the invariant checker. @preclose See "Preclose" above. Note that @preclose runs before @precheck, but is the last parameter for historical reasons

Definition at line 70 of file Invariants_test.cpp.

testXRPNotCreated()

void ripple::Invariants_test::testXRPNotCreated ( )

private

Definition at line 129 of file Invariants_test.cpp.

testAccountRootsNotRemoved()

void ripple::Invariants_test::testAccountRootsNotRemoved ( )

private

Definition at line 148 of file Invariants_test.cpp.

testAccountRootsDeletedClean()

void ripple::Invariants_test::testAccountRootsDeletedClean ( )

private

Definition at line 197 of file Invariants_test.cpp.

testTypesMatch()

void ripple::Invariants_test::testTypesMatch ( )

private

Definition at line 356 of file Invariants_test.cpp.

testNoXRPTrustLine()

void ripple::Invariants_test::testNoXRPTrustLine ( )

private

Definition at line 396 of file Invariants_test.cpp.

testXRPBalanceCheck()

void ripple::Invariants_test::testXRPBalanceCheck ( )

private

Definition at line 412 of file Invariants_test.cpp.

testTransactionFeeCheck()

void ripple::Invariants_test::testTransactionFeeCheck ( )

private

Definition at line 462 of file Invariants_test.cpp.

testNoBadOffers()

void ripple::Invariants_test::testNoBadOffers ( )

private

Definition at line 492 of file Invariants_test.cpp.

testNoZeroEscrow()

void ripple::Invariants_test::testNoZeroEscrow ( )

private

Definition at line 549 of file Invariants_test.cpp.

testValidNewAccountRoot()

void ripple::Invariants_test::testValidNewAccountRoot ( )

private

Definition at line 603 of file Invariants_test.cpp.

testNFTokenPageInvariants()

void ripple::Invariants_test::testNFTokenPageInvariants ( )

private

Definition at line 655 of file Invariants_test.cpp.

testPermissionedDomainInvariants()

void ripple::Invariants_test::testPermissionedDomainInvariants ( )

private

Definition at line 802 of file Invariants_test.cpp.

run()

void ripple::Invariants_test::run ( )

overridevirtual

Runs the suite.

Implements beast::unit_test::suite.

Definition at line 1057 of file Invariants_test.cpp.

this_suite()

static suite * beast::unit_test::suite::this_suite ( )

staticinherited

Returns the "current" running suite.

If no suite is running, nullptr is returned.

Definition at line 159 of file suite.h.

operator()()

template<class >

void beast::unit_test::suite::operator() ( runner &  r )

inherited

Invokes the test using the specified runner.

Data members are set up here instead of the constructor as a convenience to writing the derived class to avoid repetition of forwarded constructor arguments to the base. Normally this is called by the framework for you.

Definition at line 397 of file suite.h.

pass()

template<class >

void beast::unit_test::suite::pass

inherited

Record a successful test condition.

Definition at line 509 of file suite.h.

fail() [1/2]

template<class String >

void beast::unit_test::suite::fail ( String const &  reason, char const *  file, int  line  )

inherited

Record a failure.

Parameters

reason	Optional text added to the output on a failure.
file	The source code file where the test failed.
line	The source code line number where the test failed.

Definition at line 531 of file suite.h.

fail() [2/2]

template<class >

void beast::unit_test::suite::fail ( std::string const &  reason = "" )

inherited

Definition at line 518 of file suite.h.

expect() [1/4]

template<class Condition >

bool beast::unit_test::suite::expect ( Condition const &  shouldBeTrue )

inherited

Evaluate a test condition.

This function provides improved logging by incorporating the file name and line number into the reported output on failure, as well as additional text specified by the caller.

Parameters

shouldBeTrue	The condition to test. The condition is evaluated in a boolean context.
reason	Optional added text to output on a failure.
file	The source code file where the test failed.
line	The source code line number where the test failed.

Returns

true if the test condition indicates success.

Definition at line 227 of file suite.h.

expect() [2/4]

template<class Condition , class String >

bool beast::unit_test::suite::expect ( Condition const &  shouldBeTrue, String const &  reason  )

inherited

Definition at line 414 of file suite.h.

expect() [3/4]

template<class Condition >

bool beast::unit_test::suite::expect ( Condition const &  shouldBeTrue, char const *  file, int  line  )

inherited

Definition at line 238 of file suite.h.

expect() [4/4]

template<class Condition , class String >

bool beast::unit_test::suite::expect ( Condition const &  shouldBeTrue, String const &  reason, char const *  file, int  line  )

inherited

Definition at line 427 of file suite.h.

except() [1/4]

template<class F , class String >

bool beast::unit_test::suite::except ( F &&  f, String const &  reason  )

inherited

Definition at line 446 of file suite.h.

except() [2/4]

template<class F >

bool beast::unit_test::suite::except ( F &&  f )

inherited

Definition at line 261 of file suite.h.

except() [3/4]

template<class E , class F , class String >

bool beast::unit_test::suite::except ( F &&  f, String const &  reason  )

inherited

Definition at line 463 of file suite.h.

except() [4/4]

template<class E , class F >

bool beast::unit_test::suite::except ( F &&  f )

inherited

Definition at line 270 of file suite.h.

unexcept() [1/2]

template<class F , class String >

bool beast::unit_test::suite::unexcept ( F &&  f, String const &  reason  )

inherited

Definition at line 480 of file suite.h.

unexcept() [2/2]

template<class F >

bool beast::unit_test::suite::unexcept ( F &&  f )

inherited

Definition at line 279 of file suite.h.

arg()

std::string const & beast::unit_test::suite::arg ( ) const

inherited

Return the argument associated with the runner.

Definition at line 286 of file suite.h.

unexpected() [1/2]

template<class Condition , class String >

bool beast::unit_test::suite::unexpected ( Condition  shouldBeFalse, String const &  reason  )

inherited

Definition at line 497 of file suite.h.

unexpected() [2/2]

template<class Condition >

bool beast::unit_test::suite::unexpected ( Condition  shouldBeFalse )

inherited

Definition at line 299 of file suite.h.

p_this_suite()

static suite ** beast::unit_test::suite::p_this_suite ( )

staticprivateinherited

Definition at line 308 of file suite.h.

propagate_abort()

void beast::unit_test::suite::propagate_abort ( )

privateinherited

Definition at line 537 of file suite.h.

Member Data Documentation

abort_

bool beast::unit_test::suite::abort_ = false

privateinherited

Definition at line 55 of file suite.h.

aborted_

bool beast::unit_test::suite::aborted_ = false

privateinherited

Definition at line 56 of file suite.h.

runner_

runner* beast::unit_test::suite::runner_ = nullptr

privateinherited

Definition at line 57 of file suite.h.

log

log_os<char> beast::unit_test::suite::log

inherited

Logging output stream.

Text sent to the log output stream will be forwarded to the output stream associated with the runner.

Definition at line 150 of file suite.h.

testcase

testcase_t beast::unit_test::suite::testcase

inherited

Memberspace for declaring test cases.

Definition at line 153 of file suite.h.