Metadata-Version: 2.1
Name: facebook-py-sdk
Version: 1.2.0
Summary: Facebook Python SDK
Home-page: https://github.com/eventbrite/facebook-py-sdk
Author: Zeta Hernandez
Author-email: zetahernandez@gmail.com
License: MIT
Description: Facebook SDK Python
        ===================
        
        .. image:: https://travis-ci.org/eventbrite/facebook-py-sdk.svg?branch=master
            :target: https://travis-ci.org/eventbrite/facebook-py-sdk
        .. image:: https://coveralls.io/repos/github/eventbrite/facebook-py-sdk/badge.svg
            :target: https://coveralls.io/github/eventbrite/facebook-py-sdk
        
        Facebook SDK Python is a python based implementation of `Facebook PHP SDK`_
        
        .. contents:: Table of Contents
        
        
        Installation
        ============
        
        To install Facebook SDK Python, simply:
        
        .. code-block:: bash
        
            $ pip install facebook-py-sdk
        
        Usage
        =====
        
        Retrieve User Profile
        ---------------------
        
        .. code-block:: python
        
            from facebook_sdk.exceptions import FacebookResponseException
            from facebook_sdk.facebook import Facebook
        
            facebook = Facebook(
                app_id='{app_id}',
                app_secret='{app_secret}',
                default_graph_version='v2.12',
            )
        
            facebook.set_default_access_token(access_token='{access_token}')
        
            try:
                response = facebook.get(endpoint='/me?fields=id,name')
            except FacebookResponseException as e:
                print(e.message)
            else:
                print('User id: %(name)s' % {'name': response.json_body.get('id')})
                print('User name: %(name)s' % {'name': response.json_body.get('name')})
        
        
        Batch Upload Files
        ------------------
        
        .. code-block:: python
        
            from facebook_sdk.exceptions import FacebookResponseException
            from facebook_sdk.facebook import Facebook
        
            facebook = Facebook(
                app_id='{app_id}',
                app_secret='{app_secret}',
            )
        
            facebook.set_default_access_token(access_token='{access_token}')
        
            batch = {
                'photo-one': facebook.request(
                    endpoint='/me/photos',
                    params={
                        'message': 'Foo photo.',
                        'source': facebook.file_to_upload('path/to/foo.jpg'),
                    },
                ),
                'photo-two': facebook.request(
                    endpoint='/me/photos',
                    params={
                        'message': 'Bar photo.',
                        'source': facebook.file_to_upload('path/to/bar.jpg'),
                    },
                ),
                'photo-three': facebook.request(
                    endpoint='/me/photos',
                    params={
                        'message': 'Other photo.',
                        'source': facebook.file_to_upload('path/to/other.jpg'),
                    },
                )
            }
        
            try:
                responses = facebook.send_batch_request(requests=batch)
            except FacebookResponseException as e:
                print(e.message)
        
        
        Dependencies
        ============
        
        Dependencies that to use the application:
        
        * requests_
        
        .. _requests: http://docs.python-requests.org/en/latest/
        .. _Facebook PHP SDK: https://developers.facebook.com/docs/reference/php/
        
        Contributing
        ============
        
        Please use github model by forking the repository and making Pull Requests.
        
        Running tests
        -------------
        
        .. code-block:: bash
        
         ➜  facebook-python-sdk $ pip install -e .[testing]
         ➜  facebook-python-sdk $ pytest
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Provides-Extra: testing
