feat: add ability to pass user flags to python interpreter

[muravev-vasilii]

This change is meant to demonstrate the proposed update for the following feature request: #436

---

Changes are visible to end-users: yes

Users can influence behaviour of interpreter by passing additional flags via interpreter_args attribute

Test plan

• Manual testing;

Modified py_binary with new attribute

py_binary(
    name = "foo",
    srcs = [...],
    deps = [...],
    interpreter_options = ["-m", "debugpy", "--listen", "12345", "--wait-for-client"],
)

Ran bazel target

bazel run //path/to/rules_py/py_binary/target:foo

From VSCode side:

• installed Python Debugger extension
• updated launch.json with

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python Debugger: Attach",
            "type": "debugpy",
            "request": "attach",
            "connect": {
              "host": "localhost",
              "port": 12345
            }
          }
    ]
}

Used Run&Debug tab in VSCode to set breakpoints, connect to program and debug.

I also tried to do proposed here (#436) way with select and -c dbg, it works, but less minimalistic to show proposed change

[CLAassistant]

All committers have signed the CLA.

[mnoah1]

Also, one other change for the debug use case is that the run template should set the PYDEVD_RESOLVE_SYMLINKS environment variable to true before starting debugpy. This resolves symlinks when sending paths to the client. Without this set, VS Code will open any paths within the Bazel cache as their own tab instead of showing the breakpoint in the original source file. More info: microsoft/debugpy#743

[alexeagle]

optional: maybe we should document a bit more about the --compilation_mode dbg use case you'll use this for

[muravev-vasilii]

optional: maybe we should document a bit more about the --compilation_mode dbg use case you'll use this for

This one I would prefer to add in a separate example, as I need to create minimalistic example not applied to our monorepo first