QtDropbox is an API for the well known cloud storage service Dropbox.
Basically QtDropbox aims to provide an easy to use posibillity to access the REST API of Dropbox. All HTTP calls are hidden behind the curtains of neat C++/Qt classes with nice method names and specific uses.
The project is targetting the most recent version of Qt and thus was ported to Qt5. In the beginning the project was developed for Qt4 and as there are some projects based on Qt4 out there the legacy version is still being supported.
The master branch always provides the most recent version of the project and at the moment this is the Qt5 version.
Legacy versions such as the one supporting Qt4 are provided in specific branches. Here is a short list which branch to check out for the specific legacy versions:
- Qt4.x -> qt4
Mind that the branch with name qt5 is currently an unused stub!
The ongoing development focues on the master branch first. This means that legacy versions
are usually not further improved with new features. Bugfixes will be provided though!
This should not indicate that legacy versions won't receive important new features but they are rather implemented on request only. If there is a specific feature that is already implemented in the most recent version but you need it in a legacy version (e.g. Qt4.x) just open an issue.
QtDropbox is currently under development and only provides limited features at the moment. If you have some knowledge about C++ (with Qt framework and/or the Dropbox REST API you are welcome to contribute to this project. For details take a look at the project webpage
Because QtDropbox is far from being ready for a release candidate I will list all already available and somewhat tested features here:
Currently in progress:
- Complete documentation
- Examples
- Connect to Dropbox
- Access user account information (quotas, user name, share links, ...)
- Parse JSON strings
- Access files like a local QFile to read and write data
- Access file and directory metadata
- Access file revisions
- Reading file information and metadata
Postponed to next version:
- Acessing and traversing the directory structure
You can generate a documentation of all classes by:
qmake
make documentation
This will generate a directory called doxy/ that contains a HTML documentation. Input files to generate a LaTeX based configuration are supplied as well.
There are some files apart this README that may provide some useful information:
- LICENSE It's LGPL v3 although that is currently not mentioned in the files
- INSTALL.md Installation and usage instructions
- doc/ Generally everthing inside this directory is information.
- doc/DEVELOPMENT.md Development guidelines. Please read if you want to contribute!