suspenders 0.0.2

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2010 Mike Burns
+
+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.

data/README.md

@@ -0,0 +1,165 @@
+Suspenders is a base Rails project that you can upgrade. It is used by
+thoughtbot.
+
+![Suspenders](http://www.blogcdn.com/www.autoblog.com/media/2008/08/misuse-of-hydraulics.jpg)
+
+To create a new project first install suspenders:
+
+  gem install suspenders
+
+Then run:
+
+  suspenders create projectname
+
+This will create a project in `projectname'.  You should then follow the
+instructions on Github to upload that project there.  This script creates an
+entirely new git repository, and is not meant to be used against an existing
+repo.
+
+When making a change to a project that was created via this template, consider
+whether it's a change that should be made across all projects.  If so, then
+make the change in suspenders instead of your project.  Note: If you don't
+have commit access to suspenders, create a github ticket and we'll review your
+suggestion.
+
+Once that's committed, you can pull into your project to get all the changes 
+that have been made in suspenders since your last pull:
+
+  git pull suspenders master
+
+About Suspenders
+----------------
+
+Suspenders was created for use at thoughtbot, inc. (http://thoughtbot.com) as a
+baseline application setup, with reasonable default plugins that the majority
+(if not all) of our applications used, as well as best-practice configuration
+options.
+
+Suspenders currently includes a version of Rails from the 2.3 stable branch.
+You can determine the changeset with the vendor/rails/REVISION_xxxxx file.
+
+Gems (unpacked in vendor/gems, unless they are compiled gems):
+--------------------------------------------------------------
+
+For record pagination:
+
+  will_paginate (2.3.11)
+
+For text formatting:
+
+  RedCloth (4.2.2, not unpacked, this is a compiled gem)
+
+Form builder:
+
+  Formtastic (0.2.1)
+
+File attachments:
+
+  Paperclip (2.3.0)
+
+Basic user auth:
+
+  Clearance (0.7.0 engine)
+
+For testing:
+
+  jferris-mocha (standard mocha plus test spies)
+  factory_girl (fixture replacement for test data)
+  shoulda (rails test helpers and context framework)
+  timecop (for time sensitive tests)
+  fakeweb (for blocking HTTP calls to third-party services)
+
+Plugins (in vendor/plugins):
+----------------------------
+
+  hoptoad_notifier
+  limerick_rake
+  validation_reflection (used by formtastic to find required fields)
+
+Initializers (in config/initializers)
+-------------------------------------
+
+  action_mailer_configs.rb
+  We use SMTP by default in all applications.
+
+  hoptoad.rb
+  Get your API key at http://hoptoadapp.com
+  
+  requires.rb
+  Automatically requires everything in
+    lib/
+    lib/extensions
+    test/mocks/RAILS_ENV (Removed in Rails 2, we decided to keep it)
+  Add other things you need to require in here.
+
+  time_formats.rb
+  Two time formats are available by default, :short_date and :long_date.
+  Add other time formats here.
+  
+Rake Tasks
+----------
+
+Rake tasks are contained in the limerick_rake gem.
+
+  bootstrap
+  Provides rake tasks for loading data into the database.  These are used for
+  an initial application dataset needed for production.
+  
+  capistrano
+  Standard capistrano deployment tasks
+  
+Testing
+-------
+
+Testing is done utilizing Test::Unit, Shoulda, factory_girl, and mocha.
+
+factory_girl is a fixture replacement library, following the factory pattern.
+Place your factories in test/factories.rb.  The fixture directory has been
+removed, as fixtures are not used.
+
+Shoulda is a pragmatic testing framework for TDD and BDD built on top of
+Test::Unit.  A number of additional testing macros are provided in
+test/shoulda_macros:
+
+  shoulda_have_form
+  shoulda_paginate_collection
+
+Timecop is used to freeze the time for the entire test suite. It is frozen to
+the value of Time.now; that is, the time that the tests suite starts running.
+
+Deployment
+----------
+
+Deployment is done using capistrano, and deploys to a mongrel cluster, running
+under Apache.
+
+Rake tasks are provided for managing git branches which the different
+environments pull from for deploy.
+
+To push the git master to git staging branch run:
+
+  rake git:push:staging
+
+To push the git staging branch to production branch run:
+
+  rake git:push:production
+
+Setup your deployment environment by running:
+
+  cap ENVIRONMENT deploy:setup
+  (You'll be prompted for the environment's database password)
+
+Deploy to the desired environment by running:
+
+  cap ENVIRONMENT deploy
+  
+The default environment for deploy is staging, to deploy to staging, just run:
+
+  cap deploy
+
+Mascot
+------
+
+The official Suspenders mascot is Suspenders Boy:
+
+  http://media.tumblr.com/1TEAMALpseh5xzf0Jt6bcwSMo1_400.png

data/Rakefile

@@ -0,0 +1,130 @@
+require 'rubygems'
+require 'rake'
+require 'cucumber/rake/task'
+require 'date'
+
+TEST_PROJECT = 'test_project'
+SUSPENDERS_GEM_VERSION = '0.0.2'
+
+#############################################################################
+#
+# Testing functions
+#
+#############################################################################
+
+Cucumber::Rake::Task.new
+
+namespace :test do
+  desc "A full suspenders app's test suite"
+  task :full => ['generate:suspenders', 'generate:finish', 'cucumber', 'destroy:suspenders']
+end
+
+namespace :generate do
+  desc 'Suspend a new project'
+  task :suspenders do
+    sh './bin/suspenders', 'create', TEST_PROJECT
+  end
+
+  desc 'Finishing touches'
+  task :finish do
+    open(File.join(TEST_PROJECT, 'config', 'environments', 'cucumber.rb'), 'a') do |f|
+      f.puts "config.action_mailer.default_url_options = { :host => 'localhost:3000' }"
+    end
+
+    routes_file = IO.read(File.join(TEST_PROJECT, 'config', 'routes.rb')).split("\n")
+    routes_file = [routes_file[0]] + [%{map.root :controller => 'clearance/sessions', :action => 'new'}] + routes_file[1..-1]
+    open(File.join(TEST_PROJECT, 'config', 'routes.rb'), 'w') do |f|
+      f.puts routes_file.join("\n")
+    end
+  end
+end
+
+namespace :destroy do
+  desc 'Remove a suspended project'
+  task :suspenders do
+    FileUtils.rm_rf TEST_PROJECT
+  end
+end
+
+desc 'Run the test suite'
+task :default => ['test:full']
+
+#############################################################################
+#
+# Helper functions
+#
+#############################################################################
+
+def name
+  @name ||= Dir['*.gemspec'].first.split('.').first
+end
+
+def version
+  SUSPENDERS_GEM_VERSION
+end
+
+def date
+  Date.today.to_s
+end
+
+def gemspec_file
+  "#{name}.gemspec"
+end
+
+def gem_file
+  "#{name}-#{version}.gem"
+end
+
+def replace_header(head, header_name)
+  head.sub!(/(\.#{header_name}\s*= ').*'/) { "#{$1}#{send(header_name)}'"}
+end
+
+#############################################################################
+#
+# Packaging tasks
+#
+#############################################################################
+
+task :release => :build do
+  unless `git branch` =~ /^\* master$/
+    puts "You must be on the master branch to release!"
+    exit!
+  end
+  sh "git commit --allow-empty -a -m 'Release #{version}'"
+  sh "git tag v#{version}"
+  sh "git push origin master"
+  sh "git push --tags"
+  sh "gem push pkg/#{name}-#{version}.gem"
+end
+
+task :build => :gemspec do
+  sh "mkdir -p pkg"
+  sh "gem build #{gemspec_file}"
+  sh "mv #{gem_file} pkg"
+end
+
+task :gemspec do
+  # read spec file and split out manifest section
+  spec = File.read(gemspec_file)
+  head, manifest, tail = spec.split("  # = MANIFEST =\n")
+
+  # replace name version and date
+  replace_header(head, :name)
+  replace_header(head, :version)
+  replace_header(head, :date)
+
+  # determine file list from git ls-files
+  files = `git ls-files`.
+    split("\n").
+    sort.
+    reject { |file| file =~ /^\./ }.
+    reject { |file| file =~ /^(rdoc|pkg)/ }.
+    map { |file| "    #{file}" }.
+    join("\n")
+
+  # piece file back together and write
+  manifest = "  s.files = %w[\n#{files}\n  ]\n"
+  spec = [head, manifest, tail].join("  # = MANIFEST =\n")
+  File.open(gemspec_file, 'w') { |io| io.write(spec) }
+  puts "Updated #{gemspec_file}"
+end

data/bin/suspenders

@@ -0,0 +1,80 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'active_support'
+require 'pathname'
+require 'digest/md5'
+
+### currently the only thing you can do is create. So we ignore the first argument
+project_name = ARGV[1]
+fail("Usage:  #{File.basename(__FILE__)} create new_project_name")     unless project_name
+fail("Project name must only contain [a-z0-9_]")                       unless project_name =~ /^[a-z0-9_]+$/
+
+base_directory = Dir.pwd
+project_directory = File.join(base_directory, project_name)
+fail("Project directory (#{project_directory}) already exists") if File.exists?(project_directory)
+
+template_url = "git://github.com/thoughtbot/suspenders.git"
+changeme = "CHANGEME"
+changesession = "CHANGESESSION"
+
+def run(cmd)
+  puts "Running '#{cmd}'"
+  out = `#{cmd}`
+  if $? != 0
+    fail "Command #{cmd} failed: #$?\n#{out}"
+  end
+  out
+end
+
+def search_and_replace(file, search, replace)
+  if File.file?(file)
+    contents = File.read(file)
+    if contents[search]
+      puts "Replacing #{search} with #{replace} in #{file}"
+      contents.gsub!(search, replace)
+      File.open(file, "w") { |f| f << contents }
+    end
+  end
+end
+
+def installed?(gem_name)
+  installed_gems = Gem.source_index.find_name(gem_name)
+  installed_gems.any?
+end
+
+run("mkdir #{project_directory}")
+Dir.chdir(project_directory) or fail("Couldn't change to #{project_directory}")
+run("git init")
+run("git remote add suspenders #{template_url}")
+run("git pull suspenders master")
+
+Dir.glob("#{project_directory}/**/*").each do |file|
+  search_and_replace(file, changeme, project_name)
+end
+
+Dir.glob("#{project_directory}/**/session_store.rb").each do |file|
+  datestring = Time.now.strftime("%j %U %w %A %B %d %Y %I %M %S %p %Z")
+  search_and_replace(file, changesession, Digest::MD5.hexdigest("#{project_name} #{datestring}"))
+end
+
+run("git commit -a -m 'Initial commit'")
+
+# can't vendor nokogiri because it has native extensions
+unless installed?("nokogiri")
+  run "sudo gem install nokogiri --version='1.4.0'"
+end
+
+# need RedCloth installed for clearance generators to run.
+unless installed?("RedCloth")
+  run "sudo gem install RedCloth --version='4.2.2'"
+end
+
+run("script/generate clearance")
+run("script/generate clearance_features -f")
+run("script/generate clearance_views -f")
+
+run("git add .")
+run("git commit -m 'installed clearance'")
+
+puts
+puts "Now login to github and add a new project named '#{project_name.humanize.titleize}'"

data/features/rake_clean.feature

@@ -0,0 +1,7 @@
+Feature: Rake works in the suspended project
+
+  Scenario: Running rake in the suspended project
+    When I run the rake task "db:create:all"
+    And I run the rake task "db:migrate"
+    And I run the rake task "cucumber"
+    Then I see a successful response in the shell

data/features/step_definitions/shell.rb

@@ -0,0 +1,9 @@
+When 'I run the rake task "$task_name"' do |task_name|
+  Dir.chdir('test_project') do
+    system("rake #{task_name}")
+  end
+end
+
+Then 'I see a successful response in the shell' do
+  $?.to_i.should == 0
+end

data/features/support/env.rb

@@ -0,0 +1 @@
+require 'spec/expectations'

data/suspenders.gemspec

@@ -0,0 +1,43 @@
+Gem::Specification.new do |s|
+  s.specification_version = 2 if s.respond_to? :specification_version=
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.rubygems_version = '1.3.5'
+
+  s.name              = 'suspenders'
+  s.version           = '0.0.2'
+  s.date              = '2010-05-14'
+
+  s.summary     = "Generate a Rails app using thoughtbot's best practices."
+  s.description = <<-HERE
+Suspenders is a base Rails project that you can upgrade. It is used by
+thoughtbot to get a jump start on a working app. Use Suspenders if you're in a
+rush to build something amazing; don't use it if you like missing deadlines.
+  HERE
+
+  s.authors  = ["Mike Burns"]
+  s.email    = 'mburns@thoughtbot.com'
+  s.homepage = 'http://github.com/thoughtbot/suspenders-gem'
+
+  s.executables = ["suspenders"]
+  s.default_executable = 'suspenders'
+
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.extra_rdoc_files = %w[README.md LICENSE]
+
+  s.add_development_dependency('cucumber', [">= 0.6.2"])
+
+  # = MANIFEST =
+  s.files = %w[
+    LICENSE
+    README.md
+    Rakefile
+    bin/suspenders
+    features/rake_clean.feature
+    features/step_definitions/shell.rb
+    features/support/env.rb
+    suspenders.gemspec
+  ]
+  # = MANIFEST =
+
+  s.test_files = s.files.select {|path| path =~ /^features/ }
+end

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification 
+name: suspenders
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 2
+  version: 0.0.2
+platform: ruby
+authors: 
+- Mike Burns
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-05-14 00:00:00 -04:00
+default_executable: suspenders
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: cucumber
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 6
+        - 2
+        version: 0.6.2
+  type: :development
+  version_requirements: *id001
+description: |
+  Suspenders is a base Rails project that you can upgrade. It is used by
+  thoughtbot to get a jump start on a working app. Use Suspenders if you're in a
+  rush to build something amazing; don't use it if you like missing deadlines.
+
+email: mburns@thoughtbot.com
+executables: 
+- suspenders
+extensions: []
+
+extra_rdoc_files: 
+- README.md
+- LICENSE
+files: 
+- LICENSE
+- README.md
+- Rakefile
+- bin/suspenders
+- features/rake_clean.feature
+- features/step_definitions/shell.rb
+- features/support/env.rb
+- suspenders.gemspec
+has_rdoc: true
+homepage: http://github.com/thoughtbot/suspenders-gem
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 2
+summary: Generate a Rails app using thoughtbot's best practices.
+test_files: 
+- features/rake_clean.feature
+- features/step_definitions/shell.rb
+- features/support/env.rb