merb-slices 0.9.7 → 0.9.8

data/spec/slices/thin-test-slice/Rakefile

@@ -0,0 +1,43 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+
+require 'merb-core'
+require 'merb-core/tasks/merb'
+
+GEM_NAME = "thin-test-slice"
+AUTHOR = "Your Name"
+EMAIL = "Your Email"
+HOMEPAGE = "http://merbivore.com/"
+SUMMARY = "Merb Slice that provides ..."
+GEM_VERSION = "0.9.8"
+
+spec = Gem::Specification.new do |s|
+  s.rubyforge_project = 'merb'
+  s.name = GEM_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', '>= 0.9.8')
+  s.require_path = 'lib'
+  s.files = %w(LICENSE README Rakefile TODO application.rb) + Dir.glob("{lib,spec,app,public,stubs,views}/**/*")
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+desc "Install the gem"
+task :install do
+  Merb::RakeHelper.install(GEM_NAME, :version => GEM_VERSION)
+end
+
+desc "Uninstall the gem"
+task :uninstall do
+  Merb::RakeHelper.uninstall(GEM_NAME, :version => GEM_VERSION)
+end

data/spec/slices/thin-test-slice/TODO

@@ -0,0 +1,7 @@
+TODO:
+
+- Fix ThinTestSlice.description and ThinTestSlice.version
+- Fix LICENSE with your name
+- Fix Rakefile with your name and contact info
+- Add your code to lib/thin-test-slice.rb
+- Add your Merb rake tasks to lib/thin-test-slice/merbtasks.rb

data/spec/slices/thin-test-slice/application.rb

@@ -0,0 +1,36 @@
+module ThinTestSlice
+  
+  # All Slice code is expected to be namespaced inside this module.
+  
+  class Application < Merb::Controller
+    
+    controller_for_slice
+    
+    private
+    
+    # Construct a path relative to the public directory
+    def public_path_for(type, *segments)
+      ::ThinTestSlice.public_path_for(type, *segments)
+    end
+    
+    # Construct an app-level path.
+    def app_path_for(type, *segments)
+      ::ThinTestSlice.app_path_for(type, *segments)
+    end
+    
+    # Construct a slice-level path
+    def slice_path_for(type, *segments)
+      ::ThinTestSlice.slice_path_for(type, *segments)
+    end
+    
+  end
+  
+  class Main < Application
+    
+    def index
+      render "#{slice.description} (v. #{slice.version})"
+    end
+    
+  end
+  
+end

data/spec/slices/thin-test-slice/lib/thin-test-slice.rb

@@ -0,0 +1,93 @@
+if defined?(Merb::Plugins)
+
+  $:.unshift File.dirname(__FILE__)
+
+  load_dependency 'merb-slices'
+  Merb::Plugins.add_rakefiles "thin-test-slice/merbtasks", "thin-test-slice/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.
+  Merb::Slices::config[:thin_test_slice][:layout] ||= :thin_test_slice
+  
+  # All Slice code is expected to be namespaced inside a module
+  module ThinTestSlice
+    
+    # Slice metadata
+    self.description = "ThinTestSlice is a thin 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(ThinTestSlice)
+    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 :thin_test_slice_
+    #   to avoid potential conflicts with global named routes.
+    def self.setup_router(scope)
+    end
+    
+    # This sets up a thin slice's structure.
+    def self.setup_default_structure!
+      self.push_app_path(:root, Merb.root / 'slices' / self.identifier, nil)
+      
+      self.push_path(:stub, root_path('stubs'), nil)
+      self.push_app_path(:stub, app_dir_for(:root), nil)
+      
+      self.push_path(:application, root, 'application.rb')
+      self.push_app_path(:application, app_dir_for(:root), 'application.rb')
+      
+      self.push_path(:view, dir_for(:application) / "views")
+      self.push_app_path(:view, app_dir_for(:application) / "views")
+      
+      self.push_path(:public, root_path('public'), nil)
+      self.push_app_path(:public, Merb.root / 'public' / 'slices' / self.identifier, nil)
+      
+      public_components.each do |component|
+        self.push_path(component, dir_for(:public) / "#{component}s", nil)
+        self.push_app_path(component, app_dir_for(:public) / "#{component}s", nil)
+      end
+    end
+    
+  end
+  
+  # Setup the slice layout for ThinTestSlice
+  #
+  # Use ThinTestSlice.push_path and ThinTestSlice.push_app_path
+  # to set paths to thin-test-slice-level and app-level paths. Example:
+  #
+  # ThinTestSlice.push_path(:application, ThinTestSlice.root)
+  # ThinTestSlice.push_app_path(:application, Merb.root / 'slices' / 'thin-test-slice')
+  # ...
+  #
+  # Any component path that hasn't been set will default to ThinTestSlice.root
+  #
+  # For a thin slice we just add application.rb, :view and :public locations.
+  ThinTestSlice.setup_default_structure!
+  
+  # Add dependencies for other ThinTestSlice classes below. Example:
+  # dependency "thin-test-slice/other"
+  
+end

data/spec/slices/thin-test-slice/lib/thin-test-slice/merbtasks.rb

