Expose reload_scripts as reload_open_files

[KANAjetzt]

Expose the reload_scripts method to match the current state of the 3.x branch.

As described in #83118, it is possible to replicate this method with GDScript:

static func reload_script(text_edit: TextEdit, source_code: String) -> void:
	var column := text_edit.get_caret_column()
	var row := text_edit.get_caret_line()
	var scroll_position_h := text_edit.get_h_scroll_bar().value
	var scroll_position_v := text_edit.get_v_scroll_bar().value

	text_edit.text = source_code
	text_edit.set_caret_column(column)
	text_edit.set_caret_line(row)
	text_edit.scroll_horizontal = scroll_position_h
	text_edit.scroll_vertical = scroll_position_v

	text_edit.tag_saved_version()

and set the text_editor/behavior/files/auto_reload_scripts_on_external_change setting to true.

Personally, I would prefer calling EditorInterface.get_script_editor().reload_scripts(), but I might not be aware of possible pitfalls caused by exposing this method.

This would also improve the porting of existing 3.5 plugins.

closes godotengine/godot-proposals#8111

[AThousandShips]

Please remove the special characters from the commit message and make it match the title of the PR

Also please open a proper proposal as asked on the issue, having a proper proposal where the proper arguments for this feature is important to gauge if this is needed

[AThousandShips]

@twaritwaikar do you recall if exposing this (i.e. making public) in 3.x was meant to be used in scripting, or was it renamed since it was made public on the c++ side?

This was done in #53900 but only for the 3.x side, so the fact that this was not done in 4.x to me implies that it was not intended to be exposed as such

Edit: these changes were ported to 4.x in #62157 where this was not exposed

[Qubus0]

This is useful (and used) for all plugins that modify any (active) scripts.
I'm not sure why it would not be intended to be exposed. Would there be any downside to having it exposed or is it a case of needing a certain degree of usefulness to be justified?

[AThousandShips]

Exposing internal methods, especially in the editor, binds the development to maintain compatibility and stability, so that's why I asked for a proposal to gauge the need and justification for this

If it can be worked around, how needed it is, etc.

Because exposing a method isn't a trivial thing that comes with possible issues and a burden of maintenance

[KANAjetzt]

What can I do to make the Linux check pass?

[AThousandShips]

See the error message, you need to reorder the entries of the documentation, they need to be ge sorted

[KANAjetzt]

Sorry for that unnecessary check, I hope I got it now 😅
The doctool got stuck when trying to delete the cache while VSCode was running.

[Paulb23]

Don't see a solid reason against exposing this for plugins, but I'm thinking we should start moving away from the script naming in this file a little bit as reload_scripts doesn't just reload Script, but any open file i.e TextFile and JSON.

So we should bind it as reload_open_files or something along those lines.

[KANAjetzt]

Thanks, @Paulb23 - I went ahead and changed it to your suggestion. Is there something to do now on the project converter side?

[KANAjetzt]

I added the function to the rename map, I hope we can get this merged for 4.3 👀