printer.out flexibility

[synkarius]

Improve Console Output Flexibility

Description

After speaking with @LexiconCode about some upcoming changes, I suggested that he could avoid adding lots of UI code to _caster.py by making printer.py a bit more flexible. This PR is the implementation of that suggestion.

dh = printer.get_delegating_handler()
dh.register_handler(SimplePrintMessageHandler())
dh.start()

I put the above chunk of code in settings.py, but it could be moved to anywhere (anywhere that it's called only once) and it would work the same. (You don't have to worry about printer.out being called first, or import order or anything.) Switching output to the HUD would be as simple as replacing SimplePrintMessageHandler with some other implementation of BaseMessageHandler which does HUD stuff. Absolutely do not put said implementation in printer.py.

If the HUD BaseMessageHandler implementation is broken or throws errors when handling printer.out messages, those messages will be printed to the console by a default SimplePrintMessageHandler instead.

Incidentally, you can throw as many printer.out handlers at this thing as you want. It can use more than one.

Related Issue

Is there an issue for the HUD? If so, should link it here.

Motivation and Context

See description.

How Has This Been Tested

Additional unit tests + manual testing to make sure nothing was broken.

Types of changes

• [ ] Docs change / refactoring / dependency upgrade
• [ ] Bug fix (non-breaking change which fixes an issue or bug)
• [x] New feature (non-breaking change which adds functionality)
• [ ] Breaking change (fix or feature that would cause existing functionality to change)
• [ ] Renamed existing command phrases (we discourage this without a strong rationale).

Checklist

• [ ] I have read the CONTRIBUTING document.
• [x] My code follows the code style of this project.
• [x] I have checked that my code does not duplicate functionality elsewhere in Caster.
• [ ] I have checked for and utilized existing command phrases from within Caster (delete if not applicable).
• [x] My code implements all the features I wish to merge in this pull request.
• [ ] My change requires a change to the documentation.
• [ ] I have updated the documentation accordingly.
• [x] I have added tests to cover my changes.
• [x] All new and existing tests pass.

Maintainer/Reviewer Checklist

• [ ] Basic functionality has been tested and works as claimed.
• [ ] New documentation is clear and complete.
• [ ] Code is clear and readable.