thorero-gen 0.9.4

data/templates/application/slice/full/lib/%base_name%/slicetasks.rb

@@ -0,0 +1,18 @@
+namespace :slices do
+  namespace :<%= underscored_name %> do 
+    
+    # add your own <%= base_name %> tasks here
+    
+    # implement this to test for structural/code dependencies
+    # like certain directories or availability of other files
+    desc "Test for any dependencies"
+    task :preflight do
+    end
+    
+    # implement this to perform any database related setup steps
+    desc "Migrate the database"
+    task :migrate do
+    end
+    
+  end
+end

data/templates/application/slice/full/public/stylesheets/master.css

@@ -0,0 +1,2 @@
+html, body { margin: 0; padding: 0; }
+#container { width: 800px; margin: 4em auto; padding: 4em 4em 6em 4em; background: #DDDDDD; }

data/templates/application/slice/full/spec/%base_name%_spec.rb

@@ -0,0 +1,130 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe "<%= module_name %> (module)" do
+  
+  it "should have proper specs"
+  
+  # Feel free to remove the specs below
+  
+  before :all do
+    Merb::Router.prepare { |r| r.add_slice(:<%= module_name %>) } if standalone?
+  end
+  
+  after :all do
+    Merb::Router.reset! if standalone?
+  end
+  
+  it "should be registered in Merb::Slices.slices" do
+    Merb::Slices.slices.should include(<%= module_name %>)
+  end
+  
+  it "should be registered in Merb::Slices.paths" do
+    Merb::Slices.paths[<%= module_name %>.name].should == current_slice_root
+  end
+  
+  it "should have an :identifier property" do
+    <%= module_name %>.identifier.should == "<%= base_name %>"
+  end
+  
+  it "should have an :identifier_sym property" do
+    <%= module_name %>.identifier_sym.should == :<%= underscored_name %>
+  end
+  
+  it "should have a :root property" do
+    <%= module_name %>.root.should == Merb::Slices.paths[<%= module_name %>.name]
+    <%= module_name %>.root_path('app').should == current_slice_root / 'app'
+  end
+  
+  it "should have a :file property" do
+    <%= module_name %>.file.should == current_slice_root / 'lib' / '<%= base_name %>.rb'
+  end
+  
+  it "should have metadata properties" do
+    <%= module_name %>.description.should == "<%= module_name %> is a chunky Merb slice!"
+    <%= module_name %>.version.should == "0.0.1"
+    <%= module_name %>.author.should == "YOUR NAME"
+  end
+  
+  it "should have :routes and :named_routes properties" do
+    <%= module_name %>.routes.should_not be_empty
+    <%= module_name %>.named_routes[:<%= underscored_name %>_index].should be_kind_of(Merb::Router::Route)
+  end
+
+  it "should have an url helper method for slice-specific routes" do
+    <%= module_name %>.url(:controller => 'main', :action => 'show', :format => 'html').should == "/<%= base_name %>/main/show.html"
+    <%= module_name %>.url(:<%= underscored_name %>_index, :format => 'html').should == "/<%= base_name %>/index.html"
+  end
+  
+  it "should have a config property (Hash)" do
+    <%= module_name %>.config.should be_kind_of(Hash)
+  end
+  
+  it "should have bracket accessors as shortcuts to the config" do
+    <%= module_name %>[:foo] = 'bar'
+    <%= module_name %>[:foo].should == 'bar'
+    <%= module_name %>[:foo].should == <%= module_name %>.config[:foo]
+  end
+  
+  it "should have a :layout config option set" do
+    <%= module_name %>.config[:layout].should == :<%= underscored_name %>
+  end
+  
+  it "should have a dir_for method" do
+    app_path = <%= module_name %>.dir_for(:application)
+    app_path.should == current_slice_root / 'app'
+    [:view, :model, :controller, :helper, :mailer, :part].each do |type|
+      <%= module_name %>.dir_for(type).should == app_path / "#{type}s"
+    end
+    public_path = <%= module_name %>.dir_for(:public)
+    public_path.should == current_slice_root / 'public'
+    [:stylesheet, :javascript, :image].each do |type|
+      <%= module_name %>.dir_for(type).should == public_path / "#{type}s"
+    end
+  end
+  
+  it "should have a app_dir_for method" do
+    root_path = <%= module_name %>.app_dir_for(:root)
+    root_path.should == Merb.root / 'slices' / '<%= base_name %>'
+    app_path = <%= module_name %>.app_dir_for(:application)
+    app_path.should == root_path / 'app'
+    [:view, :model, :controller, :helper, :mailer, :part].each do |type|
+      <%= module_name %>.app_dir_for(type).should == app_path / "#{type}s"
+    end
+    public_path = <%= module_name %>.app_dir_for(:public)
+    public_path.should == Merb.dir_for(:public) / 'slices' / '<%= base_name %>'
+    [:stylesheet, :javascript, :image].each do |type|
+      <%= module_name %>.app_dir_for(type).should == public_path / "#{type}s"
+    end
+  end
+  
+  it "should have a public_dir_for method" do
+    public_path = <%= module_name %>.public_dir_for(:public)
+    public_path.should == '/slices' / '<%= base_name %>'
+    [:stylesheet, :javascript, :image].each do |type|
+      <%= module_name %>.public_dir_for(type).should == public_path / "#{type}s"
+    end
+  end
+  
+  it "should have a public_path_for method" do
+    public_path = <%= module_name %>.public_dir_for(:public)
+    <%= module_name %>.public_path_for("path", "to", "file").should == public_path / "path" / "to" / "file"
+    [:stylesheet, :javascript, :image].each do |type|
+      <%= module_name %>.public_path_for(type, "path", "to", "file").should == public_path / "#{type}s" / "path" / "to" / "file"
+    end
+  end
+  
+  it "should have a app_path_for method" do
+    <%= module_name %>.app_path_for("path", "to", "file").should == <%= module_name %>.app_dir_for(:root) / "path" / "to" / "file"
+    <%= module_name %>.app_path_for(:controller, "path", "to", "file").should == <%= module_name %>.app_dir_for(:controller) / "path" / "to" / "file"
+  end
+  
+  it "should have a slice_path_for method" do
+    <%= module_name %>.slice_path_for("path", "to", "file").should == <%= module_name %>.dir_for(:root) / "path" / "to" / "file"
+    <%= module_name %>.slice_path_for(:controller, "path", "to", "file").should == <%= module_name %>.dir_for(:controller) / "path" / "to" / "file"
+  end
+  
+  it "should keep a list of path component types to use when copying files" do
+    (<%= module_name %>.mirrored_components & <%= module_name %>.slice_paths.keys).length.should == <%= module_name %>.mirrored_components.length
+  end
+  
+end

