Rename from working title "wheelie" to "katapult"

Author: codener

Gemfile

@@ -1,4 +1,4 @@
 source 'https://rubygems.org'
 
-# Specify your gem's dependencies in wheelie.gemspec
+# Specify your gem's dependencies in katapult.gemspec
 gemspec

Guardfile

@@ -6,6 +6,6 @@ guard 'cucumber' do
   watch(%r{^features/support/.+$})          { 'features' }
   watch(%r{^features/step_definitions/(.+)_steps\.rb$}) { |m| Dir[File.join("**/#{m[1]}.feature")][0] || 'features' }
 
-  watch(%r{^lib/generators/wheelie/.+/.+_generator\.rb$}) { 'features/wheelie.feature:12' }
-  watch(%r{^lib/wheelie/.+\.rb$}) { 'features/wheelie.feature:12' }
+  watch(%r{^lib/generators/katapult/.+/.+_generator\.rb$}) { 'features/katapult.feature:12' }
+  watch(%r{^lib/katapult/.+\.rb$}) { 'features/katapult.feature:12' }
 end

README.md

@@ -1,38 +1,45 @@
-# Wheelie
+# Katapult
 
-Wheelie is a kickstart framework for Rails applications. It makes starting
+<img src="katapult.png" width="200px" align="right" />
+
+
+`Katapult` is a kickstart framework for Rails applications. It makes starting
 Rails applications a bliss.
 
-Wheelie will always support current Versions of Ruby and Rails, at the moment
-it's Rails 4.1 and Ruby 2.1.
+`Katapult` will always support current versions of Ruby and Rails, at the
+moment it's Rails 4.1 and Ruby 2.1.
 
 ## Installation
 
-As Wheelie is designed to *start* Rails applications, it works best with a
+As `katapult` is designed to *start* Rails applications, it works best with a
 clean new Rails app. To create one, run
 
-    rails new choose_your_name
+    katapult target MY_APPLICATION_NAME
+
+This will add the `katapult` gem to the Gemfile and then integrate `katapult`
+by running
 
-Add `gem 'wheelie'` to the Gemfile, `bundle` and then run
+    rails generate katapult:install
+    rails generate katapult:basics
 
-    rails generate wheelie:install
 
-This will create `lib/wheelie/application_model.rb` where you will draft your
-application.
+It will install application basics, such as a `database.yml`, basics styles as
+well as RSpec and Cucumber and prepare `lib/katapult/application_model.rb`
+where you will draft your application.
 
 
 ## Usage
 
-After installation, you'll find a file `lib/wheelie/application_model.rb` where
-you will define the fundamentals of your application. Inside this file, you'll
-use Wheelie's simple DSL (domain specific language) to express yourself.
+After installation, you'll find a file `lib/katapult/application_model.rb` where
+you will define the properties of your application. Inside this file, you'll
+use `katapult`'s simple DSL (domain specific language) to express yourself.
 
-Wheelie brings several basic elements: Model, Attribute, WUI (which stands for
-*Web User Interface*) and Action. Each Wheelie element has the same syntax,
-taking a name, options and a block:
+The DSL consists of elements: Model, Attribute, WUI (which stands for *Web User
+Interface*), Action, and more. Each `katapult` element has the same syntax,
+taking a name, options, and a block:
 
-    element 'name', options: 'go here' do |element|
-      element.method
+    element_type 'name', options: 'example' do |element|
+      element.some_method
     end
 
 
@@ -48,7 +55,7 @@ Takes a name and a block:
 Defined on Model. Takes a name and options:
 
     model.attr :email
-    model.attr :age, type: :integer
+    model.attr :age, type: :integer, assignable_values: 18..99
     model.attr :income, type: :money
     model.attr :homepage, type: :url, default: 'http://www.makandra.de'
     model.attr :locked, type: :flag, default: false
@@ -67,28 +74,41 @@ Defined on WUI. Takes a name and options:
 
     wui.action :index
     wui.action :show
