install_generator 0.0.1

data/install_generator.gemspec

@@ -0,0 +1,18 @@
+require 'rubygems'
+SPEC = Gem::Specification.new do |spec|
+	spec.name="install_generator"
+	spec.version="0.0.1"
+	spec.author="Eugen Minciu"
+	spec.email="minciue@gmail.com"
+	spec.homepage="http://www.tufat.com/oslink.php"
+	spec.platform=Gem::Platform::RUBY
+	spec.summary="Generates a web-based installer for Ruby on Rails applications"
+	spec.files = Dir.glob("./**/*")
+	spec.files.each do |f|
+		spec.files.delete(f) if ( f.include?(".svn") || f=="install_generator.gemspec" )
+	end
+	spec.require_path="."
+	spec.test_files= Dir.glob("templates/test/**/*rb")
+	spec.has_rdoc=true
+	spec.add_dependency "rails", ">= 1.0"
+end

data/install_generator.rb

@@ -0,0 +1,54 @@
+class InstallGenerator < Rails::Generator::NamedBase
+  def manifest
+    record do |m| 
+      
+      #Controller
+      m.template "controllers/install_controller.rb", "app/controllers/#{file_name}_controller.rb", :collision => :ask
+
+      #Models
+      m.file "models/database.rb", "app/models/database.rb", :collision => :ask 
+      m.file "models/mail_server.rb", "app/models/mail_server.rb", :collision => :ask
+      m.file "models/site_config.rb", "app/models/site_config.rb", :collision => :ask
+
+      #Helpers
+      m.template "helpers/install_helper.rb", "app/helpers/#{file_name}_helper.rb", :collision => :ask
+
+      #Tests
+      m.file "test/unit/database_test.rb", "test/unit/database_test.rb", :collision => :ask
+      m.file "test/unit/mail_server_test.rb", "test/unit/mail_server_test.rb", :collision => :ask
+      m.file "test/unit/site_config_test.rb", "test/unit/site_config_test.rb", :collision => :ask
+      
+      #Views
+      m.directory "app/views/#{file_name}"
+      m.file "views/install/confirm_options.rhtml", "app/views/#{file_name}/confirm_options.rhtml", :collision => :ask
+      m.file "views/install/config_mail.rhtml", "app/views/#{file_name}/config_mail.rhtml", :collision => :ask
+      m.file "views/install/select_db.rhtml", "app/views/#{file_name}/select_db.rhtml", :collision => :ask
+      m.file "views/install/show_authentication_options.rhtml", "app/views/#{file_name}/show_authentication_options.rhtml", :collision => :ask
+      m.file "views/install/show_db_options.rhtml", "app/views/#{file_name}/show_db_options.rhtml", :collision => :ask
+      m.file "views/install/welcome.rhtml", "app/views/#{file_name}/welcome.rhtml", :collision => :ask
+      m.file "views/install/select_language.rhtml", "app/views/#{file_name}/select_language.rhtml", :collision => :ask
+      m.file "views/install/read_site_settings.rhtml", "app/views/#{file_name}/read_site_settings.rhtml", :collision => :ask
+      m.file "views/install/save_options.rhtml", "app/views/#{file_name}/save_options.rhtml", :collision => :ask
+
+      # Partials
+      m.file "views/install/_db_form.rhtml", "app/views/#{file_name}/_db_form.rhtml", :collision => :ask
+      m.file "views/install/_mail_form.rhtml", "app/views/#{file_name}/_mail_form.rhtml", :collision => :ask
+      m.file "views/install/_site_settings_form.rhtml", "app/views/#{file_name}/_site_settings_form.rhtml", :collision => :ask
+
+      #Layouts
+      m.file "views/layouts/install.rhtml", "app/views/layouts/#{file_name}.rhtml", :collision => :ask
+
+      #Languages
+      m.directory "lang"
+      m.file "lang/en.yml", "lang/en.yml", :collision => :ask
+      m.file "lang/ro.yml", "lang/ro.yml", :collision => :ask
+
+      #Extra files
+      m.file "LICENSE", "doc/LICENSE_FOR_INSTALL_GENERATOR", :collision => :ask
+      m.file "INSTALL", "doc/INSTALL_FOR_INSTALL_GENERATOR", :collision => :ask
+      m.file "README", "doc/README_FOR_INSTALL_GENERATOR", :collision => :ask
+      
+    end
+  end
+end
+

data/templates/INSTALL

@@ -0,0 +1,22 @@
+To set up the install generator for your rails application you must do the following:
+
+1) Install the GLoc plugin for your Ruby on Rails application
+  $ ruby script/plugin source svn://rubyforge.org//var/svn/gloc
+  $ ruby script/plugin install gloc
+ 
+2) Add the following lines to your config/environment.rb (for GLoc)
+GLoc.set_config :default_language => :en
+GLoc.clear_strings_except :en, :ro
+GLoc.set_kcode
+GLoc.load_localized_strings
+
+3) Install the Settings plugin for your Ruby on Rails application
+Don't bother to generate the settings migration or migrate the database
+That will be done by the installer at the end automatically
+
+  $ ruby script/plugin source http://beautifulpixel.textdriven.com/svn/plugins/settings
+  $ ruby script/plugin install settings
+
+4) Install the installer generator and add it to your application
+  # gem install --remote install_generator
+  $ ruby script/generate install

