juicer 0.2.0

data/lib/juicer/merger/stylesheet_merger.rb

@@ -0,0 +1,112 @@
+#!/usr/bin/env ruby
+['base', 'css_dependency_resolver'].each do |lib|
+  require File.expand_path(File.join(File.dirname(__FILE__), lib))
+end
+
+require 'pathname'
+
+module Juicer
+  module Merger
+    # Merge several files into one single output file. Resolves and adds in files
+    # from @import statements
+    #
+    class StylesheetMerger < Base
+
+      # Constructor
+      #
+      # Options:
+      # * <tt>:web_root</tt> - Path to web root if there is any @import statements
+      #   using absolute URLs
+      #
+      def initialize(files = [], options = {})
+        @dependency_resolver = CssDependencyResolver.new(options)
+        super(files || [], options)
+        @hosts = options[:hosts] || []
+        @host_num = 0
+        @use_absolute = options.key?(:absolute_urls) ? options[:absolute_urls] : false
+        @use_relative = options.key?(:relative_urls) ? options[:relative_urls] : false
+        @web_root = options[:web_root]
+        @web_root = File.expand_path(@web_root).sub(/\/?$/, "") if @web_root # Make sure path doesn't end in a /
+      end
+
+     private
+      #
+      # Takes care of removing any import statements. This avoids importing the
+      # file that was just merged into the current file.
+      #
+      # +merge+ also recalculates any referenced URLs. Relative URLs are adjusted
+      # to be relative to the resulting merged file. Absolute URLs are left alone
+      # by default. If the :hosts option is set, the absolute URLs will cycle
+      # through these. This may help in concurrent downloads.
+      #
+      # The options hash decides how Juicer recalculates referenced URLs:
+      #
+      #   options[:absolute_urls] When true, all paths are converted to absolute
+      #                           URLs. Requires options[:web_root] to define
+      #                           root directory to resolve absolute URLs from.
+      #   options[:relative_urls] When true, all paths are converted to relative
+      #                           paths. Requires options[:web_root] to define
+      #                           root directory to resolve absolute URLs from.
+      #
+      # If none if these are set then relative URLs are recalculated to match
+      # location of merged target while absolute URLs are left absolute.
+      #
+      # If options[:hosts] is set to an array of hosts, then they will be cycled
+      # for all absolute URLs regardless of absolute/relative URL strategy.
+      #
+      def merge(file)
+        content = super.gsub(/^\s*\@import\s("|')(.*)("|')\;?/, '')
+        dir = File.expand_path(File.dirname(file))
+
+        content.scan(/url\(([^\)]*)\)/).uniq.collect do |url|
+          url = url.first
+          path = resolve_path(url, dir)
+          content.gsub!(/\(#{url}\)/m, "(#{path})") unless path == url
+        end
+
+        content
+      end
+
+      #
+      # Resolves a path relative to a directory
+      #
+      def resolve_path(url, dir)
+        path = url
+
+        # Absolute URLs
+        if url =~ %r{^/} && @use_relative
+          raise ArgumentError.new("Unable to handle absolute URLs without :web_root option") if !@web_root
+          path = Pathname.new(File.join(@web_root, url)).relative_path_from(@root).to_s
+        end
+
+        # All URLs that don't start with a protocol
+        if url !~ %r{^/} && url !~ %r{^[a-z]+://}
+          if @use_absolute
+            raise ArgumentError.new("Unable to handle absolute URLs without :web_root option") if !@web_root
+            path = File.expand_path(File.join(dir, url)).sub(@web_root, "")         # Make absolute
+          else
+            path = Pathname.new(File.join(dir, url)).relative_path_from(@root).to_s # ...or redefine relative ref
+          end
+        end
+
+        # Cycle hosts, if any
+        if url =~ %r{^/} && @hosts.length > 0
+          path = File.join(@hosts[@host_num % @hosts.length], url)
+          @host_num += 1
+        end
+
+        path
+      end
+    end
+  end
+end
+
+# Run file from command line
+#
+if $0 == __FILE__
+  return puts("Usage: stylesheet_merger.rb file[...] output") if $*.length < 2
+
+  fm = Juicer::Merger::StylesheetMerger.new()
+  fm << $*[0..-2]
+  fm.save($*[-1])
+end

data/lib/juicer/minifyer/yui_compressor.rb

@@ -0,0 +1,129 @@
+#!/usr/bin/env ruby
+require 'tempfile'
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'binary')) unless defined?(Juicer::Shell::Binary)
+
+module Juicer
+  module Minifyer
+
+    # Provides an interface to the YUI compressor library using
+    # Juicer::Shell::Binary. The YUI compressor library is implemented
+    # using Java, and as such Java is required when running this code. Also, the
+    # YUI jar file has to be provided.
+    #
+    # The YUI Compressor is invoked using the java binary and the YUI Compressor
+    # jar file.
+    #
+    # Providing the Jar file (usually yuicompressor-x.y.z.jar) can be done in
+    # several ways. The following directories are searched (in preferred order)
+    #
+    #  1. The directory specified by the option :bin_path
+    #  2. The directory specified by the environment variable $YUIC_HOME, if set
+    #  3. Current working directory
+    #
+    # For more information on how the Jar is located, see
+    # +Juicer::Minify::YuiCompressor.locate_jar+
+    #
+    # Author::    Christian Johansen (christian@cjohansen.no)
+    # Copyright:: Copyright (c) 2008-2009 Christian Johansen
+    # License::   MIT
+    #
+    # = Usage example =
+    # yuic = Juicer::Minifyer::YuiCompressor.new
+    # yuic.java = "/usr/local/bin/java" # If 'java' is not on path
+    # yuic.path << "/home/user/java/yui_compressor/"
+    # yuic.save("", "")
+    #
+    #
+    class YuiCompressor
+      include Juicer::Binary
+      include Juicer::Chainable
+
+      def initialize(options = {})
+        bin = options.delete(:java) || "java"
+        bin_path = options.delete(:bin_path) || nil
+        @jar = nil
+
+        super(bin, options)
+        path << bin_path if bin_path
+      end
+
+      # Compresses a file using the YUI Compressor. Note that the :bin_path
+      # option needs to be set in order for YuiCompressor to find and use the
+      # YUI jar file. Please refer to the class documentation for how to set
+      # this.
+      #
+      # file = The file to compress
+      # output = A file or stream to save the results to. If not provided the
+      #          original file will be overwritten
+      # type = Either :js or :css. If this parameter is not provided, the type
+      #        is guessed from the suffix on the input file name
+      def save(file, output = nil, type = nil)
+        type = type.nil? ? file.split('.')[-1].to_sym : type
+
+        output ||= file
+        use_tmp = !output.is_a?(String)
+        output = File.join(Dir::tmpdir, File.basename(file) + '.min.tmp.' + type.to_s) if use_tmp
+        FileUtils.mkdir_p(File.dirname(output))
+
+        result = execute(%Q{-jar "#{locate_jar}" -o "#{output}" "#{file}"})
+
+        if use_tmp                            # If no output file is provided, YUI compressor will
+          output.puts IO.read(output)         # compress to a temp file. This file should be cleared
+          File.delete(output)                 # out after we fetch its contents.
+        end
+      end
+
+      chain_method :save
+
+     private
+
+      # Returns a map of options accepted by YUI Compressor, currently:
+      #
+      # :charset
+      # :line_break
+      # :no_munge (JavaScript only)
+      # :preserve_semi
+      # :preserve_strings
+      #
+      # In addition, some class level options may be set:
+      # :bin_path (defaults to Dir.cwd)
+      # :java     (Java command, defaults to 'java')
+      def default_options
+        { :charset => nil, :line_break => nil, :no_munge => nil,
+          :preserve_semi => nil, :preserve_strings => nil }
+      end
+
+      # Locates the Jar file by searching directories.
+      # The following directories are searched (in preferred order)
+      #
+      #  1. The directory specified by the option :bin_path
+      #  2. The directory specified by the environment variable $YUIC_HOME, if set
+      #  3. Current working directory
+      #
+      # If any of these folders contain one or more files named like
+      # yuicompressor.jar or yuicompressor-x.y.z.jar the method will pick the
+      # last file in the list returned by +Dir.glob("#{dir}/yuicompressor*.jar").sort+
+      # This means that higher version numbers will be preferred with the default
+      # naming for the YUI Compressor Jars
+      def locate_jar
+        files = locate("yuicompressor*.jar", "YUIC_HOME")
+        !files || files.empty? ? nil : files.sort.last
+      end
+    end
+
+    # Run YUI Compressor with command line interface semantics
+    #
+    class Cli
+      def self.run(args)
+        if args.length != 2
+          puts 'Usage: yui_compressor.rb input ouput'
+        else
+          yc = Juicer::Minify::YuiCompressor.new
+          yc.compress(args.shift, args.shift)
+        end
+      end
+    end
+  end
+end
+
+Juicer::Minifyer::Compressor::Cli.run($*) if $0 == __FILE__

data/tasks/ann.rake

@@ -0,0 +1,80 @@
+
+begin
+  require 'bones/smtp_tls'
+rescue LoadError
+  require 'net/smtp'
+end
+require 'time'
+
+namespace :ann do
+
+  # A prerequisites task that all other tasks depend upon
+  task :prereqs
+
+  file PROJ.ann.file do
+    ann = PROJ.ann
+    puts "Generating #{ann.file}"
+    File.open(ann.file,'w') do |fd|
+      fd.puts("#{PROJ.name} version #{PROJ.version}")
+      fd.puts("    by #{Array(PROJ.authors).first}") if PROJ.authors
+      fd.puts("    #{PROJ.url}") if PROJ.url.valid?
+      fd.puts("    (the \"#{PROJ.release_name}\" release)") if PROJ.release_name
+      fd.puts
+      fd.puts("== DESCRIPTION")
+      fd.puts
+      fd.puts(PROJ.description)
+      fd.puts
+      fd.puts(PROJ.changes.sub(%r/^.*$/, '== CHANGES'))
+      fd.puts
+      ann.paragraphs.each do |p|
+        fd.puts "== #{p.upcase}"
+        fd.puts
+        fd.puts paragraphs_of(PROJ.readme_file, p).join("\n\n")
+        fd.puts
+      end
+      fd.puts ann.text if ann.text
+    end
+  end
+
+  desc "Create an announcement file"
+  task :announcement => ['ann:prereqs', PROJ.ann.file]
+
+  desc "Send an email announcement"
+  task :email => ['ann:prereqs', PROJ.ann.file] do
+    ann = PROJ.ann
+    from = ann.email[:from] || Array(PROJ.authors).first || PROJ.email
+    to   = Array(ann.email[:to])
+
+    ### build a mail header for RFC 822
+    rfc822msg =  "From: #{from}\n"
+    rfc822msg << "To: #{to.join(',')}\n"
+    rfc822msg << "Subject: [ANN] #{PROJ.name} #{PROJ.version}"
+    rfc822msg << " (#{PROJ.release_name})" if PROJ.release_name
+    rfc822msg << "\n"
+    rfc822msg << "Date: #{Time.new.rfc822}\n"
+    rfc822msg << "Message-Id: "
+    rfc822msg << "<#{"%.8f" % Time.now.to_f}@#{ann.email[:domain]}>\n\n"
+    rfc822msg << File.read(ann.file)
+
+    params = [:server, :port, :domain, :acct, :passwd, :authtype].map do |key|
+      ann.email[key]
+    end
+
+    params[3] = PROJ.email if params[3].nil?
+
+    if params[4].nil?
+      STDOUT.write "Please enter your e-mail password (#{params[3]}): "
+      params[4] = STDIN.gets.chomp
+    end
+
+    ### send email
+    Net::SMTP.start(*params) {|smtp| smtp.sendmail(rfc822msg, from, to)}
+  end
+end  # namespace :ann
+
+desc 'Alias to ann:announcement'
+task :ann => 'ann:announcement'
+
+CLOBBER << PROJ.ann.file
+
+# EOF

data/tasks/bones.rake

@@ -0,0 +1,20 @@
+
+if HAVE_BONES
+
+namespace :bones do
+
+  desc 'Show the PROJ open struct'
+  task :debug do |t|
+    atr = if t.application.top_level_tasks.length == 2
+      t.application.top_level_tasks.pop
+    end
+
+    if atr then Bones::Debug.show_attr(PROJ, atr)
+    else Bones::Debug.show PROJ end
+  end
+
+end  # namespace :bones
+
+end  # HAVE_BONES
+
+# EOF

data/tasks/gem.rake

@@ -0,0 +1,201 @@
+
+require 'find'
+require 'rake/packagetask'
+require 'rubygems/user_interaction'
+require 'rubygems/builder'
+
+module Bones
+class GemPackageTask < Rake::PackageTask
+  # Ruby GEM spec containing the metadata for this package.  The
+  # name, version and package_files are automatically determined
+  # from the GEM spec and don't need to be explicitly provided.
+  #
+  attr_accessor :gem_spec
+
+  # Tasks from the Bones gem directory
+  attr_reader :bones_files
+
+  # Create a GEM Package task library.  Automatically define the gem
+  # if a block is given.  If no block is supplied, then +define+
+  # needs to be called to define the task.
+  #
+  def initialize(gem_spec)
+    init(gem_spec)
+    yield self if block_given?
+    define if block_given?
+  end
+
+  # Initialization tasks without the "yield self" or define
+  # operations.
+  #
+  def init(gem)
+    super(gem.name, gem.version)
+    @gem_spec = gem
+    @package_files += gem_spec.files if gem_spec.files
+    @bones_files = []
+
+    local_setup = File.join(Dir.pwd, %w[tasks setup.rb])
+    if !test(?e, local_setup)
+      Dir.glob(::Bones.path(%w[lib bones tasks *])).each {|fn| bones_files << fn}
+    end
+  end
+
+  # Create the Rake tasks and actions specified by this
+  # GemPackageTask.  (+define+ is automatically called if a block is
+  # given to +new+).
+  #
+  def define
+    super
+    task :prereqs
+    task :package => ['gem:prereqs', "#{package_dir_path}/#{gem_file}"]
+    file "#{package_dir_path}/#{gem_file}" => [package_dir_path] + package_files + bones_files do
+      when_writing("Creating GEM") {
+        chdir(package_dir_path) do
+          Gem::Builder.new(gem_spec).build
+          verbose(true) {
+            mv gem_file, "../#{gem_file}"
+          }
+        end
+      }
+    end
+
+    file package_dir_path => bones_files do
+      mkdir_p package_dir rescue nil
+
+      gem_spec.files = (gem_spec.files +
+          bones_files.map {|fn| File.join('tasks', File.basename(fn))}).sort
+
+      bones_files.each do |fn|
+        base_fn = File.join('tasks', File.basename(fn))
+        f = File.join(package_dir_path, base_fn)
+        fdir = File.dirname(f)
+        mkdir_p(fdir) if !File.exist?(fdir)
+        if File.directory?(fn)
+          mkdir_p(f)
+        else
+          raise "file name conflict for '#{base_fn}' (conflicts with '#{fn}')" if test(?e, f)
+          safe_ln(fn, f)
+        end
+      end
+    end
+  end
+  
+  def gem_file
+    if @gem_spec.platform == Gem::Platform::RUBY
+      "#{package_name}.gem"
+    else
+      "#{package_name}-#{@gem_spec.platform}.gem"
+    end
+  end
+end  # class GemPackageTask
+end  # module Bones
+
+namespace :gem do
+
+  PROJ.gem._spec = Gem::Specification.new do |s|
+    s.name = PROJ.name
+    s.version = PROJ.version
+    s.summary = PROJ.summary
+    s.authors = Array(PROJ.authors)
+    s.email = PROJ.email
+    s.homepage = Array(PROJ.url).first
+    s.rubyforge_project = PROJ.rubyforge.name
+
+    s.description = PROJ.description
+
+    PROJ.gem.dependencies.each do |dep|
+      s.add_dependency(*dep)
+    end
+
+    PROJ.gem.development_dependencies.each do |dep|
+      s.add_development_dependency(*dep)
+    end
+
+    s.files = PROJ.gem.files
+    s.executables = PROJ.gem.executables.map {|fn| File.basename(fn)}
+    s.extensions = PROJ.gem.files.grep %r/extconf\.rb$/
+
+    s.bindir = 'bin'
+    dirs = Dir["{#{PROJ.libs.join(',')}}"]
+    s.require_paths = dirs unless dirs.empty?
+
+    incl = Regexp.new(PROJ.rdoc.include.join('|'))
+    excl = PROJ.rdoc.exclude.dup.concat %w[\.rb$ ^(\.\/|\/)?ext]
+    excl = Regexp.new(excl.join('|'))
+    rdoc_files = PROJ.gem.files.find_all do |fn|
+                   case fn
+                   when excl; false
+                   when incl; true
+                   else false end
+                 end
+    s.rdoc_options = PROJ.rdoc.opts + ['--main', PROJ.rdoc.main]
+    s.extra_rdoc_files = rdoc_files
+    s.has_rdoc = true
+
+    if test ?f, PROJ.test.file
+      s.test_file = PROJ.test.file
+    else
+      s.test_files = PROJ.test.files.to_a
+    end
+
+    # Do any extra stuff the user wants
+    PROJ.gem.extras.each do |msg, val|
+      case val
+      when Proc
+        val.call(s.send(msg))
+      else
+        s.send "#{msg}=", val
+      end
+    end
+  end  # Gem::Specification.new
+
+  Bones::GemPackageTask.new(PROJ.gem._spec) do |pkg|
+    pkg.need_tar = PROJ.gem.need_tar
+    pkg.need_zip = PROJ.gem.need_zip
+  end
+
+  desc 'Show information about the gem'
+  task :debug => 'gem:prereqs' do
+    puts PROJ.gem._spec.to_ruby
+  end
+
+  desc 'Write the gemspec '
+  task :spec => 'gem:prereqs' do
+    File.open("#{PROJ.name}.gemspec", 'w') do |f|
+      f.write PROJ.gem._spec.to_ruby
+    end
+  end
+
+  desc 'Install the gem'
+  task :install => [:clobber, 'gem:package'] do
+    sh "#{SUDO} #{GEM} install --local pkg/#{PROJ.gem._spec.full_name}"
+
+    # use this version of the command for rubygems > 1.0.0
+    #sh "#{SUDO} #{GEM} install --no-update-sources pkg/#{PROJ.gem._spec.full_name}"
+  end
+
+  desc 'Uninstall the gem'
+  task :uninstall do
+    installed_list = Gem.source_index.find_name(PROJ.name)
+    if installed_list and installed_list.collect { |s| s.version.to_s}.include?(PROJ.version) then
+      sh "#{SUDO} #{GEM} uninstall --version '#{PROJ.version}' --ignore-dependencies --executables #{PROJ.name}"
+    end
+  end
+
+  desc 'Reinstall the gem'
+  task :reinstall => [:uninstall, :install]
+
+  desc 'Cleanup the gem'
+  task :cleanup do
+    sh "#{SUDO} #{GEM} cleanup #{PROJ.gem._spec.name}"
+  end
+end  # namespace :gem
+
+
+desc 'Alias to gem:package'
+task :gem => 'gem:package'
+
+task :clobber => 'gem:clobber_package'
+remove_desc_for_task 'gem:clobber_package'
+
+# EOF