@@ -0,0 +1,103 @@
+namespace :slices do
+  namespace :thin_test_slice do
+  
+    desc "Install ThinTestSlice"
+    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"
+      ThinTestSlice.mirrored_components.each do |type|
+        if File.directory?(ThinTestSlice.dir_for(type))
+          if !File.directory?(dst_path = ThinTestSlice.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 ThinTestSlice - resolves any collisions"
+      copied, preserved = ThinTestSlice.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 ThinTestSlice - resolves any collisions"
+      copied, preserved = ThinTestSlice.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 ThinTestSlice into your app (only thin-test-slice/app)" 
+    task :freeze => [ "freeze:app" ]
+
+    namespace :freeze do
+      
+      desc "Freezes ThinTestSlice by installing the gem into application/gems"
+      task :gem do
+        ENV["GEM"] ||= "thin-test-slice"
+        Rake::Task['slices:install_as_gem'].invoke
+      end
+      
+      desc "Freezes ThinTestSlice by copying all files from thin-test-slice/app to your application"
+      task :app do
+        puts "Copying all thin-test-slice/app files to your application - resolves any collisions"
+        copied, preserved = ThinTestSlice.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 = ThinTestSlice.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 = ThinTestSlice.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 ThinTestSlice as a gem and copies over thin-test-slice/app"
+      task :app_with_gem => [:gem, :app]
+      
+      desc "Freezes ThinTestSlice by unpacking all files into your application"
+      task :unpack do
+        puts "Unpacking ThinTestSlice files to your application - resolves any collisions"
+        copied, preserved = ThinTestSlice.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
+    
+  end
+end

data/spec/slices/thin-test-slice/lib/thin-test-slice/slicetasks.rb

@@ -0,0 +1,18 @@
+namespace :slices do
+  namespace :thin_test_slice do 
+    
+    # add your own thin-test-slice 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/spec/slices/thin-test-slice/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/spec/slices/thin-test-slice/stubs/application.rb

@@ -0,0 +1,9 @@
+module ThinTestSlice
+  
+  class Application < Merb::Controller    
+  end
+  
+  class Main < Application
+  end
+  
+end

data/spec/slices/thin-test-slice/views/layout/thin_test_slice.html.erb

@@ -0,0 +1,16 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-us" lang="en-us">
+  <head>
+    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
+    <title>Fresh ThinTestSlice Thin Slice</title>
+    <link href="<%= public_path_for :stylesheet, 'master.css' %>" type="text/css" charset="utf-8" rel="stylesheet" media="all" />
+    <script src="<%= public_path_for :javascript, 'master.js' %>" type="text/javascript" charset="utf-8"></script>
+  </head>
+  <!-- you can override this layout at slices/thin-test-slice/views/layout/thin_test_slice.html.erb -->
+  <body class="thin-test-slice-slice">
+  <div id="container">
+	  <h1>ThinTestSlice Thin Slice</h1>
+    <div id="main"><%= catch_content :for_layout %></div>
+  </div>
+  </body>
+</html>

data/spec/slices/thin-test-slice/views/main/index.html.erb

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

data/spec/slices/very-thin-test-slice/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 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/spec/slices/very-thin-test-slice/README

@@ -0,0 +1,110 @@
+VeryThinTestSlice
+=================
+
+A very thin slice for the Merb framework.
+
+------------------------------------------------------------------------------
+
+very-thin-test-slice
+|-- LICENSE
+|-- README
+|-- Rakefile [1]
+|-- TODO
+|-- application.rb [2]
+`-- lib
+    |-- very-thin-test-slice
+    |   |-- merbtasks.rb [3]
+    |   `-- slicetasks.rb [4]
+    `-- very-thin-test-slice.rb [5]
+
+
+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.
+
+
+To see all available tasks for VeryThinTestSlice run:
+
+rake -T slices:very_thin_test_slice
+
+------------------------------------------------------------------------------
+
+Instructions for installation:
+
+file: config/init.rb
+
+# add the slice as a regular dependency
+
+dependency 'very-thin-test-slice'
+
+# if needed, configure which slices to load and in which order
+
+Merb::Plugins.config[:merb_slices] = { :queue => ["VeryThinTestSlice", ...] }
+
+# optionally configure the plugins in a before_app_loads callback
+
+Merb::BootLoader.before_app_loads do
+  
+  Merb::Slices::config[:very_thin_test_slice][:option] = value
+  
+end
+
+file: config/router.rb
+
+# example: /very-thin-test-slice/:controller/:action/:id
+
+add_slice(:VeryThinTestSlice)
+
+# example: /foo/:controller/:action/:id
+
+add_slice(:VeryThinTestSlice, 'foo') # same as :path => 'foo'
+
+# example: /:lang/:controller/:action/:id (with :a param set)
+
+add_slice(:VeryThinTestSlice, :path => ':lang', :params => { :a => 'b' })
+
+# example: /:controller/:action/:id
+
+slice(:VeryThinTestSlice)
+
+Normally you should also run the following rake task:
+
+rake slices:very_thin_test_slice: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>