[oauth2] Add o2 library as external

external/o2/CHANGES.md

@@ -0,0 +1,26 @@
+# Change Log
+
+## 1.0.1
+
+* Add Spotify specialization
+* Fix Skydrive specialization
+* If available, use ```qml``` instead of ```script```
+* Use ```Q_SIGNALS``` etc. instead of ```signals``` etc.
+* Add versioning, shared library support
+* Add Surveymonkey specialization
+* Add DLL import/export declarations for Windows
+
+## 1.0.0
+
+* O1 and O2 to share a common base class
+* Move common classes to the O0 name space
+* Cleanups and bug fixes
+
+## 0.1.0
+
+* Add Sialis, a Qt Quick Twitter demo client
+* Cleanups and bug fixes
+
+## Pre-0.1.0
+
+* Initial non-release

external/o2/CMakeLists.txt

@@ -0,0 +1,56 @@
+cmake_minimum_required(VERSION 2.8.11)
+
+if(POLICY CMP0048) # in CMake >= 3.0.0
+    cmake_policy(SET CMP0048 OLD) # keep project() from clearing VERSION variables
+endif(POLICY CMP0048)
+
+set( CMAKE_MODULE_PATH ${CMAKE_SOURCE_DIR}/cmake/modules )
+
+set(VER_MAJOR "1")
+set(VER_MINOR "0")
+set(VER_PATCH "1")
+set(API_VER_PATCH "0")
+set(CPACK_PACKAGE_VERSION_MAJOR ${VER_MAJOR})
+set(CPACK_PACKAGE_VERSION_MINOR ${VER_MINOR})
+set(CPACK_PACKAGE_VERSION_PATCH ${VER_PATCH})
+set(PROJECT_VERSION ${VER_MAJOR}.${VER_MINOR}.${VER_PATCH})
+set(API_VERSION ${VER_MAJOR}.${VER_MINOR}.${API_VER_PATCH})
+
+project(o2)
+
+option(o2_WITH_QT5 "Use Qt5" ON)
+
+set(o2_LIB_SUFFIX "" CACHE STRING "Suffix for install 'lib' directory, e.g. 64 for lib64")
+
+option(o2_SHOW_TRACE "Show debugging messages" OFF)
+if(NOT o2_SHOW_TRACE)
+  add_definitions(-DQT_NO_DEBUG_OUTPUT=1)
+endif()
+
+option(o2_WITH_TWITTER "Authenticate with Twitter" OFF)
+option(o2_WITH_DROPBOX "Authenticate with Dropbox" OFF)
+option(o2_WITH_GOOGLE "Authenticate with Google" OFF)
+option(o2_WITH_FACEBOOK "Authenticate with Facebook" OFF)
+option(o2_WITH_SKYDRIVE "Authenticate with SkyDrive" OFF)
+option(o2_WITH_FLICKR "Authenticate with Flickr" OFF)
+option(o2_WITH_HUBIC "Authenticate with Hubic" OFF)
+option(o2_WITH_SPOTIFY "Authenticate with Spotify" OFF)
+option(o2_WITH_SURVEYMONKEY "Authenticate with SurveyMonkey" OFF)
+option(o2_WITH_KEYCHAIN "keychain store" ON)
+
+option(o2_WITH_OAUTH1 "Include OAuth1 authentication" OFF)
+if(o2_WITH_TWITTER OR o2_WITH_DROPBOX OR o2_WITH_FLICKR)
+  set(o2_WITH_OAUTH1 ON)
+endif()
+
+option(o2_BUILD_EXAMPLES "Build examples" OFF)
+
+if(WIN32)
+  add_definitions(-DO2_DLL_EXPORT)
+endif()
+
+add_subdirectory(src)
+
+if(o2_BUILD_EXAMPLES)
+  add_subdirectory(examples)
+endif(o2_BUILD_EXAMPLES)

external/o2/LICENSE

@@ -0,0 +1,23 @@
+Copyright (c) 2012, Akos Polster
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without 
+modification, are permitted provided that the following conditions are met:
+
+ * Redistributions of source code must retain the above copyright notice, this
+list of conditions and the following disclaimer.
+
+ * Redistributions in binary form must reproduce the above copyright notice, 
+this list of conditions and the following disclaimer in the documentation 
+and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE 
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

external/o2/README.md

