comunicationLeap/node_modules/qs/Readme.md
node_modules/qs/Readme.mdRaw
1# node-querystring
2
3 query string parser for node and the browser supporting nesting, as it was removed from `0.3.x`, so this library provides the previous and commonly desired behaviour (and twice as fast). Used by [express](http://expressjs.com), [connect](http://senchalabs.github.com/connect) and others.
4
5## Installation
6
7 $ npm install qs
8
9## Examples
10
11```js
12var qs = require('qs');
13
14qs.parse('user[name][first]=Tobi&user[email]=tobi@learnboost.com');
15// => { user: { name: { first: 'Tobi' }, email: 'tobi@learnboost.com' } }
16
17qs.stringify({ user: { name: 'Tobi', email: 'tobi@learnboost.com' }})
18// => user[name]=Tobi&user[email]=tobi%40learnboost.com
19```
20
21## Testing
22
23Install dev dependencies:
24
25 $ npm install -d
26
27and execute:
28
29 $ make test
30
31browser:
32
33 $ open test/browser/index.html
34
35## License
36
37(The MIT License)
38
39Copyright (c) 2010 TJ Holowaychuk <tj@vision-media.ca>
40
41Permission is hereby granted, free of charge, to any person obtaining
42a copy of this software and associated documentation files (the
43'Software'), to deal in the Software without restriction, including
44without limitation the rights to use, copy, modify, merge, publish,
45distribute, sublicense, and/or sell copies of the Software, and to
46permit persons to whom the Software is furnished to do so, subject to
47the following conditions:
48
49The above copyright notice and this permission notice shall be
50included in all copies or substantial portions of the Software.
51
52THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
53EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
54MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
55IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
56CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
57TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
58SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.