Remove and shorten comments

This commit is contained in:
2022-03-18 01:09:14 +01:00
parent 1029eb2350
commit c876c47b9e

View File

@ -29,15 +29,17 @@ slash = SlashCommand(bot, sync_commands=True)
def calc_countdown(job) -> str: def calc_countdown(job) -> str:
"""Get trigger time from a reminder and calculate how many days, hours and minutes till trigger. """Get trigger time from a reminder and calculate how many days,
hours and minutes till trigger.
Days/Minutes will not be included if 0. Days/Minutes will not be included if 0.
Args: Args:
job ([type]): The job. Can be cron, interval or normal. #TODO: Find type job ([type]): The job. Can be cron, interval or normal.
Returns: Returns:
str: Returns days, hours and minutes till reminder. Returns "Failed to calculate time" if no job is found. str: Returns days, hours and minutes till reminder. Returns
"Failed to calculate time" if no job is found.
""" """
trigger_time = ( trigger_time = (
job.trigger.run_date if type(job.trigger) is DateTrigger else job.next_run_time job.trigger.run_date if type(job.trigger) is DateTrigger else job.next_run_time
@ -47,7 +49,8 @@ def calc_countdown(job) -> str:
if trigger_time is None: if trigger_time is None:
return "Failed to calculate time" return "Failed to calculate time"
# Get time and date the job will run and calculate how many days, hours and seconds. # Get time and date the job will run and calculate how many days,
# hours and seconds.
countdown = trigger_time - datetime.datetime.now(tz=pytz.timezone(config_timezone)) countdown = trigger_time - datetime.datetime.now(tz=pytz.timezone(config_timezone))
days, hours, minutes = ( days, hours, minutes = (
@ -97,7 +100,6 @@ async def on_slash_command_error(ctx: SlashContext, ex: Exception):
@bot.event @bot.event
async def on_ready(): async def on_ready():
"""Log our bots username on start."""
logging.info(f"Logged in as {bot.user.name}") logging.info(f"Logged in as {bot.user.name}")
@ -208,8 +210,9 @@ async def command_modify(ctx: SlashContext, time_or_message: str):
"TO_TIMEZONE": f"{config_timezone}", "TO_TIMEZONE": f"{config_timezone}",
}, },
) )
# FIXME: Fix mypy error remove_timezone_from_date = parsed_date.strftime(
remove_timezone_from_date = parsed_date.strftime("%Y-%m-%d %H:%M:%S") # type: ignore[union-attr] "%Y-%m-%d %H:%M:%S"
)
job = scheduler.reschedule_job( job = scheduler.reschedule_job(
job_from_dict, run_date=remove_timezone_from_date job_from_dict, run_date=remove_timezone_from_date
@ -273,7 +276,8 @@ async def remind_remove(ctx: SlashContext):
channel_name = bot.get_channel(int(channel_id)) channel_name = bot.get_channel(int(channel_id))
message = job.kwargs.get("message") message = job.kwargs.get("message")
# Only normal reminders have trigger.run_date, cron and interval has next_run_time # Only normal reminders have trigger.run_date, cron and
# interval has next_run_time
if type(job.trigger) is DateTrigger: if type(job.trigger) is DateTrigger:
trigger_time = job.trigger.run_date trigger_time = job.trigger.run_date
else: else:
@ -526,7 +530,7 @@ async def remind_resume(ctx: SlashContext):
), ),
create_option( create_option(
name="message_date", name="message_date",
description="Time and/or date when you want to get reminded. Works only with the Gregorian calendar.", description="Time and/or date when you want to get reminded.",
option_type=SlashCommandOptionType.STRING, option_type=SlashCommandOptionType.STRING,
required=True, required=True,
), ),
@ -562,8 +566,7 @@ async def remind_add(
channel_id = different_channel.id if different_channel else ctx.channel.id channel_id = different_channel.id if different_channel else ctx.channel.id
# FIXME: Fix mypy error run_date = parsed_date.strftime("%Y-%m-%d %H:%M:%S")
run_date = parsed_date.strftime("%Y-%m-%d %H:%M:%S") # type: ignore[union-attr]
reminder = scheduler.add_job( reminder = scheduler.add_job(
send_to_discord, send_to_discord,
run_date=run_date, run_date=run_date,
@ -699,18 +702,18 @@ async def remind_cron(
Args: Args:
ctx (SlashContext): Context. The meta data about the slash command. ctx (SlashContext): Context. The meta data about the slash command.
message_reason (str): The message the bot should send everytime cron job triggers. message_reason (str): The message the bot should send everytime cron job triggers.
year (int, optional): 4-digit year. Defaults to None. year (int, optional): 4-digit year.
month (int, optional): Month (1-12). Defaults to None. month (int, optional): Month (1-12).
day (int, optional): Day of month (1-31). Defaults to None. day (int, optional): Day of month (1-31).
week (int, optional): ISO week (1-53). Defaults to None. week (int, optional): ISO week (1-53).
day_of_week (str, optional): Number or name of weekday (0-6 or mon,tue,wed,thu,fri,sat,sun). Defaults to None. day_of_week (str, optional): Number or name of weekday (0-6 or mon,tue,wed,thu,fri,sat,sun).
hour (int, optional): Hour (0-23). Defaults to None. hour (int, optional): Hour (0-23).
minute (int, optional): Minute (0-59). Defaults to None. minute (int, optional): Minute (0-59).
second (int, optional): Second (0-59). Defaults to None. second (int, optional): Second (0-59).
start_date (str, optional): Earliest possible date/time to trigger on (inclusive). Defaults to None. start_date (str, optional): Earliest possible date/time to trigger on (inclusive).
end_date (str, optional): Latest possible date/time to trigger on (inclusive). Defaults to None. end_date (str, optional): Latest possible date/time to trigger on (inclusive).
timezone (str, optional): Time zone to use for the date/time calculations Defaults to scheduler timezone. timezone (str, optional): Time zone to use for the date/time calculations Defaults to scheduler timezone.
jitter (int, optional): Delay the job execution by jitter seconds at most. Defaults to None. jitter (int, optional): Delay the job execution by jitter seconds at most.
https://apscheduler.readthedocs.io/en/stable/modules/triggers/cron.html#module-apscheduler.triggers.cron https://apscheduler.readthedocs.io/en/stable/modules/triggers/cron.html#module-apscheduler.triggers.cron
""" """
@ -844,10 +847,10 @@ async def remind_interval(
hours (int, optional): Number of hours to wait. Defaults to 0. hours (int, optional): Number of hours to wait. Defaults to 0.
minutes (int, optional): Number of minutes to wait. Defaults to 0. minutes (int, optional): Number of minutes to wait. Defaults to 0.
seconds (int, optional): Number of seconds to wait. Defaults to 0. seconds (int, optional): Number of seconds to wait. Defaults to 0.
start_date (str, optional): Starting point for the interval calculation. Defaults to None. start_date (str, optional): Starting point for the interval calculation.
end_date (str, optional): Latest possible date/time to trigger on. Defaults to None. end_date (str, optional): Latest possible date/time to trigger on.
timezone (str, optional): Time zone to use for the date/time calculations. Defaults to None. timezone (str, optional): Time zone to use for the date/time calculations.
jitter (int, optional): Delay the job execution by jitter seconds at most. Defaults to None. jitter (int, optional): Delay the job execution by jitter seconds at most.
""" """
channel_id = different_channel.id if different_channel else ctx.channel.id channel_id = different_channel.id if different_channel else ctx.channel.id