grimen-dry_scaffold 0.2.3 → 0.2.4

data/README.textile

@@ -1,13 +1,13 @@
 h1. DRY SCAFFOLD
 
-A Rails scaffold generator that generates DRYer, cleaner, and more useful code.
+_A Rails scaffold generator that generates DRYer, cleaner, and more useful code._
 
 h2. Description
 
 DryScaffold is a replacement for the Rails scaffold generator that generates code that most people end up deleting or rewriting anyway because of the unusable code. The scaffold concept is powerful, but it has more potential than generating messy and almost useless code - something that might change with Rails 3 though. The goal with DryScaffold is to generate DRY, beautiful, and standards compliant code based on common patterns without adding a lot of assumptions.
 
-h3. Key Concepts:
-
+*Key Concepts:*
+ 
 * Controllers that are DRY, RESTful, no code-smells, following conventions, and implementing VERY common patterns.
 * Views that are DRY, semantic, standards compliant, valid, and more useful in development.
 * Factories instead of fixtures.
@@ -17,19 +17,19 @@ h3. Key Concepts:
 h2. Dependencies
 
 h3. Required:
-
+ 
 * "*haml*":http://github.com/nex3/haml - ERB sucks like PHP, end of story
 
 h3. Optional:
-
+ 
 h4. Controllers/Views
-
+ 
 * "*will_paginate*":http://github.com/mislav/will_paginate - Pagination
 * "*formtastic*":http://github.com/justinfrench/formtastic - DRY and semantic forms
 * "*inherited_resources*":http://github.com/josevalim/inherited_resources - DRY/Resourceful controllers
-
+ 
 h4. Models
-
+ 
 * "*factory_girl*":http://github.com/thoughtbot/factory_girl - Fixture-replacement
 * "*machinist*":http://github.com/notahat/machinist - Fixture-replacement
 * "*object_daddy*":http://github.com/flogic/object_daddy - Fixture-replacement
@@ -53,7 +53,9 @@ h3. Formtastic Forms
 
 Quick and dirty; Formtastic makes your form views cleaner, and your life as a Rails developer easier (for real). Formtastic forms can be turned off, but I would recommend any Rails developer to consider using it - there is really no good reason not to if you not running very old version of Rails.
 
-h4. Default HAML (without Formtastic):
+h4. Standard
+
+HAML + ActionView FormHelpers:
 
 <pre>- form_for(@duck) do |f|
   = f.error_messages
@@ -67,7 +69,9 @@ h4. Default HAML (without Formtastic):
   %p.buttons
     = f.submit 'Create'</pre>
 
-h4. Formtastic + HAML:
+h4. Formtastic
+
+HAML + Formtastic:
 
 <pre>- semantic_form_for(@duck) do |f|
   - f.inputs do
@@ -82,7 +86,9 @@ h3. Resourceful Controllers
 
 Quick and dirty; InheritedResources makes your controllers controllers cleaner, and might make experienced Rails developer's life DRYer code wise. This is possible because of REST as a convention in Rails, and therefore the patterns that arise in controllers can be DRYed up A LOT. Resourceful - InheritedResources-based - controllers can be turned off, but I would recommend any experienced Rails developer to consider using it - there is really no good reason not to unless maybe if you are a Rails beginner, then you should consider get used to the basic Rails building blocks first.
 
-h4. Default (without InheritedResources)
+h4. Standard
+
+Using ActionController:
 
 <pre>def new
   @duck = Duck.new
@@ -94,7 +100,9 @@ h4. Default (without InheritedResources)
   end
 end</pre>
 
-h4. Resourceful (InheritedResources)
+h4. Resourceful
+
+Using InheritedResources:
 
 <pre>actions :new
 respond_to :html, :xml, :json</pre>
@@ -107,11 +115,13 @@ Pagination is such a common feature that always seems to be implemented anyway,
 
 Find out more about *will_paginate*: "http://github.com/mislav/will_paginate":http://github.com/mislav/will_paginate
 
-h3. DRY Patterns
+h3. DRYying Patterns
 
 Either if you choosing default or resourceful controllers, this pattern is used to DRYing up controllers a bit more, and at the same time loading resources in the same place using before_filter while adding automatic pagination for collections.
 
-h4. Default (ActionController with pagination - not using InheritedResources)
+h4. Standard
+
+ActionController with pagination:
 
 <pre>before_filter :load_resource, :only => [:show, :edit, :update, :destroy]
 before_filter :load_and_paginate_resources, :only => [:index]
@@ -133,7 +143,9 @@ protected
   end
   alias :load_resource :resource</pre>
 
-h4. Resourceful (InheritedResources with pagination)
+h4. Resourceful
+
+InheritedResources with pagination:
 
 <pre>protected
   
@@ -152,8 +164,8 @@ h3. View Partials
 
 A very common pattern is to break up views in partials, which is also what DryScaffold does:
 
