Change Log

All notable changes to this project will be documented in this file.

Unreleased

1.0.12 - 2020-04-04

Fixed

Mitigated a Facebook bug that causes get_extended_access_token to sometimes fail because it does not include expires_in. This now defaults to 1 hour.

1.0.11 - 2019-09-29

Fixed

Fixed a bug that caused get_extended_access_token to fail on newer Graph API versions.

1.0.10 - 2019-04-17

Added

Support for Python 3.7 (to be fair, it already worked, just tests were failing).
The logger is now named so you can silence retries.
You may now send additional data with DELETE requests.

Fixed

You may no longer search for posts, users, events, groups or checkins, as Facebook no longer allows it.

1.0.9 - 2017-05-30

Added

The HTTP headers of the response are now available in response['headers'].
FacebookError now has fbtrace_id to aid in debugging.

Fixed

Python 3 compatibility.
Paginated requests now retry same as the first.
Fixed a bug where image files would throw a UnicodeDecodeError.

Removed

FQL (which is not available since Graph API version 2.1)

1.0.8 - 2016-01-26

Fixed

Fixed an issue where get_application_access_token using Graph API versions 2.3+ would return JSON instead of a query string, resulting in an AttributeError to be thrown.

1.0.7 - 2015-09-08

Fixed

Fixed an issue where get_extended_access_token using Graph API versions 2.3+ would return JSON instead of a query string, resulting in an AttributeError to be thrown.
FacebookError instances now contain additional data about the error.

1.0.6 - 2015-01-07

Fixed

Fixed an issue where pagination of nested resources would break.

1.0.5 - 2015-01-05

Added

You may now specify the API version to use with GraphAPI.

1.0.4 - 2014-09-28

Added

Facepy now proxies the error message from Facebook for 5XX responses.
Facepy now raises FacebookError on any response in the 5XX range.

1.0.3 - 2014-06-17

Added

FacebookError, HTTPError, OAuthError and SignedRequestError are now available from the facepy module for convenience.
GraphAPI now raises FacebookError upon receiving HTTP 500 from Facebook.

1.0.2 - 2014-06-10

Added

GraphAPI now accepts an argument timeout, which can be either None or an integer describing how many seconds to wait for a response.

1.0.1 - 2014-05-22

Fixed

Fixed an issue where six would cause an ImportError unless already installed. It is now a direct dependency.

1.0.0 - 2014-05-22

Added

GraphAPI now supports securing Graph API requests with application secret proofs.
GraphAPI#post now supports user-generated images.

Fixed

The last bit of the tuple returned from get_extended_access_token is now None if the access token won't expire.
GraphAPI#batch can now handle more than 50 requests at a time.
Fixed a bug that caused unicode URLs to fail.

0.9.0 - 2014-02-12

Added

Changed GraphAPI methods to return decimal.Decimal instances for floating-point numbers instead of float, which can cause precision losses not acceptable for financial operations.
Nested dictionaries, lists and sets are now automatically encoded as JSON.
You may now elect to not verify Facebook's SSL certificate.
You may now substitute colons with underscores in keys such as fb:explicitly_shared.
Facepy is now compatible with Python 3.

Fixed

Fixed a bug that caused parsing signed requests to fail when the user key is not present.

0.8.4 - 2012-11-13

Fixed

Fixed a bug that caused a KeyError for signed requests that were missing some keys for its "page" attribute.

0.8.3 - 2012-10-04

Added

You may now extend access tokens with get_extended_access_token.

Fixed

Fixed a bug that caused batch requests with a body to fail.
Fixed a bug that caused paths that started with a slash to fail.
Fixed a bug that caused exception messages to be omitted.

0.8.2 - 2012-07-03

Added

Facepy exceptions may now be pickled.

0.8.1 - 2012-07-02

Fixed

Fixed a bug that caused pagination to stop prematurely.

0.8.0 - 2012-06-22

Added

