Inheritance diagram for xtd::tunit::directory_assert:

Definition

The directory_assert class contains a collection of static methods that implement the most directory assertions used in xtd::tUnit.

Namespace: xtd::tunit

Library: xtd.tunit

Remarks: Assertions are central to unit testing in any of the xUnit frameworks, and xtd.tunit is no exception. xtd.tunit provides a rich set of assertions as static methods of the Assert class.; If an assertion fails, the method call does not return and an error is reported. If a test contains multiple assertions, any that follow the one that failed will not be executed. For this reason, it's usually best to try for one assertion per test.; Each method may be called without a message, with a simple text message or with a message and arguments. In the last case the message is formatted using the provided text and arguments.

Examples: This example show how to used some methods :
#include <xtd/xtd.tunit>

#include <stdexcept>

using namespace xtd;

using namespace xtd::io;

using namespace xtd::tunit;

namespace unit_tests {

// The class test must be declared with test_class_ helper.

class test_class_(test) {

void test_method_(test_case1) {

directory_assert::exists(path::get_temp_path());

}

void test_method_(test_case2) {

directory_assert::exists(path::combine("unknown root folder", "unknown sub folder", "unknown xtd example folder"));

}

void test_method_(test_case3) {

directory_assert::are_equal(directory_info {environment::get_folder_path(environment::special_folder::my_music)}, directory_info {environment::get_folder_path(environment::special_folder::my_videos)});

}

};

}

auto main() -> int {

return console_unit_test().run();

}

// This code can produce the following output :

//

// Start 3 tests from 1 test case

// Run tests:

// SUCCEED unit_tests::test.test_case1 (0 ms total)

// FAILED unit_tests::test.test_case2 (0 ms total)

// Expected: directory exists

// But was: "unknown root folder/unknown sub folder/unknown xtd example folder"

// Stack Trace: in |---OMITTED---|/directory_assert.cpp:16

// FAILED unit_tests::test.test_case3 (0 ms total)

// Expected: "|---OMITTED---|/Music"

// But was: "|---OMITTED---|/Movies"

// Stack Trace: in |---OMITTED---|/directory_assert.cpp:20

//

// Test results:

// SUCCEED 1 test.

// FAILED 2 tests.

// End 3 tests from 1 test case ran. (0 ms total)

xtd::io::directory_info
Exposes instance methods for creating, moving, and enumerating through directories and subdirectories...
Definition directory_info.hpp:129

xtd::tunit::console_unit_test
The console_unit_test class is console unit test interface.
Definition console_unit_test.hpp:23

xtd::tunit::unit_test::run
int32 run() noexcept
Runs all tests in this unit_test object and prints the result.

test_method_
#define test_method_(method_name)
Add test method to class test.
Definition test_method_attribute.hpp:73

xtd::io
The xtd::io namespace contains types that allow reading and writing to files and data streams,...
Definition binary_reader.hpp:16

xtd::tunit
The tunit namespace contains a unit test library.
Definition abort_error.hpp:10

xtd
The xtd namespace contains all fundamental classes to access Hardware, Os, System,...
Definition xtd_about_box.hpp:10

