Referencia de la Clase TestCase

Cada caso de prueba es una instancia derivada de esta clase abstracta. Más...

#include <ADH_test.h>

Diagrama de herencias de TestCase

Lista de todos los miembros.

Métodos públicos
	TestCase (const char *name=0)
	Constructor.
virtual	~TestCase ()
	Destructor.
virtual bool	run ()=0
	[virtual] ==> Ejecuta la prueba y retorna "false" si produce error.
void	runBare ()
	Ejecuta la prueba setUp(); run(); tearDown();.
bool	Run ()
	Sinónimo de run().
bool	runTest ()
	Sinónimo de run().
virtual void	setUp ()
	Establece el ambiente en que se realizará cada prueba.
virtual void	tearDown ()
	Destruye el ambiente de prueba.
int	countTestCases () const
	Cantidad de casos de prueba que serán ejecutados.
int	runCount () const
	Cantidad total de pruebas realizadas.
virtual int	errorCount () const
	Cantidad de pruebas que han producido error. reset().
int	failureCount () const
	Siempre retorna 0 (cero): "Cantidad de fallas".
virtual int	successCount () const
	Cantidad de pruebas exitosas.
bool	wasSuccessful () const
	Retorna "true" si todas las pruebas han sido exitosas.
virtual void	reset ()
	Elimina todas las pruebas realizadas.
std::string	getName () const
	Obtiene el nombre de la prueba. setName().
void	setName (const char *name=0)
	Le cambia el nombre a la prueba.
virtual const std::string	toString () const
	Hilera "enooorme" que contiene copia del registro de pruebas no exitosas, separados por "\n".
virtual const std::string	summary () const
	Retorna un hilera que contiene el nombre, cantidad de éxitos y cantidad de errores de la prueba.
virtual const std::string	toXML () const
	Hilera XML que contiene una copia de las pruebas no exitosas.
const std::string	report () const
	Retorna la hilera encabezado summary() seguido de errores toString().
const std::string	errorString () const
	Sinónimo de toString().
Métodos públicos estáticos
template<class T>
static std::string	toString (const T &val)
	Retorna una hilera que contiene el valor de val.
Métodos protegidos
void	recordSuccess ()
	Registra como exitoso el resultado de una prueba.
void	recordError (const char *label, const char *fname, int lineno, bool must_copy=false)
	Registra que la prueba no tuvo éxito.
void	recordError (const std::string &label, const char *fname, int lineno)
	Registra que la prueba no tuvo éxito.
void	testThis (bool cond, const std::string &label, const char *fname, long lineno)
	Sinónimo de testThis();.
void	testThis (bool cond, const char *label, const char *fname, long lineno, bool must_copy=false)
	Efectúa la prueba y registra el resultado.
int	nPass () const
	Sinónimo de successCount() [OBSOLETO].
int	nError () const
	Sinónimo de errorCount() [OBSOLETO].
Atributos protegidos
int	m_pass
	Cantidad de pruebas exitosas.
int	m_error
	Cantidad de pruebas que han producido error.
const char *	m_name
	Nombre del caso de prueba.
bool	m_test_suite_destroy
	Indica si la prueba está en memoria dinámica.
std::list< TestCaseError >	m_errorList
	Contenedor para registrar las pruebas que han producido error.
Métodos privados
virtual bool	iAmTestSuite () const
	Retorna false para TestCase.
	TestCase (const TestCase &)
	"private" evita la copia de casos de prueba
TestCase &	operator= (const TestCase &)
	"private" evita la copia de casos de prueba
Amigas
class	TestSuite
	Colección de pruebas.
class	test_ADH_test
	Clase de prueba para ADH_test.h.
template<class TestCase>
void	do_toXML (const TestCase *tc, std::basic_ostringstream< char > &ost)
	Le agrega a ost la hilera de todas las pruebas no exitosas de *tc en formato XML.
template<class TestCase>
void	do_toString (const TestCase *tc, std::basic_ostringstream< char > &ost)
	Le agrega a ost la hilera de todas las pruebas no exitosas de *tc.

---

Descripción detallada

Cada caso de prueba es una instancia derivada de esta clase abstracta.

• Siempre es obligatorio implementar TestCase::run().

Definición en la línea 131 del archivo ADH_test.h.

---

Documentación del constructor y destructor

TestCase::TestCase (  const char *  name = 0  )  [inline]

Constructor. Si no se indica el nombre en "name", el nombre se obtiene con typeid(*this).name(). Ver también: test_ADH_test::test_constructor() Definición en la línea 207 del archivo ADH_test.h.

virtual TestCase::~TestCase (   )  [inline, virtual]

Destructor. Definición en la línea 141 del archivo ADH_test.h.

TestCase::TestCase (  const TestCase &   )  [private]

"private" evita la copia de casos de prueba

---

Documentación de las funciones miembro

virtual bool TestCase::run (   )  [pure virtual]

[virtual] ==> Ejecuta la prueba y retorna "false" si produce error. [***] Siempre es necesario redefinir el método run(). Ver también: runBare(). Implementado en ADH::test_Graph.

