Folders.hpp

   1 /*
   2 Copyright (C) 2003, 2010 - Wolfire Games
   3 Copyright (C) 2010-2016 - Lugaru contributors (see AUTHORS file)
   4
   5 This file is part of Lugaru.
   6
   7 Lugaru is free software; you can redistribute it and/or modify
   8 it under the terms of the GNU General Public License as published by
   9 the Free Software Foundation; either version 2 of the License, or
  10 (at your option) any later version.
  11
  12 Lugaru is distributed in the hope that it will be useful,
  13 but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 GNU General Public License for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with Lugaru.  If not, see <http://www.gnu.org/licenses/>.
  19 */
  20
  21 #ifndef _FOLDERS_HPP_
  22 #define _FOLDERS_HPP_
  23
  24 #include <string>
  25
  26 #ifndef DATA_DIR
  27 #define DATA_DIR "Data"
  28 #endif
  29
  30 struct FileNotFoundException: public std::exception
  31 {
  32     std::string errorText;
  33
  34     FileNotFoundException (const std::string& filename)
  35     : errorText(filename + " could not be found")
  36     {}
  37
  38     const char * what () const throw () {
  39         return errorText.c_str();
  40     }
  41 };
  42
  43 class Folders
  44 {
  45     static const std::string dataDir;
  46
  47 public:
  48     /** Returns path to the screenshot directory. Creates it if needed. */
  49     static std::string getScreenshotDir();
  50
  51     /** Returns full path for user data */
  52     static std::string getUserDataPath();
  53
  54     /** Returns full path for config file */
  55     static std::string getConfigFilePath();
  56
  57     static FILE* openMandatoryFile(const std::string& filename, const char* mode);
  58
  59     /* Returns full path for a game resource */
  60     static inline std::string getResourcePath(const std::string& filepath)
  61     { return dataDir + '/' + filepath; }
  62
  63     /** Returns full path for user progress save */
  64     static inline std::string getUserSavePath()
  65     { return getUserDataPath() + "/users"; }
  66
  67 private:
  68     static const char* getHomeDirectory();
  69     static std::string getGenericDirectory(const char* ENVVAR, const std::string& fallback);
  70     static bool makeDirectory(const std::string& path);
  71 };
  72
  73 #endif /* _FOLDERS_H_ */