Sayonara Player
CoverFetcherInterface.h
1 /* CoverFetcherInterface.h */
2 
3 /* Copyright (C) 2011-2019 Lucio Carreras
4  *
5  * This file is part of sayonara player
6  *
7  * This program is free software: you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation, either version 3 of the License, or
10  * (at your option) any later version.
11 
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15  * GNU General Public License for more details.
16 
17  * You should have received a copy of the GNU General Public License
18  * along with this program. If not, see <http://www.gnu.org/licenses/>.
19  */
20 
21 
22 
23 #ifndef ABSTRACTCOVERFETCHER_H
24 #define ABSTRACTCOVERFETCHER_H
25 
26 class QString;
27 class QByteArray;
28 class QStringList;
29 
30 namespace Cover::Fetcher
31 {
36  class Base
37  {
38 
39  private:
40  virtual QString priv_identifier() const=0;
41 
42  public:
43  Base();
44  virtual ~Base();
45 
50  virtual bool can_fetch_cover_directly() const=0;
51 
58  virtual QStringList parse_addresses(const QByteArray& website) const=0;
59 
64  virtual QString identifier() const final;
65 
66 
73  virtual QString artist_address(const QString& artist) const;
74 
82  virtual QString album_address(const QString& artist, const QString& album) const;
83 
90  virtual QString search_address(const QString& str) const;
91 
96  virtual int estimated_size() const=0;
97  };
98 
99 } // Cover::Fetcher
100 
101 #endif // ABSTRACTCOVERFETCHER_H
virtual QString artist_address(const QString &artist) const
Get the artist search url. This is called if is_artist_supported returns true.
virtual QString search_address(const QString &str) const
Get a custom search address This is called if is_search_supported returns true.
The CoverFetcherInterface interface.
Definition: CoverFetcherInterface.h:36
virtual QString identifier() const final
get name of CoverFetcherInterface like e.g. Discogs
virtual QStringList parse_addresses(const QByteArray &website) const =0
Get addresses from the downloaded website. If can_fetch_cover_directly returns true,...
virtual QString album_address(const QString &artist, const QString &album) const
Get the album search url. This is called if is_album_supported returns true.
virtual bool can_fetch_cover_directly() const =0
Can the cover be fetched from the adress without starting a two-stage query?
virtual int estimated_size() const =0
get_estimated_size. Rough image size of the CoverFetchInterface