Commit

1 files changed, 65 insertions, 0 deletions

diff --git a/src/node_modules/chance/docs/basics/character.md b/src/node_modules/chance/docs/basics/character.md
new file mode 100644
index 0000000..6c90ed6
--- /dev/null
+++ b/src/node_modules/chance/docs/basics/character.md
@@ -0,0 +1,65 @@
+# character
+
+```js
+// usages
+chance.character()
+chance.character({ pool: 'abcde' })
+chance.character({ alpha: true })
+chance.character({ numeric: true })
+chance.character({ casing: 'lower' })
+chance.character({ symbols: true })
+```
+
+Return a random character.
+
+```js
+chance.character();
+=> 'v'
+```
+
+By default it will return a string with random character from the following
+pool.
+
+```js
+'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!@#$%^&*()'
+```
+
+Optionally specify a pool and the character will be generated with characters
+only from that pool.
+
+```js
+chance.character({ pool: 'abcde' });
+=> 'c'
+```
+
+Optionally specify alpha for an alphabetic character.
+
+```js
+chance.character({ alpha: true });
+=> 'N'
+```
+
+Optionally specify numeric for a numeric character.
+
+```js
+chance.character({ numeric: true });
+=> '8'
+```
+
+Default includes both upper and lower case. It's possible to specify one or the
+other.
+
+```js
+chance.character({ casing: 'lower' });
+=> 'j'
+```
+
+*Note, wanted to call this key just ```case``` but unfortunately that's a
+reserved word in JavaScript for use in a switch statement*
+
+Optionally return only symbols
+
+```js
+chance.character({ symbols: true });
+=> '%'
+```