2020-05-02 00:14:56 +02:00
|
|
|
/*************************************************************************/
|
|
|
|
/* gdscript_analyzer.h */
|
|
|
|
/*************************************************************************/
|
|
|
|
/* This file is part of: */
|
|
|
|
/* GODOT ENGINE */
|
|
|
|
/* https://godotengine.org */
|
|
|
|
/*************************************************************************/
|
2022-01-03 21:27:34 +01:00
|
|
|
/* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */
|
|
|
|
/* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */
|
2020-05-02 00:14:56 +02:00
|
|
|
/* */
|
|
|
|
/* 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 GDSCRIPT_ANALYZER_H
|
|
|
|
#define GDSCRIPT_ANALYZER_H
|
|
|
|
|
2020-11-07 23:33:38 +01:00
|
|
|
#include "core/object/object.h"
|
2021-06-04 18:03:15 +02:00
|
|
|
#include "core/object/ref_counted.h"
|
2022-05-19 17:00:06 +02:00
|
|
|
#include "core/templates/hash_set.h"
|
2020-06-11 00:53:25 +02:00
|
|
|
#include "gdscript_cache.h"
|
2020-05-02 00:14:56 +02:00
|
|
|
#include "gdscript_parser.h"
|
|
|
|
|
|
|
|
class GDScriptAnalyzer {
|
|
|
|
GDScriptParser *parser = nullptr;
|
2020-06-11 00:53:25 +02:00
|
|
|
HashMap<String, Ref<GDScriptParserRef>> depended_parsers;
|
2020-05-02 00:14:56 +02:00
|
|
|
|
2020-08-18 22:44:20 +02:00
|
|
|
const GDScriptParser::EnumNode *current_enum = nullptr;
|
2022-04-20 19:22:22 +02:00
|
|
|
List<GDScriptParser::LambdaNode *> lambda_stack;
|
2020-08-18 22:44:20 +02:00
|
|
|
|
2021-08-24 18:49:03 +02:00
|
|
|
// Tests for detecting invalid overloading of script members
|
|
|
|
static _FORCE_INLINE_ bool has_member_name_conflict_in_script_class(const StringName &p_name, const GDScriptParser::ClassNode *p_current_class_node);
|
|
|
|
static _FORCE_INLINE_ bool has_member_name_conflict_in_native_type(const StringName &p_name, const StringName &p_native_type_string);
|
|
|
|
Error check_native_member_name_conflict(const StringName &p_member_name, const GDScriptParser::Node *p_member_node, const StringName &p_native_type_string);
|
|
|
|
Error check_class_member_name_conflict(const GDScriptParser::ClassNode *p_class_node, const StringName &p_member_name, const GDScriptParser::Node *p_member_node);
|
|
|
|
|
2020-05-02 00:14:56 +02:00
|
|
|
Error resolve_inheritance(GDScriptParser::ClassNode *p_class, bool p_recursive = true);
|
2020-06-12 00:31:28 +02:00
|
|
|
GDScriptParser::DataType resolve_datatype(GDScriptParser::TypeNode *p_type);
|
2020-05-02 00:14:56 +02:00
|
|
|
|
2020-06-11 00:53:25 +02:00
|
|
|
void decide_suite_type(GDScriptParser::Node *p_suite, GDScriptParser::Node *p_statement);
|
|
|
|
|
2020-05-02 00:14:56 +02:00
|
|
|
// This traverses the tree to resolve all TypeNodes.
|
2020-06-11 00:53:25 +02:00
|
|
|
Error resolve_program();
|
|
|
|
|
|
|
|
void resolve_annotation(GDScriptParser::AnnotationNode *p_annotation);
|
|
|
|
void resolve_class_interface(GDScriptParser::ClassNode *p_class);
|
|
|
|
void resolve_class_body(GDScriptParser::ClassNode *p_class);
|
|
|
|
void resolve_function_signature(GDScriptParser::FunctionNode *p_function);
|
|
|
|
void resolve_function_body(GDScriptParser::FunctionNode *p_function);
|
2022-10-13 19:31:12 +02:00
|
|
|
void resolve_node(GDScriptParser::Node *p_node, bool p_is_root = true);
|
2020-06-11 00:53:25 +02:00
|
|
|
void resolve_suite(GDScriptParser::SuiteNode *p_suite);
|
|
|
|
void resolve_if(GDScriptParser::IfNode *p_if);
|
|
|
|
void resolve_for(GDScriptParser::ForNode *p_for);
|
|
|
|
void resolve_while(GDScriptParser::WhileNode *p_while);
|
|
|
|
void resolve_variable(GDScriptParser::VariableNode *p_variable);
|
|
|
|
void resolve_constant(GDScriptParser::ConstantNode *p_constant);
|
|
|
|
void resolve_assert(GDScriptParser::AssertNode *p_assert);
|
|
|
|
void resolve_match(GDScriptParser::MatchNode *p_match);
|
|
|
|
void resolve_match_branch(GDScriptParser::MatchBranchNode *p_match_branch, GDScriptParser::ExpressionNode *p_match_test);
|
|
|
|
void resolve_match_pattern(GDScriptParser::PatternNode *p_match_pattern, GDScriptParser::ExpressionNode *p_match_test);
|
2020-09-06 09:56:52 +02:00
|
|
|
void resolve_parameter(GDScriptParser::ParameterNode *p_parameter);
|
2020-06-11 00:53:25 +02:00
|
|
|
void resolve_return(GDScriptParser::ReturnNode *p_return);
|
|
|
|
|
|
|
|
// Reduction functions.
|
2021-10-15 01:12:01 +02:00
|
|
|
void reduce_expression(GDScriptParser::ExpressionNode *p_expression, bool p_is_root = false);
|
2020-06-11 00:53:25 +02:00
|
|
|
void reduce_array(GDScriptParser::ArrayNode *p_array);
|
|
|
|
void reduce_assignment(GDScriptParser::AssignmentNode *p_assignment);
|
|
|
|
void reduce_await(GDScriptParser::AwaitNode *p_await);
|
|
|
|
void reduce_binary_op(GDScriptParser::BinaryOpNode *p_binary_op);
|
2021-10-15 01:12:01 +02:00
|
|
|
void reduce_call(GDScriptParser::CallNode *p_call, bool p_is_await = false, bool p_is_root = false);
|
2020-06-11 00:53:25 +02:00
|
|
|
void reduce_cast(GDScriptParser::CastNode *p_cast);
|
|
|
|
void reduce_dictionary(GDScriptParser::DictionaryNode *p_dictionary);
|
|
|
|
void reduce_get_node(GDScriptParser::GetNodeNode *p_get_node);
|
2020-06-12 02:49:58 +02:00
|
|
|
void reduce_identifier(GDScriptParser::IdentifierNode *p_identifier, bool can_be_builtin = false);
|
2020-06-11 00:53:25 +02:00
|
|
|
void reduce_identifier_from_base(GDScriptParser::IdentifierNode *p_identifier, GDScriptParser::DataType *p_base = nullptr);
|
2021-03-26 13:03:16 +01:00
|
|
|
void reduce_lambda(GDScriptParser::LambdaNode *p_lambda);
|
2020-06-11 00:53:25 +02:00
|
|
|
void reduce_literal(GDScriptParser::LiteralNode *p_literal);
|
|
|
|
void reduce_preload(GDScriptParser::PreloadNode *p_preload);
|
|
|
|
void reduce_self(GDScriptParser::SelfNode *p_self);
|
|
|
|
void reduce_subscript(GDScriptParser::SubscriptNode *p_subscript);
|
|
|
|
void reduce_ternary_op(GDScriptParser::TernaryOpNode *p_ternary_op);
|
|
|
|
void reduce_unary_op(GDScriptParser::UnaryOpNode *p_unary_op);
|
|
|
|
|
2020-09-11 16:16:20 +02:00
|
|
|
void const_fold_array(GDScriptParser::ArrayNode *p_array);
|
|
|
|
void const_fold_dictionary(GDScriptParser::DictionaryNode *p_dictionary);
|
|
|
|
|
2020-06-11 00:53:25 +02:00
|
|
|
// Helpers.
|
2020-08-31 14:53:02 +02:00
|
|
|
GDScriptParser::DataType type_from_variant(const Variant &p_value, const GDScriptParser::Node *p_source);
|
2020-06-11 00:53:25 +02:00
|
|
|
GDScriptParser::DataType type_from_metatype(const GDScriptParser::DataType &p_meta_type) const;
|
|
|
|
GDScriptParser::DataType type_from_property(const PropertyInfo &p_property) const;
|
2020-11-26 16:27:48 +01:00
|
|
|
GDScriptParser::DataType make_global_class_meta_type(const StringName &p_class_name, const GDScriptParser::Node *p_source);
|
2022-03-06 15:09:12 +01:00
|
|
|
bool get_function_signature(GDScriptParser::Node *p_source, bool p_is_constructor, GDScriptParser::DataType base_type, const StringName &p_function, GDScriptParser::DataType &r_return_type, List<GDScriptParser::DataType> &r_par_types, int &r_default_arg_count, bool &r_static, bool &r_vararg);
|
2020-06-11 00:53:25 +02:00
|
|
|
bool function_signature_from_info(const MethodInfo &p_info, GDScriptParser::DataType &r_return_type, List<GDScriptParser::DataType> &r_par_types, int &r_default_arg_count, bool &r_static, bool &r_vararg);
|
|
|
|
bool validate_call_arg(const List<GDScriptParser::DataType> &p_par_types, int p_default_args_count, bool p_is_vararg, const GDScriptParser::CallNode *p_call);
|
|
|
|
bool validate_call_arg(const MethodInfo &p_method, const GDScriptParser::CallNode *p_call);
|
2020-08-31 14:53:02 +02:00
|
|
|
GDScriptParser::DataType get_operation_type(Variant::Operator p_operation, const GDScriptParser::DataType &p_a, const GDScriptParser::DataType &p_b, bool &r_valid, const GDScriptParser::Node *p_source);
|
2020-11-26 18:41:55 +01:00
|
|
|
GDScriptParser::DataType get_operation_type(Variant::Operator p_operation, const GDScriptParser::DataType &p_a, bool &r_valid, const GDScriptParser::Node *p_source);
|
2021-03-09 16:32:35 +01:00
|
|
|
void update_array_literal_element_type(const GDScriptParser::DataType &p_base_type, GDScriptParser::ArrayNode *p_array_literal);
|
2022-01-27 15:34:33 +01:00
|
|
|
bool is_type_compatible(const GDScriptParser::DataType &p_target, const GDScriptParser::DataType &p_source, bool p_allow_implicit_conversion = false, const GDScriptParser::Node *p_source_node = nullptr);
|
2020-06-11 00:53:25 +02:00
|
|
|
void push_error(const String &p_message, const GDScriptParser::Node *p_origin);
|
|
|
|
void mark_node_unsafe(const GDScriptParser::Node *p_node);
|
2022-04-20 19:22:22 +02:00
|
|
|
void mark_lambda_use_self();
|
2021-03-09 16:32:35 +01:00
|
|
|
bool class_exists(const StringName &p_class) const;
|
2020-06-11 00:53:25 +02:00
|
|
|
Ref<GDScriptParserRef> get_parser_for(const String &p_path);
|
2020-07-16 03:02:44 +02:00
|
|
|
#ifdef DEBUG_ENABLED
|
|
|
|
bool is_shadowing(GDScriptParser::IdentifierNode *p_local, const String &p_context);
|
|
|
|
#endif
|
2020-05-02 00:14:56 +02:00
|
|
|
|
|
|
|
public:
|
|
|
|
Error resolve_inheritance();
|
2020-06-11 00:53:25 +02:00
|
|
|
Error resolve_interface();
|
|
|
|
Error resolve_body();
|
2020-05-02 00:14:56 +02:00
|
|
|
Error analyze();
|
|
|
|
|
|
|
|
GDScriptAnalyzer(GDScriptParser *p_parser);
|
|
|
|
};
|
|
|
|
|
|
|
|
#endif // GDSCRIPT_ANALYZER_H
|