Further work being done on streams; all basic streams implemented
[diaspy.git] / diaspy / client.py
index bf3ddd915ce60dcd7b7157d5bb32819d7f044d83..8eaab4461198257b7e1d2562d5af441b9bf6eba2 100644 (file)
@@ -1,12 +1,10 @@
-import requests
-import re
-import json
 import diaspy.models
+import diaspy.streams
+import diaspy.connection
 
 
 class Client:
     """This is the client class to connect to Diaspora.
-
     """
     def __init__(self, pod, username, password):
         """
@@ -17,157 +15,55 @@ class Client:
         :param password: The password used to log in.
         :type password: str
         """
-        self._token_regex = re.compile(r'content="(.*?)"\s+name="csrf-token')
+        self.connection = diaspy.connection.Connection(pod, username, password)
+        self.connection.login()
         self.pod = pod
-        self.session = requests.Session()
-        self._post_data = {}
-        self._setlogindata(username, password)
-        self._login()
-
-    def _sessionget(self, string):
-        """This method gets data from session. 
-        Performs additional checks if needed. 
-
-        Example:
-            To obtain 'foo' from pod one should call `_sessionget('foo')`. 
-
-        :param string: URL to get without the pod's URL and slash eg. 'stream'.
-        :type string: str
-        """
-        return self.session.get('{0}/{1}'.format(self.pod, string))
-
-    def get_token(self):
-        """This function gets a token needed for authentication in most cases
-
-        :returns: string -- token used to authenticate
-        """
-        r = self._sessionget('stream')
-        token = self._token_regex.search(r.text).group(1)
-        return token
-
-    def _setlogindata(self, username, password):
-        """This function is used to set data for login. 
-        
-        .. note::
-            It should be called before _login() function.
-        """
-        self._username, self._password = username, password
-        self._login_data =  {
-                            'user[username]': self._username,
-                            'user[password]': self._password,
-                            'authenticity_token': self.get_token(),
-                            }
-
-    def _login(self):
-        """This function is used to connect to the pod and log in.
-        """
-        r = self.session.post('{0}/users/sign_in'.format(self.pod),
-                              data=self._login_data,
-                              headers={'accept': 'application/json'})
-        
-        if r.status_code != 201: raise Exception('{0}: Login failed.'.format(r.status_code))
-
-    def _setpostdata(self, text, aspect_id, photos):
-        """This function prepares data for posting.
-        :param text: Text to post.
-        :type text: str
-        :param aspect_id: Aspect id to send post to.
-        :type aspect_id: str
-        """
-        data = {}
-        data['aspect_id'] = aspect_id
-        data['status_message'] = {'text': text}
-        if photos: data['photos'] = photos
-        self._post_data = data
-
-    def _post(self):
-        """Sends post to an aspect.
-
-        :returns: diaspy.models.Post -- the Post which has been created
-        """
-        r = self.session.post('{0}/status_messages'.format(self.pod),
-                              data=json.dumps(self._post_data),
-                              headers={'content-type': 'application/json',
-                                       'accept': 'application/json',
-                                       'x-csrf-token': self.get_token()})
-        if r.status_code != 201: raise Exception('{0}: Post could not be posted.'.format(r.status_code))
+        self.stream = diaspy.streams.Stream(self.connection, 'stream.json')
 
-        return diaspy.models.Post(str(r.json()['id']), self)
-
-    def post(self, text, aspect_id='public', photos=None):
+    def post(self, text, aspect_ids='public', photos=None):
         """This function sends a post to an aspect
 
         :param text: Text to post.
         :type text: str
-        :param aspect_id: Aspect id to send post to.
-        :type aspect_id: str
+        :param aspect_ids: Aspect ids to send post to.
+        :type aspect_ids: str
 
         :returns: diaspy.models.Post -- the Post which has been created
         """
-        self._setpostdata(text, aspect_id, photos)
-        post = self._post()
-        self._post_data = {}
+        post = self.stream.post(text, aspect_ids, photos)
         return post
 
