rails-app-installer 0.1.3 → 0.1.4

data/examples/installer

@@ -6,7 +6,7 @@ require 'rails-installer'
 class AppInstaller < RailsInstaller
   application_name 'my_shiny_metal_app'
   support_location 'our shiny website'
-  rails_version '1.1.4'
+  rails_version '1.1.6'
 end
 
 # Installer program

data/examples/typo

@@ -5,7 +5,7 @@ require 'rails-installer'
 class TypoInstaller < RailsInstaller
   application_name 'typo'
   support_location 'the Typo mailing list'
-  rails_version '1.1.5'
+  rails_version '1.1.6'
   
   def install_post_hook
     sweep_cache

data/lib/rails-installer.rb

@@ -9,17 +9,30 @@ require 'rails-installer/web-servers'
 require 'rails-installer/commands'
 
 #
+# = Rails Application Installer
 # An installer for Rails applications.
 #
 # The Rails Application Installer is designed to make it easy for end-users to
 # install open-source Rails apps with a minimum amount of effort.  When built 
 # properly, all the user needs to do is run:
 #
-#    $ gem install my_app
+#    $ sudo gem install my_app
 #    $ my_app install /some/path
 #
-# To use this installer, you'll need to create a small driver program (the
-# 'my_app' program from above).  Here's a minimal example:
+# Users who need to install your .gem but don't have the right permissions can
+# do this instead:
+#
+#    $ export GEM_PATH=~/gems
+#    $ gem install -i ~gems my_app
+#    $ ~gems/bin/my_app install /some/path
+#
+# == Adding the installer to your application
+#
+# (This example assumes that your program is called 'my_app'.  Change this to
+# match your application's actual name)
+# 
+# First, create a small driver program and put it into bin/my_app. 
+# Here's a minimal example:
 #
 #    #!/usr/bin/env ruby
 #
@@ -27,9 +40,9 @@ require 'rails-installer/commands'
 #    require 'rails-installer'
 #
 #    class AppInstaller < RailsInstaller
-#      application_name 'my_shiny_metal_app'
+#      application_name 'my_app'
 #      support_location 'our shiny website'
-#      rails_version '1.1.4'
+#      rails_version '1.1.6'
 #    end
 #
 #    # Installer program
@@ -41,9 +54,84 @@ require 'rails-installer/commands'
 #    end
 #    app.execute_command(*ARGV)
 #
-# Place this in your application's gem/ directory, and then add it to your
-# .gem using the 'executables' gemspec option. See the examples/ directory for
-# more complex examples.
+# This is a simple example; you can extend the installer to add new commands and
+# install steps.  See the examples/ directory for more complex examples.
+#
+# Second, you'll need some schema files in db/schema.*.sql.  The schema_generator
+# plugin can generate these automatically from your migrations:
+#
+#    $ sudo gem install schema_generator
+#    $ ./script/generate schemas
+#    $ svn add db/schema.*.sql
+#    $ svn add db/schema_version
+#
+# Third, build a .gem file.  Make sure that it depends on the rails-app-installer
+# GEM.  Make sure that the generated schema files and the installer that you put in
+# bin/ are included in your .gem, and the gem knows that bin/my_app is supposed to
+# be executable.  Here's an example from Typo's .gemspec.  This may be more complex
+# then you need.
+#
+#    $:.unshift '../lib'
+#    require 'rubygems'
+#    require 'rake'
+#
+#    spec = Gem::Specification.new do |s|
+#      s.name = "typo"
+#      s.version = "4.0.2"
+#      s.summary = "Modern weblog engine."
+#      s.has_rdoc = false
+#  
+#      s.files = Dir.glob('**/*', File::FNM_DOTMATCH).reject do |f| 
+#         [ /\.$/, /config\/database.yml$/, /config\/database.yml-/, 
+#         /database\.sqlite/,
+#         /\.log$/, /^pkg/, /\.svn/, /^vendor\/rails/, 
+#         /^public\/(files|xml|articles|pages|index.html)/, 
+#         /^public\/(stylesheets|javascripts|images)\/theme/, /\~$/, 
+#         /\/\._/, /\/#/ ].any? {|regex| f =~ regex }
+#      end
+#      s.require_path = '.'
+#      s.author = "Tobias Luetke"
+#      s.email = "tobi@leetsoft.com"
+#      s.homepage = "http://www.typosphere.org"  
+#      s.rubyforge_project = "typo"
+#      s.platform = Gem::Platform::RUBY 
+#      s.executables = ['typo']
+#  
+#      s.add_dependency("rails", "= 1.1.6")
+#      s.add_dependency("rails-app-installer", ">= 0.1.2")
+#    end
+#
+#    if $0==__FILE__
+#      Gem::manage_gems
+#      Gem::Builder.new(spec).build
+#    end
+#
+# == Using your .gem
+#
+# You can test your new gem by running 'sudo gem install ./my_app-1.0.0.gem'.  Once you're
+# happy with it, upload it to Rubyforge and it'll automatically be added to the master
+# gem index.
+#
+# Users should be able to download and install it using the commands at the top of this
+# document.
+#
+# === Non-standard install options
+#
+# By default, the installer uses SQLite3 and Mongrel when installing your app.
+# The user can override this at install time with some flags.  Examples:
+# 
+#    # install using SQLite3 and Mongrel
+#    $ my_app install /some/path
+#
+#    # install using MySQL and Mongrel
+#    $ my_app install /some/path database=mysql db_user=my_app db_name=my_app db_host=localhost db_password=password
+#
+#    # install using PostgreSQL and Mongrel
+#    $ my_app install /some/path database=postgresql db_user=my_app db_name=my_app db_host=localhost db_password=password
+#
+#    # install using SQLite3 and mongrel_cluster
+#    $ my_app install /some/path web-server=mongrel_cluster threads=4
+#
 class RailsInstaller
   include FileUtils
   attr_accessor :install_directory, :source_directory, :config

data/lib/rails-installer/databases.rb

@@ -243,7 +243,7 @@ class RailsInstaller
           <<: *login
 
         test:
-          database: #{db_name installer}-test
+          database: #{db_name installer}_test
           <<: *login
         }
       end
@@ -251,8 +251,10 @@ class RailsInstaller
       # Create a MySQL database.
       def self.create_database(installer)
         installer.message "Creating MySQL database"
-        system("mysql -u #{db_user installer} -p#{installer.config['db_password']} -e 'create database #{db_name installer}'")
-        system("mysql -u #{db_user installer} -p#{installer.config['db_password']} -e 'create database #{db_name installer}-test'")
+        base_command = "mysql -u #{db_user installer} "
+        base_command << "-p#{installer.config['db_password']}" if installer.config['db_password']
+        system("#{base_command} -e 'create database #{db_name installer}'")
+        system("#{base_command} -e 'create database #{db_name installer}_test'")
       end
     end
   end

metadata

@@ -3,7 +3,7 @@ rubygems_version: 0.8.10
 specification_version: 1
 name: rails-app-installer
 version: !ruby/object:Gem::Version 
-  version: 0.1.3
+  version: 0.1.4
 date: 2006-08-10
 summary: An installer for Rails apps
 require_paths: