xtd 0.2.0
Loading...
Searching...
No Matches
xtd::tunit::file_valid Class Referencefinal
Inheritance diagram for xtd::tunit::file_valid:
xtd::tunit::base_assert

Definition

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

Namespace
xtd::tunit
Library
xtd.tunit
Remarks
Validations are the same as assertions with the difference, no exception is thrown, but an error is generated.
If a validation fails, he test can be continued to the end or to an assertion is generated.
Examples
This example show how to used some methods :
#include <xtd/xtd.tunit>
#include <stdexcept>
using namespace std;
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) {
auto fn = path::get_temp_file_name();
file_valid::exists(fn);
file::remove(fn);
}
void test_method_(test_case2) {
auto fn = path::get_random_file_name();
file_valid::exists(fn);
// No need to remove fn because the file does not exist.
}
void test_method_(test_case3) {
auto is = istringstream {"xtd::tunit::file_valid::are_equal example."};
file_valid::are_equal(istringstream {"xtd::tunit::file_valid::are_equel example."}, is);
}
};
}
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 test.test_case1 (0 ms total)
// FAILED test.test_case2 (0 ms total)
// Expected: file exists
// But was: "t35uk5my.8v2"
// Stack Trace: in |---OMITTED---|/file_valid.cpp:18
// FAILED test.test_case3 (0 ms total)
// Expected: istream at offset 31 value e
// But was: a
// Stack Trace: in |---OMITTED---|/file_valid.cpp:24
//
// Test results:
// SUCCEED 1 test.
// FAILED 2 tests.
// End 3 tests from 1 test case ran. (0 ms total)
The console_unit_test class is console unit test interface.
Definition console_unit_test.h:23
int32 run()
Runs all tests in this unit_test object and prints the result.
#define test_method_(method_name)
Add test method to class test.
Definition test_method_attribute.h:89
bool is(std::any value)
Checks if the result of an expression is compatible with a given type.
Definition is.h:335
The xtd::io namespace contains types that allow reading and writing to files and data streams,...
Definition binary_reader.h:16
The tunit namespace contains a unit test library.
Definition abort_error.h:10

Public Static Methods

template<typename char_t >
static void are_equal (const std::basic_istream< char_t > &expected, const std::basic_istream< char_t > &actual)
 Validate that two files are equal.
 
template<typename char_t >
static void are_equal (const std::basic_istream< char_t > &expected, const std::basic_istream< char_t > &actual, const xtd::diagnostics::stack_frame &stack_frame)
 Validate that two files are equal.
 
template<typename char_t >
static void are_equal (const std::basic_istream< char_t > &expected, const std::basic_istream< char_t > &actual, const std::string &message)
 Validate that two files are equal.
 
template<typename char_t >
static void are_equal (const std::basic_istream< char_t > &expected, const std::basic_istream< char_t > &actual, const std::string &message, const xtd::diagnostics::stack_frame &stack_frame)
 Validate that two files are equal.
 
template<typename char_t >
static void are_equal (const std::basic_string< char_t > &expected, const std::basic_string< char_t > &actual)
 Validate that two files are equal.
 
template<typename char_t >
static void are_equal (const std::basic_string< char_t > &expected, const std::basic_string< char_t > &actual, const xtd::diagnostics::stack_frame &stack_frame)
 Validate that two files are equal.
 
template<typename char_t >
static void are_equal (const std::basic_string< char_t > &expected, const std::basic_string< char_t > &actual, const std::string &message)
 Validate that two files are equal.
 
template<typename char_t >
static void are_equal (const std::basic_string< char_t > &expected, const std::basic_string< char_t > &actual, const std::string &message, const xtd::diagnostics::stack_frame &stack_frame)
 Validate that two files are equal.
 
template<typename char_t >
static void are_not_equal (const std::basic_istream< char_t > &expected, const std::basic_istream< char_t > &actual)
 Validate that two files are not equal.
 
template<typename char_t >
static void are_not_equal (const std::basic_istream< char_t > &expected, const std::basic_istream< char_t > &actual, const xtd::diagnostics::stack_frame &stack_frame)
 Validate that two files are not equal.
 
