pupu 0.0.3 → 0.0.4.pre

data/CHANGELOG

@@ -15,3 +15,6 @@
   * Bug fixes
   * Refactoring
   * Examples
+
+= Version 0.0.4
+  * Added Rails example app

data/README.textile

@@ -1,6 +1,6 @@
 h1. About Pupu
 
-"Pupu":http://github.com/botanicus/pupu is a framework-agnostic plugin system for media stuff like JS/CSS frameworks and its plugins, icon sets etc. You can "search GitHub":http://github.com/search?type=Repositories&language=&q=pupu&repo=&langOverride=&x=9&y=24&start_value=1 for more examples. It provides CLI interface for searching, installing and updating pupus from GitHub and it also provides a helper for including static files from pupu into your HTML page. Both CLI and helper can handle dependencies.
+"Pupu":http://github.com/botanicus/pupu is a framework-agnostic plugin system for assets like JS/CSS frameworks and its plugins, icon sets etc. You can "search GitHub":http://github.com/search?type=Repositories&language=&q=pupu&repo=&langOverride=&x=9&y=24&start_value=1 for more examples. It provides CLI interface for searching, installing and updating pupus from GitHub and it also provides a helper for including static files from pupu into your HTML page. Both CLI and helper can handle dependencies.
 
 CLI example:
 
@@ -91,4 +91,4 @@ h1. Links
 - "Wiki":http://wiki.github.com/botanicus/pupu
 - "Source Code":http://github.com/botanicus/pupu
 - "API Documentation":http://rdoc.info/projects/botanicus/pupu
-- Examples: "Rango":http://github.com/botanicus/pupu/tree/master/examples/rango, "Merb":http://github.com/botanicus/pupu/tree/master/examples/merb
+- Examples: "Rango":http://github.com/botanicus/pupu/tree/master/examples/rango, "Merb":http://github.com/botanicus/pupu/tree/master/examples/merb and "Rails":http://github.com/botanicus/pupu/tree/master/examples/rails

data/TODO.txt

@@ -1,11 +1,14 @@
+Examples:
+- recreate the rango app AFTER I release Rango 0.3 & bundle it
+- ensure all the examples has the same functionality include specs
+- ensure all the examples work
+
 === Version 0.1 ===
 - Pupu.framework_root: "."
 - Pupu.media_root: "media"
 - Pupu.root: "media/pupu"
 - @pupu.root: "media/pupu/mootools"
 
-- rango & merb apps: both with same functionality include specs
-
 - THERE SHOULD BE A CONVETION TO NAME PUPU WITH PUPU-FRAMEWORK-PLUGIN, FOR EXAMPLE PUPU-MOOTOOLS-FLASH because of search
 - install each dependency just once
 - how to handle metadata if we have it as submodules? (suggestions: media/pupu/metadata.yml for all) or on the fly from .git/config & config.rb etc
@@ -13,8 +16,10 @@
 - media support (.swf): media helper
 - media vs. root vs. custom
 - how to handle metadata? Generate metadata.yml from config.rb (dependencies) or generate it through merb-gen and write it by hand?
-- what about ruby helpers such as flash :notice, :error for flash <divs
+- what about ruby helpers such as flash :notice, :error for flash <divs>
 - add array with loaded plugins, do not load plugin which is already loaded
+- hooks for minify etc
+- don't touch file system in production mode (don't use File.exist?) -> just load manifest
 
 === Version 0.2 ===
 

data/bin/pupu

@@ -1,56 +1,46 @@
-#!/usr/bin/env ruby1.9
+#!/usr/bin/env ruby
 # encoding: utf-8
 
+# follow symlink
 base   = File.symlink?(__FILE__) ? File.readlink(__FILE__) : __FILE__
 libdir = File.expand_path(File.join(File.dirname(base), "..", "lib"))
 
