// Copyright (C) 2016 The Qt Company Ltd. // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only WITH Qt-GPL-exception-1.0 #include "fileutils.h" #include "coreconstants.h" #include "coreplugintr.h" #include "documentmanager.h" #include "editormanager/editormanager.h" #include "foldernavigationwidget.h" #include "icore.h" #include "iversioncontrol.h" #include "messagemanager.h" #include "navigationwidget.h" #include "vcsmanager.h" #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #ifdef Q_OS_WIN #ifdef QTCREATOR_PCH_H #define CALLBACK WINAPI #endif #include #include #endif #ifdef QTC_SUPPORT_DBUSFILEMANAGER #include "systemsettings.h" #include static Q_LOGGING_CATEGORY(fileutilsLog, "qtc.core.fileutils", QtWarningMsg) #endif using namespace Utils; namespace Core::FileUtils { static bool openFreedesktopFileManager(const FilePath &path) { #ifdef QTC_SUPPORT_DBUSFILEMANAGER if (!Core::Internal::systemSettings().useDbusFileManagers()) return false; if (!QDBusConnection::sessionBus().isConnected()) { qCDebug(fileutilsLog) << "Could not connect to session DBus"; return false; } const QLatin1String serviceName = QLatin1String("org.freedesktop.FileManager1"); const QLatin1String objectPath = QLatin1String("/org/freedesktop/FileManager1"); const QLatin1String interfaceName = QLatin1String("org.freedesktop.FileManager1"); QStringList uriList = {QUrl::fromLocalFile(path.canonicalPath().toFSPathString()).toString()}; QString startupId; QDBusInterface iface(serviceName, objectPath, interfaceName, QDBusConnection::sessionBus()); if (!iface.isValid()) { qCDebug(fileutilsLog) << "Could not find DBus" << serviceName << "service:" << iface.lastError().message(); return false; } QDBusMessage reply = iface.call(QLatin1String("ShowItems"), uriList, startupId); if (reply.type() == QDBusMessage::ErrorMessage) { qCDebug(fileutilsLog) << "Received DBus error:" << reply.errorName() << reply.errorMessage(); return false; } return true; #else Q_UNUSED(path) return false; #endif } static FilePath windowsDirectory() { #ifdef Q_OS_WIN wchar_t str[UNICODE_STRING_MAX_CHARS] = {}; if (SUCCEEDED(SHGetFolderPath(nullptr, CSIDL_WINDOWS, nullptr, 0, str))) return FilePath::fromUserInput(QString::fromUtf16(reinterpret_cast(str))); #endif return {}; } // Show error with option to open settings. static void showGraphicalShellError(const QString &app, const QString &error) { const QString title = Tr::tr("Launching a file browser failed"); const QString msg = Tr::tr("Unable to start the file manager:\n\n%1\n\n").arg(app); QMessageBox mbox(QMessageBox::Warning, title, msg, QMessageBox::Close, ICore::dialogParent()); if (!error.isEmpty()) mbox.setDetailedText(Tr::tr("\"%1\" returned the following error:\n\n%2").arg(app, error)); QAbstractButton *settingsButton = mbox.addButton(Core::ICore::msgShowOptionsDialog(), QMessageBox::ActionRole); mbox.exec(); if (mbox.clickedButton() == settingsButton) ICore::showOptionsDialog(Constants::SETTINGS_ID_INTERFACE, ICore::dialogParent()); } void showInGraphicalShell(const FilePath &pathIn) { if (openFreedesktopFileManager(pathIn)) return; const QFileInfo fileInfo = pathIn.toFileInfo(); // Mac, Windows support folder or file. if (HostOsInfo::isWindowsHost()) { const FilePath explorer = windowsDirectory().pathAppended("explorer.exe"); QStringList param; if (!pathIn.isDir()) param += QLatin1String("/select,"); param += QDir::toNativeSeparators(fileInfo.canonicalFilePath()); Process::startDetached({explorer, param}); } else if (HostOsInfo::isMacHost()) { Process::startDetached({"/usr/bin/open", {"-R", fileInfo.canonicalFilePath()}}); } else { // we cannot select a file here, because no file browser really supports it... const QString folder = fileInfo.isDir() ? fileInfo.absoluteFilePath() : fileInfo.filePath(); const QString app = UnixUtils::fileBrowser(ICore::settings()); QStringList browserArgs = ProcessArgs::splitArgs( UnixUtils::substituteFileBrowserParameters(app, folder), HostOsInfo::hostOs()); QString error; if (browserArgs.isEmpty()) { error = Tr::tr("The command for file browser is not set."); } else { const QString executable = browserArgs.takeFirst(); if (!Process::startDetached({FilePath::fromString(executable), browserArgs})) error = Tr::tr("Error while starting file browser."); } if (!error.isEmpty()) showGraphicalShellError(app, error); } } void showInFileSystemView(const FilePath &path) { QWidget *widget = NavigationWidget::activateSubWidget(FolderNavigationWidgetFactory::instance()->id(), Side::Left); if (auto *navWidget = qobject_cast(widget)) navWidget->syncWithFilePath(path); } void openTerminal(const FilePath &path, const Environment &env) { Terminal::Hooks::instance().openTerminal({path, env}); } QString msgFindInDirectory() { return Tr::tr("Find in This Directory..."); } QString msgFileSystemAction() { return Tr::tr("Show in File System View"); } QString msgGraphicalShellAction() { if (HostOsInfo::isWindowsHost()) return Tr::tr("Show in Explorer"); if (HostOsInfo::isMacHost()) return Tr::tr("Show in Finder"); #ifdef QTC_SUPPORT_DBUSFILEMANAGER return Tr::tr("Show in File Manager"); #else return Tr::tr("Show Containing Folder"); #endif } QString msgTerminalHereAction() { if (HostOsInfo::isWindowsHost()) return Tr::tr("Open Command Prompt Here"); return Tr::tr("Open Terminal Here"); } QString msgTerminalWithAction() { if (HostOsInfo::isWindowsHost()) return Tr::tr("Open Command Prompt With", "Opens a submenu for choosing an environment, such as \"Run Environment\""); return Tr::tr("Open Terminal With", "Opens a submenu for choosing an environment, such as \"Run Environment\""); } void removeFiles(const FilePaths &filePaths, bool deleteFromFS) { // remove from version control VcsManager::promptToDelete(filePaths); if (!deleteFromFS) return; // remove from file system for (const FilePath &fp : filePaths) { if (!fp.exists()) // could have been deleted by vc continue; Result<> removeResult = fp.removeFile(); if (!removeResult) { MessageManager::writeDisrupting( Tr::tr("Failed to remove file \"%1\": %2").arg(fp.toUserOutput()).arg(removeResult.error())); } } } // This method is used to refactor the include guards in the renamed headers static Result<> updateHeaderFileGuardAfterRename(const FilePath &headerPath, const QString &oldHeaderBaseName) { const Result content = headerPath.fileContents(); if (!content) return ResultError(content.error()); QRegularExpression guardConditionRegExp( QString("(#ifndef)(\\s*)(_*)%1_H(_*)(\\s*)").arg(oldHeaderBaseName.toUpper())); QRegularExpression guardDefineRegexp, guardCloseRegExp; QRegularExpressionMatch guardConditionMatch, guardDefineMatch, guardCloseMatch; int guardStartLine = -1; int guardCloseLine = -1; TextFileFormat headerFileTextFormat; headerFileTextFormat.detectFromData(*content); if (!headerFileTextFormat.encoding().isValid()) headerFileTextFormat.setEncoding(EditorManager::defaultTextEncoding()); QString stringContent; if (!headerFileTextFormat.decode(*content, &stringContent)) return ResultError(Tr::tr("Cannot decode contents.")); QTextStream inStream(&stringContent); int lineCounter = 0; QString line; while (!inStream.atEnd()) { // use trimmed line to get rid from the maunder leading spaces inStream.readLineInto(&line); line = line.trimmed(); if (line == QStringLiteral("#pragma once")) { // if pragma based guard found skip reading the whole file break; } if (guardStartLine == -1) { // we are still looking for the guard condition guardConditionMatch = guardConditionRegExp.match(line); if (guardConditionMatch.hasMatch()) { guardDefineRegexp.setPattern(QString("(#define\\s*%1)%2(_H%3\\s*)") .arg(guardConditionMatch.captured(3), oldHeaderBaseName.toUpper(), guardConditionMatch.captured(4))); // read the next line for the guard define line = inStream.readLine(); if (!inStream.atEnd()) { guardDefineMatch = guardDefineRegexp.match(line); if (guardDefineMatch.hasMatch()) { // if a proper guard define present in the next line store the line number guardCloseRegExp .setPattern( QString("(#endif\\s*)(\\/\\/|\\/\\*)(\\s*%1)%2(_H%3\\s*)((\\*\\/)?)") .arg( guardConditionMatch.captured(3), oldHeaderBaseName.toUpper(), guardConditionMatch.captured(4))); guardStartLine = lineCounter; lineCounter++; } } else { // it the line after the guard opening is not something what we expect // then skip the whole guard replacing process break; } } } else { // guard start found looking for the guard closing endif guardCloseMatch = guardCloseRegExp.match(line); if (guardCloseMatch.hasMatch()) { guardCloseLine = lineCounter; break; } } lineCounter++; } if (guardStartLine == -1) return ResultOk; const FilePath tmpHeader = headerPath.stringAppended(".tmp"); // At least the guard have been found -> // copy the contents of the header to a temporary file with the updated guard lines inStream.seek(0); const auto guardCondition = QString("#ifndef%1%2%3_H%4%5").arg( guardConditionMatch.captured(2), guardConditionMatch.captured(3), headerPath.baseName().toUpper(), guardConditionMatch.captured(4), guardConditionMatch.captured(5)); // guardDefineRegexp.setPattern(QString("(#define\\s*%1)%2(_H%3\\s*)") const auto guardDefine = QString("%1%2%3").arg( guardDefineMatch.captured(1), headerPath.baseName().toUpper(), guardDefineMatch.captured(2)); const auto guardClose = QString("%1%2%3%4%5%6").arg( guardCloseMatch.captured(1), guardCloseMatch.captured(2), guardCloseMatch.captured(3), headerPath.baseName().toUpper(), guardCloseMatch.captured(4), guardCloseMatch.captured(5)); const QString lineEnd = headerFileTextFormat.lineTerminationMode == TextFileFormat::LFLineTerminator ? QStringLiteral("\n") : QStringLiteral("\r\n"); // write into temporary string, // after that write with codec into file (QTextStream::setCodec is gone in Qt 6) QString outString; QTextStream outStream(&outString); for (int lineCounter = 0; !inStream.atEnd(); ++lineCounter) { inStream.readLineInto(&line); if (lineCounter == guardStartLine) { outStream << guardCondition << lineEnd; outStream << guardDefine << lineEnd; inStream.readLine(); lineCounter++; } else if (lineCounter == guardCloseLine) { outStream << guardClose << lineEnd; } else { outStream << line << lineEnd; } } const QByteArray encodedContent = headerFileTextFormat.encoding().encode(outString); if (const Result res = tmpHeader.writeFileContents(encodedContent); !res) return ResultError(res.error()); // if the guard was found (and updated updated properly) swap the temp and the target file if (const Result<> res = headerPath.removeFile(); !res) return res; return tmpHeader.renameFile(headerPath); } bool renameFile(const FilePath &orgFilePath, const FilePath &newFilePath, HandleIncludeGuards handleGuards) { if (orgFilePath.equalsCaseSensitive(newFilePath)) return false; const FilePath dir = orgFilePath.absolutePath(); IVersionControl *vc = VcsManager::findVersionControlForDirectory(dir); const FilePath newDir = newFilePath.absolutePath(); if (newDir != dir && !newDir.ensureWritableDir()) return false; bool result = false; if (vc && vc->supportsOperation(IVersionControl::MoveOperation)) result = vc->vcsMove(orgFilePath, newFilePath); if (!result) // The moving via vcs failed or the vcs does not support moving, fall back result = bool(orgFilePath.renameFile(newFilePath)); if (result) { DocumentManager::renamedFile(orgFilePath, newFilePath); updateHeaderFileGuardIfApplicable(orgFilePath, newFilePath, handleGuards); } return result; } void updateHeaderFileGuardIfApplicable(const FilePath &oldFilePath, const FilePath &newFilePath, HandleIncludeGuards handleGuards) { if (handleGuards == HandleIncludeGuards::No) return; const Result<> headerUpdateSuccess = updateHeaderFileGuardAfterRename(newFilePath, oldFilePath.baseName()); if (headerUpdateSuccess) return; MessageManager::writeDisrupting( Tr::tr("Failed to rename the include guard in file \"%1\": %2") .arg(newFilePath.toUserOutput(), headerUpdateSuccess.error())); } } // namespace Core::FileUtils