Flickr::Tools ============= Some of these modules are being integrated with the Flickr::API distribution started by Cal Henderson. The rest are being reworked to follow more current practice. A NOTE ON TESTING For complete testing, some additional information is required from you (your api_key and secret, for example) which is stored in a storable formatted config file. Other additional information is in key/value pairs in the test values file. make test MAKETEST_OAUTH_CFG=$HOME/oauth-testing.st [TEST_VERBOSE=1] MAKETEST_VALUES=$HOME/values_file There are some simple tools for building these files in the Flickr::API distribution scripts directory. THE MODULES These modules provide a set of classes that can be used to work with Flickr, using it's REST API, as provided by the Flickr::API distribution. The object of this set of classes is to take the "raw" interface that the Flickr::API provides and turn it into a more usable set of objects which are easier and faster to use, while providing full access to all the functionality provided by Flickr. This distribution formerly provided two sets of classes: -> The Flickr::API::* modules (eg: Flickr::API::Photos, Flickr::API::People) provide a lower-level way to access the information. They essentially get the output from the Flickr::API module and transform in into a cleaner, easier to work with hash. These modules are essentially there to be used by the next set of modules, but they may be used directly if you should wish to do so. These modules are moving into Flickr::API distribution. -> The Flickr::Tools::* modules (eg: Flickr::Tools::Person, Flickr::Tools::Photo) provide higher-level access to the information on a photo, person, etc. This is the preferred interface that a typical programmer might choose to use. These modules are continuing in the Flickr::Tools distribution. STATUS This is an early release of the distribution and there are only a limited number of methods available at the moment. Also, this is a "testing the waters" version. I expect the API of the objects will change. Read the TODO file for some of the plans for the future of this distribution. INSTALLATION You probably don't want to install v1.21 of Flickr::Tools, V1.22 may by marginally useful. To install this module, run the following commands: perl Makefile.PL make make test make install DEPENDENCIES Flickr::API Moo CHI Type::Tiny Perl 5.10 and later COPYRIGHT AND LICENCE Copyright (C) 2005 Nuno Nunes (effectively versions < 1.0) Copyright (c) 2015 Louis B. Moore (effectively versions >= 1.0) This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. This is clarified as being under the Perl Foundation Artistic License 2