API no longer exists and this library is deprecated

A fastft posts client for the browser or node.js

This module depends on es6 Promises being available as a global. At present this needs polyfilling in most environments. Note that popular promise libraries e.g. Q, Reqwest, don't necessarily conform to the es6 standard

npm install -S es6-promise

Then at the start of your application code

GLOBAL.Promise = require('es6-promise').Promise;

Include the es6-promise-polyfill or similar in the head of your page

Sets config values:

• host - the host name for requests to clamo (may contain http:// etc if your environment requires it)
• limit - the default maximum number of posts to fetch in a search. Defaults to 10, but can be specified on a per-request basis
• outputfields - the fields to return from any clamo request (see src/outputfields.json for the default)
• timeout - timeout threshold for requests. Defaults to no limit
• method - request method to use, 'GET' or 'POST', defaulting to 'GET'

Retrieves a single post from clamo. Returns a promise for an object with two properties

• response : The XHR response object received
• post: An instance of a Post model (see below for details)

Retrieves posts matching the given query, ordered by most recent first. Accepts two parameters

• query: A string conforming to clamo's query syntax e.g. location: London. Defaults to ''
• params: An object containing two properties - limit and offset - which enable pagination of results. limit defaults to 10 and offset to 0

Returns a promise for an object with two properties

• response : The XHR response object received
• posts: An array of instances of the Post model (see below for details)

Exposed as a property on the object exported by this module. This contains utilties for accessing properties of a given post. Exact structure to be determined

As well as searching for raw strings clamo will use the foloowing to query a post's metadata

• 'author: name' Restrict by author name
• 'from:date' No earlier than date (dd/mm/YYYY)
• 'to:date' No later than date (dd/mm/YYYY)
• 'status: status' Either 'live' or 'draft'
• 'taxonomy: tag' Tagged with a tag from a given taxonomy

Use AND, OR, NOT, ( and ) to construct complex search terms

e.g. bananas AND from: "01/12/2013" AND NOT location: "Americas"

To run tests locally run

npm install; bower install; make test

To debug tests in the browser run

./node_modules/karma/bin/karma start --browsers Chrome --singleRun false

(Note you will have to run make testRebuild too every time you change a file. If you have karma-cli installed globally you can use karma instead of ./node_modules/karma/bin/karma)

To update test data from the clamo api run make refreshtestdata

If you need to mock this client's communication with the server without having to set up your own request mocker you can use require('fastft-api-client/mocks') which provides both search and getPost mockers which accept json strings (not a javascript object) equivalent to one returned from the clamo api and set up functions that return a promise equivalent to one returned by a real clamo request. It uses exactly the same functions to handle the data as those used by the real api client. The only significant difference is that the full http response object won't be available (but if you're mocking then you probably won't need that anyway).

For example:

    var fastftMocks = require('fastft-api-client/mocks');
    var fastftClient = require('fastft-api-client');

    it('should render some fastft posts', function () {
        sinon.stub(fastftClient, 'search', fastftMocks.search('a json string'));
        sinon.stub(fastftClient, 'getPost', fastftMocks.getPost('a json string'));

        // now run your test     
    })