data/templates/application/slice/full/spec/controllers/main_spec.rb

@@ -0,0 +1,61 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe "<%= module_name %>::Main (controller)" do
+  
+  # Feel free to remove the specs below
+  
+  before :all do
+    Merb::Router.prepare { |r| r.add_slice(:<%= module_name %>) } if standalone?
+  end
+  
+  after :all do
+    Merb::Router.reset! if standalone?
+  end
+  
+  it "should have access to the slice module" do
+    controller = dispatch_to(<%= module_name %>::Main, :index)
+    controller.slice.should == <%= module_name %>
+    controller.slice.should == <%= module_name %>::Main.slice
+  end
+  
+  it "should have an index action" do
+    controller = dispatch_to(<%= module_name %>::Main, :index)
+    controller.status.should == 200
+    controller.body.should contain('<%= module_name %>')
+  end
+  
+  it "should work with the default route" do
+    controller = get("/<%= base_name %>/main/index")
+    controller.should be_kind_of(<%= module_name %>::Main)
+    controller.action_name.should == 'index'
+  end
+  
+  it "should work with the example named route" do
+    controller = get("/<%= base_name %>/index.html")
+    controller.should be_kind_of(<%= module_name %>::Main)
+    controller.action_name.should == 'index'
+  end
+  
+  it "should have routes in <%= module_name %>.routes" do
+    <%= module_name %>.routes.should_not be_empty
+  end
+  
+  it "should have a slice_url helper method for slice-specific routes" do
+    controller = dispatch_to(<%= module_name %>::Main, 'index')
+    controller.slice_url(:action => 'show', :format => 'html').should == "/<%= base_name %>/main/show.html"
+    controller.slice_url(:<%= underscored_name %>_index, :format => 'html').should == "/<%= base_name %>/index.html"
+  end
+  
+  it "should have helper methods for dealing with public paths" do
+    controller = dispatch_to(<%= module_name %>::Main, :index)
+    controller.public_path_for(:image).should == "/slices/<%= base_name %>/images"
+    controller.public_path_for(:javascript).should == "/slices/<%= base_name %>/javascripts"
+    controller.public_path_for(:stylesheet).should == "/slices/<%= base_name %>/stylesheets"
+  end
+  
+  it "should have a slice-specific _template_root" do
+    <%= module_name %>::Main._template_root.should == <%= module_name %>.dir_for(:view)
+    <%= module_name %>::Main._template_root.should == <%= module_name %>::Application._template_root
+  end
+
+end

