AUnit  0.5.0
Unit testing framework for Arduino platforms inspired by ArduinoUnit and Google Test.
Public Member Functions | List of all members
aunit::TestOnce Class Referenceabstract

Similar to TestAgain but performs user-defined test only once. More...

#include <TestOnce.h>

Inheritance diagram for aunit::TestOnce:
Inheritance graph
[legend]
Collaboration diagram for aunit::TestOnce:
Collaboration graph
[legend]

Public Member Functions

 TestOnce ()
 Constructor. More...
 
virtual void loop () override
 Calls the user-provided once() method. More...
 
virtual void once ()=0
 User-provided test case. More...
 
- Public Member Functions inherited from aunit::Test
 Test ()
 Empty constructor. More...
 
virtual void setup ()
 Optional method that performs any initialization. More...
 
virtual void teardown ()
 Optional method that performs any clean up after the test ends for any reasons, either passing or otherwise. More...
 
void resolve ()
 Print out the summary of the current test. More...
 
const internal::FCStringgetName ()
 Get the name of the test. More...
 
uint8_t getLifeCycle ()
 Get the life cycle state of the test. More...
 
void setLifeCycle (uint8_t state)
 
uint8_t getStatus ()
 Get the status of the test. More...
 
void setStatus (uint8_t status)
 Set the status of the test. More...
 
void setPassOrFail (bool ok)
 Set the status to Passed or Failed depending on ok. More...
 
Test ** getNext ()
 Return the next pointer as a pointer to the pointer, similar to getRoot(). More...
 
bool isDone ()
 Return true if test has been asserted. More...
 
bool isNotDone ()
 Return true if test is not has been asserted. More...
 
bool isPassed ()
 Return true if test is passed. More...
 
bool isNotPassed ()
 Return true if test is not passed. More...
 
bool isFailed ()
 Return true if test is failed. More...
 
bool isNotFailed ()
 Return true if test is not failed. More...
 
bool isSkipped ()
 Return true if test is skipped. More...
 
bool isNotSkipped ()
 Return true if test is not skipped. More...
 
bool isExpired ()
 Return true if test is expired. More...
 
bool isNotExpired ()
 Return true if test is not expired. More...
 
void skip ()
 Mark the test as skipped. More...
 
