feat(rules): Added Alnum rule

Author: ricardogobbosouza

README.md

@@ -79,6 +79,7 @@ The library can be loaded either as a standalone script, or through an [AMD](htt
 
 - [Age](docs/age.md)
 - [AllOf](docs/all-of.md)
+- [Alnum](docs/alnum.md)
 - [Alpha](docs/alpha.md)
 - [AlwaysInvalid](docs/always-invalid.md)
 - [AlwaysValid](docs/always-valid.md)

awesome-validator.min.js

@@ -0,0 +1,21 @@
+# Alnum
+
+Validates if the given input is alphanumeric.
+
+Valid values:
+
+```js
+validator.alnum().validate('alganet');
+validator.alnum().validate('abc 123');
+validator.alnum().validate('\t');
+validator.alnum().validate('\n');
+```
+
+Invalid values:
+
+```js
+validator.alnum().validate('');
+validator.alnum().validate('16-50');
+validator.alnum().validate('@#$');
+validator.alnum().validate('_');
+```

docs/alnum.md

@@ -0,0 +1,18 @@
+import { AbstractRegexFilter } from './abstract-regex-filter';
+
+export class Alnum extends AbstractRegexFilter {
+
+    /**
+     * Filter white sapce.
+     */
+    protected filterWhiteSpace(): boolean {
+        return true;
+    }
+
+    /**
+     * Get pattern.
+     */
+    protected getPattern(): string | RegExp {
+        return /^[a-z\d]+$/gi;
+    }
+}

src/rules/alnum.ts

@@ -1,5 +1,6 @@
 export * from './age';
 export * from './all-of';
+export * from './alnum';
 export * from './alpha';
 export * from './always-invalid';
 export * from './always-valid';

src/rules/index.ts

@@ -0,0 +1,69 @@
+import { assert } from 'chai';
+
+import { AbstractRule } from '../../src/rules/abstract-rule';
+import { Alnum } from '../../src/rules/alnum';
+
+describe('Alnum', () => {
+
+    let alnum: Alnum;
+
+    beforeEach(() => {
+        alnum = new Alnum();
+    });
+
+    it('is rule', () => {
+        assert.instanceOf(alnum, AbstractRule);
+    });
+
+    it('values is valid with additional characters', () => {
+        assert.isTrue(new Alnum('!@#$%^&*(){}').validate('!@#$%^&*(){} abc 123'));
+        assert.isTrue(new Alnum('[]?+=/\\-_|"\',<>.').validate('[]?+=/\\-_|"\',<>. \t \n abc 123'));
+        assert.isTrue(new Alnum(undefined).validate('abc 123'));
+    });
+
+    it('values is valid', () => {
+        assert.isTrue(alnum.validate('alganet'));
+        assert.isTrue(alnum.validate('a'));
+        assert.isTrue(alnum.validate('1'));
+        assert.isTrue(alnum.validate('\t'));
+        assert.isTrue(alnum.validate('\n'));
+        assert.isTrue(alnum.validate('foobar'));
+        assert.isTrue(alnum.validate('Foo'));
+        assert.isTrue(alnum.validate('alganet alganet'));
+        assert.isTrue(alnum.validate('\nabc'));
+        assert.isTrue(alnum.validate('\tdef'));
+        assert.isTrue(alnum.validate('\nabc \t'));
+        assert.isTrue(alnum.validate(0));
+    });
+
+    it('values is not valid', () => {
+        assert.isFalse(alnum.validate(''));
+        assert.isFalse(alnum.validate('16-50'));
+        assert.isFalse(alnum.validate('@#$'));
+        assert.isFalse(alnum.validate('_'));
+        assert.isFalse(alnum.validate('dgç'));
+        assert.isFalse(alnum.validate('12.1'));
+        assert.isFalse(alnum.validate('-12'));
+        assert.isFalse(alnum.validate(-50));
+        assert.isFalse(alnum.validate(String()));
+        assert.isFalse(alnum.validate(null));
+        assert.isFalse(alnum.validate(undefined));
+        assert.isFalse(alnum.validate('-1.1'));
+        assert.isFalse(alnum.validate('1.1'));
+        assert.isFalse(alnum.validate('-1'));
+        assert.isFalse(alnum.validate(-1));
+        assert.isFalse(alnum.validate(-1.0));
+        assert.isFalse(alnum.validate(0.1));
+        assert.isFalse(alnum.validate(-0.1));
+        assert.isFalse(alnum.validate(1.1));
+        assert.isFalse(alnum.validate(-1.1));
+        assert.isFalse(alnum.validate([]));
+        assert.isFalse(alnum.validate({}));
+        assert.isFalse(alnum.validate(new Array('foo')));
+        assert.isFalse(alnum.validate(new Object({foo: 'bar'})));
+
+        class Foo {}
+        assert.isFalse(alnum.validate(new Foo()));
+    });
+
+});