pupu 0.0.1

data/CHANGELOG

@@ -0,0 +1 @@
+[12/2/2008] First root release

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Jakub Stastny aka Botanicus
+
+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.textile

@@ -0,0 +1,160 @@
+h1. About
+
+Pupu is a plugin system for media stuff like JS & CSS frameworks, plugins for the JS & CSS frameworks, icon sets etc. It knows dependencies and it has CLI interface, so it's really easy to bundle such plugins into your app.
+
+h1. Why I wrote it
+
+In my apps the root/ stuff always get bloated and messy when I have all javascripts in root/javascripts, all stylesheets in root/stylesheets etc. It's nearly imposible to remove some stuff related with let's say some mootools plugin. It has it's own javascripts, stylesheets, few images + code which is required for initialization. And of course it is really bad idea to put your own code to directory with such things as javascript framework is.
+
+Another thing which really annoyed me was the bloody <code>js_include_tag</code> and <code>css_include_tag</code>. There are so stupid that they do not throw exception when the JS or CSS file do not exists! So you are surprised why you fancy script do not work and then you realized that it's not correctly included at all!
+
+h1. What can be presented in pupu?
+
+Everything what can be put into root directory. Some examples: blueprint css, mootools, autocompleter for mootools, icon set ...
+
+h1. CLI interface
+
+h2. Specify @--media-root=path/to/media/directory@ and Optionally @--strategy=copy|submodules@
+
+You don't have to do anything with environment, just specify @--media-root=path@ and it will work. Example: @pupu install mootools --media-root=media@
+
+h2. Using System @pupu@ and Configuration File
+
+- pupu executable will find it
+- you will require it in your environment file so it will be available in runtime
+
+h2. Using Your Own Wrapper
+
+If you have bundled application
+The only thing you need to do is just load your environment before pupu starts, example
+
+Rango:
+<pre>
+#!init
+
+load File.dirname(__FILE__) + "/gems/gems/pupu-0.0.1/bin/pupu"
+</pre>
+
+Rails/Merb
+<pre>
+#!/usr/bin/env ruby1.9
+
+load File.dirname(__FILE__) + "../config/environment.rb"
+</pre>
+
+h2. Wrapper Tasks
+
+Pupu provides Rake & Thor tasks
+
+<pre>
+task "pupu:setup" => :environment
+</pre>
+
+<pre>
+Pupu::Tasks.class_eval do
+  def setup
+    load "config/environment.rb"
+  end
+end
+</pre>
+
+<pre>
+# install autocompleter and its dependencies from my github repo
+pupu install botanicus/autocompleter
+
+# or uninstall, it's the same
+pupu remove autocompleter
+
+# list all installed pupus
+pupu list
+</pre>
+
+h1. Storing Pupus in Your Project
+
+copy/submodules
+
+h1. Views
+
+In your views you can include all the plugin-related files this way:
+
+<pre>
+pupu :autocompleter
+</pre>
+
+If pupu has optional arguments, you can specify them, it will modify its behaviour (including extra files etc).
+
+<pre>
+# this will include not just basic autocompleter files, but script for local requests too
+pupu :autocompleter, :type => "local"
+</pre>
+
+There is some helpers for getting path to pupu's files:
+
+<pre>
+Plugin[:autocompleter].image("spinner.gif")
+</pre>
+
+h1. Initializers
+
+Initializers are the only part of pupu which are not stored in <code>root/pupu</code>, but are copyied to <code>root/javascripts/initializers</code> and <code>root/stylesheets/initializers</code>. In contrary of files in <code>root/pupu</code>, initializers are intended for user editing.
+
+<pre>
+window.addEvent("domready", function() {
+  // do the init stuff
+})
+</pre>
+
+h1. Available pupus
+
+* "MooTools":http://github.com/botanicus/pupu-mootools
+* "Autocompleter":http://github.com/botanicus/pupu-autocompleter
+* "Squeezebox":http://github.com/botanicus/pupu-squeezebox
+* "Blueprint CSS":http://github.com/botanicus/pupu-blueprint
+* "Mooeditable":http://github.com/botanicus/pupu-mooeditable
+* "Tips":http://github.com/botanicus/pupu-tips
+* "Growl":http://github.com/botanicus/pupu-growl
+* "Ratings":http://github.com/botanicus/pupu-ratings
+* "Form defaults":http://github.com/botanicus/pupu-form-defaults
+* icon sets
+
+h1. I'd like to write my own pupu!
+
+h2. Plugin generator
+
+<pre>
+pupu-gen pupu chunky_bacon
+# chunky_bacon/README
+# chunky_bacon/LICENSE
+# chunky_bacon/initializers/chunky_bacon.js
+# chunky_bacon/initializers/chunky_bacon.css
+# chunky_bacon/lib
+# chunky_bacon/lib/chunky_bacon.js
+# chunky_bacon/stylesheets
+# chunky_bacon/stylesheets/chunky_bacon.css
+</pre>
+
+<pre>
+pupu-gen pupu chunky_bacon helpers.js blue.css
+</pre>
+
+h2. Configuration file
+
+File config.rb in your pupu root is intended to put package metadata there. You can define dependencies of pupu, arguments of pupu method and define which javascripts and stylesheets will be included in which order.
+
+<pre>
+# autocompleter depends on mootools
+dependencies :mootools
+
+# javascripts for loading
+javascripts "observer", "autocompleter", :in => "lib"
+
+parameter :type, :optional => ["local", "request"] do |type|
+  javascript "lib/autocompleter.#{type}"
+end
+</pre>
+
+h1. Links
+
+- "Wiki":http://wiki.github.com/botanicus/pupu
+- "Source Code":http://github.com/botanicus/pupu
+- "API Documentation":http://rdoc.info/projects/botanicus/pupu