data/templates/LICENSE

@@ -0,0 +1,10 @@
+Copyright (c) 2006, Eugen Minciu
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+ * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+ * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+ * Neither the name of Eugen Minciu nor the names of his contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/templates/README

@@ -0,0 +1,12 @@
+This is a generator for a web-based online installer for Ruby On Rails applications, similar to what many PHP applications out there have today.
+
+The code it generates is somewhat similar to what you'd get from a scaffold generator. You'll probably be changing it a lot but it should still provide you with what you need to get started, and all the functionality should be present.
+
+It's distributed under the BSD License, please see the LICENSE file for additional information.
+
+Features:
+The forms it creates rely on the use of AJAX to only display fields that are relevant to your options.
+Allows you to set up your database, your mail server and your site's main settings through an easy to use interface 
+Is fully internationalized, allowing you to select the language in which you wish to install the application.
+
+Please direct any spam or useful mail to minciue@gmail.com ;)

data/templates/controllers/install_controller.rb

@@ -0,0 +1,143 @@
+class <%= class_name %>Controller < ApplicationController
+  model :database, :mail_server, :site_config
+  before_filter :redirect_to_license, :except => [ :index, :welcome, :agree_to_license, :select_language]
+  before_filter :set_installer_lang
+
+  # Set up a hash of languages to insert in the initial form
+  def select_language
+    @forward_action=:welcome 
+    @langs=Hash.new
+    GLoc.valid_languages.each do |current_lang|
+      @langs[ll(current_lang,:language_name)] = current_lang
+    end
+  end
+
+  # Welcome dialog. Present LICENSE from doc/LICENSE file (adding <br /> s)
+  def welcome 
+    @back_action = :select_language
+    @forward_action = :agree_to_license
+    # the filter has already set the language to English (default)
+    # so let's change that
+    begin
+      f=File.new("doc/LICENSE")
+      @license=f.read()
+    rescue
+      @license=l(:no_license)
+    end
+  end
+
+  # When the user agrees to the license he is taken to this page, where
+  # the fact that he accepted the license is recorded in his session hash
+  def agree_to_license
+    session[:license_agreed]=true
+    redirect_to :action => 'select_db'
+  end
+
+  # Main database selection dialog 
+  def select_db
+    @back_action = :welcome
+    @forward_action = :config_mail
+  end
+
+  # Create a new database object for the appropriate database type
+  # Fill out an AJAX-delivered form with the appropriate data from the said object.
+  def show_db_options
+    @db=Database.new
+    @db.set_default(params[:db_adapter])
+    render :layout => false
+  end
+
+  # Configure the ActionMailer settings
+  def config_mail 
+    @back_action = :select_db
+    @forward_action = :read_site_settings
+    @db=load_db
+    redirect_to_form(:select_db) unless @db.valid?
+  end
+
+  # Show authentication options for the mail setup
+  def show_authentication_options
+    @auth=params[:mail_authentication]
+    render :layout => false
+  end
+
+  # Read the main settings for the site
+  def read_site_settings
+    @back_action = :config_mail
+    @forward_action = :confirm_options
+    @mail = load_mailserver
+    redirect_to_form(:config_mail) unless @mail.valid?
+  end
+
+  # Save database options directly to 'config/database.yml' through YAML.dump
+  # 
+  # The user is returned to the configuration page with an error message
+  # if there is an error in opening the file or saving it
+  def confirm_options
+    @back_action = :read_site_settings
+    @forward_action = :save_options
+    @db = load_db
+    @mail = load_mailserver
+
+    @site = load_site_settings
+    redirect_to_form(:read_site_settings) unless @site.valid?
+  end
+
+  # Save the configuration options
+  # Databases migrations are automatically performed
+  def save_options
+    @db.save
+    @mail.save
+    @site.save
+    Settings.installed=true
+  end
+
+  # Index (points to welcome)
+  def index
+    select_language
+    render :action => :select_language
+  end
+
+  private
+
+  # Load a mailserver object from the session data
+  def load_mailserver
+    session[:mail] = params[:mail] if params[:mail]
+    MailServer.new(session[:mail])
+  end
+
+  def load_site_settings
+    session[:site]=params[:site] if params[:site]
+    SiteConfig.new(session[:site])
+  end
+
+  # Load a database object from the session data
+  def load_db
+    session[:database]=params[:database] if @params[:database]
+    Database.new(session[:database])
+  end
+
+  # Redirect back to a form unless all the required parts of the form were completed
+  def redirect_to_form(form)
+    flash[:notice]=l(:not_all_fields_completed)
+    redirect_to :action => form
+  end
+
+  # Redirect to the license page unless the license was agreed to
+  def redirect_to_license
+    begin 
+      flash[:notice]=l(:must_agree_to_license)
+      redirect_to :action => 'index' 
+    end unless session[:license_agreed]==true
+  end
+
+  def set_installer_lang
+    if params[:language] then
+      if params[:language][:name] then
+        session[:language]=params[:language][:name] 
+      end
+    end
+    set_language session[:language]
+  end
+
+end

