Dir and List API Options

[bobbyjball3]

Enhancements

• Made Dir and List methods accept either a simple path or an options object for more advanced operations (including the optional action headers) -- (issue: 2)
• Added helper method for parsing/constructing action options/request options (issue: 2)
• Cleaned up the README and increased documentation completeness
• Organized README in a more digestible manner (modeled after Async library's excellent documentation)

Bug Fixes

N/A

Breaking changes

• users migrating from previous versions will need to review documentation for dir and list methods. For most users this will be a non-breaking change, but users of custom "action" options may require modification of existing code. See the NetStorage4 API documentation and NetStorage3 API documentation for more information on action options.

[bobbyjball3]

@AstinCHOI You might consider setting the environment variables in your Travis repo configuration rather than as secret values in the Travis YAML. The reason being that secret env variables are not accessible on pull requests (which is why builds are always failing on pull reqs)

Reference Here

"...Encrypted variables are not available to untrusted builds such as pull requests coming from another repository..."

[AstinCHOI]

Dear @bobbyjball3,

I tested and merged it. As you suggested, I remove the secure vals in Travis YAML and add them to its setting. You may test for next pull request !

Thank you !