Choose logging handler via --log-handler CLI option

[cpitclaudel]

• pelican/__init__.py (parse_arguments): Declare new --log-handler argument.
  Uses a string instead of a type= argument to get better error messages when passed an incorrect choice.
  (main): Pass args.logs_handler to init_logging
• pelican/log.py: Expose default log handler as DEFAULT_LOG_HANDLER.
  (init): Pass handler to logging.basicConfig.

Pull Request Checklist

Resolves: GH-3292

• Ensured tests pass and (if applicable) updated functional test output
• Conformed to code style guidelines by running appropriate linting tools
• Added tests for changed code
  Question: I think there's no tests for the logger?
• Updated documentation for changed code
  Question: I think there's no separate documentation for the CLI, I just added an argparse help

[justinmayer]

Hi @cpitclaudel. Thank you for the quick corrections. Apologies for the delay in moving this forward. Upon another look, I think I would prefer to standardize on "log" instead of the plural "logs". We already have DEFAULT_LOG_HANDLER, for example, and therefore I think it would be more consistent to use LOG_HANDLERS, --log-handler, et cetera, instead of the plural versions. Unless there are any objections, would you be so kind as to make those changes so we can merge your contribution?

[cpitclaudel]

No worries! No objection from me (pushed), but note that this is inconsistent with --logs-dedup-min-level.

[justinmayer]

I saw that but decided that particularly discrepancy is okay for now. We shall strive for eventual consistency! 😉

@avaris: Any thoughts on this PR?

[offbyone]

I'm curious what use this flag would be put to. It would be constructive, I think, to include documentation for how to use it, how to define a new handler, and an example custom handler.

[cpitclaudel]

I'm curious what use this flag would be put to.

I use it in makefiles, because the forced line wrapping that the rich handler does breaks hyperlinks:

           ERROR    Skipping                                     contents.py:175
                    /home/xxx/xxx/xxxxxxx/xxxxx/xxxxx/xxxxxxxxxx                
                    /xxxxxxxxxxxxx/xxxxxxxx/xxxxxxxxx/xxxxxx.htm                
                    l: could not find information about 'date'           

With this format my terminal and my IDE don't let me click on the file in question to navigate to it.

It would be constructive, I think, to include documentation for how to use it, how to define a new handler, and an example custom handler.

Defining a custom handler is something the Pelican devs would do, not users. These are standard Python log handlers, so the appropriate documentation would be https://docs.python.org/3/library/logging.handlers.html

[GiovanH]

I was just about to request this. Are there any outstanding issues or is this fully approved?

[justinmayer]

Unless there are further comments from others, I intend to merge the Ruff-related PR (3239) and then this one.