redmint_composer 2.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 137977fbed3b36d9ef12a590e5f706439824aa18
+  data.tar.gz: cd727d83d3c145b8e28d2e3fe9c720946c2c20cc
+SHA512:
+  metadata.gz: ea24428e963a6b898e076da461661d7e338c7a9bd7e5b1641fa208ee91f3cb2304b6613517972825d7e63d4425036c8c674de95a362af0970b8a8f88830ef841
+  data.tar.gz: 5cf00a1bf3d285ca6632070312a7d08832fbbcd9706d86d167bc5112a0034d41ff4a7add1e21379afc8e179beadd6d515876ffe842fb5d2cd93c6dbbd942fe95

data/README.textile

@@ -0,0 +1,10 @@
+h1. Redmint Composer
+
+The Redmint Composer gem installs a command line tool to assemble a Rails application from a collection of "recipes." (Based on rails_app_composer gem)
+
+<pre>
+$ rvm use 2.2.2
+$ gem install rails
+$ gem install redmint_composer
+$ redmint_composer new myapp -r core
+</pre>

data/bin/redmint_composer

@@ -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.rb

@@ -0,0 +1,7 @@
+require 'rails_wizard/recipes'
+require 'rails_wizard/recipe'
+require 'rails_wizard/config'
+require 'rails_wizard/diagnostics'
+require 'rails_wizard/template'
+
+RailsWizard::Recipes.add_from_directory(File.dirname(__FILE__) + '/../recipes')

data/lib/rails_wizard/command.rb

