Script to automatically fix most deprecated API usage (where applicable)

[rollerozxa]

Looking through some of the contents that were imported from the old developer wiki made me find this old script by SmallJoker that would rename some deprecated names to their new counterparts. Such a script, but more expanded should be available here such that developers can easier update their mods and games to not use deprecated functions.

For more inspiration see SDL's tooling for helping with the migration to SDL3 - they have both python scripts that runs regular regex replacements for renames as well as more advanced semantical replacements using Coccinelle, which both allows automatically changing simple things without developer intervention as well as putting FIXME code comments for things that should be checked by a developer.

[SmallJoker]

I'd too recommend to use a Python script for this task. Shell scripts perform awfully when executing hundreds of commands, and implementing custom logic causes pain twice: once when you write it, and the 2nd time when you'd like to extend it.

[appgurueu]

Niemand hat die Absicht, ein Shellskript zu schreiben.

Personally I'd prefer a Lua script probably, but Python is also okay. I suppose whoever whips up this thing will get to choose.

I wonder whether simple text replacements are the way to go though. Maybe we should rather bring a full blown Lua parser. For simple things like renames there isn't much of a difference, but consider for example what happens if we rename a node def field - with a Lua parser it's easy to see, oh this is a call to core.register_node and the table constructor contains the old field name as a key. With a true regex it's impossible.