https://github.com/jgorset/facepy

Facepy makes it really easy to use Facebook's Graph API with Python
https://github.com/jgorset/facepy

api-client facebook graph python

Last synced: 5 days ago
JSON representation

Facepy makes it really easy to use Facebook's Graph API with Python

• Host: GitHub
• URL: https://github.com/jgorset/facepy
• Owner: jgorset
• License: mit
• Created: 2011-04-20T19:27:48.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2020-04-04T13:19:22.000Z (over 4 years ago)
• Last Synced: 2024-10-31T22:32:56.324Z (13 days ago)
• Topics: api-client, facebook, graph, python
• Language: Python
• Homepage:
• Size: 405 KB
• Stars: 863
• Watchers: 56
• Forks: 199
• Open Issues: 3
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
.. image::  https://raw.githubusercontent.com/jgorset/facepy/master/docs/banner.png

|version| |pythons| |downloads| |build| |license|

.. |version| image:: https://img.shields.io/pypi/v/facepy.svg

.. |pythons| image:: https://img.shields.io/pypi/pyversions/facepy.svg

.. |downloads| image:: https://img.shields.io/pypi/dm/facepy.svg

.. |build| image:: https://img.shields.io/travis/jgorset/facepy.svg

.. |license| image:: https://img.shields.io/github/license/jgorset/facepy.svg

Usage

-----

.. code:: python

    from facepy import GraphAPI

    # Initialize the Graph API with a valid access token (optional,

    # but will allow you to do all sorts of fun stuff).

    graph = GraphAPI(oauth_access_token)

    # Get my latest posts

    graph.get('me/posts')

    # Post a photo of a parrot

    graph.post(

        path = 'me/photos',

        source = open('parrot.jpg', 'rb')

    )

Facepy can do more than reading your latest posts and posting photographs of parrots, but you'll have to

`read the documentation `_ to find out how.

Please note that Facepy does *not* do authentication with Facebook; it only consumes its API. To get an

access token to consume the API on behalf of a user, use a suitable OAuth library for your platform (if you're

using Django, for example, you might use `Fandjango `_).

Installation

------------

.. code:: bash

    $ pip install facepy

Contribute

----------

* Fork `the repository `_.

* Do your thing (preferably on a feature branch).

* Write a test that demonstrates that the bug was fixed or the feature works as expected.

* Send a pull request and bug me until I merge it!

I love you

----------

Johannes Gorset made this. You should `tweet me `_ if you can't get it

to work. In fact, you should tweet me anyway.

I love Schibsted

----------------

I work at `Schibsted Products & Technology `_ with a bunch of awesome folks

who are every bit as passionate about building things as I am. If you're using

Facepy, we probably want to hire you.