rails3_devise_wizard 0.2

data/README.textile

@@ -0,0 +1,135 @@
+h1. Rails3 Devise Wizard Gem
+
+A gem to create a ready-to-run Rails web application you can deploy in minutes.
+
+This gem can be used to create the "rails3-mongoid-devise":http://github.com/fortuity/rails3-mongoid-devise/ example application, as described in a detailed "tutorial":http://github.com/fortuity/rails3-mongoid-devise/wiki/Tutorial-%28Walkthrough%29.
+
+h2. Based on Michael Bleigh's RailsWizard Gem
+
+The rails3_devise_wizard gem is a fork of "Michael Bleigh's RailsWizard gem":https://github.com/intridea/rails_wizard (see credits below). The purpose of this fork is to provide recipes for a ready-to-run Rails web application that uses Devise for authentication.
+
+h2. Dependencies
+
+Before generating a new Rails app using an application template, you will need:
+
+* The Ruby language (version 1.8.7 or 1.9.2)
+* Rails (version 3.0.4 or newer)
+
+I recommend installing rvm, the "Ruby Version Manager":http://rvm.beginrescueend.com/, to manage multiple versions of Rails.
+
+If you are using rvm, you can see a list of the Ruby versions currently installed:
+@$ rvm list@
+
+Check that appropriate versions of Ruby and Rails are installed in your development environment:
+@$ ruby -v@
+@$ rails -v@
+
+h2. Installation
+
+Installation is simple:
+
+bc. gem install rails3_devise_wizard, :git => 'git://github.com/fortuity/rails3_devise_wizard.git'
+
+
+h2. Usage
+
+The @rails3_devise_wizard@ gem offers an interactive terminal command to build a Rails application template. To get started, run:
+
+bc. rails3_devise_wizard new APP_NAME
+
+
+Where @APP_NAME@ is the directory in which you wish to create the app (it mirrors the Rails creation syntax). You will then be guided through the recipe selection process and subsequently the Rails app generator will automatically run with the template and all appropriate command line options included.
+
+h4. Specifying Recipes
+
+If you wish to skip the interactive recipe selector, you may provide instead a list of recipes with the @-r@ option:
+
+bc. rails3_devise_wizard new APP_NAME -r jquery mongo_mapper sass
+
+
+This will automatically generate a Rails template with the provided recipes and launch the app generator.
+
+h4. Listing Recipes
+
+You can also print out a simple list of recipes:
+
+bc. rails3_devise_wizard list
+
+
+Or print out a list of recipes for a specific category:
+
+bc. rails3_devise_wizard list persistence
+
+
+h2. Rails3 Devise Wizard Recipes
+
+You can find the rails3_devise_wizard recipe collection in the GitHub repository's "recipes directory":https://github.com/fortuity/rails3_devise_wizard/tree/master/recipes. If you find errors or fork a recipe you can submit a pull request or create a "Github issue":http://github.com/fortuity/rails3_devise_wizard/issues.
+
+h4. Writing New Recipes
+
+Recipes are made of up *template code* and *YAML back-matter* stored in a ruby file. The @__END__@ parsing convention is used so that each recipe is actually a valid, parseable Ruby file. The structure of a recipe looks something like this:
+
+<pre>
+gem 'supergem'
+
+after_bundler do
+  generate &quot;supergem:install&quot;
+end
+
+__END__
+
+category: templating
+name: SuperGem
+description: Installs SuperGem which is useful for things
+author: mbleigh
+</pre>
+
+The gem has RSpec tests that automatically validate each recipe in the repository, so you should run @rake spec@ as a basic sanity check before submitting a pull request. Note that these don't verify that your recipe code itself works, just that the gem could properly parse and understand your recipe file.
+
+For more information on all available options for authoring recipes, please see the "wiki for Michael Bleigh's  RailsWizard gem":https://github.com/intridea/rails_wizard/wiki.
+
+h2. How It Works
+
+Rails generators can use any methods provided by the "Thor::Actions":http://rdoc.info/github/wycats/thor/master/Thor/Actions module. The flexibility of mixing "recipes" for application templates comes from use of the @apply@ method from the Thor::Actions module. Given a web address or a local filepath, the "apply method":http://rdoc.info/github/wycats/thor/master/Thor/Actions#apply-instance_method loads and executes a file within the context of the generator script.
+
+h2. Documentation and Support
+
+This is the only documentation.
+
+h4. Writing Recipes
+
+To understand the code in these templates, take a look at "Thor::Actions":http://rdoc.info/github/wycats/thor/master/Thor/Actions. Your recipes can use any methods provided by "Thor::Actions":http://rdoc.info/github/wycats/thor/master/Thor/Actions or "Rails::Generators::Actions":http://railsapi.com/doc/rails-v3.0.3/classes/Rails/Generators/Actions.html.
+
+Please send a message (via GitHub) or a "pull request" if you've written recipes you'd like to contribute.
+
+h4. About Rails Application Templates
+
+"Cooking Up A Custom Rails 3 Template (11 Oct 2010) by Andrea Singh":http://blog.madebydna.com/all/code/2010/10/11/cooking-up-a-custom-rails3-template.html
+"Rails Application Templates (16 Sept 2010) by Collin Schaafsma":http://quickleft.com/blog/rails-application-templates
+"Application templates in Rails 3 (18 Sept 2009) by Ben Scofield":http://benscofield.com/2009/09/application-templates-in-rails-3/
+"Railscasts: App Templates in Rails 2.3 (9 Feb 2009) by Ryan Bates":http://railscasts.com/episodes/148-app-templates-in-rails-2-3
+"Rails templates (4 Dec 2008) by Pratik Naik":http://m.onkey.org/rails-templates
+
+h2. Issues
+
+Any issues? Please create a "GitHub issue":http://github.com/fortuity/rails3_devise_wizard/issues.
+
+h2. Credits
+
+This project is based on "Michael Bleigh's RailsWizard gem":https://github.com/intridea/rails_wizard. The original idea for a RailsWizard and the innovative implementation is the work of Michael Bleigh.
+
+"Fletcher Nichol's":http://silversky.ca/ project  "fnichol/rails-template-recipes":https://github.com/fnichol/rails-template-recipes provides the basis for several recipes.
+
+RSpec, Cucumber, and Yard recipes were contributed by "Ramon Brooker":http://cogniton-mind.tumblr.com/.
+
+Additional recipes by me, Daniel Kehoe "http://danielkehoe.com/":http://danielkehoe.com/, to implement the "rails3-mongoid-devise":http://github.com/fortuity/rails3-mongoid-devise/ example application.
+
+Is the gem useful to you? Follow me on Twitter:
+"http://twitter.com/railsinit":http://twitter.com/railsinit
+and tweet some praise. I'd love to know you were helped out by the gem.
+
+h2. License
+
+h4. MIT License
+
+The rails3_devise_wizard gem and its recipes are distributed under the MIT License.

