qevercloud's Introduction

QEverCloud

Unofficial Evernote Cloud API for Qt

What's this

This library presents complete Evernote SDK for Qt. All the functionality that is described on Evernote site is implemented and ready to use. In particular OAuth authentication is implemented.

Read doxygen generated documentation for detailed info.

The documentstion is also available as a .qch file which you can register with your copy of Qt Creator to have context-sensitive help. See qch subdir.

Forks

Due to a radical change in my interests in programming and also due to the fact that I personaly mostly migrated out of Evernote I do not maintain QEverCloud anymore.

As of time of writing there are people who use QEverCloud in their projects. Some of them have created forks and maintain them. You should use their forks and not my repository and contact them about pull request and bug reports. The list of the forks:

Dmitry Ivanov's fork

If you want your fork to appear in the list (or disappear from it) - contact me. That much I can do :)

Compatibility

While the library initially supported Qt 4 it became too constraining so I've dropped the support. If you're stuck with Qt 4 you can use the previous version which is available through qt4 branch.

I do not use C++11 features directly but only through macros Qt 5 have like Q_DECL_OVERRIDE, Q_STATIC_ASSERT_X QStringLiteral and others. So QEverCloud supports any given compiler as good as Qt 5 supports it.

Personally I test the library with MSVC2012 and MinGW 4.8 on Windows.

How to compile

QEverCloud depends on Qt only. So there is nothing special to compiling it.

How to link

Link compiled library to your project in the usual way.
Add it's include subdir to your app INCLUDEPATH qmake variable.
Add to QT variabe the network module. If you use OAuth functionality than add also widgets and webkitwidgets modules.

Include QEverCloud.h or QEverCloudOAuth.h to use the library. The latter header is needed if you use OAuth functionality.

Runtime dependencies

Qt uses OpenSSL to implement https protocol. As a result OpenSSL dynamically linked libraries (libeay32 and ssleay32) must be availabe in the PATH for your app to run successfully.

qevercloud's People

Contributors

Stargazers

Watchers

qevercloud's Issues

Missing operator== and operator!= for generated types

First of all, thank you very much! Your work is just awesome and more convenient than official Evernote's C++ SDK by several orders of magnitude.

For now the only missing piece of functionality I've found is that type structs in the official Evernote's SDK have implemented operator == and operator != which are not present in QEverCloud's structs. If possible, I'd be very glad to have them in the structs even though they are implementable as outside operators.

Minor changes for Qt 4.8 & Linux

First, THANK YOU SO MUCH!!! This is so much easier to work with than the normal Thrift libraries. My only complaint is that this wasn't available two years ago. It would have saved me a ton of work. :-)

Just as an FYI & in case others ask, I needed to make a few minor changes to use it with Qt 4.8 on Linux.

1.) In http.cpp I had to use request.setRawHeader instead of request.setHeader to set the user agent because there is no QNetworkRequest::UserAgentHeader in 4.8.

2.) In http.h, I needed to add these 3 includes or it ran into issues. I assume it was due to the order in which gcc interprets headers.

include

3.) In thrift.h I needed to add this include

include

Otherwise, using Qt 4.8 on Linux everything I've tested works perfectly.

Thanks again!

EventLoopFinisher not added

I'm using QEverCloud by including it's source code as a subdir project in my project tree. When I link to this library, Qt reports "unresolved reference to vtable for EventLoopFinisher" (or something like that).

I found EventLoopFinisher.{h,cpp} are in the source directory, but bot included in the .pro file. After I added them in the QEverCloud.pro file, the problem was solved.

By the way, I would appreaciate if you can split the source without example and other file as a single repo. So that I can include that project as a git module in my project.

Recommend Projects

mgsxx / qevercloud Goto Github PK

qevercloud's Introduction

QEverCloud

What's this

Forks

Compatibility

How to compile

How to link

Runtime dependencies

qevercloud's People

Contributors

Stargazers

Watchers

Forkers

qevercloud's Issues

include

include

include

include

Recommend Projects

Recommend Topics

Recommend Org