merb_screw_unit 0.9.4

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Yehuda Katz
+
+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/README

@@ -0,0 +1,170 @@
+MerbScrewUnit
+=============
+
+A slice for the Merb framework.
+
+------------------------------------------------------------------------------
+
+merb_screw_unit
+|-- LICENSE
+|-- README
+|-- Rakefile [1]
+|-- TODO
+|-- app [2]
+|   |-- controllers
+|   |   |-- application.rb
+|   |   `-- main.rb
+|   |-- helpers
+|   |   `-- application_helper.rb
+|   `-- views
+|       |-- layout
+|       |   `-- merb_screw_unit.html.erb [3]
+|       `-- main
+|           `-- index.html.erb
+|-- lib
+|   |-- merb_screw_unit
+|   |   |-- merbtasks.rb [4]
+|   |   `-- slicetasks.rb [5]
+|   `-- merb_screw_unit.rb [6]
+|-- log
+|   `-- merb_test.log
+|-- public [7]
+|   |-- javascripts 
+|   |   `-- master.js
+|   `-- stylesheets
+|       `-- master.css
+|-- spec [8]
+|   |-- merb_screw_unit_spec.rb
+|   |-- controllers
+|   |   `-- main_spec.rb
+|   `-- spec_helper.rb
+`-- stubs [9]
+    `-- app
+        `-- controllers
+            |-- application.rb
+            `-- main.rb
+
+
+1. Rake tasks to package/install the gem - edit this to modify the manifest.
+2. The slice application: controllers, models, helpers, views.
+3. The default layout, as specified in Merb::Slices::config[:merb_screw_unit][:layout]
+   change this to :application to use the app's layout.
+4. Standard rake tasks available to your application.
+5. Your custom application rake tasks.
+6. The main slice file - contains all slice setup logic/config.
+7. Public assets you (optionally) install using rake slices:merb_screw_unit:install
+8. Specs for basis slice behaviour - you usually adapt these for your slice.
+9. Stubs of classes/views/files for the end-user to override - usually these 
+   mimic the files in app/ and/or public/; use rake slices:merb_screw_unit:stubs to
+   get started with the override stubs. Also, slices:merb_screw_unit:patch will
+   copy over views to override in addition to the files found in /stubs.
+   
+
+To see all available tasks for MerbScrewUnit run:
+
+rake -T slices:merb_screw_unit
+
+------------------------------------------------------------------------------
+
+Instructions for installation:
+
+file: config/init.rb
+
+# add the slice as a regular dependency
+
+dependency 'merb_screw_unit'
+
+# if needed, configure which slices to load and in which order
+
+Merb::Plugins.config[:merb_slices] = { :queue => ["MerbScrewUnit", ...] }
+
+# optionally configure the plugins in a before_app_loads callback
+
+Merb::BootLoader.before_app_loads do
+  
+  Merb::Slices::config[:merb_screw_unit][:option] = value
+  
+end
+
+file: config/router.rb
+
+# example: /merb_screw_unit/:controller/:action/:id
+
+r.add_slice(:MerbScrewUnit)
+
+# example: /foo/:controller/:action/:id
+
+r.add_slice(:MerbScrewUnit, 'foo') # same as :path => 'foo'
+
+# example: /:lang/:controller/:action/:id (with :a param set)
+
+r.add_slice(:MerbScrewUnit, :path => ':lang', :params => { :a => 'b' })
+
+# example: /:controller/:action/:id
+
+r.slice(:MerbScrewUnit)
+
+Normally you should also run the following rake task:
+
+rake slices:merb_screw_unit:install
+
+------------------------------------------------------------------------------
+
+You can put your application-level overrides in:
+
+host-app/slices/merb_screw_unit/app - controllers, models, views ...
+
+Templates are located in this order:
+
+1. host-app/slices/merb_screw_unit/app/views/*
+2. gems/merb_screw_unit/app/views/*
+3. host-app/app/views/*
+
+You can use the host application's layout by configuring the
+merb_screw_unit slice in a before_app_loads block:
+
+Merb::Slices.config[:merb_screw_unit] = { :layout => :application }
+
+By default :merb_screw_unit is used. If you need to override
+stylesheets or javascripts, just specify your own files in your layout
+instead/in addition to the ones supplied (if any) in 
+host-app/public/slices/merb_screw_unit.
+
+In any case don't edit those files directly as they may be clobbered any time
+rake merb_screw_unit:install is run.
+
+------------------------------------------------------------------------------
+
+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/Rakefile

@@ -0,0 +1,70 @@
+require 'rubygems'
+require 'rubygems/specification'
+require 'rake/gempackagetask'
+require "extlib"
+require 'merb-core/tasks/merb_rake_helper'
+require "spec/rake/spectask"
+
+##############################################################################
+# Package && release
+##############################################################################
+RUBY_FORGE_PROJECT  = "merb"
+PROJECT_URL         = "http://merbivore.com"
+PROJECT_SUMMARY     = "Merb Slice that provides support for Screw.Unit testing"
+PROJECT_DESCRIPTION = PROJECT_SUMMARY
+
+GEM_AUTHOR = "Yehuda Katz"
+GEM_EMAIL  = "ykatz@engineyard.com"
+
+GEM_NAME    = "merb_screw_unit"
+PKG_BUILD   = ENV['PKG_BUILD'] ? '.' + ENV['PKG_BUILD'] : ''
+GEM_VERSION = (Merb::MORE_VERSION rescue "0.9.4") + PKG_BUILD
+
+RELEASE_NAME    = "REL #{GEM_VERSION}"
+
+require "extlib/tasks/release"
+
+spec = Gem::Specification.new do |s|
+  s.rubyforge_project = RUBY_FORGE_PROJECT
+  s.name = GEM_NAME
+  s.version = GEM_VERSION
+  s.platform = Gem::Platform::RUBY
+  s.has_rdoc = true
+  s.extra_rdoc_files = ["README", "LICENSE"]
+  s.summary = PROJECT_SUMMARY
+  s.description = PROJECT_DESCRIPTION
+  s.author = GEM_AUTHOR
+  s.email = GEM_EMAIL
+  s.homepage = PROJECT_URL
+  s.add_dependency('merb-core', '>= 0.9.4')
+  s.add_dependency('merb-slices', '>= 0.9.4')
+  s.require_path = 'lib'
+  s.files = %w(LICENSE README Rakefile TODO) + Dir.glob("{lib,spec,app,public,stubs}/**/*")
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+desc "create a gemspec file"
+task :make_spec do
+  File.open("#{NAME}.gemspec", "w") do |file|
+    file.puts spec.to_ruby
+  end
+end
+
+##############################################################################
+# Installation
+##############################################################################
+
+desc "Install the gem"
+task :install => [:package] do
+  sh %{#{sudo} gem install #{install_home} pkg/#{GEM_NAME}-#{GEM_VERSION} --no-update-sources}
+end
+
+namespace :jruby do
+"Run :package and install the resulting .gem with jruby"
+  task :install => :package do
+    sh %{#{sudo} jruby -S gem install #{install_home} pkg/#{GEM_NAME}-#{GEM_VERSION}.gem --no-rdoc --no-ri}
+  end
+end

data/TODO

@@ -0,0 +1,15 @@
+TODO:
+
+- Fix MerbScrewUnit.description and MerbScrewUnit.version
+- Fix LICENSE with your name
+- Fix Rakefile with your name and contact info
+- Add your code to lib/merb_screw_unit.rb
+- Add your Merb rake tasks to lib/merb_screw_unit/merbtasks.rb
+
+Remove anything that you don't need:
+
+- app/controllers/main.rb MerbScrewUnit::Main controller
+- app/views/layout/merb_screw_unit.html.erb
+- spec/controllers/main_spec.rb controller specs
+- public/* any public files
+- stubs/* any stub files

data/app/controllers/application.rb

@@ -0,0 +1,5 @@
+class MerbScrewUnit::Application < Merb::Controller
+  
+  controller_for_slice
+  
+end

data/app/controllers/main.rb

@@ -0,0 +1,7 @@
+class MerbScrewUnit::Main < MerbScrewUnit::Application
+  
+  def index
+    render
+  end
+  
+end

data/app/helpers/application_helper.rb

@@ -0,0 +1,76 @@
+module Merb
+  module MerbScrewUnit
+    module ApplicationHelper
+      
+      # @param *segments<Array[#to_s]> Path segments to append.
+      #
+      # @return <String> 
+      #  A path relative to the public directory, with added segments.
+      def image_path(*segments)
+        public_path_for(:image, *segments)
+      end
+      
+      # @param *segments<Array[#to_s]> Path segments to append.
+      #
+      # @return <String> 
+      #  A path relative to the public directory, with added segments.
+      def javascript_path(*segments)
+        public_path_for(:javascript, *segments)
+      end
+      
+      def js_include_tag(*files)
+        files.map do |file|
+          super(javascript_path(file))
+        end.join
+      end
+
+      # @param *segments<Array[#to_s]> Path segments to append.
+      #
+      # @return <String> 
+      #  A path relative to the public directory, with added segments.
+      def stylesheet_path(*segments)
+        public_path_for(:stylesheet, *segments)
+      end
+
+      def css_include_tag(*files)
+        files.map do |file|
+          super(stylesheet_path(file))
+        end.join        
+      end
+      
+      # Construct a path relative to the public directory
+      # 
+      # @param <Symbol> The type of component.
+      # @param *segments<Array[#to_s]> Path segments to append.
+      #
+      # @return <String> 
+      #  A path relative to the public directory, with added segments.
+      def public_path_for(type, *segments)
+        ::MerbScrewUnit.public_path_for(type, *segments)
+      end
+      
+      # Construct an app-level path.
+      # 
+      # @param <Symbol> The type of component.
+      # @param *segments<Array[#to_s]> Path segments to append.
+      #
+      # @return <String> 
+      #  A path within the host application, with added segments.
+      def app_path_for(type, *segments)
+        ::MerbScrewUnit.app_path_for(type, *segments)
+      end
+      
+      # Construct a slice-level path.
+      # 
+      # @param <Symbol> The type of component.
+      # @param *segments<Array[#to_s]> Path segments to append.
+      #
+      # @return <String> 
+      #  A path within the slice source (Gem), with added segments.
+      def slice_path_for(type, *segments)
+        ::MerbScrewUnit.slice_path_for(type, *segments)
+      end
+      
+    end
+  end
+end

data/app/views/layout/merb_screw_unit.html.erb

@@ -0,0 +1,37 @@
+<html>
+  <head>
+    <%= js_include_tag "jquery-1.2.3", "jquery.fn", "jquery.print", "screw.builder", 
+                       "screw.matchers", "screw.events", "screw.behaviors",
+                       "screw.mock" %>
+        
+    <%= css_include_tag "screw.css" %>
+  </head>
+  <body>
+    <iframe id="dom" src="<%= @spec_url %>?<%= MD5.hexdigest(Time.now.to_s) %>" style="display: none"></iframe>  
+    <script type="text/javascript">
+      Screw.Unit(function() {
+        iframeWindow = $("#dom").contents()[0].defaultView;
+        iframeWindow.XMLHttpRequest = Screw.XHR;
+        runLivequeries = function() {
+          if(iframeWindow.$.livequery) {
+            queries = iframeWindow.$.livequery.queries;
+            for(var i = 0; i<queries.length;i++) {
+              queries[i].run();
+            }
+          }
+        };
+        
+        before(function() {          
+          $ = iframeWindow.$;
+          $.ajaxSettings.async = false;
+          $.fn.fireEvent = function(event) {
+            runLivequeries();
+           	this.trigger(event);
+            return this;
+          };
+        })
+        <%= catch_content :for_layout %>
+      });
+    </script>
+  </body>
+</html>

data/app/views/main/index.html.erb

@@ -0,0 +1 @@
+<strong><%= slice.description %></strong> (v. <%= slice.version %>)

data/lib/merb_screw_unit/merbtasks.rb

@@ -0,0 +1,166 @@
+namespace :slices do
+  namespace :merb_screw_unit do
+  
+    desc "Install MerbScrewUnit"
+    task :install => [:preflight, :setup_directories, :copy_assets, :migrate]
+    
+    desc "Test for any dependencies"
+    task :preflight do # see slicetasks.rb
+    end
+  
+    desc "Setup directories"
+    task :setup_directories do
+      puts "Creating directories for host application"
+      MerbScrewUnit.mirrored_components.each do |type|
+        if File.directory?(MerbScrewUnit.dir_for(type))
+          if !File.directory?(dst_path = MerbScrewUnit.app_dir_for(type))
+            relative_path = dst_path.relative_path_from(Merb.root)
+            puts "- creating directory :#{type} #{File.basename(Merb.root) / relative_path}"
+            mkdir_p(dst_path)
+          end
+        end
+      end
+    end
+    
+    desc "Copy stub files to host application"
+    task :stubs do
+      puts "Copying stubs for MerbScrewUnit - resolves any collisions"
+      copied, preserved = MerbScrewUnit.mirror_stubs!
+      puts "- no files to copy" if copied.empty? && preserved.empty?
+      copied.each { |f| puts "- copied #{f}" }
+      preserved.each { |f| puts "! preserved override as #{f}" }
+    end
+    
+    desc "Copy stub files and views to host application"
+    task :patch => [ "stubs", "freeze:views" ]
+  
+    desc "Copy public assets to host application"
+    task :copy_assets do
+      puts "Copying assets for MerbScrewUnit - resolves any collisions"
+      copied, preserved = MerbScrewUnit.mirror_public!
+      puts "- no files to copy" if copied.empty? && preserved.empty?
+      copied.each { |f| puts "- copied #{f}" }
+      preserved.each { |f| puts "! preserved override as #{f}" }
+    end
+    
+    desc "Migrate the database"
+    task :migrate do # see slicetasks.rb
+    end
+    
+    desc "Freeze MerbScrewUnit into your app (only merb_screw_unit/app)" 
+    task :freeze => [ "freeze:app" ]
+
+    namespace :freeze do
+      
+      desc "Freezes MerbScrewUnit by installing the gem into application/gems using merb-freezer"
+      task :gem do
+        begin
+          Object.const_get(:Freezer).freeze(ENV["GEM"] || "merb_screw_unit", ENV["UPDATE"], ENV["MODE"] || 'rubygems')
+        rescue NameError
+          puts "! dependency 'merb-freezer' missing"
+        end
+      end
+      
+      desc "Freezes MerbScrewUnit by copying all files from merb_screw_unit/app to your application"
+      task :app do
+        puts "Copying all merb_screw_unit/app files to your application - resolves any collisions"
+        copied, preserved = MerbScrewUnit.mirror_app!
+        puts "- no files to copy" if copied.empty? && preserved.empty?
+        copied.each { |f| puts "- copied #{f}" }
+        preserved.each { |f| puts "! preserved override as #{f}" }
+      end
+      
+      desc "Freeze all views into your application for easy modification" 
+      task :views do
+        puts "Copying all view templates to your application - resolves any collisions"
+        copied, preserved = MerbScrewUnit.mirror_files_for :view
+        puts "- no files to copy" if copied.empty? && preserved.empty?
+        copied.each { |f| puts "- copied #{f}" }
+        preserved.each { |f| puts "! preserved override as #{f}" }
+      end
+      
+      desc "Freeze all models into your application for easy modification" 
+      task :models do
+        puts "Copying all models to your application - resolves any collisions"
+        copied, preserved = MerbScrewUnit.mirror_files_for :model
+        puts "- no files to copy" if copied.empty? && preserved.empty?
+        copied.each { |f| puts "- copied #{f}" }
+        preserved.each { |f| puts "! preserved override as #{f}" }
+      end
+      
+      desc "Freezes MerbScrewUnit as a gem and copies over merb_screw_unit/app"
+      task :app_with_gem => [:gem, :app]
+      
+      desc "Freezes MerbScrewUnit by unpacking all files into your application"
+      task :unpack do
+        puts "Unpacking MerbScrewUnit files to your application - resolves any collisions"
+        copied, preserved = MerbScrewUnit.unpack_slice!
+        puts "- no files to copy" if copied.empty? && preserved.empty?
+        copied.each { |f| puts "- copied #{f}" }
+        preserved.each { |f| puts "! preserved override as #{f}" }
+      end
+      
+    end
+    
+    desc "Run slice specs within the host application context"
+    task :spec => [ "spec:explain", "spec:default" ]
+    
+    namespace :spec do
+      
+      slice_root = File.expand_path(File.join(File.dirname(__FILE__), '..', '..'))
+      
+      task :explain do
+        puts "\nNote: By running MerbScrewUnit specs inside the application context any\n" +
+             "overrides could break existing specs. This isn't always a problem,\n" +
+             "especially in the case of views. Use these spec tasks to check how\n" +
+             "well your application conforms to the original slice implementation."
+      end
+      
+      Spec::Rake::SpecTask.new('default') do |t|
+        t.spec_opts = ["--format", "specdoc", "--colour"]
+        t.spec_files = Dir["#{slice_root}/spec/**/*_spec.rb"].sort
+      end
+
+      desc "Run all model specs, run a spec for a specific Model with MODEL=MyModel"
+      Spec::Rake::SpecTask.new('model') do |t|
+        t.spec_opts = ["--format", "specdoc", "--colour"]
+        if(ENV['MODEL'])
+          t.spec_files = Dir["#{slice_root}/spec/models/**/#{ENV['MODEL']}_spec.rb"].sort
+        else
+          t.spec_files = Dir["#{slice_root}/spec/models/**/*_spec.rb"].sort
+        end
+      end
+
+      desc "Run all controller specs, run a spec for a specific Controller with CONTROLLER=MyController"
+      Spec::Rake::SpecTask.new('controller') do |t|
+        t.spec_opts = ["--format", "specdoc", "--colour"]
+        if(ENV['CONTROLLER'])
+          t.spec_files = Dir["#{slice_root}/spec/controllers/**/#{ENV['CONTROLLER']}_spec.rb"].sort
+        else    
+          t.spec_files = Dir["#{slice_root}/spec/controllers/**/*_spec.rb"].sort
+        end
+      end
+
+      desc "Run all view specs, run specs for a specific controller (and view) with CONTROLLER=MyController (VIEW=MyView)"
+      Spec::Rake::SpecTask.new('view') do |t|
+        t.spec_opts = ["--format", "specdoc", "--colour"]
+        if(ENV['CONTROLLER'] and ENV['VIEW'])
+          t.spec_files = Dir["#{slice_root}/spec/views/**/#{ENV['CONTROLLER']}/#{ENV['VIEW']}*_spec.rb"].sort
+        elsif(ENV['CONTROLLER'])
+          t.spec_files = Dir["#{slice_root}/spec/views/**/#{ENV['CONTROLLER']}/*_spec.rb"].sort
+        else
+          t.spec_files = Dir["#{slice_root}/spec/views/**/*_spec.rb"].sort
+        end
+      end
+
+      desc "Run all specs and output the result in html"
+      Spec::Rake::SpecTask.new('html') do |t|
+        t.spec_opts = ["--format", "html"]
+        t.libs = ['lib', 'server/lib' ]
+        t.spec_files = Dir["#{slice_root}/spec/**/*_spec.rb"].sort
+      end
+      
+    end
+    
+  end
+end

data/lib/merb_screw_unit/slicetasks.rb

@@ -0,0 +1,18 @@
+namespace :slices do
+  namespace :merb_screw_unit do 
+    
+    # add your own merb_screw_unit 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/lib/merb_screw_unit.rb

@@ -0,0 +1,84 @@
+if defined?(Merb::Plugins)
+  
+  module Spec; end
+
+  $:.unshift File.dirname(__FILE__)
+
+  load_dependency 'merb-slices'
+  load_dependency 'merb-assets'
+  require 'md5'
+  
+  Merb::Plugins.add_rakefiles "merb_screw_unit/merbtasks", "merb_screw_unit/slicetasks"
+
+  # Register the Slice for the current host application
+  Merb::Slices::register(__FILE__)
+  
+  # Slice configuration - set this in a before_app_loads callback.
+  # By default a Slice uses its own layout, so you can swicht to 
+  # the main application layout or no layout at all if needed.
+  # 
+  # Configuration options:
+  # :layout - the layout to use; defaults to :merb_screw_unit
+  # :mirror - which path component types to use on copy operations; defaults to all
+  Merb::Slices::config[:merb_screw_unit][:layout] ||= :merb_screw_unit
+  
+  # All Slice code is expected to be namespaced inside a module
+  module MerbScrewUnit
+    
+    # Slice metadata
+    self.description = "MerbScrewUnit is a chunky Merb slice!"
+    self.version = "0.0.1"
+    self.author = "YOUR NAME"
+    
+    # Stub classes loaded hook - runs before LoadClasses BootLoader
+    # right after a slice's classes have been loaded internally.
+    def self.loaded
+    end
+    
+    # Initialization hook - runs before AfterAppLoads BootLoader
+    def self.init
+    end
+    
+    # Activation hook - runs after AfterAppLoads BootLoader
+    def self.activate
+    end
+    
+    # Deactivation hook - triggered by Merb::Slices.deactivate(MerbScrewUnit)
+    def self.deactivate
+    end
+    
+    # Setup routes inside the host application
+    #
+    # @param scope<Merb::Router::Behaviour>
+    #  Routes will be added within this scope (namespace). In fact, any 
+    #  router behaviour is a valid namespace, so you can attach
+    #  routes at any level of your router setup.
+    #
+    # @note prefix your named routes with :merb_screw_unit_
+    #   to avoid potential conflicts with global named routes.
+    def self.setup_router(scope)
+      # example of a named route
+      scope.match('/index.:format').to(:controller => 'main', :action => 'index').name(:merb_screw_unit_index)
+      scope.match('/:controller/:action')
+    end
+    
+  end
+  
+  # Setup the slice layout for MerbScrewUnit
+  #
+  # Use MerbScrewUnit.push_path and MerbScrewUnit.push_app_path
+  # to set paths to merb_screw_unit-level and app-level paths. Example:
+  #
+  # MerbScrewUnit.push_path(:application, MerbScrewUnit.root)
+  # MerbScrewUnit.push_app_path(:application, Merb.root / 'slices' / 'merb_screw_unit')
+  # ...
+  #
+  # Any component path that hasn't been set will default to MerbScrewUnit.root
+  #
+  # Or just call setup_default_structure! to setup a basic Merb MVC structure.
+  MerbScrewUnit.setup_default_structure!
+  
+  # Add dependencies for other MerbScrewUnit classes below. Example:
+  # dependency "merb_screw_unit/other"
+  
+end