-* new/edit => _form
-* index => _item
+* @new@/@edit@ => @_form@
+* @index@ => @_item@
 
 h3. More To Come... (TODO)
 
@@ -164,7 +176,7 @@ These are things I have in mind:
 
 h2. Setup
 
-Installing DryScaffold is easy as 1-2-3...nah, really:
+Installing DryScaffold is easy:
 
 h3. 1. Installation
 
@@ -172,24 +184,21 @@ Install DryScaffold...
 
 h4. Gem (Recommended)
 
-<pre>gem sources -a http://gems.github.com
-sudo gem install grimen-dry_scaffold</pre>
+<pre>sudo gem install grimen-dry_scaffold --source http://gems.github.com</pre>
 
-h4. Plugin
-
-<pre>./script/plugin install git://github.com/grimen/dry_scaffold.git</pre>
+...and in config: @config/environments/development.rb@
 
-h3. 2. Configuration (Gem only)
+<pre>config.gem 'grimen-dry_scaffold', :lib => 'dry_scaffold', :source => 'http://gems.github.com'</pre>
 
-In: @config/environments/development.rb@
+h4. Plugin
 
-<pre>config.gem 'grimen-dry_scaffold', :lib => 'dry_scaffold'</pre>
+<pre>./script/plugin install git://github.com/grimen/dry_scaffold.git</pre>
 
-h3. 3. Install Dependencies (Partly optional)
+h3. 2. Install Dependencies (Partly optional)
 
 Install dependencies to release the full power of dry_scaffold. Only HAML is really required of these, but how could anyone resist candy? =)
 
-h4. Express
+h4. Automatic/Express
 
 For us lazy ones... =)
 
@@ -197,23 +206,21 @@ For us lazy ones... =)
 
 Will install the dependencies, initialize HAML within current Rails project if not already done, and automatically referencing the dependency gems within the current Rails project environment config if they are not already in there (note: nothing will be overwritten).
 
-h4. Installation
-
-Get the gems...
+h4. Manual
 
-<pre>sudo gem install haml</pre>
-<pre>sudo gem install will_paginate</pre>
-<pre>sudo gem install justinfrench-formtastic</pre>
-<pre>sudo gem install josevalim-inherited_resources</pre>
+Get the gems...you want:
 
-h4. B2. Configuration
+<pre>sudo gem install haml
+sudo gem install will_paginate
+sudo gem install justinfrench-formtastic
+sudo gem install josevalim-inherited_resources</pre>
 
-In: @config/environment.rb@
+...and same for the config config: @config/environments/development.rb@
 
-<pre>config.gem 'haml'</pre>
-<pre>config.gem 'will_paginate'</pre>
-<pre>config.gem 'justinfrench-formtastic', :lib => 'formtastic, :source => 'http://gems.github.com'</pre>
-<pre>config.gem 'josevalim-inherited_resources', :lib => 'inherited_resources', :source => 'http://gems.github.com'</pre>
+<pre>config.gem 'haml'
+config.gem 'will_paginate'
+config.gem 'justinfrench-formtastic', :lib => 'formtastic, :source => 'http://gems.github.com'
+config.gem 'josevalim-inherited_resources', :lib => 'inherited_resources', :source => 'http://gems.github.com'</pre>
 
 h2. Usage
 
@@ -364,7 +371,9 @@ Example:
 
 <pre>--skip-resourceful --layout</pre>
 
-h4. General
+h4. Scaffold
+
+These are the options for the scaffold-generator.
 
 * @--skip-pagination@   - Don't generate pagination of collections in controller and views, i.e. don't use *will_paginate*.
 * @--skip-resourceful@  - Don't generate resourceful controller, i.e. don't use *inherited_resources*.
@@ -374,8 +383,10 @@ h4. General
 * @--skip-tests@        - Don't generate tests (functional/unit/...).
 * @--skip-builders@     - Don't generate builders.
 * @--layout@            - Generate layout.
+ 
+h4. Model
 
-h4. Model-specific
+These are the options for the model/scaffold-generators.
 
 * @--fixtures@          - Generate fixtures.
 * @--fgirl@             - Generate *factory_girl* factories.
@@ -400,10 +411,10 @@ For your inspiration, you could try the following:
 
 <pre>./script/generate dry_scaffold Zebra name:string about:text --skip-resourceful
 ./script/generate dry_scaffold Kangaroo name:string about:text --skip-formtastic
-./script/generate dry_scaffold Duck name:string about:text _actions:new,create,index,quack
-./script/generate dry_scaffold Parrot name:string about:text _formats:html,xml,yml
-./script/generate dry_scaffold GoldFish name:string about:text _indexes:name --fgirl
-./script/generate dry_scaffold Frog name:string about:text _indexes:name,name+about --fixtures</pre>
+./script/generate dscaffold Duck name:string about:text _actions:new,create,index,quack
+./script/generate dscaffold Parrot name:string about:text _formats:html,xml,yml
+./script/generate dscaffold GoldFish name:string about:text _indexes:name --fgirl
+./script/generate dry_model Frog name:string about:text _indexes:name,name+about --fixtures</pre>
 
 ...or just go crazy!
 