@@ -0,0 +1,204 @@
+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"
+    method_option :defaults, :type => :string, :aliases => "-d"
+    method_option :recipe_dirs, :type => :array, :aliases => "-l"
+    method_option :no_default_recipes, :type => :boolean, :aliases => "-L"
+    method_option :template_root, :type => :string, :aliases => '-t'
+    method_option :quiet, :type => :boolean, :aliases => "-q", :default => false
+    method_option :verbose, :type => :boolean, :aliases => "-V", :default => false
+    def new(name)
+      add_recipes
+      recipes, defaults = load_defaults
+      (print "\ndefaults: "; p defaults) if options[:verbose]
+      args = ask_for_args(defaults)
+      (print "\nargs: "; p args) if options[:verbose]
+      recipes = ask_for_recipes(recipes)
+      (print "\nrecipes: "; p recipes) if options[:verbose]
+      gems = ask_for_gems(defaults)
+      (print "\ngems: "; p gems) if options[:verbose]
+      run_template(name, recipes, gems, args, defaults, nil)
+    end
+
+    desc "template TEMPLATE_FILE", "create a new Rails template"
+    method_option :recipes, :type => :array, :aliases => "-r"
+    method_option :defaults, :type => :string, :aliases => "-d"
+    method_option :recipe_dirs, :type => :array, :aliases => "-l"
+    method_option :no_default_recipes, :type => :boolean, :aliases => "-L"
+    method_option :template_root, :type => :string, :aliases => '-t'
+    method_option :quiet, :type => :boolean, :aliases => "-q", :default => false
+    method_option :verbose, :type => :boolean, :aliases => "-V", :default => false
+    def template(template_name)
+      add_recipes
+      recipes, defaults = load_defaults
+      recipes = ask_for_recipes(recipes)
+      gems = ask_for_gems(defaults)
+      run_template(nil, recipes, gems, nil, defaults, template_name)
+    end
+
+    desc "list [CATEGORY]", "list available recipes (optionally by category)"
+    def list(category = nil)
+      recipes = if category
+        RailsWizard::Recipes.for(category).map{|e| RailsWizard::Recipe.from_mongo e}
+      else
+        RailsWizard::Recipes.list_classes
+      end
+      address = 'https://github.com/RailsApps/rails_apps_composer/wiki/tutorial-rails-apps-composer#recipes'
+      say("To learn more about recipes, see:\n#{address}", [:bold, :cyan])
+# https://github.com/wycats/thor/blob/master/lib/thor/shell/basic.rb
+      recipes.each{|e| say("#{e.key.ljust 15}# #{e.description}")}
+    end
+
+    no_tasks do
+
+      def add_recipes
+        Recipes.clear if options[:no_default_recipes]
+        if dirs = options[:recipe_dirs]
+          dirs.each {|d| Recipes.add_from_directory d}
+        end
+      end
+
+      def load_defaults
+        # Load defaults from a file; if a file specifies recipes, they'll be run *before*
+        # any on the command line (or prompted for)..
+        return [[], {}] unless options[:defaults]
+        defaults = Kernel.open(options[:defaults]) {|f| YAML.load(f) }
+        recipes = defaults.delete('recipes') { [] }
+        [recipes, defaults]
+      end
+
+      def print_recipes(recipes)
+        say("\nAvailable Recipes:", [:bold, :cyan])
+        RailsWizard::Recipes.categories.each do |category|
+          say("#{category} ", [:bold, :cyan])
+          a = RailsWizard::Recipes.for(category)
+          a.each_with_index do |e,i|
+            s = (a.length - 1 == i) ? "#{e}" : "#{e}, "
+            if recipes.include?(e)
+              say(s, [:bold, :green])
+            else
+              say(s)
+            end
+          end
+        end
+      end
+
+      def ask_for_recipes(recipes)
+        return recipes + options[:recipes] if options[:recipes]
+        return recipes if options[:quiet]
+        loop do
+          recipe = prompt_for_recipes(recipes)
+          break if '' == recipe
+          case
+          when recipes.include?(recipe)
+            recipes -= [recipe]
+          when RailsWizard::Recipes.list.include?(recipe)
+            recipes << recipe
+          else
+            say("\n> Invalid recipe, please try again.", :red)
+          end
+        end
+        recipes
+      end
+
+      def prompt_for_recipes(recipes)
+        print_recipes(recipes)
+        say("\nWhich recipe would you like to add? ", :bold)
+        ask('(blank to finish)', :yellow)
+      end
+
+      def ask_for_gems(defaults)
+        gems = defaults["gems"] || []
+        return gems if options[:quiet]
+        loop do
+          getgem = prompt_for_gems
+          break if '' == getgem
+          gems << getgem.downcase
+        end
+        gems
+      end
+
+      def prompt_for_gems
+        say('What gem would you like to add? ', :bold)
+        ask('(blank to finish)', :yellow)
+      end
+
+      def ask_for_arg(question, default = nil)
+        return default unless default.nil?
+        say("#{question} ", :bold)
+        result = nil
+        loop do
+          answer = ask('(y/n)', :yellow)
+          case answer.downcase
+          when "yes", "y"
+            result = true
+            break
+          when "no", "n"
+            result = false
+            break
+          end
+        end
+        result
+      end
+
+      def ask_for_args(defaults)
+        args = []
+        default_args = defaults["args"] || {}
+        s = 'Would you like to skip'
+
+        question = "#{s} Test::Unit? (yes for RSpec)"
+        args << "-T" if ask_for_arg(question, default_args[:skip_test_unit])
+
+        question = "#{s} Active Record? (yes for MongoDB)"
+        args << "-O" if ask_for_arg(question, default_args[:skip_active_record])
+
+        args
+      end
+
+      def make_red(s)
+# http://en.wikipedia.org/wiki/ANSI_escape_code
+# http://en.wikibooks.org/wiki/Ruby_Programming/Syntax/Literals#Backslash_Notation
+        "\e[31m#{s}\e[0m"
+      end
+
+      #pass in name if you want to create a rails app
+      #pass in file_name if you want to create a template
+      def run_template(name, recipes, gems, args, defaults, file_name=nil)
+        if opt = options[:template_root]
+          RailsWizard::Template.template_root = opt
+        end
+
+        file = if file_name
+          File.new(file_name,'w')
+        else
+          Tempfile.new('template')
+        end
+        begin
+          template = RailsWizard::Template.new(recipes, gems, args, defaults)
+          file.write template.compile
+          file.close
+          if name
+            args_list = (args | template.args).join(' ')
+            say('Generating basic application, using: ')
+            say("\"rails new #{name} -m <temp_file> #{args_list}\"")
+            system "rails new #{name} -m #{file.path} #{args_list}"
+          else
+            say('Generating and saving application template... ')
+            say('Done. ')
+            say('Generate a new application with the command: ')
+            say("\"rails new <APP_NAME> -m #{file.path} #{template.args.join ' '}\"")
+          end
+        rescue RailsWizard::UnknownRecipeError
+          raise Thor::Error.new(make_red("> #{$!.message}."))
+        ensure
+          file.unlink unless file_name
+        end
+      end
+    end
+  end
+end