-    wui.action :create
-    wui.action :update
+    wui.action :create # also creates :new
+    wui.action :update # also creates :edit
     wui.action :destroy
+    wui.crud   # creates all the standard rails actions above
     wui.action :custom_action, method: :post, scope: :member
     wui.action :other_action, method: :get, scope: :collection
 
 
+### Navigation
+Takes a name, will generate a navigation with links to the index pages of all
+WUIs.
+
+    navigation :main
+
+
 ## Contributing
 
-<!-- 1. Fork it ( http://github.com/<my-github-username>/wheelie/fork )
+<!-- 1. Fork it ( http://github.com/<my-github-username>/katapult/fork )
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create new Pull Request -->
 
-Wheelie caches a pristine Rails application inside its `tmp/` directory to speed up testing. Keep this in mind, as it may lead to issues when switching Ruby versions or installing a new version of the Rails gem.
+`Katapult` caches a pristine Rails application inside its `tmp/` directory to
+speed up test runs. Keep this in mind, as it may lead to caching issues when
+switching Ruby versions or installing a new version of the Rails gem.
 
-Since Wheelie has full-stack integration tests, it requires a MySQL account. Create a dedicated account by running this command in a MySQL console (as-is):
+Since `katapult` has full-stack integration tests, it requires a MySQL account.
+Create a dedicated account on your MySQL server by running this command in a
+MySQL console (as-is):
 
-    GRANT ALL ON *.* TO 'wheelie'@'localhost' IDENTIFIED BY 'secret';
+    GRANT ALL ON *.* TO 'katapult'@'localhost' IDENTIFIED BY 'secret';
 
-The user `wheelie` is hereby granted any action (SELECT, UPDATE, etc. except for granting privileges) on any database and table (`*.*`).
+The user `katapult` is hereby granted any action (SELECT, UPDATE, etc. except
+for granting privileges) on any database and table (`*.*`).
 
 
 ## Credits

bin/katapult

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+
+case (command = ARGV.shift)
+when 'target'
+  app_name = ARGV.shift
+
+  puts 'Creating new Rails application ...'
+  system "rails new #{app_name} --skip-test-unit --skip-bundle --database mysql"
+  Dir.chdir app_name
+
+  puts
+  puts 'Installing katapult ...'
+  File.open('Gemfile', 'a') do |file|
+    file.puts "gem 'katapult'#{ ENV['KATAPULT_GEMFILE_OPTIONS'] }"
+  end
+  system 'bundle install'
+  system 'bundle exec rails generate katapult:install'
+
+  puts
+  puts 'Generating katapult basics ...'
+  system 'bundle exec rails generate katapult:basics'
+
+  puts
+  puts 'Done.'
+
+when 'fire'
+  app_model_path = 'lib/katapult/application_model.rb'
+
+  puts 'Loading katapult ...'
+  system 'bin/rails generate katapult:render ' + app_model_path
+
+else
+  puts 'Usage: katapult [target APP_NAME | fire]'
+end

bin/wheelie

@@ -1,35 +1,39 @@
-Feature: Wheelie binary `wheelie`
+Feature: Katapult binary `katapult`
 
   Scenario: Start new Rails application
     Given The default aruba timeout is 120 seconds
 
-    When I successfully run `wheelie target binary_test`
-    And I cd to "binary_test"
+    When I successfully run `katapult target binary_test`
+    Then the output should contain "Creating new Rails application"
+    And the output should contain "Installing katapult"
+    And the output should contain "Generating katapult basics"
+    And the output should contain "Done."
 
-    Then a file named "lib/wheelie/application_model.rb" should exist
+    When I cd to "binary_test"
+    Then a file named "lib/katapult/application_model.rb" should exist
     And a file named "config/database.yml" should exist
-    And the file "Gemfile" should contain "gem 'wheelie'"
+    And the file "Gemfile" should contain "gem 'katapult'"
 
     When I run `bundle check`
     Then the output should contain "The Gemfile's dependencies are satisfied"
 
 
   Scenario: Forget to pass application name
-    When I run `wheelie target # without app name`
+    When I run `katapult target # without app name`
     Then the output should contain "No value provided for required arguments 'app_path'"
 
 
   Scenario: Run without arguments
-    When I run `wheelie # without arguments`
-    Then the output should contain "Usage: wheelie [target APP_NAME | fire]"
+    When I run `katapult # without arguments`
+    Then the output should contain "Usage: katapult [target APP_NAME | fire]"
 
 
   Scenario: Render the application model
     Given a pristine Rails application
-    And I install wheelie
-    And I generate wheelie basics
+    And I install katapult
+    And I generate katapult basics
 
-    When I run `wheelie fire`
+    When I run `katapult fire`
     Then the output should contain "Loading katapult"
-    And the output should contain "parse  lib/wheelie/application_model"
-    And the output should contain "render  into wheelie_test_app"
+    And the output should contain "parse  lib/katapult/application_model"
+    And the output should contain "render  into katapult_test_app"

features/binary.feature

@@ -1,17 +1,17 @@
-Feature: Configure Wheelie
+Feature: Configure katapult
 
   Background:
     Given a pristine Rails application
-    And I install wheelie
-    And I generate wheelie basics
+    And I install katapult
+    And I generate katapult basics
 
 
   Scenario: Custom model template
-    When I overwrite "lib/wheelie/application_model.rb" with:
+    When I overwrite "lib/katapult/application_model.rb" with:
       """
       model 'Car'
       """
-    And a file named "lib/templates/wheelie/model/model.rb" with:
+    And a file named "lib/templates/katapult/model/model.rb" with:
       """
       # custom model template for <%= class_name %>
 

features/configuration.feature

@@ -1,12 +1,12 @@
-Feature: Wheelie in general
+Feature: Katapult in general
 
   Background:
     Given a pristine Rails application
 
 
-  Scenario: Install Wheelie
-    When I install wheelie
-    Then the file "lib/wheelie/application_model.rb" should contain exactly:
+  Scenario: Install katapult
+    When I install katapult
+    Then the file "lib/katapult/application_model.rb" should contain exactly:
       """
       # Here you define the fundamentals of your application.
       #
@@ -23,13 +23,16 @@ Feature: Wheelie in general
       #   wui.action :show
       #   wui.action :lock, scope: :member, method: :post
       # end
+      #
+      # Add navigation
+      # navigation :main
 
       """
 
 
   Scenario: Generate basic files and settings
-    Given I install wheelie
-    When I generate wheelie basics
+    Given I install katapult
+    When I generate katapult basics
     Then the file "Gemfile" should contain exactly:
       """
       source 'https://rubygems.org'
@@ -40,7 +43,7 @@ Feature: Wheelie in general
       gem 'jquery-rails'
       gem 'jbuilder', '~> 2.0'
       gem 'spring',        group: :development
-      gem 'wheelie', path: '../../..'
+      gem 'katapult', path: '../../..'
 
       # engines
       gem 'haml-rails'
@@ -121,16 +124,16 @@ Feature: Wheelie in general
       common: &common
         adapter: mysql2
         encoding: utf8
-        username: wheelie
+        username: katapult
         password: secret
 
       development:
         <<: *common
-        database: wheelie_test_app_development
+        database: katapult_test_app_development
 
       test: &test
         <<: *common
-        database: wheelie_test_app_test<%= ENV['TEST_ENV_NUMBER'] %>
+        database: katapult_test_app_test<%= ENV['TEST_ENV_NUMBER'] %>
 
       cucumber:
         <<: *test
@@ -145,11 +148,11 @@ Feature: Wheelie in general
 
       development:
         <<: *common
-        database: wheelie_test_app_development
+        database: katapult_test_app_development
 
       test: &test
         <<: *common
-        database: wheelie_test_app_test<%= ENV['TEST_ENV_NUMBER'] %>
+        database: katapult_test_app_test<%= ENV['TEST_ENV_NUMBER'] %>
 
       cucumber:
         <<: *test