mirror of
				https://github.com/godotengine/godot.git
				synced 2025-10-31 05:31:01 +00:00 
			
		
		
		
	 b5334d14f7
			
		
	
	
		b5334d14f7
		
			
		
	
	
	
	
		
			
			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 🎆
		
	
			
		
			
				
	
	
		
			444 lines
		
	
	
	
		
			15 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
			
		
		
	
	
			444 lines
		
	
	
	
		
			15 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
| /*************************************************************************/
 | |
| /*  test_expression.h                                                    */
 | |
| /*************************************************************************/
 | |
| /*                       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.                */
 | |
| /*************************************************************************/
 | |
| 
 | |
| #ifndef TEST_EXPRESSION_H
 | |
| #define TEST_EXPRESSION_H
 | |
| 
 | |
| #include "core/math/expression.h"
 | |
| 
 | |
| #include "tests/test_macros.h"
 | |
| 
 | |
| namespace TestExpression {
 | |
| 
 | |
| TEST_CASE("[Expression] Integer arithmetic") {
 | |
| 	Expression expression;
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("-123456") == OK,
 | |
| 			"Integer identity should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			int(expression.execute()) == -123456,
 | |
| 			"Integer identity should return the expected result.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("2 + 3") == OK,
 | |
| 			"Integer addition should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			int(expression.execute()) == 5,
 | |
| 			"Integer addition should return the expected result.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("999999999999 + 999999999999") == OK,
 | |
| 			"Large integer addition should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			int64_t(expression.execute()) == 1'999'999'999'998,
 | |
| 			"Large integer addition should return the expected result.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("25 / 10") == OK,
 | |
| 			"Integer / integer division should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			int(expression.execute()) == 2,
 | |
| 			"Integer / integer division should return the expected result.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("2 * (6 + 14) / 2 - 5") == OK,
 | |
| 			"Integer multiplication-addition-subtraction-division should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			int(expression.execute()) == 15,
 | |
| 			"Integer multiplication-addition-subtraction-division should return the expected result.");
 | |
| }
 | |
| 
 | |
| TEST_CASE("[Expression] Floating-point arithmetic") {
 | |
| 	Expression expression;
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("-123.456") == OK,
 | |
| 			"Float identity should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			Math::is_equal_approx(float(expression.execute()), -123.456),
 | |
| 			"Float identity should return the expected result.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("2.0 + 3.0") == OK,
 | |
| 			"Float addition should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			Math::is_equal_approx(float(expression.execute()), 5),
 | |
| 			"Float addition should return the expected result.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("3.0 / 10") == OK,
 | |
| 			"Float / integer division should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			Math::is_equal_approx(float(expression.execute()), 0.3),
 | |
| 			"Float / integer division should return the expected result.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("3 / 10.0") == OK,
 | |
| 			"Basic integer / float division should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			Math::is_equal_approx(float(expression.execute()), 0.3),
 | |
| 			"Basic integer / float division should return the expected result.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("3.0 / 10.0") == OK,
 | |
| 			"Float / float division should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			Math::is_equal_approx(float(expression.execute()), 0.3),
 | |
| 			"Float / float division should return the expected result.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("2.5 * (6.0 + 14.25) / 2.0 - 5.12345") == OK,
 | |
| 			"Float multiplication-addition-subtraction-division should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			Math::is_equal_approx(float(expression.execute()), 20.18905),
 | |
| 			"Float multiplication-addition-subtraction-division should return the expected result.");
 | |
| }
 | |
| 
 | |
| TEST_CASE("[Expression] Scientific notation") {
 | |
| 	Expression expression;
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("2.e5") == OK,
 | |
| 			"The expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			Math::is_equal_approx(float(expression.execute()), 200'000),
 | |
| 			"The expression should return the expected result.");
 | |
| 
 | |
| 	// The middle "e" is ignored here.
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("2e5") == OK,
 | |
| 			"The expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			Math::is_equal_approx(float(expression.execute()), 25),
 | |
| 			"The expression should return the expected result.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("2e.5") == OK,
 | |
| 			"The expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			Math::is_equal_approx(float(expression.execute()), 2),
 | |
| 			"The expression should return the expected result.");
 | |
| }
 | |
| 
 | |
| TEST_CASE("[Expression] Underscored numeric literals") {
 | |
| 	Expression expression;
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("1_000_000") == OK,
 | |
| 			"The expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("1_000.000") == OK,
 | |
| 			"The expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("0xff_99_00") == OK,
 | |
| 			"The expression should parse successfully.");
 | |
| }
 | |
| 
 | |
| TEST_CASE("[Expression] Built-in functions") {
 | |
| 	Expression expression;
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("sqrt(pow(3, 2) + pow(4, 2))") == OK,
 | |
| 			"The expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			int(expression.execute()) == 5,
 | |
| 			"`sqrt(pow(3, 2) + pow(4, 2))` should return the expected result.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("snapped(sin(0.5), 0.01)") == OK,
 | |
| 			"The expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			Math::is_equal_approx(float(expression.execute()), 0.48),
 | |
| 			"`snapped(sin(0.5), 0.01)` should return the expected result.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("pow(2.0, -2500)") == OK,
 | |
| 			"The expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			Math::is_zero_approx(float(expression.execute())),
 | |
| 			"`pow(2.0, -2500)` should return the expected result (asymptotically zero).");
 | |
