summaryrefslogtreecommitdiff
path: root/protocols/Twitter/oauth/README
diff options
context:
space:
mode:
authorVadim Dashevskiy <watcherhd@gmail.com>2012-06-06 20:17:58 +0000
committerVadim Dashevskiy <watcherhd@gmail.com>2012-06-06 20:17:58 +0000
commitab92c2a5cd5427bf8a33d06afdb64b88d2d640ed (patch)
treefc82f068ad7bf8e141b6148f2ff191eab56e1f5a /protocols/Twitter/oauth/README
parent441daff7dfc4cd80075cfbec3345192aab4353b5 (diff)
Twitter updated
git-svn-id: http://svn.miranda-ng.org/main/trunk@337 1316c22d-e87f-b044-9b9b-93d7a3e3ba9c
Diffstat (limited to 'protocols/Twitter/oauth/README')
-rw-r--r--protocols/Twitter/oauth/README63
1 files changed, 63 insertions, 0 deletions
diff --git a/protocols/Twitter/oauth/README b/protocols/Twitter/oauth/README
new file mode 100644
index 0000000000..ad28f1a4f2
--- /dev/null
+++ b/protocols/Twitter/oauth/README
@@ -0,0 +1,63 @@
+liboauth is a collection of c functions implementing the http://oauth.net API.
+
+liboauth provides functions to escape and encode stings according to
+OAuth specifications and offers high-level functionality built on top to sign
+requests or verify signatures using either NSS or OpenSSL for calculating
+the hash/signatures.
+
+The included documentation in the doc/ folder and example code from tests/
+can also be found online at http://liboauth.sourceforge.net/
+
+Send bug-reports, patches or suggestions to robin@gareus.org.
+or inquire information at http://groups.google.com/group/oauth/
+
+ == License and Notes ==
+
+The source-code of liboauth can be distributed under MIT License,
+or at your option: in terms of the the GNU General Public License.
+see COPYING.MIT or COPYING.GPL for details.
+
+Note: OpenSSL is not strictly compatible with the GPL license.
+An exemption (to the GPL) allowing to link and redistribute
+liboauth with the OpenSSL library is is included in the source files.
+for more information, see LICENSE.OpenSSL and
+http://lists.debian.org/debian-legal/2004/05/msg00595.html
+
+You can avoid this whole issue by using NSS instead of OpenSSL;
+configure with '--enable-nss'.
+
+The Debian packaging that comes with the source-code is licensed under
+the GNU General Public License.
+
+ == Test and Example Code ==
+
+After compilation `make check` can be used to perform a off-line self-test.
+
+There is also example code to perform and verify OAuth requests online,
+but they are not run automatically.
+
+
+ tests/oauthexample.c - CONNECTS TO INTERNET
+ walk-though http://term.ie/oauth/example
+
+ tests/oauthtest.c - CONNECTS TO INTERNET
+ gets a request-token from http://term.ie test-server
+
+ tests/oauthtest2.c - CONNECTS TO INTERNET
+ gets a request-token from http://term.ie test-server
+ using OAuth HTTP Authorization header:
+ see http://oauth.net/core/1.0a/#auth_header
+ and http://oauth.net/core/1.0a/#consumer_req_param
+
+ tests/selftest_wiki.c
+ tests/selftest_eran.c
+ Test-Cases for parameter encoding, signatures, etc
+
+ tests/commontest.c
+ Common Test-Case functions exercising the low-level API used by self-tests.
+
+ tests/oauthdatapost.c - CONNECTS TO INTERNET
+ Experimental code to sign data uploads
+ Note: The example keys have since been deleted from the test-server.
+ Code remains for inspiration/example purposes.
+