sneedmc/launcher/FileSystem.h

159 lines
4.4 KiB
C
Raw Normal View History

// SPDX-License-Identifier: GPL-3.0-only
/*
* PolyMC - Minecraft Launcher
* Copyright (C) 2022 Sefa Eyeoglu <contact@scrumplex.net>
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, version 3.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*
* This file incorporates work covered by the following copyright and
* permission notice:
*
* Copyright 2013-2021 MultiMC Contributors
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#pragma once
#include "Exception.h"
#include "pathmatcher/IPathMatcher.h"
2015-10-04 23:47:27 +00:00
#include <QDir>
#include <QFlags>
namespace FS {
class FileSystemException : public ::Exception {
public:
FileSystemException(const QString& message) : Exception(message) {}
};
2015-10-04 23:47:27 +00:00
/**
* write data to a file safely
*/
void write(const QString& filename, const QByteArray& data);
2015-10-04 23:47:27 +00:00
/**
* read data from a file safely\
*/
QByteArray read(const QString& filename);
2015-10-04 23:47:27 +00:00
2016-11-17 03:09:24 +00:00
/**
* Update the last changed timestamp of an existing file
*/
bool updateTimestamp(const QString& filename);
2016-11-17 03:09:24 +00:00
2015-10-04 23:47:27 +00:00
/**
* Creates all the folders in a path for the specified path
* last segment of the path is treated as a file name and is ignored!
*/
bool ensureFilePathExists(QString filenamepath);
2015-10-04 23:47:27 +00:00
/**
* Creates all the folders in a path for the specified path
* last segment of the path is treated as a folder name and is created!
*/
bool ensureFolderPathExists(QString filenamepath);
2015-10-04 23:47:27 +00:00
class copy {
public:
copy(const QString& src, const QString& dst)
2018-07-15 12:51:05 +00:00
{
m_src.setPath(src);
m_dst.setPath(dst);
2018-07-15 12:51:05 +00:00
}
copy& followSymlinks(const bool follow)
2018-07-15 12:51:05 +00:00
{
m_followSymlinks = follow;
return *this;
}
copy& blacklist(const IPathMatcher* filter)
2018-07-15 12:51:05 +00:00
{
m_blacklist = filter;
return *this;
}
bool operator()() { return operator()(QString()); }
private:
bool operator()(const QString& offset);
private:
2018-07-15 12:51:05 +00:00
bool m_followSymlinks = true;
const IPathMatcher* m_blacklist = nullptr;
2018-07-15 12:51:05 +00:00
QDir m_src;
QDir m_dst;
};
2015-10-04 23:47:27 +00:00
/**
* Delete a folder recursively
*/
bool deletePath(QString path);
2015-10-04 23:47:27 +00:00
/**
* Trash a folder / file
*/
bool trash(QString path, QString *pathInTrash);
QString PathCombine(const QString& path1, const QString& path2);
QString PathCombine(const QString& path1, const QString& path2, const QString& path3);
QString PathCombine(const QString& path1, const QString& path2, const QString& path3, const QString& path4);
2015-10-04 23:47:27 +00:00
QString AbsolutePath(QString path);
2015-10-04 23:47:27 +00:00
/**
* Resolve an executable
*
* Will resolve:
* single executable (by name)
* relative path
* absolute path
*
* @return absolute path to executable or null string
*/
QString ResolveExecutable(QString path);
2015-10-04 23:47:27 +00:00
/**
* Normalize path
*
* Any paths inside the current directory will be normalized to relative paths (to current)
* Other paths will be made absolute
*
* Returns false if the path logic somehow filed (and normalizedPath in invalid)
*/
QString NormalizePath(QString path);
2015-10-04 23:47:27 +00:00
QString RemoveInvalidFilenameChars(QString string, QChar replaceWith = '-');
2015-10-04 23:47:27 +00:00
QString DirNameFromString(QString string, QString inDir = ".");
2015-10-04 23:47:27 +00:00
/// Checks if the a given Path contains "!"
bool checkProblemticPathJava(QDir folder);
2015-10-04 23:47:27 +00:00
// Get the Directory representing the User's Desktop
QString getDesktopDir();
2015-10-04 23:47:27 +00:00
// Overrides one folder with the contents of another, preserving items exclusive to the first folder
// Equivalent to doing QDir::rename, but allowing for overrides
bool overrideFolder(QString overwritten_path, QString override_path);
}