gaming/godot
gaming/godot
1
0
Fork 0
mirror of https://github.com/godotengine/godot synced 2024-09-05 06:48:38 +00:00
Code Issues Packages Projects Releases Wiki Activity
godot/modules/gdscript/tests
History
Rémi Verschelde 745f8e112f
Revert "Add UID support to GDScript files" 
This reverts commit c7f68a27ec.

We still think GDScript files need UIDs to allow safe refactoring,
but we're still debating what form those should take exactly.

So far there seems to be agreement that it shouldn't be done via an
annotation as implemented here, so we're reverting this one for now,
to revisit the feature in a future PR.
2024-01-29 21:00:26 +01:00
..
scripts Revert "Add UID support to GDScript files" 2024-01-29 21:00:26 +01:00
gdscript_test_runner.cpp Add unit test runner for autocompletion 2024-01-05 17:49:51 +01:00
gdscript_test_runner.h Style: Harmonize header includes in modules 2023-06-15 14:35:45 +02:00
gdscript_test_runner_suite.h Style: Harmonize header includes in modules 2023-06-15 14:35:45 +02:00
README.md Allow specifying a scene in completion tests 2024-01-08 22:38:41 +01:00
test_completion.h Allow specifying a scene in completion tests 2024-01-08 22:38:41 +01:00
test_gdscript.cpp Merge pull request #79425 from vnen/gdscript-load-classes-for-debug-tests 2023-10-03 17:11:01 +02:00
test_gdscript.h Style: Harmonize header includes in modules 2023-06-15 14:35:45 +02:00
test_lsp.h Add unit test runner for autocompletion 2024-01-05 17:49:51 +01:00

README.md

GDScript integration tests

The scripts/ folder contains integration tests in the form of GDScript files and output files.

See the Integration tests for GDScript documentation for information about creating and running GDScript integration tests.

GDScript Autocompletion tests

The script/completion folder contains test for the GDScript autocompletion.

Each test case consists of at least one .gd file, which contains the code, and one .cfg file, which contains expected results and configuration. Inside of the GDScript file the character ➡ represents the cursor position, at which autocompletion is invoked.

The config file contains two section:

[input] contains keys that configure the test environment. The following keys are possible:

  • cs: boolean = false: If true, the test will be skipped when running a non C# build.
  • use_single_quotes: boolean = false: Configures the corresponding editor setting for the test.
  • scene: String: Allows to specify a scene which is opened while autocompletion is performed. If this is not set the test runner will search for a .tscn file with the same basename as the GDScript file. If that isn't found either, autocompletion will behave as if no scene was opened.

[output] specifies the expected results for the test. The following key are supported:

  • include: Array: An unordered list of suggestions that should be in the result. Each entry is one dictionary with the following keys: display, insert_text, kind, location, which correspond to the suggestion struct which is used in the code. The runner only tests against specified keys, so in most cases display will suffice.
  • exclude: Array: An array of suggestions which should not be in the result. The entries take the same form as for include.
  • call_hint: String: The expected call hint returned by autocompletion.
  • forced: boolean: Whether autocompletion is expected to force opening a completion window.

Tests will only test against entries in [output] that were specified.

Writing autocompletion tests

To avoid failing edge cases a certain behaviour needs to be tested multiple times. Some things that tests should account for:

  • All possible types: Test with all possible types that apply to the tested behaviour. (For the last points testing against SCRIPT and CLASS should suffice. CLASS can be obtained through C#, SCRIPT through GDScript. Relying on autoloads to be of type SCRIPT is not good, since this might change in the future.)

    • BUILTIN
    • NATIVE
    • GDScripts (with class_name as well as preloaded)
    • C# (as standin for all other language bindings) (with class_name as well as preloaded)
    • Autoloads

  • Possible contexts: the completion might be placed in different places of the program. e.g:

    • initializers of class members
    • directly inside a suite
    • assignments inside a suite
    • as parameter to a call