-vendor = File.join(File.dirname(__FILE__), "..", "vendor")
-if File.directory?(vendor)
-  Dir["#{vendor}/*"].each do |path|
-    if File.directory?(path) && Dir["#{path}/*"].empty?
-      warn "Dependency #{File.basename(path)} in vendor seems to be empty. Run git submodule init && git submodule update to checkout it."
-    elsif File.directory?(path) && File.directory?(File.join(path, "lib"))
-      $:.unshift(File.join(path, "lib"))
-    end
-  end
-end
-
 # because of system installation, there is bin/../lib, but not bin/../lib/pupu
 if File.directory?(File.join(libdir, "pupu"))
   $:.unshift(libdir) unless $:.include?(libdir)
 end
 
-# === Helpers === #
-# TODO: Generators.each { |generator| puts generator.help }
+require "pupu/cli"
+
+# helpers
 def usage
 <<-HELP
 === Usage ===
---media-root=media
-pupu create mootools  Generate pupu mootools
+pupu install [pupu]
+pupu uninstall [pupu]
+pupu update [pupu|all]
+pupu list
+pupu check
+pupu search [pattern]
+pupu create [name]
+     --media-root=media
 HELP
 end
 
+# main loop
 begin
   case ARGV.shift
-  when nil
-    abort usage
   when "install"
-    require "pupu/cli"
     Pupu::CLI.new(ARGV).install
   when "uninstall", "remove"
-    require "pupu/cli"
     Pupu::CLI.new(ARGV).uninstall
   when "update"
-    require "pupu/cli"
     Pupu::CLI.new(ARGV).update
   when "list" # list all pupus
-    require "pupu/cli"
     Pupu::CLI.new(ARGV).list
   when "check" # check setup & if you are in the right directory
-    require "pupu/cli"
     Pupu::CLI.new(ARGV).check || abort("File config/pupu.rb doesn't exist or can't be loaded")
   when "search"
-    require "pupu/cli"
     Pupu::CLI.new(ARGV).search(ARGV.first)
   when "create"
     begin
@@ -69,5 +59,7 @@ begin
     rescue Exception => exception
       abort "Exception #{exception.inspect} occured during running generator #{generator.inspect}\n#{exception.backtrace.join("\n")}"
     end
+  else
+    abort usage
   end
 end

data/examples/merb/.gitignore

