client.hpp

/*#***************************************************************************
#                         __    __   _____       _____
#   Project              |  |  |  | |     \     /  ___|
#                        |  |__|  | |  |\  \   /  /
#                        |        | |  | )  ) (  (     
#                        |   /\   | |  |/  /   \  \___
#                         \_/  \_/  |_____/     \_____|
#
# Copyright (C) 2016, The WDC Project, <designerror@yandex.ru>, et al.
#
# This software is licensed as described in the file LICENSE, which
# you should have received as part of this distribution. 
#
# You may opt to use, copy, modify, merge, publish, distribute and/or sell
# copies of the Software, and permit persons to whom the Software is
# furnished to do so, under the terms of the LICENSE file.
#
# This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
# KIND, either express or implied.
#
############################################################################*/

#ifndef WEBDAV_CLIENT_H
#define WEBDAV_CLIENT_H
#pragma once

#include <functional>
#include <iostream>
#include <map>
#include <string>
#include <vector>

namespace WebDAV
{
    using progress_t = std::function<int(void *context,
                                size_t dltotal,
                                size_t dlnow, 
                                size_t ultotal, 
                                size_t ulnow)> ;

    using callback_t = std::function<void(bool)> ;

    using strings_t = std::vector<std::string>;
    using dict_t = std::map<std::string, std::string>;

    class Client
    {   
    public:

        static auto Init(const dict_t& options) noexcept -> Client *;

        static void Cleanup() noexcept;

        auto free_size() const noexcept -> unsigned long long;

        auto check(const std::string& remote_resource = "/") const noexcept -> bool;

        auto info(const std::string& remote_resource) const noexcept -> dict_t;

        auto clean(const std::string& remote_resource) const noexcept -> bool;

        auto is_directory(const std::string& remote_resource) const noexcept -> bool;

        auto list(const std::string& remote_directory = "") const noexcept -> strings_t;

        auto create_directory(
            const std::string& remote_directory, 
            bool recursive = false
        ) const noexcept -> bool;

        auto move(
            const std::string& remote_source_resource, 
            const std::string& remote_destination_resource
        ) const noexcept -> bool;

        auto copy(
            const std::string& remote_source_resource, 
            const std::string& remote_destination_resource
        ) const noexcept -> bool;

        auto download(
            const std::string& remote_file, 
            const std::string& local_file, 
            progress_t progress = nullptr
        ) const noexcept -> bool;

        auto download_to(
            const std::string& remote_file,
            char * & buffer_ptr, 
            unsigned long long & buffer_size, 
            progress_t progress = nullptr
        ) const noexcept -> bool;

        auto download_to(
            const std::string& remote_file,
            std::ostream& stream,
            progress_t progress = nullptr
        ) const noexcept -> bool;

        auto async_download(
            const std::string& remote_file, 
            const std::string& local_file, 
            callback_t callback = nullptr, 
            progress_t progress = nullptr
        ) const noexcept -> void;

        auto upload(
            const std::string& remote_file,
            const std::string& local_file, 
            progress_t progress = nullptr
        ) const noexcept -> bool;

        auto upload_from(
            const std::string& remote_file, 
            char * buffer_ptr, 
            unsigned long long buffer_size, 
            progress_t progress = nullptr
        ) const noexcept -> bool;

        auto upload_from(
            const std::string& remote_file, 
            std::istream& stream, 
            progress_t progress = nullptr
        ) const noexcept -> bool;

        auto async_upload(
            const std::string& remote_file, 
            const std::string& local_file, 
            callback_t callback = nullptr,
            progress_t progress = nullptr
        ) const noexcept -> void;


        virtual ~Client() {};

    protected:

        enum { buffer_size = 1000 * 1000 };

        Client() {}
    };
}

#endif