Use Cases for ADM and Thor tasks

Thor tasks to be created to support App Dev Management (ADM)

== List
Lists all matching entries

xxxx:list [arguments] [options]

apps:list --category [c1,c2] --platform [p1,p2] --runtype [r1,r2] --environment [e1,e2] --os --use --origin --maturity

gems:list --category [c1,c2] --rubyv --frameworks  --use --origin --maturity

frameworks:list --lang [lang]:[versions] --type [types] --version [framework versions] 

=== List apps

# List all Game apps targeted for a mobile or desktop platform
$ apps:list --categories games --platforms mobile,desktop     

=== List gems

# List all Ruby 1.9 gems for Rails
$ gems:list --rubyv 1.9 --frameworks rails     

# List all Ruby 1.9 gems for Rails 3
$ gems:list --rubyv 1.9 --frameworks rails-3     

=== List frameworks

# List all Ruby 1.9 frameworks
$ frameworks:list --lang ruby:1.9

# List all Java 4-6 frameworks
$ frameworks:list --lang java:4-6

# List all Java 6 frameworks
$ frameworks:list --lang java

# List all Java 6 J2EE web frameworks
$ frameworks:list --lang java:6 --type web --match /j2ee/

# List all HTML-5 frameworks
$ frameworks:list --html 5
HTML\versions\HTML-5\frameworks\sproutcore

== Navigation

frameworks:goto [position] --lang [lang]:[version] --match [reg exp] --category [c]

Go to first HTML framework 
$ frameworks:goto first --lang html

Go to last HTML-5 framework 
$ frameworks:goto last --lang html:5
                            
Go to 2nd HTML-5 framework 
$ frameworks:goto 2 --lang html:5

Go to first HTML framework that matches /sprout/
$ frameworks:goto first --match /sprout/ --lang html

Go to first Ruby framework for Gamedevelopment 
$ frameworks:goto first --lang ruby --category games

== Install

Creates a new entry

xxxx:install [file names] [arguments] [options]

- binaries
- apps
- gems     
- frameworks

=== Utility commands

- latest [number]

1. Create a new temporary dir ~/Latest
2. Copy the latest [n] number of files from Downloads to this dir 
3. Navigate to ~/Latest

Then easy to do the install from here!

=== Binary install

Install a new binary

$ binaries:install [filenames] --lang [language]:[version] --name [entry name] --version[version of binary]   

version of language is optional

$ binaries:install [filenames] --lang [language] --name [entry name] --version[version of binary]   

- Download and install new MacRuby binary
$ cd Downloads
$ latest 3
$ binaries:install [filenames] --lang ruby --name MacRuby --version 0.5    

=== Application install

$ apps:install [filenames] --lang [language]:[version] --framework [framework]:[version]

version of language and framework is optional

$ apps:install [filenames] --lang [language] --framework [framework]

- Download and install new Rails 3 app, a Game just for Fun, found somewhere on the net
$ cd Downloads
$ latest 3
$ apps:install [filenames] --lang ruby --framework rails:3 --category games --use fun --origin foreign    

== Gems install

$ gems:install [filenames] --rubyv [version] --category [c] --framework [framework]:[version] --use [use] --origin [o]

Maturity is calculated based on the version of the gem (Version file ) 

- Download and install new Ruby gem
$ cd Downloads
$ latest 3
$ gems:install [filenames] --lang ruby

- Download and install new Ruby 1.9 gem for Games
$ cd Downloads
$ latest 3
$ gems:install [filenames] --rubyv 1.9 --category games

- Download and install new Ruby 1.9 gem - Mature and for Professional use
$ cd Downloads
$ latest 3
$ gems:install [filenames] --rubyv 1.9 --use prof --maturity mature

== Design

=== Install
$ design:install [filenames] --lang [language]:[version] --framework [framework]:[version] --category [c] --type [t] --name [folder name]

Example:

$ design:install [filenames] --lang ruby:1.9 --category games --type ideas --name 3d-games

=== List
$ design:list [filenames] --lang [language]:[version] --framework [framework]:[version] --category [c] --type [t] --match [reg exp]

Example:

$ designlist [filenames] --lang ruby:1.9 --category games --type book --match /3d/


== Documentation

=== Install
$ doc:install [filenames] --lang [language]:[version] --framework [framework]:[version] --category [c] --type [t] --name [folder name]

Example:

$ doc:install [filenames] --lang ruby:1.9 --category games --type book --name 3d-games-in-ruby

=== List
$ design:list [filenames] --lang [language]:[version] --framework [framework]:[version] --category [c] --type [t] --match [reg exp]

Example:

$ doc:list [filenames] --lang ruby:1.9 --category games --type book --match /3d/