wip 0.0.2 → 0.1.0

data/.gitignore

@@ -2,7 +2,6 @@
 .DS_Store
 .bundle
 .yardoc
-doc/*
 pkg/*
 scratch/*
 spec/spec.opts

data/.wiprc

@@ -1,22 +1 @@
-#!/usr/bin/env bash
-
-echo "WIP'n wip!"
-
-# if [ "" == "$TM_PROJECT_DIRECTORY" ] ; then
-#   # non-textmate (e.g., command line) setup...
-#   rvm use 1.8.7
-# # else
-#   # TextMate (e.g., command line) setup...
-# fi
-# 
-# dbrebase() {
-#   SQL_FILE=$1
-# 
-#   rake db:drop:all
-#   rake db:create:all
-# 
-#   mysql -u root -p iwrtw_development < $SQL_FILE
-#   rake db:schema:dump
-# 
-#   rake db:migrate
-# }
+echo 'working on wip...'

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in wip.gemspec
+gemspec

data/README.mkd

@@ -1,9 +1,9 @@
 `wip` README
 ============================================================================
 
-  > NOTE: **`wip`** is WIP
+  > NOTE: `wip` is WIP
 
-**`wip`** is a concept I'm playing with for streamlining the process of
+`wip` is a concept I'm playing with for streamlining the process of
 coding for and documenting client and personal software projects.
 
 While this document (specifically) and the idea (generally) are
@@ -12,13 +12,14 @@ and will, in fact, be using the techniques described herein for this project
 itself.
 
 
-What is a **wip** Project
+`wip` *works* (in theory)
 ----------------------------------------------------------------------------
 
-A Project is made up of:
+A *work* is made up of:
 
   * Notes
   * Code
+  * ...?
 
 The goal is to create an experience in which working on a given client or
 personal project is:
@@ -41,9 +42,190 @@ personal project is:
         team-at-large, while allowing for "local" preferences as well.
 
 
+`wip` *works* (NOW)
+----------------------------------------------------------------------------
+
+`wip`, currently, is a rubygem that installs an executable and a bash
+function (`wip`, as it turns out) which together assist with navigating to
+and "activating" a given *work* (project workspace, for now).
+
+The following is an example shell session, using `wip` as it exists now:
+
+    # given `wip` is installed .............................................
+
+
+    # `wip index` ... list "works"
+    # ......................................................................
+    corey@computer ~  $ wip index .
+
+    corey@computer ~  $ echo "echo 'working on wip...'" > \
+                        Workspace/com.github/coreyti/wip/.wiprc
+
+    corey@computer ~  $ wip index .
+      * wip
+        /Users/corey/Workspace/com.github/coreyti/wip
+
+    corey@computer ~  $ echo "echo 'working on help...'" > \
+                        Workspace/help/.wiprc
+
+    corey@computer ~  $ wip index .
+      * help
+        /Users/corey/Workspace/help
+      * wip
+        /Users/corey/Workspace/com.github/coreyti/wip
+
+
+
+    # `wip index` ... narrowing the scope & speeding things up
+    # ......................................................................
+    corey@computer ~  $ wip index .
+      * help
+        /Users/corey/Workspace/help
+      * wip
+        /Users/corey/Workspace/com.github/coreyti/wip
+
+    corey@computer ~  $ wip index ~/Workspace/com.github
+      * wip
+        /Users/corey/Workspace/com.github/coreyti/wip
+
+
+
+    # `wip index` ... defaults
+    # ......................................................................
+    corey@computer ~  $ wip index                   # no arg to `wip index`
+      * help
+        /Users/corey/Workspace/help
+      * wip
+        /Users/corey/Workspace/com.github/coreyti/wip
+
+    corey@computer ~  $ wip                         # no arg to `wip`
+      * help
+        /Users/corey/Workspace/help
+      * wip
+        /Users/corey/Workspace/com.github/coreyti/wip
+
+
+
+    # `wip show` ... activate a "work"
+    # ......................................................................
+    corey@computer ~  $ pwd
+    /Users/corey
+
+    corey@computer ~  $ wip show wip
+    -------------------------------------------------------------------------------
+     work : /Users/corey/Workspace/com.github/coreyti/wip
+    -------------------------------------------------------------------------------
+    working on wip...
+
+    corey@computer wip (git::master) $ wip            # scoped `wip index`
+      * wip
+        /Users/corey/Workspace/com.github/coreyti/wip
+
+    corey@computer wip (git::master) $ pwd
+    /Users/corey/Workspace/com.github/coreyti/wip
+
+
+
+    # `wip show` ... default: `wip ARG` to `wip show ARG`
+    # ......................................................................
+    corey@computer wip (git::master) $ cd ~
+
+    corey@computer ~  $ wip .
+
+    corey@computer ~  $ wip wip
+    ------------------------------------------------------------------------
+     work : /Users/corey/Workspace/com.github/coreyti/wip
+    ------------------------------------------------------------------------
+    working on wip...
+
+    corey@computer wip (git::master) $ wip .
+    ------------------------------------------------------------------------
+     work : /Users/corey/Workspace/com.github/coreyti/wip
+    ------------------------------------------------------------------------
+    working on wip...
+
+    corey@computer wip (git::master) $ pwd
+    /Users/corey/Workspace/com.github/coreyti/wip
+
+
+
+    # `wip show` ... with a path
+    # ......................................................................
+    corey@computer wip (git::master) $ cd ~
+
+    corey@computer ~  $ wip foo
+
+    corey@computer ~  $ wip show foo
+
+    corey@computer ~  $ wip show ~/Workspace/com.github/
+
+    corey@computer ~  $ wip show ~/Workspace/com.github/coreyti/wip
+    ------------------------------------------------------------------------
+     work : /Users/corey/Workspace/com.github/coreyti/wip
+    ------------------------------------------------------------------------
+    working on wip...
+
+    corey@computer wip (git::master) $ pwd
+    /Users/corey/Workspace/com.github/coreyti/wip
+
+
+
+    # `wip help`
+    # ......................................................................
+    corey@computer wip (git::master) $ cd ~
+
+    corey@computer ~  $ wip index .
+      * help
+        /Users/corey/Workspace/help
+      * wip
+        /Users/corey/Workspace/com.github/coreyti/wip
+
+    corey@computer ~  $ wip help
+    Tasks:
+      wip-ruby back         # Move to and activate most recent 'work'
+      wip-ruby help [TASK]  # Describe available tasks or one specific task
+      wip-ruby index        # List all indexed 'works'
+      wip-ruby show         # Move to and activate a 'work'
+
+    corey@computer ~  $ wip show help
+    ------------------------------------------------------------------------
+     work : /Users/corey/Workspace/help
+    ------------------------------------------------------------------------
+    working on help...
+
+    corey@computer help  $ pwd
+    /Users/corey/Workspace/help
+
+
+
+    # `wip back`
+    # ......................................................................
+    corey@computer help  $ cd ~
+
+    corey@computer ~  $ wip show wip
+    ------------------------------------------------------------------------
+     work : /Users/corey/Workspace/com.github/coreyti/wip
+    ------------------------------------------------------------------------
+    working on wip...
+
+    corey@computer wip (git::master) $ cd ~/Documents/
+
+    corey@computer Documents  $ wip back
+    ------------------------------------------------------------------------
+     work : /Users/corey/Workspace/com.github/coreyti/wip
+    ------------------------------------------------------------------------
+    working on wip...
+
+    corey@computer wip (git::master) $ pwd
+    /Users/corey/Workspace/com.github/coreyti/wip
+
+
 Assumptions & Intentional Limitations
 ----------------------------------------------------------------------------
 
+  > Most of the following are irrelevant for now. Once `wip` does more
+  > though...
+
   1. I develop with:
      * an Apple computer
      * an iPhone
@@ -59,7 +241,8 @@ Assumptions & Intentional Limitations
 On "Notes"
 ----------------------------------------------------------------------------
 
-TODO: expand upon, clarify:
+  > Most of the following are irrelevant for now. Once `wip` does more
+  > though...
 
   * backed by DropBox
   * on-the-fly versioned, with git-wip

data/Rakefile

@@ -1,3 +1,15 @@
 require 'bundler'
 Bundler::GemHelper.install_tasks
 
+module Bundler
+  class GemHelper
+    # override in order to see install output (we have a post-install hook)
+    def install_gem
+      built_gem_path = build_gem
+      out, err, code = sh_with_code("gem install #{built_gem_path}")
+      puts out
+      raise err if err[/ERROR/]
+      Bundler.ui.confirm "#{name} (#{version}) installed"
+    end
+  end
+end

data/bin/wip-ruby

@@ -1,8 +1,5 @@
 #!/usr/bin/env ruby
 
-# puts "wip-ruby..."
-# puts "    args... #{ARGV.inspect}"
-
 BASH_COMMANDS = [:show]
 
 begin
@@ -15,11 +12,7 @@ end
 require 'wip/cli'
 
 begin
-  result = WIP::CLI::Shell.start
-
-  if result && BASH_COMMANDS.include?(ARGV.first.intern)
-    STDOUT.print result
-  end
+  WIP::CLI::Shell.start
 rescue WIP::WIPError => e
   WIP.ui.error e.message
   WIP.ui.error e.backtrace.join("\n") if ENV["WIP_DEBUG"]

data/doc/README.md

@@ -1,9 +1,9 @@
 `wip` README
 ============================================================================
 
-  > NOTE: **`wip`** is WIP
+  > NOTE: `wip` is WIP
 
-**`wip`** is a concept I'm playing with for streamlining the process of
+`wip` is a concept I'm playing with for streamlining the process of
 coding for and documenting client and personal software projects.
 
 While this document (specifically) and the idea (generally) are
@@ -12,13 +12,14 @@ and will, in fact, be using the techniques described herein for this project
 itself.
 
 
-What is a **wip** Project
+`wip` *works* (in theory)
 ----------------------------------------------------------------------------
 
-A Project is made up of:
+A *work* is made up of:
 
   * Notes
   * Code
+  * ...?
 
 The goal is to create an experience in which working on a given client or
 personal project is:
@@ -41,9 +42,190 @@ personal project is:
         team-at-large, while allowing for "local" preferences as well.
 
 
+`wip` *works* (NOW)
+----------------------------------------------------------------------------
+
+`wip`, currently, is a rubygem that installs an executable and a bash
+function (`wip`, as it turns out) which together assist with navigating to
+and "activating" a given *work* (project workspace, for now).
+
+The following is an example shell session, using `wip` as it exists now:
+
+    # given `wip` is installed .............................................
+
+
+    # `wip index` ... list "works"
+    # ......................................................................
+    corey@computer ~  $ wip index .
+
+    corey@computer ~  $ echo "echo 'working on wip...'" > \
+                        Workspace/com.github/coreyti/wip/.wiprc
+
+    corey@computer ~  $ wip index .
+      * wip
+        /Users/corey/Workspace/com.github/coreyti/wip
+
+    corey@computer ~  $ echo "echo 'working on help...'" > \
+                        Workspace/help/.wiprc
+
+    corey@computer ~  $ wip index .
+      * help
+        /Users/corey/Workspace/help
+      * wip
+        /Users/corey/Workspace/com.github/coreyti/wip
+
+
+
+    # `wip index` ... narrowing the scope & speeding things up
+    # ......................................................................
+    corey@computer ~  $ wip index .
+      * help
+        /Users/corey/Workspace/help
+      * wip
+        /Users/corey/Workspace/com.github/coreyti/wip
+
+    corey@computer ~  $ wip index ~/Workspace/com.github
+      * wip
+        /Users/corey/Workspace/com.github/coreyti/wip
+
+
+
+    # `wip index` ... defaults
+    # ......................................................................
+    corey@computer ~  $ wip index                   # no arg to `wip index`
+      * help
+        /Users/corey/Workspace/help
+      * wip
+        /Users/corey/Workspace/com.github/coreyti/wip
+
+    corey@computer ~  $ wip                         # no arg to `wip`
+      * help
+        /Users/corey/Workspace/help
+      * wip
+        /Users/corey/Workspace/com.github/coreyti/wip
+
+
+
+    # `wip show` ... activate a "work"
+    # ......................................................................
+    corey@computer ~  $ pwd
+    /Users/corey
+
+    corey@computer ~  $ wip show wip
+    -------------------------------------------------------------------------------
+     work : /Users/corey/Workspace/com.github/coreyti/wip
+    -------------------------------------------------------------------------------
+    working on wip...
+
+    corey@computer wip (git::master) $ wip            # scoped `wip index`
+      * wip
+        /Users/corey/Workspace/com.github/coreyti/wip
+
+    corey@computer wip (git::master) $ pwd
+    /Users/corey/Workspace/com.github/coreyti/wip
+
+
+
+    # `wip show` ... default: `wip ARG` to `wip show ARG`
+    # ......................................................................
+    corey@computer wip (git::master) $ cd ~
+
+    corey@computer ~  $ wip .
+
+    corey@computer ~  $ wip wip
+    ------------------------------------------------------------------------
+     work : /Users/corey/Workspace/com.github/coreyti/wip
+    ------------------------------------------------------------------------
+    working on wip...
+
+    corey@computer wip (git::master) $ wip .
+    ------------------------------------------------------------------------
+     work : /Users/corey/Workspace/com.github/coreyti/wip
+    ------------------------------------------------------------------------
+    working on wip...
+
+    corey@computer wip (git::master) $ pwd
+    /Users/corey/Workspace/com.github/coreyti/wip
+
+
+
+    # `wip show` ... with a path
+    # ......................................................................
+    corey@computer wip (git::master) $ cd ~
+
+    corey@computer ~  $ wip foo
+
+    corey@computer ~  $ wip show foo
+
+    corey@computer ~  $ wip show ~/Workspace/com.github/
+
+    corey@computer ~  $ wip show ~/Workspace/com.github/coreyti/wip
+    ------------------------------------------------------------------------
+     work : /Users/corey/Workspace/com.github/coreyti/wip
+    ------------------------------------------------------------------------
+    working on wip...
+
+    corey@computer wip (git::master) $ pwd
+    /Users/corey/Workspace/com.github/coreyti/wip
+
+
+
+    # `wip help`
+    # ......................................................................
+    corey@computer wip (git::master) $ cd ~
+
+    corey@computer ~  $ wip index .
+      * help
+        /Users/corey/Workspace/help
+      * wip
+        /Users/corey/Workspace/com.github/coreyti/wip
+
+    corey@computer ~  $ wip help
+    Tasks:
+      wip-ruby back         # Move to and activate most recent 'work'
+      wip-ruby help [TASK]  # Describe available tasks or one specific task
+      wip-ruby index        # List all indexed 'works'
+      wip-ruby show         # Move to and activate a 'work'
+
+    corey@computer ~  $ wip show help
+    ------------------------------------------------------------------------
+     work : /Users/corey/Workspace/help
+    ------------------------------------------------------------------------
+    working on help...
+
+    corey@computer help  $ pwd
+    /Users/corey/Workspace/help
+
+
+
+    # `wip back`
+    # ......................................................................
+    corey@computer help  $ cd ~
+
+    corey@computer ~  $ wip show wip
+    ------------------------------------------------------------------------
+     work : /Users/corey/Workspace/com.github/coreyti/wip
+    ------------------------------------------------------------------------
+    working on wip...
+
+    corey@computer wip (git::master) $ cd ~/Documents/
+
+    corey@computer Documents  $ wip back
+    ------------------------------------------------------------------------
+     work : /Users/corey/Workspace/com.github/coreyti/wip
+    ------------------------------------------------------------------------
+    working on wip...
+
+    corey@computer wip (git::master) $ pwd
+    /Users/corey/Workspace/com.github/coreyti/wip
+
+
 Assumptions & Intentional Limitations
 ----------------------------------------------------------------------------
 
+  > Most of the following are irrelevant for now. Once `wip` does more
+  > though...
+
   1. I develop with:
      * an Apple computer
      * an iPhone
@@ -59,7 +241,8 @@ Assumptions & Intentional Limitations
 On "Notes"
 ----------------------------------------------------------------------------
 
-TODO: expand upon, clarify:
+  > Most of the following are irrelevant for now. Once `wip` does more
+  > though...
 
   * backed by DropBox
   * on-the-fly versioned, with git-wip

data/lib/wip/cli.rb

@@ -24,11 +24,28 @@ module WIP
 
       check_unknown_options!
 
+      desc "route", "Route finder", :hide => true
+      def route(*args)
+        @_all_tasks    ||= self.class.all_tasks
+        @_public_names ||= @_all_tasks.inject([]) do |memo, hash|
+          memo << hash[0] unless hash[1].hidden?
+          memo
+        end
+
+        # TODO: be sure we cannot loop (send :route)
+        if @_public_names.include?(args.first)
+          send(args.shift, *args)
+        else
+          # no matching task: see if there's a "work" to show
+          show(*args)
+        end
+      end
+
       desc "index", "List all indexed 'works'"
       method_option "path", :type    => :string,
                             :banner  => "Specify a path to index",
                             :default => '. (working dir)'
-      def index(path = nil)
+      def index(path = nil, *)
         @_index ||= WIP::CLI::Index.new(path || '.')
         @_index.get(:sort => :name).each do |work|
           WIP.ui.info "  * #{work[:name]}\n    #{work[:path]}"
@@ -39,9 +56,14 @@ module WIP
       method_option "path", :type    => :string,
                             :banner  => "Specify a path to activate",
                             :default => '. (working dir)'
-      def show(path = nil)
+      def show(path = nil, *)
         @_show ||= WIP::CLI::Show.new(path || '.')
-        @_show.get
+        WIP.ui.info @_show.get
+      end
+
+      desc "back", "Move to and activate most recent 'work'"
+      def back(*)
+        WIP.ui.info ENV['WIP_BACK']
       end
     end
   end

data/lib/wip/version.rb

@@ -1,3 +1,3 @@
 module WIP
-  VERSION = "0.0.2"
+  VERSION = "0.1.0"
 end

data/wip.gemspec

@@ -1,6 +1,33 @@
 # -*- encoding: utf-8 -*-
 $:.push File.expand_path("../lib", __FILE__)
-require 'wip/version'
+
+require "wip/version"
+
+BOOTSTRAP_VERSION = "1.0"
+
+begin
+  require "rubygems"
+  gem     "wip-bootstrap", "= #{BOOTSTRAP_VERSION}"
+  require "wip-bootstrap"
+rescue LoadError => e
+  puts %{
+WARNING:
+#{e.message}wip-bootstrap must be pre-installed. I'll try to grab that now.
+
+}
+  local = File.join(File.dirname(__FILE__), '..', 'wip-bootstrap')
+
+  if File.exist?(local)
+    `cd #{local} && rake install`
+  else
+    `gem install wip-bootstrap`
+  end
+end
+
+Gem.clear_paths
+gem     "wip-bootstrap", "= #{BOOTSTRAP_VERSION}"
+require "wip-bootstrap"
+WIP::Bootstrap.run
 
 Gem::Specification.new do |s|
   s.name        ="wip"
@@ -16,16 +43,82 @@ Gem::Specification.new do |s|
 
   s.files              = `git ls-files`.split("\n")
   s.test_files         = `git ls-files -- {test,spec,features}/*`.split("\n")
-  s.executables        = `git ls-files -- {bin}/*`.split("\n")
+  s.executables        = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.default_executable = "wip"
   s.require_path       = "lib"
 
-  s.add_development_dependency 'bundler', '~> 1.0.0'
+  s.add_runtime_dependency     'wip-bootstrap', BOOTSTRAP_VERSION
+  s.add_development_dependency 'bundler',       '~> 1.0.0'
+
+  s.post_install_message = %Q{
+Thank you for installing #{s.name} v#{s.version}
+------------------------------------------------------------------------------
+
+What happened:
+
+  * First, `wip` depends on `wip-bootstrap`, which should have been installed
+    for you if it wasn't already around. `wip-bootstrap` simply adds a few
+    bash wrappers to `wip` and sets up your bash profile.
+
+    `wip-bootstrap` shouldn't have to be updated too often, and updates to
+    `wip` will not attempt to re-bootstrap, unless dependent on a new
+    bootstrap version.
+
+    If bootstrapping *was* run, you should have seen a related banner
+    preceding this one.
+  * `wip` provides ruby CLI utilities that are meant to assist with software
+    project workspace and workflow management (called 'works').
+
+    The executable doing most of the heavy lifting is:
+
+        wip-ruby
+
+  * However, one of the things `wip-bootstrap` takes care of is add a bash
+    function called `wip` to your environment. So,
 
-  s.post_install_message = %Q{**************************************************
+        wip
 
-  Thank you for installing #{s.summary}
+    is your entry point (even though it doesn't show up with `which wip`).
 
-**************************************************
+
+Getting started:
+
+  * If this is your *first* time installing `wip` on this machine, you need
+    to `source ~/.wiprc` to get things activated for your current shell
+    session(s).
+  * Drop a `.wiprc` file into a project of your liking. Add some
+    project-specific setup to that file. To start, try this:
+
+        echo 'welcome to my cool project!'
+
+  * Next these a try:
+
+        wip help
+
+        wip index ~/workspace
+            # containing, perhaps, numerous 'works'
+            # returns a list of work names and paths
+
+        wip
+            # shortcut for `wip index .`
+
+        wip show WORK_NAME
+            # cd's to known (indexed) work and sources .wiprc, e.g.:
+            # welcome to my cool project!
+
+        wip WORK_NAME
+            # shortcut for `wip show`
+
+        wip .
+            # shortcut for `wip show .`
+
+
+Feedback, complaints, suggestions, etc?
+
+  * email me:  
+    support+wip@coolerator.net
+
+------------------------------------------------------------------------------
 }
+
 end

metadata

@@ -5,9 +5,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
+  - 1
   - 0
-  - 2
-  version: 0.0.2
+  version: 0.1.0
 platform: ruby
 authors: 
 - Corey Innis
@@ -15,13 +15,28 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-10-31 00:00:00 -07:00
+date: 2010-11-01 00:00:00 -07:00
 default_executable: wip
 dependencies: 
 - !ruby/object:Gem::Dependency 
-  name: bundler
+  name: wip-bootstrap
   prerelease: false
   requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 1
+        - 0
+        version: "1.0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -33,12 +48,12 @@ dependencies:
         - 0
         version: 1.0.0
   type: :development
-  version_requirements: *id001
+  version_requirements: *id002
 description: "'wip' provides tools to assist with the creation/maintenance of and collaboration on software projects"
 email: 
 - support+wip@coolerator.net
-executables: []
-
+executables: 
+- wip-ruby
 extensions: []
 
 extra_rdoc_files: []
@@ -46,14 +61,12 @@ extra_rdoc_files: []
 files: 
 - .gitignore
 - .wiprc
+- Gemfile
 - README.mkd
 - Rakefile
-- bin/wip
-- bin/wip-bash
 - bin/wip-ruby
 - doc/README.md
 - doc/TEMPLATE.md
-- lib/rubygems_plugin.rb
 - lib/wip.rb
 - lib/wip/cli.rb
 - lib/wip/cli/base.rb
@@ -92,11 +105,75 @@ homepage: http://github.com/coreyti/wip
 licenses: []
 
 post_install_message: |
-  **************************************************
   
-    Thank you for installing 'wip': streamlined work-in-progress projects
+  Thank you for installing wip v0.1.0
+  ------------------------------------------------------------------------------
+  
+  What happened:
+  
+    * First, `wip` depends on `wip-bootstrap`, which should have been installed
+      for you if it wasn't already around. `wip-bootstrap` simply adds a few
+      bash wrappers to `wip` and sets up your bash profile.
+  
+      `wip-bootstrap` shouldn't have to be updated too often, and updates to
+      `wip` will not attempt to re-bootstrap, unless dependent on a new
+      bootstrap version.
+  
+      If bootstrapping *was* run, you should have seen a related banner
+      preceding this one.
+    * `wip` provides ruby CLI utilities that are meant to assist with software
+      project workspace and workflow management (called 'works').
+  
+      The executable doing most of the heavy lifting is:
+  
+          wip-ruby
+  
+    * However, one of the things `wip-bootstrap` takes care of is add a bash
+      function called `wip` to your environment. So,
+  
+          wip
+  
+      is your entry point (even though it doesn't show up with `which wip`).
+  
+  
+  Getting started:
+  
+    * If this is your *first* time installing `wip` on this machine, you need
+      to `source ~/.wiprc` to get things activated for your current shell
+      session(s).
+    * Drop a `.wiprc` file into a project of your liking. Add some
+      project-specific setup to that file. To start, try this:
+  
+          echo 'welcome to my cool project!'
+  
+    * Next these a try:
+  
+          wip help
+  
+          wip index ~/workspace
+              # containing, perhaps, numerous 'works'
+              # returns a list of work names and paths
+  
+          wip
+              # shortcut for `wip index .`
+  
+          wip show WORK_NAME
+              # cd's to known (indexed) work and sources .wiprc, e.g.:
+              # welcome to my cool project!
+  
+          wip WORK_NAME
+              # shortcut for `wip show`
+  
+          wip .
+              # shortcut for `wip show .`
+  
+  
+  Feedback, complaints, suggestions, etc?
+  
+    * email me:  
+      support+wip@coolerator.net
   
-  **************************************************
+  ------------------------------------------------------------------------------
 
 rdoc_options: []
 

data/bin/wip

@@ -1,38 +0,0 @@
-#!/usr/bin/env bash
-
-# TODO:
-#   * ask a Ruby option parser to get us the options for bash.
-#   * allow passing args through:  
-#     wip work-name --flag -- RAILS_ENV=production
-
-cmd="$1"
-
-case "${cmd:-index}" in
-  help)
-    # $ wip help                        --> wip-ruby... ["help"]
-    wip-ruby "help" $2
-    ;;
-  index)
-    # $ wip                             --> wip-ruby... ["index", "."]
-    # $ wip index                       --> wip-ruby... ["index", "."]
-    # $ wip index .                     --> wip-ruby... ["index", "."]
-    # $ wip index ~/Workspace           --> wip-ruby... ["index", "/Users/corey/Workspace"]
-
-    wip-ruby "index" "${2:-.}"
-    ;;
-  show)
-    # $ wip show                        --> wip-bash... show '.'
-    # $ wip show .                      --> wip-bash... show '.'
-    # $ wip show work-name              --> wip-bash... show 'work-name'
-    # $ wip show ~/Workspace/work-path  --> wip-bash... show '/Users/corey/Workspace/work-path'
-
-    wip-bash "show" "${2:-.}"
-    ;;
-  *)
-    # $ wip .                           --> wip-bash... show '.'
-    # $ wip work-name                   --> wip-bash... show 'work-name'
-    # $ wip ~/Workspace/work-path       --> wip-bash... show '/Users/corey/Workspace/work-path'
-
-    wip-bash "$1"
-    ;;
-esac

data/bin/wip-bash

@@ -1,24 +0,0 @@
-#!/usr/bin/env bash
-
-cmd="$1"
-
-# echo "wip-bash..."
-
-wip-show() {
-  # echo "    show...  name: $1"
-}
-
-case "$cmd" in
-  show)
-    wip-show $2
-    ;;
-  *)
-    wip-show $1
-    ;;
-esac
-
-
-
-# for wiprc in "$HOME/.wiprc" "./.wiprc" ; do
-#   
-# done

data/lib/rubygems_plugin.rb

@@ -1,3 +0,0 @@
-Gem::post_install do |installer|
-  puts "thanks for installing!!!"
-end