data/templates/helpers/install_helper.rb

@@ -0,0 +1,28 @@
+module <%= class_name %>Helper
+  def cute_db_name(string)
+    case string
+    when "mysql"
+      return "MySQL"
+    when "postgresql"
+      return "PostgreSQL"
+    when "oci"
+      return "Oracle"
+    when "sqlite"
+      return "SQLite"
+    when "sqlserver"
+      return "Microsoft SQL Server"
+    end
+  end
+
+  def add_br(str)
+    str.gsub("\n","<br />\n")
+  end
+
+  def back_link
+    link_to l(:back), :action => @back_action
+  end
+
+  def forward_link
+    link_to l(:forward), :action => @forward_action
+  end
+end

data/templates/lang/en.yml

@@ -0,0 +1,42 @@
+language_name: English
+no_license: No license specified. Please add your license in doc/LICENSE
+not_all_fields_completed: Not all required fields were completed.
+must_agree_to_license: You must agree to the license first.
+not_specified: is not specified
+not_valid_number: is not a valid number
+installer_default_title: Installation
+forward: Forward
+here_is_an_overview: Here is an overview of the configuration you have selected for your site.
+if_not_satisfied: If you are not satisfied with your settings you may return and change them.
+db_configuration: Database Configuration
+type: Type
+name: Name
+address: Address
+username: Username
+password: Password
+port: Port
+file: File
+mail_configuration: Mail Server Configuration
+domain: Domain
+back: Back
+fill_database_options: Please fill in database options
+enter_mail_configuration: Please enter your mail server configuration
+authentication: Authentication Method
+select_db_type: Select your database type
+none: None
+project_information_and_license: Insert information about your project and its license here.
+proceed_if_you_agree: You may proceed only if you agree to this license.
+i_agree: I Agree
+enter_site_information: Please complete the following information about your site
+title: Title
+admin_username: Administrator's username
+admin_name: Administrator's name
+admin_email: Administrator's email
+admin_password: Administrator's password
+description: Description
+site_information: Site information
+congratulation_settings_saved: Congratulations, your settings have been sucessfully saved!
+dont_match: Don't Match
+confirmation_password: Password (confirm) 
+admin_confirmation_password: Administrator's password (confirmation)
+title: Title

data/templates/lang/ro.yml

@@ -0,0 +1,42 @@
+language_name: Românã
+no_license: Nici o licenţã nu a fost specificatã. Vã rugãm sã adãugaţi licenţa dumneavoastrã in doc/LICENSE
+not_all_fields_completed: Nu toate câmpurile necesare au fost completate.
+must_agree_to_license: Trebuie sã acceptaţi licenţa iniţial.
+not_specified: nu este specificat(ã)
+not_valid_number: nu este un numãr valid
+installer_default_title: Instalare
+forward: Înainte
+here_is_an_overview: Iatã configuraţia pe care aţi selectat-o pentru situl dumneavoastra.
+if_not_satisfied: Dacã nu sunteţi mulţumit(ă) de opţiunile selectate, vã puteţi întoarce pentru a le modifica. 
+db_configuration: Configuraţia bazei de date
+type: Tip
+name: Nume
+address: Adresã
+username: Utilizator
+password: Parolã
+port: Port
+file: Fişier
+mail_configuration: Configuraţia serverului de mail
+domain: Domeniu
+back: Înapoi
+fill_database_options: Vã rugãm sã completaţi opţiunile referitoare la baza de date
+enter_mail_configuration: Vã rugãm sã introduceţi configuraţia serverului dumneavoastrã de mail
+authentication: Metodã de autentificare
+select_db_type: Selectaţi tipul bazei de date
+none: Nici unul(una)
+project_information_and_license: Introduceţi informaţii despre proiectul dumneavoastrã şi licenţa acestuia aici.
+proceed_if_you_agree: Puteţi continua doar dacã sunteţi de acord cu aceastã licenţã.
+i_agree: Sunt de acord
+enter_site_information: Vã rugãm sã introduceţi urmãtoarele informaţii despre situl dumneavoastra
+title: Titlu
+admin_username: Utilizatorul administratorului
+admin_name: Numele administratorului
+admin_email: Adresa de email a administratorului
+admin_password: Parola administratorului
+description: Descriere
+site_information: Informaţii despre sit
+congratulations_settings_saved: Felicitãri, opţiunile dumneavoastrã au fost salvate cu succes!
+dont_match: Nu se potrivesc
+confirmation_password: Parola (confirmare)
+admin_confirmation_password: Parola administratorului (confirmare)
+title: Titlu

data/templates/models/database.rb

