Sayonara Player
CoverFetcher.h
1 /* CoverFetcher.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 #ifndef ABSTRACTCOVERFETCHER_H
22 #define ABSTRACTCOVERFETCHER_H
23 
24 class QString;
25 class QByteArray;
26 class QStringList;
27 
28 namespace Cover::Fetcher
29 {
34  class Base
35  {
36  private:
37  virtual QString priv_identifier() const=0;
38 
39  public:
40  Base();
41  virtual ~Base();
42 
47  virtual bool can_fetch_cover_directly() const=0;
48 
55  virtual QStringList parse_addresses(const QByteArray& website) const=0;
56 
61  virtual QString identifier() const final;
62 
63 
70  virtual QString artist_address(const QString& artist) const;
71 
79  virtual QString album_address(const QString& artist, const QString& album) const;
80 
87  virtual QString search_address(const QString& str) const;
88 
93  virtual int estimated_size() const=0;
94  };
95 
96 } // Cover::Fetcher
97 
98 #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.
Definition: CoverFetchManager.h:32
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: CoverFetcher.h:34
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, this method is not called.
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