template<typename char_t >
static void are_not_equal (const std::basic_istream< char_t > &expected, const std::basic_istream< char_t > &actual, const std::string &message)
 Validate that two files are not equal.
 
template<typename char_t >
static void are_not_equal (const std::basic_istream< char_t > &expected, const std::basic_istream< char_t > &actual, const std::string &message, const xtd::diagnostics::stack_frame &stack_frame)
 Validate that two files are not equal.
 
template<typename char_t >
static void are_not_equal (const std::basic_string< char_t > &expected, const std::basic_string< char_t > &actual)
 Validate that two files are not equal.
 
template<typename char_t >
static void are_not_equal (const std::basic_string< char_t > &expected, const std::basic_string< char_t > &actual, const xtd::diagnostics::stack_frame &stack_frame)
 Validate that two files are not equal.
 
template<typename char_t >
static void are_not_equal (const std::basic_string< char_t > &expected, const std::basic_string< char_t > &actual, const std::string &message)
 Validate that two files are not equal.
 
template<typename char_t >
static void are_not_equal (const std::basic_string< char_t > &expected, const std::basic_string< char_t > &actual, const std::string &message, const xtd::diagnostics::stack_frame &stack_frame)
 Validate that two files are not equal.
 
template<typename char_t >
static void does_not_exist (const std::basic_string< char_t > &file)
 Validate that file not exists.
 
template<typename char_t >
static void does_not_exist (const std::basic_string< char_t > &file, const xtd::diagnostics::stack_frame &stack_frame)
 Validate that file not exists.
 
template<typename char_t >
static void does_not_exist (const std::basic_string< char_t > &file, const std::string &message)
 Validate that file not exists.
 
template<typename char_t >
static void does_not_exist (const std::basic_string< char_t > &file, const std::string &message, const xtd::diagnostics::stack_frame &stack_frame)
 Validate that file not exists.
 
template<typename char_t >
static void exists (const std::basic_string< char_t > &file)
 Validate that file exists.
 
template<typename char_t >
static void exists (const std::basic_string< char_t > &file, const xtd::diagnostics::stack_frame &stack_frame)
 Validate that file exists.
 
template<typename char_t >
static void exists (const std::basic_string< char_t > &file, const std::string &message)
 Validate that file exists.
 
template<typename char_t >
static void exists (const std::basic_string< char_t > &file, const std::string &message, const xtd::diagnostics::stack_frame &stack_frame)
 Validate that file exists.
 

Member Function Documentation

◆ are_equal() [1/8]

template<typename char_t >
static void xtd::tunit::file_valid::are_equal ( const std::basic_istream< char_t > &  expected,
const std::basic_istream< char_t > &  actual 
)
inlinestatic

Validate that two files are equal.

Parameters
expectedthe expected value.
actualthe actual value.
Examples
std::stringstream s1;
s1 << "Test";
s1.seekg(0, std::ios::beg);
std::stringstream s2;
s2 << "Test";
s2.seekg(0, std::ios::beg);
s2 << "Test2";
s2.seekg(0, std::ios::beg);
xtd::tunit::file_valid::are_equal(s2, s1); // test fails
static void are_equal(const std::basic_istream< char_t > &expected, const std::basic_istream< char_t > &actual)
Validate that two files are equal.
Definition file_valid.h:49

◆ are_equal() [2/8]

template<typename char_t >
static void xtd::tunit::file_valid::are_equal ( const std::basic_istream< char_t > &  expected,
const std::basic_istream< char_t > &  actual,
const std::string &  message 
)
inlinestatic

Validate that two files are equal.

Parameters
expectedthe expected value.
actualthe actual value.
messageA user message to display if the assertion fails. This message can be seen in the unit test results.
Examples
std::stringstream s1;
s1 << "Test";
s1.seekg(0, std::ios::beg);
std::stringstream s2;
s2 << "Test";
s2.seekg(0, std::ios::beg);
xtd::tunit::file_valid::are_equal(s2, s1, "User message..."); // test ok.
s2 << "Test2";
s2.seekg(0, std::ios::beg);
xtd::tunit::file_valid::are_equal(s2, s1, "User message..."); // test fails

◆ are_equal() [3/8]

