[update] divide `app.py` into `Cogs` && use `commands.bot`

[smngs]

issue

• Null

変更の概要

• app.py にまとめていた send_hoge コマンドたちを module 直下にそれぞれ分割

変更の理由（なぜこの変更をするのか）

• メンテナンス性の向上
• global 変数を使わないようにする
  • 今まで global で持っていた queue, voice_client... といった変数を（適当に）クラス変数として定義し直した

その他

既知の問題

• 当該変更に伴い，今まで行っていた on_message での None チェックを排除
  • 当該変更に伴いメッセージ投稿時に AttributeError が発生している
  • 今後修正予定

[12ev09]

# root/src/config.py

#
# 環境変数
#
import os

DISCORD_API_KEY = os.environ.get("DISCORD_API_KEY")
DISCORD_SERVER_KEY = os.environ.get("DISCORD_SERVER_KEY")

/moduleで環境変数を読み込む処理が冗長で嫌なのでconfig.pyを定義してこれをimportしたい

importのしかた

• 同じディレクトリの場合(app.py)

  from config import DISCORD_API_KEY, DISCORD_SERVER_KEY

• /module直下の場合

  from ..config import DISCORD_SERVER_KEY

データベースを作る前の段階では、これと同様な感じでやってあげると良いね。

[smngs]

# root/src/config.py

#
# 環境変数
#
import os

DISCORD_API_KEY = os.environ.get("DISCORD_API_KEY")
DISCORD_SERVER_KEY = os.environ.get("DISCORD_SERVER_KEY")

• 下位のディレクトリのモジュールから上位のディレクトリのモジュールを import しようとすると，以下のような ImportError が発生する

app                | Traceback (most recent call last):
app                |   File "/usr/local/lib/python3.10/site-packages/discord/ext/commands/bot.py", line 934, in _load_from_module_spec
app                |     spec.loader.exec_module(lib)  # type: ignore
app                |   File "<frozen importlib._bootstrap_external>", line 883, in exec_module
app                |   File "<frozen importlib._bootstrap>", line 241, in _call_with_frames_removed
app                |   File "/root/src/modules/hello.py", line 6, in <module>
app                |     from ..config import DISCORD_SERVER_KEY
app                | ImportError: attempted relative import beyond top-level package

[smngs]

https://github.com/smngs/da-bot/blob/d4c03463456c99ea6900a87686b100138b3c4dce/app.py#L25

• 環境変数を定義した ./config.py をルートディレクトリに置いたまま import できた
  • app.py で await bot.load_extension(cogs) した時点で，modules 直下のモジュール群はルートに存在することになるらしい？
  • あんまりよくわかってない
• app.py, modules/*.py 両方において，以下で import 可能

from config import DISCORD_SERVER_KEY

[smngs]

• DI に関しては https://github.com/smngs/da-bot/issues/31 で Issue を建てました．
  • 別 PR にて (時間がある時に) 対処予定．