0ad/source/ps/ModInstaller.h
wraitii 4f972bc623 Split off JSON-related function from ScriptInterface, clean up headers.
Follows 34b1920e7b.

JSON functions and ToString are movec to their own headers.
Also clean out a few PersistentRooted usage to use the 2-phase init to
clean up scriptInterface usage.

With these functions split off, we can finally clean out headers and
remove ScriptInterface.h from most of them, in favour of smaller and
more precise headers.


Take the opportunity to clarify some comments regarding Mutability.

Differential Revision: https://code.wildfiregames.com/D3961
This was SVN commit r25434.
2021-05-14 10:18:03 +00:00

85 lines
2.1 KiB
C++

/* Copyright (C) 2021 Wildfire Games.
* This file is part of 0 A.D.
*
* 0 A.D. 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, either version 2 of the License, or
* (at your option) any later version.
*
* 0 A.D. 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 0 A.D. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef INCLUDED_MODINSTALLER
#define INCLUDED_MODINSTALLER
#include "CStr.h"
#include "lib/file/vfs/vfs.h"
#include <vector>
class ScriptContext;
/**
* Install a mod into the mods directory.
*/
class CModInstaller
{
public:
enum ModInstallationResult
{
SUCCESS,
FAIL_ON_VFS_MOUNT,
FAIL_ON_MOD_LOAD,
FAIL_ON_PARSE_JSON,
FAIL_ON_EXTRACT_NAME,
FAIL_ON_MOD_MOVE
};
/**
* Initialise the mod installer for processing the given mod.
*
* @param modsdir path to the data directory that contains mods
* @param tempdir path to a writable directory for temporary files
*/
CModInstaller(const OsPath& modsdir, const OsPath& tempdir);
~CModInstaller();
/**
* Process and unpack the mod.
* @param mod path of .pyromod/.zip file
* @param keepFile if true, copy the file, if false move it
*/
ModInstallationResult Install(
const OsPath& mod,
const std::shared_ptr<ScriptContext>& scriptContext,
bool keepFile);
/**
* @return a list of all mods installed so far by this CModInstaller.
*/
const std::vector<CStr>& GetInstalledMods() const;
/**
* @return whether the path has a mod-like extension.
*/
static bool IsDefaultModExtension(const Path& ext)
{
return ext == ".pyromod" || ext == ".zip";
}
private:
PIVFS m_VFS;
OsPath m_ModsDir;
OsPath m_TempDir;
VfsPath m_CacheDir;
std::vector<CStr> m_InstalledMods;
};
#endif // INCLUDED_MODINSTALLER