gh-102980: Redirect pdb interact command, add tests and improve docs

[gaogaotiantian]

With the long due #102896, we can finally add tests for interact command.

However, the current interact command uses code.interact directly which makes it super difficult to test, because code.interact writes to sys.stderr directly (with sys.stderr.write)! We need to overload the write method in a derived class to write to the same channel as Pdb.message.

The interactive message is also changed to make more sense - one might wonder if this is a breaking change to users, but

1. This PR will be not backported, so it's a new thing.
2. The current status (plus the interactive issue in gh-102895 Add an option local_exit in code.interact to block exit() from terminating the whole process #102896 before the fix) made it almost impossible to write tests for interact command, so I don't think we'll break anything.

This PR adds the class for interact commmand and some basic tests for interact; and also clarifies the namespace situation with interact - it's a bit tricky and could be confusing to the users, so some clarification is needed.

The way to exit interact command is also added to the docs.

• Issue: Improve test coverage on pdb #102980

---

📚 Documentation preview 📚: https://cpython-previews--111194.org.readthedocs.build/

[gaogaotiantian]

Hi @iritkatriel , could you maybe take a look at this PR when you have some time? It's a relatively straightforward one and it's been stuck for a while. Thanks!

[iritkatriel]

Is this describing the code change in this PR?

[gaogaotiantian]

Yes. So currently pdb uses code.interact directly for interact command. However, code.interact has a hard-coded output to sys.stderr. pdb supports defining output channel, and we kind of use that for our tests. The user would also expect the output from interact command flushed to the same channel as pdb (stdout instead of stderr by default actually).

This PR subclassed code.InteractiveConsole to overwrite the write method, in order to redirect the output to self.message.

[gaogaotiantian]

Thanks for the review!