organizing my thoughts

qwandry.rb

@@ -1,9 +1,45 @@
 #!/usr/bin/env ruby
 require 'optparse'
 
-puts "Qwandry; a qwestionable tool"
+# Informal Spec:
+# 
+# A User may have multiple Repositories
+# A Repositories contains Packages
+# 
+# A User will search for a repository giving a name and optional version
+# Each Repository will be scanned for matching Packages
+# If only one Package matches, that Package will be opened
+# If more than one Package matches, then the user will be prompted to pick one
+#   While any two Packages share the same name their parent dir is appended
+# If no Repository matches, then qwandry will exit with a -404 (repo not found)
+#
+module Qwandry
+
+  class Repository
+    def initialize(path)
+      @path = path.chomp('/')
+    end
+  
+    def scan(name)
+      []
+    end
+  end
+
+  # Directories look like:
+  #     Repository
+  #       lib-0.1
+  #       lib-0.2
+  class FlatRepository < Repository
+    def scan(name)
+      Dir["#{@path}/*"].select{|path| path if File.basename(path).start_with?(name)}
+    end
+  end
+
+end
+
+if __FILE__ == $0
   opts = OptionParser.new do |opts|    
-  opts.banner = "Usage: qwandry [options] [type] repository-name"
+    opts.banner = "Usage: qwandry [options] name [version]"
 
     opts.separator ""
     opts.separator "Known Repositories:"
@@ -17,24 +53,6 @@ if ARGV.length != 1
     exit(-1)
   end
   
-##
-class Repository
-  def initialize(path)
-    @path = path.chomp('/')
-  end
-  
-  def scan(name)
-    []
-  end
-end
-
-class FlatRepository < Repository
-  def scan(name)
-    Dir["#{@path}/*"].select{|path| path if File.basename(path).start_with?(name)}
-  end
-end
-
-##
   load('repositories.rb')
 
   name = ARGV.pop
@@ -54,3 +72,4 @@ print ">> "
   index = gets.to_i-1
   path = candidates[index]
   `mate #{path}`
+end

repositories.rb

@@ -5,7 +5,7 @@ def which(bin)
 end
 
 def add(label, path)
-  @repositories[label.to_s] << FlatRepository.new(path)
+  @repositories[label.to_s] << Qwandry::FlatRepository.new(path)
 end
 
 if which('ruby') == '/Users/adam/.rvm/rubies/ruby-1.9.1-p378/bin/ruby'