Open and load --code file and arguments in C++

[btzy]

Description

(Note: Please don't merge yet; there's still some problem with setting sys.argv that I haven't ironed out.)

I took a stab at #60120 to see if we can design a better alternative to #60121.

Instead of doing string substitution into Python code, we use the proper Python C API functions to assign to sys.argv and execute a Python script from a file. This avoids the issues that arise due to improper escaping of strings (e.g. ' and \). Unix file names in particular may contain any non-null character (including non-printable characters), and trying to escape such characters manually would otherwise be difficult to get right. String substitution is also possibly vulnerable to code injection attacks, as it is possible to carefully craft a string containing code that will be executed.

There was a hack that converts Windows-style directory separators to Unix-style directory separators. This is no longer necessary, and therefore has been removed.

Note that this PR changes the behaviour when --py-args is specified without --code. Previously, we would set sys.argv to the arguments given, but with this PR we do not do that. As far as I can tell, --py-args is meant to be used with --code, and therefore the former was unintended.

Fixes #60120.

[domi4484]

@btzy when we introduced --py-args we decided on purpose to make the args available for each python execution in QGIS independently from the --code argument.
But I can't remember exactly what's the use case thought, maybe @m-kuhn do you remember more?

@btzy If you need arguments valid only in the context of the --code script I would suggest to add a new parameter --code-args. But then arise the question what to do if they are both set?

[m-kuhn]

No strong opinion. What would be the reason to not make it also available for other python code than --code?

[btzy]

@domi4484 I misunderstood the help string of --py-args. I'll modify this PR. Likely we'll need another function in QgsPythonUtils to set the sys.argv variable (separate from runFile).

[btzy]

I'm not sure how to trigger the automatic Windows build that other PRs have; can someone help me get the GitHub Action to run?

[btzy]

Separately, I made #60183 to fix the grammar error in the help, which was what originally misled me to think that --py-args is only used with --code.

[github-actions]

🪟 Windows builds

Download Windows builds of this PR for testing.
Debug symbols for this build are available here.
(Built from commit 437bb6e)

🪟 Windows Qt6 builds

Download Windows Qt6 builds of this PR for testing.
(Built from commit 437bb6e)