Open source C library for the Flickr application

Flickcurl is a C library for the Flickr API, handling creating the requests, signing, token management, calling the API, marshalling request parameters and decoding responses.

Flickcurl uses libcurl to call the REST web service and libxml2 to manipulate the XML responses. Flickcurl 1.0 or later supports 100% of the 2008-01-23 version of the API (see Flickcurl API coverage) including the functions for photo uploading, browsing,

Flickcurl also includes a program flickrdf to turn photo metadata, tags and machine tags into RDF descriptions of photos and tags.

NOTE: Flickcurl is released under LGPL 2.1 / GPL 2 / Apache 2.0.

Requirements:

· libcurl
· libxml2 2.6.8 or newer
· raptor 1.4.0 (optional), 1.4.14 recommended

What's New in This Release: [ read full changelog ]

· Added PHOTO_FIELD_location_neighbourhood, PHOTO_FIELD_neighbourhood_placeid, PHOTO_FIELD_neighbourhood_woeid, PHOTO_FIELD_location_neighbourhood and FLICKCURL_PLACE_NEIGHBOURHOOD enum values making the American English spelling versions aliases for the British / Commonwealth English. Adjusted the XPaths to accept both spellings just in case Flickr changes this. The neighbourhood / neighborhood feature was announced 2008-08-19.
· Added flickcurl_places_forUser() function for new API call flickr.places.placesForUser to get the cluster of places for a user as announced 2008-09-04.
· Added support for the (experimental) Photos List feed format parameter by the new feature of allowing any function that returns a Standard Photos Response to send the same optional result parameters, including format. This is done by adding new typedefs flickcurl_photos_list for the standard photos response and flickcurl_photos_list_params for the parameters. This allows for existing result parameters (page, per_page, extras) as well as the new new format parameter to be given optionally. The standard photos response format was described 2008-08-19 and the experimental feeds format feature was announced 2008-08-25.
· Added functions to return lists of photos with list results parameters based on existing functions without the _params suffix. The functions all take a flickcurl_photos_list_params to replace any existing extras, page and/or per_page parameters and return a new flickcurl_photos_list object on success.
· Added int flickcurl_photos_list_params_init() to initialize a photos list parameter object and flickcurl_free_photos_list() to destroy a photos list object.
· Added a flickcurl_location to a flickcurl_place for the new flickcurl_places_forUser() function.
· Added flickcurl_get_feed_format_info() to get the names and descriptions of the current known feed 'format' parameter values, as usable by the '_params' functions mentioned above.
· Added flickcurl_get_extras_format_info() to get the names and descriptions of the current known 'extras' parameter values, as usable by the '_params' functions mentioned above.
· Added flickcurl_search_params_init() to initialize a search parameter object
· Fixed building contexts to not expect the number of contexts to be 3 (!!) but allocate it based on the returned XML. Bug reported by Francis Gastellu.
· Fixed typo in the FOAF namespace - no trailing #
· Updated flickcurl(1) utility to help with authentication configuration. It now prints a help message on how to get authentication tokens set up, when there is no configuration file present and now accepts -a FROB as an entire command line to get the auth token from the web service via the mobile frob.
· Updated flickcurl(1) utility help message to explain list result parameters in more detail, enumerating the known format and extra values using the new flickcurl_get_extras_format_info() and flickcurl_get_feed_format_info() functions.
· All flickcurl(1) utility command options that accept booleans, now recognise "true", "false", "yes" and "no" values as well as the existing 'non-zero integer means true' form.
· Updated flickcurl(1) utility command photos.recentlyUpdated now enforces it's required parameter - min-date.
· Updated flickcurl(1) utility to understand raw format results and write them either to stdout (default) or a file, when called with -o FILE or --output FILE.
· Updated flickcurl(1) utility to add a -q / --quiet to be less verbose in its output. This option does not make informational requests generate no output!
· Improved error reporting when an API fails (returns non-200), an error message is called via the error handler (set by flickcurl_set_error_handler()).