mirror of
https://github.com/4ian/GDevelop.git
synced 2025-10-15 10:19:04 +00:00
543 lines
15 KiB
TypeScript
543 lines
15 KiB
TypeScript
namespace gdjs {
|
|
const logger = new gdjs.Logger('Filesystem');
|
|
export namespace fileSystem {
|
|
// The Node.js path module, or null if it can't be loaded.
|
|
export let _path: any = null;
|
|
// The Node.js fs module, or null if it can't be loaded.
|
|
export let _fs: any = null;
|
|
|
|
/** Get the Node.js path module, or null if it can't be loaded */
|
|
export const _getPath = function () {
|
|
if (!_path) {
|
|
_path = typeof require !== 'undefined' ? require('path') : null;
|
|
}
|
|
return _path;
|
|
};
|
|
|
|
/** Get the Node.js fs module, or null if it can't be loaded */
|
|
export const _getFs = function () {
|
|
if (!_fs) {
|
|
_fs = typeof require !== 'undefined' ? require('fs') : null;
|
|
}
|
|
return _fs;
|
|
};
|
|
|
|
export const getDirectoryName = function (fileOrFolderPath: string) {
|
|
const path = gdjs.fileSystem._getPath();
|
|
if (!path) {
|
|
return '';
|
|
}
|
|
return path.dirname(fileOrFolderPath);
|
|
};
|
|
|
|
export const getFileName = function (filePath: string) {
|
|
const path = gdjs.fileSystem._getPath();
|
|
if (!path) {
|
|
return '';
|
|
}
|
|
return path.basename(filePath);
|
|
};
|
|
|
|
export const getExtensionName = function (filePath: string) {
|
|
const path = gdjs.fileSystem._getPath();
|
|
if (!path) {
|
|
return '';
|
|
}
|
|
return path.extname(filePath);
|
|
};
|
|
|
|
/**
|
|
* Get the path to 'Desktop' folder.
|
|
* @param instanceContainer The current container
|
|
* @return The path to the desktop folder
|
|
*/
|
|
export const getDesktopPath = function (
|
|
instanceContainer: gdjs.RuntimeInstanceContainer
|
|
): string {
|
|
const remote = instanceContainer
|
|
.getGame()
|
|
.getRenderer()
|
|
.getElectronRemote();
|
|
const app = remote ? remote.app : null;
|
|
if (app) {
|
|
return app.getPath('desktop') || '';
|
|
} else {
|
|
return '';
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Get the path to 'Documents' folder.
|
|
* @param instanceContainer The current container
|
|
* @return The path to the documents folder
|
|
*/
|
|
export const getDocumentsPath = function (
|
|
instanceContainer: gdjs.RuntimeInstanceContainer
|
|
): string {
|
|
const remote = instanceContainer
|
|
.getGame()
|
|
.getRenderer()
|
|
.getElectronRemote();
|
|
const app = remote ? remote.app : null;
|
|
if (app) {
|
|
return app.getPath('documents') || '';
|
|
} else {
|
|
return '';
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Get the path to 'Pictures' folder.
|
|
* @param instanceContainer The current container
|
|
* @return The path to the pictures folder
|
|
*/
|
|
export const getPicturesPath = function (
|
|
instanceContainer: gdjs.RuntimeInstanceContainer
|
|
): string {
|
|
const remote = instanceContainer
|
|
.getGame()
|
|
.getRenderer()
|
|
.getElectronRemote();
|
|
const app = remote ? remote.app : null;
|
|
if (app) {
|
|
return app.getPath('pictures') || '';
|
|
} else {
|
|
return '';
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Get the path to this application 'Executable' file.
|
|
* @param instanceContainer The current container
|
|
* @return The path to this applications executable file
|
|
*/
|
|
export const getExecutablePath = function (
|
|
instanceContainer: gdjs.RuntimeInstanceContainer
|
|
): string {
|
|
const remote = instanceContainer
|
|
.getGame()
|
|
.getRenderer()
|
|
.getElectronRemote();
|
|
const app = remote ? remote.app : null;
|
|
if (app) {
|
|
return app.getPath('exe') || '';
|
|
} else {
|
|
return '';
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Get the path to this application 'Executable' folder.
|
|
* @param instanceContainer The current container
|
|
* @return The path to this applications executable folder
|
|
*/
|
|
export const getExecutableFolderPath = function (
|
|
instanceContainer: gdjs.RuntimeInstanceContainer
|
|
): string {
|
|
const path = gdjs.fileSystem._getPath();
|
|
const executablePath = gdjs.fileSystem.getExecutablePath(
|
|
instanceContainer
|
|
);
|
|
if (!path) {
|
|
return '';
|
|
}
|
|
return path.dirname(executablePath);
|
|
};
|
|
|
|
/**
|
|
* Get the path to 'UserData' folder.
|
|
* @param instanceContainer The current container
|
|
* @return The path to userdata folder
|
|
*/
|
|
export const getUserdataPath = function (
|
|
instanceContainer: gdjs.RuntimeInstanceContainer
|
|
): string {
|
|
const remote = instanceContainer
|
|
.getGame()
|
|
.getRenderer()
|
|
.getElectronRemote();
|
|
const app = remote ? remote.app : null;
|
|
if (app) {
|
|
return app.getPath('userData') || '';
|
|
} else {
|
|
return '';
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Get the path to the user's home folder (on Windows `C:\Users\<USERNAME>\` for example).
|
|
* @return The path to user's "home" folder
|
|
*/
|
|
export const getUserHomePath = function (
|
|
instanceContainer: gdjs.RuntimeInstanceContainer
|
|
): string {
|
|
const remote = instanceContainer
|
|
.getGame()
|
|
.getRenderer()
|
|
.getElectronRemote();
|
|
const app = remote ? remote.app : null;
|
|
if (app) {
|
|
return app.getPath('home') || '';
|
|
} else {
|
|
return '';
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Get the path to 'Temp' folder.
|
|
* @param instanceContainer The current container
|
|
* @return The path to temp folder
|
|
*/
|
|
export const getTempPath = function (
|
|
instanceContainer: gdjs.RuntimeInstanceContainer
|
|
): string {
|
|
const remote = instanceContainer
|
|
.getGame()
|
|
.getRenderer()
|
|
.getElectronRemote();
|
|
const app = remote ? remote.app : null;
|
|
if (app) {
|
|
return app.getPath('temp') || '';
|
|
} else {
|
|
return '';
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Get the path delimiter specific to the operating system.
|
|
* @return The path delimiter
|
|
*/
|
|
export const getPathDelimiter = function (): string {
|
|
const path = gdjs.fileSystem._getPath();
|
|
if (path) {
|
|
return path.sep || '/';
|
|
} else {
|
|
return '/';
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Create a new directory at the given path.
|
|
* @param directory The path to create a new directory
|
|
* @param resultVar The variable where to store the result of the operation
|
|
*/
|
|
export const makeDirectory = function (
|
|
directory: string,
|
|
resultVar: gdjs.Variable
|
|
) {
|
|
const fileSystem = gdjs.fileSystem._getFs();
|
|
let result = 'error';
|
|
if (fileSystem) {
|
|
try {
|
|
fileSystem.mkdirSync(directory);
|
|
result = 'ok';
|
|
} catch (err) {
|
|
logger.error(
|
|
"Unable to create directory at: '" + directory + "': ",
|
|
err
|
|
);
|
|
}
|
|
}
|
|
resultVar.setString(result);
|
|
};
|
|
|
|
/**
|
|
* Save a string into a file, asynchronously.
|
|
* @param text The string to be saved
|
|
* @param savePath Path to the file
|
|
* @param resultVar The variable where to store the result of the operation
|
|
*/
|
|
export const saveStringToFileAsync = function (
|
|
text: string,
|
|
savePath: string,
|
|
resultVar: gdjs.Variable
|
|
) {
|
|
const fileSystem = gdjs.fileSystem._getFs();
|
|
if (fileSystem) {
|
|
fileSystem.writeFile(savePath, text, 'utf8', (err) => {
|
|
resultVar.setString('ok');
|
|
if (err) {
|
|
logger.error(
|
|
"Unable to save the text to path: '" + savePath + "': ",
|
|
err
|
|
);
|
|
resultVar.setString('error');
|
|
}
|
|
});
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Save a string into a file.
|
|
* @param text The string to be saved
|
|
* @param savePath Path to the file
|
|
* @param resultVar The variable where to store the result of the operation
|
|
*/
|
|
export const saveStringToFile = function (
|
|
text: string,
|
|
savePath: string,
|
|
resultVar: gdjs.Variable
|
|
) {
|
|
const fileSystem = gdjs.fileSystem._getFs();
|
|
let result = 'error';
|
|
if (fileSystem) {
|
|
try {
|
|
fileSystem.writeFileSync(savePath, text, 'utf8');
|
|
result = 'ok';
|
|
} catch (err) {
|
|
logger.error(
|
|
"Unable to save the text to path: '" + savePath + "': ",
|
|
err
|
|
);
|
|
}
|
|
}
|
|
resultVar.setString(result);
|
|
};
|
|
|
|
/**
|
|
* Save a variable into a file in JSON format.
|
|
* @param variable The variable to be saved
|
|
* @param savePath Path to the file
|
|
* @param resultVar The variable where to store the result of the operation
|
|
*/
|
|
export const saveVariableToJSONFile = function (
|
|
variable: gdjs.Variable,
|
|
savePath: string,
|
|
resultVar: gdjs.Variable
|
|
) {
|
|
const fileSystem = gdjs.fileSystem._getFs();
|
|
let result = 'error';
|
|
if (fileSystem) {
|
|
try {
|
|
fileSystem.writeFileSync(
|
|
savePath,
|
|
JSON.stringify(variable.toJSObject()),
|
|
'utf8'
|
|
);
|
|
result = 'ok';
|
|
} catch (err) {
|
|
logger.error(
|
|
"Unable to save the variable to path: '" + savePath + "': ",
|
|
err
|
|
);
|
|
}
|
|
}
|
|
resultVar.setString(result);
|
|
};
|
|
|
|
/**
|
|
* Save a variable into a file in JSON format, asynchronously.
|
|
* @param variable The variable to be saved
|
|
* @param savePath Path to the file
|
|
* @param resultVar The variable where to store the result of the operation
|
|
*/
|
|
export const saveVariableToJSONFileAsync = function (
|
|
variable: gdjs.Variable,
|
|
savePath: string,
|
|
resultVar: gdjs.Variable
|
|
) {
|
|
const fileSystem = gdjs.fileSystem._getFs();
|
|
if (fileSystem) {
|
|
fileSystem.writeFile(
|
|
savePath,
|
|
JSON.stringify(variable.toJSObject()),
|
|
'utf8',
|
|
(err) => {
|
|
resultVar.setString('ok');
|
|
if (err) {
|
|
logger.error(
|
|
"Unable to save the variable to path: '" + savePath + "': ",
|
|
err
|
|
);
|
|
resultVar.setString('error');
|
|
}
|
|
}
|
|
);
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Load a string from a file into a scene variable.
|
|
* @param stringVar Variable where to store the content
|
|
* @param loadPath Path to the file
|
|
* @param resultVar The variable where to store the result of the operation
|
|
*/
|
|
export const loadStringFromFile = function (
|
|
stringVar: gdjs.Variable,
|
|
loadPath: string,
|
|
resultVar: gdjs.Variable
|
|
) {
|
|
const fileSystem = gdjs.fileSystem._getFs();
|
|
let result = 'error';
|
|
if (fileSystem) {
|
|
try {
|
|
const data = fileSystem.readFileSync(loadPath, 'utf8');
|
|
if (data) {
|
|
stringVar.setString(data);
|
|
result = 'ok';
|
|
}
|
|
} catch (err) {
|
|
logger.error(
|
|
"Unable to load the file at path: '" + loadPath + "': ",
|
|
err
|
|
);
|
|
}
|
|
}
|
|
resultVar.setString(result);
|
|
};
|
|
|
|
/**
|
|
* Load a JSON file and convert it into a variable.
|
|
* @param variable Variable to store the variable
|
|
* @param loadPath Path to the file
|
|
* @param resultVar The variable where to store the result of the operation
|
|
*/
|
|
export const loadVariableFromJSONFile = function (
|
|
variable: gdjs.Variable,
|
|
loadPath: string,
|
|
resultVar: gdjs.Variable
|
|
) {
|
|
const fileSystem = gdjs.fileSystem._getFs();
|
|
let result = 'error';
|
|
if (fileSystem) {
|
|
try {
|
|
const data = fileSystem.readFileSync(loadPath, 'utf8');
|
|
if (data) {
|
|
variable.fromJSON(data);
|
|
result = 'ok';
|
|
}
|
|
} catch (err) {
|
|
logger.error(
|
|
"Unable to load variable from the file at path: '" +
|
|
loadPath +
|
|
"': ",
|
|
err
|
|
);
|
|
}
|
|
}
|
|
resultVar.setString(result);
|
|
};
|
|
|
|
/**
|
|
* Load a JSON file and convert it into a variable, asynchronously.
|
|
* @param variable Variable to store the variable
|
|
* @param loadPath Path to the file
|
|
* @param resultVar The variable where to store the result of the operation
|
|
*/
|
|
export const loadVariableFromJSONFileAsync = function (
|
|
variable: gdjs.Variable,
|
|
loadPath: string,
|
|
resultVar: gdjs.Variable
|
|
) {
|
|
const fileSystem = gdjs.fileSystem._getFs();
|
|
if (fileSystem) {
|
|
fileSystem.readFile(loadPath, 'utf8', (err, data) => {
|
|
if (data) {
|
|
variable.fromJSON(data);
|
|
resultVar.setString('ok');
|
|
}
|
|
if (err) {
|
|
logger.error(
|
|
"Unable to load variable from the file at path: '" +
|
|
loadPath +
|
|
"': ",
|
|
err
|
|
);
|
|
resultVar.setString('error');
|
|
}
|
|
});
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Load a string from a file into a scene variable, asynchronously.
|
|
* @param stringVar Variable where to store the content
|
|
* @param loadPath Path to the file
|
|
* @param resultVar The variable where to store the result of the operation
|
|
*/
|
|
export const loadStringFromFileAsync = function (
|
|
stringVar: gdjs.Variable,
|
|
loadPath: string,
|
|
resultVar: gdjs.Variable
|
|
) {
|
|
const fileSystem = gdjs.fileSystem._getFs();
|
|
if (fileSystem) {
|
|
fileSystem.readFile(loadPath, 'utf8', (err, data) => {
|
|
if (data) {
|
|
stringVar.setString(data);
|
|
resultVar.setString('ok');
|
|
}
|
|
if (err) {
|
|
logger.error(
|
|
"Unable to load the file at path: '" + loadPath + "': ",
|
|
err
|
|
);
|
|
resultVar.setString('error');
|
|
}
|
|
});
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Delete a file from the filesystem.
|
|
* @param filePath Path to the file
|
|
* @param resultVar The variable where to store the result of the operation
|
|
*/
|
|
export const deleteFile = function (
|
|
filePath: string,
|
|
resultVar: gdjs.Variable
|
|
) {
|
|
const fileSystem = gdjs.fileSystem._getFs();
|
|
let result = 'error';
|
|
if (fileSystem) {
|
|
try {
|
|
fileSystem.unlinkSync(filePath);
|
|
result = 'ok';
|
|
} catch (err) {
|
|
logger.error("Unable to delete the file: '" + filePath + "': ", err);
|
|
result = 'error';
|
|
}
|
|
}
|
|
resultVar.setString(result);
|
|
};
|
|
|
|
/**
|
|
* Delete a file from the filesystem, asynchronously.
|
|
* @param filePath Path to the file
|
|
* @param resultVar The variable where to store the result of the operation
|
|
*/
|
|
export const deleteFileAsync = function (
|
|
filePath: string,
|
|
resultVar: gdjs.Variable
|
|
) {
|
|
const fileSystem = gdjs.fileSystem._getFs();
|
|
if (fileSystem) {
|
|
fileSystem.unlink(filePath, (err) => {
|
|
resultVar.setString('ok');
|
|
if (err) {
|
|
logger.error(
|
|
"Unable to delete the file: '" + filePath + "': ",
|
|
err
|
|
);
|
|
resultVar.setString('error');
|
|
}
|
|
});
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Check if the file or directory exists.
|
|
* @param filePath The path to the file or directory
|
|
* @return true if fhe file or directory exists
|
|
*/
|
|
export const pathExists = function (filePath: string): boolean {
|
|
const fileSystem = gdjs.fileSystem._getFs();
|
|
if (fileSystem) {
|
|
return fileSystem.existsSync(filePath);
|
|
} else {
|
|
return false;
|
|
}
|
|
};
|
|
}
|
|
}
|