# Linux/macOS
python3 -m pip install -U py-cord

# Windows
py -3 -m pip install -U py-cord

# Linux/macOS
python3 -m pip install -U dotenv

# Windows
py -3 -m pip install -U dotenv

import discord 
import os
from dotenv import load_dotenv

load_dotenv()
TOKEN = os.getenv("DISCORD_TOKEN")

bot = discord.Bot(intents=discord.Intents.all())

if __name__ == "__main__":
    bot.run(TOKEN)

async def helloworld():
	print("Hello")
    
    // time consuming tasks
    await asyncio.sleep(1)
    
    print("World")

asyncio.run(helloworld())

@bot.event
async def on_ready():
	# your code

@bot.event
async def on_ready():
	print("The bot is ready.")

@bot.event
async def on_member_join(member: discord.Member):
	# your code

@bot.event
async def on_member_join(member: discord.Member):
    channel = bot.get_channel(1442049122986229843)
    await channel.send(f"welcome {member.mention}")

@bot.event
async def on_message(message: discord.Message):
    await message.channel.send("shut up")

@bot.event
async def on_message(message: discord.Message):
    if message.author == bot.user:
        return
    await message.channel.send("shut up")
    # await message.reply("shut up")

@bot.command()
async def hello(ctx):
    await ctx.send("Hello!")

@bot.command()
async def hello(ctx, name: str):
    await ctx.send(f"Hello, {name}!")

@hello.error
async def hello_error(ctx, err):
    if isinstance(err, commands.MissingRequiredArgument):
          await ctx.send("missing args")

bot = commands.Bot(
    command_prefix="!", 
    intents=discord.Intents.all()
)

@bot.slash_command()
async def ping(ctx):
    await ctx.respond("pong")

@bot.slash_command(name="ping")
async def ping_command(ctx):
    await ctx.respond("pong")

def f(name="Andy"):
	print(f"Hello {name}!")
    
f("Kevin") // "Hello Kevin!"

f() // "Hello Andy!"

def f(name=None):
	if name is None:
    	name = "Andy"
	print(f"Hello {name}!")
    
f("Kevin") // "Hello Kevin!"

f() // "Hello Andy!"

@bot.slash_command(name="ping")
async def ping_command(
    ctx,
    text: str              
):

@bot.slash_command(name="ping")
async def ping_command(
    ctx,
    text: str = "hi"
):

@bot.slash_command(name="ping")
async def ping_command(
    ctx,
    text: Option(str, "description")
):

@bot.slash_command(name="ping")
async def ping_command(
    ctx,
    text: Option(str, "description") = "hi"
):

color: Option(str, choices=["red", "blue", "green"])

color: Option(str, "choose!", choices=["red", "blue", "green"])

embed = discord.Embed(
	title: str, 
    description: str, 
    url: str, 
    color: discord.Color, 
    timestamp: datetime.datetime
)

embed = discord.Embed(
    title="Title",
    description="Description",
    color=discord.Color.red(),
    url="https://github.com/",
    timestamp=datetime.datetime.now(datetime.UTC)
)

discord.Color.random()
discord.Color.red()
discord.Color.from_rgb(0xAA, 0, 0)

discord.Color.from_str("0xAA0000")
discord.Color.from_str("#AA0000")
discord.Color.from_str("0x#AA0000")

embed.set_thumbnail(url: str)

embed.set_thumbnail(url="https://...")

file = discord.File("file.png", "filename.png")

embed.set_thumbnail(url="attachment://filename.png")

await ctx.respond(embed=embed, file=file)

embed.set_author(name: str, url: str, icon_url: str)

embed.set_image(url: str)

embed.set_footer(text: str, icon_url: str)

embed.add_field(name: str, value: str, inline: bool)

await ctx.respond(embed=embed)

await ctx.respond(embeds = [e1, e2])

class TestView(discord.ui.View):
    @discord.ui.button(label="Click Here", style=discord.ButtonStyle.primary)
    async def click_me(self, button: discord.ui.Button, interaction: discord.Interaction):
        # 行為
        await interaction.response.send_message("ok.", ephemeral=True)

@bot.event
async def on_message(message: discord.Message):
    if message.author == bot.user:
        return

    if message.content == "hi":
         await message.channel.send(content="This is a Button", view=TestView())