void TestCase::runBare (   )  [inline]

Ejecuta la prueba setUp(); run(); tearDown();. A diferencia de run(), este método si establece el ambiente de prueba invocando setUp() y tearDown() antes y después de hacer la prueba. Ver también: test_ADH_test::test_run() Definición en la línea 250 del archivo ADH_test.h.

bool TestCase::Run (   )  [inline]

Sinónimo de run(). Definición en la línea 147 del archivo ADH_test.h.

bool TestCase::runTest (   )  [inline]

Sinónimo de run(). Definición en la línea 148 del archivo ADH_test.h.

void TestCase::setUp (   )  [inline, virtual]

Establece el ambiente en que se realizará cada prueba. Como TestCase::run() es un método abstracto, para facilitar la programación lo usual es que el programador no incluya invocaciones a TestCase::setUp() y TestCase::tearDown() pues es más simple dejar que lo haga TestSuite<TestCase>::runBare(). A diferencia de TestCase::runBare(), el método TestCase::run() no establece el ambiente de prueba porque no invoca ni a TestCase::setUp() antes de la prueba ni a TestCase::tearDown() después . TestSuite<TestCase>::runBare() invoca los métodos TestCase::setUp() y TestCase::tearDown() cuando ejecuta cada prueba. Por eso, si el programador cliente quiere que cada prueba se ejecute luego de establecer el ambiente de la prueba, lo más práctico es que agregue sus pruebas a una colección de pruebas TestSuite para ejecutarlas con TestSuite<TestCase>::runBare(). Reimplementado en ADH::test_Graph. Definición en la línea 276 del archivo ADH_test.h.

void TestCase::tearDown (   )  [inline, virtual]

Destruye el ambiente de prueba. Definición en la línea 279 del archivo ADH_test.h.

int TestCase::countTestCases (   )  const [inline]

Cantidad de casos de prueba que serán ejecutados. Definición en la línea 151 del archivo ADH_test.h.

int TestCase::runCount (   )  const [inline]

Cantidad total de pruebas realizadas. Sinónimo de successCount()+errorCount()+failureCount(). Ver también: reset(). Definición en la línea 155 del archivo ADH_test.h.

virtual int TestCase::errorCount (   )  const [inline, virtual]

Cantidad de pruebas que han producido error. reset(). Definición en la línea 157 del archivo ADH_test.h.

int TestCase::failureCount (   )  const [inline]

Siempre retorna 0 (cero): "Cantidad de fallas". ADH_test no hace diferencia entre "errores" y "fallas" Ver también: http://osdir.com/ml/java.junit.user/2002-06/msg00114.html Definición en la línea 161 del archivo ADH_test.h.

virtual int TestCase::successCount (   )  const [inline, virtual]

Cantidad de pruebas exitosas. Ver también: reset(). Definición en la línea 162 del archivo ADH_test.h.

bool TestCase::wasSuccessful (   )  const [inline]

Retorna "true" si todas las pruebas han sido exitosas. Sinónimo de (successCount() == runCount()) Definición en la línea 165 del archivo ADH_test.h.

void TestCase::reset (   )  [inline, virtual]

Elimina todas las pruebas realizadas. Anula los contadores de pruebas porque deja la clase en el estado inicial que tuvo al ser construida. Borra el registro de pruebas no exitosas. No borra el nombre de la prueba. Ver también: test_ADH_test::test_reset() Definición en la línea 221 del archivo ADH_test.h.

std::string TestCase::getName (   )  const [inline]

Obtiene el nombre de la prueba. setName(). Definición en la línea 226 del archivo ADH_test.h.

void TestCase::setName (  const char *  name = 0  )  [inline]

Le cambia el nombre a la prueba. Ver también: test_ADH_test::test_setName() Definición en la línea 236 del archivo ADH_test.h.

const std::string TestCase::toString (   )  const [inline, virtual]

Hilera "enooorme" que contiene copia del registro de pruebas no exitosas, separados por "\n". =\_error: 1 == 0 =/ (125) X:\DIR\SubDir\test_ADH_test.cpp =\_error: 4 == 0 =/ (128) X:\DIR\SubDir\test_ADH_test.cpp Definición en la línea 358 del archivo ADH_test.h.

const std::string TestCase::summary (   )  const [inline, virtual]

Retorna un hilera que contiene el nombre, cantidad de éxitos y cantidad de errores de la prueba. Definición en la línea 490 del archivo ADH_test.h.

const std::string TestCase::toXML (   )  const [inline, virtual]

Hilera XML que contiene una copia de las pruebas no exitosas. <error file="X:\DIR\SubDir\test_ADH_test.cpp" line="125" message="1 == 0"/> <error file="X:\DIR\SubDir\test_ADH_test.cpp" line="128" message="4 == 0"/> Definición en la línea 390 del archivo ADH_test.h.

const std::string TestCase::report (   )  const [inline]

Retorna la hilera encabezado summary() seguido de errores toString(). Definición en la línea 175 del archivo ADH_test.h.

const std::string TestCase::errorString (   )  const [inline]

