Cleanup in content_mapblock (#5746)
[oweals/minetest.git] / src / mods.h
index e85ec2f4c85f4dc5f5c22a64904f1c6d35eb3538..1e62db54d41ceda2b3849eac5935448924f1ff42 100644 (file)
@@ -1,18 +1,18 @@
 /*
-Minetest-c55
-Copyright (C) 2011 celeron55, Perttu Ahola <celeron55@gmail.com>
+Minetest
+Copyright (C) 2013 celeron55, Perttu Ahola <celeron55@gmail.com>
 
 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; either version 2 of the License, or
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation; either version 2.1 of the License, or
 (at your option) any later version.
 
 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.
+GNU Lesser General Public License for more details.
 
-You should have received a copy of the GNU General Public License along
+You should have received a copy of the GNU Lesser General Public License along
 with this program; if not, write to the Free Software Foundation, Inc.,
 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */
@@ -21,46 +21,219 @@ with this program; if not, write to the Free Software Foundation, Inc.,
 #define MODS_HEADER
 
 #include "irrlichttypes.h"
+#include <list>
 #include <set>
+#include <vector>
 #include <string>
-#include <exception>
+#include <map>
+#include <json/json.h>
+#include "util/cpp11_container.h"
+#include "config.h"
+#include "metadata.h"
 
-class ModError : public std::exception
+#define MODNAME_ALLOWED_CHARS "abcdefghijklmnopqrstuvwxyz0123456789_"
+
+struct ModSpec
+{
+       std::string name;
+       std::string path;
+       //if normal mod:
+       UNORDERED_SET<std::string> depends;
+       UNORDERED_SET<std::string> optdepends;
+       UNORDERED_SET<std::string> unsatisfied_depends;
+
+       bool part_of_modpack;
+       bool is_modpack;
+       // if modpack:
+       std::map<std::string,ModSpec> modpack_content;
+       ModSpec(const std::string &name_="", const std::string &path_=""):
+               name(name_),
+               path(path_),
+               depends(),
+               optdepends(),
+               unsatisfied_depends(),
+               part_of_modpack(false),
+               is_modpack(false),
+               modpack_content()
+       {}
+};
+
+// Retrieves depends, optdepends, is_modpack and modpack_content
+void parseModContents(ModSpec &mod);
+
+std::map<std::string,ModSpec> getModsInPath(std::string path, bool part_of_modpack = false);
+
+// replaces modpack Modspecs with their content
+std::vector<ModSpec> flattenMods(std::map<std::string,ModSpec> mods);
+
+// a ModConfiguration is a subset of installed mods, expected to have
+// all dependencies fullfilled, so it can be used as a list of mods to
+// load when the game starts.
+class ModConfiguration
 {
 public:
-       ModError(const std::string &s)
+       // checks if all dependencies are fullfilled.
+       bool isConsistent() const
        {
-               m_s = "ModError: ";
-               m_s += s;
+               return m_unsatisfied_mods.empty();
        }
-       virtual ~ModError() throw()
-       {}
-       virtual const char * what() const throw()
+
+       std::vector<ModSpec> getMods()
        {
-               return m_s.c_str();
+               return m_sorted_mods;
        }
-       std::string m_s;
+
+       const std::vector<ModSpec> &getUnsatisfiedMods() const
+       {
+               return m_unsatisfied_mods;
+       }
+
+       void printUnsatisfiedModsError() const;
+
+protected:
+       ModConfiguration(const std::string &worldpath);
+       // adds all mods in the given path. used for games, modpacks
+       // and world-specific mods (worldmods-folders)
+       void addModsInPath(const std::string &path);
+
+       // adds all mods in the set.
+       void addMods(const std::vector<ModSpec> &new_mods);
+
+       void checkConflictsAndDeps();
+private:
+       // move mods from m_unsatisfied_mods to m_sorted_mods
+       // in an order that satisfies dependencies
+       void resolveDependencies();
+
+       // mods with unmet dependencies. Before dependencies are resolved,
+       // this is where all mods are stored. Afterwards this contains
+       // only the ones with really unsatisfied dependencies.
+       std::vector<ModSpec> m_unsatisfied_mods;
+
+       // list of mods sorted such that they can be loaded in the
+       // given order with all dependencies being fullfilled. I.e.,
+       // every mod in this list has only dependencies on mods which
+       // appear earlier in the vector.
+       std::vector<ModSpec> m_sorted_mods;
+
+       // set of mod names for which an unresolved name conflict
+       // exists. A name conflict happens when two or more mods
+       // at the same level have the same name but different paths.
+       // Levels (mods in higher levels override mods in lower levels):
+       // 1. game mod in modpack; 2. game mod;
+       // 3. world mod in modpack; 4. world mod;
+       // 5. addon mod in modpack; 6. addon mod.
+       UNORDERED_SET<std::string> m_name_conflicts;
+
+       // Deleted default constructor
+       ModConfiguration() {}
+
 };
 
-struct ModSpec
+class ServerModConfiguration: public ModConfiguration
 {
-       std::string name;
-       std::string path;
-       std::set<std::string> depends;
-       std::set<std::string> unsatisfied_depends;
+public:
+       ServerModConfiguration(const std::string &worldpath);
 
-       ModSpec(const std::string &name_="", const std::string path_="",
-                       const std::set<std::string> &depends_=std::set<std::string>()):
-               name(name_),
-               path(path_),
-               depends(depends_),
-               unsatisfied_depends(depends_)
-       {}
 };
 
-// Get a dependency-sorted list of ModSpecs
-core::list<ModSpec> getMods(core::list<std::string> &modspaths)
-               throw(ModError);
+#ifndef SERVER
+class ClientModConfiguration: public ModConfiguration
+{
+public:
+       ClientModConfiguration(const std::string &path);
+};
+#endif
 
+#if USE_CURL
+Json::Value getModstoreUrl(const std::string &url);
+#else
+inline Json::Value getModstoreUrl(const std::string &url)
+{
+       return Json::Value();
+}
 #endif
 
+struct ModLicenseInfo {
+       int id;
+       std::string shortinfo;
+       std::string url;
+};
+
+struct ModAuthorInfo {
+       int id;
+       std::string username;
+};
+
+struct ModStoreMod {
+       int id;
+       std::string title;
+       std::string basename;
+       ModAuthorInfo author;
+       float rating;
+       bool valid;
+};
+
+struct ModStoreCategoryInfo {
+       int id;
+       std::string name;
+};
+
+struct ModStoreVersionEntry {
+       int id;
+       std::string date;
+       std::string file;
+       bool approved;
+       //ugly version number
+       int mtversion;
+};
+
+struct ModStoreTitlePic {
+       int id;
+       std::string file;
+       std::string description;
+       int mod;
+};
+
+struct ModStoreModDetails {
+       /* version_set?? */
+       std::vector<ModStoreCategoryInfo> categories;
+       ModAuthorInfo author;
+       ModLicenseInfo license;
+       ModStoreTitlePic titlepic;
+       int id;
+       std::string title;
+       std::string basename;
+       std::string description;
+       std::string repository;
+       float rating;
+       std::vector<std::string> depends;
+       std::vector<std::string> softdeps;
+
+       std::string download_url;
+       std::string screenshot_url;
+       std::vector<ModStoreVersionEntry> versions;
+       bool valid;
+};
+
+class ModMetadata: public Metadata
+{
+public:
+       ModMetadata(const std::string &mod_name);
+       ~ModMetadata() {}
+
+       virtual void clear();
+
+       bool save(const std::string &root_path);
+       bool load(const std::string &root_path);
+
+       bool isModified() const { return m_modified; }
+       const std::string &getModName() const { return m_mod_name; }
+
+       virtual bool setString(const std::string &name, const std::string &var);
+private:
+       std::string m_mod_name;
+       bool m_modified;
+};
+
+#endif