void expire ()
 Mark the test as expired (i.e. More...
 
void enableVerbosity (uint8_t verbosity)
 Enable the given verbosity of the current test. More...
 
void disableVerbosity (uint8_t verbosity)
 Disable the given verbosity of the current test. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from aunit::Test
static Test ** getRoot ()
 Get the pointer to the root pointer. More...
 
- Static Public Attributes inherited from aunit::Test
static const uint8_t kLifeCycleNew = 0
 Test is new, needs to be setup. More...
 
static const uint8_t kLifeCycleExcluded = 1
 Test is Excluded by an exclude() method. More...
 
static const uint8_t kLifeCycleSetup = 2
 Test has been set up by calling setup() and ready to execute the test code. More...
 
static const uint8_t kLifeCycleAsserted = 3
 Test is asserted (using pass(), fail(), expired() or skipped()) and the getStatus() has been determined. More...
 
static const uint8_t kLifeCycleFinished = 4
 The test has completed its life cycle. More...
 
static const uint8_t kStatusUnknown = 0
 Test status is unknown. More...
 
static const uint8_t kStatusPassed = 1
 Test has passed, or pass() was called. More...
 
static const uint8_t kStatusFailed = 2
 Test has failed, or fail() was called. More...
 
static const uint8_t kStatusSkipped = 3
 Test is skipped through the exclude() method or skip() was called. More...
 
static const uint8_t kStatusExpired = 4
 Test has timed out, or expire() called. More...
 
- Protected Member Functions inherited from aunit::MetaAssertion
 MetaAssertion ()
 Empty constructor. More...
 
bool assertionTestStatus (const char *file, uint16_t line, const char *testName, const __FlashStringHelper *statusMessage, bool ok)
 Set the status of the current test based on 'ok, and print assertion message if requested.
 
void printAssertionTestStatusMessage (bool ok, const char *file, uint16_t line, const char *testName, const __FlashStringHelper *statusMessage)
 Print the meta assertion passed or failed message. More...
 
- Protected Member Functions inherited from aunit::Assertion
 Assertion ()
 Empty constructor. More...
 
bool isOutputEnabled (bool ok)
 Returns true if an assertion message should be printed. More...
 
bool assertionBool (const char *file, uint16_t line, bool arg, bool value)
 
bool assertion (const char *file, uint16_t line, bool lhs, const char *opName, bool(*op)(bool lhs, bool rhs), bool rhs)
 
bool assertion (const char *file, uint16_t line, char lhs, const char *opName, bool(*op)(char lhs, char rhs), char rhs)
 
bool assertion (const char *file, uint16_t line, int lhs, const char *opName, bool(*op)(int lhs, int rhs), int rhs)
 
bool assertion (const char *file, uint16_t line, unsigned int lhs, const char *opName, bool(*op)(unsigned int lhs, unsigned int rhs), unsigned int rhs)
 
bool assertion (const char *file, uint16_t line, long lhs, const char *opName, bool(*op)(long lhs, long rhs), long rhs)
 
bool assertion (const char *file, uint16_t line, unsigned long lhs, const char *opName, bool(*op)(unsigned long lhs, unsigned long rhs), unsigned long rhs)
 
bool assertion (const char *file, uint16_t line, double lhs, const char *opName, bool(*op)(double lhs, double rhs), double rhs)
 
bool assertion (const char *file, uint16_t line, const char *lhs, const char *opName, bool(*op)(const char *lhs, const char *rhs), const char *rhs)
 
bool assertion (const char *file, uint16_t line, const char *lhs, const char *opName, bool(*op)(const char *lhs, const String &rhs), const String &rhs)
 
bool assertion (const char *file, uint16_t line, const char *lhs, const char *opName, bool(*op)(const char *lhs, const __FlashStringHelper *rhs), const __FlashStringHelper *rhs)
 
bool assertion (const char *file, uint16_t line, const String &lhs, const char *opName, bool(*op)(const String &lhs, const char *rhs), const char *rhs)
 
bool assertion (const char *file, uint16_t line, const String &lhs, const char *opName, bool(*op)(const String &lhs, const String &rhs), const String &rhs)
 
bool assertion (const char *file, uint16_t line, const String &lhs, const char *opName, bool(*op)(const String &lhs, const __FlashStringHelper *rhs), const __FlashStringHelper *rhs)
 
bool assertion (const char *file, uint16_t line, const __FlashStringHelper *lhs, const char *opName, bool(*op)(const __FlashStringHelper *lhs, const char *rhs), const char *rhs)
 
bool assertion (const char *file, uint16_t line, const __FlashStringHelper *lhs, const char *opName, bool(*op)(const __FlashStringHelper *lhs, const String &rhs), const String &rhs)
 
bool assertion (const char *file, uint16_t line, const __FlashStringHelper *lhs, const char *opName, bool(*op)(const __FlashStringHelper *lhs, const __FlashStringHelper *rhs), const __FlashStringHelper *rhs)
 
bool assertionBoolVerbose (const char *file, uint16_t line, bool arg, internal::FlashStringType argString, bool value)
 
bool assertionVerbose (const char *file, uint16_t line, bool lhs, internal::FlashStringType lhsString, const char *opName, bool(*op)(bool lhs, bool rhs), bool rhs, internal::FlashStringType rhsString)
 
bool assertionVerbose (const char *file, uint16_t line, char lhs, internal::FlashStringType lhsString, const char *opName, bool(*op)(char lhs, char rhs), char rhs, internal::FlashStringType rhsString)
 
bool assertionVerbose (const char *file, uint16_t line, int lhs, internal::FlashStringType lhsString, const char *opName, bool(*op)(int lhs, int rhs), int rhs, internal::FlashStringType rhsString)
 
bool assertionVerbose (const char *file, uint16_t line, unsigned int lhs, internal::FlashStringType lhsString, const char *opName, bool(*op)(unsigned int lhs, unsigned int rhs), unsigned int rhs, internal::FlashStringType rhsString)
 
bool assertionVerbose (const char *file, uint16_t line, long lhs, internal::FlashStringType lhsString, const char *opName, bool(*op)(long lhs, long rhs), long rhs, internal::FlashStringType rhsString)
 
bool assertionVerbose (const char *file, uint16_t line, unsigned long lhs, internal::FlashStringType lhsString, const char *opName, bool(*op)(unsigned long lhs, unsigned long rhs), unsigned long rhs, internal::FlashStringType rhsString)
 
bool assertionVerbose (const char *file, uint16_t line, double lhs, internal::FlashStringType lhsString, const char *opName, bool(*op)(double lhs, double rhs), double rhs, internal::FlashStringType rhsString)
 
bool assertionVerbose (const char *file, uint16_t line, const char *lhs, internal::FlashStringType lhsString, const char *opName, bool(*op)(const char *lhs, const char *rhs), const char *rhs, internal::FlashStringType rhsString)
 
bool assertionVerbose (const char *file, uint16_t line, const char *lhs, internal::FlashStringType lhsString, const char *opName, bool(*op)(const char *lhs, const String &rhs), const String &rhs, internal::FlashStringType rhsString)
 
bool assertionVerbose (const char *file, uint16_t line, const char *lhs, internal::FlashStringType lhsString, const char *opName, bool(*op)(const char *lhs, const __FlashStringHelper *rhs), const __FlashStringHelper *rhs, internal::FlashStringType rhsString)
 
bool assertionVerbose (const char *file, uint16_t line, const String &lhs, internal::FlashStringType lhsString, const char *opName, bool(*op)(const String &lhs, const char *rhs), const char *rhs, internal::FlashStringType rhsString)
 
bool assertionVerbose (const char *file, uint16_t line, const String &lhs, internal::FlashStringType lhsString, const char *opName, bool(*op)(const String &lhs, const String &rhs), const String &rhs, internal::FlashStringType rhsString)
 
bool assertionVerbose (const char *file, uint16_t line, const String &lhs, internal::FlashStringType lhsString, const char *opName, bool(*op)(const String &lhs, const __FlashStringHelper *rhs), const __FlashStringHelper *rhs, internal::FlashStringType rhsString)
 
bool assertionVerbose (const char *file, uint16_t line, const __FlashStringHelper *lhs, internal::FlashStringType lhsString, const char *opName, bool(*op)(const __FlashStringHelper *lhs, const char *rhs), const char *rhs, internal::FlashStringType rhsString)
 
bool assertionVerbose (const char *file, uint16_t line, const __FlashStringHelper *lhs, internal::FlashStringType lhsString, const char *opName, bool(*op)(const __FlashStringHelper *lhs, const String &rhs), const String &rhs, internal::FlashStringType rhsString)
 
bool assertionVerbose (const char *file, uint16_t line, const __FlashStringHelper *lhs, internal::FlashStringType lhsString, const char *opName, bool(*op)(const __FlashStringHelper *lhs, const __FlashStringHelper *rhs), const __FlashStringHelper *rhs, internal::FlashStringType rhsString)
 
- Protected Member Functions inherited from aunit::Test
void fail ()
 Mark the test as failed. More...
 
void pass ()
 Mark the test as passed. More...
 
void init (const char *name)
 
void init (const __FlashStringHelper *name)
 
bool isVerbosity (uint8_t verbosity)
 Determine if any of the given verbosity is enabled. More...
 
uint8_t getVerbosity ()
 Get the verbosity. More...
 
- Static Protected Attributes inherited from aunit::MetaAssertion
static const char kMessageDone []
 
static const char kMessageNotDone [] = "not done"
 
static const char kMessagePassed [] = "passed"
 
static const char kMessageNotPassed [] = "not passed"
 
static const char kMessageFailed [] = "failed"
 
static const char kMessageNotFailed [] = "not failed"
 
static const char kMessageSkipped [] = "skipped"
 
static const char kMessageNotSkipped [] = "not skipped"
 
static const char kMessageExpired [] = "timed out"
 
static const char kMessageNotExpired [] = "not timed out"
 

Detailed Description

Similar to TestAgain but performs user-defined test only once.

Definition at line 40 of file TestOnce.h.

Constructor & Destructor Documentation

◆ TestOnce()

aunit::TestOnce::TestOnce ( )
inline

Constructor.

Definition at line 43 of file TestOnce.h.

Member Function Documentation

◆ loop()

void aunit::TestOnce::loop ( )
overridevirtual

Calls the user-provided once() method.

If no other assertXxx() macros set the internal status, then this calls pass() to make sure that this test case will be called only once from Test::run().

Implements aunit::Test.

Definition at line 29 of file TestOnce.cpp.

◆ once()

virtual void aunit::TestOnce::once ( )
pure virtual

User-provided test case.


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