Sinónimo de toString(). Definición en la línea 176 del archivo ADH_test.h.

template<class T> std::string TestCase::toString (  const T &  val  )  [static]

Retorna una hilera que contiene el valor de val. toString() with standard C++ Definición en la línea 519 del archivo ADH_test.h.

void TestCase::recordSuccess (   )  [inline, protected]

Registra como exitoso el resultado de una prueba. Definición en la línea 179 del archivo ADH_test.h.

void TestCase::recordError (  const char *  label, const char *  fname, int  lineno, bool  must_copy = false )  [inline, protected]

Registra que la prueba no tuvo éxito. Los valores "fname" y "lineno" indican el archivo y el renglón en donde se ejecuta la prueba. Usualmente los valores de "fname" y "lineno" se obtienen con las macros globales "__FILE__" y "__LINE__". El valor "must_copy" indica que es necesario hacer una copia de la hilera "label", copia que será destruida cuando el registro de pruebas no exitosas sea borrado. En la mayor parte de los casos, la hilera "label" es una constante generada por el preprocesador al usar la macro #cond y por eso su memoria no debe ser retornada. Este método es invocado usando la macro ADH_test_ERROR(). Definición en la línea 329 del archivo ADH_test.h.

void TestCase::recordError (  const std::string &  label, const char *  fname, int  lineno )  [inline, protected]

Registra que la prueba no tuvo éxito. En ADH_test.h no se hace diferencia entre "fallas" y "errores". Definición en la línea 342 del archivo ADH_test.h.

void TestCase::testThis (  bool  cond, const std::string &  label, const char *  fname, long  lineno )  [inline, protected]

Sinónimo de testThis();. Definición en la línea 311 del archivo ADH_test.h.

void TestCase::testThis (  bool  cond, const char *  label, const char *  fname, long  lineno, bool  must_copy = false )  [inline, protected]

Efectúa la prueba y registra el resultado. Si la prueba es exitosa sólo incrementa la cantidad de éxitos successCount(). Si la prueba no tiene éxito reporta en toString() el hecho. La prueba es "cond". Los valores "fname" y "lineno" indican el archivo y el renglón en donde se ejecuta la prueba. Usualmente los valores de "fname" y "lineno" se obtienen con las macros globales "__FILE__" y "__LINE__". El valor "must_copy" indica que es necesario hacer una copia de la hilera "label", copia que será destruida cuando el registro de pruebas no exitosas sea borrado. En la mayor parte de los casos, la hilera "label" es una constante generada por el preprocesador al usar la macro #cond y por eso su memoria no debe ser retornada. Este método es invocado usando la macro ADH_test_TEST(). Ver también: test_ADH_test::test_testThis() Definición en la línea 302 del archivo ADH_test.h.

int TestCase::nPass (   )  const [inline, protected]

Sinónimo de successCount() [OBSOLETO]. Desaprobado: Definición en la línea 187 del archivo ADH_test.h.

int TestCase::nError (   )  const [inline, protected]

Sinónimo de errorCount() [OBSOLETO]. Desaprobado: Definición en la línea 188 del archivo ADH_test.h.

virtual bool TestCase::iAmTestSuite (   )  const [inline, private, virtual]

Retorna false para TestCase. Definición en la línea 190 del archivo ADH_test.h.

TestCase& TestCase::operator= (  const TestCase &   )  [private]

"private" evita la copia de casos de prueba

---

Documentación de las funciones relacionadas y clases amigas

friend class TestSuite [friend]

Colección de pruebas. Definición en la línea 186 del archivo ADH_test.h.

friend class test_ADH_test [friend]

Clase de prueba para ADH_test.h. Definición en la línea 193 del archivo ADH_test.h.

template<class TestCase> void do_toXML (  const TestCase *  tc, std::basic_ostringstream< char > &  ost )  [friend]

Le agrega a ost la hilera de todas las pruebas no exitosas de *tc en formato XML. Definición en la línea 399 del archivo ADH_test.h.

template<class TestCase> void do_toString (  const TestCase *  tc, std::basic_ostringstream< char > &  ost )  [friend]

Le agrega a ost la hilera de todas las pruebas no exitosas de *tc. Definición en la línea 367 del archivo ADH_test.h.

---

Documentación de los datos miembro

int TestCase::m_pass [protected]

Cantidad de pruebas exitosas. Definición en la línea 133 del archivo ADH_test.h.

int TestCase::m_error [protected]

Cantidad de pruebas que han producido error. Definición en la línea 134 del archivo ADH_test.h.

const char* TestCase::m_name [protected]

Nombre del caso de prueba. Definición en la línea 135 del archivo ADH_test.h.

bool TestCase::m_test_suite_destroy [protected]

Indica si la prueba está en memoria dinámica. Definición en la línea 136 del archivo ADH_test.h.

std::list<TestCaseError> TestCase::m_errorList [protected]

Contenedor para registrar las pruebas que han producido error. Definición en la línea 138 del archivo ADH_test.h.

---

La documentación para esta clase fué generada a partir del siguiente archivo:

• ADH_test.h

---

Hosted by www.Geocities.ws