@@ -0,0 +1,104 @@
+class Database < ActiveRecord::Base
+  attr_accessor :adapter, :database, :host, :username, :password, :confirmation_password, :port, :dbfile
+  # The following definitions are required for validation because this model
+  # Does not have an associated table present in the database
+  def self.columns() @columns ||= []; end
+  def self.column(name, sql_type = nil, default = nil, null = true)
+    columns << ActiveRecord::ConnectionAdapters::Column.new(name.to_s, default, sql_type.to_s, null)
+  end
+  column :adapter,  :string
+  column :database, :string
+  column :host,     :string
+  column :username, :string
+  column :password, :string
+  column :confirmation_password, :string
+  column :port,     :string # PostgreSQL can use a filename as a port argument (and often does)
+  column :dbfile,   :string
+
+  # These are the supported database adapters
+  # Based on these, the installer will generate a form that only has the appropriate boxes to edit
+  ADAPTERS = [
+    [ "MySQL",                  'mysql'],
+    [ "PostgreSQL",             'postgresql'],
+    [ "SQLite",                 'sqlite'],
+    [ "Oracle",                 'oci'],
+    [ "Microsoft SQL Server",   'sqlserver']
+  ].freeze
+
+  # Set some sensible defaults from values
+  # If for some fields, defaults aren't set and they remain nil, those fields won't appear in the form
+  def set_default(adapter)
+    @adapter=adapter
+    case @adapter
+    when "mysql"
+      @database=""
+      @host="localhost"
+      @username="root"
+      @port=3306
+      @password=""
+      @confirmation_password=""
+    when "postgresql"
+      @database=""
+      @host="localhost"
+      @username="root"
+      @port=5432
+      @password=""
+      @confirmation_password=""
+    when "oci"
+      @host=""
+      @username=""
+      @password=""
+      @confirmation_password=""
+    when "sqlserver"
+      @database=""
+      @host="localhost"
+      @username="sa"
+      @password=""
+      @confirmation_password=""
+    when "sqlite"
+      @dbfile=""
+    end
+  end
+
+  # Save the database configuration in 'config/database.yml' or some other user supplied value
+  # Properly handles the event of an unwritable file.
+  def save(file='config/database.yml')
+    @databases=Hash.new()
+    @production=Hash.new()
+
+    @production['adapter']=@adapter if @adapter
+    @production['database']=@database if @database
+    @production['username']=@username if @username
+    @production['password']=@password if @password
+    @production['host']=@host if @host
+    @production['port']=@port if @port
+    @production['dbfile']=@dbfile if @dbfile
+
+    @databases['production']=@production
+    # TODO : only have the next line execute if we're in a development environment
+    @databases['development']='production'
+
+    begin
+      File.open(file, 'w') do |out|
+        YAML.dump(@databases,out)
+      end
+    rescue
+      flash[:notice]="Unable to save the configuration.\n<br />"
+      flash[:notice]+=" Make sure you have write permissions for the file '#{file}'"
+      redirect_to :action => "select_db"
+    end
+  end
+
+  protected 
+  # Validation for the AJAX-generated form which lets you specify database details
+  # if a certain item is nil this is not seen as an error, the said item was not in the form
+  def validate
+    erorrs.add(:adapter, l(:not_specified)) if @adapter == ""
+    errors.add(:database, l(:not_specified)) if @database == ""
+    errors.add(:password, l(:dont_match)) if @password != @confirmation_password
+    errors.add(:host, l(:not_specified)) if @host == ""
+    errors.add(:username, l(:not_specified)) if @username == ""
+    errors.add(:port, l(:not_specified)) if @port == ""
+    errors.add(:dbfile, l(:not_specified)) if @dbfile == ""
+  end
+end

data/templates/models/mail_server.rb

@@ -0,0 +1,59 @@
+class MailServer < ActiveRecord::Base
+  attr_accessor :address, :port, :domain, :authentication, :username, :password, :confirmation_password
+  # The following definitions are required for validation because this model
+  # Does not have an associated table present in the database
+  def self.columns() @columns ||= []; end
+  def self.column(name, sql_type = nil, default = nil, null = true)
+    columns << ActiveRecord::ConnectionAdapters::Column.new(name.to_s, default, sql_type.to_s, null)
+  end
+
+  column :address, :string
+  column :port,   :integer
+  column :domain, :string
+  column :authentication, :string
+  column :username, :string
+  column :password, :string
+  column :confirmation_password, :string
+
+  validates_presence_of :address, :port, :domain  
+
+  # These are the authentication methods Rails supports
+  AUTHENTICATION_METHODS = [
+    [ "None",        'none' ], 
+    [ "Plain",       'plain' ],
+    [ "Login",       'login' ],
+    [ "CRAM-MD5",    'cram_md5']
+  ]
+
+  def save
+    if (@authentication != 'none') then
+      @hash = {
+        :adapter => @adapter,
+        :port => @port,
+        :domain => @domain,
+        :authentication => @authentication,
+        :username => @username,
+        :password => @password
+      }
+    else 
+      @hash = {
+        :adapter => @adapter,
+        :port => @port,
+        :domain => @domain,
+        :authentication => @authentication
+      }
+    end
+    return @hash
+  end
+
+  protected
+
+  def validate
+    errors.add(@port, l(:not_valid_number)) if (@port.to_i <0 || @port.to_i >65535)
+    if (@authentication != 'none') then
+      errors.add(:username, l(:not_specified)) if @username == "" || @username == nil 
+      errors.add(:password, l(:dont_match)) if @password != @confirmation_password
+    end
+  end
+
+end

data/templates/models/site_config.rb

