Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

PrevUpHomeNext

Class test_unit

boost::unit_test::test_unit

Synopsis

// In header: <boost/test/tree/test_unit.hpp>


class test_unit {
public:
  // types
  typedef std::vector< test_unit_id >                                  id_list;       
  typedef std::vector< test_unit_fixture_ptr >                         fixture_list_t;
  typedef std::vector< decorator::base_ptr >                           decor_list_t;  
  typedef boost::function< test_tools::assertion_result(test_unit_id)> precondition_t;

  enum { type = TUT_ANY };

  enum run_status { RS_DISABLED, RS_ENABLED, RS_INHERIT, RS_INVALID };

  // public member functions
  typedef BOOST_READONLY_PROPERTY(test_unit_id, (framework::state));
  typedef BOOST_READONLY_PROPERTY(test_unit_id, (test_suite));
  typedef BOOST_READONLY_PROPERTY(id_list, (test_unit));
  typedef BOOST_READONLY_PROPERTY(std::vector< std::string >, (test_unit));
  typedef BOOST_READONLY_PROPERTY(std::vector< precondition_t >, (test_unit));
  void depends_on(test_unit *);
  void add_precondition(precondition_t const &);
  test_tools::assertion_result check_preconditions() const;
  void add_label(const_string);
  bool has_label(const_string) const;
  void increase_exp_fail(counter_t);
  bool is_enabled() const;
  std::string full_name() const;

  // protected member functions
  ~test_unit();
  test_unit(const_string, const_string, std::size_t, test_unit_type);
  explicit test_unit(const_string);

  // public data members
  test_unit_type const p_type;  // type for this test unit 
  const_string const p_type_name;  // "case"/"suite"/"module" 
  const_string const p_file_name;
  std::size_t const p_line_num;
  id_t p_id;  // unique id for this test unit 
  parent_id_t p_parent_id;  // parent test suite id 
  label_list_t p_labels;  // list of labels associated with this test unit 
  id_list_t p_dependencies;  // list of test units this one depends on 
  precond_list_t p_preconditions;  // user supplied preconditions for this test unit; 
  readwrite_property< std::string > p_name;  // name for this test unit 
  readwrite_property< std::string > p_description;  // description for this test unit 
  readwrite_property< unsigned > p_timeout;  // timeout for the test unit execution in seconds 
  readwrite_property< counter_t > p_expected_failures;  // number of expected failures in this test unit 
  readwrite_property< run_status > p_default_status;  // run status obtained by this unit during setup phase 
  readwrite_property< run_status > p_run_status;  // run status assigned to this unit before execution phase after applying all filters 
  readwrite_property< counter_t > p_sibling_rank;  // rank of this test unit amoung siblings of the same parent 
  readwrite_property< decor_list_t > p_decorators;  // automatically assigned decorators; execution is delayed till framework::finalize_setup_phase function 
  readwrite_property< fixture_list_t > p_fixtures;  // fixtures associated with this test unit 
};

Description

test_unit public member functions

  1. typedef BOOST_READONLY_PROPERTY(test_unit_id, (framework::state));
  2. typedef BOOST_READONLY_PROPERTY(test_unit_id, (test_suite));
  3. typedef BOOST_READONLY_PROPERTY(id_list, (test_unit));
  4. typedef BOOST_READONLY_PROPERTY(std::vector< std::string >, (test_unit));
  5. typedef BOOST_READONLY_PROPERTY(std::vector< precondition_t >, (test_unit));
  6. void depends_on(test_unit * tu);
  7. void add_precondition(precondition_t const &);
  8. test_tools::assertion_result check_preconditions() const;
  9. void add_label(const_string l);
  10. bool has_label(const_string l) const;
  11. void increase_exp_fail(counter_t num);
  12. bool is_enabled() const;
  13. std::string full_name() const;

test_unit protected member functions

  1. ~test_unit();
  2. test_unit(const_string tu_name, const_string tc_file, std::size_t tc_line, 
              test_unit_type t);
  3. explicit test_unit(const_string module_name);

PrevUpHomeNext