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

 /***************************************************************************
     Copyright (C) 2021 Robby Stephenson <robby@periapsis.org>
  ***************************************************************************/
 
 /***************************************************************************
  *                                                                         *
  *   This program is free software; you can redistribute it and/or         *
  *   modify it under the terms of the GNU General Public License as        *
  *   published by the Free Software Foundation; either version 2 of        *
  *   the License or (at your option) version 3 or any later version        *
  *   accepted by the membership of KDE e.V. (or its successor approved     *
  *   by the membership of KDE e.V.), which shall act as a proxy            *
  *   defined in Section 14 of version 3 of the license.                    *
  *                                                                         *
  *   This program is distributed in the hope that it will be useful,       *
  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
  *   GNU General Public License for more details.                          *
  *                                                                         *
  *   You should have received a copy of the GNU General Public License     *
  *   along with this program.  If not, see <http://www.gnu.org/licenses/>. *
  *                                                                         *
  ***************************************************************************/
 
 #include "rpggeekfetcher.h"
 #include "../translators/xslthandler.h"
 #include "../translators/tellicoimporter.h"
 #include "../utils/string_utils.h"
 #include "../core/tellico_strings.h"
 #include "../gui/combobox.h"
 #include "../tellico_debug.h"
 
 #include <KLocalizedString>
 #include <KConfigGroup>
 
 #include <QLabel>
 #include <QFile>
 #include <QTextStream>
 #include <QGridLayout>
 #include <QTextCodec>
 #include <QUrlQuery>
 
 namespace {
   // a lot of overlap with boardgamegeekimporter.h
   static const int BGG_MAX_RETURNS_TOTAL = 10;
   // interchangeable with boardgamegeek.com
   static const char* BGG_SEARCH_URL  = "https://rpggeek.com/xmlapi2/search";
   static const char* BGG_THING_URL  = "https://rpggeek.com/xmlapi2/thing";
 }
 
 using namespace Tellico;
 using Tellico::Fetch::RPGGeekFetcher;
 
 RPGGeekFetcher::RPGGeekFetcher(QObject* parent_)
     : XMLFetcher(parent_), m_imageSize(SmallImage) {
   setLimit(BGG_MAX_RETURNS_TOTAL);
   setXSLTFilename(QStringLiteral("boardgamegeek2tellico.xsl"));
 }
 
 RPGGeekFetcher::~RPGGeekFetcher() {
 }
 
 QString RPGGeekFetcher::source() const {
   return m_name.isEmpty() ? defaultName() : m_name;
 }
 
 // https://boardgamegeek.com/wiki/page/XML_API_Terms_of_Use
 QString RPGGeekFetcher::attribution() const {
   return i18n(providedBy, QLatin1String("https://boardgamegeek.com"), QLatin1String("BoardGameGeek"));
 }
 
 bool RPGGeekFetcher::canSearch(Fetch::FetchKey k) const {
   return k == Title || k == Keyword;
 }
 
 bool RPGGeekFetcher::canFetch(int type) const {
   // it's a custom collection
   return type == Data::Collection::Base;
 }
 
 void RPGGeekFetcher::readConfigHook(const KConfigGroup& config_) {
   const int imageSize = config_.readEntry("Image Size", -1);
   if(imageSize > -1) {
     m_imageSize = static_cast<ImageSize>(imageSize);
   }
 }
 
 QUrl RPGGeekFetcher::searchUrl() {
   QUrl u(QString::fromLatin1(BGG_SEARCH_URL));
 
   QUrlQuery q;
   switch(request().key()) {
     case Title:
       q.addQueryItem(QStringLiteral("query"), request().value());
       q.addQueryItem(QStringLiteral("type"), QStringLiteral("rpgitem"));
       q.addQueryItem(QStringLiteral("exact"), QStringLiteral("1"));
       break;
 
     case Keyword:
       q.addQueryItem(QStringLiteral("query"), request().value());
       q.addQueryItem(QStringLiteral("type"), QStringLiteral("rpgitem"));
       break;
 
     case Raw:
       u.setUrl(QLatin1String(BGG_THING_URL));
       q.addQueryItem(QStringLiteral("id"), request().value());
       q.addQueryItem(QStringLiteral("type"), QStringLiteral("rpgitem"));
       break;
 
     default:
       myWarning() << source() << "- key not recognized:" << request().key();
       return QUrl();
   }
   u.setQuery(q);
 
 //  myDebug() << "url: " << u.url();
   return u;
 }
 
 Tellico::Data::EntryPtr RPGGeekFetcher::fetchEntryHookData(Data::EntryPtr entry_) {
   Q_ASSERT(entry_);
 
   const QString id = entry_->field(QStringLiteral("bggid"));
   if(id.isEmpty()) {
     myDebug() << "no bgg id found";
     return entry_;
   }
 
   QUrl u(QString::fromLatin1(BGG_THING_URL));
   QUrlQuery q;
   q.addQueryItem(QStringLiteral("id"), id);
   q.addQueryItem(QStringLiteral("type"), QStringLiteral("rpgitem"));
   u.setQuery(q);
 //  myDebug() << "url: " << u;
 
   // quiet
   QString output = FileHandler::readXMLFile(u, true);
 
 #if 0
   myWarning() << "Remove output debug from rpggeekfetcher.cpp";
   QFile f(QStringLiteral("/tmp/test-rpggeek.xml"));
   if(f.open(QIODevice::WriteOnly)) {
     QTextStream t(&f);
     t.setCodec("UTF-8");
     t << output;
   }
   f.close();
 #endif
 
   auto handler = xsltHandler();
   handler->addStringParam("image-size", QByteArray::number(m_imageSize));
 
   Import::TellicoImporter imp(handler->applyStylesheet(output));
   // be quiet when loading images
   imp.setOptions(imp.options() ^ Import::ImportShowImageErrors);
   Data::CollPtr coll = imp.collection();
   if(!coll) {
     myWarning() << "no collection pointer";
     return entry_;
   }
   if(coll->entryCount() == 0) {
     myWarning() << "no entries";
     return entry_;
   }
 
   if(coll->entryCount() > 1) {
     myDebug() << "weird, more than one entry found";
   }
 
   // don't want to include id
   coll->removeField(QStringLiteral("bggid"));
   return coll->entries().front();
 }
 
 Tellico::Fetch::FetchRequest RPGGeekFetcher::updateRequest(Data::EntryPtr entry_) {
   QString bggid = entry_->field(QStringLiteral("bggid"));
   if(!bggid.isEmpty()) {
     return FetchRequest(Raw, bggid);
   }
 
   QString title = entry_->field(QStringLiteral("title"));
   if(!title.isEmpty()) {
     return FetchRequest(Title, title);
   }
   return FetchRequest();
 }
 
 Tellico::Fetch::ConfigWidget* RPGGeekFetcher::configWidget(QWidget* parent_) const {
   return new RPGGeekFetcher::ConfigWidget(parent_, this);
 }
 
 QString RPGGeekFetcher::defaultName() {
   return QStringLiteral("RPGGeek");
 }
 
 QString RPGGeekFetcher::defaultIcon() {
   return favIcon("https://cf.geekdo-static.com/icons/favicon2.ico");
 }
 
 Tellico::StringHash RPGGeekFetcher::allOptionalFields() {
   StringHash hash;
   hash[QStringLiteral("genre")] = i18n("Genre");
   hash[QStringLiteral("year")] = i18n("Release Year");
   hash[QStringLiteral("publisher")] = i18n("Publisher");
   hash[QStringLiteral("artist")]  = i18nc("Comic Book Illustrator", "Artist");
   hash[QStringLiteral("designer")] = i18n("Designer");
   hash[QStringLiteral("producer")] = i18n("Producer");
   hash[QStringLiteral("mechanism")] = i18n("Mechanism");
   hash[QStringLiteral("description")] = i18n("Description");
   hash[QStringLiteral("rpggeek-link")] = i18n("RPGGeek Link");
   return hash;
 }
 
 RPGGeekFetcher::ConfigWidget::ConfigWidget(QWidget* parent_, const RPGGeekFetcher* fetcher_)
     : Fetch::ConfigWidget(parent_) {
   QGridLayout* l = new QGridLayout(optionsWidget());
   l->setSpacing(4);
   l->setColumnStretch(1, 10);
 
   int row = -1;
 
   QLabel* label = new QLabel(i18n("&Image size: "), optionsWidget());
   l->addWidget(label, ++row, 0);
   m_imageCombo = new GUI::ComboBox(optionsWidget());
   m_imageCombo->addItem(i18n("No Image"), NoImage);
   m_imageCombo->addItem(i18n("Small Image"), SmallImage);
   m_imageCombo->addItem(i18n("Large Image"), LargeImage);
   void (GUI::ComboBox::* activatedInt)(int) = &GUI::ComboBox::activated;
   connect(m_imageCombo, activatedInt, this, &ConfigWidget::slotSetModified);
   l->addWidget(m_imageCombo, row, 1);
   label->setBuddy(m_imageCombo);
 
   l->setRowStretch(++row, 10);
 
   // now add additional fields widget
   addFieldsWidget(RPGGeekFetcher::allOptionalFields(), fetcher_ ? fetcher_->optionalFields() : QStringList());
 
   if(fetcher_) {
     m_imageCombo->setCurrentData(fetcher_->m_imageSize);
   } else { // defaults
     m_imageCombo->setCurrentData(SmallImage);
   }
 }
 
 void RPGGeekFetcher::ConfigWidget::saveConfigHook(KConfigGroup& config_) {
   const int n = m_imageCombo->currentData().toInt();
   config_.writeEntry("Image Size", n);
 }
 
 QString RPGGeekFetcher::ConfigWidget::preferredName() const {
   return RPGGeekFetcher::defaultName();
 }