| }
 | |
| 
 | |
| TEST_CASE("[Expression] Boolean expressions") {
 | |
| 	Expression expression;
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("24 >= 12") == OK,
 | |
| 			"The boolean expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			bool(expression.execute()),
 | |
| 			"The boolean expression should evaluate to `true`.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("1.0 < 1.25 && 1.25 < 2.0") == OK,
 | |
| 			"The boolean expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			bool(expression.execute()),
 | |
| 			"The boolean expression should evaluate to `true`.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("!2") == OK,
 | |
| 			"The boolean expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			!bool(expression.execute()),
 | |
| 			"The boolean expression should evaluate to `false`.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("!!2") == OK,
 | |
| 			"The boolean expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			bool(expression.execute()),
 | |
| 			"The boolean expression should evaluate to `true`.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("!0") == OK,
 | |
| 			"The boolean expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			bool(expression.execute()),
 | |
| 			"The boolean expression should evaluate to `true`.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("!!0") == OK,
 | |
| 			"The boolean expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			!bool(expression.execute()),
 | |
| 			"The boolean expression should evaluate to `false`.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("2 && 5") == OK,
 | |
| 			"The boolean expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			bool(expression.execute()),
 | |
| 			"The boolean expression should evaluate to `true`.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("0 || 0") == OK,
 | |
| 			"The boolean expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			!bool(expression.execute()),
 | |
| 			"The boolean expression should evaluate to `false`.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("(2 <= 4) && (2 > 5)") == OK,
 | |
| 			"The boolean expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			!bool(expression.execute()),
 | |
| 			"The boolean expression should evaluate to `false`.");
 | |
| }
 | |
| 
 | |
| TEST_CASE("[Expression] Expressions with variables") {
 | |
| 	Expression expression;
 | |
| 
 | |
| 	PackedStringArray parameter_names;
 | |
| 	parameter_names.push_back("foo");
 | |
| 	parameter_names.push_back("bar");
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("foo + bar + 50", parameter_names) == OK,
 | |
| 			"The expression should parse successfully.");
 | |
| 	Array values;
 | |
| 	values.push_back(60);
 | |
| 	values.push_back(20);
 | |
| 	CHECK_MESSAGE(
 | |
| 			int(expression.execute(values)) == 130,
 | |
| 			"The expression should return the expected value.");
 | |
| 
 | |
| 	PackedStringArray parameter_names_invalid;
 | |
| 	parameter_names_invalid.push_back("foo");
 | |
| 	parameter_names_invalid.push_back("baz"); // Invalid parameter name.
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("foo + bar + 50", parameter_names_invalid) == OK,
 | |
| 			"The expression should parse successfully.");
 | |
| 	Array values_invalid;
 | |
| 	values_invalid.push_back(60);
 | |
| 	values_invalid.push_back(20);
 | |
| 	// Invalid parameters will parse successfully but print an error message when executing.
 | |
| 	ERR_PRINT_OFF;
 | |
| 	CHECK_MESSAGE(
 | |
| 			int(expression.execute(values_invalid)) == 0,
 | |
| 			"The expression should return the expected value.");
 | |
| 	ERR_PRINT_ON;
 | |
| 
 | |
| 	// Mismatched argument count (more values than parameters).
 | |
| 	PackedStringArray parameter_names_mismatch;
 | |
| 	parameter_names_mismatch.push_back("foo");
 | |
| 	parameter_names_mismatch.push_back("bar");
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("foo + bar + 50", parameter_names_mismatch) == OK,
 | |
| 			"The expression should parse successfully.");
 | |
| 	Array values_mismatch;
 | |
| 	values_mismatch.push_back(60);
 | |
| 	values_mismatch.push_back(20);
 | |
| 	values_mismatch.push_back(110);
 | |
| 	CHECK_MESSAGE(
 | |
| 			int(expression.execute(values_mismatch)) == 130,
 | |
| 			"The expression should return the expected value.");
 | |
| 
 | |
| 	// Mismatched argument count (more parameters than values).
 | |
| 	PackedStringArray parameter_names_mismatch2;
 | |
| 	parameter_names_mismatch2.push_back("foo");
 | |
| 	parameter_names_mismatch2.push_back("bar");
 | |
| 	parameter_names_mismatch2.push_back("baz");
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("foo + bar + baz + 50", parameter_names_mismatch2) == OK,
 | |
| 			"The expression should parse successfully.");
 | |
| 	Array values_mismatch2;
 | |
| 	values_mismatch2.push_back(60);
 | |
| 	values_mismatch2.push_back(20);
 | |
| 	// Having more parameters than values will parse successfully but print an
 | |