template<typename char_t >
static void xtd::tunit::file_valid::are_equal ( const std::basic_istream< char_t > &  expected,
const std::basic_istream< char_t > &  actual,
const std::string &  message,
const xtd::diagnostics::stack_frame stack_frame 
)
inlinestatic

Validate that two files are equal.

Parameters
expectedthe expected value.
actualthe actual value.
messageA user message to display if the assertion fails. This message can be seen in the unit test results.
stack_frameContains information about current file and current line.
Examples
std::stringstream s1;
s1 << "Test";
s1.seekg(0, std::ios::beg);
std::stringstream s2;
s2 << "Test";
s2.seekg(0, std::ios::beg);
xtd::tunit::file_valid::are_equal(s2, s1, "User message...", csf_); // test ok.
s2 << "Test2";
s2.seekg(0, std::ios::beg);
xtd::tunit::file_valid::are_equal(s2, s1, "User message...", csf_); // test fails
#define csf_
Provides information about the current stack frame.
Definition current_stack_frame.h:30

◆ are_equal() [4/8]

template<typename char_t >
static void xtd::tunit::file_valid::are_equal ( const std::basic_istream< char_t > &  expected,
const std::basic_istream< char_t > &  actual,
const xtd::diagnostics::stack_frame stack_frame 
)
inlinestatic

Validate that two files are equal.

Parameters
expectedthe expected value.
actualthe actual value.
stack_frameContains information about current file and current line.
Examples
std::stringstream s1;
s1 << "Test";
s1.seekg(0, std::ios::beg);
std::stringstream s2;
s2 << "Test";
s2.seekg(0, std::ios::beg);
s2 << "Test2";
s2.seekg(0, std::ios::beg);
xtd::tunit::file_valid::are_equal(s2, s1, csf_); // test fails

◆ are_equal() [5/8]

template<typename char_t >
static void xtd::tunit::file_valid::are_equal ( const std::basic_string< char_t > &  expected,
const std::basic_string< char_t > &  actual 
)
inlinestatic

Validate that two files are equal.

Parameters
expectedthe expected value.
actualthe actual value.
Examples
std::stringstream s1;
s1 << "Test";
s1.seekg(0, std::ios::beg);
std::stringstream s2;
s2 << "Test";
s2.seekg(0, std::ios::beg);
s2 << "Test2";
s2.seekg(0, std::ios::beg);
xtd::tunit::file_valid::are_equal(s2, s1); // test fails

◆ are_equal() [6/8]

template<typename char_t >
static void xtd::tunit::file_valid::are_equal ( const std::basic_string< char_t > &  expected,
const std::basic_string< char_t > &  actual,
const std::string &  message 
)
inlinestatic

Validate that two files are equal.

Parameters
expectedthe expected value.
actualthe actual value.
messageA user message to display if the assertion fails. This message can be seen in the unit test results.
Examples
std::stringstream s1;
s1 << "Test";
s1.seekg(0, std::ios::beg);
std::stringstream s2;
s2 << "Test";
s2.seekg(0, std::ios::beg);
xtd::tunit::file_valid::are_equal(s2, s1, "User message..."); // test ok.
s2 << "Test2";
s2.seekg(0, std::ios::beg);
xtd::tunit::file_valid::are_equal(s2, s1, "User message..."); // test fails

◆ are_equal() [7/8]

template<typename char_t >
static void xtd::tunit::file_valid::are_equal ( const std::basic_string< char_t > &  expected,
const std::basic_string< char_t > &  actual,
const std::string &  message,
const xtd::diagnostics::stack_frame stack_frame 
)
inlinestatic

Validate that two files are equal.

Parameters
expectedthe expected value.
actualthe actual value.
messageA user message to display if the assertion fails. This message can be seen in the unit test results.
stack_frameContains information about current file and current line.
Examples
std::stringstream s1;
s1 << "Test";
s1.seekg(0, std::ios::beg);
std::stringstream s2;
s2 << "Test";
s2.seekg(0, std::ios::beg);
xtd::tunit::file_valid::are_equal(s2, s1, "User message...", csf_); // test ok.
s2 << "Test2";
s2.seekg(0, std::ios::beg);
xtd::tunit::file_valid::are_equal(s2, s1, "User message...", csf_); // test fails

