[UPDATE] lib, tests, examples.

README.md

@@ -1,4 +1,4 @@
-string-array
+String Array
 ===
 [![NPM version][npm-image]][npm-url] [![Build Status][travis-image]][travis-url] [![Coverage Status][coveralls-image]][coveralls-url] [![Dependencies][dependencies-image]][dependencies-url]
 
@@ -17,18 +17,36 @@ For use in the browser, use [browserify](https://github.com/substack/node-browse
 ## Usage
 
 ``` javascript
-var foo = require( 'validate.io-string-array' );
+var isStringArray = require( 'validate.io-string-array' );
 ```
 
-#### foo( value )
+#### isStringArray( value )
 
-What does this function do?
+Validates if a `value` is a `string array`.
+
+``` javascript
+var arr = ['a','b','c'];
+
+var bool = isStringArray( value );
+// returns true
+```
+
+__Note__: the method will return `false` for an empty `array`.
 
 
 ## Examples
 
 ``` javascript
-var foo = require( 'validate.io-string-array' );
+var isStringArray = require( 'validate.io-string-array' );
+
+console.log( isStringArray( ['beep','','foo'] ) );
+// returns true
+
+console.log( isStringArray( [] ) );
+// returns false
+
+console.log( isStringArray( [1,2,3] ) );
+// returns false
 ```
 
 To run the example code from the top-level application directory,

examples/index.js

@@ -1,3 +1,12 @@
 'use strict';
 
-var module = require( './../lib' );
+var isStringArray = require( './../lib' );
+
+console.log( isStringArray( ['beep','','foo'] ) );
+// returns true
+
+console.log( isStringArray( [] ) );
+// returns false
+
+console.log( isStringArray( [1,2,3] ) );
+// returns false

lib/index.js

@@ -30,20 +30,37 @@
 
 // MODULES //
 
-// var module_alias = require( 'module_name' );
+var isArray = require( 'validate.io-array' ),
+	isString = require( 'validate.io-string' );
 
 
-// FUNCTIONS //
+// IS STRING ARRAY //
 
 /**
-* FUNCTION: foo()
-*	{{ foo description }}.
+* FUNCTION: isStringArray( value )
+*	Validates if a value is a string array.
+*
+* @param {*} value - value to be validated
+* @returns {Boolean} boolean indicating if a value is a string array
 */
-function foo() {
-
-} // end FUNCTION foo()
+function isStringArray( value ) {
+	var len;
+	if ( !isArray( value ) ) {
+		return false;
+	}
+	len = value.length;
+	if ( !len ) {
+		return false;
+	}
+	for ( var i = 0; i < len; i++ ) {
+		if ( !isString( value[i] ) ) {
+			return false;
+		}
+	}
+	return true;
+} // end FUNCTION isStringArray()
 
 
 // EXPORTS //
 
-module.exports = foo;
+module.exports = isStringArray;

package.json

@@ -26,12 +26,21 @@
     "validate.io",
     "validate",
     "validation",
-    "validator"
+    "validator",
+    "valid",
+    "string",
+    "array",
+    "stringarray",
+    "is",
+    "isstringarray"
   ],
   "bugs": {
     "url": "https://github.com/validate-io/string-array/issues"
   },
-  "dependencies": {},
+  "dependencies": {
+    "validate.io-array": "^1.0.3",
+    "validate.io-string": "^1.0.2"
+  },
   "devDependencies": {
     "chai": "1.x.x",
     "mocha": "1.x.x",

test/test.js

@@ -7,7 +7,7 @@ var // Expectation library:
 	chai = require( 'chai' ),
 
 	// Module to be tested:
-	lib = require( './../lib' );
+	isStringArray = require( './../lib' );
 
 
 // VARIABLES //
@@ -21,9 +21,40 @@ var expect = chai.expect,
 describe( 'validate.io-string-array', function tests() {
 
 	it( 'should export a function', function test() {
-		expect( lib ).to.be.a( 'function' );
+		expect( isStringArray ).to.be.a( 'function' );
 	});
 
-	it( 'should do something' );
+	it( 'should positively validate', function test() {
+		var bool;
+
+		bool = isStringArray( ['a','b','c'] );
+		assert.ok( bool );
+
+		bool = isStringArray( [new String('a') ] );
+		assert.ok( bool );
+	});
+
+	it( 'should negatively validate', function test() {
+		var values = [
+			5,
+			'5',
+			null,
+			undefined,
+			true,
+			function(){},
+			[],
+			{},
+			[1,2,3],
+			[1,'2',3],
+			[[],[]]
+		];
+
+		for ( var i = 0; i < values.length; i++ ) {
+			assert.notOk( badValue( values[i] ) );
+		}
+		function badValue( value ) {
+			return isStringArray( value );
+		}
+	});
 
 });