GitLocker: The Coding Marketplace

Description:

kweathercord 0.1.3

kweathercord은 대한민국 기상청 API을 이용하여 대한민국의 날씨를 Embed, Button, Select Menu를 이용하여 확인하는 간단한 도구입니다.
초단기실황, 초단기예보, 단기예보를 지원합니다.
NOAA 알고리즘을 통해 조회하시는 지역의 일출, 일몰 시간에 맞추어 아이콘이 조정됩니다.
코드 한 줄만으로 모든 게 알아서 이루어집니다.
Discord.py 관련 오류 이외의 오류는 알아서 핸들링합니다.

구현 모습

파이썬 요구 사항

Python 3.8 이상에서 작동합니다.

의존 패키지

Discord.py (2.4.0 이상)
RapidFuzz

설치 방법

설치 시

pip install -U kweather-cord

업그레이드 시

pip install kweather-cord --upgrade

제한 사항

당일 최저/최고 온도는 명시적으로 제공하지 않으나 초단기예보 및 단기예보에서 각각 06시와 15시를 최저/최고온도로 지정하고 있습니다. 초단기실황은 지원하지 않습니다.
이 패키지는 discord.py의 app_commands 모듈(Slash command)의 사용을 권장합니다.
또, 안정적인 동작을 위해, defer가 적용되어 있습니다. Error Handling 시, edit_original_response나 followup.send 메소드 사용을 고려해주십시오.

사용 예시

1. bot.py
from aiohttp import ClientSession
from discord.ext import commands
from kweathercord import KoreaForecastForDiscord

import discord
import os

initial_extensions = (
'cogs.weather',
)

class Test(commands.Bot):
def __init__(self):
intents = discord.Intents.default()
super().__init__(
command_prefix=None,
intents=intents
)

async def setup_hook(self) -> None:
# aiohttp 사용을 위한 선언 (라이브러리 한계로 인해 동기 함수에서 선언할 수 없습니다.)
# Kweathercord는 clientsession을 선언하지 않아도, 라이브러리에서 핸들링 할 수 있습니다.
self.session = ClientSession()
self.weather = KoreaForecastForDiscord(self, self.session)
# 기상청 API 키를 넣어주세요.
# self.weather.api_key = '여기에 기상청 api키를 넣거나, .env로부터 api 키를 얻어내세요.'

for extension in initial_extensions:
try:
await self.load_extension(extension)
except Exception:
raise
# await self.tree.sync()

async def on_ready(self):
...
# on_ready에서 사용해도 되나, 이 함수에서 복잡한 작업은 권장되지 않습니다.
# 따라서, setup_hook 함수 내에서 이루어지는 것이 좋습니다.

2. cog.weather
from discord import app_commands, Interaction
from discord.ext import commands
from typing import Literal

from bot_example import Test

class Weather(commands.Cog):
def __init__(self, bot : Test) -> None:
self.bot = bot

# commands.Context는 가급적 사용하지 않습니다.
@app_commands.command(name='날씨', description='지역의 날씨를 찾아보세요')
@app_commands.describe(
where='어느 지역의 날씨를 검색하실 건가요?',
period='어떤 검색 방식을 이용하실 건가요?'
)
@app_commands.rename(where='지역', period='기간')
async def search(self, interaction : Interaction, where : str, period : Literal['지금', '향후 6시간', '향후 3~4일']):
try:
if period == '지금':
method = '초단기실황'
elif period == '향후 3~4일':
method = '단기예보'
else:
method = '초단기예보'
await self.bot.weather.get_weather(interaction, method=method, city=where, hidden=True)

except Exception as e:
# interaction.response.defer를 사용하기 때문에,
# 오류 발생 시, Interaction.Followup 이나 InteractionMessage만 허용됩니다.
await interaction.followup.send(e)

# use_area_list가 true이면 autocomplete 사용 시 지역 리스트를 불러올 수 있습니다.
@search.autocomplete('where')
async def search_ac(self, interaction : Interaction, current : str):
result = [
app_commands.Choice(name=choice, value=choice)
for choice in self.bot.weather.area_list
if current.replace(' ', '') in choice.replace(' ', '')
]
# 디스코드 한계로 인해 선택 옵션은 최대 25개까지 입니다.
return result[:25]

async def setup(bot : Test):
await bot.add_cog(Weather(bot))

참고 링크

대한민국 기상청 API