kickstart 0.2 → 0.2.2

data/bin/kickstart

@@ -11,17 +11,75 @@ include Kickstart::Keywords
 include Kickstart::Plugins
 include Kickstart::Scripting
 
+  @help_docs = <<-EOF
+    kickstart is the super awesome ruby package that gets you railsing in a jiffy.
+    since using a subversion repository is Best Practice(TM), this package generally
+    prefers that you have one set up before creating your project. kickstart will
+    still work (some) goodness for you if you aren't using a repository, but i really
+    think you should use one. really. 
+
+    also: have you run
+
+      $ kickstart --config
+
+    yet? you really should. it puts your kickstart home in place (~/.kickstart) with
+    all kinds of goodies. well.. a few kinds of goodies... i recommend it. 
+
+    - - + basic usage + - - 
+
+      $ kickstart project_name.rails [flags] # <- currently requires that project_name.rails already exists
+      $ kickstart repo_address [flags] 
+
+     repositories are addressable by http://, svn://, svn+ssh://, repo:// or repo:
+     repo:// (and repo:) indicate a repository in your repo bank, customizable in ~/.kickstart/defaults.rb
+
+    - - + flags + - - 
+
+    --config or -c
+      copies the default kickstart home into ~/.kickstart if it does not already exist
+      opens ~/.kickstart/plugin_helper.rb and ~/.kickstart/defaults.rb for editing before processing
+      exits unless a project is given
+
+    --force or -f
+      destroys the kickstart home if the config flag is set
+      i.e. forces copy, but you should know that it destroys the whole folder.
+      does nothing unless flagging to config
+
+    --name or -n
+      set the name of your project.
+      by default your project will be named by your .rails file or your repository.
+
+    --sample or -s
+      selects a sample project from the kickstart home. selects the project by name without (e.g. -s twirp)
+      cannot be used in conjunction with --config (config exits before sample gets a chance to do its thing)
+    
+    --help or -h
+      exits after showing this
+
+   EOF
+
+def help_docs
+  puts @help_docs
+  exit
+end
+
+flag(:help => 'h'){
+  help_docs
+}
 flag(:sample => 's'){ |value|
   @remaining_argument << "#{ENV['HOME']}/.kickstart/samples/#{value}.rails" if exists?(:folder, "#{ENV['HOME']}/.kickstart")
 }
 
+flag(:force => 'f'){ @force = true }
+
 flag(:config => 'c'){
   puts "\npreparing the ~/.kickstart folder\n"
+  destroy "#{ENV['HOME']}/.kickstart" if exists?(:folder, "#{ENV['HOME']}/.kickstart") && @active_flags.include?(:force)
   copy "#{File.dirname(__FILE__)}/../kickstart_home/", "#{ENV['HOME']}/.kickstart" unless exists?(:folder, "#{ENV['HOME']}/.kickstart")
-  puts "\nvi #{ENV['HOME']}/.kickstart/plugin_helper.rb\n"
-  system "vi #{ENV['HOME']}/.kickstart/plugin_helper.rb"
-  puts "\nvi #{ENV['HOME']}/.kickstart/defaults.rb"
-  system "vi #{ENV['HOME']}/.kickstart/defaults.rb"
+  puts "\n#{ENV['EDITOR']} #{ENV['HOME']}/.kickstart/plugin_helper.rb\n"
+  system "#{ENV['EDITOR']} #{ENV['HOME']}/.kickstart/plugin_helper.rb"
+  puts "\n#{ENV['EDITOR']} #{ENV['HOME']}/.kickstart/defaults.rb"
+  system "#{ENV['EDITOR']} #{ENV['HOME']}/.kickstart/defaults.rb"
   exit unless not remaining_argument.empty?
 }
 

data/kickstart_home/defaults.rb

@@ -4,7 +4,8 @@
 
 require 'plugin_helper'
 
-rspec_version = '0_7_5_1'
+ENV['EDITOR'] = 'vi' # must be callable from the command line (mate -w for textmate)
+$RSPEC_VERSION = '0_7_5_1'
 
 mysqladmin_user 'root'
 request_mysqladmin_pass? false
@@ -15,3 +16,11 @@ delete_rails_index? true
 default_plugins << :spider_test
 
 use_plugins default_plugins
+
+module Kickstart
+  module Scripting
+    def repo_bank
+      {:newq => 'http://someaddress'}
+    end
+  end
+end