Public Static Methods
static void	are_equal (const xtd::io::directory_info &expected, const xtd::io::directory_info &actual, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Asserts that two xtd::io::directory_info are equal.

static void	are_equal (const xtd::io::directory_info &expected, const xtd::io::directory_info &actual, const std::string &message, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Asserts that two xtd::io::directory_info are equal.

static void	are_not_equal (const xtd::io::directory_info &expected, const xtd::io::directory_info &actual, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Asserts that two xtd::io::directory_info are not equal.

static void	are_not_equal (const xtd::io::directory_info &expected, const xtd::io::directory_info &actual, const std::string &message, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Asserts that two xtd::io::directory_info are not equal.

static void	does_not_exist (const xtd::io::directory_info &directory, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Asserts that directory not exists.

static void	does_not_exist (const xtd::io::directory_info &directory, const std::string &message, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Asserts that directory not exists.

template<typename char_t >
static void	does_not_exist (const xtd::basic_string< char_t > &directory, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Asserts that directory not exists.

template<typename char_t >
static void	does_not_exist (const xtd::basic_string< char_t > &directory, const std::string &message, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Asserts that directory not exists.

static void	exists (const xtd::io::directory_info &directory, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Asserts that directory exists.

static void	exists (const xtd::io::directory_info &directory, const std::string &message, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Asserts that directory exists.

template<typename char_t >
static void	exists (const xtd::basic_string< char_t > &directory, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Asserts that directory exists.

template<typename char_t >
static void	exists (const xtd::basic_string< char_t > &directory, const std::string &message, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Asserts that directory exists.

Member Function Documentation

◆ are_equal() [1/2]

static void xtd::tunit::directory_assert::are_equal	(	const xtd::io::directory_info &	expected,
		const xtd::io::directory_info &	actual,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

static

Asserts that two xtd::io::directory_info are equal.

Parameters

expected	the expected value.
actual	the actual value.
stack_frame	Contains information about current file and current line.

Exceptions

xtd::tunit::assert_error If bad assertion.

Examples: xtd::io::directory_info d1(".");

xtd::io::directory_info d2(".")

xtd::io::directory_info d3("..")

xtd::tunit::directory_assert::are_equal(d1, d2); // test ok.

xtd::tunit::directory_assert::are_equal(d1, d3); // test throws an assert_error exception.

xtd::tunit::directory_assert
The directory_assert class contains a collection of static methods that implement the most directory ...
Definition directory_assert.hpp:31

xtd::tunit::directory_assert::are_equal
static void are_equal(const xtd::io::directory_info &expected, const xtd::io::directory_info &actual, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
Asserts that two xtd::io::directory_info are equal.

xtd::console_key::d1
@ d1
The 1 key.

xtd::console_key::d2
@ d2
The 2 key.

xtd::console_key::d3
@ d3
The 3 key.

◆ are_equal() [2/2]

static void xtd::tunit::directory_assert::are_equal	(	const xtd::io::directory_info &	expected,
		const xtd::io::directory_info &	actual,
		const std::string &	message,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

static

Asserts that two xtd::io::directory_info are equal.

Parameters

expected	the expected value.
actual	the actual value.
message	A user message to display if the assertion fails. This message can be seen in the unit test results.
stack_frame	Contains information about current file and current line.

Exceptions

xtd::tunit::assert_error If bad assertion.

Examples: xtd::io::directory_info d1(".");

xtd::io::directory_info d2(".")

xtd::io::directory_info d3("..")

xtd::tunit::directory_assert::are_equal(d1, d2, "User message..."); // test ok.

xtd::tunit::directory_assert::are_equal(d1, d3, "User message..."); // test throws an assert_error exception.

◆ are_not_equal() [1/2]

static void xtd::tunit::directory_assert::are_not_equal	(	const xtd::io::directory_info &	expected,
		const xtd::io::directory_info &	actual,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

static

Asserts that two xtd::io::directory_info are not equal.

Parameters

expected	the expected value.
actual	the actual value.
stack_frame	Contains information about current file and current line.

Exceptions

xtd::tunit::assert_error If bad assertion.

Examples: xtd::io::directory_info d1(".");

xtd::io::directory_info d2(".")

xtd::io::directory_info d3("..")

xtd::tunit::directory_assert::are_not_equal(d1, d3, "User message..."); // test ok.

xtd::tunit::directory_assert::are_not_equal(d1, d2, "User message..."); // test throws an assert_error exception.

xtd::tunit::directory_assert::are_not_equal
static void are_not_equal(const xtd::io::directory_info &expected, const xtd::io::directory_info &actual, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
Asserts that two xtd::io::directory_info are not equal.

◆ are_not_equal() [2/2]

static void xtd::tunit::directory_assert::are_not_equal	(	const xtd::io::directory_info &	expected,
		const xtd::io::directory_info &	actual,
		const std::string &	message,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

static

Asserts that two xtd::io::directory_info are not equal.

Parameters

expected	the expected value.
actual	the actual value.
message	A user message to display if the assertion fails. This message can be seen in the unit test results.
stack_frame	Contains information about current file and current line.

Exceptions

xtd::tunit::assert_error If bad assertion.

Examples: xtd::io::directory_info d1(".");

xtd::io::directory_info d2(".")

xtd::io::directory_info d3("..")

xtd::tunit::directory_assert::are_not_equal(d1, d3, "User message..."); // test ok.

xtd::tunit::directory_assert::are_not_equal(d1, d2, "User message..."); // test throws an assert_error exception.

◆ does_not_exist() [1/4]

static void xtd::tunit::directory_assert::does_not_exist	(	const xtd::io::directory_info &	directory,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

static

Asserts that directory not exists.

Parameters

expected	the expected value.
actual	the actual value.
stack_frame	Contains information about current file and current line.

Exceptions

xtd::tunit::assert_error If bad assertion.

Examples: xtd::io::directory_info d1(environment::get_folder_path(environment::special_folder::common_application_data));

xtd::io::directory_info d2(xtd::io::path::combine(environment::get_folder_path(environment::special_folder::common_application_data), "__xtd_test_directory_not_found__"));

xtd::tunit::directory_assert::does_not_exist(d2); // test ok.

xtd::tunit::directory_assert::does_not_exist(d1); // test throws an assert_error exception.

xtd::environment::special_folder::common_application_data
@ common_application_data
The directory that serves as a common repository for application-specific data that is used by all us...

xtd::environment::get_folder_path
static xtd::string get_folder_path(environment::special_folder folder)
Gets the path to the system special folder that is identified by the specified enumeration.
Definition environment.hpp:608

xtd::io::path::combine
static xtd::string combine(const xtd::string &path1, const xtd::string &path2)
Combines two path strings.

xtd::tunit::directory_assert::does_not_exist
static void does_not_exist(const xtd::io::directory_info &directory, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
Asserts that directory not exists.

◆ does_not_exist() [2/4]

static void xtd::tunit::directory_assert::does_not_exist	(	const xtd::io::directory_info &	directory,
		const std::string &	message,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

static

Asserts that directory not exists.

Parameters

expected	the expected value.
actual	the actual value.
message	A user message to display if the assertion fails. This message can be seen in the unit test results.
stack_frame	Contains information about current file and current line.

Exceptions

xtd::tunit::assert_error If bad assertion.

Examples: xtd::io::directory_info d1(environment::get_folder_path(environment::special_folder::common_application_data));

xtd::io::directory_info d2(xtd::io::path::combine(environment::get_folder_path(environment::special_folder::common_application_data), "__xtd_test_directory_not_found__"));

xtd::tunit::directory_assert::does_not_exist(d2); // test ok.

xtd::tunit::directory_assert::does_not_exist(d1); // test throws an assert_error exception.

◆ does_not_exist() [3/4]

template<typename char_t >

static void xtd::tunit::directory_assert::does_not_exist	(	const xtd::basic_string< char_t > &	directory,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

inlinestatic

Asserts that directory not exists.

Parameters

expected	the expected value.
actual	the actual value.
stack_frame	Contains information about current file and current line.

Exceptions

xtd::tunit::assert_error If bad assertion.

Examples: xtd::string d1 = environment::get_folder_path(environment::special_folder::common_application_data);

xtd::utring d2 = xtd::io::path::combine(environment::get_folder_path(environment::special_folder::common_application_data), "__xtd_test_directory_not_found__");

xtd::tunit::directory_assert::does_not_exist(d2); // test ok.

xtd::tunit::directory_assert::does_not_exist(d1); // test throws an assert_error exception.

xtd::basic_string
Represents text as a sequence of character units.
Definition basic_string.hpp:79

◆ does_not_exist() [4/4]

template<typename char_t >

static void xtd::tunit::directory_assert::does_not_exist	(	const xtd::basic_string< char_t > &	directory,
		const std::string &	message,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

inlinestatic

Asserts that directory not exists.

Parameters

expected	the expected value.
actual	the actual value.
message	A user message to display if the assertion fails. This message can be seen in the unit test results.
stack_frame	Contains information about current file and current line.

Exceptions

xtd::tunit::assert_error If bad assertion.

Examples: xtd::string d1 = environment::get_folder_path(environment::special_folder::common_application_data);

xtd::utring d2 = xtd::io::path::combine(environment::get_folder_path(environment::special_folder::common_application_data), "__xtd_test_directory_not_found__");

xtd::tunit::directory_assert::does_not_exist(d2); // test ok.

xtd::tunit::directory_assert::does_not_exist(d1); // test throws an assert_error exception.

◆ exists() [1/4]

static void xtd::tunit::directory_assert::exists	(	const xtd::io::directory_info &	directory,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

static

Asserts that directory exists.

Parameters

expected	the expected value.
actual	the actual value.
stack_frame	Contains information about current file and current line.

Exceptions

xtd::tunit::assert_error If bad assertion.

Examples: xtd::string d1 = environment::get_folder_path(environment::special_folder::common_application_data);

xtd::utring d2 = xtd::io::path::combine(environment::get_folder_path(environment::special_folder::common_application_data), "__xtd_test_directory_not_found__");

xtd::tunit::directory_assert::exists(d1); // test ok.

xtd::tunit::directory_assert::exists(d2); // test throws an assert_error exception.

xtd::tunit::directory_assert::exists
static void exists(const xtd::io::directory_info &directory, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
Asserts that directory exists.

◆ exists() [2/4]

static void xtd::tunit::directory_assert::exists	(	const xtd::io::directory_info &	directory,
		const std::string &	message,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

static

Asserts that directory exists.

Parameters

expected	the expected value.
actual	the actual value.
message	A user message to display if the assertion fails. This message can be seen in the unit test results.
stack_frame	Contains information about current file and current line.

Exceptions

xtd::tunit::assert_error If bad assertion.

Examples: xtd::string d1 = environment::get_folder_path(environment::special_folder::common_application_data);

xtd::utring d2 = xtd::io::path::combine(environment::get_folder_path(environment::special_folder::common_application_data), "__xtd_test_directory_not_found__");

xtd::tunit::directory_assert::exists(d1); // test ok.

xtd::tunit::directory_assert::exists(d2); // test throws an assert_error exception.

◆ exists() [3/4]

template<typename char_t >

static void xtd::tunit::directory_assert::exists	(	const xtd::basic_string< char_t > &	directory,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

inlinestatic

Asserts that directory exists.

Parameters

expected	the expected value.
actual	the actual value.
stack_frame	Contains information about current file and current line.

Exceptions

xtd::tunit::assert_error If bad assertion.

Examples: xtd::string d1 = environment::get_folder_path(environment::special_folder::common_application_data);

xtd::utring d2 = xtd::io::path::combine(environment::get_folder_path(environment::special_folder::common_application_data), "__xtd_test_directory_not_found__");

xtd::tunit::directory_assert::exists(d1); // test ok.

xtd::tunit::directory_assert::exists(d2); // test throws an assert_error exception.

◆ exists() [4/4]

template<typename char_t >

static void xtd::tunit::directory_assert::exists	(	const xtd::basic_string< char_t > &	directory,
		const std::string &	message,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

inlinestatic

Asserts that directory exists.

Parameters

expected	the expected value.
actual	the actual value.
message	A user message to display if the assertion fails. This message can be seen in the unit test results.
stack_frame	Contains information about current file and current line.

Exceptions

xtd::tunit::assert_error If bad assertion.

Examples: xtd::string d1 = environment::get_folder_path(environment::special_folder::common_application_data);

xtd::utring d2 = xtd::io::path::combine(environment::get_folder_path(environment::special_folder::common_application_data), "__xtd_test_directory_not_found__");

xtd::tunit::directory_assert::exists(d1); // test ok.

xtd::tunit::directory_assert::exists(d2); // test throws an assert_error exception.

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

xtd.tunit/include/xtd/tunit/directory_assert.hpp

Definition

Public Static Methods

Member Function Documentation

◆ are_equal() [1/2]

◆ are_equal() [2/2]

◆ are_not_equal() [1/2]

◆ are_not_equal() [2/2]

◆ does_not_exist() [1/4]

◆ does_not_exist() [2/4]

◆ does_not_exist() [3/4]

◆ does_not_exist() [4/4]

◆ exists() [1/4]

◆ exists() [2/4]

◆ exists() [3/4]

◆ exists() [4/4]