21bad7af51
All checks were successful
Ruff Lint / lint (pull_request) Successful in 12s
Closes #146 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
89 lines
2.5 KiB
Python
89 lines
2.5 KiB
Python
"""
|
|
Refractor Tier Completion Notifications
|
|
|
|
Builds and sends Discord embeds when a player completes a refractor tier
|
|
during post-game evaluation. Each tier-up event gets its own embed.
|
|
|
|
Notification failures are non-fatal: the send is wrapped in try/except so
|
|
a Discord API hiccup never disrupts game flow.
|
|
"""
|
|
|
|
import logging
|
|
|
|
import discord
|
|
|
|
from helpers.refractor_constants import TIER_NAMES, NOTIF_TIER_COLORS as TIER_COLORS
|
|
|
|
logger = logging.getLogger("discord_app")
|
|
|
|
FOOTER_TEXT = "Paper Dynasty Refractor"
|
|
|
|
|
|
def build_tier_up_embed(tier_up: dict) -> discord.Embed:
|
|
"""Build a Discord embed for a tier-up event.
|
|
|
|
Parameters
|
|
----------
|
|
tier_up:
|
|
Dict with keys: player_name, old_tier, new_tier, current_value, track_name.
|
|
|
|
Returns
|
|
-------
|
|
discord.Embed
|
|
A fully configured embed ready to send to a channel.
|
|
"""
|
|
player_name: str = tier_up["player_name"]
|
|
new_tier: int = tier_up["new_tier"]
|
|
track_name: str = tier_up["track_name"]
|
|
|
|
tier_name = TIER_NAMES.get(new_tier, f"Tier {new_tier}")
|
|
color = TIER_COLORS.get(new_tier, 0x2ECC71)
|
|
|
|
if new_tier >= 4:
|
|
# Superfractor — special title and description.
|
|
embed = discord.Embed(
|
|
title="SUPERFRACTOR!",
|
|
description=(
|
|
f"**{player_name}** has reached maximum refractor tier on the **{track_name}** track"
|
|
),
|
|
color=color,
|
|
)
|
|
else:
|
|
embed = discord.Embed(
|
|
title="Refractor Tier Up!",
|
|
description=(
|
|
f"**{player_name}** reached **Tier {new_tier} ({tier_name})** on the **{track_name}** track"
|
|
),
|
|
color=color,
|
|
)
|
|
|
|
embed.set_footer(text=FOOTER_TEXT)
|
|
return embed
|
|
|
|
|
|
async def notify_tier_completion(
|
|
channel: discord.abc.Messageable, tier_up: dict
|
|
) -> None:
|
|
"""Send a tier-up notification embed to the given channel.
|
|
|
|
Non-fatal: any exception during send is caught and logged so that a
|
|
Discord API failure never interrupts game evaluation.
|
|
|
|
Parameters
|
|
----------
|
|
channel:
|
|
A discord.abc.Messageable (e.g. discord.TextChannel).
|
|
tier_up:
|
|
Dict with keys: player_name, old_tier, new_tier, current_value, track_name.
|
|
"""
|
|
try:
|
|
embed = build_tier_up_embed(tier_up)
|
|
await channel.send(embed=embed)
|
|
except Exception as exc:
|
|
logger.error(
|
|
"Failed to send tier-up notification for %s (tier %s): %s",
|
|
tier_up.get("player_name", "unknown"),
|
|
tier_up.get("new_tier"),
|
|
exc,
|
|
)
|