bently 1.0.0 → 1.0.1

data/README.md

@@ -4,9 +4,9 @@ Bently is a community maintained library of executable recipes for rapid applica
 
 The goal of Bently is to reduce duplication in the development process across projects, with rapid prototyping in mind.
 
-Bently is Homebrew meets Rails generators.
+Bently is [Homebrew](https://github.com/mxcl/homebrew) meets Rails generators.
 
-Bently is built on top of Thor.
+Bently is built on top of [Thor](https://github.com/wycats/thor).
 
 
 Installation
@@ -19,7 +19,7 @@ Usage
 =====
 
     bently list                   # list all recipes
-    bently list [STRING]          # search recipes matching a string
+    bently list [STRING]          # find recipes matching a string
     bently read [RECIPE]          # display a recipe without executing it
     bently bake [RECIPE]          # execute all steps in recipe
     bently bake [RECIPE] --step   # execute a recipe step by step, prompting before each step
@@ -29,9 +29,12 @@ Usage
 Example
 =======
 
-Installing and configuring devise in a Rails application.
+Installing and configuring devise in a Rails application
 
     $ bently bake devise
+    
+which executes and outputs
+
         gemfile  devise
               1  
               2  gem "devise"

data/lib/bently/core_ext/method.rb

@@ -0,0 +1,95 @@
+# (The MIT License) 
+# 
+# Copyright (c) 2011 John Mair (banisterfiend)
+# 
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# 'Software'), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+# 
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+# IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+# CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+# SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+
+if RUBY_VERSION == '1.8.7'
+  class Method
+    def trace_func(event, file, line, id, binding, classname)
+      return unless event == 'call'
+      set_trace_func nil
+
+      @file, @line = file, line
+      raise :found
+    end
+
+    private :trace_func
+
+    # Return the source location of a method for Ruby 1.8.
+    # @return [Array] A two element array. First element is the
+    #   file, second element is the line in the file where the
+    #   method definition is found.
+    def source_location
+      if @file.nil?
+        args =[*(1..(arity<-1 ? -arity-1 : arity ))]
+
+        set_trace_func method(:trace_func).to_proc
+        call(*args) rescue nil
+        set_trace_func nil
+        @file = File.expand_path(@file) if @file && File.exist?(File.expand_path(@file))
+      end
+      [@file, @line] if @file
+    end
+  end
+
+
+  class UnboundMethod
+    # Return the source location of an instance method for Ruby 1.8.
+    # @return [Array] A two element array. First element is the
+    #   file, second element is the line in the file where the
+    #   method definition is found.
+    def source_location
+      klass = case owner
+              when Class
+                owner
+              when Module
+                method_owner = owner
+                Class.new { include(method_owner) }
+              end
+
+      # deal with immediate values
+      case
+      when klass == Symbol
+        return :a.method(name).source_location
+      when klass == Fixnum
+        return 0.method(name).source_location
+      when klass == TrueClass
+        return true.method(name).source_location
+      when klass == FalseClass
+        return false.method(name).source_location
+      when klass == NilClass
+        return nil.method(name).source_location
+      end
+
+      begin
+        Object.instance_method(:method).bind(klass.allocate).call(name).source_location
+      rescue TypeError
+
+        # Assume we are dealing with a Singleton Class:
+        # 1. Get the instance object
+        # 2. Forward the source_location lookup to the instance
+        instance ||= ObjectSpace.each_object(owner).first
+        Object.instance_method(:method).bind(instance).call(name).source_location
+      end
+    end
+  end
+end

data/lib/bently/recipe/action-mailer.rb

@@ -7,56 +7,18 @@ module Bently
     def initialize
       generate 'mailer UserMailer'
       insert 'app/mailers/user_mailer.rb', welcome_email_method, :after => /^.*default.*$/
-      create './app/views/user_mailer/welcome_email.html.erb', welcome_email_html
-      create './app/views/user_mailer/welcome_email.text.erb', welcome_email_text
+      create './app/views/user_mailer/welcome_email.html.erb', template('welcome_email.html.erb')
+      create './app/views/user_mailer/welcome_email.text.erb', template('welcome_email.text.erb')
     end
 
     protected
 
     def welcome_email_method
-%{
-  # def welcome_email(user)
+%{# def welcome_email(user)
   #   @user = user
   #   @url  = "http://example.com/login"
   #   mail(:to => user.email, :subject => "Welcome to My Awesome Site")
-  # end
-}
-    end
-
-    def welcome_email_html
-%{
-<!DOCTYPE html>
-<html>
-  <head>
-    <meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
-  </head>
-  <body>
-    <h1>Welcome to example.com, <%= @user.name %></h1>
-    <p>
-      You have successfully signed up to example.com,
-      your username is: <%= @user.login %>.<br/>
-    </p>
-    <p>
-      To login to the site, just follow this link: <%= @url %>.
-    </p>
-    <p>Thanks for joining and have a great day!</p>
-  </body>
-</html>
-}
-    end
-
-    def welcome_email_text
-%{
-Welcome to example.com, <%= @user.name %>
-===============================================
-
-You have successfully signed up to example.com,
-your username is: <%= @user.login %>.
-
-To login to the site, just follow this link: <%= @url %>.
-
-Thanks for joining and have a great day!
-}
+  # end}
     end
 
   end

data/lib/bently/recipe/active_admin.rb

@@ -0,0 +1,15 @@
+module Bently
+  class ActiveAdmin < RailsRecipe
+
+    title 'active_admin'
+    homepage 'https://github.com/gregbell/active_admin/blob/master/README.rdoc'
+
+    def initialize
+      gem 'activeadmin'
+      bundle
+      generate 'active_admin:install'
+      migrate
+    end
+
+  end
+end

data/lib/bently/recipe/acts-as-taggable-on.rb

@@ -0,0 +1,18 @@
+module Bently
+  class ActsAsTaggableOn < RailsRecipe
+
+    title 'acts-as-taggable-on'
+    homepage 'https://github.com/mbleigh/acts-as-taggable-on/blob/master/README.md'
+
+    def initialize
+      gem 'acts-as-taggable-on', '~> 2.3.1'
+      bundle
+      generate 'acts_as_taggable_on:migration'
+      migrate
+      usage ''
+      code template('usage.rb')
+      usage 'See https://github.com/mbleigh/acts-as-taggable-on/blob/master/README.md#usage'
+    end
+
+  end
+end

data/lib/bently/recipe/better-errors.rb

@@ -0,0 +1,16 @@
+module Bently
+  class BetterErrors < RailsRecipe
+
+    title 'better_errors'
+    homepage 'https://github.com/charliesome/better_errors/blob/master/README.md'
+
+    def initialize
+      gem_group :development do
+        gem 'better_errors'
+        gem 'binding_of_caller'
+      end
+      bundle
+    end
+
+  end
+end

data/lib/bently/recipe/cancan.rb

@@ -0,0 +1,21 @@
+module Bently
+  class Cancan < RailsRecipe
+
+    title 'cancan'
+    category 'gem'
+    description 'downloads and installs cancan gem'
+    homepage 'https://github.com/ryanb/cancan/blob/master/README.rdoc'
+
+    def initialize
+      gem 'cancan'
+      bundle
+      generate 'cancan:ability'
+      todo 'See Defining Abilities: https://github.com/ryanb/cancan/wiki/defining-abilities'
+      todo 'See Checking Abilities: https://github.com/ryanb/cancan/wiki/checking-abilities'
+      todo 'See Authorizing Controller Actions: https://github.com/ryanb/cancan/wiki/authorizing-controller-actions'
+      todo 'See Exception Handling: https://github.com/ryanb/cancan/wiki/exception-handling'
+      todo 'See Ensure Authorization: https://github.com/ryanb/cancan/wiki/Ensure-Authorization'
+    end
+
+  end
+end

data/lib/bently/recipe/carrierwave.rb

@@ -0,0 +1,34 @@
+module Bently
+  class Carrierwave < RailsRecipe
+
+    title 'carrierwave'
+    category 'gem'
+    description 'downloads and installs carrierwave gem'
+    homepage 'https://github.com/jnicklas/carrierwave/blob/master/README.md'
+
+    def initialize
+      gem 'carrierwave'
+      bundle
+      todo 'Start off by generating an uploader:'
+      say '  rails generate uploader Avatar', ''
+      todo 'For use with ActiveRecord:'
+      say 'Make sure you are loading CarrierWave after loading your ORM, otherwise you\'ll need to require the relevant extension manually, e.g.:', '-'
+      say '  require \'carrierwave/orm/activerecord\'','1', :magenta
+      say 'Add a string column to the model you want to mount the uploader on:','-'
+      say '  add_column :users, :avatar, :string','1', :magenta
+      say 'Open your model file and mount the uploader:','-'
+      say '  class User < ActiveRecord::Base','1', :magenta
+      say '    mount_uploader :avatar, AvatarUploader','2', :magenta
+      say '  end','3', :magenta
+      say 'Now you can cache files by assigning them to the attribute, they will automatically be stored when the record is saved.','-'
+      say '  u = User.new', '1', :magenta
+      say '  u.avatar = params[:file]', '2', :magenta
+      say '  u.avatar = File.open(\'somewhere\')', '3', :magenta
+      say '  u.save!', '4', :magenta
+      say '  u.avatar.url # => \'/url/to/file.png\'', '5', :magenta
+      say '  u.avatar.current_path # => \'path/to/file.png\'', '6', :magenta
+      say '  u.avatar.identifier # => \'file.png\'', '7', :magenta
+    end
+
+  end
+end

data/lib/bently/recipe/cucumber-rails.rb

@@ -1,7 +1,7 @@
 module Bently
   class CucumberRails < RailsRecipe
 
-    name 'cucumber-rails'
+    title 'cucumber-rails'
     category 'gem'
     description 'downloads and installs cucumber-rails gem'
     homepage 'https://github.com/cucumber/cucumber-rails'

data/lib/bently/recipe/delayed-job-active-record.rb

@@ -0,0 +1,18 @@
+module Bently
+  class DelayedJobActiveRecord < RailsRecipe
+
+    title 'delayed_job Active Record'
+    category 'gem'
+    description 'downloads and installs delayed_job_active_record gem'
+    homepage 'https://github.com/collectiveidea/delayed_job/blob/master/README.md'
+    version '3.0'
+
+    def initialize
+      gem 'delayed_job_active_record'
+      bundle
+      generate 'delayed_job:active_record'
+      migrate
+    end
+
+  end
+end

data/lib/bently/recipe/delayed-job-mongoid.rb

@@ -0,0 +1,16 @@
+module Bently
+  class DelayedJobMongoid < RailsRecipe
+
+    title 'delayed_job Mongoid'
+    category 'gem'
+    description 'downloads and installs delayed_job_mongoid gem'
+    homepage 'https://github.com/collectiveidea/delayed_job/blob/master/README.md'
+    version '3.0'
+
+    def initialize
+      gem 'delayed_job_mongoid'
+      bundle
+    end
+
+  end
+end

data/lib/bently/recipe/devise.rb

@@ -1,7 +1,7 @@
 module Bently
   class Devise < RailsRecipe
 
-    name 'devise'
+    title 'devise'
     category 'gem'
     description 'downloads and installs devise gem'
     homepage 'https://github.com/plataformatec/devise/blob/master/README.md'

data/lib/bently/recipe/factory-girl-rails.rb

@@ -1,7 +1,7 @@
 module Bently
   class FactoryGirlRails < RailsRecipe
 
-    name 'factory_girl_rails'
+    title 'factory_girl_rails'
     category 'gem'
     description 'downloads and installs factory_girl_rails gem'
     homepage 'https://github.com/thoughtbot/factory_girl_rails/blob/master/README.md'
@@ -11,27 +11,7 @@ module Bently
         gem "factory_girl_rails", "~> 4.0"
       end
       bundle
-      create './spec/factories.rb', factory_file
-    end
-
-  protected
-
-    def factory_file
-  %{#  # This will guess the User class
-  #  FactoryGirl.define do
-  #    factory :user do
-  #      first_name "John"
-  #      last_name  "Doe"
-  #      admin false
-  #    end
-  #
-  #    # This will use the User class (Admin would have been guessed)
-  #    factory :admin, class: User do
-  #      first_name "Admin"
-  #      last_name  "User"
-  #      admin      true
-  #    end
-  #  end}
+      create './spec/factories.rb', template('factories.rb')
     end
 
   end

data/lib/bently/recipe/foreman-thin.rb

@@ -1,7 +1,7 @@
 module Bently
   class ForemanThin < RailsRecipe
 
-    name 'foreman-thin'
+    title 'foreman-thin'
     category 'gem'
     description 'downloads and installs foreman and thin Ruby gems'
     homepage 'https://devcenter.heroku.com/articles/rails3#webserver'

data/lib/bently/recipe/foreman.rb

@@ -1,7 +1,7 @@
 module Bently
   class Foreman < RubyRecipe
 
-    name 'foreman'
+    title 'foreman'
     category 'gem'
     description 'downloads and installs foreman gem'
     homepage 'https://github.com/ddollar/foreman/blob/master/README.md'

data/lib/bently/recipe/formtastic.rb

@@ -0,0 +1,16 @@
+module Bently
+  class Formtastic < RailsRecipe
+
+    title 'formtastic'
+    category 'gem'
+    description 'downloads and installs formtastic gem'
+    homepage 'https://github.com/justinfrench/formtastic/blob/master/README.textile'
+
+    def initialize
+      gem 'formtastic'
+      bundle
+      generate 'formtastic:install'
+    end
+
+  end
+end

data/lib/bently/recipe/gitignore-emacs.rb

@@ -5,24 +5,7 @@ module Bently
     homepage 'https://github.com/github/gitignore/blob/master/Global/Emacs.gitignore'
 
     def initialize
-      append '.gitignore', gitignore
-    end
-
-    protected
-
-    def gitignore
-%{*~
-\#*\#
-/.emacs.desktop
-/.emacs.desktop.lock
-.elc
-auto-save-list
-tramp
-.\#*
-
-# Org-mode
-.org-id-locations
-*_archive}
+      append '.gitignore', template('.gitignore')
     end
 
   end

data/lib/bently/recipe/gitignore-linux.rb

@@ -5,15 +5,7 @@ module Bently
     homepage 'https://github.com/github/gitignore/blob/master/Global/Linux.gitignore'
 
     def initialize
-      append '.gitignore', gitignore
-    end
-
-    protected
-
-    def gitignore
-%{.*
-!.gitignore
-*~}
+      append '.gitignore', template('.gitignore')
     end
 
   end

data/lib/bently/recipe/gitignore-osx.rb

@@ -5,24 +5,7 @@ module Bently
     homepage 'https://github.com/github/gitignore/blob/master/Global/OSX.gitignore'
 
     def initialize
-      append '.gitignore', gitignore
-    end
-
-    protected
-
-    def gitignore
-%{.DS_Store
-.AppleDouble
-.LSOverride
-Icon
-
-
-# Thumbnails
-._*
-
-# Files that might appear on external disk
-.Spotlight-V100
-.Trashes}
+      append '.gitignore', template('.gitignore')
     end
 
   end

data/lib/bently/recipe/gitignore-rails.rb

@@ -5,30 +5,7 @@ module Bently
     homepage 'https://github.com/github/gitignore/blob/master/Rails.gitignore'
 
     def initialize
-      append '.gitignore', gitignore
-    end
-
-    protected
-
-    def gitignore
-%{*.rbc
-*.sassc
-.sass-cache
-capybara-*.html
-.rspec
-.rvmrc
-/.bundle
-/vendor/bundle
-/log/*
-/tmp/*
-/db/*.sqlite3
-/public/system/*
-/coverage/
-/spec/tmp/*
-**.orig
-rerun.txt
-pickle-email-*.html
-.project}
+      append '.gitignore', template('.gitignore')
     end
 
   end

data/lib/bently/recipe/gitignore-ruby.rb

@@ -5,30 +5,7 @@ module Bently
     homepage 'https://github.com/github/gitignore/blob/master/Ruby.gitignore'
 
     def initialize
-      append '.gitignore', gitignore
-    end
-
-    protected
-
-    def gitignore
-%{*.gem
-*.rbc
-.bundle
-.config
-coverage
-InstalledFiles
-lib/bundler/man
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp
-
-# YARD artifacts
-# .yardoc
-# _yardoc
-# doc/}
+      append '.gitignore', template('.gitignore')
     end
 
   end

data/lib/bently/recipe/gitignore-rubymine.rb

@@ -5,13 +5,7 @@ module Bently
     homepage 'https://github.com/github/gitignore/blob/master/Global/RubyMine.gitignore'
 
     def initialize
-      append '.gitignore', gitignore
-    end
-
-    protected
-
-    def gitignore
-%{.idea/workspace.xml}
+      append '.gitignore', template('.gitignore')
     end
 
   end

data/lib/bently/recipe/gitignore-sass.rb

@@ -5,15 +5,7 @@ module Bently
     homepage 'https://github.com/github/gitignore/blob/master/Global/SASS.gitignore'
 
     def initialize
-      append '.gitignore', gitignore
-    end
-
-    protected
-
-    def gitignore
-%{### SASS Ignores - "Sassy CSS" http://sass-lang.com/
-*.sass-cache
-}
+      append '.gitignore', template('.gitignore')
     end
 
   end

data/lib/bently/recipe/gitignore-sublime-text.rb

@@ -5,14 +5,7 @@ module Bently
     homepage 'https://github.com/github/gitignore/blob/master/Global/SublimeText.gitignore'
 
     def initialize
-      append '.gitignore', gitignore
-    end
-
-    protected
-
-    def gitignore
-%{# SublimeText project files
-*.sublime-workspace}
+      append '.gitignore', template('.gitignore')
     end
 
   end

data/lib/bently/recipe/gitignore-textmate.rb

@@ -5,15 +5,7 @@ module Bently
     homepage 'https://github.com/github/gitignore/blob/master/Global/TextMate.gitignore'
 
     def initialize
-      append '.gitignore', gitignore
-    end
-
-    protected
-
-    def gitignore
-%{*.tmproj
-*.tmproject
-tmtags}
+      append '.gitignore', template('.gitignore')
     end
 
   end

data/lib/bently/recipe/gitignore-vim.rb

@@ -5,17 +5,7 @@ module Bently
     homepage 'https://github.com/github/gitignore/blob/master/Global/vim.gitignore'
 
     def initialize
-      append '.gitignore', gitignore
-    end
-
-    protected
-
-    def gitignore
-%{.*.s[a-w][a-z]
-*.un~
-Session.vim
-.netrwhist
-*~}
+      append '.gitignore', template('.gitignore')
     end
 
   end