Connection_libcurl.h

/*
 * Copyright(c) Sophist Solutions, Inc. 1990-2025.  All rights reserved
 */
#ifndef _Stroika_Foundation_IO_Network_Transfer_Connection_libcurl_h_
#define _Stroika_Foundation_IO_Network_Transfer_Connection_libcurl_h_ 1
 
#include "Stroika/Foundation/StroikaPreComp.h"
 
#include <system_error>
 
#if qStroika_HasComponent_libcurl
// For CURLCode define
#include <curl/curl.h>
#endif
 
#include "Stroika/Foundation/Execution/Exceptions.h"
#include "Stroika/Foundation/IO/Network/Transfer/Connection.h"
 
/*
 * TODO:
 *      @todo   Consider if curl global init/global_free stuff safe (look at curl code). May run into issue if other
 *              libraries using curl (like CurlNetAccessor::initCurl in xerces) do the same thing.
 */
 
#if qStroika_HasComponent_libcurl
namespace Stroika::Foundation::IO::Network::Transfer::LibCurl {
 
    /**
     *  Return a reference the the LibCurl error category object. This object lives forever (like other error categories).
     */
    const std::error_category& error_category () noexcept;
 
    /**
     * throw Exception () type iff the status indicates a real exception code. This MAY not throw an exception of type LibCurlException,
     * but MAY map to any other exception type
     */
    void ThrowIfError (CURLcode status);
 
    namespace Connection {
 
        using namespace Stroika::Foundation::IO::Network::Transfer::Connection;
 
        /**
         *  Create a 'libcurl' connection object (url specified in the options).
         */
        Ptr New (const Options& options = {});
    }
 
}
#endif
 
/*
 ********************************************************************************
 ***************************** Implementation Details ***************************
 ********************************************************************************
 */
#include "Connection_libcurl.inl"
 
#endif /*_Stroika_Foundation_IO_Network_Transfer_Connection_libcurl_h_*/