-    def get_user_info(self):
-        """This function returns the current user's attributes.
-
-        :returns: dict -- json formatted user info.
-        """
-        r = self._sessionget('bookmarklet')
-        regex = re.compile(r'window.current_user_attributes = ({.*})')
-        userdata = json.loads(regex.search(r.text).group(1))
-        return userdata
-
     def post_picture(self, filename):
         """This method posts a picture to D*.
 
         :param filename: Path to picture file.
         :type filename: str
         """
-        aspects = self.get_user_info()['aspects']
-        params = {}
-        params['photo[pending]'] = 'true'
-        params['set_profile_image'] = ''
-        params['qqfile'] = filename
-        for i, aspect in enumerate(aspects):
-            params['photo[aspect_ids][%d]' % (i)] = aspect['id']
+        return self.stream.post_picture(filename)
 
-        data = open(filename, 'rb')
-
-        headers = {'content-type': 'application/octet-stream',
-                   'x-csrf-token': self.get_token(),
-                   'x-file-name': filename}
-
-        r = self.session.post('{0}/photos'.format(self.pod),
-                              params=params, data=data, headers=headers)
-
-        return r
+    def get_activity(self):
+        """This function returns activity stream.
+        :returns: diaspy.streams.Activity
+        """
+        activity = diaspy.streams.Activity(self.connection, 'activity.json')
+        return activity
 
     def get_stream(self):
-        """This functions returns a list of posts found in the stream.
+        """This functions returns stream.
 
-        :returns: list -- list of Post objects.
+        :returns: diaspy.streams.Stream
         """
-        data = {'authenticity_token': self.get_token()}
-        r = self._sessionget('stream.json')
-
-        if r.status_code != 200: 
-            raise Exception('wrong status code: {0}'.format(r.status_code))
-
-        stream = r.json()
-        return [ diaspy.models.Post(str(post['id']), self) for post in stream ]
+        self.stream.update()
+        return self.stream
 
     def get_notifications(self):
         """This functions returns a list of notifications.
 
         :returns: list -- list of json formatted notifications
         """
-        data = {'authenticity_token': self.get_token()}
-        r = self._sessionget('notifications.json')
+        r = self.connection.get('notifications.json')
 
-        if r.status_code != 200: 
+        if r.status_code != 200:
             raise Exception('wrong status code: {0}'.format(r.status_code))
 
         notifications = r.json()
@@ -179,14 +75,13 @@ class Client:
 
         :returns: list -- list of Post objects
         """
-        data = {'authenticity_token': self.get_token()}
-        r = self._sessionget('mentions.json')
+        r = self.connection.get('mentions.json')
 
         if r.status_code != 200:
             raise Exception('wrong status code: {0}'.format(r.status_code))
 
         mentions = r.json()
-        return [ diaspy.models.Post(str(post['id']), self) for post in mentions ]
+        return [diaspy.models.Post(str(post['id']), self.connection) for post in mentions]
 
     def get_tag(self, tag):
         """This functions returns a list of posts containing the tag.
@@ -195,14 +90,27 @@ class Client:
 
         :returns: list -- list of Post objects
         """
-        data = {'authenticity_token': self.get_token()}
-        r = self._sessionget('tags/{0}.json'.format(tag))
+        r = self.connection.get('tags/{0}.json'.format(tag))
 
         if r.status_code != 200:
             raise Exception('wrong status code: {0}'.format(r.status_code))
 
         tagged_posts = r.json()
-        return [ diaspy.models.Post(str(post['id']), self) for post in tagged_posts ]
+        return [diaspy.models.Post(str(post['id']), self.connection) for post in tagged_posts]
+
+    def get_mailbox(self):
+        """This functions returns a list of messages found in the conversation.
+
+        :returns: list -- list of Conversation objects.
+        """
+        r = self.connection.get('conversations.json')
+
+        if r.status_code != 200:
+            raise Exception('wrong status code: {0}'.format(r.status_code))
+
+        mailbox = r.json()
+        return [diaspy.conversations.Conversation(str(conversation['conversation']['id']), self.connection)
+                for conversation in mailbox]
 
     def add_user_to_aspect(self, user_id, aspect_id):
         """ this function adds a user to an aspect.
@@ -213,18 +121,22 @@ class Client:
         :type aspect_id: str
 
         """
