.. 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 <http://facepy.rtfd.org>_ 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 <https://github.com/jgorset/fandjango>_).
Installation
.. code:: bash
$ pip install facepy
Contribute
- Fork
the repository <http://github.com/jgorset/facepy>_. - 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 <http://twitter.com/jgorset>_ if you can't get it
to work. In fact, you should tweet me anyway.
I love Schibsted
I work at Schibsted Products & Technology <https://github.com/schibsted>_ 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.