godot/modules/mono/class_db_api_json.cpp
Rémi Verschelde b5334d14f7
Update copyright statements to 2021
Happy new year to the wonderful Godot community!

2020 has been a tough year for most of us personally, but a good year for
Godot development nonetheless with a huge amount of work done towards Godot
4.0 and great improvements backported to the long-lived 3.2 branch.

We've had close to 400 contributors to engine code this year, authoring near
7,000 commit! (And that's only for the `master` branch and for the engine code,
there's a lot more when counting docs, demos and other first-party repos.)

Here's to a great year 2021 for all Godot users 🎆
2021-01-01 20:19:21 +01:00

250 lines
7.5 KiB
C++

/*************************************************************************/
/* class_db_api_json.cpp */
/*************************************************************************/
/* This file is part of: */
/* GODOT ENGINE */
/* https://godotengine.org */
/*************************************************************************/
/* Copyright (c) 2007-2021 Juan Linietsky, Ariel Manzur. */
/* Copyright (c) 2014-2021 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 "class_db_api_json.h"
#ifdef DEBUG_METHODS_ENABLED
#include "core/config/project_settings.h"
#include "core/io/json.h"
#include "core/os/file_access.h"
#include "core/version.h"
void class_db_api_to_json(const String &p_output_file, ClassDB::APIType p_api) {
Dictionary classes_dict;
List<StringName> names;
const StringName *k = nullptr;
while ((k = ClassDB::classes.next(k))) {
names.push_back(*k);
}
//must be alphabetically sorted for hash to compute
names.sort_custom<StringName::AlphCompare>();
for (List<StringName>::Element *E = names.front(); E; E = E->next()) {
ClassDB::ClassInfo *t = ClassDB::classes.getptr(E->get());
ERR_FAIL_COND(!t);
if (t->api != p_api || !t->exposed) {
continue;
}
Dictionary class_dict;
classes_dict[t->name] = class_dict;
class_dict["inherits"] = t->inherits;
{ //methods
List<StringName> snames;
k = nullptr;
while ((k = t->method_map.next(k))) {
String name = k->operator String();
ERR_CONTINUE(name.is_empty());
if (name[0] == '_') {
continue; // Ignore non-virtual methods that start with an underscore
}
snames.push_back(*k);
}
snames.sort_custom<StringName::AlphCompare>();
Array methods;
for (List<StringName>::Element *F = snames.front(); F; F = F->next()) {
Dictionary method_dict;
methods.push_back(method_dict);
MethodBind *mb = t->method_map[F->get()];
method_dict["name"] = mb->get_name();
method_dict["argument_count"] = mb->get_argument_count();
method_dict["return_type"] = mb->get_argument_type(-1);
Array arguments;
method_dict["arguments"] = arguments;
for (int i = 0; i < mb->get_argument_count(); i++) {
Dictionary argument_dict;
arguments.push_back(argument_dict);
const PropertyInfo info = mb->get_argument_info(i);
argument_dict["type"] = info.type;
argument_dict["name"] = info.name;
argument_dict["hint"] = info.hint;
argument_dict["hint_string"] = info.hint_string;
}
method_dict["default_argument_count"] = mb->get_default_argument_count();
Array default_arguments;
method_dict["default_arguments"] = default_arguments;
for (int i = 0; i < mb->get_default_argument_count(); i++) {
Dictionary default_argument_dict;
default_arguments.push_back(default_argument_dict);
//hash should not change, i hope for tis
Variant da = mb->get_default_argument(i);
default_argument_dict["value"] = da;
}
method_dict["hint_flags"] = mb->get_hint_flags();
}
if (!methods.is_empty()) {
class_dict["methods"] = methods;
}
}
{ //constants
List<StringName> snames;
k = nullptr;
while ((k = t->constant_map.next(k))) {
snames.push_back(*k);
}
snames.sort_custom<StringName::AlphCompare>();
Array constants;
for (List<StringName>::Element *F = snames.front(); F; F = F->next()) {
Dictionary constant_dict;
constants.push_back(constant_dict);
constant_dict["name"] = F->get();
constant_dict["value"] = t->constant_map[F->get()];
}
if (!constants.is_empty()) {
class_dict["constants"] = constants;
}
}
{ //signals
List<StringName> snames;
k = nullptr;
while ((k = t->signal_map.next(k))) {
snames.push_back(*k);
}
snames.sort_custom<StringName::AlphCompare>();
Array signals;
for (List<StringName>::Element *F = snames.front(); F; F = F->next()) {
Dictionary signal_dict;
signals.push_back(signal_dict);
MethodInfo &mi = t->signal_map[F->get()];
signal_dict["name"] = F->get();
Array arguments;
signal_dict["arguments"] = arguments;
for (int i = 0; i < mi.arguments.size(); i++) {
Dictionary argument_dict;
arguments.push_back(argument_dict);
argument_dict["type"] = mi.arguments[i].type;
}
}
if (!signals.is_empty()) {
class_dict["signals"] = signals;
}
}
{ //properties
List<StringName> snames;
k = nullptr;
while ((k = t->property_setget.next(k))) {
snames.push_back(*k);
}
snames.sort_custom<StringName::AlphCompare>();
Array properties;
for (List<StringName>::Element *F = snames.front(); F; F = F->next()) {
Dictionary property_dict;
properties.push_back(property_dict);
ClassDB::PropertySetGet *psg = t->property_setget.getptr(F->get());
property_dict["name"] = F->get();
property_dict["setter"] = psg->setter;
property_dict["getter"] = psg->getter;
}
if (!properties.is_empty()) {
class_dict["property_setget"] = properties;
}
}
Array property_list;
//property list
for (List<PropertyInfo>::Element *F = t->property_list.front(); F; F = F->next()) {
Dictionary property_dict;
property_list.push_back(property_dict);
property_dict["name"] = F->get().name;
property_dict["type"] = F->get().type;
property_dict["hint"] = F->get().hint;
property_dict["hint_string"] = F->get().hint_string;
property_dict["usage"] = F->get().usage;
}
if (!property_list.is_empty()) {
class_dict["property_list"] = property_list;
}
}
FileAccessRef f = FileAccess::open(p_output_file, FileAccess::WRITE);
ERR_FAIL_COND_MSG(!f, "Cannot open file '" + p_output_file + "'.");
f->store_string(JSON::print(classes_dict, /*indent: */ "\t"));
f->close();
print_line(String() + "ClassDB API JSON written to: " + ProjectSettings::get_singleton()->globalize_path(p_output_file));
}
#endif // DEBUG_METHODS_ENABLED