Wavelink

This release adds two main additional features:

- [on_wavelink_inactive_player](https://wavelink.dev/en/latest/wavelink.html#wavelink.on_wavelink_inactive_player)
- [Player.inactive_timeout](https://wavelink.dev/en/latest/wavelink.html#wavelink.Player.inactive_timeout)
- [Queue (Redesign)](https://wavelink.dev/en/latest/wavelink.html#queue)

**Documentation:**
https://wavelink.dev

**Support:**
[Discord Server](https://discord.gg/RAKc3HF)


> [!CAUTION]
> You can no longer use a **BETA** version of Lavalink from version **3.1.0**. Please upgrade your Lavalink to a stable version 4+.


Additions

**Events:**
- [on_wavelink_inactive_player()](https://wavelink.dev/en/latest/wavelink.html#wavelink.on_wavelink_inactive_player)
_{Called when the Players `inactive_timeout` expires. Useful for disconnecting the bot after a timeframe of no activity.}

**Utils:**
- [Playlist.extras](https://wavelink.dev/en/latest/wavelink.html#wavelink.Playlist.extras)
_{Similar to `Playable.extras`, but this applies `Playable.extras` to each track in the playlist **and** on the `Playlist` itself.}
- [Playable.raw_data](https://wavelink.dev/en/latest/wavelink.html#wavelink.Playable.raw_data)
_{The raw payload received from lavalink. You can use this payload to re-build a track later.}


Changes

- [Queue (Redesign)](https://wavelink.dev/en/latest/wavelink.html#queue)
- ++ [Queue.swap()](https://wavelink.dev/en/latest/wavelink.html#wavelink.Queue.swap)
- ++ [Queue.peek()](https://wavelink.dev/en/latest/wavelink.html#wavelink.Queue.peek)
- ++ [Queue.index()](https://wavelink.dev/en/latest/wavelink.html#wavelink.Queue.index)
- ++ [Queue.remove()](https://wavelink.dev/en/latest/wavelink.html#wavelink.Queue.remove)
- ! ! [Queue.delete()](https://wavelink.dev/en/latest/wavelink.html#wavelink.Queue.delete)
- ++ [Queue.get_at()](https://wavelink.dev/en/latest/wavelink.html#wavelink.Queue.get_at)
- ++ [Queue.put_at()](https://wavelink.dev/en/latest/wavelink.html#wavelink.Queue.put_at)
- ++ [Queue.count](https://wavelink.dev/en/latest/wavelink.html#wavelink.Queue.count)
- ++ [Queue.is_empty](https://wavelink.dev/en/latest/wavelink.html#wavelink.Queue.is_empty)
- ++ [Queue.loaded](https://wavelink.dev/en/latest/wavelink.html#wavelink.Queue.loaded)

The queue has been redesigned to be more friendly for wavelink use. Internally the queue now uses a `list` instead of a `deque`. QoL methods and properties have been added to make it easier to manage and use the queue. Please see the documentation for more information and special ways of using the queue. The queue is backwards compatible minus `Queue.delete` which is now **not** asynchronous.


QoL
- Updated the yarl dependency for better support on `Python 3.12+`

This release adds some QoL features that have been frequently requested, and adds support for plugin events.

**Documentation:**
https://wavelink.dev

**Support:**
[Discord Server](https://discord.gg/RAKc3HF)


> [!CAUTION]
> You can no longer use a **BETA** version of Lavalink on this release. Please upgrade your Lavalink to a stable version 4+.


Additions

**Playable:**
- [Playable.extras](https://wavelink.dev/en/latest/wavelink.html#wavelink.Playable.extras)
_{Updates to support `userData` field in Lavalink.}

**Node:**
- [Node.fetch_info](https://wavelink.dev/en/latest/wavelink.html#wavelink.Node.fetch_info)
- [Node.fetch_stats](https://wavelink.dev/en/latest/wavelink.html#wavelink.Node.fetch_stats)
- [Node.fetch_version](https://wavelink.dev/en/latest/wavelink.html#wavelink.Node.fetch_version)
- [Node.fetch_player_info](https://wavelink.dev/en/latest/wavelink.html#wavelink.Node.fetch_player_info)
- [Node.fetch_players](https://wavelink.dev/en/latest/wavelink.html#wavelink.Node.fetch_players)
_{All the above endpoints have been made public.}

> [!IMPORTANT]
> [Node.fetch_player_info](https://wavelink.dev/en/latest/wavelink.html#wavelink.Node.fetch_player_info) and [Node.fetch_players](https://wavelink.dev/en/latest/wavelink.html#wavelink.Node.fetch_players) are not the same as [Node.get_player](https://wavelink.dev/en/latest/wavelink.html#wavelink.Node.get_player). Please read the documentation before using these endpoints for more details.

**Payloads:**
- [StatsResponsePayload](https://wavelink.dev/en/latest/wavelink.html#wavelink.StatsResponsePayload)
- [PlayerStatePayload](https://wavelink.dev/en/latest/wavelink.html#wavelink.PlayerStatePayload)
- [VoiceStatePayload](https://wavelink.dev/en/latest/wavelink.html#wavelink.VoiceStatePayload)
- [PlayerResponsePayload](https://wavelink.dev/en/latest/wavelink.html#wavelink.PlayerResponsePayload)
- [GitResponsePayload](https://wavelink.dev/en/latest/wavelink.html#wavelink.GitResponsePayload)
- [VersionResponsePayload](https://wavelink.dev/en/latest/wavelink.html#wavelink.VersionResponsePayload)
- [PluginResponsePayload](https://wavelink.dev/en/latest/wavelink.html#wavelink.PluginResponsePayload)
- [InfoResponsePayload](https://wavelink.dev/en/latest/wavelink.html#wavelink.InfoResponsePayload)
- [ExtraEventPayload](https://wavelink.dev/en/latest/wavelink.html#wavelink.ExtraEventPayload)
<sub>These payloads correspond to all the data received in the above endpoints, minus [ExtraEventPayload](https://wavelink.dev/en/latest/wavelink.html#wavelink.ExtraEventPayload) which will be received in the [on_wavelink_extra_event](https://wavelink.dev/en/latest/wavelink.html#wavelink.on_wavelink_extra_event) event.

**Events:**
- [on_wavelink_extra_event](https://wavelink.dev/en/latest/wavelink.html#wavelink.on_wavelink_extra_event)
_{An event fired when an event that is unknown/unhandled by default is received, usually from Lavalink Plugins.}

> [!WARNING]
> Make sure you know the source of your event when using [on_wavelink_extra_event](https://wavelink.dev/en/latest/wavelink.html#wavelink.on_wavelink_extra_event). Lavalink **does not** provide this information by default.

**Utils:**
- [ExtrasNamespace](https://wavelink.dev/en/latest/wavelink.html#wavelink.ExtrasNamespace)
_{`ExtrasNamespace` is a container class that holds all the information sent to Lavalink via the `userData` field which can be set by passing a `dict` of `str` keys to `Any` value (Must be convertible to JSON) to [Playable.extras](https://wavelink.dev/en/latest/wavelink.html#wavelink.Playable.extras). Please see documentation for more details.}


Changes
Internally Wavelink now sends a different payload to Lavalink when playing a track or skipping. This is inline with Lavalink changes. Please upgrade your Lavalink to a stable version 4+ if you are currently on a beta version.

Version 3 🎉

This is the initial release for version 3!

Changes are too big to go over here so please see:
https://wavelink.dev/en/latest/migrating.html

Documentation:
https://wavelink.dev

Examples:
https://github.com/PythonistaGuild/Wavelink/tree/main/examples

Help and Support:
https://discord.gg/RAKc3HF

Issues:
https://github.com/PythonistaGuild/Wavelink/issues

Installing:
https://github.com/PythonistaGuild/Wavelink#installation

Spotify Support is via LavaSrc:
https://github.com/topi314/LavaSrc

**Key Notes:**
- Pyright Strict
- Lavalink v4+
- Discord.py 2.0.1+
- Python 3.10+


Thank you to everyone who helped out during the development and beta phases <3
Special Thanks to:
chillymosh
AbstractUmbra
Sachaa-Thanasius

Version **3** Release Candidate: **1**.

This is the first release candidate for Wavelink **3**.

Please see:
[Docs](https://wavelink.dev/en/feature-v3/)
[Migrating](https://wavelink.dev/en/feature-v3/migrating.html)

You can install this release via:
`pip install -U wavelink --pre`

Final release for the version 2 lifecycle!
Please consider moving on to version 3👋

**Additions:**
- Check to the queue to allow adding `SoundCloudPlaylist` directly.

Minor fix for auto_queue where it was raising NotImplementedError on an equality check.

v.2.6.2
Version **v.2.6.2**

This version fixes the issue with auto_play queue raising errors when mixing YouTubeTracks and SpotifyTracks.

- `__hash__` has been added to SpotifyTrack
- `raise NotImplementedError` in `__eq__` for Playable and SpotifyTrack