@@ -0,0 +1,36 @@
+class SiteConfig < ActiveRecord::Base
+  attr_accessor :title, :admin_username, :admin_name, :admin_password, :admin_confirmation_password, :admin_email, :description
+
+  # The following definitions are required for validation because this model
+  # Does not have an associated table present in the database
+  def self.columns() @columns ||= []; end
+  def self.column(name, sql_type = nil, default = nil, null = true)
+    columns << ActiveRecord::ConnectionAdapters::Column.new(name.to_s, default, sql_type.to_s, null)
+  end
+
+  column :title, :string
+  column :admin_username, :string
+  column :admin_name, :string
+  column :admin_password, :string
+  column :admin_confirmation_password, :string
+  column :admin_email, :string
+  column :description, :text
+
+  validates_presence_of :title, :admin_username, :admin_name, :admin_password, :admin_confirmation_password, :admin_email, :description
+
+  # Save the options. This requires the settings plugin to be installed
+  def save
+    system("ruby script/generate settings_migration")
+    system("rake db:migrate")
+    Settings.title=@title
+    Settings.admin_username=@admin_username
+    Settings.admin_name=@admin_name
+    Settings.admin_password=@admin_password
+    Settings.admin_email=@admin_email
+    Settings.description=@description
+  end
+
+  def validate
+    errors.add(:admin_password, l(:dont_match)) if @admin_password != @admin_confirmation_password
+  end
+end

data/templates/test/unit/database_test.rb

@@ -0,0 +1,126 @@
+require File.dirname(__FILE__) + '/../test_helper'
+class DatabaseTest < Test::Unit::TestCase
+  def setup
+    @db=Database.new
+    @mysql_db=Database.new
+    @postgresql_db=Database.new
+    @sqlite_db=Database.new
+    @oracle_db=Database.new
+    @sqlserver_db=Database.new
+
+    @databases=[@mysql_db,@postgresql_db,@sqlite_db,@oracle_db,@sqlserver_db]
+    @databases_except_sqlite=[@mysql_db,@postgresql_db,@oracle_db,@sqlserver_db]
+
+    @mysql_db.set_default('mysql')
+    @postgresql_db.set_default('postgresql')
+    @sqlite_db.set_default('sqlite')
+    @oracle_db.set_default('oci')
+    @sqlserver_db.set_default('sqlserver')
+  end
+
+  # Tests that the values set through set_default yield an invalid product
+  #
+  # This should be the case, as the user is expected to fill in at least
+  # a database name or database file
+  def test_invalid_defaults
+    for i in @databases do
+      assert(!(i.valid?))
+    end
+  end
+
+  # Check if they pass once you fill in the required field 
+  # (or dbfile for sqlite)
+  def test_valid_with_database_field
+    @sqlite_db.dbfile='test'
+    for i in @databases do
+      i.database='test' unless i == @sqlite_db
+
+      assert (i.valid?) unless i== @oracle_db
+      # Oracle fails 
+      # All fields must be completed for Oracle, there are no defaults
+      assert(!(i.valid?)) if i==@oracle_db
+    end
+  end
+
+  # A separate test for Oracle which has no defaults for multiple fields
+  #
+  # The reason for this is that the configuration heavily depends on the
+  # version of Oracle DB server you use
+  def test_oracle_valid
+    @oracle_db.database = 'test'
+    @oracle_db.host = 'localhost'
+    @oracle_db.username = 'test'
+
+    assert @oracle_db.valid?
+  end
+
+  # Test if the database objects pass if different values are registered for
+  # their password and confirmation_password fields (except for SQLite )
+  def test_different_passwords_invalid
+    @oracle_db.host='localhost'
+    @oracle_db.username='test'
+
+    for i in @databases_except_sqlite do
+      i.database='test'
+      i.password='test1'
+      i.confirmation_password='test2'
+      assert (!(i.valid?))
+    end
+
+  end
+
+  # This tests that databases do not pass validation unless they have a 
+  # host field. This of course, doesn't apply for SQLite
+  def test_invalid_if_missing_host
+    @oracle_db.username='test'
+    for i in @databases_except_sqlite do
+      i.database='test'
+      i.host=''
+      assert(!(i.valid?))
+    end
+  end
+
+
+  #Test that databases without a username don't pass (except for SQLite)
+  def test_invalid_if_missing_username
+    @oracle_db.host='test'
+    for i in @databases_except_sqlite do
+      i.database='test'
+      i.username=''
+      assert(!(i.valid?))
+    end
+  end
+
+  # For MySQL and PostgreSQL check that databases do not work without
+  # specifying a port number
+  def test_invalid_if_missing_port
+    for i in [@mysql_db, @postgresql_db] do
+      i.database='test'
+      i.port=''
+      assert (!(i.valid?))
+    end
+  end
+
+  # Test that save works properly by loading from a saved test file and
+  # comparing the fields with the initial values.
+  #
+  # This test is only written for an example MySQL database.
+  # If anyone finds an example where this doesn't work let me know.
+  def test_save
+    @mysql_db.database='test'
+    @mysql_db.save('test_file')
+    File.open('test_file') do |yo| 
+      mysql_db_from_test_file=YAML::load(yo)
+      @test_mysql_db=mysql_db_from_test_file['production']
+    end
+    assert @mysql_db.adapter==@test_mysql_db['adapter']
+    assert @mysql_db.database==@test_mysql_db['database']
+    assert @mysql_db.username==@test_mysql_db['username']
+    assert @mysql_db.password==@test_mysql_db['password']
+    assert @mysql_db.host==@test_mysql_db['host']
+    assert @mysql_db.port==@test_mysql_db['port']
+    assert @mysql_db.dbfile==@test_mysql_db['dbfile']
+    FileUtils.rm('test_file')
+  end
+
+end

