text: """MIT License
  
  Copyright (c) 2019-2021 PythonistaGuild
  
  Permission is hereby granted, free of charge, to any person obtaining a copy
  of this software and associated documentation files (the "Software"), to deal
  in the Software without restriction, including without limitation the rights
  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  copies of the Software, and to permit persons to whom the Software is
  furnished to do so, subject to the following conditions:
  
  The above copyright notice and this permission notice shall be included in all
  copies or substantial portions of the Software.
  
  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  SOFTWARE.
  """
  from __future__ import annotations
  
  from typing import (
      TYPE_CHECKING,
      ClassVar,
      List,
      Literal,
      Optional,
      Type,
      TypeVar,
      Union,
      overload,
  )
  
  import yarl
  from discord.ext import commands
  
  from .abc import *
  from .pool import Node, NodePool
  from .utils import MISSING
  
  if TYPE_CHECKING:
      from .ext import spotify
  
  
  __all__ = (
      "Track",
      "SearchableTrack",
      "YouTubeTrack",
      "YouTubeMusicTrack",
      "SoundCloudTrack",
      "YouTubePlaylist",
      "PartialTrack",
      "LocalTrack"
  )
  
  ST = TypeVar("ST", bound="SearchableTrack")
  
  
  class Track(Playable):
      """A Lavalink track object.
  
      Attributes
      ------------
      id: str
          The Base64 Track ID, can be used to rebuild track objects.
      info: Dict[str, Any]
          The raw track info.
      title: str
          The track title.
      identifier: Optional[str]
          The tracks identifier. could be None depending on track type.
      length:
          The duration of the track in seconds.
      duration:
          Alias to ``length``.
      uri: Optional[str]
          The tracks URI. Could be None.
      author: Optional[str]
          The author of the track. Could be None
      """
  
      def __init__(self, id: str, info: dict):
          super().__init__(id, info)
          self.title: str = info["title"]
          self.identifier: Optional[str] = info.get("identifier")
          self.uri: Optional[str] = info.get("uri")
          self.author: Optional[str] = info.get("author")
  
          self._stream: bool = info.get("isStream")  # type: ignore
          self._dead: bool = False
  
      def __str__(self) -> str:
          return self.title
  
      def is_stream(self) -> bool:
          """Indicates whether the track is a stream or not."""
          return self._stream
  
  
  class SearchableTrack(Track, Searchable):
  
      _search_type: ClassVar[str]
  
      @overload
      @classmethod
      async def search(
              cls: Type[ST],
              query: str,
              *,
              node: Node = ...,
              type: spotify.SpotifySearchType = ...,
              return_first: Literal[False] = ...,
      ) -> List[ST]:
          ...
  
      @overload
      @classmethod
      async def search(
              cls: Type[ST],
              query: str,
              *,
              node: Node = ...,
              type: spotify.SpotifySearchType = ...,
              return_first: Literal[True] = ...,
      ) -> Optional[ST]:
          ...
  
      @overload
      @classmethod
      async def search(
          cls: Type[ST],
          query: str,
          *,
          node: Node = ...,
          return_first: Literal[False] = ...,
      ) -> List[ST]:
          ...
  
      @overload
      @classmethod
      async def search(
          cls: Type[ST],
          query: str,
          *,
          node: Node = ...,
          return_first: Literal[True] = ...,
      ) -> Optional[ST]:
          ...
  
      @classmethod
      async def search(
          cls: Type[ST],
              query: str,
              *,
              type: spotify.SpotifySearchType = None,
              node: Node = MISSING,
              return_first: bool = False
      ) -> Union[Optional[ST], List[ST]]:
          """|coro|
  
          Search for tracks with the given query.
  
          Parameters
          ----------
          query: str
              The song to search for.
          spotify_type: Optional[:class:`spotify.SpotifySearchType`]
              An optional enum value to use when searching with Spotify.
          node: Optional[:class:`wavelink.Node`]
              An optional Node to use to make the search with.
          return_first: Optional[bool]
              An optional bool which when set to True will return only the first track found. Defaults to False.
              Use this as True, when searching with LocalTrack.
  
          Returns
          -------
          Union[Optional[Track], List[Track]]
          """
          if node is MISSING:
              node = NodePool.get_node()
  
          check = yarl.URL(query)
  
          if str(check.host) == 'youtube.com' or str(check.host) == 'www.youtube.com' and check.query.get("list") or \
                  cls._search_type == 'ytpl':
  
              tracks = await node.get_playlist(cls=YouTubePlaylist, identifier=query)
          elif cls._search_type == 'local':
              tracks = await node.get_tracks(cls, query)
          else:
              tracks = await node.get_tracks(cls, f"{cls._search_type}:{query}")
  
          if return_first:
              if not tracks:
                  return None
              return tracks[0]
  
          return tracks
  
      @classmethod
      async def convert(cls: Type[ST], ctx: commands.Context, argument: str) -> ST:
          """Converter which searches for and returns the first track.
  
          Used as a type hint in a discord.py command.
          """
          if argument.startswith('local:'):
              argument.replace('local:', '')
  
          results = await cls.search(argument)
  
          if not results:
              raise commands.BadArgument("Could not find any songs matching that query.")
  
          if isinstance(cls, YouTubePlaylist):
              return results  # type: ignore
  
          return results[0]
  
  
  class YouTubeTrack(SearchableTrack):
      """A track created using a search to YouTube."""
  
      _search_type: ClassVar[str] = "ytsearch"
  
      @property
      def thumbnail(self) -> str:
          """The URL to the thumbnail of this video."""
          return f"https://img.youtube.com/vi/{self.identifier}/maxresdefault.jpg"
  
      thumb = thumbnail
  
  
  class YouTubeMusicTrack(YouTubeTrack):
      """A track created using a search to YouTube Music."""
  
      _search_type: ClassVar[str] = "ytmsearch"
  
  
  class SoundCloudTrack(SearchableTrack):
      """A track created using a search to SoundCloud."""
  
      _search_type: ClassVar[str] = "scsearch"
  
  
  class YouTubePlaylist(SearchableTrack, Playlist):
      """Represents a Lavalink YouTube playlist object.
  
      Attributes
      ----------
      name: str
          The name of the playlist.
      tracks: :class:`YouTubeTrack`
          The list of :class:`YouTubeTrack` in the playlist.
      selected_track: Optional[int]
          The selected video in the playlist. This could be ``None``.
      """
  
      _search_type: ClassVar[str] = "ytpl"
  
      def __init__(self, data: dict):
          self.tracks: List[YouTubeTrack] = []
          self.name: str = data["playlistInfo"]["name"]
  
          self.selected_track: Optional[int] = data["playlistInfo"].get("selectedTrack")
          if self.selected_track is not None:
              self.selected_track = int(self.selected_track)
  
          for track_data in data["tracks"]:
              track = YouTubeTrack(track_data["track"], track_data["info"])
              self.tracks.append(track)
  
  
  class LocalTrack(SearchableTrack):
      """Represents a Lavalinkl Local Track Object."""
  
      _search_type: ClassVar[str] = 'local'
  
  
  class PartialTrack(Searchable, Playable):
      """A PartialTrack object that searches for the given query at playtime.
  
      Parameters
      ----------
      query: str
          The query to search for at playtime.
      node: Optional[:class:`wavelink.Node`]
          An optional node to use when searching. Defaults to the best node.
      cls: Optional[:class:`SearchableTrack`]
          An optional Non-Partial Track object to use when searching.
  
  
      .. warning::
  
          This object will only search for the given query at playtime.
          Full track information will be missing until it has been searched.
      """
  
      def __init__(self,
                   *,
                   query: str,
                   node: Optional[Node] = MISSING,
                   cls: Optional[SearchableTrack] = YouTubeTrack):
          self.query = query
          self.title = query
          self._node = node
          self._cls = cls
  
          if not issubclass(cls, SearchableTrack):
              raise TypeError(f"cls parameter must be of type {SearchableTrack!r} not {cls!r}")
  
      async def _search(self):
          node = self._node
          if node is MISSING:
              node = NodePool.get_node()
  
          tracks = await self._cls.search(query=self.query, node=node)
  
          return tracks[0]
  
      async def search(self):
          raise NotImplementedError
  