fix: honor passing bolt logger in default web client installation

[WilliamBergamin]

Summary

This aims to resolve #1255

#246 defined passing the Bolt logger as the default logger for WebClient instantiation. Since #714 Bolt creates a new WebClient for each request handling execution, this is to prevent using the singleton pattern.

These changes aim to honor both previous decisions by passing the app client logger into each WebClient created for request handling.

Testing

Default WebClient logger is the Bolt App logger

import os
import logging

from slack_bolt import Ack, App
from slack_bolt.adapter.socket_mode import SocketModeHandler
from slack_sdk import WebClient


logging.basicConfig(level=logging.DEBUG)

app = App(token=os.environ.get("SLACK_BOT_TOKEN"))


@app.command("/sample-command")
def sample_command(ack: Ack, client: WebClient):
    ack()
    assert client.logger.name == app.logger.name


# Start Bolt app
if __name__ == "__main__":
    SocketModeHandler(app, os.environ.get("SLACK_APP_TOKEN")).start()

Custom logger can be set on WebClient

import os
import logging

from slack_bolt import Ack, App
from slack_bolt.adapter.socket_mode import SocketModeHandler
from slack_sdk import WebClient


logging.basicConfig(level=logging.DEBUG)
my_logger = logging.Logger("my_logger")
app = App(client=WebClient(token=os.environ.get("SLACK_BOT_TOKEN"), logger=my_logger))

@app.command("/sample-command")
def sample_command(ack: Ack, client: WebClient):
    ack()
    assert client.logger.name == my_logger.name

if __name__ == "__main__":
    SocketModeHandler(app, os.environ.get("SLACK_APP_TOKEN")).start()

Category

• slack_bolt.App and/or its core components
• slack_bolt.async_app.AsyncApp and/or its core components
• Adapters in slack_bolt.adapter
• Document pages under /docs
• Others

Requirements

Please read the Contributing guidelines and Code of Conduct before creating this issue or pull request. By submitting, you are agreeing to those rules.

• I've read and understood the Contributing Guidelines and have done my best effort to follow them.
• I've read and agree to the Code of Conduct.
• I've run ./scripts/install_all_and_run_tests.sh after making the changes.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 90.96%. Comparing base (4c237fe) to head (4173845).
Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1272   +/-   ##
=======================================
  Coverage   90.96%   90.96%           
=======================================
  Files         222      222           
  Lines        7501     7501           
=======================================
  Hits         6823     6823           
  Misses        678      678           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[zimeg]

🤔 QQ: Do we want to change the slack_sdk logger if no logger is provided to slack_bolt?

Before these changes I found API requests logged as so:

DEBUG:slack_sdk.web.base_client:Sending a request - url: https://slack.com/api/views.publish

But with the default setup this is changed to:

DEBUG:slack_bolt.App:Sending a request - url: https://slack.com/api/views.publish

I think both cases make sense, but I might be used to having the default slack_sdk logs shown here 📣

[zimeg]

👏 Awesome checks!

[zimeg]

A bit more testing is showing that a custom logger setup with the following outputs as expected 🚀

bolt = logging.getLogger("zaps")
logs.setLevel(logging.DEBUG)
app = App(logger=logs, token=os.environ.get("SLACK_BOT_TOKEN"))

DEBUG:zaps:Sending a request - url: https://slack.com/api/views.publish

Even fun combinations of logger setups are logging to the right outputs:

bolt = logging.getLogger("zaps")
bolt.setLevel(logging.DEBUG)
webapi = logging.getLogger("zips")
webapi.setLevel(logging.DEBUG)
app = App(logger=bolt, client=WebClient(token=os.environ.get("SLACK_BOT_TOKEN"), logger=webapi))

LGTM if the comment beforehand seems right to you, but I'm open to more discussion whenever!

[zimeg]

🏷️ Small nit to the milestone used, we could add this PR to 1.23.0 and include the changes that landed for 1.22.1 with this next release?

[WilliamBergamin]

🤔 QQ: Do we want to change the slack_sdk logger if no logger is provided to slack_bolt?

This is a good point to bring up, from my investigation before #714 the default slack_bolt logger was being injected as the slack_sdk logger, the default logger of the parent client in the app is the bolt framework logger.

bolt-python/slack_bolt/app/app.py

Line 242 in 4c237fe

logger=self._framework_logger,