Merge pull request #242 from Marchrius/master

'split' filter implementation

Author: a8m

README.md

@@ -63,6 +63,7 @@ Bunch of useful filters for AngularJS *(with no external dependencies!)*
   - [ltrim](#ltrim)
   - [rtrim](#rtrim)
   - [truncate](#truncate)
+  - [split](#split)
   - [ucfirst](#ucfirst)
   - [uriEncode](#uriencode)
   - [uriComponentEncode](#uricomponentencode)
@@ -1099,6 +1100,22 @@ lorem ipsum...
 lorem ipsum d...
 lorem ipsum dolor sit amet
 ```
+###split
+truncates a string given a specified length, providing a custom string to denote an omission.<br/>
+usage: ``` | split: [delimiter]: [skip-optional]```<br/>
+```js
+$scope.text = 'lorem ipsum dolor sit amet';
+```
+```html
+
+<p>{{ text | split: ' ' }}</p>
+
+<p>{{ text | split: ' ': 2}}</p>
+
+<!--result:
+['lorem', 'ipsum', 'dolor', 'sit', 'amet']
+['lorem ipsum dolor', 'sit', 'amet']
+```
 ###reverse
 Reverses a string
 ```js

dist/angular-filter.js

@@ -1,6 +1,6 @@
 /**
  * Bunch of useful filters for angularJS(with no external dependencies!)
- * @version v0.5.14 - 2016-12-06 * @link https://github.com/a8m/angular-filter
+ * @version v0.5.14 - 2017-01-16 * @link https://github.com/a8m/angular-filter
  * @author Ariel Mashraki <ariel@mashraki.co.il>
  * @license MIT License, http://www.opensource.org/licenses/MIT
  */
@@ -1798,6 +1798,23 @@ angular.module('a8m.match', [])
     }
   });
 
+/**
+ * @ngdoc filter
+ * @name phone-us
+ * @kind function
+ *
+ * @description
+ * format a string or a number into a us-style
+ * phone number in the form (***) ***-****
+ */
+angular.module('a8m.phoneUS', [])
+  .filter('phoneUS', function () {
+    return function(num) {
+      num += '';
+      return '(' + num.slice(0, 3) + ') ' + num.slice(3, 6) + '-' + num.slice(6);
+    }
+  });
+
 /**
  * @ngdoc filter
  * @name repeat
@@ -1875,6 +1892,47 @@ angular.module('a8m.slugify', [])
     }
   }]);
 
+/**
+ * @ngdoc filter
+ * @name split
+ * @kind function
+ *
+ * @description
+ * split a string by a provided delimiter (none '' by default) and skip first n-delimiters
+ */
+angular.module('a8m.split', [])
+  .filter('split', function () {
+    function escapeRegExp(str) {
+      return str.replace(/[\-\[\]\/\{\}\(\)\*\+\?\.\\\^\$\|]/g, "\\$&");
+    }
+
+    return function (input, delimiter, skip) {
+      var _regexp, _matches, _splitted, _temp;
+
+      if (isUndefined(input) || !isString(input)) {
+        return null;
+      }
+      if (isUndefined(delimiter)) delimiter = '';
+      if (isNaN(skip)) skip = 0;
+
+      _regexp = new RegExp(escapeRegExp(delimiter), 'g');
+      _matches = input.match(_regexp);
+      
+      if (isNull(_matches) || skip >= _matches.length) {
+        return [input];
+      }
+
+      if (skip === 0) return input.split(delimiter);
+      
+      _splitted = input.split(delimiter);
+      _temp = _splitted.splice(0, skip + 1);
+      _splitted.unshift(_temp.join(delimiter));
+    
+      return _splitted;
+    };
+  })
+;
+
 /**
  * @ngdoc filter
  * @name startWith
@@ -2009,18 +2067,23 @@ angular.module('a8m.truncate', [])
  * ucfirst
  */
 angular.module('a8m.ucfirst', [])
-  .filter('ucfirst', [function() {
-    return function(input) {
-      return isString(input)
-        ? input
-            .split(' ')
-            .map(function (ch) {
-              return ch.charAt(0).toUpperCase() + ch.substring(1);
-            })
-            .join(' ')
-        : input;
-    }
-  }]);
+  .filter({
+    ucfirst: ucfirstFilter,
+    titleize: ucfirstFilter
+  });
+
+function ucfirstFilter() {
+  return function (input) {
+    return isString(input)
+      ? input
+      .split(' ')
+      .map(function (ch) {
+        return ch.charAt(0).toUpperCase() + ch.substring(1);
+      })
+      .join(' ')
+      : input;
+  }
+}
 
 /**
  * @ngdoc filter
@@ -2248,6 +2311,7 @@ angular.module('angular.filter', [
   'a8m.repeat',
   'a8m.test',
   'a8m.match',
+  'a8m.split',
 
   'a8m.to-array',
   'a8m.concat',

dist/angular-filter.min.js

@@ -0,0 +1,40 @@
+/**
+ * @ngdoc filter
+ * @name split
+ * @kind function
+ *
+ * @description
+ * split a string by a provided delimiter (none '' by default) and skip first n-delimiters
+ */
+angular.module('a8m.split', [])
+  .filter('split', function () {
+    function escapeRegExp(str) {
+      return str.replace(/[\-\[\]\/\{\}\(\)\*\+\?\.\\\^\$\|]/g, "\\$&");
+    }
+
+    return function (input, delimiter, skip) {
+      var _regexp, _matches, _splitted, _temp;
+
+      if (isUndefined(input) || !isString(input)) {
+        return null;
+      }
+      if (isUndefined(delimiter)) delimiter = '';
+      if (isNaN(skip)) skip = 0;
+
+      _regexp = new RegExp(escapeRegExp(delimiter), 'g');
+      _matches = input.match(_regexp);
+      
+      if (isNull(_matches) || skip >= _matches.length) {
+        return [input];
+      }
+
+      if (skip === 0) return input.split(delimiter);
+      
+      _splitted = input.split(delimiter);
+      _temp = _splitted.splice(0, skip + 1);
+      _splitted.unshift(_temp.join(delimiter));
+    
+      return _splitted;
+    };
+  })
+;

dist/angular-filter.zip

@@ -24,6 +24,7 @@ angular.module('angular.filter', [
   'a8m.repeat',
   'a8m.test',
   'a8m.match',
+  'a8m.split',
 
   'a8m.to-array',
   'a8m.concat',

src/_filter/string/split.js

@@ -0,0 +1,28 @@
+'use strict';
+
+describe('splitFilter', function () {
+
+  var filter, sentence = "Today is a beautiful and sunny day!";
+
+  beforeEach(module('a8m.split'));
+
+  beforeEach(inject(function ($filter) {
+    filter = $filter('split');
+  }));
+
+  it('should test a string with given pattern', function() {
+
+    expect(filter(sentence, ' ', 3)).toEqual(['Today is a beautiful', 'and', 'sunny', 'day!']);
+    expect(angular.equals(filter(sentence, '.'), [sentence])).toBeTruthy();
+    expect(filter(sentence, ' ')).toEqual(['Today', 'is', 'a', 'beautiful', 'and', 'sunny', 'day!']);
+
+  });
+
+  it('should get a !string and return null', function() {
+    expect(filter({})).toEqual(null);
+    expect(filter([])).toEqual(null);
+    expect(filter(1)).toEqual(null);
+    expect(filter(!1)).toBeFalsy(null);
+  });
+
+});