laravel 0.3.2 → 0.5.1

data/README.md

@@ -1,4 +1,4 @@
-[[#]] Laravel
+# Laravel
 
 A wrapper around Laravel framework for PHP.
 Currently, is only capable of downloading Laravel source from

data/bin/commands/config.rb

@@ -5,6 +5,7 @@ module Laravel
     # This class inherits from thor and can be used to configure
     # various options in the application/config/application.php file.
     class Config < Thor
+      class_option :debug, :type => :boolean
 
       # This class-wide option specifies the application directory to use.
       # By default, this is the path to the current directory.
@@ -16,7 +17,11 @@ module Laravel
       desc "index [NEW_INDEX]", "modify the Application Index for Laravel application"
       def index(new_index)
         @config = Laravel::Configuration.new(options[:app])
-        @config.update_index new_index
+        begin
+          @config.update_index new_index
+        rescue StandardError => e
+          Laravel::handle_error e, options[:debug]
+        end
       end
 
       # This task generates a new key for our application.
@@ -24,7 +29,11 @@ module Laravel
       desc "key", "generate a new key for Laravel application"
       def key(value=nil)
         @config = Laravel::Configuration.new(options[:app])
-        @config.update_key
+        begin
+          @config.update_key
+        rescue StandardError => e
+          Laravel::handle_error e, options[:debug]
+        end
       end
 
     end

data/bin/commands/install.rb

@@ -4,6 +4,7 @@ module Laravel
     # This class is responsible for the various installation tasks
     # e.g. installing the bundles or other goodies.
     class Install < Thor
+      class_option :debug, :type => :boolean
 
       # This option specifies the application directory to use.
       # By default, this is the path to the current directory.
@@ -25,7 +26,11 @@ module Laravel
       desc "generator", "download the Laravel Generator by Jeffrey Way"
       def generator
         @installer = Laravel::Installer.new(options[:app])
-        @installer.task_generator
+        begin
+          @installer.task_generator
+        rescue StandardError => e
+          Laravel::handle_error e, options[:debug]
+        end
       end
     end
   end

data/bin/commands/new.rb

@@ -1,5 +1,7 @@
 module Laravel
   class CLI < Thor
+    class_option :debug, :type => :boolean
+
     # This task creates a new application based on Laravel framework.  By
     # default, it simply copies a Laravel source to the path specified as the
     # argument. However, this method is heavily customizable and allows us to
@@ -38,7 +40,14 @@ module Laravel
     method_option :generator, :type => :boolean, :aliases => "-g",
       :desc => "get the Laravel generator by Jeffrey Way"
     def new(app_name)
-      Laravel::App.new(app_name, options).create
+      app = Laravel::App.new(app_name, options)
+      begin
+        app.create
+      rescue StandardError => e
+        Laravel::handle_error e, options[:debug]
+      rescue Exception => e
+        Laravel::handle_error e, options[:debug]
+      end
     end
 
   end

data/features/S_1_new_online.feature

@@ -0,0 +1,34 @@
+Feature: Create a new application based on Laravel framework for PHP when online
+  In order to develop awesome web application
+  As a PHP developer acquinted with ruby
+  I want to use Laravel gem to setup Laravel framework using online sources
+
+  Scenario: create Laravel application with default settings
+    Given no application has been created using "http://github.com/laravel/laravel" as source
+    And   I want to create a new application
+    When  I create this application
+    Then  application should be ready for development
+
+  Scenario: create Laravel application in the current directory
+    Given I want to create a new application forcefully
+    When  I create this application
+    Then  application should be ready for development
+    Given I, again, want to create a new application
+    When  I, now, create this application
+    Then  I should get an error
+
+  Scenario: create Laravel application using source from a non-official repo
+    Given no application has been created using "http://github.com/laravel/pastes" as source
+    And   I want to create a new application
+    And   I want to use "http://github.com/laravel/pastes" as source
+    When  I create an application with above requirements
+    Then  application should be ready for development
+
+  Scenario: create Laravel application using non-laravel repository
+    Given I want to create a new application
+    And   I want to use "http://github.com/github/gitignore" as source
+    When  I create an application with above requirements
+    Then  local cache should not exist
+    And   I should get an error
+    And   the stdout should contain "corrupt"
+    And   application should not be created

data/features/S_2_new_offline.feature

@@ -0,0 +1,32 @@
+Feature: Create a new application based on Laravel framework for PHP when offline
+  In order to develop awesome web application
+  As a PHP developer acquinted with ruby
+  I want to use Laravel gem to setup Laravel framework when not online
+
+  Background: we have created some applications using this gem in the past
+    Given applications have been created using "http://github.com/laravel/laravel" as source
+    And   applications have been created using "http://github.com/laravel/pastes" as source
+
+  Scenario: create Laravel application using repository from local cache
+    Given I want to create a new application
+    And   I want to use "http://github.com/laravel/laravel" as source
+    When  I create an application with above requirements
+    Then  application should be ready for development
+
+  Scenario: create Laravel application using source from a directory
+    # Given laravel framework exists in "./laravel" directory
+    # And   I want to create a new application
+    # And   I want to use "./laravel/" as source
+    #
+    # following is the encrypted path to local cache of default repo - makes test go faster
+    Given I want to create a new application
+    And   I want to use "~/.laravel/repos/d07cf9818b8fb1e073f23901b58505f6" as source
+    When  I create an application with above requirements
+    Then  application should be ready for development
+
+  Scenario: create Laravel application but do not update permissions on storage/ directory
+    Given I want to create a new application
+    And   I do not want to update file permissions for storage
+    When  I create an application with above requirements
+    Then  application should be created
+    But   file permissions on storage should not be updated

data/features/S_3_new_customized.feature

@@ -0,0 +1,14 @@
+Feature: Create a new application with maximum customizations
+  In order to develop awesome web application
+  As a PHP developer acquinted with ruby
+  I want to use Laravel gem to setup a new application with maximum customizations
+
+  Scenario: create Laravel application with maximum customizations
+    Given I want to create an application forcefully
+    And   I want to use "http://github.com/laravel/pastes" as source
+    And   I want to generate a new key
+    And   I want to use "home.php" as application index
+    When  I create an application with above requirements
+    Then  application should be ready for development
+    And   a new application key should be generated
+    And   the application index should be updated to "home.php"

data/features/S_4_config.feature

@@ -0,0 +1,17 @@
+Feature: Configure an existing Laravel application
+  In order to customize the application to my needs
+  As a PHP developer acquinted with ruby
+  I want to use Laravel gem to configure this application
+
+  Background: An application based on Laravel framework exists
+    Given I want to create a new application
+    When  I create this application
+    Then  the application should be ready for development
+
+  Scenario: generate a new key for a Laravel application
+    When  I generate a new key for this application
+    Then  a new application key should be generated
+
+  Scenario: update Application Index in a Laravel application
+    When  I udpate application index to "home.php"
+    Then  the application index should be updated to "home.php"

data/features/S_5_install.feature

@@ -0,0 +1,13 @@
+Feature: Download Laravel Generator by Jeffrey Way
+  In order to generate code for my application quickly using :generate tasks
+  As a PHP developer acquinted with ruby
+  I want to use Laravel gem to download Laravel Generator by Jeffrey Way
+
+  Background: An application based on Laravel framework exists
+    Given I want to create a new application
+    When  I create this application
+    Then  the application should be ready for development
+
+  Scenario: download Laravel generator
+    When  I install generator for this application
+    Then  a task should be installed as "generate.php"

data/features/step_definitions/config_steps.rb

@@ -0,0 +1,30 @@
+Then /^configuration: "(.*?)" should be updated to "(.*?)"$/ do |config, value|
+  value = '.*' if value == "__something__"
+  @app_tester.validate_configuration("'#{config}' => '#{value}'")
+  step "the stdout should contain \"Updated configuration: #{config}\""
+end
+
+
+
+Given /^I( do not)? want to generate a new key$/ do |negate|
+  @args = "#{@args} #{negate ? "--no-key" : "--key"}"
+end
+When /^(?:|I |we )generate a new key(?:| for this application)$/ do
+  step "I run `laravel config key --app=#{@app_path}`"
+end
+Then /^a new application key should be generated$/ do
+  step "configuration: \"key\" should be updated to \"__something__\""
+end
+
+
+
+Given /^I want to use "(.*?)" as application index$/ do |index|
+  @args = "#{@args} --index=#{index}"
+end
+When /^.*udpate application index to "(.*?)"$/ do |index|
+  step "I run `laravel config index #{index} --app=#{@app_path}`"
+end
+Then /^the application index should be updated to "(.*?)"$/ do |index|
+  step "configuration: \"index\" should be updated to \"#{index}\""
+end
+

data/features/step_definitions/install_steps.rb

@@ -0,0 +1,9 @@
+When /install generator for this application$/ do
+  step "I run `laravel install generator --app=#{@app_path}`"
+end
+
+Then /^(?:|a )tasks? should be installed as "(.*?)"$/ do |filename|
+  filepath = @app_tester.app.tasks_file(filename)
+  @app_tester.raise_error?(File.exists?(filepath))
+  step "the stdout should contain \"Installed task\""
+end

data/features/step_definitions/laravel.rb

@@ -1,116 +1,6 @@
-# suppress any output from Thor based shell while testing
-module Laravel
-  def self.say(status, message = "", log_status = true)
-  end
-end
-
-#### GIVEN ####
-
-# This test setups a given condition where the local cache may or may not exist
-# for a given source repository. It does so by removing the cache directory, and
-# then recreating it, if not negated, by downloading the repository from github.
-#
-Given /^local cache( does not)? exists? for "(.*?)" repository$/ do |negation, repo|
-  @app_tester = Laravel::AppTests.new(nil, repo)
-
-  if negation
-    FileUtils.rm_rf @app_tester.app.cache
-  elsif not @app_tester.app.has_cache?
-    # easiest method to ensure local cache exists is to clone repo from github
-    FileUtils.rm_rf @app_tester.app.cache
-    `git clone #{@app_tester.app.source} #{@app_tester.app.cache} &>/dev/null`
-  end
-end
-
-# This test setups a given condition where the Laravel application exists in a
-# given directory. It does so by removing the directory if it exists and then,
-# creating a new Laravel application there.
-#
-Given /^laravel application exists in "(.*?)" directory$/ do |dir|
-  FileUtils.rm_rf(dir) if File.directory?(dir)
-  @app_tester = Laravel::AppTests.new(dir)
-  @app_tester.app.merge_options(:force => true, :quiet => true)
-  @app_tester.app.create unless @app_tester.app.has_laravel?
-end
-
-# This test setups a given condition where the Laravel framework source has
-# been download in a given directory, which is essentially the same as testing
-# whether a Laravel application existing in a given directory.
-#
-Given /^laravel source has already been downloaded in "(.*?)" directory$/ do |dir|
-  # creating laravel in directory is virtually same as it being downloaded there
-  step "laravel application exists in \"#{dir}\" directory"
-end
-
-#### THEN ####
 
-# This test checks whether the Laravel application we created is ready to use in
-# a given directory, which is to say whether we can readily use Laravel after
-# the command 'new' has been issued. This test assumes that the source repository
-# is the official Laravel repository.
-#
-Then /^laravel application should be ready to use in "(.*?)" directory$/ do |dir|
-  step "local cache for \"official\" repository should exist"
-  step "the stdout should contain \"Hurray!\""
-  step "laravel application must exist in \"#{dir}\" directory"
-  step "permissions should be updated on \"#{dir}/storage\" directory"
-end
-
-# This test checks whether the Laravel application we created is ready to use
-# in a given directory using a given source repository, which is to say whether
-# we can readily use Laravel after the command 'new' has been issued.
-#
-Then /^laravel application should be ready to use in "(.*?)" directory using "(.*?)" repository$/ do |dir, repo|
-  step "local cache for \"#{repo}\" repository should exist"
-  step "the stdout should contain \"Hurray!\""
-  step "laravel application must exist in \"#{dir}\" directory"
-  step "permissions should be updated on \"#{dir}/storage\" directory"
-end
-
-# This test checks whether the local cache exists for a given repository. It
-# does so by calling the 'has_cache?' method on the application.
-#
-Then /^local cache for "(.*?)" repository should( not)? exist$/ do |repo, negation|
-  @app_tester = Laravel::AppTests.new(nil, repo)
-  @app_tester.raise_error?(@app_tester.app.has_cache?, negation)
-end
 
-# This test checks if a Laravel application exists (or was created) in the given
-# directory. It does so by calling the 'has_laravel?' method on the application.
-#
-Then /^laravel application must( not)? exist in "(.*?)" directory$/ do |negation, dir|
-  @app_tester = Laravel::AppTests.new(dir)
-  @app_tester.raise_error?(@app_tester.app.has_laravel?, negation)
+Then /^I should get an error$/ do
+  step "the stdout should contain \"ERROR\""
 end
 
-# This test checks if valid permissions were set on the "storage/" directory
-# This test checks if the valid permissions were set on the "storage/" directory
-# of the application.
-#
-Then /^permissions should( not)? be updated on "(.*?)" directory$/ do |negation, dir|
-  @app_tester = Laravel::AppTests.new(dir)
-  step "the stdout should contain \"Updated permissions\"" unless negation
-  world_bit = sprintf("%o", File.stat(@app_tester.app_dir).mode).to_s[-1,1].to_i
-  is_world_writable = [2,3,6,7].include?(world_bit)
-  @app_tester.raise_error?(is_world_writable, negation)
-end
-
-# This test checks if the given configuration setting has been updated to a given
-# value for the specified application.
-#
-Then /^configuration: "(.*?)" must be updated to "(.*?)" for "(.*?)" application$/ do |config, value, app_dir|
-  value = '.*' if value == "__something__"
-  @app_tester = Laravel::AppTests.new(app_dir)
-  @app_tester.validate_configuration("'#{config}' => '#{value}'")
-  step "the stdout should contain \"Updated configuration: #{config}\""
-end
-
-# This test checks if the given resource has been installed in the specified
-# application.
-#
-Then /^(.*?): "(.*?)" should be installed (?:as|in) "(.*?)" for "(.*?)" application$/ do |type, name, filename, app_dir|
-  @app_tester = Laravel::AppTests.new(app_dir)
-  filepath = @app_tester.app.tasks_file(filename) if type == "task"
-  @app_tester.raise_error?(File.exists?(filepath))
-  step "the stdout should contain \"Installed #{type}: #{name.capitalize}\""
-end

data/features/step_definitions/new_steps.rb

@@ -0,0 +1,47 @@
+Given /^laravel (?:framework|application)( does not)? exists? in "(.*?)" directory$/ do |negate, dir|
+  dir = File.expand_path(dir, Laravel::AppTests::TestDirectory)
+  FileUtils.rm_rf(dir)
+  # easiest way to do this is to download github repository at this location
+  `git clone -q http://github.com/laravel/laravel #{dir}` unless negate
+end
+
+Given /^local cache for "(.*?)" (does not )?exists?$/ do |repo, negate|
+  tester = Laravel::AppTests.new(".", repo)
+  if negate
+    FileUtils.rm_rf tester.app.cache
+  elsif not tester.app.has_cache?
+    # easiest method to ensure local cache exists is to clone repo from github
+    FileUtils.rm_rf tester.app.cache
+    `git clone #{tester.app.source} #{tester.app.cache} &>/dev/null`
+  end
+end
+
+Given /^(no )?applications? (?:has|have) been created using "(.*?)" as source$/ do |negate, repo|
+  step "local cache for \"#{repo}\" #{negate ? "does not exist" : "exists"}"
+end
+
+
+
+When /^.*create (?:an|this) application(?:| with above requirements)( in the current directory)?$/ do |current_dir|
+  dir = current_dir ? "." : "my_app"
+  @source   ||= "http://github.com/laravel/laravel"
+  @app_tester = Laravel::AppTests.new(dir, @source)
+  @app        = @app_tester.app
+  @app_path   = @app_tester.app_path
+  @cache      = @app_tester.app.cache
+
+  step "I run `laravel new #{dir} #{@args}`"
+end
+
+
+Then /^(?:|this |the )application should be ready for development$/ do
+  step "local cache should exist"
+  step "application should be created"
+end
+Then /^local cache should( not)? exist$/ do |negate|
+  @app_tester.raise_error?(@app.has_cache?, negate)
+end
+Then /^application should( not)? be created$/ do |negate|
+  step "the stdout should contain \"Hurray!\"" unless negate
+  @app_tester.raise_error?(@app.has_laravel?, negate)
+end

data/features/step_definitions/requirements.rb

@@ -0,0 +1,20 @@
+Given /.*want to create (?:an|the|a new) application( forcefully)?$/ do |force|
+  @args = force ? "--force" : ""
+end
+
+Given /^I want to use( local cache for)? "(.*?)" as source$/ do |use_cache, source|
+  @source = source
+  @args = "#{@args} --source=#{source}"
+end
+
+
+
+Given /^I( do not)? want to update file permissions for storage$/ do |negate|
+  @args = "#{@args} #{negate ? "--no-perms" : "--perms"}"
+end
+Then /^file permissions on storage should( not)? be updated$/ do |negate|
+  step "the stdout should contain \"Updated permissions\"" unless negate
+  world_bit = sprintf("%o", File.stat(@app_path).mode).to_s[-1,1].to_i
+  is_world_writable = [2,3,6,7].include?(world_bit)
+  @app_tester.raise_error?(is_world_writable, negate)
+end

data/features/support/env.rb

@@ -9,18 +9,6 @@ After do
   FileUtils.rm_rf(File.join(test_directory, "current"))
 end
 
-Before('@very_slow') do
+Before do
   @aruba_timeout_seconds = 300
 end
-
-Before('@requires_repository_download') do
-  @aruba_timeout_seconds = 300
-end
-
-Before('@may_require_repository_download') do
-  @aruba_timeout_seconds = 300
-end
-
-Before('@slow') do
-  @aruba_timeout_seconds = 60
-end

data/features/support/laravel_helpers.rb

@@ -1,7 +1,8 @@
 module Laravel
   # a means to test the gem
   class AppTests
-    attr_reader :app, :app_dir, :repo, :aruba
+    attr_reader :app, :app_path, :aruba
+    TestDirectory = File.expand_path(File.join(File.dirname(__FILE__), %w[ .. .. tmp aruba]))
 
     # create a new object that handles the tests for us
     #
@@ -10,20 +11,17 @@ module Laravel
     # +repo+ :: repository URL/directory for source
     #
     def initialize(dir = nil, repo = nil)
-      @repo    = repo
-      @aruba   = File.expand_path(File.join(File.dirname(__FILE__), %w[ .. .. tmp aruba]))
-
       # Store absolute path to the directory
-      @app_dir = dir || Dir.pwd
+      @app_path = dir || Dir.pwd
       convert_to_relative_path
 
       options = {
         :force  => false, :quiet  => false,
-        :perms  => true,  :source => get_source_url
+        :perms  => true,  :source => repo
       }
 
       # create a new Laravel App instance for given options
-      @app = Laravel::App.new(@app_dir, options)
+      @app = Laravel::App.new(@app_path, options)
     end
 
     # get the relative path of a directory relative to the temporary path aruba creates
@@ -33,22 +31,8 @@ module Laravel
     #                  By default, it is the path to the aruba tmp directory
     #
     def convert_to_relative_path(relative_to = nil)
-      relative_to = @aruba unless relative_to
-      @app_dir = File.expand_path(@app_dir, relative_to)
-    end
-
-    # get the url to a repository by a given alias/name
-    #
-    # ==== Return
-    # +string+ :: URL for the repository
-    #
-    def get_source_url
-      case @repo
-      when nil, "", "official", "default" then Laravel::App::LaravelRepo
-      when "pastes"  then "http://github.com/laravel/pastes"
-      when "non_laravel" then "http://github.com/github/gitignore"
-      else @repo
-      end
+      relative_to = TestDirectory unless relative_to
+      @app_path = File.expand_path(@app_path, relative_to)
     end
 
     # checks if the configuration file contains a particular string
@@ -71,7 +55,7 @@ module Laravel
     #                this condition raises an error if it evaluates to false.
     # +negate+ :: negate the default behaviour
     def raise_error?(condition, negate = nil)
-      raise RSpec::Expectations::ExpectationNotMetError if condition == !negate.nil?
+      raise ExpectationNotMetError if condition == !negate.nil?
     end
   end
 end

data/lib/laravel.rb

@@ -1,8 +1,11 @@
 # require dependencies
 require "thor"
+require "yaml"
 
 # require laravel files
 require "laravel/version"
+require "laravel/errors"
+require "laravel/helpers"
 require "laravel/app_support"
 require "laravel/app"
 require "laravel/configuration"

data/lib/laravel/app.rb

@@ -5,17 +5,12 @@ module Laravel
   #
   class App
     # include the AppSupport module which has all the methods defined.
+    include Laravel::Helpers
     include Laravel::AppSupport
 
     # these attributes must be available as: object.attribute
     attr_reader   :cache_folder, :laravel_repo, :app_path, :source, :cache, :options
 
-    # the path to the folder where the sources will be locally cached.
-    CacheFolder = File.expand_path(File.join(ENV['HOME'], %w[ .laravel repos ]))
-
-    # the official Laravel repository URL which is also the default source for us.
-    LaravelRepo = "http://github.com/laravel/laravel.git"
-
     # This method initializes a new App object for us, on which we can apply
     # our changes.  Logically, this new App object represents an application
     # based on Laravel.
@@ -74,7 +69,7 @@ module Laravel
         say_failed "Downloaded source is not Laravel framework or a possible fork."
         show_info "Cleaning up.."
         clean_up
-        show_error "Specified Laravel source is corrupt!"
+        raise InvalidSourceRepositoryError
       end
     end
 

data/lib/laravel/app_support.rb

@@ -3,20 +3,7 @@ require 'digest/md5'
 module Laravel
   # various methods that help with various classes defined for the Laravel module
   module AppSupport
-
-    # convert a string to MD5 hash - useful to generate quick random strings.
-    #
-    # ==== Parameters
-    # +string+ :: optional, the input string to be hashed
-    #          :: a random string will be used for hashing, if this string is not provided
-    #
-    # ==== Return
-    # +string+ :: a 32-character long MD5'ed string
-    #
-    def make_md5(string = nil)
-      string ||= (0...32).map{ ('a'..'z').to_a[rand(26)] }.join
-      (Digest::MD5.new << string).to_s
-    end
+    include Laravel::Helpers
 
     # Return the path to the local cache directory for a given Source
     #
@@ -34,8 +21,8 @@ module Laravel
     # ==== Return
     # +boolean+ :: True, if the app directory is the current directory.
     #
-    def current_directory?
-      File.directory?(@app_path) and (@app_path == File.expand_path(Dir.pwd))
+    def create_in_current_directory?
+      is_current_directory?(@app_path)
     end
 
     # Check whether the app directory is empty?
@@ -46,8 +33,8 @@ module Laravel
     # ==== Return
     # +boolean+ :: True, if the app directory is an empty one.
     #
-    def empty_directory?
-      File.directory?(@app_path) and (Dir.entries(@app_path).size == 2)
+    def create_in_empty_directory?
+      is_empty_directory?(@app_path)
     end
 
     # Check whether the specified source is a local directory or a URL?
@@ -92,31 +79,6 @@ module Laravel
       File.expand_path(File.join(@app_path, %w[ application tasks ], name))
     end
 
-    # Download a given resource at a particular path
-    #
-    # ==== Parameters
-    # +path+   :: Path where the downloaded content will be saved.
-    #             This can either be the path to a single file or a directory.
-    #             If this is a directory, git will be used to download the source,
-    #             otherwise, curl will be used for the same. Therefore, please, make
-    #             sure that the source is a git repository when +path+ is a directory,
-    #             and that the source is an online file when +path+ is a file.
-    # +source+ :: Source URL/directory from where the content of the resource will be
-    #             downloaded. Please, read information about +path+
-    #
-    # ==== Return
-    # +boolean+ :: true, if the resource was downloaded successfully.
-    #
-    def download_resource(path, source, using)
-      using = "wget" if using == "curl" and `which curl`.empty? and not `which wget`.empty?
-      case using
-      when "git"  then system("git clone -q #{source} #{path}")
-      when "curl" then system("curl -s #{source} > #{path}")
-      when "wget" then system("wget #{source} -O #{path}")
-      else false
-      end
-    end
-
     # check if laravel framework exists in the current application's directory
     # currently, this is performed by looking for the presence of 'artisan' file
     # and the 'laravel' subdirectory.
@@ -139,26 +101,6 @@ module Laravel
       laravel_exists_in_directory?(@cache)
     end
 
-    # check if laravel framework exists in a specified directory
-    # this method is in turn called by the instance methods: 'has_cache?'
-    # and the 'has_laravel?'
-    #
-    # ==== Parameters
-    # +directory+ :: directory to check for the existance of laravel framework
-    #                this can be the relative path to the current app directory
-    #                or the absolute path of the directory.
-    #
-    # ==== Return
-    # +boolean+ :: true, if laravel exists in the given directory
-    #
-    def laravel_exists_in_directory?(directory = "")
-      return false unless directory
-      directory = File.expand_path(directory, @app_path)
-      return false unless File.exists? File.join(directory, "artisan")
-      return false unless File.directory? File.join(directory, "laravel")
-      true
-    end
-
     # This method first checks if the given application path requires
     # the 'force' option, and then checks if the 'force' option is provided
     # by the user.
@@ -172,11 +114,11 @@ module Laravel
     #
     def required_force_is_missing?
       # we need force if path exists and is not the current directory
-      check_force   = (File.exists?(@app_path) and not current_directory?)
+      check_force   = (File.exists?(@app_path) and not create_in_current_directory?)
       # we need force if path is current directory but is not empty
-      check_force ||= (current_directory? and not empty_directory?)
+      check_force ||= (create_in_current_directory? and not create_in_empty_directory?)
       # raise an error when we need to force and we have not been supplied with enforcements
-      show_error "required force is missing! please, provide enforcements!" if check_force and not @options[:force]
+      raise RequiredForceMissingError if check_force and not @options[:force]
     end
 
     # Depending on whether the 'force' parameter is provided, this method
@@ -201,7 +143,7 @@ module Laravel
     #
     def download_or_update_local_cache
       return if source_is_local?
-      show_error "git is required!" if `which git`.empty?
+      raise RequiredLibraryMissingError, "git" if `which git`.empty?
       FileUtils.mkdir_p @cache
       Dir.chdir(@cache) do
         if has_cache?
@@ -245,38 +187,17 @@ module Laravel
     # Keeping the local cache does not make sense, since we anyways can not create
     # applications based on these 'corrupt' repositories.
     def clean_up
-      FileUtils.rm_rf "#{@app_path}" unless current_directory?
+      FileUtils.rm_rf "#{@app_path}" unless create_in_current_directory?
       FileUtils.rm_rf "#{@cache}"
     end
 
-    # This method, simply, imitates the 'say' method that the Thor gem provides us.
-    # I preferred to use this method, since it gives us a very nice UI at the CLI :)
-    #
-    def say(status, message = "", log_status = true)
-      shell = Thor::Shell::Color.new
-      log_status = false if @options and @options[:quiet]
-      shell.say_status(status, message, log_status)
-    end
-
-    # Show some information to the user in Cyan.
-    def show_info(message)
-      say "Information", message, :cyan
-    end
-
-    # Show a success message to the user in Green.
-    def say_success(message)
-      say "Success", message, :green
-    end
 
-    # Show a failed message to the user in Yellow.
-    def say_failed(message)
-      self.say "Failed!!", message, :yellow
+    def read_gem_settings
+      read_yaml GemSettings
     end
 
-    # Show an error the user in Red, and exit the script, since this is an error!
-    def show_error(message)
-      self.say "!!ERROR!!", message, :red
-      exit
+    def write_gem_settings(data)
+      write_yaml data, GemSettings
     end
   end
 end

data/lib/laravel/configuration.rb

@@ -40,7 +40,7 @@ module Laravel
       response = case action
                  when "read" then __read_config(setting)
                  when "update" then __update_config(setting, new_value)
-                 else show_error "Do not know how to configure this setting!"
+                 else raise InvalidArgumentError
                  end
 
       # let the user know when we set the value to an empty string
@@ -101,18 +101,15 @@ module Laravel
 
       # try to change configuration only if this is a Laravel application
       # otherwise, raise an error
-      if has_laravel?
+      raise LaravelNotFoundError unless has_laravel?
 
-        # make the required substitution in the configuration file
-        text = File.read conf
-        text = text.gsub(/'#{key}' => '.*'/, "'#{key}' => '#{new_value}'")
-        File.open(conf, "w") {|file| file.puts text}
+      # make the required substitution in the configuration file
+      text = File.read conf
+      text = text.gsub(/'#{key}' => '.*'/, "'#{key}' => '#{new_value}'")
+      File.open(conf, "w") {|file| file.puts text}
 
-        # check to ensure we were able to update configuration
-        File.readlines(conf).grep(/'#{key}' => '#{new_value}'/).any?
-      else
-        show_error "Is this a valid Laravel application?"
-      end
+      # check to ensure we were able to update configuration
+      File.readlines(conf).grep(/'#{key}' => '#{new_value}'/).any?
     end
 
   end

data/lib/laravel/errors.rb

@@ -0,0 +1,65 @@
+module Laravel
+
+  class InvalidArgumentError < StandardError
+    def initialize(message = "Invalid arguments specified!")
+      super(message)
+    end
+  end
+
+  class LaravelNotFoundError < StandardError
+    def initialize(message = "Is this a valid Laravel application?")
+      super(message)
+    end
+  end
+
+  class InvalidSourceRepositoryError < StandardError
+    def initialize(message = "Source for downloading Laravel repository is corrupt!")
+      super(message)
+    end
+  end
+
+  class LaravelError < StandardError
+    def initialize(message = "A general error occurred while processing the command!")
+      super(message)
+    end
+  end
+
+  class RequiredForceMissingError < StandardError
+    def initialize(message = "You must pass in --force parameter to force an overwrite!")
+      super(message)
+    end
+  end
+
+  class RequiredLibraryMissingError < StandardError
+    def initialize(message = nil)
+      message = message ? "#{message} is required! Please, install it." : "One of the required library is missing, e.g. git, curl, etc.!"
+      super(message)
+    end
+  end
+
+  class ExpectationNotMetError < StandardError
+    def initialize(message = "Test failed because expectation was not met!")
+      super(message)
+    end
+  end
+
+  class FileNotFoundError < StandardError
+    def initialize(message = nil)
+      message = message ? "File not found: #{message}" : "Could not find the specified file!"
+      super(message)
+    end
+  end
+
+  # Show an error the user in Red, and exit the script, since this is an error!
+  def self.handle_error(error, debug = false)
+    shell = Thor::Shell::Color.new
+    shell.say_status("!!ERROR!!", error.message, :red)
+    if debug
+      puts
+      puts "--"
+      puts error.backtrace
+    end
+    exit
+  end
+
+end

data/lib/laravel/helpers.rb

@@ -0,0 +1,142 @@
+module Laravel
+  module Helpers
+
+    # the path to the folder where the sources will be locally cached.
+    CacheFolder = File.join(ENV['HOME'], %w[ .laravel repos ])
+
+    # the official Laravel repository URL which is also the default source for us.
+    LaravelRepo = "http://github.com/laravel/laravel"
+
+    # the path to the setting.yml file for this gem
+    GemSettings = File.join(File.dirname(__FILE__), "settings.yml")
+
+    # convert a string to MD5 hash - useful to generate quick random strings.
+    #
+    # ==== Parameters
+    # +string+ :: optional, the input string to be hashed
+    #          :: a random string will be used for hashing, if this string is not provided
+    #
+    # ==== Return
+    # +string+ :: a 32-character long MD5'ed string
+    #
+    def make_md5(string = nil)
+      string ||= (0...32).map{ ('a'..'z').to_a[rand(26)] }.join
+      (Digest::MD5.new << string).to_s
+    end
+
+    # Check whether the given directory is the current directory.
+    #
+    # ==== Return
+    # +boolean+ :: True, if the app directory is the current directory.
+    #
+    def is_current_directory?(dir = nil)
+      dir ||= Dir.pwd
+      dir = File.expand_path(dir)
+      File.directory?(dir) and (dir == File.expand_path(Dir.pwd))
+    end
+
+    # Check whether the given directory is empty?
+    #
+    # ==== Return
+    # +boolean+ :: True, if the app directory is an empty one.
+    #
+    def is_empty_directory?(dir = nil)
+      dir ||= Dir.pwd
+      dir = File.expand_path(dir)
+      File.directory?(dir) and (Dir.entries(dir).size == 2)
+    end
+
+    # Download a given resource at a particular path
+    #
+    # ==== Parameters
+    # +path+   :: Path where the downloaded content will be saved.
+    #             This can either be the path to a single file or a directory.
+    #             If this is a directory, git will be used to download the source,
+    #             otherwise, curl will be used for the same. Therefore, please, make
+    #             sure that the +source+ is a git repository when +path+ is a directory,
+    #             and that the +source+ is an online file when +path+ is a file.
+    # +source+ :: Source URL/directory from where the content of the resource will be
+    #             downloaded. Please, read information about +path+
+    #
+    # ==== Return
+    # +boolean+ :: true, if the resource was downloaded successfully.
+    #
+    def download_resource(path, source, using)
+      raise RequiredLibraryMissingError, "curl" if using == "curl" and `which curl`.empty? and `which wget`.empty?
+      raise RequiredLibraryMissingError, "git" if using == "git"
+
+      using = "wget" if using == "curl" and `which curl`.empty? and not `which wget`.empty?
+      case using
+      when "git"  then system("git clone -q #{source} #{path}")
+      when "curl" then system("curl -s #{source} > #{path}")
+      when "wget" then system("wget #{source} -O #{path}")
+      else raise RequiredLibraryMissingError
+      end
+    end
+
+    # check if laravel framework exists in a specified directory
+    #
+    # ==== Parameters
+    # +directory+ :: directory to check for the existance of laravel framework
+    #                this can be the relative path to the current app directory
+    #                or the absolute path of the directory.
+    # +relative_to+ :: if the +directory+ is a relative path, we can define the
+    #                  base directory here.
+    #
+    # ==== Return
+    # +boolean+ :: true, if laravel exists in the given directory
+    #
+    def laravel_exists_in_directory?(directory = nil, relative_to = nil)
+      return false unless directory
+      directory = File.expand_path(directory, relative_to)
+      return false unless File.exists? File.join(directory, "artisan")
+      return false unless File.directory? File.join(directory, "laravel")
+      true
+    end
+
+    # read the yaml configuration from a file
+    #
+    def read_yaml(file)
+      raise FileNotFoundError, file unless File.exists?(file)
+      data = YAML.load(File.open(file))
+      # adjust the 'config' hash by making substitutions
+      data["config"].each do |setting, matrix|
+        data["config"].delete(setting) if matrix.has_key?("supported") and not matrix["supported"]
+        data["config"][setting]["default"] = matrix["factory"] if matrix["default"] == "__factory__"
+      end
+      data
+    end
+
+    # write the configuration to a yaml file
+    #
+    def write_yaml(data, file)
+      raise FileNotFoundError, file unless File.exists?(file)
+      File.open(file, "w") {|f| f.write(data.to_yaml) }
+    end
+
+    # This method, simply, imitates the 'say' method that the Thor gem provides us.
+    # I preferred to use this method, since it gives us a very nice UI at the CLI :)
+    #
+    def say(status, message = "", log_status = true)
+      shell = Thor::Shell::Color.new
+      log_status = false if @options and @options[:quiet]
+      shell.say_status(status, message, log_status)
+    end
+
+    # Show some information to the user in Cyan.
+    def show_info(message)
+      say "Information", message, :cyan
+    end
+
+    # Show a success message to the user in Green.
+    def say_success(message)
+      say "Success", message, :green
+    end
+
+    # Show a failed message to the user in Yellow.
+    def say_failed(message)
+      say "Failed!!", message, :yellow
+    end
+
+  end
+end

data/lib/laravel/settings.yml

@@ -0,0 +1,43 @@
+config:
+  url:
+    factory: ""
+    default: __factory__
+    type: url
+  asset_url:
+    factory: ""
+    default: __factory__
+    type: url
+  index:
+    factory: index.php
+    default: ""
+    type: string
+  key:
+    factory: "YourSecretKeyGoesHere!"
+    default: __random__
+    type: string
+  profiler:
+    factory: false
+    default: __factory__
+    type: boolean
+  encoding:
+    factory: UTF-8
+    default: __factory__
+    type: string
+  language:
+    factory: en
+    default: __factory__
+    type: string
+  langauges:
+    supported: false
+    type: array
+  ssl:
+    factory: false
+    default: __factory__
+    type: boolean
+  timezone:
+    factory: UTC
+    default: __factory__
+    type: string
+  aliases:
+    supported: false
+    type: array

data/lib/laravel/version.rb

@@ -1,3 +1,3 @@
 module Laravel
-  VERSION = "0.3.2"
+  VERSION = "0.5.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: laravel
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.5.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-12-25 00:00:00.000000000 Z
+date: 2012-12-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -77,11 +77,16 @@ files:
 - bin/commands/install.rb
 - bin/commands/new.rb
 - bin/laravel
-- features/S_1_new.feature
-- features/S_2_generate_key.feature
-- features/S_3_update_index.feature
-- features/S_4_generator.feature
+- features/S_1_new_online.feature
+- features/S_2_new_offline.feature
+- features/S_3_new_customized.feature
+- features/S_4_config.feature
+- features/S_5_install.feature
+- features/step_definitions/config_steps.rb
+- features/step_definitions/install_steps.rb
 - features/step_definitions/laravel.rb
+- features/step_definitions/new_steps.rb
+- features/step_definitions/requirements.rb
 - features/support/env.rb
 - features/support/laravel_helpers.rb
 - laravel.gemspec
@@ -89,7 +94,10 @@ files:
 - lib/laravel/app.rb
 - lib/laravel/app_support.rb
 - lib/laravel/configuration.rb
+- lib/laravel/errors.rb
+- lib/laravel/helpers.rb
 - lib/laravel/installer.rb
+- lib/laravel/settings.yml
 - lib/laravel/version.rb
 homepage: https://github.com/nikhgupta/laravel
 licenses: []
@@ -105,7 +113,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 3739253093214665675
+      hash: 2758462782054416537
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -114,7 +122,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 3739253093214665675
+      hash: 2758462782054416537
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24
@@ -124,10 +132,15 @@ summary: This gem is a wrapper around the Laravel framework for PHP. Initially,
   gem would allow to create new laravel apps along with options to modify the default
   behavior for these new installations.
 test_files:
-- features/S_1_new.feature
-- features/S_2_generate_key.feature
-- features/S_3_update_index.feature
-- features/S_4_generator.feature
+- features/S_1_new_online.feature
+- features/S_2_new_offline.feature
+- features/S_3_new_customized.feature
+- features/S_4_config.feature
+- features/S_5_install.feature
+- features/step_definitions/config_steps.rb
+- features/step_definitions/install_steps.rb
 - features/step_definitions/laravel.rb
+- features/step_definitions/new_steps.rb
+- features/step_definitions/requirements.rb
 - features/support/env.rb
 - features/support/laravel_helpers.rb

data/features/S_1_new.feature

@@ -1,59 +0,0 @@
-Feature: Create a new application based on Laravel framework for PHP
-  In order to develop awesome web application
-  As a PHP developer acquinted with ruby
-  I want to use Laravel gem to setup Laravel framework
-
-  @requires_repository_download @very_slow @online 
-  Scenario: create Laravel application with default settings
-    Given local cache does not exist for "official" repository
-    When  I run `laravel new my_app`
-    Then  laravel application should be ready to use in "my_app" directory
-
-  @may_require_repository_download 
-  Scenario: create Laravel application in the current directory
-    When  I run `laravel new . --force`
-    Then  laravel application should be ready to use in "." directory
-    When  I run `laravel new .`
-    Then  the stdout should contain "ERROR"
-
-  @requires_repository_download @online 
-  Scenario: create Laravel application using source from a non-official repo
-    Given local cache does not exist for "pastes" repository
-    When  I run `laravel new my_app --source=http://github.com/laravel/pastes`
-    Then  laravel application should be ready to use in "my_app" directory using "pastes" repository
-
-  @requires_repository_download @online
-  Scenario: create Laravel application using non-laravel repository
-    When  I run `laravel new my_app --source=http://github.com/github/gitignore`
-    Then  local cache for "non_laravel" repository should not exist
-    And   the stdout should contain "source is corrupt"
-    And   the stdout should contain "ERROR"
-    And   laravel application must not exist in "my_app" directory
-
-  @may_require_repository_download
-  Scenario: create Laravel application using repository from local cache
-    Given local cache exists for "pastes" repository
-    When  I run `laravel new my_app --source=http://github.com/laravel/pastes`
-    Then  laravel application should be ready to use in "my_app" directory using "pastes" repository
-
-  @may_require_repository_download 
-  Scenario: create Laravel application using source from a directory
-    Given laravel source has already been downloaded in "laravel" directory
-    When  I run `laravel new my_app --source=laravel`
-    Then  laravel application should be ready to use in "my_app" directory
-
-  @may_require_repository_download
-  Scenario: create Laravel application but do not update permissions on storage/ directory
-    When  I run `laravel new my_app --no-perms`
-    Then  the stdout should contain "Hurray!"
-    And   laravel application must exist in "my_app" directory
-    And   permissions should not be updated on "my_app/storage" directory
-
-  @may_require_repository_download
-  Scenario: create Laravel application with maximum customizations
-    When I run `laravel new -kgi 'home.php' -s http://github.com/laravel/pastes my_app --force`
-    Then laravel application should be ready to use in "my_app" directory using "pastes" repository
-    And  the stdout should contain "Creating application forcefully"
-    And  configuration: "key" must be updated to "__something__" for "my_app" application
-    And  configuration: "index" must be updated to "home.php" for "my_app" application
-    And  task: "generator" should be installed as "generate.php" for "my_app" application

data/features/S_2_generate_key.feature

@@ -1,16 +0,0 @@
-Feature: Generate a new key for Laravel application
-  In order to make the Laravel application more secure
-  As a PHP developer acquinted with ruby
-  I want to use Laravel gem to generate a key
-
-  @may_require_repository_download
-  Scenario: generate a new key for a Laravel application
-    Given laravel application exists in "my_app" directory
-    When  I run `laravel config key --app=my_app`
-    Then  configuration: "key" must be updated to "__something__" for "my_app" application
-
-  @may_require_repository_download
-  Scenario: create Laravel application and generate a key for it
-    When  I run `laravel new my_app --key`
-    Then  laravel application should be ready to use in "my_app" directory
-    And   configuration: "key" must be updated to "__something__" for "my_app" application

data/features/S_3_update_index.feature

@@ -1,16 +0,0 @@
-Feature: Update Application Index for a Laravel based application
-  In order to have pretty links in my web application
-  As a PHP developer acquinted with ruby
-  I want to use Laravel gem to update Application Index for this application
-
-  @may_require_repository_download
-  Scenario: update Application Index in a Laravel application
-    Given laravel application exists in "my_app" directory
-    When  I run `laravel config index 'home.php' --app=my_app`
-    Then  configuration: "index" must be updated to "home.php" for "my_app" application
-
-  @may_require_repository_download
-  Scenario: create Laravel application without an Application Index
-    When  I run `laravel new my_app --index=''`
-    Then  laravel application should be ready to use in "my_app" directory
-    And   configuration: "index" must be updated to "" for "my_app" application

data/features/S_4_generator.feature

@@ -1,16 +0,0 @@
-Feature: Download Laravel Generator by Jeffrey Way
-  In order to generate code for my application quickly using :generate tasks
-  As a PHP developer acquinted with ruby
-  I want to use Laravel gem to download Laravel Generator by Jeffrey Way
-
-  @may_require_repository_download 
-  Scenario: download Laravel generator
-    Given laravel application exists in "my_app" directory
-    When  I run `laravel install generator --app=my_app`
-    Then  task: "generator" should be installed as "generate.php" for "my_app" application
-
-  @may_require_repository_download 
-  Scenario: download Laravel generator while creating an application
-    When  I run `laravel new my_app --generator`
-    Then  laravel application should be ready to use in "my_app" directory
-    And  task: "generator" should be installed as "generate.php" for "my_app" application