data/lib/cli_tools.rb

@@ -97,9 +97,13 @@ module Flagger
   
   def run_flags(options)
     options.each { |key, value|
-      @associated_blocks[key.to_sym][value]
+      @associated_blocks[key.to_sym][value] rescue help_docs
     }
   end
+
+  def help_docs
+    exit
+  end
   
   def active_options
     flags = @active_flags || {}

data/lib/kickstart.rb

@@ -1,6 +1,7 @@
 
 $LOAD_PATH.unshift(File.expand_path(File.dirname(__FILE__)))
 
+ENV['EDITOR'] = 'vi'
 require 'rails_elements'
 require 'repository'
 require 'keywords'
@@ -10,5 +11,5 @@ require 'filebase'
 require 'cli_tools'
 
 module Kickstart
-  VERSION = '0.2'
+  VERSION = '0.2.2'
 end

data/lib/plugins.rb

@@ -2,13 +2,14 @@ module Kickstart
   module Plugins
     # define the version of rspec that you are using. formatted as it would be in the rspec_on_rails url 
     def rspec_version
-      value = request_value 'please enter the version of rspec on your computer [default: 0_7_5_1]'
-      value = '0_7_5_1' if value == ''
-      value
+      $RSPEC_VERSION ||= request_value("please enter the version of rspec on your computer [default: 0_7_5_1]")
+      $RSPEC_VERSION = '0_7_5_1' if $RSPEC_VERSION == ''
+      $RSPEC_VERSION
     end
 
     # set the rspec version
     def rspec_version= what
+      puts "setting rspec version to #{what}"
       @rspec_version = what
     end
 

data/lib/scripting.rb

@@ -20,14 +20,20 @@ resource(:foo){|foo|
 EOF
 end
 
+def repo_bank; {} end
     def setup_project(arg)
-      if arg =~ /^(http:\/\/|svn\+ssh:\/\/)/
-        @repo_address = arg
-        @project_name ||= arg.gsub(/^.+\//, '')
+      if arg =~ /^(http:\/\/|svn\+ssh:\/\/|svn:\/\/|repo:\/\/|repo:)/
+        repo_name = arg.sub(/^.+\//, '')
+        repo_location = arg.sub(/^repo:/, '').sub(/^\/\//, '').sub(/\/#{repo_name}/, '') if arg=~ /^repo:/
+
+        @repo_address = arg=~/^repo:/ ? "#{repo_bank[repo_location.to_sym]}/#{repo_name}" : arg
+        puts repo_bank[:newq]+' '+repo_name
+
+        @project_name ||= repo_name
         @kickstarter = "#{@project_name}.rails"
         use_repo_first
         write @repo_first_template.result, @kickstarter
-        system "vi #{@kickstarter}"
+        system "#{ENV['EDITOR']} #{@kickstarter}"
       else
         @kickstarter = arg
         @project_name ||= arg.gsub(/^.+\//, '').gsub(/\..+$/, '')
@@ -56,7 +62,7 @@ end
 
     def edit_db_config
       @edit_db = request_value "would you like to edit database.yml file? default values will be used otherwise. [Y/n]" if(@edit_db == :ask || @edit_db.nil?)
-      system 'vi config/database.yml' if @edit_db && @edit_db != 'n'
+      system "#{ENV['HOME']} config/database.yml" if @edit_db && @edit_db != 'n'
       File.open('config/database.yml') { |yf| @dbconfig = YAML::load(yf) }
     end
 
@@ -97,7 +103,7 @@ end
     end
     def edit_routes
       @edit_routes = request_value "would you like to edit routes.rb? default values will be used otherwise. [Y/n]" if(@edit_routes == :ask || @edit_routes.nil?)
-      system "vi config/routes.rb"
+      system "#{ENV['EDITOR']} config/routes.rb"
     end
 
     def delete_rails_index? bool

metadata

@@ -3,7 +3,7 @@ rubygems_version: 0.9.0
 specification_version: 1
 name: kickstart
 version: !ruby/object:Gem::Version 
-  version: "0.2"
+  version: 0.2.2
 date: 2007-04-15 00:00:00 -04:00
 summary: this project is intended to give the initial steps of the rails process a nice kick in the pants, allowing you to define the initial parameters of a project in a unified way.
 require_paths: