inc/CurlWikiGrabber.h

   1 //! \file CurlWikiGrabber.h
   2
   3 #ifndef WIKIWALKER_CURL_WIKI_GRABBER_H
   4 #define WIKIWALKER_CURL_WIKI_GRABBER_H
   5
   6 #include <string>
   7
   8 namespace WikiWalker
   9 {
  10   //! Class responsible for grabbing the contents / links of an article
  11   class CurlWikiGrabber
  12   {
  13   public:
  14     /*! Create a new instance.
  15      * Might throw an exception, if curl intialization failed
  16      */
  17     CurlWikiGrabber();
  18
  19     ~CurlWikiGrabber();
  20
  21     //! Explicitely delete copy constructor, because curl handle
  22     CurlWikiGrabber(const CurlWikiGrabber& other) = delete;
  23     //! Explicitely delete move constructor, because curl handle
  24     CurlWikiGrabber(CurlWikiGrabber&& other) = delete;
  25
  26     //! Explicitely delete copy assignment operator, because curl handle
  27     CurlWikiGrabber& operator=(const CurlWikiGrabber& other) = delete;
  28     //! Explicitely delete move assignment operator, because curl handle
  29     CurlWikiGrabber& operator=(CurlWikiGrabber&& other) = delete;
  30
  31     /*! given an URL, return article JSON data
  32      * \param url URL of the article
  33      * \returns article JSON data
  34      */
  35     std::string grabUrl(const std::string& url) const;
  36
  37     /*! Set whether to skip SSL verification.
  38      * \param state whether to skip SSL verification
  39      * this was added because vcpkg's libcurl doesn't have
  40      * a default CA certificate lookup path.
  41      */
  42     void skipSslVerification(bool state);
  43
  44   private:
  45     bool skipSslVerificationState_{false};
  46   };
  47 }  // namespace WikiWalker
  48 #endif  // WIKIWALKER_CURL_WIKI_GRABBER_H