data/bin/rails3_devise_wizard

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+$:.push File.dirname(__FILE__) + '/../lib'
+
+require 'rubygems'
+require 'rails_wizard/command'
+
+RailsWizard::Command.start

data/lib/rails_wizard/command.rb

@@ -0,0 +1,79 @@
+require 'rails_wizard'
+require 'thor'
+
+module RailsWizard
+  class Command < Thor
+    include Thor::Actions
+    desc "new APP_NAME", "create a new Rails app"
+    method_option :recipes, :type => :array, :aliases => "-r"
+    def new(name)
+      if options[:recipes]
+        run_template(name, options[:recipes])
+      else
+        @recipes = []
+
+        while recipe = ask("#{print_recipes}#{bold}Which recipe would you like to add? #{clear}#{yellow}(blank to finish)#{clear}")
+          if recipe == ''
+            run_template(name, @recipes)
+            break
+          elsif RailsWizard::Recipes.list.include?(recipe)
+            @recipes << recipe
+            puts
+            puts "> #{green}Added '#{recipe}' to template.#{clear}"
+          else
+            puts
+            puts "> #{red}Invalid recipe, please try again.#{clear}"
+          end
+        end
+      end
+    end
+
+    desc "list [CATEGORY]", "list available recipes (optionally by category)"
+    def list(category = nil)
+      if category
+        recipes = RailsWizard::Recipes.for(category).map{|r| RailsWizard::Recipe.from_mongo(r) }
+      else
+        recipes = RailsWizard::Recipes.list_classes
+      end
+
+      recipes.each do |recipe|
+        puts recipe.key.ljust(15) + "# #{recipe.description}"
+      end
+    end
+
+    no_tasks do
+      def cyan; "\033[36m" end
+      def clear; "\033[0m" end
+      def bold; "\033[1m" end
+      def red; "\033[31m" end
+      def green; "\033[32m" end
+      def yellow; "\033[33m" end
+
+      def print_recipes
+        puts
+        puts
+        puts
+        if @recipes && @recipes.any?
+          puts "#{green}#{bold}Your Recipes:#{clear} " + @recipes.join(", ")
+          puts
+        end
+        puts "#{bold}#{cyan}Available Recipes:#{clear} " + RailsWizard::Recipes.list.join(', ')
+        puts
+      end
+
+      def run_template(name, recipes)
+        puts
+        puts
+        puts "#{bold}Generating and Running Template..."
+        puts
+        file = Tempfile.new('template')        
+        template = RailsWizard::Template.new(recipes)
+        file.write template.compile
+        file.close
+        system "rails new #{name} -m #{file.path} #{template.args.join(' ')}"
+      ensure
+        file.unlink
+      end
+    end
+  end
+end