-
-        data = {'authenticity_token': self.get_token(),
+        data = {'authenticity_token': self.connection.getToken(),
                 'aspect_id': aspect_id,
                 'person_id': user_id}
 
-        r = self.session.post('{0}/aspect_memberships.json'.format(self.pod),
-                              data=data)
+        r = self.connection.post('aspect_memberships.json', data=data)
 
         if r.status_code != 201:
             raise Exception('wrong status code: {0}'.format(r.status_code))
         return r.json()
 
+    def add_aspect(self, aspect_name, visible=0):
+        """ This function adds a new aspect.
+        """
+        aspects = diaspy.streams.Aspects(self.connection)
+        aspects.add(aspect_name, visible)
+
     def remove_user_from_aspect(self, user_id, aspect_id):
         """ this function removes a user from an aspect.
 
@@ -234,61 +146,31 @@ class Client:
         :type aspect_id: str
 
         """
-
-        data = {'authenticity_token': self.get_token(),
+        data = {'authenticity_token': self.connection.getToken(),
                 'aspect_id': aspect_id,
                 'person_id': user_id}
 
-        r = self.session.delete('{0}/aspect_memberships/42.json'.format(self.pod),
-                                data=data)
+        r = self.connection.delete('aspect_memberships/42.json',
+                                   data=data)
 
         if r.status_code != 200:
             raise Exception('wrong status code: {0}'.format(r.status_code))
 
         return r.json()
 
-    def add_aspect(self, aspect_name, visible=0):
-        """ This function adds a new aspect.
-        """
-
-        data = {'authenticity_token': self.get_token(),
-                'aspect[name]': aspect_name,
-                'aspect[contacts_visible]': visible}
-
-        r = self.session.post('{0}/aspects'.format(self.pod),
-                              data=data)
-
-        if r.status_code != 200:
-            raise Exception('wrong status code: {0}'.format(r.status_code))
-
     def remove_aspect(self, aspect_id):
         """ This function adds a new aspect.
         """
+        data = {'authenticity_token': self.connection.getToken()}
 
-        data = {'authenticity_token': self.get_token()}
-
-        r = self.session.delete('{0}/aspects/{1}'.format(self.pod, aspect_id),
-                                data=data)
+        r = self.connection.delete('aspects/{}'.format(aspect_id),
+                                   data=data)
 
         if r.status_code != 404:
             raise Exception('wrong status code: {0}'.format(r.status_code))
 
-    def get_mailbox(self):
-        """This functions returns a list of messages found in the conversation.
-
-        :returns: list -- list of Conversation objects.
-        """
-        data = {'authenticity_token': self.get_token()}
-        r = self._sessionget('conversations.json')
-
-        if r.status_code != 200:
-            raise Exception('wrong status code: {0}'.format(r.status_code))
-
-        mailbox = r.json()
-        return [ diaspy.conversations.Conversation(str(conversation['conversation']['id']), self) for conversation in mailbox ]
-
     def new_conversation(self, contacts, subject, text):
-        """ start a new conversation
+        """Start a new conversation.
 
         :param contacts: recipients ids, no guids, comma sperated.
         :type contacts: str
@@ -296,19 +178,17 @@ class Client:
         :type subject: str
         :param text: text of the message.
         :type text: str
-
         """
-
         data = {'contact_ids': contacts,
                 'conversation[subject]': subject,
                 'conversation[text]': text,
                 'utf8': '✓',
-                'authenticity_token': self.get_token()}
+                'authenticity_token': self.connection.getToken()}
 
-        r = self.session.post('{0}/conversations/'.format(self.pod),
-                              data=data,
-                              headers={'accept': 'application/json'})
+        r = self.connection.post('conversations/',
+                                 data=data,
+                                 headers={'accept': 'application/json'})
         if r.status_code != 200:
-            raise Exception('{0}: Conversation could not be started.'.format(r.status_code))
-
+            raise Exception('{0}: Conversation could not be started.'
+                            .format(r.status_code))
         return r.json()