Q{File,FileInfo,Dir}: add std::filesystem::path overloads

Add some overloads where (I thought) it makes sense for QDir and QFile
to accept std::filesystem::path objects. Currently my thinking is to
not add overloads for static functions where std::filesystem can already
do the same job, e.g. create directory or file.

Template and enable_if is needed due to both QString and
std::filesystem::path being able to be constructed from string literals.

The common shared code is currently in QFile because QDir had an
implicit include of QFile, made explicit in this patch, and QFileInfo
has an include to QFile as well.

The QT_HAS_STD_FILESYSTEM macro is visible in user-code which I
currently take advantage of in the tests, and users could too.

Change-Id: I8d05d3c34c6c17e20972a6a2053862b8891d6c3c
Reviewed-by: Thiago Macieira <thiago.macieira@intel.com>

1 files changed, 93 insertions, 0 deletions

diff --git a/tests/auto/corelib/io/qfileinfo/tst_qfileinfo.cpp b/tests/auto/corelib/io/qfileinfo/tst_qfileinfo.cpp
index ebb9a0a44c..a1f9ca0b87 100644
--- a/tests/auto/corelib/io/qfileinfo/tst_qfileinfo.cpp
+++ b/tests/auto/corelib/io/qfileinfo/tst_qfileinfo.cpp
@@ -287,6 +287,8 @@ private slots:
     void invalidState();
     void nonExistingFile();
 
+    void stdfilesystem();
+
 private:
     const QString m_currentDir;
     QString m_sourceFile;
@@ -2269,6 +2271,97 @@ void tst_QFileInfo::nonExistingFile()
     stateCheck(info, dirname, filename);
 }
 
+void tst_QFileInfo::stdfilesystem()
+{
+#if QT_CONFIG(cxx17_filesystem)
+
+    namespace fs = std::filesystem;
+
+    // Verify constructing with fs::path leads to valid objects
+    {
+        // We compare using absoluteFilePath since QFileInfo::operator== ends up using
+        // canonicalFilePath which evaluates to empty-string for non-existent paths causing
+        // these tests to always succeed.
+#define COMPARE_CONSTRUCTION(filepath)                                                 \
+        QCOMPARE(QFileInfo(fs::path(filepath)).absoluteFilePath(),                     \
+                 QFileInfo(QString::fromLocal8Bit(filepath)).absoluteFilePath());      \
+        QCOMPARE(QFileInfo(base, fs::path(filepath)).absoluteFilePath(),               \
+                 QFileInfo(base, QString::fromLocal8Bit(filepath)).absoluteFilePath())
+
+        QDir base{ "../" }; // Used for the QFileInfo(QDir, <path>) ctor
+
+        COMPARE_CONSTRUCTION("./file");
+
+#ifdef Q_OS_WIN32
+        COMPARE_CONSTRUCTION("C:\\path\\to\\file.txt");
+        COMPARE_CONSTRUCTION("x:\\path/to\\file.txt");
+        COMPARE_CONSTRUCTION("D:/path/TO/file.txt");
+        COMPARE_CONSTRUCTION("//sharename/folder/file.txt");
+#endif
+        COMPARE_CONSTRUCTION("/path/TO/file.txt");
+        COMPARE_CONSTRUCTION("./path/TO/file.txt");
+        COMPARE_CONSTRUCTION("../file.txt");
+        COMPARE_CONSTRUCTION("./filæ.txt");
+
+#undef COMPARE_CONSTRUCTION
+        {
+            // One proper comparison with operator== for each ctor
+            QFile file(QStringLiteral("./filesystem_test_file.txt"));
+            if (!file.open(QFile::NewOnly))
+                QVERIFY(file.exists());
+            file.close();
+
+            QFileInfo pinfo{ fs::path{ "./filesystem_test_file.txt" } };
+            QFileInfo info{ QStringLiteral("./filesystem_test_file.txt") };
+            QCOMPARE(pinfo, info);
+        }
+
+        {
+            // And once more for QFileInfo(QDir, <path>)
+            const QString &subdir = QStringLiteral("./filesystem_test_dir/");
+            base = QDir(QStringLiteral("."));
+            if (!base.exists(subdir))
+                QVERIFY(base.mkdir(subdir));
+            base.cd(subdir);
+            QFile file{ base.filePath(QStringLiteral("./filesystem_test_file.txt")) };
+            if (!file.open(QFile::NewOnly))
+                QVERIFY(file.exists());
+            file.close();
+            QFileInfo pinfo{ base, fs::path{ "filesystem_test_file.txt" } };
+            QFileInfo info{ base, QStringLiteral("filesystem_test_file.txt") };
+            QCOMPARE(pinfo, info);
+        }
+    }
+
+    // Verify that functions returning path all point to the same place
+    {
+#define COMPARE_PATHS(actual, expected)                               \
+    QCOMPARE(QString::fromStdU16String(actual.u16string()), expected)
+
+        QFile file(QStringLiteral("./orig"));
+        if (!file.open(QFile::NewOnly))
+            QVERIFY(file.exists());
+        file.close();
+
+        QFileInfo info{ QStringLiteral("./orig") };
+        COMPARE_PATHS(info.filesystemPath(), info.path());
+        COMPARE_PATHS(info.filesystemAbsolutePath(), info.absolutePath());
+        COMPARE_PATHS(info.filesystemCanonicalPath(), info.canonicalPath());
+        COMPARE_PATHS(info.filesystemFilePath(), info.filePath());
+        COMPARE_PATHS(info.filesystemAbsoluteFilePath(), info.absoluteFilePath());
+        COMPARE_PATHS(info.filesystemCanonicalFilePath(), info.canonicalFilePath());
+
+        QVERIFY(file.link(QStringLiteral("./filesystem_test_symlink.lnk")));
+        info = QFileInfo{ "./filesystem_test_symlink.lnk" };
+
+        COMPARE_PATHS(info.filesystemSymLinkTarget(), info.symLinkTarget());
+#undef COMPARE_PATHS
+    }
+
+#else
+    QSKIP("Not supported");
+#endif
+}
 
 QTEST_MAIN(tst_QFileInfo)
 #include "tst_qfileinfo.moc"