carrot/ship — pull request #6 by kylemac (2013-11-19 14:54:14+00:00)
Title: Argument output proposal

IMO, the object we're returning from the argument parser is a little confusing. I've also run into issues where I'm expecting a relative path but receive the absolute `process.cwd()` for `path`. I also tend to think that `path` is a little bit of a confusing name in the context of the deployer.

I propose the following objects:

- **path** - the directory the ship command is run in
- **deployer** - the specified deployer
- **config** - the shipfile contents
- **cargo** - the directory of files to be shipped
- **folder** - the relative path to be shipped

The new objects are `cargo` and `folder`. `cargo` is simply the `path` joined with the `folder`. I don't believe I've had a use-case for `folder` yet, and I'm not 100% pleased with it's naming - but it seems like down the line this operation would be necessary and it makes sense to marshall it now instead of doing a string difference of `path` and `cargo` later.