core file

Author: Falicon

README.md

@@ -1,4 +1,12 @@
 Python-Hackpad-API
 ==================
 
-A simple wrapper library for the Hackpad API
+A simple wrapper library for the Hackpad API. [Hackpad API Documentation](https://hackpad.com/Public-Hackpad-API-Draft-nGhsrCJFlP7)
+
+
+Usage
+==================
+
+temp = Hackpad('your_hackpad_subdomain','your_hackpad_client_id','your_hackpad_secret')
+my_hackpads = temp.list_all()
+

hackpad.py

@@ -0,0 +1,161 @@
+"""
+ Simple wrapper for the Hackpad API v1.0
+ API Documentation: https://hackpad.com/Public-Hackpad-API-Draft-nGhsrCJFlP7
+"""
+
+import oauth2
+import requests
+import sys
+import time
+
+from urlparse import urljoin
+
+class Hackpad(object):
+  def __init__(self, sub_domain='', consumer_key='', consumer_secret=''):
+    self.sub_domain = sub_domain
+    self.consumer_key = consumer_key
+    self.consumer_secret = consumer_secret
+    return
+
+  def create_new_hackpad(self, asUser='', content_type='text/plain'):
+    api_link = 'pad/create'
+    params = {}
+    if asUser != '':
+      params['asUser'] = asUser
+    return self.do_api_request(api_link, 'POST', params, 'Hackpad Title\nHackpad contents.', content_type)
+
+  def get_pad_content(self, padId, revision='', response_format='txt', asUser=''):
+    api_link = 'pad/%s/content' % padId
+    if revision != '':
+      api_link += revision
+    api_link += '.%s' % format
+    params = {}
+    if asUser != '':
+      params['asUser'] = asUser
+    return self.do_api_request(api_link, 'GET', params)
+
+  def update_pad_content(self, padId, content='', asUser='', content_type='text/plain'):
+    api_link = 'pad/%s/content' % padId
+    params = {}
+    if asUser != '':
+      params['asUser'] = asUser
+    return self.do_api_request(api_link, 'POST', params, content, content_type)
+
+  def search_for_pads(self, q='', start=0, limit=10, asUser=''):
+    api_link = 'search'
+    params = {'q':q, 'start':start, 'limit':limit}
+    if asUser != '':
+      params['asUser'] = asUser
+    return self.do_api_request(api_link, 'GET', params)
+
+  def list_updated_pads(self, timestamp):
+    api_link = 'edited-since%s' % timestamp
+    params = {}
+    return self.do_api_request(api_link, 'GET', params)
+
+  def pad_revisions(self, padId, asUser=''):
+    api_link = 'pad/%s/revisions' % padId
+    params = {}
+    if asUser != '':
+      params['asUser'] = asUser
+    return self.do_api_request(api_link, 'GET', params)
+
+  def revert_pad(self, padId, revision, asUser=''):
+    api_link = 'pad/%s/revert-to/%s' % (padId, revision)
+    params = {}
+    if asUser != '':
+      params['asUser'] = asUser
+    return self.do_api_request(api_link, 'POST', params)
+
+  def revoke_access(self, padId, user, asUser=''):
+    api_link = 'pad/%s/revoke-access/%s' % (padId, user)
+    params = {}
+    if asUser != '':
+      params['asUser'] = asUser
+    return self.do_api_request(api_link, 'POST', params)
+
+  def pad_options(self, padId, asUser=''):
+    api_link = 'pad/%s/options' % padId
+    params = {}
+    if asUser != '':
+      params['asUser'] = asUser
+    return self.do_api_request(api_link, 'GET', params)
+
+  def set_pad_options(self, padId, settings={}, asUser=''):
+    api_link = 'pad/%s/options' % padId
+    params = {}
+    if asUser != '':
+      params['asUser'] = asUser
+    for key in settings.keys():
+      params[key] = settings[key]
+    return self.do_api_request(api_link, 'POST', params)
+
+  def user_settings(self, user, settings={}):
+    api_link = 'user/%s/settings' % user
+    params = {}
+    for key in settings.keys():
+      params[key] = settings[key]
+    return self.do_api_request(api_link, 'POST', params)
+
+  def user_deletion(self, user):
+    api_link = 'user/%s/remove' % user
+    return self.do_api_request(api_link, 'POST')
+
+  def user_creation(self, name, email):
+    api_link = 'user/create'
+    params = {'email':email, 'name':name}
+    return self.do_api_request(api_link, 'POST', params)
+
+  def list_all(self):
+    api_link = 'pads/all'
+    return self.do_api_request(api_link, 'GET')
+
+  def site_options(self):
+    api_link = 'options'
+    return self.do_api_request(api_link, 'GET')
+
+  def do_api_request(self, path, method, post_data={}, body='', content_type='text/plain'):
+    hackpad = {}
+    try:
+      api_method = urljoin('https://%s.hackpad.com/api/1.0/' % self.sub_domain, path)
+      params = {
+        'oauth_version': "1.0",
+        'oauth_nonce': oauth2.generate_nonce(),
+        'oauth_timestamp': int(time.time()),
+      }
+      for key in post_data.keys():
+        params[key] = post_data[key]
+      consumer = oauth2.Consumer(self.consumer_key, self.consumer_secret)
+      params['oauth_consumer_key'] = consumer.key
+      req = oauth2.Request(method='GET', url=api_method, parameters=params)
+      signature_method = oauth2.SignatureMethod_HMAC_SHA1()
+      req.sign_request(signature_method, consumer, None)
+      api_link = req.to_url()
+      if method.lower() == 'post':
+        r = requests.post(
+          api_link,
+          data=body,
+          headers={'Content-Type': content_type},
+          verify=False
+        )
+        hackpad = r.json
+      else:
+        if len(post_data.keys()) > 0:
+          r = requests.get(
+            api_link,
+            data=post_data,
+            headers={'Content-Type': 'text/plain'},
+            verify=False
+          )
+        else:
+          r = requests.get(
+            api_link,
+            headers={'Content-Type': 'text/plain'},
+            verify=False
+          )
+        hackpad = r.json
+    except:
+      print sys.exc_info()[0]
+
+    return hackpad
+