LeechCraft  0.6.70-13605-g8cd066ad6a
Modular cross-platform feature rich live environment.
ihypesprovider.h
Go to the documentation of this file.
1 /**********************************************************************
2  * LeechCraft - modular cross-platform feature rich internet client.
3  * Copyright (C) 2006-2014 Georg Rudoy
4  *
5  * Boost Software License - Version 1.0 - August 17th, 2003
6  *
7  * Permission is hereby granted, free of charge, to any person or organization
8  * obtaining a copy of the software and accompanying documentation covered by
9  * this license (the "Software") to use, reproduce, display, distribute,
10  * execute, and transmit the Software, and to prepare derivative works of the
11  * Software, and to permit third-parties to whom the Software is furnished to
12  * do so, all subject to the following:
13  *
14  * The copyright notices in the Software and this entire statement, including
15  * the above license grant, this restriction and the following disclaimer,
16  * must be included in all copies of the Software, in whole or in part, and
17  * all derivative works of the Software, unless such copies or derivative
18  * works are solely in the form of machine-executable object code generated by
19  * a source language processor.
20  *
21  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
22  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
23  * FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
24  * SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
25  * FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
26  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
27  * DEALINGS IN THE SOFTWARE.
28  **********************************************************************/
29 
30 #pragma once
31 
32 #include <variant>
33 #include <QString>
34 #include <QList>
35 #include <QUrl>
36 #include <util/sll/eitherfwd.h>
37 #include "audiostructs.h"
38 
39 template<typename>
40 class QFuture;
41 
42 namespace Media
43 {
51  struct HypedArtistInfo
52  {
58  ArtistInfo Info_;
59 
68 
76  int Playcount_;
77 
85  int Listeners_;
86  };
87 
95  struct HypedTrackInfo
96  {
99  QString TrackName_;
100 
107  QUrl TrackPage_;
108 
116  int PercentageChange_;
117 
125  int Playcount_;
126 
134  int Listeners_;
135 
138  int Duration_;
139 
142  QUrl Image_;
143 
146  QUrl LargeImage_;
147 
150  QString ArtistName_;
151 
158  QUrl ArtistPage_;
159  };
160 
161  using HypedInfo_t = std::variant<QList<HypedArtistInfo>, QList<HypedTrackInfo>>;
162 
168  class Q_DECL_EXPORT IHypesProvider
169  {
170  public:
171  virtual ~IHypesProvider () {}
172 
178  using HypeQueryResult_t = LC::Util::Either<QString, HypedInfo_t>;
179 
187  virtual QString GetServiceName () const = 0;
188 
191  enum class HypeType
192  {
195  NewArtists,
196 
199  NewTracks,
200 
203  TopArtists,
204 
207  TopTracks
208  };
209 
215  virtual bool SupportsHype (HypeType hype) = 0;
216 
222  virtual QFuture<HypeQueryResult_t> RequestHype (HypeType type) = 0;
223  };
224 
225  template<IHypesProvider::HypeType HypeType>
226  auto GetHypedInfo (const HypedInfo_t& info)
227  {
228  if constexpr (HypeType == IHypesProvider::HypeType::NewArtists ||
230  return std::get<QList<HypedArtistInfo>> (info);
231  else
232  return std::get<QList<HypedTrackInfo>> (info);
233  }
234 }
235 
236 Q_DECLARE_INTERFACE (Media::IHypesProvider, "org.LeechCraft.Media.IHypesProvider/1.0")
Media::HypedTrackInfo::Listeners_
int Listeners_
Number of listeners.
Definition: ihypesprovider.h:133
Media::HypedTrackInfo::Duration_
int Duration_
Duration of the track.
Definition: ihypesprovider.h:137
Media::IHypesProvider::HypeType::NewArtists
New artists rapidly growing in popularity.
Media::HypedArtistInfo::PercentageChange_
int PercentageChange_
Change of popularity in percents.
Definition: ihypesprovider.h:66
Media::HypedArtistInfo::Playcount_
int Playcount_
Play count.
Definition: ihypesprovider.h:75
Media::HypedTrackInfo::TrackName_
QString TrackName_
Name of the track.
Definition: ihypesprovider.h:98
QList
Definition: ianrulesstorage.h:34
Media::HypedTrackInfo::LargeImage_
QUrl LargeImage_
Full size image of this track or performing artist.
Definition: ihypesprovider.h:145
Media::HypedTrackInfo::TrackPage_
QUrl TrackPage_
Address of the track page.
Definition: ihypesprovider.h:106
Media::HypedInfo_t
std::variant< QList< HypedArtistInfo >, QList< HypedTrackInfo > > HypedInfo_t
Definition: ihypesprovider.h:160
LC::Util::Either
Definition: either.h:97
Media::HypedTrackInfo::ArtistPage_
QUrl ArtistPage_
URL of the artist page.
Definition: ihypesprovider.h:157
Media::HypedTrackInfo::Image_
QUrl Image_
URL of thumb image of this track or performing artist.
Definition: ihypesprovider.h:141
Media::HypedArtistInfo::Info_
ArtistInfo Info_
Basic information about the artist.
Definition: ihypesprovider.h:57
Media
Definition: audiostructs.h:36
Media::GetHypedInfo
auto GetHypedInfo(const HypedInfo_t &info)
Definition: ihypesprovider.h:225
Media::IHypesProvider
Interface for plugins that support fetching hypes.
Definition: ihypesprovider.h:167
audiostructs.h
Media::HypedTrackInfo::ArtistName_
QString ArtistName_
Name of the performer of this track.
Definition: ihypesprovider.h:149
Media::HypedTrackInfo::Playcount_
int Playcount_
Play count.
Definition: ihypesprovider.h:124
QFuture
Definition: idownload.h:39
Media::HypedTrackInfo::PercentageChange_
int PercentageChange_
Change of popularity in percents.
Definition: ihypesprovider.h:115
Media::HypedArtistInfo::Listeners_
int Listeners_
Number of listeners.
Definition: ihypesprovider.h:84
Media::IHypesProvider::HypeType::TopArtists
Top artists.
eitherfwd.h