@@ -0,0 +1,223 @@
+# OAuth 1.0 and 2.0 for Qt
+
+This library encapsulates the OAuth 1.0 and 2.0 client authentication flows, and the sending of authenticated HTTP requests.
+
+The primary target is Qt Quick applications on embedded devices.
+
+Notes to contributors:
+
+   * Please follow the coding style of the existing source
+   * Code contributions are released under Simplified BSD License, as specified in LICENSE. Do not contribute if this license does not suit your code
+
+## Classes
+
+Class | Header | Purpose
+:-- | :-- | :--
+O0AbstractStore | o0abstractstore.h | Base class of persistent stores
+O0BaseAuth | o0baseauth.h | Base class of OAuth authenticators
+O0SettingsStore | o0settingsstore.h | QSettings-based persistent store
+o0keyChainStore | o0keychainstore.h | Settings stored through the system keychain [keychain](https://github.com/frankosterfeld/qtkeychain)
+O0SimpleCrypt | o0simplecrypt.h | Simple encryption and decryption by Andre Somers
+O1 | o1.h | Generic OAuth 1.0 authenticator
+O1Dropbox | o1dropbox.h | Dropbox OAuth specialization
+O1Flickr | o1flickr.h | Flickr OAuth specialization
+O1Freshbooks | o1freshbooks.h | Freshbooks OAuth specialization
+O1Requestor | o1requestor.h | Makes authenticated OAuth 1.0 requests: GET, POST or PUT, handles timeouts
+O1RequestParameter | o1.h | An extra request parameter participating in request signing
+O1Twitter | o1twitter.h | Twitter OAuth specialization
+O2 | o2.h | Generic OAuth 2.0 authenticator
+O2Facebook | o2facebook.h | Facebook OAuth specialization
+O2Gft | o2gft.h | Google Fusion Tables OAuth specialization
+O2Google | o2google.h | Google Oauth specialization [scopes](https://developers.google.com/identity/protocols/googlescopes)
+O2Hubic | o2hubic.h | Hubic OAuth specialization
+O2Reply | o2reply.h | A network request/reply that can time out
+O2ReplyServer | o2replyserver.h | HTTP server to process authentication responses
+O2Requestor | o2requestor.h | Makes authenticated OAuth 2.0 requests (GET, POST or PUT), handles timeouts and token expiry
+O2Skydrive | o2skydrive.h | OneDrive OAuth specialization
+O2SurveyMonkey | o2surveymonkey.h | SurveyMonkey OAuth specialization
+OXTwitter | oxtwitter.h | Twitter XAuth specialization
+
+## Installation
+
+Clone the Github repository, then add all files in *src* to your Qt project, by including *src/src.pri*.
+
+## Basic Usage
+
+This example assumes a hypothetical Twitter client that will post tweets. Twitter is using OAuth 1.0.
+
+### Setup
+
+Include the required header files, and have some member variables that will be used for authentication and sending requests:
+
+    #include "o1twitter.h"
+    #include "o1requestor.h"
+    O1Twitter *o1;
+
+### Initialization
+
+Instantiate one of the authenticator classes, like O1Twitter, set your application ID and application secret, and install the signal handlers:
+
+    o1 = new O1Twitter(this);
+    o1->setClientId(MY_CLIENT_ID);
+    o1->setClientSecret(MY_CLIENT_SECRET);
+    connect(o1, SIGNAL(linkedChanged()), this, SLOT(onLinkedChanged()));
+    connect(o1, SIGNAL(linkingFailed()), this, SLOT(onLinkingFailed()));
+    connect(o1, SIGNAL(linkingSucceeded()), this, SLOT(onLinkingSucceeded()));
+    connect(o1, SIGNAL(openBrowser(QUrl)), this, SLOT(onOpenBrowser(QUrl)));
+    connect(o1, SIGNAL(closeBrowser()), this, SLOT(onCloseBrowser()));
+
+**Note:** For browserless Twitter authentication, you can use the OXTwitter specialized class which can do Twitter XAuth. You will need to additionally provide your Twitter login credentials (username & password) before calling *link()*.
+
+### Handling Signals
+
+O2 is an asynchronous library. It will send signals at various stages of authentication and request processing.
+
+To handle these signals, implement the following slots in your code:
+
+    void onLinkedChanged() {
+        // Linking (login) state has changed.
+        // Use o1->linked() to get the actual state
+    }
+
+    void onLinkingFailed() {
+        // Login has failed
+    }
+
+    void onLinkingSucceeded() {
+        // Login has succeeded
+    }
+
+    void onOpenBrowser(const QUrl *url) {
+        // Open a web browser or a web view with the given URL.
+        // The user will interact with this browser window to
+        // enter login name, password, and authorize your application
+        // to access the Twitter account
+    }
+
+    void onCloseBrowser() {
+        // Close the browser window opened in openBrowser()
+    }
+
+### Logging In
+
+To log in (e.g. to link your application to the OAuth service), call the link() method:
+
+    o1->link();
+
+This initiates the authentication sequence. Your signal handlers above will be called at various stages. Lastly, if linking succeeds, onLinkingSucceeded() will be called.
+
+### Logging Out
+
+To log out, call the unlink() method:
+
+    o1->unlink();
+
+Logging out always succeeds, and requires no user interaction.
+
+### Sending Authenticated Requests
+
+Once linked, you can start sending authenticated requests to the service. We start with a simple example of sending a text-only tweet or as it's known in Twitter docs, a 'status update'.
+
+First we need a Qt network manager and an O1 requestor object:
+
+    QNetworkAccessManager *manager = new QNetworkAccessManager(this);
+    O1Requestor *requestor = new O1Requestor(manager, o1, this);
+
+Next, create parameters for posting the update:
+
+    QByteArray paramName("status");
+    QByteArray tweetText("My first tweet!");
+
+    QList<O1RequestParameter> requestParams = QList<O1RequestParameter>();
+    requestParams << O1RequestParameter(paramName, tweetText);
+
+    QByteArray postData = O1::createQueryParams(requestParams);
+
+    // Using Twitter's REST API ver 1.1
+    QUrl url = QUrl("https://api.twitter.com/1.1/statuses/update.json");
+
+    QNetworkRequest request(url);
+    request.setHeader(QNetworkRequest::ContentTypeHeader, O2_MIME_TYPE_XFORM);
+
+Finally we authenticate and send the request using the O1 requestor object:
+
+    QNetworkReply *reply = requestor->post(request, reqestParams, postData);
+
+Continuing with the example, we will now send a tweet containing an image as well as a message.
+
+We create an HTTP request containing the image and the message, in the format specified by Twitter:
+
+    QString imagePath("/tmp/image.jpg");
+    QString message("My tweet with an image!");
+
+    QFileInfo fileInfo(imagePath);
+    QFile file(imagePath);
+    file.open(QIODevice::ReadOnly);
+
+    QString boundary("7d44e178b0439");
+    QByteArray data(QString("--" + boundary + "\r\n").toAscii());
+    data += "Content-Disposition: form-data; name=\"media[]\"; filename=\"" + fileInfo.fileName() + "\"\r\n";
+    data += "Content-Transfer-Encoding: binary\r\n";
+    data += "Content-Type: application/octet-stream\r\n\r\n";
+    data += file.readAll();
+    file.close();
+    data += QString("\r\n--") + boundary + "\r\n";
+    data += "Content-Disposition: form-data; name=\"status\"\r\n";
+    data += "Content-Transfer-Encoding: binary\r\n";
+    data += "Content-Type: text/plain; charset=utf-8\r\n\r\n";
+    data += message.toUtf8();
+    data += QString("\r\n--") + boundary + "--\r\n";
+
+    QNetworkRequest request;
+    // Using Twitter's REST API ver 1.1
+    request.setUrl(QUrl("https://api.twitter.com/1.1/statuses/update_with_media.json"));
+    request.setHeader(QNetworkRequest::ContentTypeHeader, "multipart/form-data; boundary=" + boundary);
+    request.setHeader(QNetworkRequest::ContentLengthHeader, data.length());
+
+    QNetworkReply *reply = requestor->post(request, QList<O1RequestParameter>(), data);
+
+That's it. Tweets using the O2 library!
+
+### Storing OAuth Tokens
+
+O2 provides simple storage classes for writing OAuth tokens in a peristent location. Currently, a QSettings based backing store **O2SettingsStore** is provided in O2. O2SettingsStore keeps all token values in an encrypted form. You have to specify the encryption key to use while constructing the object:
+
+    O0SettingsStore settings = new O0SettingsStore("myencryptionkey");
+    // Set the store before starting OAuth, i.e before calling link()
+    o1->setStore(settings);
+    ...
+
+You can also create it with your customized QSettings object. O2SettingsStore will then use that QSettings object for storing the tokens:
+
+    O0SettingsStore settings = new O0SettingsStore(mySettingsObject, "myencryptionkey");
+
+Once set, O2SettingsStore takes ownership of the QSettings object.
+
+**Note:** If you do not specify a storage object to use, O2 will create one by default (which QSettings based), and use it. In such a case, a default encryption key is used for encrypting the data.
+
+### Extra OAuth Tokens
+
+Some OAuth service providers provide additional information in the access token response. Eg: Twitter returns 2 additional tokens in it's access token response - *screen_name* and *user_id*.
+
+O2 provides all such tokens via the property - *extraTokens*. You can query this property after a successful OAuth exchange, i.e after the *linkingSucceeded()* signal has been emitted.
+
+## More Examples
+
+The *examples* folder contains complete example applications:
+
+Name | Description
+:-- | :--
+facebookdemo | Command line application authenticating with Facebook
+sialis | QT Quick Twitter client using OAuth 1
+twitterdemo | Command line client for authenticating with Twitter and posting status updates. Uses OAuth 1 or Twitter XAuth
+
+## Change Log
+
+### 0.1.0
+
+* Persist the extra tokens, too
+* Add Qt Quick Twitter client example
+
+
+
+

external/o2/README_QGIS.txt

@@ -0,0 +1,4 @@
+
+O2 Library from https://github.com/pipacs/o2/archive/31ceafb3f0c3b605110ddd20aeebd3288504ee1f.tar.gz
+
+Note: current master build of O2 is broken if built with keychain support