@@ -1,21 +1,17 @@
-.DS_Store
+# You usually don't want to ignore gems/cache, but examples are
+# part of the pupu gem and we want to keep it as small as possible
+gems/*
+bin/*
+
 log/*
 tmp/*
-TAGS
-*~
-.#*
+
 schema/schema.rb
 schema/*_structure.sql
 schema/*.sqlite3
 schema/*.sqlite
 schema/*.db
+
 *.sqlite
 *.sqlite3
 *.db
-src/*
-.hgignore
-.hg/*
-.svn/*
-gems/gems/*
-gems/specifications/*
-merb_profile_results

data/examples/merb/Gemfile

@@ -0,0 +1,27 @@
+# encoding: utf-8
+
+# === Usage === #
+# Run gem bundle for installation. You have to have bundler gem installed.
+
+# http://github.com/wycats/bundler
+# http://litanyagainstfear.com/blog/2009/10/14/gem-bundler-is-the-future
+# http://yehudakatz.com/2009/11/03/using-the-new-gem-bundler-today
+# http://www.engineyard.com/blog/2009/using-the-rubygems-bundler-for-your-app
+
+gem "merb-core"          # git: "git://github.com/merb/merb.git"
+gem "media-path"         # git: "git://github.com/botanicus/media-path.git"
+gem "rspec", only: :test # git: "git://github.com/dchelimsky/rspec.git"
+
+# === Bundler Setup === #
+# Specify where the bundled gems should be stashed. This directory will
+# be a gem repository where all gems are downloaded to and installed to.
+#
+# This is an optional setting.
+# The default is: vendor/gems
+bundle_path "gems"
+
+# Specify where gem executables should be copied to.
+#
+# This is an optional setting.
+# The default is: bin
+bin_path "bin"

data/examples/merb/README.textile

@@ -1,7 +1,5 @@
 h1. Merb Example
 
-* Dependencies for running: @merb-core@
-* Run with @merb -a webrick@ (will start at @http://localhost:4000@)
-
-* Dependencies for testing: @rspec@, @webrat@
-* Specs: @spec spec/application_spec.rb --colour@
+* @gem bundle@ (you have to have bundler 0.7.2 installed)
+* Run with @./bin/merb -a webrick@ (will start at @http://localhost:4000@)
+* Specs: @./bin/spec spec/application_spec.rb --colour@

data/examples/merb/config/init.rb

@@ -1,5 +1,12 @@
 # Go to http://wiki.merbivore.com/pages/init-rb
 
+# bundler
+begin
+  require_relative "../gems/environment.rb"
+rescue LoadError => exception
+  abort "LoadError during loading gems/environment: #{exception.message}\nRun gem bundle to fix it."
+end
+
 # setup $:
 pupu_libdir = File.expand_path("../../lib")
 raise Errno::ENOENT, "#{pupu_libdir} doesn't exist" unless File.directory?(pupu_libdir)

data/examples/rails/.gitignore

@@ -0,0 +1,7 @@
+# You usually don't want to ignore gems/cache, but examples are
+# part of the pupu gem and we want to keep it as small as possible
+gems/*
+bin/*
+
+tmp/*
+log/*

data/examples/rails/Gemfile

@@ -0,0 +1,28 @@
+# encoding: utf-8
+
+# === Usage === #
+# Run gem bundle for installation. You have to have bundler gem installed.
+
+# http://github.com/wycats/bundler
+# http://litanyagainstfear.com/blog/2009/10/14/gem-bundler-is-the-future
+# http://yehudakatz.com/2009/11/03/using-the-new-gem-bundler-today
+# http://www.engineyard.com/blog/2009/using-the-rubygems-bundler-for-your-app
+
+gem "rails"                    # git: "git://github.com/rails/rails.git"
+gem "media-path"               # git: "git://github.com/botanicus/media-path.git"
+gem "rspec", only: :test       # git: "git://github.com/dchelimsky/rspec.git"
+gem "rspec-rails", only: :test # git: "git://github.com/dchelimsky/rspec-rails.git"
+
+# === Bundler Setup === #
+# Specify where the bundled gems should be stashed. This directory will
+# be a gem repository where all gems are downloaded to and installed to.
+#
+# This is an optional setting.
+# The default is: vendor/gems
+bundle_path "gems"
+
+# Specify where gem executables should be copied to.
+#
+# This is an optional setting.
+# The default is: bin
+bin_path "bin"

data/examples/rails/README.textile

@@ -0,0 +1,5 @@
+h1. Rails Example
+
+* @gem bundle@ (you have to have bundler 0.7.2 installed)
+* Run with @./script/server@ (will start at @http://localhost:3000@)
+* Specs: @./script/spec spec/application_spec.rb --colour@

data/examples/rails/Rakefile

@@ -0,0 +1,10 @@
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require(File.join(File.dirname(__FILE__), 'config', 'boot'))
+
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+require 'tasks/rails'

data/examples/rails/app/controllers/application_controller.rb

@@ -0,0 +1,10 @@
+# Filters added to this controller apply to all controllers in the application.
+# Likewise, all the methods added will be available for all controllers.
+
+class ApplicationController < ActionController::Base
+  helper :all # include all helpers, all the time
+  protect_from_forgery # See ActionController::RequestForgeryProtection for details
+
+  # Scrub sensitive parameters from your log
+  # filter_parameter_logging :password
+end

data/examples/rails/app/controllers/home_controller.rb

@@ -0,0 +1,8 @@
+class HomeController < ApplicationController
+  def index
+  end
+
+  def static
+    render template: params[:template]
+  end
+end

data/examples/rails/app/helpers/application_helper.rb

@@ -0,0 +1,3 @@
+# Methods added to this helper will be available to all templates in the application.
+module ApplicationHelper
+end

data/examples/rails/app/views/examples/simple.html.erb

@@ -0,0 +1,4 @@
+<% content_for :title, "Simple Example" %>
+<% content_for :head do %>
+  <%= pupu :mootools %>
+<% end %>

data/examples/rails/app/views/index.html.erb

@@ -0,0 +1,7 @@
+<% content_for :title, "Pupu Examples" %>
+
+<ul>
+  <li><a href="/examples/simple">Simple Example</a></li>
+  <li><a href="/examples/dependencies">Example With Dependencies</a></li>
+  <li><a href="/examples/arguments">Example With Arguments</a></li>
+</ul>

data/examples/rails/app/views/layout.html.erb

@@ -0,0 +1,12 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html lang="en" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <title><%= yield :title %></title>
+    <%= yield :head %>
+  </head>
+  <body>
+    <h1><%= yield :title %></h1>
+    <%= yield :layout %>
+    <pre><%= yield :head %></pre>
+  </body>
+</html>

data/examples/rails/config/boot.rb

@@ -0,0 +1,110 @@
+# Don't change this file!
+# Configure your app in config/environment.rb and config/environments/*.rb
+
+RAILS_ROOT = "#{File.dirname(__FILE__)}/.." unless defined?(RAILS_ROOT)
+
+module Rails
+  class << self
+    def boot!
+      unless booted?
+        preinitialize
+        pick_boot.run
+      end
+    end
+
+    def booted?
+      defined? Rails::Initializer
+    end
+
+    def pick_boot
+      (vendor_rails? ? VendorBoot : GemBoot).new
+    end
+
+    def vendor_rails?
+      File.exist?("#{RAILS_ROOT}/vendor/rails")
+    end
+
+    def preinitialize
+      load(preinitializer_path) if File.exist?(preinitializer_path)
+    end
+
+    def preinitializer_path
+      "#{RAILS_ROOT}/config/preinitializer.rb"
+    end
+  end
+
+  class Boot
+    def run
+      load_initializer
+      Rails::Initializer.run(:set_load_path)
+    end
+  end
+
+  class VendorBoot < Boot
+    def load_initializer
+      require "#{RAILS_ROOT}/vendor/rails/railties/lib/initializer"
+      Rails::Initializer.run(:install_gem_spec_stubs)
+      Rails::GemDependency.add_frozen_gem_path
+    end
+  end
+
+  class GemBoot < Boot
+    def load_initializer
+      self.class.load_rubygems
+      load_rails_gem
+      require 'initializer'
+    end
+
+    def load_rails_gem
+      if version = self.class.gem_version
+        gem 'rails', version
+      else
+        gem 'rails'
+      end
+    rescue Gem::LoadError => load_error
+      $stderr.puts %(Missing the Rails #{version} gem. Please `gem install -v=#{version} rails`, update your RAILS_GEM_VERSION setting in config/environment.rb for the Rails version you do have installed, or comment out RAILS_GEM_VERSION to use the latest version installed.)
+      exit 1
+    end
+
+    class << self
+      def rubygems_version
+        Gem::RubyGemsVersion rescue nil
+      end
+
+      def gem_version
+        if defined? RAILS_GEM_VERSION
+          RAILS_GEM_VERSION
+        elsif ENV.include?('RAILS_GEM_VERSION')
+          ENV['RAILS_GEM_VERSION']
+        else
+          parse_gem_version(read_environment_rb)
+        end
+      end
+
+      def load_rubygems
+        min_version = '1.3.2'
+        require 'rubygems'
+        unless rubygems_version >= min_version
+          $stderr.puts %Q(Rails requires RubyGems >= #{min_version} (you have #{rubygems_version}). Please `gem update --system` and try again.)
+          exit 1
+        end
+
+      rescue LoadError
+        $stderr.puts %Q(Rails requires RubyGems >= #{min_version}. Please install RubyGems and try again: http://rubygems.rubyforge.org)
+        exit 1
+      end
+
+      def parse_gem_version(text)
+        $1 if text =~ /^[^#]*RAILS_GEM_VERSION\s*=\s*["']([!~<>=]*\s*[\d.]+)["']/
+      end
+
+      private
+        def read_environment_rb
+          File.read("#{RAILS_ROOT}/config/environment.rb")
+        end
+    end
+  end
+end
+
+# All that for this:
+Rails.boot!