diff options
author | Rémi Verschelde <rverschelde@gmail.com> | 2020-03-24 09:54:49 +0100 |
---|---|---|
committer | Rémi Verschelde <rverschelde@gmail.com> | 2020-03-24 09:56:04 +0100 |
commit | cfd84625f0dbd5590e94ecf851bd7b7db5c7665b (patch) | |
tree | 319f6234471eabfec2c7ea62e22763a8a535c53d /editor/doc | |
parent | 9d245415971a83d7989fc57fa176868aad728841 (diff) |
Move DocData and Collada out of their subfolders
Now that the unused DocDump was removed, the `editor/doc` subfolder is
redundant.
Similarly, there's no reason for Collada to have a subfolder for itself
when glTF or OBJ don't.
Diffstat (limited to 'editor/doc')
-rw-r--r-- | editor/doc/SCsub | 5 | ||||
-rw-r--r-- | editor/doc/doc_data.cpp | 1217 | ||||
-rw-r--r-- | editor/doc/doc_data.h | 117 |
3 files changed, 0 insertions, 1339 deletions
diff --git a/editor/doc/SCsub b/editor/doc/SCsub deleted file mode 100644 index 2b1e889fb0..0000000000 --- a/editor/doc/SCsub +++ /dev/null @@ -1,5 +0,0 @@ -#!/usr/bin/env python - -Import('env') - -env.add_source_files(env.editor_sources, "*.cpp") diff --git a/editor/doc/doc_data.cpp b/editor/doc/doc_data.cpp deleted file mode 100644 index 66134b4428..0000000000 --- a/editor/doc/doc_data.cpp +++ /dev/null @@ -1,1217 +0,0 @@ -/*************************************************************************/ -/* doc_data.cpp */ -/*************************************************************************/ -/* This file is part of: */ -/* GODOT ENGINE */ -/* https://godotengine.org */ -/*************************************************************************/ -/* Copyright (c) 2007-2020 Juan Linietsky, Ariel Manzur. */ -/* Copyright (c) 2014-2020 Godot Engine contributors (cf. AUTHORS.md). */ -/* */ -/* Permission is hereby granted, free of charge, to any person obtaining */ -/* a copy of this software and associated documentation files (the */ -/* "Software"), to deal in the Software without restriction, including */ -/* without limitation the rights to use, copy, modify, merge, publish, */ -/* distribute, sublicense, and/or sell copies of the Software, and to */ -/* permit persons to whom the Software is furnished to do so, subject to */ -/* the following conditions: */ -/* */ -/* The above copyright notice and this permission notice shall be */ -/* included in all copies or substantial portions of the Software. */ -/* */ -/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */ -/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */ -/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/ -/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */ -/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */ -/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */ -/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ -/*************************************************************************/ - -#include "doc_data.h" - -#include "core/engine.h" -#include "core/global_constants.h" -#include "core/io/compression.h" -#include "core/io/marshalls.h" -#include "core/os/dir_access.h" -#include "core/project_settings.h" -#include "core/script_language.h" -#include "core/version.h" -#include "scene/resources/theme.h" - -void DocData::merge_from(const DocData &p_data) { - - for (Map<String, ClassDoc>::Element *E = class_list.front(); E; E = E->next()) { - - ClassDoc &c = E->get(); - - if (!p_data.class_list.has(c.name)) - continue; - - const ClassDoc &cf = p_data.class_list[c.name]; - - c.description = cf.description; - c.brief_description = cf.brief_description; - c.tutorials = cf.tutorials; - - for (int i = 0; i < c.methods.size(); i++) { - - MethodDoc &m = c.methods.write[i]; - - for (int j = 0; j < cf.methods.size(); j++) { - - if (cf.methods[j].name != m.name) - continue; - if (cf.methods[j].arguments.size() != m.arguments.size()) - continue; - // since polymorphic functions are allowed we need to check the type of - // the arguments so we make sure they are different. - int arg_count = cf.methods[j].arguments.size(); - Vector<bool> arg_used; - arg_used.resize(arg_count); - for (int l = 0; l < arg_count; ++l) - arg_used.write[l] = false; - // also there is no guarantee that argument ordering will match, so we - // have to check one by one so we make sure we have an exact match - for (int k = 0; k < arg_count; ++k) { - for (int l = 0; l < arg_count; ++l) - if (cf.methods[j].arguments[k].type == m.arguments[l].type && !arg_used[l]) { - arg_used.write[l] = true; - break; - } - } - bool not_the_same = false; - for (int l = 0; l < arg_count; ++l) - if (!arg_used[l]) // at least one of the arguments was different - not_the_same = true; - if (not_the_same) - continue; - - const MethodDoc &mf = cf.methods[j]; - - m.description = mf.description; - break; - } - } - - for (int i = 0; i < c.signals.size(); i++) { - - MethodDoc &m = c.signals.write[i]; - - for (int j = 0; j < cf.signals.size(); j++) { - - if (cf.signals[j].name != m.name) - continue; - const MethodDoc &mf = cf.signals[j]; - - m.description = mf.description; - break; - } - } - - for (int i = 0; i < c.constants.size(); i++) { - - ConstantDoc &m = c.constants.write[i]; - - for (int j = 0; j < cf.constants.size(); j++) { - - if (cf.constants[j].name != m.name) - continue; - const ConstantDoc &mf = cf.constants[j]; - - m.description = mf.description; - break; - } - } - - for (int i = 0; i < c.properties.size(); i++) { - - PropertyDoc &p = c.properties.write[i]; - - for (int j = 0; j < cf.properties.size(); j++) { - - if (cf.properties[j].name != p.name) - continue; - const PropertyDoc &pf = cf.properties[j]; - - p.description = pf.description; - break; - } - } - - for (int i = 0; i < c.theme_properties.size(); i++) { - - PropertyDoc &p = c.theme_properties.write[i]; - - for (int j = 0; j < cf.theme_properties.size(); j++) { - - if (cf.theme_properties[j].name != p.name) - continue; - const PropertyDoc &pf = cf.theme_properties[j]; - - p.description = pf.description; - break; - } - } - } -} - -void DocData::remove_from(const DocData &p_data) { - for (Map<String, ClassDoc>::Element *E = p_data.class_list.front(); E; E = E->next()) { - if (class_list.has(E->key())) - class_list.erase(E->key()); - } -} - -static void return_doc_from_retinfo(DocData::MethodDoc &p_method, const PropertyInfo &p_retinfo) { - - if (p_retinfo.type == Variant::INT && p_retinfo.usage & PROPERTY_USAGE_CLASS_IS_ENUM) { - p_method.return_enum = p_retinfo.class_name; - if (p_method.return_enum.begins_with("_")) //proxy class - p_method.return_enum = p_method.return_enum.substr(1, p_method.return_enum.length()); - p_method.return_type = "int"; - } else if (p_retinfo.class_name != StringName()) { - p_method.return_type = p_retinfo.class_name; - } else if (p_retinfo.hint == PROPERTY_HINT_RESOURCE_TYPE) { - p_method.return_type = p_retinfo.hint_string; - } else if (p_retinfo.type == Variant::NIL && p_retinfo.usage & PROPERTY_USAGE_NIL_IS_VARIANT) { - p_method.return_type = "Variant"; - } else if (p_retinfo.type == Variant::NIL) { - p_method.return_type = "void"; - } else { - p_method.return_type = Variant::get_type_name(p_retinfo.type); - } -} - -static void argument_doc_from_arginfo(DocData::ArgumentDoc &p_argument, const PropertyInfo &p_arginfo) { - - p_argument.name = p_arginfo.name; - - if (p_arginfo.type == Variant::INT && p_arginfo.usage & PROPERTY_USAGE_CLASS_IS_ENUM) { - p_argument.enumeration = p_arginfo.class_name; - if (p_argument.enumeration.begins_with("_")) //proxy class - p_argument.enumeration = p_argument.enumeration.substr(1, p_argument.enumeration.length()); - p_argument.type = "int"; - } else if (p_arginfo.class_name != StringName()) { - p_argument.type = p_arginfo.class_name; - } else if (p_arginfo.hint == PROPERTY_HINT_RESOURCE_TYPE) { - p_argument.type = p_arginfo.hint_string; - } else if (p_arginfo.type == Variant::NIL) { - // Parameters cannot be void, so PROPERTY_USAGE_NIL_IS_VARIANT is not necessary - p_argument.type = "Variant"; - } else { - p_argument.type = Variant::get_type_name(p_arginfo.type); - } -} - -static Variant get_documentation_default_value(const StringName &p_class_name, const StringName &p_property_name, bool &r_default_value_valid) { - - Variant default_value = Variant(); - r_default_value_valid = false; - - if (ClassDB::can_instance(p_class_name)) { - default_value = ClassDB::class_get_default_property_value(p_class_name, p_property_name, &r_default_value_valid); - } else { - // Cannot get default value of classes that can't be instanced - List<StringName> inheriting_classes; - ClassDB::get_direct_inheriters_from_class(p_class_name, &inheriting_classes); - for (List<StringName>::Element *E2 = inheriting_classes.front(); E2; E2 = E2->next()) { - if (ClassDB::can_instance(E2->get())) { - default_value = ClassDB::class_get_default_property_value(E2->get(), p_property_name, &r_default_value_valid); - if (r_default_value_valid) - break; - } - } - } - - return default_value; -} - -void DocData::generate(bool p_basic_types) { - - List<StringName> classes; - ClassDB::get_class_list(&classes); - classes.sort_custom<StringName::AlphCompare>(); - // Move ProjectSettings, so that other classes can register properties there. - classes.move_to_back(classes.find("ProjectSettings")); - - bool skip_setter_getter_methods = true; - - while (classes.size()) { - - Set<StringName> setters_getters; - - String name = classes.front()->get(); - String cname = name; - if (cname.begins_with("_")) //proxy class - cname = cname.substr(1, name.length()); - - class_list[cname] = ClassDoc(); - ClassDoc &c = class_list[cname]; - c.name = cname; - c.inherits = ClassDB::get_parent_class(name); - - List<PropertyInfo> properties; - List<PropertyInfo> own_properties; - if (name == "ProjectSettings") { - //special case for project settings, so settings can be documented - ProjectSettings::get_singleton()->get_property_list(&properties); - own_properties = properties; - } else { - ClassDB::get_property_list(name, &properties); - ClassDB::get_property_list(name, &own_properties, true); - } - - List<PropertyInfo>::Element *EO = own_properties.front(); - for (List<PropertyInfo>::Element *E = properties.front(); E; E = E->next()) { - bool inherited = EO == NULL; - if (EO && EO->get() == E->get()) { - inherited = false; - EO = EO->next(); - } - - if (E->get().usage & PROPERTY_USAGE_GROUP || E->get().usage & PROPERTY_USAGE_CATEGORY || E->get().usage & PROPERTY_USAGE_INTERNAL) - continue; - - PropertyDoc prop; - - prop.name = E->get().name; - - prop.overridden = inherited; - - bool default_value_valid = false; - Variant default_value; - - if (name == "ProjectSettings") { - // Special case for project settings, so that settings are not taken from the current project's settings - if (E->get().name == "script" || - ProjectSettings::get_singleton()->get_order(E->get().name) >= ProjectSettings::NO_BUILTIN_ORDER_BASE) { - continue; - } - if (E->get().usage & PROPERTY_USAGE_EDITOR) { - default_value = ProjectSettings::get_singleton()->property_get_revert(E->get().name); - default_value_valid = true; - } - } else { - default_value = get_documentation_default_value(name, E->get().name, default_value_valid); - - if (inherited) { - bool base_default_value_valid = false; - Variant base_default_value = get_documentation_default_value(ClassDB::get_parent_class(name), E->get().name, base_default_value_valid); - if (!default_value_valid || !base_default_value_valid || default_value == base_default_value) - continue; - } - } - - //used to track uninitialized values using valgrind - //print_line("getting default value for " + String(name) + "." + String(E->get().name)); - if (default_value_valid && default_value.get_type() != Variant::OBJECT) { - prop.default_value = default_value.get_construct_string().replace("\n", ""); - } - - StringName setter = ClassDB::get_property_setter(name, E->get().name); - StringName getter = ClassDB::get_property_getter(name, E->get().name); - - prop.setter = setter; - prop.getter = getter; - - bool found_type = false; - if (getter != StringName()) { - MethodBind *mb = ClassDB::get_method(name, getter); - if (mb) { - PropertyInfo retinfo = mb->get_return_info(); - - found_type = true; - if (retinfo.type == Variant::INT && retinfo.usage & PROPERTY_USAGE_CLASS_IS_ENUM) { - prop.enumeration = retinfo.class_name; - prop.type = "int"; - } else if (retinfo.class_name != StringName()) { - prop.type = retinfo.class_name; - } else if (retinfo.hint == PROPERTY_HINT_RESOURCE_TYPE) { - - prop.type = retinfo.hint_string; - } else if (retinfo.type == Variant::NIL && retinfo.usage & PROPERTY_USAGE_NIL_IS_VARIANT) { - - prop.type = "Variant"; - } else if (retinfo.type == Variant::NIL) { - prop.type = "void"; - } else { - prop.type = Variant::get_type_name(retinfo.type); - } - } - - setters_getters.insert(getter); - } - - if (setter != StringName()) { - - setters_getters.insert(setter); - } - - if (!found_type) { - - if (E->get().type == Variant::OBJECT && E->get().hint == PROPERTY_HINT_RESOURCE_TYPE) - prop.type = E->get().hint_string; - else - prop.type = Variant::get_type_name(E->get().type); - } - - c.properties.push_back(prop); - } - - List<MethodInfo> method_list; - ClassDB::get_method_list(name, &method_list, true); - method_list.sort(); - - for (List<MethodInfo>::Element *E = method_list.front(); E; E = E->next()) { - - if (E->get().name == "" || (E->get().name[0] == '_' && !(E->get().flags & METHOD_FLAG_VIRTUAL))) - continue; //hidden, don't count - - if (skip_setter_getter_methods && setters_getters.has(E->get().name)) { - // Don't skip parametric setters and getters, i.e. method which require - // one or more parameters to define what property should be set or retrieved. - // E.g. CPUParticles::set_param(Parameter param, float value). - if (E->get().arguments.size() == 0 /* getter */ || (E->get().arguments.size() == 1 && E->get().return_val.type == Variant::NIL /* setter */)) { - continue; - } - } - - MethodDoc method; - - method.name = E->get().name; - - if (E->get().flags & METHOD_FLAG_VIRTUAL) - method.qualifiers = "virtual"; - - if (E->get().flags & METHOD_FLAG_CONST) { - if (method.qualifiers != "") - method.qualifiers += " "; - method.qualifiers += "const"; - } else if (E->get().flags & METHOD_FLAG_VARARG) { - if (method.qualifiers != "") - method.qualifiers += " "; - method.qualifiers += "vararg"; - } - - for (int i = -1; i < E->get().arguments.size(); i++) { - - if (i == -1) { -#ifdef DEBUG_METHODS_ENABLED - return_doc_from_retinfo(method, E->get().return_val); -#endif - } else { - - const PropertyInfo &arginfo = E->get().arguments[i]; - ArgumentDoc argument; - argument_doc_from_arginfo(argument, arginfo); - - int darg_idx = i - (E->get().arguments.size() - E->get().default_arguments.size()); - if (darg_idx >= 0) { - Variant default_arg = E->get().default_arguments[darg_idx]; - argument.default_value = default_arg.get_construct_string(); - } - - method.arguments.push_back(argument); - } - } - - c.methods.push_back(method); - } - - List<MethodInfo> signal_list; - ClassDB::get_signal_list(name, &signal_list, true); - - if (signal_list.size()) { - - for (List<MethodInfo>::Element *EV = signal_list.front(); EV; EV = EV->next()) { - - MethodDoc signal; - signal.name = EV->get().name; - for (int i = 0; i < EV->get().arguments.size(); i++) { - - const PropertyInfo &arginfo = EV->get().arguments[i]; - ArgumentDoc argument; - argument_doc_from_arginfo(argument, arginfo); - - signal.arguments.push_back(argument); - } - - c.signals.push_back(signal); - } - } - - List<String> constant_list; - ClassDB::get_integer_constant_list(name, &constant_list, true); - - for (List<String>::Element *E = constant_list.front(); E; E = E->next()) { - - ConstantDoc constant; - constant.name = E->get(); - constant.value = itos(ClassDB::get_integer_constant(name, E->get())); - constant.enumeration = ClassDB::get_integer_constant_enum(name, E->get()); - c.constants.push_back(constant); - } - - //theme stuff - - { - List<StringName> l; - Theme::get_default()->get_constant_list(cname, &l); - for (List<StringName>::Element *E = l.front(); E; E = E->next()) { - - PropertyDoc pd; - pd.name = E->get(); - pd.type = "int"; - pd.default_value = itos(Theme::get_default()->get_constant(E->get(), cname)); - c.theme_properties.push_back(pd); - } - - l.clear(); - Theme::get_default()->get_color_list(cname, &l); - for (List<StringName>::Element *E = l.front(); E; E = E->next()) { - - PropertyDoc pd; - pd.name = E->get(); - pd.type = "Color"; - pd.default_value = Variant(Theme::get_default()->get_color(E->get(), cname)).get_construct_string(); - c.theme_properties.push_back(pd); - } - - l.clear(); - Theme::get_default()->get_icon_list(cname, &l); - for (List<StringName>::Element *E = l.front(); E; E = E->next()) { - - PropertyDoc pd; - pd.name = E->get(); - pd.type = "Texture2D"; - c.theme_properties.push_back(pd); - } - l.clear(); - Theme::get_default()->get_font_list(cname, &l); - for (List<StringName>::Element *E = l.front(); E; E = E->next()) { - - PropertyDoc pd; - pd.name = E->get(); - pd.type = "Font"; - c.theme_properties.push_back(pd); - } - l.clear(); - Theme::get_default()->get_stylebox_list(cname, &l); - for (List<StringName>::Element *E = l.front(); E; E = E->next()) { - - PropertyDoc pd; - pd.name = E->get(); - pd.type = "StyleBox"; - c.theme_properties.push_back(pd); - } - } - - classes.pop_front(); - } - - { - // So we can document the concept of Variant even if it's not a usable class per se. - class_list["Variant"] = ClassDoc(); - class_list["Variant"].name = "Variant"; - } - - if (!p_basic_types) - return; - - // Add Variant types. - for (int i = 0; i < Variant::VARIANT_MAX; i++) { - if (i == Variant::NIL) - continue; // Not exposed outside of 'null', should not be in class list. - if (i == Variant::OBJECT) - continue; // Use the core type instead. - - String cname = Variant::get_type_name(Variant::Type(i)); - - class_list[cname] = ClassDoc(); - ClassDoc &c = class_list[cname]; - c.name = cname; - - Callable::CallError cerror; - Variant v = Variant::construct(Variant::Type(i), NULL, 0, cerror); - - List<MethodInfo> method_list; - v.get_method_list(&method_list); - method_list.sort(); - Variant::get_constructor_list(Variant::Type(i), &method_list); - - for (List<MethodInfo>::Element *E = method_list.front(); E; E = E->next()) { - - MethodInfo &mi = E->get(); - MethodDoc method; - - method.name = mi.name; - - for (int j = 0; j < mi.arguments.size(); j++) { - - PropertyInfo arginfo = mi.arguments[j]; - ArgumentDoc ad; - argument_doc_from_arginfo(ad, mi.arguments[j]); - ad.name = arginfo.name; - - int darg_idx = mi.default_arguments.size() - mi.arguments.size() + j; - if (darg_idx >= 0) { - Variant default_arg = mi.default_arguments[darg_idx]; - ad.default_value = default_arg.get_construct_string(); - } - - method.arguments.push_back(ad); - } - - return_doc_from_retinfo(method, mi.return_val); - - if (mi.flags & METHOD_FLAG_VARARG) { - if (method.qualifiers != "") - method.qualifiers += " "; - method.qualifiers += "vararg"; - } - - c.methods.push_back(method); - } - - List<PropertyInfo> properties; - v.get_property_list(&properties); - for (List<PropertyInfo>::Element *E = properties.front(); E; E = E->next()) { - - PropertyInfo pi = E->get(); - PropertyDoc property; - property.name = pi.name; - property.type = Variant::get_type_name(pi.type); - property.default_value = v.get(pi.name).get_construct_string(); - - c.properties.push_back(property); - } - - List<StringName> constants; - Variant::get_constants_for_type(Variant::Type(i), &constants); - - for (List<StringName>::Element *E = constants.front(); E; E = E->next()) { - - ConstantDoc constant; - constant.name = E->get(); - Variant value = Variant::get_constant_value(Variant::Type(i), E->get()); - constant.value = value.get_type() == Variant::INT ? itos(value) : value.get_construct_string(); - c.constants.push_back(constant); - } - } - - //built in constants and functions - - { - - String cname = "@GlobalScope"; - class_list[cname] = ClassDoc(); - ClassDoc &c = class_list[cname]; - c.name = cname; - - for (int i = 0; i < GlobalConstants::get_global_constant_count(); i++) { - - ConstantDoc cd; - cd.name = GlobalConstants::get_global_constant_name(i); - cd.value = itos(GlobalConstants::get_global_constant_value(i)); - cd.enumeration = GlobalConstants::get_global_constant_enum(i); - c.constants.push_back(cd); - } - - List<Engine::Singleton> singletons; - Engine::get_singleton()->get_singletons(&singletons); - - //servers (this is kind of hackish) - for (List<Engine::Singleton>::Element *E = singletons.front(); E; E = E->next()) { - - PropertyDoc pd; - Engine::Singleton &s = E->get(); - if (!s.ptr) { - continue; - } - pd.name = s.name; - pd.type = s.ptr->get_class(); - while (String(ClassDB::get_parent_class(pd.type)) != "Object") - pd.type = ClassDB::get_parent_class(pd.type); - if (pd.type.begins_with("_")) - pd.type = pd.type.substr(1, pd.type.length()); - c.properties.push_back(pd); - } - } - - //built in script reference - - { - - for (int i = 0; i < ScriptServer::get_language_count(); i++) { - - ScriptLanguage *lang = ScriptServer::get_language(i); - String cname = "@" + lang->get_name(); - class_list[cname] = ClassDoc(); - ClassDoc &c = class_list[cname]; - c.name = cname; - - List<MethodInfo> minfo; - - lang->get_public_functions(&minfo); - - for (List<MethodInfo>::Element *E = minfo.front(); E; E = E->next()) { - - MethodInfo &mi = E->get(); - MethodDoc md; - md.name = mi.name; - - if (mi.flags & METHOD_FLAG_VARARG) { - if (md.qualifiers != "") - md.qualifiers += " "; - md.qualifiers += "vararg"; - } - - return_doc_from_retinfo(md, mi.return_val); - - for (int j = 0; j < mi.arguments.size(); j++) { - - ArgumentDoc ad; - argument_doc_from_arginfo(ad, mi.arguments[j]); - - int darg_idx = j - (mi.arguments.size() - mi.default_arguments.size()); - if (darg_idx >= 0) { - Variant default_arg = E->get().default_arguments[darg_idx]; - ad.default_value = default_arg.get_construct_string(); - } - - md.arguments.push_back(ad); - } - - c.methods.push_back(md); - } - - List<Pair<String, Variant>> cinfo; - lang->get_public_constants(&cinfo); - - for (List<Pair<String, Variant>>::Element *E = cinfo.front(); E; E = E->next()) { - - ConstantDoc cd; - cd.name = E->get().first; - cd.value = E->get().second; - c.constants.push_back(cd); - } - } - } -} - -static Error _parse_methods(Ref<XMLParser> &parser, Vector<DocData::MethodDoc> &methods) { - - String section = parser->get_node_name(); - String element = section.substr(0, section.length() - 1); - - while (parser->read() == OK) { - - if (parser->get_node_type() == XMLParser::NODE_ELEMENT) { - - if (parser->get_node_name() == element) { - - DocData::MethodDoc method; - ERR_FAIL_COND_V(!parser->has_attribute("name"), ERR_FILE_CORRUPT); - method.name = parser->get_attribute_value("name"); - if (parser->has_attribute("qualifiers")) - method.qualifiers = parser->get_attribute_value("qualifiers"); - - while (parser->read() == OK) { - - if (parser->get_node_type() == XMLParser::NODE_ELEMENT) { - - String name = parser->get_node_name(); - if (name == "return") { - - ERR_FAIL_COND_V(!parser->has_attribute("type"), ERR_FILE_CORRUPT); - method.return_type = parser->get_attribute_value("type"); - if (parser->has_attribute("enum")) { - method.return_enum = parser->get_attribute_value("enum"); - } - } else if (name == "argument") { - - DocData::ArgumentDoc argument; - ERR_FAIL_COND_V(!parser->has_attribute("name"), ERR_FILE_CORRUPT); - argument.name = parser->get_attribute_value("name"); - ERR_FAIL_COND_V(!parser->has_attribute("type"), ERR_FILE_CORRUPT); - argument.type = parser->get_attribute_value("type"); - if (parser->has_attribute("enum")) { - argument.enumeration = parser->get_attribute_value("enum"); - } - - method.arguments.push_back(argument); - - } else if (name == "description") { - - parser->read(); - if (parser->get_node_type() == XMLParser::NODE_TEXT) - method.description = parser->get_node_data(); - } - - } else if (parser->get_node_type() == XMLParser::NODE_ELEMENT_END && parser->get_node_name() == element) - break; - } - - methods.push_back(method); - - } else { - ERR_FAIL_V_MSG(ERR_FILE_CORRUPT, "Invalid tag in doc file: " + parser->get_node_name() + "."); - } - - } else if (parser->get_node_type() == XMLParser::NODE_ELEMENT_END && parser->get_node_name() == section) - break; - } - - return OK; -} - -Error DocData::load_classes(const String &p_dir) { - - Error err; - DirAccessRef da = DirAccess::open(p_dir, &err); - if (!da) { - return err; - } - - da->list_dir_begin(); - String path; - path = da->get_next(); - while (path != String()) { - if (!da->current_is_dir() && path.ends_with("xml")) { - Ref<XMLParser> parser = memnew(XMLParser); - Error err2 = parser->open(p_dir.plus_file(path)); - if (err2) - return err2; - - _load(parser); - } - path = da->get_next(); - } - - da->list_dir_end(); - - return OK; -} -Error DocData::erase_classes(const String &p_dir) { - - Error err; - DirAccessRef da = DirAccess::open(p_dir, &err); - if (!da) { - return err; - } - - List<String> to_erase; - - da->list_dir_begin(); - String path; - path = da->get_next(); - while (path != String()) { - if (!da->current_is_dir() && path.ends_with("xml")) { - to_erase.push_back(path); - } - path = da->get_next(); - } - da->list_dir_end(); - - while (to_erase.size()) { - da->remove(to_erase.front()->get()); - to_erase.pop_front(); - } - - return OK; -} -Error DocData::_load(Ref<XMLParser> parser) { - - Error err = OK; - - while ((err = parser->read()) == OK) { - - if (parser->get_node_type() == XMLParser::NODE_ELEMENT && parser->get_node_name() == "?xml") { - parser->skip_section(); - } - - if (parser->get_node_type() != XMLParser::NODE_ELEMENT) - continue; //no idea what this may be, but skipping anyway - - ERR_FAIL_COND_V(parser->get_node_name() != "class", ERR_FILE_CORRUPT); - - ERR_FAIL_COND_V(!parser->has_attribute("name"), ERR_FILE_CORRUPT); - String name = parser->get_attribute_value("name"); - class_list[name] = ClassDoc(); - ClassDoc &c = class_list[name]; - - c.name = name; - if (parser->has_attribute("inherits")) - c.inherits = parser->get_attribute_value("inherits"); - - while (parser->read() == OK) { - - if (parser->get_node_type() == XMLParser::NODE_ELEMENT) { - - String name2 = parser->get_node_name(); - - if (name2 == "brief_description") { - - parser->read(); - if (parser->get_node_type() == XMLParser::NODE_TEXT) - c.brief_description = parser->get_node_data(); - - } else if (name2 == "description") { - parser->read(); - if (parser->get_node_type() == XMLParser::NODE_TEXT) - c.description = parser->get_node_data(); - } else if (name2 == "tutorials") { - while (parser->read() == OK) { - - if (parser->get_node_type() == XMLParser::NODE_ELEMENT) { - - String name3 = parser->get_node_name(); - - if (name3 == "link") { - - parser->read(); - if (parser->get_node_type() == XMLParser::NODE_TEXT) - c.tutorials.push_back(parser->get_node_data().strip_edges()); - } else { - ERR_FAIL_V_MSG(ERR_FILE_CORRUPT, "Invalid tag in doc file: " + name3 + "."); - } - } else if (parser->get_node_type() == XMLParser::NODE_ELEMENT_END && parser->get_node_name() == "tutorials") - break; // End of <tutorials>. - } - } else if (name2 == "methods") { - - Error err2 = _parse_methods(parser, c.methods); - ERR_FAIL_COND_V(err2, err2); - - } else if (name2 == "signals") { - - Error err2 = _parse_methods(parser, c.signals); - ERR_FAIL_COND_V(err2, err2); - } else if (name2 == "members") { - - while (parser->read() == OK) { - - if (parser->get_node_type() == XMLParser::NODE_ELEMENT) { - - String name3 = parser->get_node_name(); - - if (name3 == "member") { - - PropertyDoc prop2; - - ERR_FAIL_COND_V(!parser->has_attribute("name"), ERR_FILE_CORRUPT); - prop2.name = parser->get_attribute_value("name"); - ERR_FAIL_COND_V(!parser->has_attribute("type"), ERR_FILE_CORRUPT); - prop2.type = parser->get_attribute_value("type"); - if (parser->has_attribute("setter")) - prop2.setter = parser->get_attribute_value("setter"); - if (parser->has_attribute("getter")) - prop2.getter = parser->get_attribute_value("getter"); - if (parser->has_attribute("enum")) - prop2.enumeration = parser->get_attribute_value("enum"); - if (!parser->is_empty()) { - parser->read(); - if (parser->get_node_type() == XMLParser::NODE_TEXT) - prop2.description = parser->get_node_data(); - } - c.properties.push_back(prop2); - } else { - ERR_FAIL_V_MSG(ERR_FILE_CORRUPT, "Invalid tag in doc file: " + name3 + "."); - } - - } else if (parser->get_node_type() == XMLParser::NODE_ELEMENT_END && parser->get_node_name() == "members") - break; // End of <members>. - } - - } else if (name2 == "theme_items") { - - while (parser->read() == OK) { - - if (parser->get_node_type() == XMLParser::NODE_ELEMENT) { - - String name3 = parser->get_node_name(); - - if (name3 == "theme_item") { - - PropertyDoc prop2; - - ERR_FAIL_COND_V(!parser->has_attribute("name"), ERR_FILE_CORRUPT); - prop2.name = parser->get_attribute_value("name"); - ERR_FAIL_COND_V(!parser->has_attribute("type"), ERR_FILE_CORRUPT); - prop2.type = parser->get_attribute_value("type"); - if (!parser->is_empty()) { - parser->read(); - if (parser->get_node_type() == XMLParser::NODE_TEXT) - prop2.description = parser->get_node_data(); - } - c.theme_properties.push_back(prop2); - } else { - ERR_FAIL_V_MSG(ERR_FILE_CORRUPT, "Invalid tag in doc file: " + name3 + "."); - } - - } else if (parser->get_node_type() == XMLParser::NODE_ELEMENT_END && parser->get_node_name() == "theme_items") - break; // End of <theme_items>. - } - - } else if (name2 == "constants") { - - while (parser->read() == OK) { - - if (parser->get_node_type() == XMLParser::NODE_ELEMENT) { - - String name3 = parser->get_node_name(); - - if (name3 == "constant") { - - ConstantDoc constant2; - ERR_FAIL_COND_V(!parser->has_attribute("name"), ERR_FILE_CORRUPT); - constant2.name = parser->get_attribute_value("name"); - ERR_FAIL_COND_V(!parser->has_attribute("value"), ERR_FILE_CORRUPT); - constant2.value = parser->get_attribute_value("value"); - if (parser->has_attribute("enum")) { - constant2.enumeration = parser->get_attribute_value("enum"); - } - if (!parser->is_empty()) { - parser->read(); - if (parser->get_node_type() == XMLParser::NODE_TEXT) - constant2.description = parser->get_node_data(); - } - c.constants.push_back(constant2); - } else { - ERR_FAIL_V_MSG(ERR_FILE_CORRUPT, "Invalid tag in doc file: " + name3 + "."); - } - - } else if (parser->get_node_type() == XMLParser::NODE_ELEMENT_END && parser->get_node_name() == "constants") - break; // End of <constants>. - } - - } else { - - ERR_FAIL_V_MSG(ERR_FILE_CORRUPT, "Invalid tag in doc file: " + name2 + "."); - } - - } else if (parser->get_node_type() == XMLParser::NODE_ELEMENT_END && parser->get_node_name() == "class") - break; // End of <class>. - } - } - - return OK; -} - -static void _write_string(FileAccess *f, int p_tablevel, const String &p_string) { - - if (p_string == "") - return; - String tab; - for (int i = 0; i < p_tablevel; i++) - tab += "\t"; - f->store_string(tab + p_string + "\n"); -} - -Error DocData::save_classes(const String &p_default_path, const Map<String, String> &p_class_path) { - - for (Map<String, ClassDoc>::Element *E = class_list.front(); E; E = E->next()) { - - ClassDoc &c = E->get(); - - String save_path; - if (p_class_path.has(c.name)) { - save_path = p_class_path[c.name]; - } else { - save_path = p_default_path; - } - - Error err; - String save_file = save_path.plus_file(c.name + ".xml"); - FileAccessRef f = FileAccess::open(save_file, FileAccess::WRITE, &err); - - ERR_CONTINUE_MSG(err != OK, "Can't write doc file: " + save_file + "."); - - _write_string(f, 0, "<?xml version=\"1.0\" encoding=\"UTF-8\" ?>"); - - String header = "<class name=\"" + c.name + "\""; - if (c.inherits != "") - header += " inherits=\"" + c.inherits + "\""; - header += String(" version=\"") + VERSION_BRANCH + "\""; - header += ">"; - _write_string(f, 0, header); - - _write_string(f, 1, "<brief_description>"); - _write_string(f, 2, c.brief_description.strip_edges().xml_escape()); - _write_string(f, 1, "</brief_description>"); - - _write_string(f, 1, "<description>"); - _write_string(f, 2, c.description.strip_edges().xml_escape()); - _write_string(f, 1, "</description>"); - - _write_string(f, 1, "<tutorials>"); - for (int i = 0; i < c.tutorials.size(); i++) { - _write_string(f, 2, "<link>" + c.tutorials.get(i).xml_escape() + "</link>"); - } - _write_string(f, 1, "</tutorials>"); - - _write_string(f, 1, "<methods>"); - - c.methods.sort(); - - for (int i = 0; i < c.methods.size(); i++) { - - const MethodDoc &m = c.methods[i]; - - String qualifiers; - if (m.qualifiers != "") - qualifiers += " qualifiers=\"" + m.qualifiers.xml_escape() + "\""; - - _write_string(f, 2, "<method name=\"" + m.name + "\"" + qualifiers + ">"); - - if (m.return_type != "") { - - String enum_text; - if (m.return_enum != String()) { - enum_text = " enum=\"" + m.return_enum + "\""; - } - _write_string(f, 3, "<return type=\"" + m.return_type + "\"" + enum_text + ">"); - _write_string(f, 3, "</return>"); - } - - for (int j = 0; j < m.arguments.size(); j++) { - - const ArgumentDoc &a = m.arguments[j]; - - String enum_text; - if (a.enumeration != String()) { - enum_text = " enum=\"" + a.enumeration + "\""; - } - - if (a.default_value != "") - _write_string(f, 3, "<argument index=\"" + itos(j) + "\" name=\"" + a.name.xml_escape() + "\" type=\"" + a.type.xml_escape() + "\"" + enum_text + " default=\"" + a.default_value.xml_escape(true) + "\">"); - else - _write_string(f, 3, "<argument index=\"" + itos(j) + "\" name=\"" + a.name.xml_escape() + "\" type=\"" + a.type.xml_escape() + "\"" + enum_text + ">"); - - _write_string(f, 3, "</argument>"); - } - - _write_string(f, 3, "<description>"); - _write_string(f, 4, m.description.strip_edges().xml_escape()); - _write_string(f, 3, "</description>"); - - _write_string(f, 2, "</method>"); - } - - _write_string(f, 1, "</methods>"); - - if (c.properties.size()) { - _write_string(f, 1, "<members>"); - - c.properties.sort(); - - for (int i = 0; i < c.properties.size(); i++) { - - String additional_attributes; - if (c.properties[i].enumeration != String()) { - additional_attributes += " enum=\"" + c.properties[i].enumeration + "\""; - } - if (c.properties[i].default_value != String()) { - additional_attributes += " default=\"" + c.properties[i].default_value.xml_escape(true) + "\""; - } - - const PropertyDoc &p = c.properties[i]; - - if (c.properties[i].overridden) { - _write_string(f, 2, "<member name=\"" + p.name + "\" type=\"" + p.type + "\" setter=\"" + p.setter + "\" getter=\"" + p.getter + "\" override=\"true\"" + additional_attributes + " />"); - } else { - _write_string(f, 2, "<member name=\"" + p.name + "\" type=\"" + p.type + "\" setter=\"" + p.setter + "\" getter=\"" + p.getter + "\"" + additional_attributes + ">"); - _write_string(f, 3, p.description.strip_edges().xml_escape()); - _write_string(f, 2, "</member>"); - } - } - _write_string(f, 1, "</members>"); - } - - if (c.signals.size()) { - - c.signals.sort(); - - _write_string(f, 1, "<signals>"); - for (int i = 0; i < c.signals.size(); i++) { - - const MethodDoc &m = c.signals[i]; - _write_string(f, 2, "<signal name=\"" + m.name + "\">"); - for (int j = 0; j < m.arguments.size(); j++) { - - const ArgumentDoc &a = m.arguments[j]; - _write_string(f, 3, "<argument index=\"" + itos(j) + "\" name=\"" + a.name.xml_escape() + "\" type=\"" + a.type.xml_escape() + "\">"); - _write_string(f, 3, "</argument>"); - } - - _write_string(f, 3, "<description>"); - _write_string(f, 4, m.description.strip_edges().xml_escape()); - _write_string(f, 3, "</description>"); - - _write_string(f, 2, "</signal>"); - } - - _write_string(f, 1, "</signals>"); - } - - _write_string(f, 1, "<constants>"); - - for (int i = 0; i < c.constants.size(); i++) { - - const ConstantDoc &k = c.constants[i]; - if (k.enumeration != String()) { - _write_string(f, 2, "<constant name=\"" + k.name + "\" value=\"" + k.value + "\" enum=\"" + k.enumeration + "\">"); - } else { - _write_string(f, 2, "<constant name=\"" + k.name + "\" value=\"" + k.value + "\">"); - } - _write_string(f, 3, k.description.strip_edges().xml_escape()); - _write_string(f, 2, "</constant>"); - } - - _write_string(f, 1, "</constants>"); - - if (c.theme_properties.size()) { - - c.theme_properties.sort(); - - _write_string(f, 1, "<theme_items>"); - for (int i = 0; i < c.theme_properties.size(); i++) { - - const PropertyDoc &p = c.theme_properties[i]; - - if (p.default_value != "") - _write_string(f, 2, "<theme_item name=\"" + p.name + "\" type=\"" + p.type + "\" default=\"" + p.default_value.xml_escape(true) + "\">"); - else - _write_string(f, 2, "<theme_item name=\"" + p.name + "\" type=\"" + p.type + "\">"); - - _write_string(f, 3, p.description.strip_edges().xml_escape()); - - _write_string(f, 2, "</theme_item>"); - } - _write_string(f, 1, "</theme_items>"); - } - - _write_string(f, 0, "</class>"); - } - - return OK; -} - -Error DocData::load_compressed(const uint8_t *p_data, int p_compressed_size, int p_uncompressed_size) { - - Vector<uint8_t> data; - data.resize(p_uncompressed_size); - Compression::decompress(data.ptrw(), p_uncompressed_size, p_data, p_compressed_size, Compression::MODE_DEFLATE); - class_list.clear(); - - Ref<XMLParser> parser = memnew(XMLParser); - Error err = parser->open_buffer(data); - if (err) - return err; - - _load(parser); - - return OK; -} diff --git a/editor/doc/doc_data.h b/editor/doc/doc_data.h deleted file mode 100644 index 073705f0b1..0000000000 --- a/editor/doc/doc_data.h +++ /dev/null @@ -1,117 +0,0 @@ -/*************************************************************************/ -/* doc_data.h */ -/*************************************************************************/ -/* This file is part of: */ -/* GODOT ENGINE */ -/* https://godotengine.org */ -/*************************************************************************/ -/* Copyright (c) 2007-2020 Juan Linietsky, Ariel Manzur. */ -/* Copyright (c) 2014-2020 Godot Engine contributors (cf. AUTHORS.md). */ -/* */ -/* Permission is hereby granted, free of charge, to any person obtaining */ -/* a copy of this software and associated documentation files (the */ -/* "Software"), to deal in the Software without restriction, including */ -/* without limitation the rights to use, copy, modify, merge, publish, */ -/* distribute, sublicense, and/or sell copies of the Software, and to */ -/* permit persons to whom the Software is furnished to do so, subject to */ -/* the following conditions: */ -/* */ -/* The above copyright notice and this permission notice shall be */ -/* included in all copies or substantial portions of the Software. */ -/* */ -/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */ -/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */ -/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/ -/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */ -/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */ -/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */ -/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ -/*************************************************************************/ - -#ifndef DOC_DATA_H -#define DOC_DATA_H - -#include "core/io/xml_parser.h" -#include "core/map.h" -#include "core/variant.h" - -class DocData { -public: - struct ArgumentDoc { - - String name; - String type; - String enumeration; - String default_value; - }; - - struct MethodDoc { - - String name; - String return_type; - String return_enum; - String qualifiers; - String description; - Vector<ArgumentDoc> arguments; - bool operator<(const MethodDoc &p_md) const { - return name < p_md.name; - } - }; - - struct ConstantDoc { - - String name; - String value; - String enumeration; - String description; - }; - - struct PropertyDoc { - - String name; - String type; - String enumeration; - String description; - String setter, getter; - String default_value; - bool overridden; - bool operator<(const PropertyDoc &p_prop) const { - return name < p_prop.name; - } - PropertyDoc() { - overridden = false; - } - }; - - struct ClassDoc { - - String name; - String inherits; - String category; - String brief_description; - String description; - Vector<String> tutorials; - Vector<MethodDoc> methods; - Vector<MethodDoc> signals; - Vector<ConstantDoc> constants; - Vector<PropertyDoc> properties; - Vector<PropertyDoc> theme_properties; - }; - - String version; - - Map<String, ClassDoc> class_list; - Error _load(Ref<XMLParser> parser); - -public: - void merge_from(const DocData &p_data); - void remove_from(const DocData &p_data); - void generate(bool p_basic_types = false); - Error load_classes(const String &p_dir); - static Error erase_classes(const String &p_dir); - Error save_classes(const String &p_default_path, const Map<String, String> &p_class_path); - - Error load_compressed(const uint8_t *p_data, int p_compressed_size, int p_uncompressed_size); -}; - -#endif // DOC_DATA_H |