C++ Utilities  5.10.5
Useful C++ classes and routines such as argument parser, IO and conversion utilities
iotests.cpp
Go to the documentation of this file.
1 #include "./testutils.h"
2 
3 #include "../conversion/conversionexception.h"
4 #include "../conversion/stringbuilder.h"
5 
6 #include "../io/ansiescapecodes.h"
7 #include "../io/binaryreader.h"
8 #include "../io/binarywriter.h"
9 #include "../io/bitreader.h"
10 #include "../io/copy.h"
11 #include "../io/inifile.h"
12 #include "../io/misc.h"
13 #include "../io/nativefilestream.h"
14 #include "../io/path.h"
15 
16 #include <cppunit/TestFixture.h>
17 #include <cppunit/extensions/HelperMacros.h>
18 
19 #include <algorithm>
20 #include <fstream>
21 #include <regex>
22 #include <sstream>
23 
24 #ifdef PLATFORM_WINDOWS
25 #include <cstdio>
26 #endif
27 
28 #ifdef PLATFORM_UNIX
29 #include <sys/fcntl.h>
30 #include <sys/types.h>
31 #endif
32 
33 using namespace std;
34 using namespace CppUtilities;
35 using namespace CppUtilities::Literals;
36 using namespace CPPUNIT_NS;
37 
41 class IoTests : public TestFixture {
42  CPPUNIT_TEST_SUITE(IoTests);
43  CPPUNIT_TEST(testBinaryReader);
44  CPPUNIT_TEST(testBinaryWriter);
45  CPPUNIT_TEST(testBitReader);
46  CPPUNIT_TEST(testPathUtilities);
47  CPPUNIT_TEST(testIniFile);
48  CPPUNIT_TEST(testAdvancedIniFile);
49  CPPUNIT_TEST(testCopy);
50  CPPUNIT_TEST(testReadFile);
51  CPPUNIT_TEST(testWriteFile);
52  CPPUNIT_TEST(testAnsiEscapeCodes);
53 #ifdef CPP_UTILITIES_USE_NATIVE_FILE_BUFFER
54  CPPUNIT_TEST(testNativeFileStream);
55 #endif
56  CPPUNIT_TEST_SUITE_END();
57 
58 public:
59  void setUp() override;
60  void tearDown() override;
61 
62  void testBinaryReader();
63  void testBinaryWriter();
64  void testBitReader();
65  void testPathUtilities();
66  void testIniFile();
67  void testAdvancedIniFile();
68  void testCopy();
69  void testReadFile();
70  void testWriteFile();
71  void testAnsiEscapeCodes();
72 #ifdef CPP_UTILITIES_USE_NATIVE_FILE_BUFFER
73  void testNativeFileStream();
74 #endif
75 };
76 
78 
80 {
81 }
82 
84 {
85 }
86 
91 {
92  // read test file
93  fstream testFile;
94  testFile.exceptions(ios_base::failbit | ios_base::badbit);
95  testFile.open(testFilePath("some_data"), ios_base::in | ios_base::binary);
96  BinaryReader reader(&testFile);
97  CPPUNIT_ASSERT_EQUAL(static_cast<istream::pos_type>(398), reader.readStreamsize());
98  CPPUNIT_ASSERT_EQUAL(static_cast<std::uint16_t>(0x0102u), reader.readUInt16LE());
99  CPPUNIT_ASSERT_EQUAL(static_cast<istream::pos_type>(396), reader.readRemainingBytes());
100  CPPUNIT_ASSERT_EQUAL(static_cast<std::uint16_t>(0x0102u), reader.readUInt16BE());
101  CPPUNIT_ASSERT_EQUAL(0x010203u, reader.readUInt24LE());
102  CPPUNIT_ASSERT_EQUAL(0x010203u, reader.readUInt24BE());
103  CPPUNIT_ASSERT_EQUAL(0x01020304u, reader.readUInt32LE());
104  CPPUNIT_ASSERT_EQUAL(0x01020304u, reader.readUInt32BE());
105  CPPUNIT_ASSERT_EQUAL(0x0102030405u, reader.readUInt40LE());
106  CPPUNIT_ASSERT_EQUAL(0x0102030405u, reader.readUInt40BE());
107  CPPUNIT_ASSERT_EQUAL(0x01020304050607u, reader.readUInt56LE());
108  CPPUNIT_ASSERT_EQUAL(0x01020304050607u, reader.readUInt56BE());
109  CPPUNIT_ASSERT_EQUAL(0x0102030405060708u, reader.readUInt64LE());
110  CPPUNIT_ASSERT_EQUAL(0x0102030405060708u, reader.readUInt64BE());
111  testFile.seekg(0);
112  CPPUNIT_ASSERT_EQUAL(reader.readInt16LE(), static_cast<std::int16_t>(0x0102));
113  CPPUNIT_ASSERT_EQUAL(reader.readInt16BE(), static_cast<std::int16_t>(0x0102));
114  CPPUNIT_ASSERT_EQUAL(0x010203, reader.readInt24LE());
115  CPPUNIT_ASSERT_EQUAL(0x010203, reader.readInt24BE());
116  CPPUNIT_ASSERT_EQUAL(0x01020304, reader.readInt32LE());
117  CPPUNIT_ASSERT_EQUAL(0x01020304, reader.readInt32BE());
118  CPPUNIT_ASSERT_EQUAL(0x0102030405, reader.readInt40LE());
119  CPPUNIT_ASSERT_EQUAL(0x0102030405, reader.readInt40BE());
120  CPPUNIT_ASSERT_EQUAL(0x01020304050607, reader.readInt56LE());
121  CPPUNIT_ASSERT_EQUAL(0x01020304050607, reader.readInt56BE());
122  CPPUNIT_ASSERT_EQUAL(0x0102030405060708, reader.readInt64LE());
123  CPPUNIT_ASSERT_EQUAL(0x0102030405060708, reader.readInt64BE());
124  CPPUNIT_ASSERT_EQUAL(1.125f, reader.readFloat32LE());
125  CPPUNIT_ASSERT_EQUAL(1.625, reader.readFloat64LE());
126  CPPUNIT_ASSERT_EQUAL(1.125f, reader.readFloat32BE());
127  CPPUNIT_ASSERT_EQUAL(reader.readFloat64BE(), 1.625);
128  CPPUNIT_ASSERT_EQUAL(false, reader.readBool());
129  CPPUNIT_ASSERT_EQUAL(true, reader.readBool());
130  CPPUNIT_ASSERT_EQUAL("abc"s, reader.readString(3));
131  CPPUNIT_ASSERT_EQUAL(reader.readLengthPrefixedString(), "ABC"s);
132  CPPUNIT_ASSERT_EQUAL("01234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901"
133  "23456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123"
134  "45678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345"
135  "678901234567890123456789"s,
136  reader.readLengthPrefixedString());
137  CPPUNIT_ASSERT_EQUAL("def"s, reader.readTerminatedString());
138  testFile.seekg(-4, ios_base::cur);
139  CPPUNIT_ASSERT_EQUAL("def"s, reader.readTerminatedString(5, 0));
140  CPPUNIT_ASSERT_THROW(reader.readLengthPrefixedString(), ConversionException);
141  CPPUNIT_ASSERT_MESSAGE("pos in stream not advanced on conversion error", reader.readByte() == 0);
142 
143  // test ownership
144  reader.setStream(nullptr, true);
145  reader.setStream(new fstream(), true);
146  BinaryReader reader2(reader);
147  CPPUNIT_ASSERT(reader2.stream() == reader.stream());
148  CPPUNIT_ASSERT(!reader2.hasOwnership());
149  reader.setStream(&testFile, false);
150  reader.setStream(new fstream(), true);
151 }
152 
157 {
158  // prepare reading expected data
159  fstream testFile;
160  testFile.exceptions(ios_base::failbit | ios_base::badbit);
161  testFile.open(testFilePath("some_data"), ios_base::in | ios_base::binary);
162 
163  // prepare output stream
164  stringstream outputStream(ios_base::in | ios_base::out | ios_base::binary);
165  outputStream.exceptions(ios_base::failbit | ios_base::badbit);
166  char testData[397];
167  outputStream.rdbuf()->pubsetbuf(testData, sizeof(testData));
168 
169  // write test data
170  BinaryWriter writer(&outputStream);
171  writer.writeUInt16LE(0x0102u);
172  writer.writeUInt16BE(0x0102u);
173  writer.writeUInt24LE(0x010203u);
174  writer.writeUInt24BE(0x010203u);
175  writer.writeUInt32LE(0x01020304u);
176  writer.writeUInt32BE(0x01020304u);
177  writer.writeUInt40LE(0x0102030405u);
178  writer.writeUInt40BE(0x0102030405u);
179  writer.writeUInt56LE(0x01020304050607u);
180  writer.writeUInt56BE(0x01020304050607u);
181  writer.writeUInt64LE(0x0102030405060708u);
182  writer.writeUInt64BE(0x0102030405060708u);
183 
184  // test written values
185  for (char c : testData) {
186  CPPUNIT_ASSERT(c == static_cast<char>(testFile.get()));
187  if (testFile.tellg() >= 58) {
188  break;
189  }
190  }
191  testFile.seekg(0);
192  outputStream.seekp(0);
193 
194  // write more test data
195  writer.writeInt16LE(0x0102);
196  writer.writeInt16BE(0x0102);
197  writer.writeInt24LE(0x010203);
198  writer.writeInt24BE(0x010203);
199  writer.writeInt32LE(0x01020304);
200  writer.writeInt32BE(0x01020304);
201  writer.writeInt40LE(0x0102030405);
202  writer.writeInt40BE(0x0102030405);
203  writer.writeInt56LE(0x01020304050607);
204  writer.writeInt56BE(0x01020304050607);
205  writer.writeInt64LE(0x0102030405060708);
206  writer.writeInt64BE(0x0102030405060708);
207  writer.writeFloat32LE(1.125);
208  writer.writeFloat64LE(1.625);
209  writer.writeFloat32BE(1.125);
210  writer.writeFloat64BE(1.625);
211  writer.writeBool(false);
212  writer.writeBool(true);
213  writer.writeString("abc");
214  writer.writeLengthPrefixedString("ABC");
215  writer.writeLengthPrefixedString("012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890"
216  "123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901"
217  "234567890123456789012345678901234567890123456789012345678901234567890123456789");
218  writer.writeTerminatedString("def");
219 
220  // test written values
221  for (char c : testData) {
222  CPPUNIT_ASSERT(c == static_cast<char>(testFile.get()));
223  }
224 
225  // test ownership
226  writer.setStream(nullptr, true);
227  writer.setStream(new fstream(), true);
228  BinaryWriter writer2(writer);
229  CPPUNIT_ASSERT(writer2.stream() == writer.stream());
230  CPPUNIT_ASSERT(!writer2.hasOwnership());
231  writer.setStream(&testFile, false);
232  writer.setStream(new fstream(), true);
233 }
234 
239 {
240  const std::uint8_t testData[] = { 0x81, 0x90, 0x3C, 0x44, 0x28, 0x00, 0x44, 0x10, 0x20, 0xFF, 0xFA };
241  BitReader reader(reinterpret_cast<const char *>(testData), sizeof(testData));
242  CPPUNIT_ASSERT(reader.readBit() == 1);
243  reader.skipBits(6);
244  CPPUNIT_ASSERT_EQUAL(static_cast<std::uint8_t>(3), reader.showBits<std::uint8_t>(2));
245  CPPUNIT_ASSERT_EQUAL(static_cast<std::uint8_t>(3), reader.readBits<std::uint8_t>(2));
246  CPPUNIT_ASSERT_EQUAL(static_cast<std::uint32_t>(0x103C4428 << 1), reader.readBits<std::uint32_t>(32));
247  reader.align();
248  CPPUNIT_ASSERT_EQUAL(static_cast<std::uint8_t>(0x44), reader.readBits<std::uint8_t>(8));
249  CPPUNIT_ASSERT_EQUAL(static_cast<std::uint8_t>(7), reader.readUnsignedExpGolombCodedBits<std::uint8_t>());
250  CPPUNIT_ASSERT_EQUAL(static_cast<std::int8_t>(4), reader.readSignedExpGolombCodedBits<std::int8_t>());
251  CPPUNIT_ASSERT_EQUAL(static_cast<std::uint8_t>(0), reader.readBit());
252  CPPUNIT_ASSERT_EQUAL(static_cast<std::uint8_t>(0), reader.readBit());
253  reader.skipBits(8 + 4);
254  CPPUNIT_ASSERT_EQUAL(4_st, reader.bitsAvailable());
255  CPPUNIT_ASSERT_EQUAL(static_cast<std::uint8_t>(0xA), reader.readBits<std::uint8_t>(4));
256  CPPUNIT_ASSERT_THROW(reader.readBit(), std::ios_base::failure);
257  CPPUNIT_ASSERT_THROW(reader.skipBits(1), std::ios_base::failure);
258  reader.reset(reinterpret_cast<const char *>(testData), sizeof(testData));
259  CPPUNIT_ASSERT_EQUAL(static_cast<std::size_t>(8 * sizeof(testData)), reader.bitsAvailable());
260 }
261 
266 {
267  CPPUNIT_ASSERT_EQUAL("libc++utilities.so"s, fileName("C:\\libs\\libc++utilities.so"));
268  CPPUNIT_ASSERT_EQUAL("libc++utilities.so"s, fileName("C:\\libs/libc++utilities.so"));
269  CPPUNIT_ASSERT_EQUAL("libc++utilities.so"s, fileName("/usr/lib/libc++utilities.so"));
270  CPPUNIT_ASSERT_EQUAL("libc++utilities.so"s, fileName("libc++utilities.so"));
271  CPPUNIT_ASSERT_EQUAL("/usr/lib/"s, directory("/usr/lib/libc++utilities.so"));
272  CPPUNIT_ASSERT_EQUAL(string(), directory("libc++utilities.so"));
273  CPPUNIT_ASSERT_EQUAL("C:\\libs\\"s, directory("C:\\libs\\libc++utilities.so"));
274  CPPUNIT_ASSERT_EQUAL("C:\\libs/"s, directory("C:\\libs/libc++utilities.so"));
275  string invalidPath("lib/c++uti*lities.so?");
276  removeInvalidChars(invalidPath);
277  CPPUNIT_ASSERT(invalidPath == "libc++utilities.so");
278 }
279 
284 {
285  // prepare reading test file
286  fstream inputFile;
287  inputFile.exceptions(ios_base::failbit | ios_base::badbit);
288  inputFile.open(testFilePath("test.ini"), ios_base::in);
289 
290  IniFile ini;
291  ini.parse(inputFile);
292  const auto globalScope = ini.data().at(0);
293  const auto scope1 = ini.data().at(1);
294  const auto scope2 = ini.data().at(2);
295  CPPUNIT_ASSERT(globalScope.first.empty());
296  CPPUNIT_ASSERT(globalScope.second.find("key0") != globalScope.second.cend());
297  CPPUNIT_ASSERT(globalScope.second.find("key0")->second == "value 0");
298  CPPUNIT_ASSERT(globalScope.second.find("key1") == globalScope.second.cend());
299  CPPUNIT_ASSERT(scope1.first == "scope 1");
300  CPPUNIT_ASSERT(scope1.second.find("key1") != scope1.second.cend());
301  CPPUNIT_ASSERT(scope1.second.find("key1")->second == "value 1");
302  CPPUNIT_ASSERT(scope1.second.find("key2") != scope1.second.cend());
303  CPPUNIT_ASSERT(scope1.second.find("key2")->second == "value=2");
304  CPPUNIT_ASSERT(scope2.first == "scope 2");
305  CPPUNIT_ASSERT(scope2.second.find("key5") == scope2.second.cend());
306 
307  // write values to another file
308  fstream outputFile;
309  outputFile.exceptions(ios_base::failbit | ios_base::badbit);
310  outputFile.open(workingCopyPath("output.ini", WorkingCopyMode::NoCopy), ios_base::out | ios_base::trunc);
311  ini.make(outputFile);
312 
313  // parse written values (again)
314  outputFile.close();
315  outputFile.open(workingCopyPath("output.ini", WorkingCopyMode::NoCopy), ios_base::in);
316  IniFile ini2;
317  ini2.parse(outputFile);
318  CPPUNIT_ASSERT(ini.data() == ini2.data());
319 }
320 
325 {
326  // prepare reading test file
327  fstream inputFile;
328  inputFile.exceptions(ios_base::failbit | ios_base::badbit);
329  inputFile.open(testFilePath("pacman.conf"), ios_base::in);
330 
331  // parse the test file
332  AdvancedIniFile ini;
333  ini.parse(inputFile);
334 
335  // check whether scope data is as expected
336  CPPUNIT_ASSERT_EQUAL_MESSAGE("5 scopes (taking implicit empty section at the end into account)", 5_st, ini.sections.size());
337  auto options = ini.findSection("options");
338  CPPUNIT_ASSERT(options != ini.sectionEnd());
340  "comment block before section", "# Based on.*\n.*# GENERAL OPTIONS\n#\n"s, std::regex::extended, options->precedingCommentBlock);
341  CPPUNIT_ASSERT_EQUAL(7_st, options->fields.size());
342  CPPUNIT_ASSERT_EQUAL("HoldPkg"s, options->fields[0].key);
343  CPPUNIT_ASSERT_EQUAL("pacman glibc"s, options->fields[0].value);
344  CPPUNIT_ASSERT_MESSAGE("value present", options->fields[0].flags & IniFileFieldFlags::HasValue);
345  TESTUTILS_ASSERT_LIKE_FLAGS("comment block between section header and first field",
346  "# The following paths are.*\n.*#HookDir = /etc/pacman\\.d/hooks/\n"s, std::regex::extended, options->fields[0].precedingCommentBlock);
347  CPPUNIT_ASSERT_EQUAL(""s, options->fields[0].followingInlineComment);
348  CPPUNIT_ASSERT_EQUAL("Foo"s, options->fields[1].key);
349  CPPUNIT_ASSERT_EQUAL("bar"s, options->fields[1].value);
350  CPPUNIT_ASSERT_MESSAGE("value present", options->fields[1].flags & IniFileFieldFlags::HasValue);
351  TESTUTILS_ASSERT_LIKE_FLAGS("comment block between fields", "#XferCommand.*\n.*#CleanMethod = KeepInstalled\n"s, std::regex::extended,
352  options->fields[1].precedingCommentBlock);
353  CPPUNIT_ASSERT_EQUAL("# inline comment"s, options->fields[1].followingInlineComment);
354  CPPUNIT_ASSERT_EQUAL("CheckSpace"s, options->fields[3].key);
355  CPPUNIT_ASSERT_EQUAL(""s, options->fields[3].value);
356  CPPUNIT_ASSERT_MESSAGE("no value present", !(options->fields[3].flags & IniFileFieldFlags::HasValue));
357  TESTUTILS_ASSERT_LIKE_FLAGS("empty lines in comments preserved", "\n# Pacman.*\n.*\n\n#NoUpgrade =\n.*#TotalDownload\n"s, std::regex::extended,
358  options->fields[3].precedingCommentBlock);
359  CPPUNIT_ASSERT_EQUAL(""s, options->fields[3].followingInlineComment);
360  auto extraScope = ini.findSection(options, "extra");
361  CPPUNIT_ASSERT(extraScope != ini.sectionEnd());
362  CPPUNIT_ASSERT_EQUAL_MESSAGE("comment block which is only an empty line", "\n"s, extraScope->precedingCommentBlock);
363  CPPUNIT_ASSERT_EQUAL_MESSAGE("inline comment after scope", "# an inline comment after a scope name"s, extraScope->followingInlineComment);
364  CPPUNIT_ASSERT_EQUAL(1_st, extraScope->fields.size());
365  CPPUNIT_ASSERT(ini.sections.back().flags & IniFileSectionFlags::Implicit);
366  TESTUTILS_ASSERT_LIKE_FLAGS("comment block after last field present in implicitly added last scope", "\n# If you.*\n.*custompkgs\n"s,
367  std::regex::extended, ini.sections.back().precedingCommentBlock);
368 
369  // test finding a field from file level and const access
370  const auto *const constIniFile = &ini;
371  auto includeField = constIniFile->findField("extra", "Include");
372  CPPUNIT_ASSERT(includeField.has_value());
373  CPPUNIT_ASSERT_EQUAL("Include"s, includeField.value()->key);
374  CPPUNIT_ASSERT_EQUAL("/etc/pacman.d/mirrorlist"s, includeField.value()->value);
375  CPPUNIT_ASSERT_MESSAGE("field not present", !constIniFile->findField("extra", "Includ").has_value());
376  CPPUNIT_ASSERT_MESSAGE("scope not present", !constIniFile->findField("extr", "Includ").has_value());
377 
378  // write values again; there shouldn't be a difference as the parser and the writer are supposed to
379  // preserve the order of all elements and comments
380  std::stringstream newFile;
381  ini.make(newFile);
382  std::string originalContents;
383  inputFile.clear();
384  inputFile.seekg(std::ios_base::beg);
385  originalContents.assign((istreambuf_iterator<char>(inputFile)), istreambuf_iterator<char>());
386  CPPUNIT_ASSERT_EQUAL(originalContents, newFile.str());
387 }
388 
393 {
394  // prepare streams
395  fstream testFile;
396  testFile.exceptions(ios_base::failbit | ios_base::badbit);
397  testFile.open(testFilePath("some_data"), ios_base::in | ios_base::binary);
398  stringstream outputStream(ios_base::in | ios_base::out | ios_base::binary);
399  outputStream.exceptions(ios_base::failbit | ios_base::badbit);
400 
401  // copy
402  CopyHelper<13> copyHelper;
403  copyHelper.copy(testFile, outputStream, 50);
404 
405  // test
406  testFile.seekg(0);
407  for (auto i = 0; i < 50; ++i) {
408  CPPUNIT_ASSERT(testFile.get() == outputStream.get());
409  }
410 }
411 
416 {
417  // read a file successfully
418  const string iniFilePath(testFilePath("test.ini"));
419  CPPUNIT_ASSERT_EQUAL("# file for testing INI parser\n"
420  "key0=value 0\n"
421  "\n"
422  "[scope 1]\n"
423  "key1=value 1 # comment\n"
424  "key2=value=2\n"
425  "key3=value 3\n"
426  "\n"
427  "[scope 2]\n"
428  "key4=value 4\n"
429  "#key5=value 5\n"
430  "key6=value 6\n"s,
431  readFile(iniFilePath));
432 
433  // fail by exceeding max size
434  CPPUNIT_ASSERT_THROW(readFile(iniFilePath, 10), std::ios_base::failure);
435 
436  // handle UTF-8 in path and file contents correctly via NativeFileStream
437 #if !defined(PLATFORM_WINDOWS) || defined(CPP_UTILITIES_USE_NATIVE_FILE_BUFFER)
438  CPPUNIT_ASSERT_EQUAL("file with non-ASCII character 'ä' in its name\n"s, readFile(testFilePath("täst.txt")));
439 #endif
440 }
441 
446 {
447  const string path(workingCopyPath("test.ini", WorkingCopyMode::NoCopy));
448  writeFile(path, "some contents");
449  CPPUNIT_ASSERT_EQUAL("some contents"s, readFile(path));
450 }
451 
456 {
457  stringstream ss1;
458  EscapeCodes::enabled = true;
459  ss1 << EscapeCodes::Phrases::Error << "some error" << EscapeCodes::Phrases::End;
460  ss1 << EscapeCodes::Phrases::Warning << "some warning" << EscapeCodes::Phrases::End;
461  ss1 << EscapeCodes::Phrases::Info << "some info" << EscapeCodes::Phrases::End;
462  ss1 << EscapeCodes::Phrases::ErrorMessage << "Arch-style error" << EscapeCodes::Phrases::End;
463  ss1 << EscapeCodes::Phrases::WarningMessage << "Arch-style warning" << EscapeCodes::Phrases::End;
464  ss1 << EscapeCodes::Phrases::PlainMessage << "Arch-style message" << EscapeCodes::Phrases::End;
465  ss1 << EscapeCodes::Phrases::SuccessMessage << "Arch-style success" << EscapeCodes::Phrases::End;
466  ss1 << EscapeCodes::Phrases::SubMessage << "Arch-style sub-message" << EscapeCodes::Phrases::End;
467  ss1 << EscapeCodes::color(EscapeCodes::Color::Blue, EscapeCodes::Color::Red, EscapeCodes::TextAttribute::Blink)
468  << "blue, blinking text on red background" << EscapeCodes::TextAttribute::Reset << '\n';
469  cout << "\noutput for formatting with ANSI escape codes:\n" << ss1.str() << "---------------------------------------------\n";
470  fstream("/tmp/test.txt", ios_base::out | ios_base::trunc) << ss1.str();
471  CPPUNIT_ASSERT_EQUAL("\e[1;31mError: \e[0m\e[1msome error\e[0m\n"
472  "\e[1;33mWarning: \e[0m\e[1msome warning\e[0m\n"
473  "\e[1;34mInfo: \e[0m\e[1msome info\e[0m\n"
474  "\e[1;31m==> ERROR: \e[0m\e[1mArch-style error\e[0m\n"
475  "\e[1;33m==> WARNING: \e[0m\e[1mArch-style warning\e[0m\n"
476  " \e[0m\e[1mArch-style message\e[0m\n"
477  "\e[1;32m==> \e[0m\e[1mArch-style success\e[0m\n"
478  "\e[1;32m -> \e[0m\e[1mArch-style sub-message\e[0m\n"
479  "\e[5;34;41mblue, blinking text on red background\e[0m\n"s,
480  ss1.str());
481 
482  stringstream ss2;
483  EscapeCodes::enabled = false;
484  ss2 << EscapeCodes::Phrases::Info << "some info" << EscapeCodes::Phrases::End;
485  CPPUNIT_ASSERT_EQUAL("Info: some info\n"s, ss2.str());
486 }
487 
488 #ifdef CPP_UTILITIES_USE_NATIVE_FILE_BUFFER
492 void IoTests::testNativeFileStream()
493 {
494  // open file by path
495  const auto txtFilePath(workingCopyPath("täst.txt"));
496  NativeFileStream fileStream;
497  fileStream.exceptions(ios_base::badbit | ios_base::failbit);
498  CPPUNIT_ASSERT(!fileStream.is_open());
499  fileStream.open(txtFilePath, ios_base::in);
500  CPPUNIT_ASSERT(fileStream.is_open());
501 #if defined(PLATFORM_WINDOWS) && defined(CPP_UTILITIES_USE_BOOST_IOSTREAMS)
502  CPPUNIT_ASSERT(fileStream.fileHandle() != nullptr);
503 #else
504  CPPUNIT_ASSERT(fileStream.fileDescriptor() != -1);
505 #endif
506  CPPUNIT_ASSERT_EQUAL(static_cast<char>(fileStream.get()), 'f');
507  fileStream.seekg(0, ios_base::end);
508  CPPUNIT_ASSERT_EQUAL(fileStream.tellg(), static_cast<NativeFileStream::pos_type>(47));
509  fileStream.close();
510  CPPUNIT_ASSERT(!fileStream.is_open());
511  try {
512  fileStream.open("non existing file", ios_base::in | ios_base::out | ios_base::binary);
513  CPPUNIT_FAIL("expected exception");
514  } catch (const std::ios_base::failure &failure) {
515 #ifdef PLATFORM_WINDOWS
516 #ifdef CPP_UTILITIES_USE_BOOST_IOSTREAMS
517  TESTUTILS_ASSERT_LIKE("expected error with some message", "CreateFileW failed: .+", failure.what());
518 #else
519  TESTUTILS_ASSERT_LIKE("expected error with some message", "_wopen failed: .+", failure.what());
520 #endif
521 #else
522  TESTUTILS_ASSERT_LIKE("expected error with some message", "open failed: .+", failure.what());
523 #endif
524  }
525  fileStream.clear();
526 
527  // open file from file descriptor
528 #ifndef PLATFORM_WINDOWS
529  auto readWriteFileDescriptor = open(txtFilePath.data(), O_RDWR);
530  CPPUNIT_ASSERT(readWriteFileDescriptor);
531  fileStream.open(readWriteFileDescriptor, ios_base::in | ios_base::out | ios_base::binary);
532  CPPUNIT_ASSERT(fileStream.is_open());
533  CPPUNIT_ASSERT_EQUAL(static_cast<char>(fileStream.get()), 'f');
534  fileStream.seekg(0, ios_base::end);
535  CPPUNIT_ASSERT_EQUAL(fileStream.tellg(), static_cast<NativeFileStream::pos_type>(47));
536  fileStream.flush();
537  fileStream.close();
538  CPPUNIT_ASSERT(!fileStream.is_open());
539 #endif
540  try {
541  fileStream.open(-1, ios_base::in | ios_base::out | ios_base::binary);
542  fileStream.get();
543  CPPUNIT_FAIL("expected exception");
544  } catch (const std::ios_base::failure &failure) {
545 #ifndef PLATFORM_WINDOWS
547  "expected error message", "(basic_ios::clear|failed reading: Bad file descriptor): iostream error"s, string(failure.what()));
548 #else
549  CPP_UTILITIES_UNUSED(failure)
550 #endif
551  }
552  fileStream.clear();
553 
554  // append + write file via path
555  NativeFileStream fileStream2;
556  fileStream2.exceptions(ios_base::failbit | ios_base::badbit);
557  fileStream2.open(txtFilePath, ios_base::in | ios_base::out | ios_base::app);
558  CPPUNIT_ASSERT(fileStream2.is_open());
559  fileStream2 << "foo";
560  fileStream2.flush();
561  fileStream2.close();
562  CPPUNIT_ASSERT(!fileStream2.is_open());
563  CPPUNIT_ASSERT_EQUAL("file with non-ASCII character 'ä' in its name\nfoo"s, readFile(txtFilePath, 50));
564 
565  // truncate + write file via path
566  fileStream2.open(txtFilePath, ios_base::out | ios_base::trunc);
567  CPPUNIT_ASSERT(fileStream2.is_open());
568  fileStream2 << "bar";
569  fileStream2.close();
570  CPPUNIT_ASSERT(!fileStream2.is_open());
571  CPPUNIT_ASSERT_EQUAL("bar"s, readFile(txtFilePath, 4));
572 
573  // append + write via file descriptor from file handle
574 #ifdef PLATFORM_WINDOWS
575  const auto wideTxtFilePath = NativeFileStream::makeWidePath(txtFilePath);
576  const auto appendFileHandle = _wfopen(wideTxtFilePath.get(), L"a+");
577 #else
578  const auto appendFileHandle = fopen(txtFilePath.data(), "a");
579 #endif
580  CPPUNIT_ASSERT(appendFileHandle);
581  fileStream2.open(fileno(appendFileHandle), ios_base::out | ios_base::app);
582  CPPUNIT_ASSERT(fileStream2.is_open());
583  fileStream2 << "foo";
584  fileStream2.close();
585  CPPUNIT_ASSERT(!fileStream2.is_open());
586  CPPUNIT_ASSERT_EQUAL("barfoo"s, readFile(txtFilePath, 7));
587 }
588 #endif
#define CPP_UTILITIES_UNUSED(x)
Prevents warnings about unused variables.
Definition: global.h:92
Reads primitive data types from a std::istream.
Definition: binaryreader.h:11
std::int64_t readInt64LE()
Reads a 64-bit little endian signed integer from the current stream and advances the current position...
Definition: binaryreader.h:505
float readFloat32BE()
Reads a 32-bit big endian floating point value from the current stream and advances the current posit...
Definition: binaryreader.h:379
std::string readTerminatedString(std::uint8_t termination=0)
Reads a terminated string from the current stream.
std::string readString(std::size_t length)
Reads a string from the current stream of the given length from the stream and advances the current p...
std::uint64_t readUInt64LE()
Reads a 64-bit little endian unsigned integer from the current stream and advances the current positi...
Definition: binaryreader.h:514
std::string readLengthPrefixedString()
Reads a length prefixed string from the current stream.
Definition: binaryreader.h:580
std::int64_t readInt40LE()
Reads a 40-bit little endian signed integer from the current stream and advances the current position...
Definition: binaryreader.h:457
std::int32_t readInt32BE()
Reads a 32-bit big endian signed integer from the current stream and advances the current position of...
Definition: binaryreader.h:285
std::int32_t readInt24LE()
Reads a 24-bit little endian signed integer from the current stream and advances the current position...
Definition: binaryreader.h:415
std::uint32_t readUInt32LE()
Reads a 32-bit little endian unsigned integer from the current stream and advances the current positi...
Definition: binaryreader.h:448
std::uint16_t readUInt16LE()
Reads a 16-bit little endian unsigned integer from the current stream and advances the current positi...
Definition: binaryreader.h:406
void setStream(std::istream *stream, bool giveOwnership=false)
Assigns the stream the reader will read from when calling one of the read-methods.
std::uint64_t readUInt56BE()
Reads a 56-bit big endian unsigned integer from the current stream and advances the current position ...
Definition: binaryreader.h:341
bool readBool()
Reads a boolean value from the current stream and advances the current position of the stream by one ...
Definition: binaryreader.h:570
std::uint32_t readUInt24BE()
Reads a 24-bit big endian unsigned integer from the current stream and advances the current position ...
Definition: binaryreader.h:275
std::int32_t readInt32LE()
Reads a 32-bit little endian signed integer from the current stream and advances the current position...
Definition: binaryreader.h:439
const std::istream * stream() const
Returns a pointer to the stream the reader will read from when calling one of the read-methods.
Definition: binaryreader.h:148
std::int16_t readInt16BE()
Reads a 16-bit big endian signed integer from the current stream and advances the current position of...
Definition: binaryreader.h:243
std::uint32_t readUInt24LE()
Reads a 24-bit little endian unsigned integer from the current stream and advances the current positi...
Definition: binaryreader.h:429
std::int64_t readInt56LE()
Reads a 56-bit little endian signed integer from the current stream and advances the current position...
Definition: binaryreader.h:481
std::istream::pos_type readRemainingBytes()
Returns the number of remaining bytes in the stream from the current offset.
std::uint64_t readUInt64BE()
Reads a 64-bit big endian unsigned integer from the current stream and advances the current position ...
Definition: binaryreader.h:360
bool hasOwnership() const
Returns whether the reader takes ownership over the assigned stream.
Definition: binaryreader.h:160
std::uint64_t readUInt40LE()
Reads a 40-bit little endian unsigned integer from the current stream and advances the current positi...
Definition: binaryreader.h:471
std::uint64_t readUInt56LE()
Reads a 56-bit little endian unsigned integer from the current stream and advances the current positi...
Definition: binaryreader.h:495
std::uint16_t readUInt16BE()
Reads a 16-bit big endian unsigned integer from the current stream and advances the current position ...
Definition: binaryreader.h:252
std::int32_t readInt24BE()
Reads a 24-bit big endian signed integer from the current stream and advances the current position of...
Definition: binaryreader.h:261
std::int64_t readInt40BE()
Reads a 40-bit big endian signed integer from the current stream and advances the current position of...
Definition: binaryreader.h:303
double readFloat64BE()
Reads a 64-bit big endian floating point value from the current stream and advances the current posit...
Definition: binaryreader.h:388
std::uint32_t readUInt32BE()
Reads a 32-bit big endian unsigned integer from the current stream and advances the current position ...
Definition: binaryreader.h:294
std::int64_t readInt56BE()
Reads a 56-bit big endian signed integer from the current stream and advances the current position of...
Definition: binaryreader.h:327
std::int16_t readInt16LE()
Reads a 16-bit little endian signed integer from the current stream and advances the current position...
Definition: binaryreader.h:397
double readFloat64LE()
Reads a 64-bit little endian floating point value from the current stream and advances the current po...
Definition: binaryreader.h:542
std::int64_t readInt64BE()
Reads a 64-bit big endian signed integer from the current stream and advances the current position of...
Definition: binaryreader.h:351
std::istream::pos_type readStreamsize()
Returns the size of the assigned stream.
std::uint64_t readUInt40BE()
Reads a 40-bit big endian unsigned integer from the current stream and advances the current position ...
Definition: binaryreader.h:317
float readFloat32LE()
Reads a 32-bit little endian floating point value from the current stream and advances the current po...
Definition: binaryreader.h:533
std::uint8_t readByte()
Reads a single byte/unsigned character from the current stream and advances the current position of t...
Definition: binaryreader.h:560
Writes primitive data types to a std::ostream.
Definition: binarywriter.h:14
void writeFloat32LE(float value)
Writes a 32-bit little endian floating point value to the current stream and advances the current pos...
Definition: binarywriter.h:517
void writeUInt40BE(std::uint64_t value)
Writes a 40-bit big endian unsigned integer to the current stream and advances the current position o...
Definition: binarywriter.h:318
void writeUInt64LE(std::uint64_t value)
Writes a 64-bit little endian unsigned integer to the current stream and advances the current positio...
Definition: binarywriter.h:499
void writeInt40LE(std::int64_t value)
Writes a 40-bit big endian signed integer to the current stream and advances the current position of ...
Definition: binarywriter.h:451
void writeUInt40LE(std::uint64_t value)
Writes a 40-bit big endian unsigned integer to the current stream and advances the current position o...
Definition: binarywriter.h:461
void writeInt64BE(std::int64_t value)
Writes a 64-bit big endian signed integer to the current stream and advances the current position of ...
Definition: binarywriter.h:347
void writeInt32LE(std::int32_t value)
Writes a 32-bit little endian signed integer to the current stream and advances the current position ...
Definition: binarywriter.h:432
bool hasOwnership() const
Returns whether the writer takes ownership over the assigned stream.
Definition: binarywriter.h:157
void writeUInt24LE(std::uint32_t value)
Writes a 24-bit little endian unsigned integer to the current stream and advances the current positio...
Definition: binarywriter.h:422
void writeFloat32BE(float value)
Writes a 32-bit big endian floating point value to the current stream and advances the current positi...
Definition: binarywriter.h:374
void writeInt24BE(std::int32_t value)
Writes a 24-bit big endian signed integer to the current stream and advances the current position of ...
Definition: binarywriter.h:269
void setStream(std::ostream *stream, bool giveOwnership=false)
Assigns the stream the writer will write to when calling one of the write-methods.
void writeUInt56BE(std::uint64_t value)
Writes a 56-bit big endian unsigned integer to the current stream and advances the current position o...
Definition: binarywriter.h:338
void writeUInt32BE(std::uint32_t value)
Writes a 32-bit big endian unsigned integer to the current stream and advances the current position o...
Definition: binarywriter.h:298
void writeFloat64BE(double value)
Writes a 64-bit big endian floating point value to the current stream and advances the current positi...
Definition: binarywriter.h:383
void writeFloat64LE(double value)
Writes a 64-bit little endian floating point value to the current stream and advances the current pos...
Definition: binarywriter.h:526
void writeString(const std::string &value)
Writes a string to the current stream and advances the current position of the stream by the length o...
Definition: binarywriter.h:535
void writeUInt56LE(std::uint64_t value)
Writes a 56-bit big endian unsigned integer to the current stream and advances the current position o...
Definition: binarywriter.h:481
void writeInt56LE(std::int64_t value)
Writes a 56-bit big endian signed integer to the current stream and advances the current position of ...
Definition: binarywriter.h:471
const std::ostream * stream() const
Returns a pointer to the stream the writer will write to when calling one of the write-methods.
Definition: binarywriter.h:145
void writeUInt16BE(std::uint16_t value)
Writes a 16-bit big endian unsigned integer to the current stream and advances the current position o...
Definition: binarywriter.h:259
void writeUInt64BE(std::uint64_t value)
Writes a 64-bit big endian unsigned integer to the current stream and advances the current position o...
Definition: binarywriter.h:356
void writeInt56BE(std::int64_t value)
Writes a 56-bit big endian signed integer to the current stream and advances the current position of ...
Definition: binarywriter.h:328
void writeInt16LE(std::int16_t value)
Writes a 16-bit little endian signed integer to the current stream and advances the current position ...
Definition: binarywriter.h:392
void writeUInt32LE(std::uint32_t value)
Writes a 32-bit little endian unsigned integer to the current stream and advances the current positio...
Definition: binarywriter.h:441
void writeUInt16LE(std::uint16_t value)
Writes a 16-bit little endian unsigned integer to the current stream and advances the current positio...
Definition: binarywriter.h:401
void writeInt16BE(std::int16_t value)
Writes a 16-bit big endian signed integer to the current stream and advances the current position of ...
Definition: binarywriter.h:250
void writeLengthPrefixedString(const std::string &value)
Writes the length of a string and the string itself to the current stream.
Definition: binarywriter.h:555
void writeInt24LE(std::int32_t value)
Writes a 24-bit little endian signed integer to the current stream and advances the current position ...
Definition: binarywriter.h:411
void writeUInt24BE(std::uint32_t value)
Writes a 24-bit big endian unsigned integer to the current stream and advances the current position o...
Definition: binarywriter.h:279
void writeTerminatedString(const std::string &value)
Writes a terminated string to the current stream and advances the current position of the stream by t...
Definition: binarywriter.h:543
void writeInt64LE(std::int64_t value)
Writes a 64-bit little endian signed integer to the current stream and advances the current position ...
Definition: binarywriter.h:490
void writeInt32BE(std::int32_t value)
Writes a 32-bit big endian signed integer to the current stream and advances the current position of ...
Definition: binarywriter.h:289
void writeInt40BE(std::int64_t value)
Writes a 40-bit big endian signed integer to the current stream and advances the current position of ...
Definition: binarywriter.h:308
void writeBool(bool value)
Writes a boolean value to the current stream and advances the current position of the stream by one b...
Definition: binarywriter.h:242
The BitReader class provides bitwise reading of buffered data.
Definition: bitreader.h:13
void reset(const char *buffer, std::size_t bufferSize)
Resets the reader.
Definition: bitreader.h:148
std::uint8_t readBit()
Reads the one bit from the buffer advancing the current position by one bit.
Definition: bitreader.h:89
void skipBits(std::size_t bitCount)
Skips the specified number of bits without reading it.
Definition: bitreader.cpp:18
void align()
Re-establishes alignment.
Definition: bitreader.h:171
std::size_t bitsAvailable()
Returns the number of bits which are still available to read.
Definition: bitreader.h:137
intType readSignedExpGolombCodedBits()
Reads "Exp-Golomb coded" bits (signed).
Definition: bitreader.h:119
intType readUnsignedExpGolombCodedBits()
Reads "Exp-Golomb coded" bits (unsigned).
Definition: bitreader.h:102
intType readBits(std::uint8_t bitCount)
Reads the specified number of bits from the buffer advancing the current position by bitCount bits.
Definition: bitreader.h:67
intType showBits(std::uint8_t bitCount)
Reads the specified number of bits from the buffer without advancing the current position.
Definition: bitreader.h:128
The ConversionException class is thrown by the various conversion functions of this library when a co...
The CopyHelper class helps to copy bytes from one stream to another.
Definition: copy.h:16
void copy(std::istream &input, std::ostream &output, std::size_t count)
Copies count bytes from input to output.
Definition: copy.h:43
The IniFile class allows parsing and writing INI files.
Definition: inifile.h:16
void parse(std::istream &inputStream)
Parses all data from the specified inputStream.
Definition: inifile.cpp:40
ScopeList & data()
Returns the data of the file.
Definition: inifile.h:46
void make(std::ostream &outputStream)
Write the current data to the specified outputStream.
Definition: inifile.cpp:159
The IoTests class tests classes and functions provided by the files inside the io directory.
Definition: iotests.cpp:41
void testBinaryReader()
Tests the most important methods of the BinaryReader.
Definition: iotests.cpp:90
void testAnsiEscapeCodes()
Tests formatting functions of CppUtilities::EscapeCodes namespace.
Definition: iotests.cpp:455
void testIniFile()
Tests IniFile.
Definition: iotests.cpp:283
void testBitReader()
Tests the BitReader.
Definition: iotests.cpp:238
void testBinaryWriter()
Tests the most important methods of the BinaryWriter.
Definition: iotests.cpp:156
void setUp() override
Definition: iotests.cpp:79
void testCopy()
Tests CopyHelper.
Definition: iotests.cpp:392
void testPathUtilities()
Tests fileName() and removeInvalidChars().
Definition: iotests.cpp:265
void tearDown() override
Definition: iotests.cpp:83
void testWriteFile()
Tests writeFile().
Definition: iotests.cpp:445
void testReadFile()
Tests readFile().
Definition: iotests.cpp:415
void testAdvancedIniFile()
Tests AdvancedIniFile.
Definition: iotests.cpp:324
CPPUNIT_TEST_SUITE_REGISTRATION(IoTests)
constexpr auto color(Color foreground, Color background, TextAttribute displayAttribute=TextAttribute::Reset)
CPP_UTILITIES_EXPORT bool enabled
Controls whether the functions inside the EscapeCodes namespace actually make use of escape codes.
Contains literals to ease asserting with CPPUNIT_ASSERT_EQUAL.
Definition: testutils.h:317
Contains all utilities provides by the c++utilities library.
CPP_UTILITIES_EXPORT std::string readFile(const std::string &path, std::string::size_type maxSize=std::string::npos)
Reads all contents of the specified file in a single call.
Definition: misc.cpp:16
CPP_UTILITIES_EXPORT std::string testFilePath(const std::string &relativeTestFilePath)
Convenience function to invoke TestApplication::testFilePath().
Definition: testutils.h:148
CPP_UTILITIES_EXPORT std::string workingCopyPath(const std::string &relativeTestFilePath, WorkingCopyMode mode=WorkingCopyMode::CreateCopy)
Convenience function to invoke TestApplication::workingCopyPath().
Definition: testutils.h:166
CPP_UTILITIES_EXPORT std::string directory(const std::string &path)
Returns the directory of the specified path string (including trailing slash).
Definition: path.cpp:35
CPP_UTILITIES_EXPORT std::string fileName(const std::string &path)
Returns the file name and extension of the specified path string.
Definition: path.cpp:15
CPP_UTILITIES_EXPORT void writeFile(std::string_view path, std::string_view contents)
Writes all contents to the specified file in a single call.
Definition: misc.cpp:39
std::fstream NativeFileStream
CPP_UTILITIES_EXPORT void removeInvalidChars(std::string &fileName)
Removes invalid characters from the specified fileName.
Definition: path.cpp:57
The AdvancedIniFile class allows parsing and writing INI files.
Definition: inifile.h:79
void make(std::ostream &outputStream, IniFileMakeOptions options=IniFileMakeOptions::None)
Write the current data to the specified outputStream.
Definition: inifile.cpp:412
std::optional< FieldList::iterator > findField(std::string_view sectionName, std::string_view key)
Returns an iterator to the first field within the first section with matching sectionName and key.
Definition: inifile.h:170
void parse(std::istream &inputStream, IniFileParseOptions options=IniFileParseOptions::None)
Parses all data from the specified inputStream.
Definition: inifile.cpp:217
SectionList::iterator sectionEnd()
Returns an iterator that points one past the last section.
Definition: inifile.h:154
SectionList::iterator findSection(std::string_view sectionName)
Returns an iterator to the first section with the name sectionName.
Definition: inifile.h:122
#define TESTUTILS_ASSERT_LIKE_FLAGS(message, expectedRegex, regexFlags, actualString)
Asserts whether the specified string matches the specified regex.
Definition: testutils.h:277
#define TESTUTILS_ASSERT_LIKE(message, expectedRegex, actualString)
Asserts whether the specified string matches the specified regex.
Definition: testutils.h:287
constexpr int i