Improve Python bskLogging API with convenience methods and level aliases

[ReeceHumphreys]

• Review: By commit
• Merge strategy: Merge (no squash)

Description

The bskLogger Python API doesn't match the conventions of Python's standard logging module. This is just a consequence of the SWIG code generation used to expose the C++ class. This PR adds purely additive aliases and convenience methods so users can interact with bskLogger in a more natural and Pythonic way:

• debug(), info(), warning(), error() convenience methods on BSKLogger which mirror the logging.Logger API.
• setLevel() as an alias for setLogLevel()
• A LogLevel IntEnum for typed level references

All existing APIs remain unchanged so this is fully backward compatible.
Also some minor formatting fixes were applied to the files that were updated. Generally I think when updating these older files its okay to allow the formatter to make some cleanup as long as we don't go overboard and muddle the diff with 1000s of LOC changes.

Verification

Tests passing

Documentation

Updated the bskLogging related documentation.

Future work

• We could deprecate the existing API.
• Generally I think we should make sure the API we expose feels very Pythonic and not just like python flavored C++. I am sure there are other spots like this we could improve the feel of the API.