@@ -413,4 +424,6 @@ If you experience any issues/bugs or have feature requests, just file a GitHub-i
 If you think parts of my implementation could be implemented nicer somehow, please let me know...or just fork it and fix it yourself! =)
 At last, positive feedback is always appreciated!
 
-Copyright (c) 2009 Jonas Grimfelt, released under MIT-license
+h2. License
+
+Copyright (c) 2009 Jonas Grimfelt, released under the MIT-license.

data/Rakefile

@@ -20,7 +20,7 @@ begin
     gem.email = EMAIL
     
     gem.require_paths = %w{lib}
-    gem.files = %w(MIT-LICENSE Rakefile) + SUPPORT_FILES + Dir.glob(File.join('{bin,generators,rails,tasks}', '**', '*'))
+    gem.files = %w(MIT-LICENSE Rakefile) + SUPPORT_FILES + Dir.glob(File.join('{bin,config,generators,lib,rails,tasks}', '**', '*'))
     gem.executables = %w(dscaffold dry_scaffold dmodel dry_model)
     gem.extra_rdoc_files = SUPPORT_FILES
   end

data/TODO.textile

@@ -10,4 +10,4 @@ h2. Maybe later
 * Clean-up: Comment the code a bit more =)
 * Refactor: Break up in different generators: dry_controller, dry_views, etc., and use as dependencies in dry_scaffold?
 * Feature: Check for overridden templates in: RAILS_ROOT/lib/dry_scaffold/templates/
-* Feature: Builder for podcast-feed, similar to RSS/Atom-builders.
+* Feature: Builder for podcast-feed, similar to RSS/Atom-builders. http://wiki.github.com/radiant/radiant/host-a-podcast

data/generators/dry_model/dry_model_generator.rb

@@ -13,8 +13,8 @@ class DryModelGenerator < Rails::Generator::NamedBase
   
   # Load defaults from config file - default or custom.
   begin
-    default_config_file = File.join(File.dirname(__FILE__), '..', '..', 'config', 'scaffold.yml')
-    custom_config_file = File.join(Rails.root, 'config', 'scaffold.yml')
+    default_config_file = File.expand_path(File.join(File.dirname(__FILE__), '..', '..', 'config', 'scaffold.yml'))
+    custom_config_file = File.expand_path(File.join(Rails.root, 'config', 'scaffold.yml'))
     config_file = File.join(File.exist?(custom_config_file) ? custom_config_file : default_config_file)
     config = YAML::load(File.open(config_file))
     CONFIG_OPTIONS = config['dry_model']['options'] rescue nil

data/generators/dry_scaffold/dry_scaffold_generator.rb

@@ -13,8 +13,8 @@ class DryScaffoldGenerator < Rails::Generator::NamedBase
   
   # Load defaults from config file - default or custom.
   begin
-    default_config_file = File.join(File.dirname(__FILE__), '..', '..', 'config', 'scaffold.yml')
-    custom_config_file = File.join(Rails.root, 'config', 'scaffold.yml')
+    default_config_file = File.expand_path(File.join(File.dirname(__FILE__), '..', '..', 'config', 'scaffold.yml'))
+    custom_config_file = File.expand_path(File.join(Rails.root, 'config', 'scaffold.yml'))
     config_file = File.join(File.exist?(custom_config_file) ? custom_config_file : default_config_file)
     config = YAML::load(File.open(config_file))
     CONFIG_ARGS = config['dry_scaffold']['args'] rescue nil
@@ -161,7 +161,7 @@ class DryScaffoldGenerator < Rails::Generator::NamedBase
       m.directory File.join(HELPERS_PATH, controller_class_path) unless options[:skip_helpers]
       m.directory File.join(VIEWS_PATH, controller_class_path, controller_file_name) unless options[:skip_views]
       m.directory File.join(FUNCTIONAL_TESTS_PATH, controller_class_path) unless options[:skip_tests]
-      m.directory File.join(UNIT_TESTS_PATH, controller_class_path) unless options[:skip_tests]
+      m.directory File.join(UNIT_TESTS_PATH, 'helpers', controller_class_path) unless options[:skip_tests] || options[:skip_helpers]
       
       # Controllers.
       controller_template = options[:resourceful] ? 'inherited_resources' : 'action'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: grimen-dry_scaffold
 version: !ruby/object:Gem::Version 
-  version: 0.2.3
+  version: 0.2.4
 platform: ruby
 authors: 
 - Jonas Grimfelt
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-05-13 00:00:00 -07:00
+date: 2009-05-19 00:00:00 -07:00
 default_executable: 
 dependencies: []