data/lib/rails_wizard/config.rb

@@ -0,0 +1,86 @@
+require 'active_support/ordered_hash'
+
+module RailsWizard
+  class Config
+    attr_reader :questions
+
+    def initialize(schema)
+      @questions = ActiveSupport::OrderedHash.new
+      schema.each do |hash| 
+        key = hash.keys.first
+        details = hash.values.first
+
+        kind = details['type']
+        raise ArgumentError, "Unrecognized question type, must be one of #{QUESTION_TYPES.keys.join(', ')}" unless QUESTION_TYPES.keys.include?(kind)
+        @questions[key] = QUESTION_TYPES[kind].new(details)
+      end
+    end
+
+    def compile(values = {})
+      result = []
+      result << "config = #{values.inspect}"
+      @questions.each_pair do |key, question|
+        result << "config['#{key}'] = #{question.compile} unless config.key?('#{key}')"
+      end
+      result.join("\n")
+    end
+
+    class Prompt
+      attr_reader :prompt, :details
+      def initialize(details)
+        @details = details
+        @prompt = details['prompt']
+      end
+
+      def compile
+        "#{question} if #{conditions}"
+      end
+
+      def question
+        "ask_wizard(#{prompt.inspect})"
+      end
+
+      def conditions
+        [config_conditions, recipe_conditions].join(' && ')
+      end
+
+      def config_conditions
+        if details['if']
+          "config['#{details['if']}']"
+        elsif details['unless']
+          "!config['#{details['unless']}']"
+        else
+          'true'
+        end
+      end
+
+      def recipe_conditions
+        if details['if_recipe']
+          "recipe?('#{details['if_recipe']}')"
+        elsif details['unless_recipe']
+          "!recipe?('#{details['unless_recipe']}')"
+        else
+          'true'
+        end
+      end
+    end
+
+    class TrueFalse < Prompt
+      def question 
+        "yes_wizard?(#{prompt.inspect})"
+      end
+    end
+
+    class MultipleChoice < Prompt
+      def question
+        "multiple_choice(#{prompt.inspect}, #{@details['choices'].inspect})"
+      end 
+    end
+
+    QUESTION_TYPES = {
+      'boolean' => TrueFalse,
+      'string' => Prompt,
+      'multiple_choice' => MultipleChoice
+    }
+  end
+end

