A testbed for the Ffilesystem library, to test across platforms without breaking the widely-used library. As in Ffilesystem, we use some optional C++20 features. The main focus is on the C++17 filesystem standard library. We also demonstrate techniques in C to reproduce some C++ filesystem functionality at lower fidelity--otherwise, we'd be reinventing the wheel.
Platform-independent mkdtemp() is a C++17 example of creating a temporary directory that works on Windows, Linux, macOS, MinGW, Cygwin, WSL, etc. across compilers and operating systems.
Creating canonical "Lname" as entirely the lower case version of "Uname" deliberately forces the drive/root to be lower case. In general full paths on Windows and macOS have some uppercase character elements:
- Windows: upper case drive letter
- macOS: /Users/ etc. has some upper case letters
Recursively copy a file tree.
Example of iterating over directory contents.
Is executable tests if a file is executable. On Windows filesystems such as NTFS, all files are always seen as executable. On most other filesystems, executable permissions can be detected.
Show what type a file is, such as regular file, directory, symlink, etc.
A working example of how to determine an executable's full path no matter what the current working directory is. This can be useful when a data file is known to exist relative to an executable. This is relevant to say CMake installed project that has an executable and associated data files installed. Assuming the user knows the path to the MAIN executable in the installed directory, the program can determine its own full path and then a priori know the relative path to the data file(s).
Determine the free space available on a drive.
Determine the filesystem type of a drive or partition. Note that WSL uses v9fs.
For Windows only, find the short path (8.3) from a long filename and vice versa.
Symbolic links are demonstrated across platforms, including Linux, macOS, Windows, MinGW, WSL, and Cygwin. Windows symlinks may require setting group policy (Windows Pro) or enabling Windows Developer Mode (non-Pro Windows).
Example system calls with mild effort towards security and cross-platform compatibility.