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).

$ pip install facepy

• 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!

Johannes Gorset made this. You should tweet me if you can't get it to work. In fact, you should tweet me anyway.

I work at Hyper with a bunch of awesome folks who are all every bit as passionate about good code as myself. If you're using this library, we probably want to hire you.