data/templates/application/slice/full/spec/spec_helper.rb

@@ -0,0 +1,44 @@
+require 'rubygems'
+require 'merb-core'
+require 'merb-slices'
+require 'spec'
+
+# Add <%= base_name %>.rb to the search path
+Merb::Plugins.config[:merb_slices][:auto_register] = true
+Merb::Plugins.config[:merb_slices][:search_path]   = File.join(File.dirname(__FILE__), '..', 'lib', '<%= base_name %>.rb')
+
+# Using Merb.root below makes sure that the correct root is set for
+# - testing standalone, without being installed as a gem and no host application
+# - testing from within the host application; its root will be used
+Merb.start_environment(
+  :testing => true, 
+  :adapter => 'runner', 
+  :environment => ENV['MERB_ENV'] || 'test',
+  :merb_root => Merb.root,
+  :session_store => 'memory'
+)
+
+module Merb
+  module Test
+    module SliceHelper
+      
+      # The absolute path to the current slice
+      def current_slice_root
+        @current_slice_root ||= File.expand_path(File.join(File.dirname(__FILE__), '..'))
+      end
+      
+      # Whether the specs are being run from a host application or standalone
+      def standalone?
+        Merb.root == ::<%= module_name %>.root
+      end
+      
+    end
+  end
+end
+
+Spec::Runner.configure do |config|
+  config.include(Merb::Test::ViewHelper)
+  config.include(Merb::Test::RouteHelper)
+  config.include(Merb::Test::ControllerHelper)
+  config.include(Merb::Test::SliceHelper)
+end

data/templates/application/slice/full/stubs/app/controllers/application.rb

@@ -0,0 +1,2 @@
+class <%= module_name %>::Application < Merb::Controller
+end

data/templates/application/slice/full/stubs/app/controllers/main.rb

@@ -0,0 +1,2 @@
+class <%= module_name %>::Main < <%= module_name %>::Application
+end

data/templates/application/slice/thin/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) <%= Time.now.year %> YOUR NAME
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/templates/application/slice/thin/README