◆ are_equal() [8/8]

template<typename char_t >
static void xtd::tunit::file_valid::are_equal ( const std::basic_string< char_t > &  expected,
const std::basic_string< char_t > &  actual,
const xtd::diagnostics::stack_frame stack_frame 
)
inlinestatic

Validate that two files are equal.

Parameters
expectedthe expected value.
actualthe actual value.
stack_frameContains information about current file and current line.
Examples
std::stringstream s1;
s1 << "Test";
s1.seekg(0, std::ios::beg);
std::stringstream s2;
s2 << "Test";
s2.seekg(0, std::ios::beg);
s2 << "Test2";
s2.seekg(0, std::ios::beg);
xtd::tunit::file_valid::are_equal(s2, s1, csf_); // test fails

◆ are_not_equal() [1/8]

template<typename char_t >
static void xtd::tunit::file_valid::are_not_equal ( const std::basic_istream< char_t > &  expected,
const std::basic_istream< char_t > &  actual 
)
inlinestatic

Validate that two files are not equal.

Parameters
expectedthe expected value.
actualthe actual value.
Examples
std::stringstream s1;
s1 << "Test";
s1.seekg(0, std::ios::beg);
std::stringstream s2;
s2 << "Test2";
s2.seekg(0, std::ios::beg);
s2 << "Test";
s2.seekg(0, std::ios::beg);
static void are_not_equal(const std::basic_istream< char_t > &expected, const std::basic_istream< char_t > &actual)
Validate that two files are not equal.
Definition file_valid.h:236

◆ are_not_equal() [2/8]

template<typename char_t >
static void xtd::tunit::file_valid::are_not_equal ( const std::basic_istream< char_t > &  expected,
const std::basic_istream< char_t > &  actual,
const std::string &  message 
)
inlinestatic

Validate that two files are not equal.

Parameters
expectedthe expected value.
actualthe actual value.
messageA user message to display if the assertion fails. This message can be seen in the unit test results.
Examples
std::stringstream s1;
s1 << "Test";
s1.seekg(0, std::ios::beg);
std::stringstream s2;
s2 << "Test2";
s2.seekg(0, std::ios::beg);
xtd::tunit::file_valid::are_not_equal(s2, s1, "User message..."); // test ok.
s2 << "Test";
s2.seekg(0, std::ios::beg);
xtd::tunit::file_valid::are_not_equal(s2, s1, "User message..."); // test fails

◆ are_not_equal() [3/8]

template<typename char_t >
static void xtd::tunit::file_valid::are_not_equal ( const std::basic_istream< char_t > &  expected,
const std::basic_istream< char_t > &  actual,
const std::string &  message,
const xtd::diagnostics::stack_frame stack_frame 
)
inlinestatic

Validate that two files are not equal.

Parameters
expectedthe expected value.
actualthe actual value.
messageA user message to display if the assertion fails. This message can be seen in the unit test results.
stack_frameContains information about current file and current line.
Examples
std::stringstream s1;
s1 << "Test";
s1.seekg(0, std::ios::beg);
std::stringstream s2;
s2 << "Test2";
s2.seekg(0, std::ios::beg);
xtd::tunit::file_valid::are_not_equal(s2, s1, "User message...", csf_); // test ok.
s2 << "Test";
s2.seekg(0, std::ios::beg);
xtd::tunit::file_valid::are_not_equal(s2, s1, "User message...", csf_); // test fails

◆ are_not_equal() [4/8]

template<typename char_t >
static void xtd::tunit::file_valid::are_not_equal ( const std::basic_istream< char_t > &  expected,
const std::basic_istream< char_t > &  actual,
const xtd::diagnostics::stack_frame stack_frame 
)
inlinestatic

Validate that two files are not equal.

Parameters
expectedthe expected value.
actualthe actual value.
stack_frameContains information about current file and current line.
Examples
std::stringstream s1;
s1 << "Test";
s1.seekg(0, std::ios::beg);
std::stringstream s2;
s2 << "Test2";
s2.seekg(0, std::ios::beg);
s2 << "Test";
s2.seekg(0, std::ios::beg);

