/usr/include/cupt/download/method.hpp is in libcupt4-dev 2.9.4ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 | /**************************************************************************
* Copyright (C) 2010 by Eugene V. Lyubimkin *
* *
* This program is free software; you can redistribute it and/or modify *
* it under the terms of the GNU General Public License *
* (version 3 or above) as published by the Free Software Foundation. *
* *
* 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 GPL *
* along with this program; if not, write to the *
* Free Software Foundation, Inc., *
* 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA *
**************************************************************************/
#ifndef CUPT_DOWNLOAD_METHOD_SEEN
#define CUPT_DOWNLOAD_METHOD_SEEN
/// @file
#include <functional>
#include <cupt/common.hpp>
#include <cupt/fwd.hpp>
namespace cupt {
namespace download {
/// base class of download methods
class CUPT_API Method
{
protected:
Method();
/// gets URI-specific value of some @c 'acquire::*' option
/**
* Options of @c Acquire group can be overridden for specific host. This
* function hides the details and provides the convenient way get the value
* of the option in @c Acquire group for certain URI.
*
* @param config
* @param uri
* @param suboptionName
*
* @par Example:
* @code
* auto proxy = getAcquireSuboptionForUri(config, uri, "proxy");
* @endcode
*/
static string getAcquireSuboptionForUri(const Config& config,
const Uri& uri, const string& suboptionName);
/// gets URI-specific value of some integer @c 'acquire::*' option
/**
* Same as @ref getAcquireSuboptionForUri, but for integer options.
*
* @param config
* @param uri
* @param suboptionName
*/
static ssize_t getIntegerAcquireSuboptionForUri(const Config& config,
const Uri& uri, const string& suboptionName);
public:
/// downloads @a uri to @a targetPath
/**
* @param config
* @param uri
* @param targetPath path to download to
* @param callback callback function
*
* @par Allowed callback sequences:
* @c downloading @a total_downloaded_bytes @a size_of_last_fetched_piece @n
* @c expected-size @a expected_file_size
*/
virtual string perform(const Config& config, const Uri& uri,
const string& targetPath, const std::function< void (const vector< string >&) >& callback) = 0;
virtual ~Method() {}
};
}
}
#endif
|