| 	// error message when executing.
 | |
| 	ERR_PRINT_OFF;
 | |
| 	CHECK_MESSAGE(
 | |
| 			int(expression.execute(values_mismatch2)) == 0,
 | |
| 			"The expression should return the expected value.");
 | |
| 	ERR_PRINT_ON;
 | |
| }
 | |
| 
 | |
| TEST_CASE("[Expression] Invalid expressions") {
 | |
| 	Expression expression;
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("\\") == ERR_INVALID_PARAMETER,
 | |
| 			"The expression shouldn't parse successfully.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("0++") == ERR_INVALID_PARAMETER,
 | |
| 			"The expression shouldn't parse successfully.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("()") == ERR_INVALID_PARAMETER,
 | |
| 			"The expression shouldn't parse successfully.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("()()") == ERR_INVALID_PARAMETER,
 | |
| 			"The expression shouldn't parse successfully.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("() - ()") == ERR_INVALID_PARAMETER,
 | |
| 			"The expression shouldn't parse successfully.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("() * 12345") == ERR_INVALID_PARAMETER,
 | |
| 			"The expression shouldn't parse successfully.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("() * 12345") == ERR_INVALID_PARAMETER,
 | |
| 			"The expression shouldn't parse successfully.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("123'456") == ERR_INVALID_PARAMETER,
 | |
| 			"The expression shouldn't parse successfully.");
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("123\"456") == ERR_INVALID_PARAMETER,
 | |
| 			"The expression shouldn't parse successfully.");
 | |
| }
 | |
| 
 | |
| TEST_CASE("[Expression] Unusual expressions") {
 | |
| 	Expression expression;
 | |
| 
 | |
| 	// Redundant parentheses don't cause a parse error as long as they're matched.
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("(((((((((((((((666)))))))))))))))") == OK,
 | |
| 			"The expression should parse successfully.");
 | |
| 
 | |
| 	// Using invalid identifiers doesn't cause a parse error.
 | |
| 	ERR_PRINT_OFF;
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("hello + hello") == OK,
 | |
| 			"The expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			int(expression.execute()) == 0,
 | |
| 			"The expression should return the expected result.");
 | |
| 	ERR_PRINT_ON;
 | |
| 
 | |
| 	ERR_PRINT_OFF;
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("$1.00 + ???5") == OK,
 | |
| 			"The expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			int(expression.execute()) == 0,
 | |
| 			"The expression should return the expected result.");
 | |
| 	ERR_PRINT_ON;
 | |
| 
 | |
| 	// Commas can't be used as a decimal parameter.
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("123,456") == OK,
 | |
| 			"The expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			int(expression.execute()) == 123,
 | |
| 			"The expression should return the expected result.");
 | |
| 
 | |
| 	// Spaces can't be used as a separator for large numbers.
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("123 456") == OK,
 | |
| 			"The expression should parse successfully.");
 | |
| 	CHECK_MESSAGE(
 | |
| 			int(expression.execute()) == 123,
 | |
| 			"The expression should return the expected result.");
 | |
| 
 | |
| 	// Division by zero is accepted, even though it prints an error message normally.
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("-25.4 / 0") == OK,
 | |
| 			"The expression should parse successfully.");
 | |
| 	ERR_PRINT_OFF;
 | |
| 	CHECK_MESSAGE(
 | |
| 			Math::is_inf(float(expression.execute())),
 | |
| 			"`-25.4 / 0` should return inf.");
 | |
| 	ERR_PRINT_ON;
 | |
| 
 | |
| 	CHECK_MESSAGE(
 | |
| 			expression.parse("0 / 0") == OK,
 | |
| 			"The expression should parse successfully.");
 | |
| 	ERR_PRINT_OFF;
 | |
| 	CHECK_MESSAGE(
 | |
| 			int(expression.execute()) == 0,
 | |
| 			"`0 / 0` should return 0.");
 | |
| 	ERR_PRINT_ON;
 | |
| 
 | |
| 	// The tests below currently crash the engine.
 | |
| 	//
 | |
| 	//CHECK_MESSAGE(
 | |
| 	//		expression.parse("(-9223372036854775807 - 1) % -1") == OK,
 | |
| 	//		"The expression should parse successfully.");
 | |
| 	//CHECK_MESSAGE(
 | |
| 	//		int64_t(expression.execute()) == 0,
 | |
| 	//		"`(-9223372036854775807 - 1) % -1` should return the expected result.");
 | |
| 	//
 | |
| 	//CHECK_MESSAGE(
 | |
| 	//		expression.parse("(-9223372036854775807 - 1) / -1") == OK,
 | |
| 	//		"The expression should parse successfully.");
 | |
| 	//CHECK_MESSAGE(
 | |
| 	//		int64_t(expression.execute()) == 0,
 | |
| 	//		"`(-9223372036854775807 - 1) / -1` should return the expected result.");
 | |
| }
 | |
| } // namespace TestExpression
 | |
| 
 | |
| #endif // TEST_EXPRESSION_H
 |