◆ are_not_equal() [5/8]

template<typename char_t >
static void xtd::tunit::file_valid::are_not_equal ( const std::basic_string< char_t > &  expected,
const std::basic_string< char_t > &  actual 
)
inlinestatic

Validate that two files are not equal.

Parameters
expectedthe expected value.
actualthe actual value.
Examples
std::stringstream s1;
s1 << "Test";
s1.seekg(0, std::ios::beg);
std::stringstream s2;
s2 << "Test2";
s2.seekg(0, std::ios::beg);
s2 << "Test";
s2.seekg(0, std::ios::beg);

◆ are_not_equal() [6/8]

template<typename char_t >
static void xtd::tunit::file_valid::are_not_equal ( const std::basic_string< char_t > &  expected,
const std::basic_string< char_t > &  actual,
const std::string &  message 
)
inlinestatic

Validate that two files are not equal.

Parameters
expectedthe expected value.
actualthe actual value.
messageA user message to display if the assertion fails. This message can be seen in the unit test results.
Examples
std::stringstream s1;
s1 << "Test";
s1.seekg(0, std::ios::beg);
std::stringstream s2;
s2 << "Test2";
s2.seekg(0, std::ios::beg);
xtd::tunit::file_valid::are_not_equal(s2, s1, "User message..."); // test ok.
s2 << "Test";
s2.seekg(0, std::ios::beg);
xtd::tunit::file_valid::are_not_equal(s2, s1, "User message..."); // test fails

◆ are_not_equal() [7/8]

template<typename char_t >
static void xtd::tunit::file_valid::are_not_equal ( const std::basic_string< char_t > &  expected,
const std::basic_string< char_t > &  actual,
const std::string &  message,
const xtd::diagnostics::stack_frame stack_frame 
)
inlinestatic

Validate that two files are not equal.

Parameters
expectedthe expected value.
actualthe actual value.
messageA user message to display if the assertion fails. This message can be seen in the unit test results.
stack_frameContains information about current file and current line.
Examples
std::stringstream s1;
s1 << "Test";
s1.seekg(0, std::ios::beg);
std::stringstream s2;
s2 << "Test2";
s2.seekg(0, std::ios::beg);
xtd::tunit::file_valid::are_not_equal(s2, s1, "User message...", csf_); // test ok.
s2 << "Test";
s2.seekg(0, std::ios::beg);
xtd::tunit::file_valid::are_not_equal(s2, s1, "User message...", csf_); // test fails

◆ are_not_equal() [8/8]

template<typename char_t >
static void xtd::tunit::file_valid::are_not_equal ( const std::basic_string< char_t > &  expected,
const std::basic_string< char_t > &  actual,
const xtd::diagnostics::stack_frame stack_frame 
)
inlinestatic

Validate that two files are not equal.

Parameters
expectedthe expected value.
actualthe actual value.
stack_frameContains information about current file and current line.
Examples
std::stringstream s1;
s1 << "Test";
s1.seekg(0, std::ios::beg);
std::stringstream s2;
s2 << "Test2";
s2.seekg(0, std::ios::beg);
s2 << "Test";
s2.seekg(0, std::ios::beg);

◆ does_not_exist() [1/4]

template<typename char_t >
static void xtd::tunit::file_valid::does_not_exist ( const std::basic_string< char_t > &  file)
inlinestatic

Validate that file not exists.

Parameters
expectedthe expected value.
actualthe actual value.
Examples
std::ifstream f1("Test1.txt");
f1.close();
xtd::tunit::file_valid::does_not_exist("Test2.txt"); // test ok.
xtd::tunit::file_valid::does_not_exist("Test1.txt"); // test fails
static void does_not_exist(const std::basic_string< char_t > &file)
Validate that file not exists.
Definition file_valid.h:416
@ f1
The F1 key.

◆ does_not_exist() [2/4]

template<typename char_t >
static void xtd::tunit::file_valid::does_not_exist ( const std::basic_string< char_t > &  file,
const std::string &  message 
)
inlinestatic

Validate that file not exists.