data/templates/test/unit/mail_server_test.rb

@@ -0,0 +1,73 @@
+require File.dirname(__FILE__) + '/../test_helper'
+class MailServerTest < Test::Unit::TestCase
+  def setup
+    @unauthenticated=MailServer.new
+    @plain=MailServer.new
+    @login=MailServer.new
+    @cram_md5=MailServer.new
+
+    @all_methods=[@unauthenticated,@plain,@login,@cram_md5]
+    @authenticated=[@plain,@login,@cram_md5]
+
+    for i in @all_methods
+      i.address='localhost'
+      i.port=25
+      i.domain=''
+    end
+
+    @unauthenticated.authentication='none'
+    @plain.authentication='plain'
+    @login.authentication='login'
+    @cram_md5.authentication='cram_md5'
+  end
+
+  # First we test that default options don't pass
+  # They don't pass because there's no domain field specified
+  def test_defaults
+    for i in @all_methods
+      assert (!(i.valid?))
+    end
+  end
+
+  # We then test that if we add a domain field only the
+  # setup where the mail server doesn't need any authentication passes
+  def test_defaults_with_domain_specified
+    for i in @all_methods do
+      i.domain='localdomain'
+      assert(!(i.valid?)) unless i==@unauthenticated
+    end
+    assert @unauthenticated.valid?
+  end
+
+  # Now we check that properly completed mail server options where authentication is in use do indeed pass
+  def test_authenticated_with_all_completed_fields_pass
+    for i in @authenticated do
+      i.domain='localdomain'
+      i.username='test'
+      i.password='test'
+      i.confirmation_password='test'
+      assert i.valid?
+    end
+  end
+
+  # Just what the test's name says
+  def test_different_password_fields_fail
+    for i in @authenticated do
+      i.domain='localdomain'
+      i.username='test'
+      i.password='test'
+      i.confirmation_password='test2'
+      assert (!(i.valid?))
+    end
+  end
+
+  # Test that the saved results are appropriate
+  def test_save 
+    @x=Hash.new
+    @x=@unauthenticated.save
+    assert @x[:authentication]==@unauthenticated.authentication
+    assert @x[:port]==@unauthenticated.port
+    assert @x[:domain]==@unauthenticated.domain
+    assert @x[:authentication]==@unauthenticated.authentication
+  end
+end

data/templates/test/unit/site_config_test.rb

@@ -0,0 +1,41 @@
+require File.dirname(__FILE__) + '/../test_helper'
+class SiteConfigTest < Test::Unit::TestCase
+  def setup
+    @site=SiteConfig.new
+  end
+
+  # Test that default values do not pass
+  def test_default_doesnt_pass
+    @site.title='test'
+    @site.admin_username='admin'
+    assert(!(@site.valid?))
+  end
+
+  # Test that if all fields are completed but the supplied 
+  # passwords are different, the configuration is not valid
+  def test_different_passwords_dont_pass
+    @site.title=@site.admin_username=@site.admin_name=@site.admin_email=@site.description='test'
+    @site.admin_password='test1'
+    @site.admin_confirmation_password='test2'
+    assert(!(@site.valid?))
+  end
+
+  # test that properly configured fields provide a valid result
+  def test_all_completed_fields_pass_with_identical_passwords
+    @site.title=@site.admin_username=@site.admin_name=@site.admin_email=@site.description=@site.admin_password=@site.admin_confirmation_password='test'
+    assert @site.valid?
+  end
+
+  def test_save
+    @site.title=@site.admin_username=@site.admin_name=@site.admin_email=@site.description=@site.admin_password=@site.admin_confirmation_password='test'
+    @site.save
+    assert Settings.title == @site.title
+    assert Settings.admin_username == @site.admin_username
+    assert Settings.admin_name == @site.admin_name
+    assert Settings.admin_email == @site.admin_email
+    assert Settings.description == @site.description
+    assert Settings.admin_password == @site.admin_password
+    assert Settings.admin_confirmation_password = @site.admin_confirmation_password
+  end
+
+end

data/templates/views/install/_db_form.rhtml

@@ -0,0 +1,40 @@
+<% begin -%>
+  <%= l(:fill_database_options) %>: <br />
+<% end if @db.adapter!="" -%>
+
+<% begin -%>
+  <%= l(:name) %>:
+  <%= text_field :database, :database, :value => @db.database %><br />
+<% end if @db.database -%> 
+
+<% begin -%>
+  <%= l(:address) %>:
+  <%= text_field :database, :host, :value => @db.host %><br />
+<% end if @db.host -%>
+
+<% begin -%>
+  <%= l(:username) %>:
+  <%= text_field :database, :username, :value => @db.username %><br />
+<% end if @db.username -%>
+
+<% begin -%>
+  <%= l(:password) %>:
+  <%= password_field :database, :password %><br />
+
+  <%= l(:confirmation_password) %>:
+  <%= password_field :database, :confirmation_password %><br />
+<% end if @db.password -%>
+
+<% begin -%>
+  <%= l(:port) %>:
+  <%= text_field :database, :port, :value => @db.port %><br />
+<% end if @db.port -%>
+
+<% begin -%>
+  <%= l(:file) %>:
+  <%= text_field :database, :dbfile, :value => @db.dbfile %><br />
+<% end if @db.dbfile-%>
+
+<% begin -%>
+  <%= hidden_field 'database','adapter', :value => @db.adapter %>
+<% end if @db.adapter -%>