data/Rakefile

@@ -0,0 +1,61 @@
+#!/usr/bin/env rake1.9
+# encoding: utf-8
+
+# http://support.runcoderun.com/faqs/builds/how-do-i-run-rake-with-trace-enabled
+Rake.application.options.trace = true
+
+task :setup => ["submodules:init"]
+
+namespace :submodules do
+  desc "Init submodules"
+  task :init do
+    sh "git submodule init"
+  end
+
+  desc "Update submodules"
+  task :update do
+    Dir["vendor/*"].each do |path|
+      if File.directory?(path) && File.directory?(File.join(path, ".git"))
+        Dir.chdir(path) do
+          puts "=> #{path}"
+          puts %x[git reset --hard]
+          puts %x[git fetch]
+          puts %x[git reset origin/master --hard]
+          puts
+        end
+      end
+    end
+  end
+end
+
+task :gem do
+  sh "gem build pupu.gemspec"
+end
+
+desc "Release new version of pupu"
+task release: ["release:tag", "release:gemcutter"]
+
+namespace :release do
+  desc "Create Git tag"
+  task :tag do
+    require_relative "lib/pupu"
+    puts "Creating new git tag #{Pupu::VERSION} and pushing it online ..."
+    sh "git tag -a -m 'Version #{Pupu::VERSION}' #{Pupu::VERSION}"
+    sh "git push --tags"
+    puts "Tag #{Pupu::VERSION} was created and pushed to GitHub."
+  end
+
+  desc "Push gem to Gemcutter"
+  task :gemcutter => :gem do
+    puts "Pushing to Gemcutter ..."
+    sh "gem push #{Dir["*.gem"].last}"
+  end
+end
+
+desc "Run specs"
+task :default => :setup do
+  rubylib = (ENV["RUBYLIB"] || String.new).split(":")
+  libdirs = Dir["vendor/*/lib"]
+  ENV["RUBYLIB"] = (libdirs + rubylib).join(":")
+  exec "./script/spec --options spec/spec.opts spec"
+end

data/TODO.txt

@@ -0,0 +1,21 @@
+=== Version 0.1 ===
+metadata vzdycky, dat je do ignore
+pupu has a license, but the stuff we want to put into pupu probably has also a license (MooTools is under MIT etc)
+- media support (.swf): media helper
+- adapters for Rango, Merb, Rails (helpers registration)
+- 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
+- custom messages on errors
+- install dependencies if any
+- add array with loaded plugins, do not load plugin which is already loaded
+- pupu view helper should works with dependencies (pupu :autocompleter should add mootools as well)
+
+=== Version 0.2 ===
+
+=== Version 0.3 ===
+- bin/pupu
+
+=== Version 0.4 ===
+- 100% specs coverage & refactoring
+- YARD Code Documentation

data/bin/pupu