data/lib/rails_wizard/recipe.rb

@@ -0,0 +1,106 @@
+require 'rails_wizard/config'
+
+require 'active_support/inflector'
+require 'yaml'
+require 'erb'
+
+module RailsWizard
+  class Recipe
+    extend Comparable
+    
+    def self.<=>(another)
+      return -1 if another.run_after.include?(self.key) || self.run_before.include?(another.key)
+      return 1 if another.run_before.include?(self.key) || self.run_after.include?(another.key)
+      self.key <=> another.key
+    end
+
+    ATTRIBUTES = %w(key args category name description template config exclusive tags run_before run_after requires)
+    DEFAULT_ATTRIBUTES = {
+      :category => 'other',
+      :args => [],
+      :tags => [],
+      :run_after => [],
+      :run_before => [],
+      :requires => []
+    }
+
+    def self.generate(key, template_or_file, attributes = {})
+      if template_or_file.respond_to?(:read)
+        file = template_or_file.read
+        parts = file.split(/^__END__$/)
+        raise ArgumentError, "The recipe file must have YAML matter after an __END__" unless parts.size == 2
+        template = parts.first.strip
+        attributes = YAML.load(parts.last).inject({}) do |h,(k,v)|
+          h[k.to_sym] = v
+          h
+        end.merge!(attributes)
+      else
+        template = template_or_file
+      end
+ 
+      recipe_class = Class.new(RailsWizard::Recipe) 
+      recipe_class.attributes = attributes
+      recipe_class.template = template
+      recipe_class.key = key
+
+      recipe_class
+    end
+
+    ATTRIBUTES.each do |setter|
+      class_eval <<-RUBY
+        def self.#{setter}
+          attributes[:#{setter}]
+        end
+
+        def self.#{setter}=(val)
+          attributes[:#{setter}] = val
+        end
+
+        def #{setter}
+          self.class.#{setter}
+        end
+      RUBY
+    end
+
+    # The attributes hash containing any set values for
+    def self.attributes
+      @attributes ||= DEFAULT_ATTRIBUTES.dup
+    end
+
+    def self.attributes=(hash)
+      attributes.merge! hash
+    end
+
+    def self.config
+      return nil unless attributes[:config]
+      RailsWizard::Config.new(attributes[:config])
+    end
+
+    def attributes
+      self.class.attributes
+    end
+
+    def self.compile
+      "# >#{"[ #{name} ]".center(75,'-')}<\n\n# #{description}\nsay_recipe '#{name}'\n\n#{template}\n"
+    end
+    def compile; self.class.compile end
+
+    def self.to_mongo(value)
+      case value
+        when Class
+          value.key
+        when String
+          value
+      end
+    end
+
+    def self.from_mongo(key)
+      return key if key.respond_to?(:superclass) && key.superclass == RailsWizard::Recipe
+      RailsWizard::Recipes[key]
+    end
+
+    def self.get_binding
+      binding
+    end
+  end
+end

data/lib/rails_wizard/recipes.rb

@@ -0,0 +1,38 @@
+module RailsWizard
+  module Recipes
+    @@categories = {}
+    @@list = {}
+    
+    def self.add(recipe)
+      RailsWizard::Recipes.const_set ActiveSupport::Inflector.camelize(recipe.key), recipe
+      @@list[recipe.key] = recipe
+      (@@categories[recipe.category.to_s] ||= []) << recipe.key
+      @@categories[recipe.category.to_s].uniq!
+      recipe
+    end
+
+    def self.[](key)
+      @@list[key.to_s]
+    end
+
+    def self.list
+      @@list.keys.sort
+    end
+
+    def self.list_classes
+      @@list.values.sort_by{|c| c.key}
+    end
+
+    def self.categories
+      @@categories.keys.sort
+    end
+
+    def self.for(category)
+      (@@categories[category.to_s] || []).sort
+    end
+
+    def self.remove_from_category(category, recipe)
+      (@@categories[category.to_s] ||= []).delete(recipe.key)
+    end
+  end
+end