You may now query application access tokens with get_application_access_token.
SignedRequest.parse now returns a dictionary describing the payload of the signed request instead of a SignedRequest instance.
SignedRequest.__init__ now accepts arguments signed_request and application_secret_key and no longer facilitates for constructing arbitrary signed requests.
SignedRequest#generate no longer requires the provision of application_secret_key.
GraphAPI now supports retries for get, post, delete, search and fql.
GraphAPI#get is now more intelligent about pagination and should no longer query Facebook for another page of results if the current page has less elements than limit.

Removed

SignedRequest#oauth_token and SignedRequest.OAuthToken have been removed (deprecated since v0.6).

Fixed

Fixed a bug that caused some exceptions to be returned rather than raised.

0.7.0 - 2012-06-13

Added

You may now access the original data of the signed request from SignedRequest#raw.
You may now issue FQL queries with GraphAPI#fql.
FacebookError exceptions yielded from GraphAPI#batch now include the request that produced the error.

Fixed

Fixed a bug that caused GraphAPI#batch to crash upon receiving legacy errors from Facebook.

0.6.9 - 2012-05-27

Added

Facepy will now raise OAuthError for authorization-related errors.
Facepy will now reuse the connection to Facebook.

0.6.8 - 2012-04-25

Fixed

Fixed a bug that caused a KeyError upon parsing errors without an error code.

0.6.7 - 2012-04-23

Added

Facepy now raises GraphAPI.HTTPError for requests whose transport failed, and GraphAPI.FacebookError for requests that produced an error in Facebook's API.

Fixed

Fixed a bug that caused some errors to be ignored.
Fixed a bug that caused an error for empty batch responses.

0.6.6 - 2012-03-28

Added

Facepy now supports batch requests.

0.6.5 - 2012-03-09

Added

Updated requests.

0.6.4 - 2012-01-16

Fixed

Fixed a bug that caused SignedRequest.User#has_authorized_application to be incorrect for signed requests with an user id, but no OAuth Token.
Fixed a bug that caused queries that returned 3xx status codes to yield a blank string

0.6.3 - 2012-01-12

Fixed

Fixed a bug that caused installation to fail in some circumstances.

0.6.2 - 2012-01-10

Fixed

Fixed a bug that caused a KeyError upon parsing a signed request that didn't include the user's age.

0.6.1 - 2012-01-06

Fixed

Fixed a bug that caused a NameError upon providing a list of strings as a Graph API parameter.

0.6.0 - 2012-01-05

Added

Search results may now be paged.
facepy.VERSION is now facepy.__version__

0.5.1 - 2011-12-03

Added

It is now considerably easier to create signed requests programmatically.

0.5.0 - 2011-11-07

Added

Facepy now returns the complete API response instead of just its "data" attribute.

0.4.2 - 2011-11-03

Added

Facepy is now compatible with Python 2.4.

Fixed

Fixed a bug that caused a KeyError if the user's locale or country is missing from the signed request.

0.4.1 - 2011-11-02

Fixed

Fixed a bug that caused a TypeError upon parsing signed requests in unicode.

0.4.0 - 2011-11-02

Added

Added support for parsing and reverse-engineering signed requests.
Added support for file-like objects in POST and PUT.

0.3.1 - 2011-09-17

Fixed

Fixed a bug that prevented the 'page' argument to GraphAPI#get from working correctly.

0.3.0 - 2011-09-16

Added

GraphAPI#get now has a new argument 'page', which returns a generator that iterates over each page of results.

0.2.3 - 2011-08-15

Added

The GraphAPI class may now be initialized by signed request.

0.2.2 - 2011-05-26

Fixed

Fix a bug that caused non-JSON data (e.g. pictures) to raise a ValueError.

0.2.1 - 2011-05-10

Fixed

Fix a bug that caused a TypeError if the 'path' argument is an integer.

0.2.0 - 2011-05-10

Added

Exceptions have been moved.