@@ -0,0 +1,73 @@
+#!/usr/bin/env ruby1.9
+# encoding: utf-8
+
+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 }
+def usage
+<<-HELP
+=== Usage ===
+--media-root=media
+pupu create mootools  Generate pupu mootools
+HELP
+end
+
+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
+      require "simple-templater"
+    rescue LoadError
+      abort "You have to install simple-templater first!"
+    end
+    path = File.expand_path(File.join(File.dirname(base), "..", "stubs", "pupu"))
+    generator = SimpleTemplater::GeneratorSet.new(:pupu, path)
+    begin
+      generator.run(ARGV)
+    rescue SimpleTemplater::TargetAlreadyExist => exception
+      abort exception.message
+    rescue Interrupt
+      exit
+    rescue Exception => exception
+      abort "Exception #{exception.inspect} occured during running generator #{generator.inspect}\n#{exception.backtrace.join("\n")}"
+    end
+  end
+end

data/deps.rip

@@ -0,0 +1,6 @@
+#!/usr/bin/env rip install
+
+# Syntax:
+# repository [tag or commit to install]
+git://github.com/botanicus/media-path.git
+git://github.com/botanicus/simple-templater.git

data/examples/blog/Rakefile

@@ -0,0 +1,4 @@
+# encoding: utf-8
+
+require_relative "init"
+load "pupu/tasks/pupu.rake"

data/examples/blog/Thorfile

@@ -0,0 +1,9 @@
+# encoding: utf-8
+
+# Init hooks
+# Rango::Tasks.hook do
+#   Dir["models/*.rb"].each(&method(:require))
+# end
+
+require_relative "init"
+load "pupu/tasks/pupu.thor"

data/examples/blog/bin/pupu

@@ -0,0 +1,4 @@
+#!init.rb
+
+puts "We loaded init.rb, so our environment is loaded and now we can run the original bin/pupu from the pupu gem"
+load File.join("../../bin/pupu")

data/examples/blog/config.ru

@@ -0,0 +1,22 @@
+#!/usr/bin/env rackup -s thin -p 4000
+# encoding: utf-8
+
+require_relative "init"
+
+require "rango"
+require "rango/gv"
+require "pupu/helpers"
+
+Rango::Router.use(:usher)
+
+# register helpers
+Rango::GV::View.send(:include, Pupu::Helpers)
+
+use Rango::Middlewares::Basic
+
+Project.router = Usher::Interface.for(:rack) do
+  get("/").to(Rango::GV.static {"index"})
+  get("/examples/:template").to(Rango::GV.static { |template| "examples/#{template}" })
+end
+
+run Project.router

data/examples/blog/config/pupu.rb

@@ -0,0 +1,4 @@
+require "pupu"
+
+Pupu.root = File.join(File.dirname(__FILE__), "..")
+Pupu.media_root = File.join(MediaPath.root, "media")

data/examples/blog/init.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+require "rango"
+
+# === Usage === #
+# init.rb
+# init.rb production
+Rango.boot(environment: "development")
+
+pupu_libdir = File.expand_path("../../lib")
+raise Errno::ENOENT, "#{pupu_libdir} doesn't exist" unless File.directory?(pupu_libdir)
+$:.unshift(pupu_libdir)
+
+require_relative "config/pupu"
+
+# if you will run this script with -i argument, interactive session will begin
+Rango.interactive if ARGV.delete("-i")

data/examples/blog/media/javascripts/initializers/lighter.js

@@ -0,0 +1,16 @@
+// See http://pradador.com/code/lighterjs
+window.addEvent("domready", function() {
+  // Syntax highlight using Fuel.js.js and default theme
+  // <pre id="code" class="js">var myClass = new Class({})</pre>
+
+  // Syntax highlight using Fuel.ruby.js and theme from Flame.twilight.js
+  // <pre id="code" class="ruby:twilight">puts "hi"</pre>
+
+  // Highlight all "pre" elements with "code" class
+  //$$('pre.code').light({ altLines: 'hover' });
+  alert("X");
+  $$("pre.code").each(function(element) {
+    console.log(element);
+    new Lighter(element, { altLines: 'hover' });
+  });
+})

data/examples/blog/media/pupu/autocompleter/CHANGELOG

@@ -0,0 +1 @@
+[12/2/2008] First public release

data/examples/blog/media/pupu/autocompleter/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Jakub Stastny aka Botanicus
+ 
+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.