data/templates/views/install/_mail_form.rhtml

@@ -0,0 +1,21 @@
+<%= l(:enter_mail_configuration) %><br />
+
+<%= l(:address) %>:
+<%= text_field :mail, :address, :value => 'localhost' %><br />
+
+<%= l(:port) %>:
+<%= text_field :mail, :port, :value => 25 %><br />
+
+<%= l(:domain) %>:
+<%= text_field :mail, :domain %><br />
+
+<%= l(:authentication) %>:
+<%= select('mail', 'authentication', MailServer::AUTHENTICATION_METHODS) %> <br /> 
+
+<%= observe_field('mail_authentication', 
+  :url => { :action => :show_authentication_options }, 
+  :update => 'authentication_form', :with => 'mail_authentication')
+%>
+
+<div id="authentication_form">
+</div>

data/templates/views/install/_site_settings_form.rhtml

@@ -0,0 +1,20 @@
+<%= l(:title) %>:
+<%= text_field :site, :title, :value => l(:title) %><br />
+
+<%= l(:admin_username) %>:
+<%= text_field :site, :admin_username, :value => 'admin' %><br />
+
+<%= l(:admin_name) %>:
+<%= text_field :site, :admin_name %><br />
+
+<%= l(:admin_password) %>:
+<%= password_field :site, :admin_password %><br />
+
+<%= l(:admin_confirmation_password) %>:
+<%= password_field :site, :admin_confirmation_password %><br />
+
+<%= l(:admin_email) %>:
+<%= text_field :site, :admin_email %><br />
+
+<%= l(:description) %>:<br />
+<%= text_area :site, :description %><br />

data/templates/views/install/config_mail.rhtml

@@ -0,0 +1,6 @@
+<%= start_form_tag :action => @forward_action %>
+<%= render :partial => 'mail_form' %>
+<%= submit_tag l(:forward) %>
+
+<br />
+<%= back_link %>

data/templates/views/install/confirm_options.rhtml

@@ -0,0 +1,75 @@
+<p>
+<%= l(:here_is_an_overview) %>
+</p>
+
+<p>
+<%= l(:if_not_satisfied) %> <br />
+</p>
+
+<div>
+  <p>
+  <%= l(:db_configuration) %>:<br />
+  <% begin -%>
+  <%= l(:type) %>: <%= cute_db_name(@db.adapter) %><br />
+  <% end if @db.adapter!="" -%>
+
+  <% begin -%>
+  <%= l(:name) %>: <%= @db.database %><br />
+  <% end if @db.database -%>
+
+  <% begin -%>
+  <%= l(:address) %>: <%= @db.host %> <br />
+  <% end if @db.host %>
+
+  <% begin -%>
+  <%= l(:username) %>: <%= @db.username %> <br />
+  <% end if @db.username -%>
+
+  <% begin -%>
+  <%= l(:password) %>: <%= '*' * @db.password.length %><br />
+  <% end if @db.password -%>
+
+  <% begin -%>
+  <%= l(:port) %>: <%= @db.port %> <br />
+  <% end if @db.port -%>
+
+  <% begin -%>
+  <%= l(:file) %>: <%= @db.dbfile %> <br />
+  <% end if @db.dbfile -%>
+  </p>
+</div>
+
+<hr />
+
+<div>
+  <p>
+  <%= l(:mail_configuration)%>: <br />
+  <%= l(:address) %>: <%= @mail.address %><br />
+  <%= l(:port) %>: <%= @mail.port %><br />
+  <%= l(:domain) %>: <%= @mail.domain %><br />
+  <% begin -%>
+  <%= l(:username) %>: <%= @mail.username %><br />
+  <%= l(:password) %>: <%= '*' * @mail.password.length %>
+  <% end if @mail.authentication != 'none' -%>
+  </p>
+</div>
+
+<hr />
+
+<div>
+  <p>
+  <%= l(:site_information)%>: <br />
+  <%= l(:title) %>: <%= @site.title %><br />
+  <%= l(:admin_username) %>: <%= @site.admin_username %><br />
+  <%= l(:admin_name) %>: <%= @site.admin_name %><br />
+  <%= l(:admin_password) %>: <%= '*' * @site.admin_password.length %><br />
+  <%= l(:admin_email) %>: <%= @site.admin_email %><br />
+  <%= l(:description) %>: <br />
+    <p>
+    <%= add_br(@site.description) %>
+    </p>
+  </p>
+</div>
+
+<%= back_link %>
+<%= forward_link %>

data/templates/views/install/read_site_settings.rhtml

