braintree/vendor/querystring.node.js.511d6a2/README.md

A library for integrating with Braintree.

# querystring.node.js

This node module provides robust querystring parsing and stringifying. It is based heavily
on the [YUI QueryString module located here](http://github.com/isaacs/yui3/tree/master/src/querystring/js).

## Acknowledgements

Thanks to Isaac Schlueter for pointing me to the YUI code and allowing me to tweak it for node.js.

## querystring.js

Exports the __parse__ and __stringify__ methods from the __querystring-parse__ 
and __querystring-stringify__ sub-modules, repsectively.

### parse example

    var util = require("util");
    var qs = require("./querystring");

    var str = qs.parse("foo=bar&baz=qux");
    util.log(JSON.stringify(str)); // => {"foo":"bar","baz":"qux"}

    str = qs.parse("foo[bar][][bla]=baz");
    util.log(JSON.stringify(str)); // => {"foo":{"bar":[{"bla":"baz"}]}}



### stringify example

    var util = require("util");
    var qs = require("./querystring");

    var obj = {"foo":"bar","baz":"qux"};
    util.log(qs.stringify(obj)); // => foo=bar&baz=qux

    obj = {"foo":{"bar":[{"bla":"baz"}]}};
    util.log(qs.stringify(obj)); // => foo%5Bbar%5D%5B%5D%5Bbla%5D=baz


## querystring-parse.js

Provides a __parse__ function which takes a string and returns a javascript object


## querystring-stringify.js

Provides a __stringify__ function which takes a javascript object and returns a query string

## Other

See test.js for a few more examples.