Metadata-Version: 1.0
Name: tornado-facebook-sdk
Version: 0.1.0
Summary: A tornado based facebook graph api wrapper
Home-page: https://github.com/pauloalem/tornado-facebook-sdk
Author: Paulo Alem
Author-email: biggahed@gmail.com
License: OSI
Description: ====================
        tornado-facebook-sdk
        ====================
        
        What is it?
        -----------
        The tornado-facebook-sdk is a library that aims
        to ease the task of writing non-blocking, server side,
        facebook social graph accessing code.
        It's built using `tornado <https://github.com/facebook/tornado>`_.
        This makes tornado-facebook-sdk a perfect fit if you're
        developing an application using tornado.
        
        Installing
        ----------
        The prefered way to install is via pip ::
        
        $ pip install tornado-facebook-sdk
        
        From github, for the last version ::
        
        $ pip install git+https://github.com/pauloalem/tornado-facebook-sdk.git
        
        Or you can just download it and install via setup.py, it's up to you.
        
        Using
        -----
        Getting facebook's public page ::
        
            from tornado import ioloop
            from facebook import GraphAPI
        
            ioloop = ioloop.IOLoop.instance()
            graph = GraphAPI()
        
            # a simple callback that prints social graph responses
            def print_callback(data):
                print data
                ioloop.stop()
        
            graph.get_object('/facebook', callback=print_callback)
        
            ioloop.start()
        
        Authenticating with a user auth token and printing it's name ::
        
            graph = GraphAPI(access_token)
        
            #do something with the user's data, like print it's first name
            def get_first_name(me):
                print me['first_name']
                ioloop.stop()
        
            result = graph.get_object('/me', callback=get_first_name)
            ioloop.start()
        
        Posting on an user's wall ::
        
        
            def callback(response):
                # ...
            graph.post_wall("Maoe!", callback=callback)
        
        Which is just a shortcut for ::
        
        
            def callback(response):
                # ...
            graph.put_object('me', 'feed', message="Maoe!!", callback=callback)
        
        
        Deleting an object ::
        
            def callback(response):
                # ...
            graph.delete_object(obj_id, callback=callback)
        
        License
        -------
        Read LICENSE.txt
        
        History
        -------
        This library is based on the `facebook-sdk <https://github.com/pythonforfacebook/facebook-sdk>`_ library.
        Originaly, I was going to use it as it's simple and has a nice
        interface, but it's blocking code makes it a no-no.
        
Platform: UNKNOWN
