Opbeat CLI syntax survey

opbeat-cli.sh

#
# Opbeat is looking for the best CLI syntax for the `opbeat'  
# command that sends deployment info to the Opbeat API.
#
# Users should be able to specify repositories that the app being deployed
# consists of and their attributes.
# 
# The attributes are "name", "version", "vcs", "rev", "branch", "remote_url".
#
# We are considering these syntaxes:
#



### 1. --repo takes one argument, a string of comma-separated key=value pairs:

$ opbeat deployment \
    --repo name=myapp,version=1.0,vcs=git,branch=master,remote_url=git@github.com:myorg/app.git,rev=hash \
    --repo name=myapp2,version=1.0,vcs=git,branch=master,remote_url=git@github.com:myorg/app2.git,rev=hash


### 2. --repo takes multiple arguments, each is a key=value pair.

$ opbeat deployment \
    --repo \
        name=myapp \
        version=1.0 \
        vcs=git \
        branch=master \
        remote_url=git@github.com:opbeat/opbeatcli.git \
        rev=hash \
    --repo \
        name=myapp2 \
        version=1.0 \
        vcs=git \
        branch=master \
        remote_url=git@github.com:myorg/app2.git \
        rev=hash


#
# Please let us know what you think. Thanks!
# 

It's a good suggestion but we need it to be extensible (more fields can be added in the future).

#1 is easier to type, but #2 is easier to read. I prefer #2.