← Back to team overview

coapp-developers team mailing list archive

Re: New Command line interface spec

 

I've added the following, which will provide all things to all people. (powershell similarity, short commands and tiny single-letter-shortcuts)
Quick List
Command Short Command   Switch Shortcut Description
list-package    list    -l      lists packages
get-packageinfo info    -g      shows extended package information
install-package install -i      installs a package
remove-package  remove *        -r      removes a package
update-package  update  -u      updates a package
trim-packages   trim    -t      trims unneccessary packages
activate-package        activate        -a      makes a specific package the 'current'
block-package   block   -b      marks a package as 'blocked'
unblock-package unblock -B      unblocks a package
mark-package    mark    m       marks a package as 'required'
unmark-package  unmark  M       unmarks a package as 'required'
list-feed       feeds   -f      lists the feeds known to the system
add-feed        add     -A      adds a feed to the system
remove-feed     remove *        -R      removes a feed from the system

Note: the * indicates that the remove command will operate slightly differently depending on context (if you pass a feed to it, it will act as remove-feed, otherwise it will act as remove-package )

________________________________
From: coapp-developers-bounces+garretts=microsoft.com@xxxxxxxxxxxxxxxxxxx [coapp-developers-bounces+garretts=microsoft.com@xxxxxxxxxxxxxxxxxxx] on behalf of Garrett Serack [garretts@xxxxxxxxxxxxx]
Sent: Wednesday, August 24, 2011 8:04 AM
To: Andrew Fenn
Cc: coapp-developers@xxxxxxxxxxxxxxxxxxx
Subject: Re: [Coapp-developers] New Command line interface spec

Well, the powershell commands would be the same, just without the 'coapp' part.  The only time you have to specify the 'coapp' part in powershell, is if there were two modules loaded that exposed install-package commands, you'd have to say 'coapp\install-package'

G


________________________________
From: Andrew Fenn [andrewfenn@xxxxxxxxx]
Sent: Tuesday, August 23, 2011 9:50 PM
To: Garrett Serack
Cc: Olaf van der Spek; coapp-developers@xxxxxxxxxxxxxxxxxxx
Subject: Re: [Coapp-developers] New Command line interface spec

Maybe i'm just ignorant about powershell but it seems to me that powershell commands do not follow such a format. Looking through the list of powershell commands I don't see any that follow the format "[command] [(noun)-(subcommand)]". However many seem to follow the format "[(command)-(noun)] [subcommand]".

Doesn't that mean if you want it to follow powershell it should be as follows: coapp-list-package, coapp-install, coapp-remove, etc?


On Wed, Aug 24, 2011 at 4:01 AM, Garrett Serack <garretts@xxxxxxxxxxxxx<mailto:garretts@xxxxxxxxxxxxx>> wrote:
Powershell commands follow a verb-noun format for all their commands. Maintaining consistency with existing conventions with powershell is pretty important.

For convenience, Powershell also offers aliases, which can be handy.

I’ve looked at other package managers, there isn’t enough consistency between them to settle on a `standard`.

I don’t understand why a few extra characters in the long form is problematic when we’ll also have the abbreviated short form:

coapp -i somepackage

If you don’t like typing the long form, use the short ones.
?

From: Olaf van der Spek [mailto:olafvdspek@xxxxxxxxx<mailto:olafvdspek@xxxxxxxxx>]
Sent: Tuesday, August 23, 2011 1:57 PM
To: Garrett Serack
Cc: coapp-developers@xxxxxxxxxxxxxxxxxxx<mailto:coapp-developers@xxxxxxxxxxxxxxxxxxx>

Subject: Re: [Coapp-developers] New Command line interface spec

Can't the PS interface use the shorter commands as well?
Consistency with other pkg management interfaces is important as well. If not more important, IMO.
On Tue, Aug 23, 2011 at 10:51 PM, Garrett Serack <garretts@xxxxxxxxxxxxx<mailto:garretts@xxxxxxxxxxxxx>> wrote:
Well, I’m trying to keep consistency with the upcoming powershell interface for coapp (so that the command lines are equivalent).

Like I said, I also want to include a ‘short’ interface that has dash-plus-single-letter shortcuts for everything.

G

From: Olaf van der Spek [mailto:olafvdspek@xxxxxxxxx<mailto:olafvdspek@xxxxxxxxx>]
Sent: Tuesday, August 23, 2011 1:49 PM
To: Garrett Serack
Subject: Re: [Coapp-developers] New Command line interface spec

Why can't install just be install? Repeating package in so many commands seems both verbose, redundant and inconsistent with apt and yum.
On Tue, Aug 23, 2011 at 10:47 PM, Garrett Serack <garretts@xxxxxxxxxxxxx<mailto:garretts@xxxxxxxxxxxxx>> wrote:
I just finished drafting up a new command line interface spec: https://github.com/coapp/coapp.org/wiki/New-coapp-command-line-interface

Hopefully this will be a bit more consistent in usage than the old one.

I’m also entertaining ideas for a ‘short’ interface (ie, using short switches instead of full words).

coapp -i firefox

coapp -r firefox-1.*

G


[Description: Description: Description: fearthecowboy]<http://fearthecowboy.com/>

Garrett Serack | Microsoft Open Source Software Developer | Microsoft Corporation
Office:(425)706-7939<tel:%28425%29706-7939>[X]<https://www.google.com/voice/m/caller?number=+14257067939><https://www.google.com/voice/m/caller?number=+14257067939>                                       email/messenger: garretts@xxxxxxxxxxxxx<mailto:garretts@xxxxxxxxxxxxx>
blog: http://fearthecowboy.com<http://fearthecowboy.com/>                                      twitter: @fearthecowboy<http://twitter.com/fearthecowboy>

I don't make the software you use; I make the software you use better on Windows.





_______________________________________________
Mailing list: https://launchpad.net/~coapp-developers
Post to     : coapp-developers@xxxxxxxxxxxxxxxxxxx<mailto:coapp-developers@xxxxxxxxxxxxxxxxxxx>
Unsubscribe : https://launchpad.net/~coapp-developers
More help   : https://help.launchpad.net/ListHelp



--
Olaf



--
Olaf

_______________________________________________
Mailing list: https://launchpad.net/~coapp-developers
Post to     : coapp-developers@xxxxxxxxxxxxxxxxxxx<mailto:coapp-developers@xxxxxxxxxxxxxxxxxxx>
Unsubscribe : https://launchpad.net/~coapp-developers
More help   : https://help.launchpad.net/ListHelp


GIF image


References