milkshake 0.0.1

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,5 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Simon Menke
+
+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.rdoc

@@ -0,0 +1,60 @@
+= Milkshake
+
+Milkshake allows you to compose rails apps from several other rails apps specially packed as gems.
+
+== Creating a host application
+
+To create a new host application you must use the <tt>create.host</tt> command.
+
+  $ milkshake create.host my_host_applications
+  Rails app successfully created!
+  Rails app successfully cleaned!
+  Milkshake successfully installed!
+  Rails app successfully stripped!
+  $ ls my_host_applications
+  config db log public script tmp
+
+The most important part of the host application is the <tt>config/milkshake.yml</tt> file.
+
+  gems:
+    my-gem:
+      version: 0.2.38
+      lib:     my_gem
+      source:  http://www.github.com
+
+After changing the <tt>milkshake.yml</tt> or updating some gems you must touch <tt>tmp/relink.txt</tt> and restart your app server (touch <tt>tmp/restart.txt</tt> for passenger).
+
+== Creating a gem application
+
+Gem applications can be packaged as gems and can be linked back into host applications.
+
+  $ milkshake create.gem my_gem_applications
+  #   anwser the questions milkshake asks you
+
+== Installation
+
+  #   you need gemcutter first
+  $ sudo gem install gemcutter
+  $ sudo gem tumble
+  #   then just install milkshake
+  $ sudo gem install milkshake
+
+== Wish list
+
+* link rake tasks from [gem path]/lib/tasks (is this needed?)
+* migrate down when removing (or downgrading) a gem.
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but
+  bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2009 Simon Menke. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,56 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "milkshake"
+    gem.summary = %Q{Make composite rails applications}
+    gem.description = %Q{Compose rails applications using several smaller rails applications}
+    gem.email = "simon@mrhenry.be"
+    gem.homepage = "http://github.com/simonmenke/milkshake"
+    gem.authors = ["Simon Menke"]
+    gem.add_development_dependency "thoughtbot-shoulda"
+    gem.add_development_dependency "yard"
+    gem.add_runtime_dependency 'thor'
+    gem.add_runtime_dependency 'snapshots'
+    gem.files += FileList['lib/**/*.rb'] + FileList['templates/**/*']
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/*_test.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+begin
+  require 'yard'
+  YARD::Rake::YardocTask.new
+rescue LoadError
+  task :yardoc do
+    abort "YARD is not available. In order to run yardoc, you must: sudo gem install yard"
+  end
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/bin/milkshake

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+begin
+  require 'milkshake'
+rescue LoadError
+  $:.unshift File.join(File.dirname(__FILE__), *%w[ .. lib ])
+  retry
+end
+
+Milkshake::App.start

data/lib/milkshake/app/actions.rb

@@ -0,0 +1,223 @@
+
+module Milkshake
+  class App
+    module Actions
+    private
+      
+      def install_rails!(path)
+        override_app_path! path
+        assert_new_app_path!
+        
+        system(%{rails "#{self.options.app}" > /dev/null})
+        good_say('Rails app successfully created!')
+        
+        goto_rails do
+          if File.file?('config/locales/en.yml')
+            File.unlink('config/locales/en.yml')
+          end
+          if File.file?('public/index.html')
+            File.unlink('public/index.html')
+          end
+          if File.file?('public/images/rails.png')
+            File.unlink('public/images/rails.png')
+          end
+          if File.file?('public/javascripts/controls.js')
+            File.unlink('public/javascripts/controls.js')
+          end
+          if File.file?('public/javascripts/dragdrop.js')
+            File.unlink('public/javascripts/dragdrop.js')
+          end
+          if File.file?('public/javascripts/effects.js')
+            File.unlink('public/javascripts/effects.js')
+          end
+          if File.file?('public/javascripts/prototype.js')
+            File.unlink('public/javascripts/prototype.js')
+          end
+          
+          Milkshake::Template.evaluate('routes.rb'
+          ).write_to('config/routes.rb')
+        end
+        
+        good_say('Rails app successfully cleaned!')
+      end
+      
+      def install_app!
+        goto_rails do
+          
+          Milkshake::Template.evaluate('preinitializer.rb'
+          ).write_to('config/preinitializer.rb')
+          
+          unless File.file?('config/milkshake.yml')
+            Milkshake::Template.evaluate('milkshake.yml'
+            ).write_to('config/milkshake.yml')
+          end
+          
+        end
+        
+        good_say('Milkshake successfully installed!')
+      end
+      
+      def install_gem!(name)
+        assert_valid_gem_name! name
+        
+        goto_rails do
+          
+          Milkshake::Template.evaluate('jeweler.rake',
+            :name        => name,
+            :author      => ask_unless_given(
+              'Author',      self.options.author,      self.class.default_author),
+            :email       => ask_unless_given(
+              'Email',       self.options.email,       self.class.default_email),
+            :summary     => ask_unless_given(
+              'Summary',     self.options.summary,     'FIX_ME_SUMMARY'),
+            :description => ask_unless_given(
+              'Description', self.options.description, 'FIX_ME_DESCRIPTION'),
+            :website     => ask_unless_given(
+              'Website',     self.options.website,     'FIX_ME_WEBSITE')
+          ).write_to('lib/tasks/jeweler.rake')
+          
+          FileUtils.mkdir_p('rails/initializers')
+          FileUtils.touch('rails/init.rb')
+          FileUtils.rm_rf('app/controllers/application_controller.rb') rescue nil
+          FileUtils.rm_rf('app/helpers/application_helper.rb')         rescue nil
+          
+          if self.options.git or shell.yes?('Initialize git? [yN]:')
+            system(%{ git init > /dev/null })
+            
+            Milkshake::Template.evaluate('gitignore'
+            ).write_to('.gitignore')
+            
+            system(%{ git add . > /dev/null })
+            system(%{ git commit -m "First import" > /dev/null })
+          end
+        end
+        
+        good_say('Jeweler successfully installed!')
+      end
+      
+      def install_host!
+        goto_rails do |rails_root|
+          (rails_root + 'README').unlink             rescue nil
+          (rails_root + 'Rakefile').unlink           rescue nil
+          (rails_root + 'app').rmtree                rescue nil
+          (rails_root + 'config/locales').rmtree     rescue nil
+          (rails_root + 'db/seeds.rb').unlink        rescue nil
+          (rails_root + 'doc').rmtree                rescue nil
+          (rails_root + 'lib').rmtree                rescue nil
+          (rails_root + 'public/images').rmtree      rescue nil
+          (rails_root + 'public/javascripts').rmtree rescue nil
+          (rails_root + 'public/stylesheets').rmtree rescue nil
+          (rails_root + 'test').rmtree               rescue nil
+          (rails_root + 'vendor').rmtree             rescue nil
+        end
+        
+        good_say('Rails app successfully stripped!')
+      end
+      
+      def ensure_extrernalized_data!(shared_path)
+        shared_path = pathname_for(shared_path)
+        if shared_path.exist?
+          link_externalized_data! shared_path
+        else
+          externalize_data! shared_path
+        end
+      end
+      
+      def externalize_data!(shared_path)
+        shared_path = pathname_for(shared_path)
+        
+        goto_rails do |rails_path|
+          
+          if (rails_path + 'config/settings').symlink?
+            bad_say("The data of this rails app seems to be already extracted!")
+          end
+          
+          assert_new_shared_path! shared_path
+          shared_path.mkpath
+          
+          (rails_path + 'public/system').mkpath
+          (rails_path + 'config/settings').mkpath
+          
+          swap_and_make_symlink!(
+            rails_path  + 'db',
+            shared_path + 'private')
+          
+          swap_and_make_symlink!(
+            rails_path  + 'log',
+            shared_path + 'log')
+          
+          swap_and_make_symlink!(
+            rails_path  + 'public/system',
+            shared_path + 'public')
+          
+          swap_and_make_symlink!(
+            rails_path  + 'config/settings',
+            shared_path + 'settings')
+          
+          swap_and_make_symlink!(
+            rails_path  + 'config/milkshake.yml',
+            shared_path + 'settings/milkshake.yml')
+          
+          swap_and_make_symlink!(
+            rails_path  + 'config/database.yml',
+            shared_path + 'settings/database.yml')
+          
+        end
+        
+        if self.options.git or shell.yes?('Initialize git? [yN]:')
+          Dir.chdir(shared_path.to_s) do
+            system(%{ git init > /dev/null })
+            
+            Milkshake::Template.evaluate('gitignore_for_data'
+            ).write_to('.gitignore')
+            
+            system(%{ git add . > /dev/null })
+            system(%{ git commit -m "First snapshot" > /dev/null })
+          end
+        end
+        
+        good_say('Data files successfully externalized!')
+      end
+      
+      def link_externalized_data!(shared_path)
+        shared_path = pathname_for(shared_path)
+        assert_shared_path! shared_path
+        
+        goto_rails do |rails_path|
+          
+          (rails_path   + 'db').rmtree
+          make_symlink!(
+            rails_path  + 'db',
+            shared_path + 'private')
+          
+          (rails_path   + 'log').rmtree
+          make_symlink!(
+            rails_path  + 'log',
+            shared_path + 'log')
+          
+          (rails_path   + 'public/system').rmtree
+          make_symlink!(
+            rails_path  + 'public/system',
+            shared_path + 'public')
+          
+          (rails_path   + 'config/settings').rmtree
+          make_symlink!(
+            rails_path  + 'config/settings',
+            shared_path + 'settings')
+          
+          (rails_path   + 'config/milkshake.yml').unlink
+          make_symlink!(
+            rails_path  + 'config/milkshake.yml',
+            shared_path + 'settings/milkshake.yml')
+          
+          (rails_path   + 'config/database.yml').unlink
+          make_symlink!(
+            rails_path  + 'config/database.yml',
+            shared_path + 'settings/database.yml')
+          
+        end
+      end
+      
+    end
+  end
+end

data/lib/milkshake/app/defaults.rb

@@ -0,0 +1,48 @@
+
+module Milkshake
+  class App
+    module Defaults
+      
+      def default_author
+        @default_author ||= begin
+          name = %x[git config --get user.name].chomp
+          name = 'FIX_ME_AUTHOR' if name.nil? or name.empty?
+          name
+        end
+      end
+      
+      def default_email
+        @default_email ||= begin
+          email = %x[git config --get user.email].chomp
+          email = 'FIX_ME_EMAIL' if email.nil? or email.empty?
+          email
+        end
+      end
+      
+      def default_environment
+        @default_environment ||= begin
+          ENV['RAILS_ENV'] || 'development'
+        end
+      end
+      
+      def default_summary
+        'FIX_ME_SUMMARY'
+      end
+      
+      def default_description
+        'FIX_ME_DESCRIPTION'
+      end
+      
+      def default_website
+        'FIX_ME_WEBSITE'
+      end
+      
+      def rename_task(names={})
+        names.each do |old_name, new_name|
+          self.tasks[new_name.to_s] = self.tasks.delete(old_name.to_s)
+        end
+      end
+      
+    end
+  end
+end

data/lib/milkshake/app/helpers.rb

@@ -0,0 +1,113 @@
+
+module Milkshake
+  class App
+    module Helpers
+    private
+      
+      def load_environment!
+        Object.const_set('RAILS_ROOT', rails_root)  rescue nil
+        ENV['RAILS_ENV'] = environment
+        $rails_rake_task = true
+        require(File.join(RAILS_ROOT, 'config', 'environment'))
+      end
+      
+      def rails_root
+        return @rails_root if @rails_root
+        
+        root_path = self.options.app
+        root_path = File.expand_path(root_path)
+        
+        unless File.directory?(root_path) and File.file?(File.join(root_path, 'config', 'environment.rb'))
+          bad_say("This is not a rails application!\n#{root_path}")
+        end
+        
+        @rails_root = root_path
+      end
+      
+      def goto_rails(path=nil)
+        Dir.chdir(path || rails_root) do
+          yield(Pathname.pwd)
+        end
+      end
+      
+      def environment
+        self.options.environment
+      end
+      
+      def good_say(msg)
+        shell.say(msg, Thor::Shell::Color::GREEN)
+      end
+      
+      def bad_say(msg, exit=true)
+        shell.say(msg, Thor::Shell::Color::RED)
+        exit(1) if exit
+      end
+      
+      def ask_with_default(statement, default=nil, color=nil)
+        if default
+          answer = shell.ask(statement+" [#{default}]:", color)
+          answer = default if answer.nil? or answer.strip.empty?
+          answer.strip
+        else
+          shell.ask(statement, color)
+        end
+      end
+      
+      def ask_unless_given(statement, value=nil, default=nil, color=nil)
+        if !value.nil? and value != default
+          value
+        else
+          ask_with_default(statement, default, color)
+        end
+      end
+      
+      def assert_valid_gem_name!(name)
+        unless name =~ /^[a-zA-Z0-9_-]+$/
+          bad_say "please specify a valid gem name (/^[a-zA-Z0-9_-]+$/)"
+        end
+      end
+      
+      def assert_new_app_path!
+        if File.exist?(self.options.app)
+          bad_say("This path already exists!\n#{self.options.app}")
+        end
+      end
+      
+      def assert_new_shared_path!(path)
+        if path.exist?
+          bad_say("This path already exists!\n#{path}")
+        end
+      end
+      
+      def assert_shared_path!(path)
+        unless path.exist?
+          bad_say("This path already exists!\n#{path}")
+        end
+      end
+      
+      def pathname_for(path, expand=true)
+        path = Pathname.new(path) unless Pathname === path
+        path = path.expand_path
+        path
+      end
+      
+      def override_app_path!(path)
+        path = File.expand_path(path)
+        @options = @options.dup
+        @options['app'] = path
+      end
+      
+      def make_symlink!(old_path, new_path)
+        Dir.chdir(old_path.dirname.to_s) do
+          old_path.basename.make_symlink(new_path.relative_path_from(old_path.dirname))
+        end
+      end
+      
+      def swap_and_make_symlink!(old_path, new_path)
+        old_path.rename(new_path)
+        make_symlink! old_path, new_path
+      end
+      
+    end
+  end
+end