init commit

Author: grindcode

.gitignore

@@ -0,0 +1,34 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (http://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directory
+# https://docs.npmjs.com/misc/faq#should-i-check-my-node-modules-folder-into-git
+node_modules
+
+# Optional npm cache directory
+.npm
+
+# Optional REPL history
+.node_repl_history

.travis.yml

@@ -0,0 +1,11 @@
+language: node_js
+node_js:
+  - "4.1"
+  - "4.0"
+  - "0.12"
+  - "0.11"
+  - "0.10"
+  - "iojs"
+branches:
+  only:
+  - master

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Isis T. Baulig
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,37 @@
+# Flat Insert
+[![Build Status](https://travis-ci.org/grindcode/flat-insert.svg)](https://travis-ci.org/grindcode/flat-insert)
+Returns a new _Array_ or _String_ after inserting and flatten `value` at `index`.
+
+[![browser support](https://ci.testling.com/grindcode/flat-insert.png)
+](https://ci.testling.com/grindcode/flat-insert)
+
+## Get Started
+```
+npm install flat-insert
+```
+
+## API
+### insert(input, value, [index])
+Returns new `string` or `array` depending on `input` type.
+* `input`: Input value to be modified. (**String**|**Array**)
+* `value`: Any value to be inserted into `input`. (**mixed**)
+  *  If `input` type is _String_, `value` will be turned into _String_.
+  *  If `input` and `value` types are _Array_, then `value` will be flatten.
+* `index`: Index or position at `input` where insert `value`. (**Number**; default: `0`)
+
+### Usage
+```
+var insert = require('flat-insert')
+
+insert([1, 2, 3], [1.1, 1.2], 1)
+// → '[1, 1.1, 1.2, 2, 3]'
+
+insert([1, 2, 3], 'meh', 1)
+// → '[1, 'meh', 2, 3]'
+
+insert('123', 'yo', 2)
+// → '12yo3'
+```
+
+## License
+See the [License](LICENSE) file.

index.js

@@ -0,0 +1,3 @@
+module.exports = function (res, val, i) {
+  return res.slice(0, i || 0).concat(val).concat(res.slice(i || 0))
+}

package.json

@@ -0,0 +1,35 @@
+{
+  "name": "flat-insert",
+  "version": "0.1.0",
+  "description": "Returns a new Array or String after inserting and flatten value at index.",
+  "main": "index.js",
+  "scripts": {
+    "test": "tape test/*.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grindcode/flat-insert.git"
+  },
+  "keywords": [
+    "array",
+    "string",
+    "insert",
+    "inject",
+    "position",
+    "index",
+    "join",
+    "concat",
+    "slice",
+    "splice",
+    "flat"
+  ],
+  "author": "Isis T. Baulig",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/grindcode/flat-insert/issues"
+  },
+  "homepage": "https://github.com/grindcode/flat-insert#readme",
+  "devDependencies": {
+    "tape": "^4.4.0"
+  }
+}

test/arrays.js

@@ -0,0 +1,32 @@
+var test = require('tape')
+var inject = require('../index.js')
+
+test('insert undefined into array', function (t) {
+  t.plan(1)
+  var result = inject([1, 2, 3], undefined, 1)
+  t.deepEqual(result, [1, undefined, 2, 3])
+})
+
+test('insert a Number into array', function (t) {
+  t.plan(1)
+  var result = inject([1, 2, 3], 4, 1)
+  t.deepEqual(result, [1, 4, 2, 3])
+})
+
+test('insert a String into array', function (t) {
+  t.plan(1)
+  var result = inject([1, 2, 3], 'yo', 2)
+  t.deepEqual(result, [1, 2, 'yo', 3])
+})
+
+test('insert an Array of mixed values into array', function (t) {
+  t.plan(1)
+  var result = inject([1, 2, 3], [4, true, 'yo'], 1)
+  t.deepEqual(result, [1, 4, true, 'yo', 2, 3])
+})
+
+test('insert duplicated values into array', function (t) {
+  t.plan(1)
+  var result = inject([1, 2, 3], [1, 2, 3], 1)
+  t.deepEqual(result, [1, 1, 2, 3, 2, 3])
+})

test/indexes.js

@@ -0,0 +1,32 @@
+var test = require('tape')
+var inject = require('../index.js')
+
+test('index is undefined', function (t) {
+  t.plan(1)
+  var result = inject([1, 2, 3], 'yo', undefined)
+  t.deepEqual(result, ['yo', 1, 2, 3])
+})
+
+test('insert at offset index', function (t) {
+  t.plan(1)
+  var result = inject([1, 2, 3], 'last', 10)
+  t.deepEqual(result, [1, 2, 3, 'last'])
+})
+
+test('insert at index == 0', function (t) {
+  t.plan(1)
+  var result = inject([1, 2, 3], 'first', 0)
+  t.deepEqual(result, ['first', 1, 2, 3])
+})
+
+test('insert at negative index', function (t) {
+  t.plan(1)
+  var result = inject([1, 2, 3], 'before last', -1)
+  t.deepEqual(result, [1, 2, 'before last', 3])
+})
+
+test('insert at negative offset index', function (t) {
+  t.plan(1)
+  var result = inject([1, 2, 3], 'first', -10)
+  t.deepEqual(result, ['first', 1, 2, 3])
+})

test/strings.js

@@ -0,0 +1,26 @@
+var test = require('tape')
+var inject = require('../index.js')
+
+test('insert undefined into string', function (t) {
+  t.plan(1)
+  var result = inject('123', undefined, 1)
+  t.equal(result, '1undefined23')
+})
+
+test('insert a Number into string', function (t) {
+  t.plan(1)
+  var result = inject('123', 4, 1)
+  t.equal(result, '1423')
+})
+
+test('insert a String into string', function (t) {
+  t.plan(1)
+  var result = inject('123', 'yo', 2)
+  t.equal(result, '12yo3')
+})
+
+test('insert an Array of mixed values into string', function (t) {
+  t.plan(1)
+  var result = inject('123', [4, true, 'yo'], 1)
+  t.equal(result, '14,true,yo23')
+})