Parameters
expectedthe expected value.
actualthe actual value.
messageA user message to display if the assertion fails. This message can be seen in the unit test results.
Examples
std::ifstream f1("Test1.txt");
f1.close();
xtd::tunit::file_valid::does_not_exist("Test2.txt", "User message..."); // test ok.
xtd::tunit::file_valid::does_not_exist("Test1.txt", "User message..."); // test fails

◆ does_not_exist() [3/4]

template<typename char_t >
static void xtd::tunit::file_valid::does_not_exist ( const std::basic_string< char_t > &  file,
const std::string &  message,
const xtd::diagnostics::stack_frame stack_frame 
)
inlinestatic

Validate that file not exists.

Parameters
expectedthe expected value.
actualthe actual value.
messageA user message to display if the assertion fails. This message can be seen in the unit test results.
stack_frameContains information about current file and current line.
Examples
std::ifstream f1("Test1.txt");
f1.close();
xtd::tunit::file_valid::does_not_exist("Test2.txt" "User message...", csf_); // test ok.
xtd::tunit::file_valid::does_not_exist("Test1.txt", "User message...", csf_); // test fails

◆ does_not_exist() [4/4]

template<typename char_t >
static void xtd::tunit::file_valid::does_not_exist ( const std::basic_string< char_t > &  file,
const xtd::diagnostics::stack_frame stack_frame 
)
inlinestatic

Validate that file not exists.

Parameters
expectedthe expected value.
actualthe actual value.
stack_frameContains information about current file and current line.
Examples
std::ifstream f1("Test1.txt");
f1.close();
xtd::tunit::file_valid::does_not_exist("Test2.txt", csf_); // test ok.
xtd::tunit::file_valid::does_not_exist("Test1.txt", csf_); // test fails

◆ exists() [1/4]

template<typename char_t >
static void xtd::tunit::file_valid::exists ( const std::basic_string< char_t > &  file)
inlinestatic

Validate that file exists.

Parameters
expectedthe expected value.
actualthe actual value.
Examples
std::ifstream f1("Test1.txt");
f1.close();
xtd::tunit::file_valid::exists("Test1.txt"); // test ok.
xtd::tunit::file_valid::exists("Test2.txt"); // test fails
static void exists(const std::basic_string< char_t > &file)
Validate that file exists.
Definition file_valid.h:486

◆ exists() [2/4]

template<typename char_t >
static void xtd::tunit::file_valid::exists ( const std::basic_string< char_t > &  file,
const std::string &  message 
)
inlinestatic

Validate that file exists.

Parameters
expectedthe expected value.
actualthe actual value.
messageA user message to display if the assertion fails. This message can be seen in the unit test results.
Examples
std::ifstream f1("Test1.txt");
f1.close();
xtd::tunit::file_valid::exists("Test1.txt", "User message..."); // test ok.
xtd::tunit::file_valid::exists("Test2.txt", "User message..."); // test fails

◆ exists() [3/4]

template<typename char_t >
static void xtd::tunit::file_valid::exists ( const std::basic_string< char_t > &  file,
const std::string &  message,
const xtd::diagnostics::stack_frame stack_frame 
)
inlinestatic

Validate that file exists.

Parameters
expectedthe expected value.
actualthe actual value.
messageA user message to display if the assertion fails. This message can be seen in the unit test results.
stack_frameContains information about current file and current line.
Examples
std::ifstream f1("Test1.txt");
f1.close();
xtd::tunit::file_valid::exists("Test1.txt" "User message...", csf_); // test ok.
xtd::tunit::file_valid::exists("Test2.txt", "User message...", csf_); // test fails

◆ exists() [4/4]

template<typename char_t >
static void xtd::tunit::file_valid::exists ( const std::basic_string< char_t > &  file,
const xtd::diagnostics::stack_frame stack_frame 
)
inlinestatic

Validate that file exists.

Parameters
expectedthe expected value.
actualthe actual value.
stack_frameContains information about current file and current line.
Examples
std::ifstream f1("Test1.txt");
f1.close();
xtd::tunit::file_valid::exists("Test1.txt", csf_); // test ok.
xtd::tunit::file_valid::exists("Test2.txt", csf_); // test fails

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