typo

[z_archive/twitter.git] / twitter / api.py

diff --git a/twitter/api.py b/twitter/api.py
index f3d661299ad760b8e8a3f53fbfee5a2b5eb4aee2..42d9e53a62aee3f00c8959ac9822805688023c1f 100644 (file)
--- a/twitter/api.py
+++ b/twitter/api.py
@@ -1,12 +1,10 @@
 
-from base64 import encodestring
-from urllib import urlencode
-
 import urllib2
 
 from exceptions import Exception
 
 from twitter.twitter_globals import POST_ACTIONS
+from twitter.auth import UserPassAuth, NoAuth
 
 def _py26OrGreater():
     import sys
@@ -19,17 +17,31 @@ else:
 
 class TwitterError(Exception):
     """
-    Exception thrown by the Twitter object when there is an
-    error interacting with twitter.com.
+    Base Exception thrown by the Twitter object when there is a
+    general error interacting with the API.
     """
     pass
 
+class TwitterHTTPError(TwitterError):
+    """
+    Exception thrown by the Twitter object when there is an
+    HTTP error interacting with twitter.com.
+    """
+    def __init__(self, e, uri, format, encoded_args):
+      self.e = e
+      self.uri = uri
+      self.format = format
+      self.encoded_args = encoded_args
+
+    def __str__(self):
+        return "Twitter sent status %i for URL: %s.%s using parameters: (%s)\ndetails: %s" %(
+                    self.e.code, self.uri, self.format, self.encoded_args, self.e.fp.read())
+
 class TwitterCall(object):
     def __init__(
-        self, username, password, format, domain, uri="", agent=None,
+        self, auth, format, domain, uri="", agent=None,
         encoded_args=None, secure=True):
-        self.username = username
-        self.password = password
+        self.auth = auth
         self.format = format
         self.domain = domain
         self.uri = uri
@@ -42,11 +54,11 @@ class TwitterCall(object):
             return object.__getattr__(self, k)
         except AttributeError:
             return TwitterCall(
-                self.username, self.password, self.format, self.domain,
-                self.uri + "/" + k, self.agent, self.encoded_args)
+                self.auth, self.format, self.domain,
+                self.uri + "/" + k, self.agent, self.encoded_args, self.secure)
 
     def __call__(self, **kwargs):
-        uri = self.uri
+        uri = self.uri.strip("/")
         method = "GET"
         for action in POST_ACTIONS:
             if self.uri.endswith(action):
@@ -55,11 +67,20 @@ class TwitterCall(object):
                     kwargs["source"] = self.agent
                 break
 
+        secure_str = ''
+        if self.secure:
+            secure_str = 's'
+        dot = ""
+        if self.format != '':
+            dot = "."
+        uriBase = "http%s://%s/%s%s%s" %(
+                    secure_str, self.domain, uri, dot, self.format)
+
         if (not self.encoded_args):
             if kwargs.has_key('id'):
                 uri += "/%s" %(kwargs['id'])
-    
-            self.encoded_args = urlencode(kwargs.items())
+
+            self.encoded_args = self.auth.encode_params(uriBase, method, kwargs)
 
         argStr = ""
         argData = None
@@ -72,18 +93,10 @@ class TwitterCall(object):
         headers = {}
         if (self.agent):
             headers["X-Twitter-Client"] = self.agent
-        if (self.username):
-            headers["Authorization"] = "Basic " + encodestring("%s:%s" %(
-                self.username, self.password)).strip('\n')
+        if self.auth is not None:
+            headers.update(self.auth.generate_headers())
 
-        secure_str = ''
-        if self.secure:
-            secure_str = 's'
-
-        req = urllib2.Request(
-                "http%s://%s/%s.%s%s" %(
-                    secure_str, self.domain, uri, self.format, argStr),
-                argData, headers)
+        req = urllib2.Request(uriBase+argStr, argData, headers)
         
         try:
             handle = urllib2.urlopen(req)
@@ -95,9 +108,7 @@ class TwitterCall(object):
             if (e.code == 304):
                 return []
             else:
-                raise TwitterError(
-                    "Twitter sent status %i for URL: %s.%s using parameters: (%s)\ndetails: %s" %(
-                        e.code, uri, self.format, self.encoded_args, e.fp.read()))
+                raise TwitterHTTPError(e, uri, self.format, self.encoded_args)
 
 class Twitter(TwitterCall):
     """
@@ -164,16 +175,25 @@ class Twitter(TwitterCall):
     """
     def __init__(
         self, email=None, password=None, format="json", domain="twitter.com",
-        agent=None, secure=True):
+        agent=None, secure=True, auth=None):
         """
         Create a new twitter API connector using the specified
         credentials (email and password). Format specifies the output
         format ("json" (default) or "xml").
         """
-        if (format not in ("json", "xml")):
+        
+        if email is not None or password is not None:
+            if auth is not None:
+                raise ValueError, "can't specify 'email' or 'password' and 'auth' params"
+            auth = UserPassAuth(email, password)
+
+        if not auth:
+            auth = NoAuth()
+
+        if (format not in ("json", "xml", "")):
             raise TwitterError("Unknown data format '%s'" %(format))
         TwitterCall.__init__(
-            self, email, password, format, domain, "", agent, 
+            self, auth, format, domain, "", agent, 
             secure=secure)
 
-__all__ = ["Twitter", "TwitterError"]
+__all__ = ["Twitter", "TwitterError", "TwitterHTTPError"]