Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/CloudPolis/webdav-client-cpp

:cloud: C++ WebDAV Client provides easy and convenient to work with WebDAV-servers.
https://github.com/CloudPolis/webdav-client-cpp

box client cpp webdav yandex-disk

Last synced: about 2 months ago
JSON representation

:cloud: C++ WebDAV Client provides easy and convenient to work with WebDAV-servers.

Awesome Lists containing this project

README

        

WebDAV Client
===
[![version](https://img.shields.io/badge/hunter-v0.23.86-blue.svg)](https://github.com/ruslo/hunter/releases/tag/v0.23.86)
[![version](https://img.shields.io/badge/wdc-v1.1.5-blue.svg)](https://github.com/CloudPolis/webdav-client-cpp/releases/tag/v1.1.4)
[![Build Status](https://travis-ci.org/CloudPolis/webdav-client-cpp.svg?branch=master)](https://travis-ci.org/CloudPolis/webdav-client-cpp)
[![Build status](https://ci.appveyor.com/api/projects/status/cr2xwpwe3iiafbwg?svg=true)](https://ci.appveyor.com/project/rusdevops/webdav-client-cpp)
[![Join the chat at https://gitter.im/CloudPolis/webdav-client-cpp](https://badges.gitter.im/CloudPolis/webdav-client-cpp.svg)](https://gitter.im/CloudPolis/webdav-client-cpp?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

Package ```WebDAV Client``` provides easy and convenient to work with WebDAV-servers:

- Yandex.Disk
- Dropbox
- Google Drive
- Box
- 4shared
- ownCloud
- ...

Install old version
===

```ShellSession
# via brew or homebrew
$ brew install wdc
```

Build
===

Building WebDAV Client from sources:

```ShellSession
$ git clone --recursive https://github.com/CloudPolis/webdav-client-cpp
$ cd webdav-client-cpp
$ ./tools/polly/bin/polly --install
```

Building documentation:
```ShellSession
$ doxygen docs/doxygen.conf
$ open docs/html/index.html
```

Running tests
===

For run tests you need to set environment variables `WEBDAV_HOSTNAME`,
`WEBDAV_USERNAME` and `WEBDAV_PASSWORD` (optional `WEBDAV_ROOT`).

```ShellSession
$ export WEBDAV_HOSTNAME=
$ export WEBDAV_USERNAME=
$ export WEBDAV_PASSWORD=
$ ./tools/polly/bin/polly --test --reconfig --fwd BUILD_TESTS=yes
```

Usage
===

```C++
#include

#include
#include
#include

int main()
{
std::map options =
{
{"webdav_hostname", "https://webdav.yandex.ru"},
{"webdav_username", "webdav_username"},
{"webdav_password", "webdav_password"}
};
// additional keys:
// - webdav_root
// - cert_path, key_path
// - proxy_hostname, proxy_username, proxy_password

std::unique_ptr client{ new WebDAV::Client{ options } };

bool check_connection = client->check();
std::cout << "test connection with WebDAV drive is "
<< (check_connection ? "" : "not ")
<< "successful"<< std::endl;

bool is_dir = client->is_directory("/path/to/remote/resource");
std::cout << "remote resource is "
<< (is_dir ? "" : "not ")
<< "directory" << std::endl;

client->create_directory("/path/to/remote/directory/");
client->clean("/path/to/remote/directory/");

std::cout << "On WebDAV-disk available free space: "
<< client->free_size()
<< std::endl;

std::cout << "remote_directory_name";
for (const auto& resource_name : client->list("/path/to/remote/directory/"))
{
std::cout << "\t" << "-" << resource_name;
}
std::cout << std::endl;

client->download("/path/to/remote/file", "/path/to/local/file");
client->clean("/path/to/remote/file");
client->upload("/path/to/remote/file", "/path/to/local/file");

const auto meta_info = client->info("/path/to/remote/resource");
for (const auto& field : meta_info) {
std::cout << field.first << ":" << "\t" << field.second;
}
std::cout << std::endl;

client->copy("/path/to/remote/file1", "/path/to/remote/file2");
client->move("/path/to/remote/file1", "/path/to/remote/file3");

client->async_upload("/path/to/remote/file", "/path/to/local/file");
client->async_download("/path/to/remote/file", "/path/to/local/file");
}
```

**CMakeLists.txt**
```cmake
cmake_minimum_required(VERSION 3.4)

HunterGate(
URL "https://github.com/ruslo/hunter/archive/v0.23.83.tar.gz"
SHA1 "12dec078717539eb7b03e6d2a17797cba9be9ba9"
)

project(example)

hunter_add_package(WDC)
find_package(WDC CONFIG REQUIRED)

add_executable(example example.cpp)
target_link_libraries(example WDC::libwdc)
```