data/lib/rails_wizard/config.rb

@@ -0,0 +1,88 @@
+require 'active_support/ordered_hash'
+
+module RailsWizard
+  class Config
+    attr_reader :questions, :defaults
+
+    def initialize(schema, defaults=nil)
+      @questions = ActiveSupport::OrderedHash.new
+      @defaults = defaults
+      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 = []
+      values.merge!(defaults) if defaults
+      result << "config = #{values.inspect}"
+      @questions.each_pair do |key, question|
+        result << "config['#{key}'] = #{question.compile} unless config.key?('#{key}') || prefs.has_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/diagnostics.rb

@@ -0,0 +1,58 @@
+module RailsWizard
+  module Diagnostics
+
+    ### collections of recipes that are known to work together
+    @@recipes = []
+    @@recipes << %w(example)
+    @@recipes << %w(setup)
+    @@recipes << %w(railsapps)
+    @@recipes << %w(gems setup)
+    @@recipes << %w(gems readme setup)
+    @@recipes << %w(extras gems readme setup)
+    @@recipes << %w(example git)
+    @@recipes << %w(git setup)
+    @@recipes << %w(git railsapps)
+    @@recipes << %w(gems git setup)
+    @@recipes << %w(gems git readme setup)
+    @@recipes << %w(extras gems git readme setup)
+    @@recipes << %w(email extras frontend gems git init railsapps readme setup testing)
+    @@recipes << %w(core email extras frontend gems git init railsapps readme setup testing)
+    @@recipes << %w(core email extras frontend gems git init railsapps readme setup testing)
+    @@recipes << %w(core email extras frontend gems git init railsapps readme setup testing)
+    @@recipes << %w(email example extras frontend gems git init railsapps readme setup testing)
+    @@recipes << %w(email example extras frontend gems git init railsapps readme setup testing)
+    @@recipes << %w(email example extras frontend gems git init railsapps readme setup testing)
+    @@recipes << %w(apps4 core email extras frontend gems git init railsapps readme setup testing)
+    @@recipes << %w(apps4 core email extras frontend gems git init railsapps readme setup tests)
+    @@recipes << %w(apps4 core deployment email extras frontend gems git init railsapps readme setup testing)
+    @@recipes << %w(apps4 core deployment email extras frontend gems git init railsapps readme setup tests)
+    @@recipes << %w(apps4 core deployment devise email extras frontend gems git init omniauth pundit railsapps readme setup tests)
+
+    ### collections of preferences that are known to work together
+
+    # ignore these preferences (because they don't cause conflicts)
+    # :ban_spiders
+    # :better_errors
+    # :dev_webserver
+    # :git
+    # :github
+    # :jsruntime
+    # :local_env_file
+    # :main_branch
+    # :prelaunch_branch
+    # :prod_webserver
+    # :quiet_assets
+    # :rvmrc
+    # :templates
+
+    @@prefs = []
+
+    def self.recipes
+      @@recipes
+    end
+
+    def self.prefs
+      @@prefs
+    end
+  end
+end

data/lib/rails_wizard/recipe.rb

@@ -0,0 +1,114 @@
+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 defaults)
+    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], attributes[:defaults])
+    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)
+      return RailsWizard::Recipes[key] if RailsWizard::Recipes[key]
+      raise(RailsWizard::UnknownRecipeError.new(key))
+    end
+
+    def self.get_binding
+      binding
+    end
+  end
+
+  class UnknownRecipeError < StandardError
+    def initialize(key)
+      message = "No recipe found with name '#{key}'"
+      super(message)
+    end
+  end
+end