@@ -0,0 +1,10 @@
+<%= l(:enter_site_information) %>:<br />
+
+<%= start_form_tag :action => @forward_action %>
+
+<%= render :partial => 'site_settings_form' %>
+
+<%= submit_tag l(:forward) %>
+<%= end_form_tag %>
+
+<%= back_link %>

data/templates/views/install/save_options.rhtml

@@ -0,0 +1,2 @@
+<%= l(:congratulations_settings_saved) %><br />
+

data/templates/views/install/select_db.rhtml

@@ -0,0 +1,16 @@
+<%= l(:select_db_type) %>
+
+<%=
+#TODO i18n this
+options = [ ["Select database type", ""]] + Database::ADAPTERS
+select('db','adapter',options)
+%>
+
+<%=
+observe_field('db_adapter', :url => { :action => :show_db_options }, :update => 'database_form', :with => 'db_adapter')
+%>
+
+<div id="database_form">
+</div>
+
+<%= back_link %>

data/templates/views/install/select_language.rhtml

@@ -0,0 +1,4 @@
+<%= start_form_tag :action => @forward_action %>
+<%= select('language','name',@langs) %> <br />
+<%= submit_tag ">>>" %>
+<%= end_form_tag %>

data/templates/views/install/show_authentication_options.rhtml

@@ -0,0 +1,10 @@
+<% begin -%>
+<%= l(:username) %>:
+<%= text_field :mail, :username %><br />
+
+<%= l(:password) %>:
+<%= password_field :mail, :password %><br />
+
+<%= l(:confirmation_password) %>:
+<%= password_field :mail, :password %><br />
+<% end if (@auth != 'none') -%>

data/templates/views/install/show_db_options.rhtml

@@ -0,0 +1,7 @@
+<% begin -%>  
+    <!-- @forward action doesn't work here at this point -->
+    <%= start_form_tag :action => 'config_mail' %>
+      <%= render :partial => 'db_form' %>
+      <%= submit_tag l(:forward) %>
+    <%= end_form_tag %>
+<% end if params[:db_adapter]!="" -%>

data/templates/views/install/welcome.rhtml

@@ -0,0 +1,14 @@
+<p>
+<%= l(:project_information_and_license) %> <br />
+</p>
+
+<p>
+  <%= add_br(@license) %>
+</p>
+
+<p>
+<%= l(:proceed_if_you_agree) %> <br />
+</p>
+
+<%= back_link %>
+<%= link_to l(:i_agree), :action => @forward_action %>

data/templates/views/layouts/install.rhtml

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <title><%= l(:installer_default_title) %></title>
+    <%= javascript_include_tag "prototype" %>
+  </head>
+  <body>
+    <% if (@flash[:notice]) then -%>
+    <%= flash[:notice] %><br />
+    <% end -%>
+
+    <div>
+      <%= @content_for_layout %>
+    </div>
+  </body>
+</html>
+

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.0
+specification_version: 1
+name: install_generator
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+date: 2006-07-28 00:00:00 +03:00
+summary: Generates a web-based installer for Ruby on Rails applications
+require_paths: 
+- .
+email: minciue@gmail.com
+homepage: http://www.tufat.com/oslink.php
+rubyforge_project: 
+description: 
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Eugen Minciu
+files: 
+- ./USAGE
+- ./install_generator-0.0.1.gem
+- ./install_generator.rb
+- ./install_generator.gemspec
+- ./templates
+- ./templates/lib
+- ./templates/lang
+- ./templates/test
+- ./templates/LICENSE
+- ./templates/views
+- ./templates/README
+- ./templates/migrate
+- ./templates/controllers
+- ./templates/models
+- ./templates/helpers
+- ./templates/INSTALL
+- ./templates/lang/en.yml
+- ./templates/lang/ro.yml
+- ./templates/test/unit
+- ./templates/test/functional
+- ./templates/test/fixtures
+- ./templates/test/unit/site_config_test.rb
+- ./templates/test/unit/database_test.rb
+- ./templates/test/unit/mail_server_test.rb
+- ./templates/views/layouts
+- ./templates/views/install
+- ./templates/views/layouts/install.rhtml
+- ./templates/views/install/show_db_options.rhtml
+- ./templates/views/install/select_db.rhtml
+- ./templates/views/install/show_authentication_options.rhtml
+- ./templates/views/install/config_mail.rhtml
+- ./templates/views/install/_site_settings_form.rhtml
+- ./templates/views/install/save_options.rhtml
+- ./templates/views/install/select_language.rhtml
+- ./templates/views/install/welcome.rhtml
+- ./templates/views/install/_db_form.rhtml
+- ./templates/views/install/confirm_options.rhtml
+- ./templates/views/install/read_site_settings.rhtml
+- ./templates/views/install/_mail_form.rhtml
+- ./templates/controllers/install_controller.rb
+- ./templates/models/database.rb
+- ./templates/models/site_config.rb
+- ./templates/models/mail_server.rb
+- ./templates/helpers/install_helper.rb
+test_files: 
+- templates/test/unit/site_config_test.rb
+- templates/test/unit/database_test.rb
+- templates/test/unit/mail_server_test.rb
+rdoc_options: []
+
+extra_rdoc_files: []
+
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rails
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "1.0"
+    version: