.

qwen/nodejs/node_modules/dottie/README.md

@@ -0,0 +1,112 @@
+[![Build Status](https://travis-ci.org/mickhansen/dottie.js.svg?branch=master)](https://travis-ci.org/mickhansen/dottie.js)
+
+Dottie helps you easily (and without sacrificing too much performance) look up and play with nested keys in objects, without them throwing up in your face.
+
+**Not actively maintained. You are likely better off using lodash or ES6+**
+
+## Install
+    npm install dottie
+
+## Usage
+For detailed usage, check source or tests.
+
+### Get value
+Gets nested value, or undefined if unreachable, or a default value if passed.
+
+```js
+var values = {
+  some: {
+    nested: {
+        key: 'foobar';
+    }
+  },
+  'some.dot.included': {
+    key: 'barfoo'
+  }
+}
+
+dottie.get(values, 'some.nested.key'); // returns 'foobar'
+dottie.get(values, 'some.undefined.key'); // returns undefined
+dottie.get(values, 'some.undefined.key', 'defaultval'); // returns 'defaultval'
+dottie.get(values, ['some.dot.included', 'key']); // returns 'barfoo'
+```
+
+*Note: lodash.get() also works fine for this* 
+
+### Set value
+
+Sets nested value, creates nested structure if needed
+
+```js
+dottie.set(values, 'some.nested.value', someValue);
+dottie.set(values, ['some.dot.included', 'value'], someValue);
+dottie.set(values, 'some.nested.object', someValue, {
+  force: true // force overwrite defined non-object keys into objects if needed
+});
+```
+
+### Transform object
+Transform object from keys with dottie notation to nested objects
+
+```js
+var values = {
+  'user.name': 'Gummy Bear',
+  'user.email': 'gummybear@candymountain.com',
+  'user.professional.title': 'King',
+  'user.professional.employer': 'Candy Mountain'
+};
+var transformed = dottie.transform(values);
+
+/*
+{
+  user: {
+    name: 'Gummy Bear',
+    email: 'gummybear@candymountain.com',
+    professional: {
+      title: 'King',
+      employer: 'Candy Mountain'
+    }
+  }
+}
+*/
+```
+
+#### With a custom delimiter
+
+```js
+var values = {
+  'user_name': 'Mick Hansen',
+  'user_email': 'maker@mhansen.io'
+};
+var transformed = dottie.transform(values, { delimiter: '_' });
+
+/*
+{
+  user: {
+    name: 'Mick Hansen',
+    email: 'maker@mhansen.io'
+  }
+}
+*/
+```
+
+### Get paths in object
+```js
+var object = {
+  a: 1,
+  b: {
+    c: 2,
+    d: { e: 3 }
+  }
+};
+
+dottie.paths(object); // ["a", "b.c", "b.d.e"];
+```
+
+## Performance
+
+`0.3.1` and up ships with `dottie.memoizePath: true` by default, if this causes any bugs, please try setting it to false
+
+## License
+
+[MIT](https://github.com/mickhansen/dottie.js/blob/master/LICENSE)