File indexing completed on 2024-05-12 05:09:40

0001 /***************************************************************************
0002     Copyright (C) 2023 Robby Stephenson <robby@periapsis.org>
0003  ***************************************************************************/
0004 
0005 /***************************************************************************
0006  *                                                                         *
0007  *   This program is free software; you can redistribute it and/or         *
0008  *   modify it under the terms of the GNU General Public License as        *
0009  *   published by the Free Software Foundation; either version 2 of        *
0010  *   the License or (at your option) version 3 or any later version        *
0011  *   accepted by the membership of KDE e.V. (or its successor approved     *
0012  *   by the membership of KDE e.V.), which shall act as a proxy            *
0013  *   defined in Section 14 of version 3 of the license.                    *
0014  *                                                                         *
0015  *   This program is distributed in the hope that it will be useful,       *
0016  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
0017  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
0018  *   GNU General Public License for more details.                          *
0019  *                                                                         *
0020  *   You should have received a copy of the GNU General Public License     *
0021  *   along with this program.  If not, see <http://www.gnu.org/licenses/>. *
0022  *                                                                         *
0023  ***************************************************************************/
0024 
0025 #ifndef TELLICO_OPDSFETCHER_H
0026 #define TELLICO_OPDSFETCHER_H
0027 
0028 #include "fetcher.h"
0029 #include "configwidget.h"
0030 
0031 #include <QPointer>
0032 
0033 class QLabel;
0034 class KUrlRequester;
0035 class KJob;
0036 namespace KIO {
0037   class StoredTransferJob;
0038 }
0039 
0040 namespace Tellico {
0041   class XSLTHandler;
0042   namespace GUI {
0043     class LineEdit;
0044   }
0045   namespace Fetch {
0046 
0047 /**
0048  * @author Robby Stephenson
0049  */
0050 class OPDSFetcher : public Fetcher {
0051 Q_OBJECT
0052 
0053 public:
0054   /**
0055    */
0056   OPDSFetcher(QObject* parent);
0057   /**
0058    */
0059   virtual ~OPDSFetcher();
0060 
0061   /**
0062    */
0063   virtual QString source() const Q_DECL_OVERRIDE;
0064   virtual QString attribution() const Q_DECL_OVERRIDE;
0065   virtual QString icon() const Q_DECL_OVERRIDE;
0066   virtual bool isSearching() const Q_DECL_OVERRIDE { return m_started; }
0067   virtual bool canSearch(FetchKey k) const Q_DECL_OVERRIDE;
0068   virtual void stop() Q_DECL_OVERRIDE;
0069   virtual Data::EntryPtr fetchEntryHook(uint uid) Q_DECL_OVERRIDE;
0070   virtual Type type() const Q_DECL_OVERRIDE { return OPDS; }
0071   virtual bool canFetch(int type) const Q_DECL_OVERRIDE;
0072   virtual void readConfigHook(const KConfigGroup& config) Q_DECL_OVERRIDE;
0073   virtual void saveConfigHook(KConfigGroup& config) Q_DECL_OVERRIDE;
0074 
0075   virtual Fetch::ConfigWidget* configWidget(QWidget* parent) const Q_DECL_OVERRIDE;
0076 
0077   class Reader;
0078   friend class Reader;
0079   class ConfigWidget;
0080   friend class ConfigWidget;
0081 
0082   static QString defaultName();
0083   static QString defaultIcon();
0084   static StringHash allOptionalFields();
0085 
0086 private Q_SLOTS:
0087   void slotComplete(KJob* job);
0088 
0089 private:
0090   virtual void search() Q_DECL_OVERRIDE;
0091   virtual FetchRequest updateRequest(Data::EntryPtr entry) Q_DECL_OVERRIDE;
0092   void initXSLTHandler();
0093   void parseData(const QByteArray& data, bool manualSearch=false);
0094   bool matchesEntry(Data::EntryPtr entry) const;
0095 
0096   QString m_catalog;
0097   QString m_searchTemplate;
0098   QString m_icon;
0099   QString m_attribution;
0100   XSLTHandler* m_xsltHandler;
0101 
0102   QHash<uint, Data::EntryPtr> m_entries;
0103   QPointer<KIO::StoredTransferJob> m_job;
0104   bool m_started;
0105 };
0106 
0107 // utility class for reading the OPDS catalog and finding the search information
0108 class OPDSFetcher::Reader {
0109 public:
0110   Reader(const QUrl& catalog);
0111   bool parse();
0112   bool readSearchTemplate();
0113 
0114   QUrl catalog;
0115   QByteArray opdsText;
0116   bool isAcquisition;
0117   QUrl searchUrl;
0118   QString searchTemplate;
0119   QString name;
0120   QString icon;
0121   QString attribution;
0122 };
0123 
0124 class OPDSFetcher::ConfigWidget : public Fetch::ConfigWidget {
0125 Q_OBJECT
0126 
0127 public:
0128   explicit ConfigWidget(QWidget* parent_, const OPDSFetcher* fetcher = nullptr);
0129   virtual void saveConfigHook(KConfigGroup& config) Q_DECL_OVERRIDE;
0130   virtual QString preferredName() const Q_DECL_OVERRIDE;
0131 
0132 private Q_SLOTS:
0133   void verifyCatalog();
0134 
0135 private:
0136   KUrlRequester* m_catalogEdit;
0137   QLabel* m_statusLabel;
0138   QString m_name;
0139   QString m_searchTemplate;
0140   QString m_icon;
0141   QString m_attribution;
0142 };
0143 
0144   } // end namespace
0145 } // end namespace
0146 #endif