feat: cache voice channel info from gateway

[plun1331]

Summary

https://docs.discord.com/developers/change-log#voice-channel-status-and-start-time-documentation

• Adds support for Request Channel Info
• Adds a flag to Client to automatically request and cache channel info at startup (cache_channel_info, default False)
• Adds voice_channel_start_time_update event
• Adds voice_start_time to voice channels.
• Reworks how status is stored on voice channels.

Information

• This PR fixes an issue.
• This PR adds something new (e.g. new method or parameters).
• This PR is a breaking change (e.g. methods or parameters removed/renamed).
• This PR is not a code change (e.g. documentation, README, typehinting,
  examples, ...).

Checklist

• I have searched the open pull requests for duplicates.
• If code changes were made then they have been tested.
  • I have updated the documentation to reflect the changes.
• If type: ignore comments were used, a comment is also left explaining why.
• I have updated the changelog to include these changes.
• AI Usage has been disclosed.
  • If AI has been used, I understand fully what the code does

[pycord-app]

Thanks for opening this pull request!
Please make sure you have read the Contributing Guidelines and Code of Conduct.

This pull request can be checked-out with:

git fetch origin pull/3210/head:pr-3210
git checkout pr-3210

This pull request can be installed with:

pip install git+https://github.com/Pycord-Development/pycord@refs/pull/3210/head

[plun1331]

Test code I've been using:

import asyncio

import discord
import logging

logging.basicConfig(level=logging.DEBUG)

client = discord.Client(cache_channel_info=True, intents=discord.Intents.all(), chunk_guilds_at_startup=False)


@client.event
async def on_ready():
    while True:
        for channel in client.get_all_channels():
            if hasattr(channel, "voice_start_time") and channel.voice_start_time:
                print("rec", getattr(channel, "status", ...), channel.voice_start_time)


@client.event
async def on_voice_channel_status_update(channel, old, new):
    print("status", channel.status, channel.voice_start_time, old, new)


@client.event
async def on_voice_channel_start_time_update(channel, old, new):
    print("start", channel.status, channel.voice_start_time, old, new)


client.run("token")

[plun1331]

Needs input: API for ChannelInfo and Guild.channel_info()

[vmphase]

datetime.UTC was added in Python 3.11 as an alias for datetime.timezone.utc.
Workflow tests don't catch this critical issue because property access is lazy.

Suggested change

	return datetime.datetime.fromtimestamp(self._voice_start_time, tz=datetime.UTC)
	return datetime.datetime.fromtimestamp(
	self._voice_start_time,
	tz=datetime.timezone.utc,
	)

[vmphase]

datetime.UTC was added in Python 3.11 as an alias for datetime.timezone.utc.
Workflow tests don't catch this critical issue because attribute access is lazy.

Suggested change

	datetime.datetime.fromtimestamp(data["voice_start_time"], tz=datetime.UTC)
	datetime.datetime.fromtimestamp(
	data["voice_start_time"],
	tz=datetime.timezone.utc,
	)

[vmphase]

I don't see the _connection._request_channel_info flag being reset to False anywhere.

[vmphase]

Unused import.

Suggested change

from .abc import Snowflake