A simple wrapper for the Flickr API using oAuth 1.0a auth
A simple node wrapper for the Flickr API that supports oAuth authentication
This is a small library that adds a thin wrapper around the Flickr API to make it easier to call methods, sign them when necessary.
It currently does not support the RSS/Atom feeds, nor does it handle the oAuth login process. It may in the future -- I'd appreciate any patches if you have time.
The library is heavily inspired by the flickrnode library by Ciaran Jessup.
Install the library into your package.json file or using the following command:
npm install flickr
Once installed, you can interact with the library with something like this:
var Flickr = require'flickr'Flickr;var client = 'YOUR_CONSUMER_KEY/API_KEY' 'YOUR_CONSUMER_SECRET'"oauth_token": 'optional oauth token' "oauth_token_secret": 'optional oauth token secret';
Some examples follow.
Contributions are welcome. Please feel free to submit pull requests. I prefer that pull requests come from properly named feature branches (don't dev in master!). This makes it easier for people scanning the Network tab above to see what your fork offers.
To setup your local copy for testing, I recommend you run
in the project directory to install all the dependencies. I found that easiest.
Next, create a .env file in the root of the project directory. The
sets up the testing environment to use those values.
Yes, the tests run against the live API (for now).
You should probably start with the following contents:
FLICKR_API_KEY=<Your API Key>FLICKR_API_SECRET=<Your API Secret>FLICKR_OA_TOKEN=<A valid access token>FLICKR_OA_TOKEN_SECRET=<A valid access token secret>
To get the access token and the access token secret, you will need to go through the OAuth dance. You can use something like this OAuth test client to generate those values. Using that tool is beyond the scope of this readme.
Then, whenever you want to run tests:
You should get a nicely formatted output for your tests. You can also override the
reporter used by Mocha by setting a
REPORTER value in
.env. Read the
See the LICENSE file for details.