Add: Increment helper (#40)

* Add: indexPlusOne helper

* Add: indexPlusOne description + example to README

* Add: Closing backtick to slice example

* Reposition: indexPlusOne helper below slice (so same as README order)

* Amend: Helper to receive argument by which to increment index value

* Remove: parseInt() from incrementBy argument as already number type

* Add: Increment helper to express test

README.md

@@ -136,7 +136,12 @@ Outputs contents if a complex boolean logic expression is satisfied. Uses string
 
 ### slice
 Loop through a subset of items
-- `{{#slice items limit="2" offset="4"}} some content {{/slice}}
+- `{{#slice items limit="2" offset="4"}} some content {{/slice}}`
+
+### increment
+Displays `@index` value added to given argument (e.g. an argument of `1` will display ordinal not cardinal numbers, i.e. values start from 1 not 0).
+- `{{#each array}}{{#increment 1}}{{@index}}{{/increment}}{{/each}}`
+
 
 ## Presenter helpers
 

src/extend-helpers.js

@@ -18,6 +18,7 @@ module.exports = function (helpers) {
 	helpers.defineBlock = require('./helpers/defineBlock');
 	helpers.outputBlock = require('./helpers/outputBlock');
 	helpers.slice = require('./helpers/slice');
+	helpers.increment = require('./helpers/increment');
 	helpers.json = require('./helpers/json');
 	helpers.concat = require('./helpers/concat');
 	helpers.usePartial = require('./helpers/usePartial');

src/helpers/increment.js

@@ -0,0 +1,5 @@
+'use strict';
+
+module.exports = function (incrementBy, options) {
+	return parseInt(options.fn(this)) + incrementBy;
+};

test/express.test.js

@@ -60,6 +60,12 @@ describe('express handlebars setup', function() {
 				.get('/templated')
 				.expect(200, /slice\:34\:end/, done);
 		});
+
+		it('should provide an index increment helper', function(done) {
+			request(app)
+				.get('/templated')
+				.expect(200, /increment\:12345\:end/, done);
+		});
 	});
 
 	describe('logic helpers', function () {

test/fixtures/app/views/main.html

@@ -43,6 +43,7 @@ <h2>Dates test:-</h2>
 ifBool:{{#ifBool thing1 thing2 nothing "$0 && ($1 || $2)"}}first{{else}}not first{{/ifBool}} {{#ifBool @root/thing2 nothing thing1 "($0 && $1) && $2"}}second{{else}}not second{{/ifBool}}
 
 slice:{{#slice items limit="2" offset="2"}}{{this}}{{/slice}}:end
+increment:{{#each items}}{{#increment 1}}{{@index}}{{/increment}}{{/each}}:end
 
 {{encode "http://domain.com?q=this / that" mode='uri'}} {{encode "http://domain.com?q=this / that"}}
 {{#resize 200}}http://image.jpg{{/resize}}