@@ -0,0 +1,130 @@
+<%= module_name %>
+<%= "=" * module_name.size %>
+
+A thin slice for the Merb framework.
+
+------------------------------------------------------------------------------
+
+<%= base_name %>
+|-- LICENSE
+|-- README
+|-- Rakefile [1]
+|-- TODO
+|-- application.rb [2]
+|-- lib
+|   |-- <%= base_name %>
+|   |   |-- merbtasks.rb [3]
+|   |   `-- slicetasks.rb [4]
+|   `-- <%= base_name %>.rb [5]
+|-- public [6]
+|   |-- javascripts
+|   |   `-- master.js
+|   `-- stylesheets
+|       `-- master.css
+|-- stubs [7]
+|   `-- application.rb
+`-- views [8]
+    |-- layout
+    |   `-- <%= underscored_name %>.html.erb [9]
+    `-- main
+        `-- index.html.erb
+
+
+1. Rake tasks to package/install the gem - edit this to modify the manifest.
+2. The slice application in a single file: controllers, models, helper methods.
+3. Standard rake tasks available to your application.
+4. Your custom application rake tasks.
+5. The main slice file - contains all slice setup logic/config.
+6. Public assets you (optionally) install using rake slices:my_slice:install
+7. Stubs of classes/views/files for the end-user to override - usually these 
+   mimic the files in app/ and/or public/; use rake slices:<%= underscored_name %>:stubs to
+   get started with the override stubs. Also, slices:<%= underscored_name %>:patch will
+   copy over views to override in addition to the files found in /stubs.
+8. A thin slice stores its views seperately.
+9. The default layout, as specified in Merb::Slices::config[:my_slice][:layout]
+   change this to :application to use the app's layout.
+   
+   
+To see all available tasks for <%= module_name %> run:
+
+rake -T slices:<%= underscored_name %>
+
+------------------------------------------------------------------------------
+
+Instructions for installation:
+
+file: config/init.rb
+
+# add the slice as a regular dependency
+
+dependency '<%= base_name %>'
+
+# if needed, configure which slices to load and in which order
+
+Merb::Plugins.config[:merb_slices] = { :queue => ["<%= module_name %>", ...] }
+
+# optionally configure the plugins in a before_app_loads callback
+
+Merb::BootLoader.before_app_loads do
+  
+  Merb::Slices::config[:<%= underscored_name %>][:option] = value
+  
+end
+
+file: config/router.rb
+
+# example: /<%= base_name %>/:controller/:action/:id
+
+r.add_slice(:<%= module_name %>)
+
+# example: /foo/:controller/:action/:id
+
+r.add_slice(:<%= module_name %>, 'foo') # same as :path => 'foo'
+
+# example: /:lang/:controller/:action/:id (with :a param set)
+
+r.add_slice(:<%= module_name %>, :path => ':lang', :params => { :a => 'b' })
+
+# example: /:controller/:action/:id
+
+r.slice(:<%= module_name %>)
+
+Normally you should also run the following rake task:
+
+rake slices:<%= underscored_name %>:install
+
+------------------------------------------------------------------------------
+
+About Slices
+============
+
+Merb-Slices is a Merb plugin for using and creating application 'slices' which
+help you modularize your application. Usually these are reuseable extractions
+from your main app. In effect, a Slice is just like a regular Merb MVC
+application, both in functionality as well as in structure.
+
+When you generate a Slice stub structure, a module is setup to serve as a
+namespace for your controller, models, helpers etc. This ensures maximum
+encapsulation. You could say a Slice is a mixture between a Merb plugin (a
+Gem) and a Merb application, reaping the benefits of both.
+
+A host application can 'mount' a Slice inside the router, which means you have
+full over control how it integrates. By default a Slice's routes are prefixed
+by its name (a router :namespace), but you can easily provide your own prefix
+or leave it out, mounting it at the root of your url-schema. You can even
+mount a Slice multiple times and give extra parameters to customize an
+instance's behaviour.
+
+A Slice's Application controller uses controller_for_slice to setup slice
+specific behaviour, which mainly affects cascaded view handling. Additionaly,
+this method is available to any kind of controller, so it can be used for
+Merb Mailer too for example.
+
+There are many ways which let you customize a Slice's functionality and
+appearance without ever touching the Gem-level code itself. It's not only easy
+to add template/layout overrides, you can also add/modify controllers, models
+and other runtime code from within the host application.
+
+To create your own Slice run this (somewhere outside of your merb app):
+
+$ merb-gen slice <your-lowercase-slice-name>

data/templates/application/slice/thin/Rakefile

@@ -0,0 +1,46 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+require 'merb-core/version'
+require 'merb-core/tasks/merb_rake_helper'
+
+NAME = "<%= base_name %>"
+AUTHOR = "Your Name"
+EMAIL = "Your Email"
+HOMEPAGE = "http://merbivore.com/"
+SUMMARY = "Merb Slice that provides ..."
+GEM_VERSION = "<%= Merb::VERSION %>"
+
+spec = Gem::Specification.new do |s|
+  s.rubyforge_project = 'merb'
+  s.name = NAME
+  s.version = GEM_VERSION
+  s.platform = Gem::Platform::RUBY
+  s.has_rdoc = true
+  s.extra_rdoc_files = ["README", "LICENSE", 'TODO']
+  s.summary = SUMMARY
+  s.description = s.summary
+  s.author = AUTHOR
+  s.email = EMAIL
+  s.homepage = HOMEPAGE
+  s.add_dependency('merb-slices', '>= <%= Merb::VERSION %>')
+  s.require_path = 'lib'
+  s.files = %w(LICENSE README Rakefile TODO application.rb) + Dir.glob("{lib,public,views,stubs}/**/*")
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+desc "Install <%= module_name %> as a gem"
+task :install => [:package] do
+  sh %{#{sudo} gem install pkg/#{NAME}-#{GEM_VERSION} --no-update-sources}
+end
+
+namespace :jruby do
+
+  desc "Run :package and install the resulting .gem with jruby"
+  task :install => :package do
+    sh %{#{sudo} jruby -S gem install #{install_home} pkg/#{NAME}-#{GEM_VERSION}.gem --no-rdoc --no-ri}
+  end
+  
+end