arnebrasseur-compass 0.3.5

data/lib/compass/commands/update_project.rb

@@ -0,0 +1,101 @@
+require 'rubygems'
+require 'sass'
+require 'fileutils'
+require 'pathname'
+require File.join(File.dirname(__FILE__), 'base')
+
+module Compass
+  module Commands
+    class UpdateProject < Base
+      
+      Base::ACTIONS << :compile
+      Base::ACTIONS << :overwrite
+
+      attr_accessor :project_directory, :project_name, :options, :project_src_subdirectory, :project_css_subdirectory
+
+      def initialize(working_directory, options = {})
+        super(working_directory, options)
+        if options[:project_name]
+          options[:project_name] = options[:project_name][0..-2] if options[:project_name][-1..-1] == File::SEPARATOR
+          self.project_name = File.basename(options[:project_name])
+          if options[:project_name][0] == File::SEPARATOR
+            self.project_directory = options[:project_name]
+          elsif File.directory?(File.join(working_directory, options[:project_name]))
+            self.project_directory = File.expand_path(File.join(working_directory, options[:project_name]))
+          else
+            if File.exists?(options[:project_name]) or File.exists?(File.join(working_directory, options[:project_name]))
+              raise ::Compass::Exec::ExecError.new("#{options[:project_name]} is not a directory.")
+            elsif !(options[:force] || options[:dry_run])
+              raise ::Compass::Exec::ExecError.new("#{options[:project_name]} does not exist.")
+            end
+          end
+        else
+          self.project_name = File.basename(working_directory)
+          self.project_directory = working_directory          
+        end
+      end
+      
+      def perform
+        Dir.glob(separate("#{project_src_directory}/**/[^_]*.sass")).each do |sass_file|
+          stylesheet_name = sass_file[("#{project_src_directory}/".length)..-6]
+          compile "#{project_src_subdirectory}/#{stylesheet_name}.sass", "#{project_css_subdirectory}/#{stylesheet_name}.css", options
+        end
+      end
+
+      # Compile one Sass file
+      def compile(sass_filename, css_filename, options)
+        sass_filename = projectize(sass_filename)
+        css_filename = projectize(css_filename)
+        if !File.directory?(File.dirname(css_filename))
+          directory basename(File.dirname(css_filename)), options.merge(:force => true) unless options[:dry_run]
+        end
+        print_action :compile, basename(sass_filename)
+        if File.exists?(css_filename)
+          print_action :overwrite, basename(css_filename)
+        else
+          print_action :create, basename(css_filename)
+        end
+        unless options[:dry_run]
+          engine = ::Sass::Engine.new(open(sass_filename).read,
+                                      :filename => sass_filename,
+                                      :line_comments => options[:environment] == :development,
+                                      :style => output_style,
+                                      :css_filename => css_filename,
+                                      :load_paths => sass_load_paths)
+          output = open(css_filename,'w')
+          output.write(engine.render)
+          output.close
+        end
+      end
+      
+      def output_style
+        @output_style ||= options[:style] || if options[:environment] == :development
+          :expanded
+        else
+          :compact
+        end
+      end
+      
+      # where to load sass files from
+      def sass_load_paths
+        @sass_load_paths ||= [project_src_directory] + Compass::Frameworks::ALL.map{|f| f.stylesheets_directory}
+      end
+      
+      # The subdirectory where the sass source is kept.
+      def project_src_subdirectory
+        @project_src_subdirectory ||= options[:src_dir] || "src"
+      end
+
+      # The subdirectory where the css output is kept.
+      def project_css_subdirectory
+        @project_css_subdirectory ||= options[:css_dir] || "stylesheets"
+      end
+
+      # The directory where the project source files are located.
+      def project_src_directory
+        @project_src_directory ||= separate("#{project_directory}/#{project_src_subdirectory}")
+      end
+
+    end
+  end
+end

data/lib/compass/commands/watch_project.rb

@@ -0,0 +1,42 @@
+require 'rubygems'
+require 'sass'
+require 'fileutils'
+require 'pathname'
+require File.join(File.dirname(__FILE__), 'base')
+require File.join(File.dirname(__FILE__), 'update_project')
+
+module Compass
+  module Commands
+    class WatchProject < UpdateProject
+      attr_accessor :last_update_time
+      def perform
+        super
+        self.last_update_time = most_recent_update_time
+        loop do
+          # TODO: Make this efficient by using filesystem monitoring.
+          sleep 1
+          file, t = should_update?
+          if t
+            begin
+              puts ">>> Change detected to #{file} <<<"
+              super
+            rescue StandardError => e
+              ::Compass::Exec.report_error(e, options)
+            end
+            self.last_update_time = t
+          end
+        end
+      end
+      def most_recent_update_time
+        Dir.glob(separate("#{project_src_directory}/**/*.sass")).map {|sass_file| File.stat(sass_file).mtime}.max
+      end
+      def should_update?
+        t = most_recent_update_time
+        if t > last_update_time
+          file = Dir.glob(separate("#{project_src_directory}/**/*.sass")).detect {|sass_file| File.stat(sass_file).mtime >= t}
+          [file, t]
+        end
+      end
+    end
+  end
+end

data/lib/compass/core_ext.rb

@@ -0,0 +1,39 @@
+class String
+  # see if string has any content
+  def blank?; self.length.zero?; end
+  
+  # strip space after :, remove newlines, replace multiple spaces with only one space, remove comments
+  def strip_space!
+    replace self.gsub(/:\s*/, ':').gsub(/\n/, '').gsub(/\s+/, ' ').gsub(/(\/\*).*?(\*\/)/, '')
+  end
+  
+  # remove newlines, insert space after comma, replace two spaces with one space after comma
+  def strip_selector_space!
+    replace self.gsub(/(\n)/, '').gsub(',', ', ').gsub(',  ', ', ')
+  end
+  
+  # remove leading whitespace, remove end whitespace
+  def strip_side_space!
+    replace self.gsub(/^\s+/, '').gsub(/\s+$/, $/)
+  end
+end
+
+class NilClass
+  def blank?
+    true
+  end
+end
+
+class File
+  # string output from file
+  def self.path_to_string(path)
+    File.new(path).read
+  end
+  
+  # saves a string to a specified file path
+  def self.string_to_file(string, path)
+    directory = File.dirname(path)
+    FileUtils.mkdir_p directory unless File.directory?(directory)
+    File.open(path, 'w') { |f| f << string }
+  end
+end

data/lib/compass/exec.rb

@@ -0,0 +1,164 @@
+require 'optparse'
+require 'rubygems'
+require 'haml'
+
+module Compass
+  module Exec
+    class ExecError < StandardError
+    end
+
+
+    def report_error(e, options)
+      $stderr.puts "#{e.class} on line #{get_line e} of #{get_file e}: #{e.message}"
+      if options[:trace]
+        e.backtrace[1..-1].each { |t| $stderr.puts "  #{t}" }
+      else
+        $stderr.puts "Run with --trace to see the full backtrace"
+      end
+    end
+
+    def get_file(exception)
+      exception.backtrace[0].split(/:/, 2)[0]
+    end
+
+    def get_line(exception)
+      # SyntaxErrors have weird line reporting
+      # when there's trailing whitespace,
+      # which there is for Haml documents.
+      return exception.message.scan(/:(\d+)/)[0] if exception.is_a?(::Haml::SyntaxError)
+      exception.backtrace[0].scan(/:(\d+)/)[0]
+    end
+    module_function :report_error, :get_file, :get_line
+
+    class Compass
+      
+      attr_accessor :args, :options, :opts
+
+      def initialize(args)
+        self.args = args
+        self.options = {}
+      end
+
+      def run!
+        begin
+          parse!
+          perform!
+        rescue Exception => e
+          raise e if e.is_a? SystemExit
+          if e.is_a?(ExecError) || e.is_a?(OptionParser::ParseError)
+            $stderr.puts e.message
+          else
+            ::Compass::Exec.report_error(e, @options)
+          end
+          exit 1
+        end
+        exit 0
+      end
+      
+      protected
+      
+      def perform!
+        if options[:command]
+          do_command(options[:command])
+        else
+          puts self.opts
+        end
+      end
+      
+      def parse!
+        self.opts = OptionParser.new(&method(:set_opts))
+        self.opts.parse!(self.args)    
+        if ARGV.size > 0
+          self.options[:project_name] = ARGV.shift
+        end
+        self.options[:command] ||= self.options[:project_name] ? :create_project : :update_project
+        self.options[:environment] ||= :production
+        self.options[:framework] ||= :compass
+      end
+      
+      def set_opts(opts)
+        opts.banner = <<END
+Usage: compass [options] [project]
+
+Description:
+  When project is given, generates a new project of that name as a subdirectory of
+  the current directory.
+  
+  If you change any source files, you can update your project using --update.
+
+Options:
+END
+        opts.on('-u', '--update', :NONE, 'Update the current project') do
+          self.options[:command] = :update_project
+        end
+
+        opts.on('-w', '--watch', :NONE, 'Monitor the current project for changes and update') do
+          self.options[:command] = :watch_project
+        end
+
+        opts.on('--source SRC_DIR', "The source directory (where you keep your sass stylesheets).") do |src_dir|
+          self.options[:src_dir] = src_dir
+        end
+
+        opts.on('--target CSS_DIR', "The target directory (where you keep your css stylesheets).") do |css_dir|
+          self.options[:css_dir] = css_dir
+        end
+
+        opts.on('-f FRAMEWORK', '--framework FRAMEWORK', [:compass, :blueprint], 'Set up a new project using the selected framework. Legal values: compass (default), blueprint') do |framework|
+          self.options[:framework] = framework
+        end
+
+        opts.on('-e ENV', '--environment ENV', [:development, :production], 'Use sensible defaults for your current environment: development, production (default)') do |env|
+          self.options[:environment] = env
+        end
+
+        opts.on('-s STYLE', '--output-style STYLE', [:nested, :expanded, :compact, :compressed], 'Select a CSS output mode (nested, expanded, compact, compressed)') do |style|
+          self.options[:style] = style
+        end
+        
+        opts.on('--rails', "Install compass into your Ruby on Rails project found in the current directory.") do
+          self.options[:command] = :install_rails
+        end
+
+        opts.on('-q', '--quiet', :NONE, 'Quiet mode.') do
+          self.options[:quiet] = true
+        end
+
+        opts.on('--dry-run', :NONE, 'Dry Run. Tells you what it plans to do.') do
+          self.options[:dry_run] = true
+        end
+
+        opts.on('--trace', :NONE, 'Show a full traceback on error') do
+          self.options[:trace] = true
+        end
+        
+        opts.on('--force', :NONE, 'Force. Allows some commands to succeed when they would otherwise fail.') do
+          self.options[:force] = true
+        end
+
+        opts.on('--imports', :NONE, 'Emit an import path suitable for use with the Sass command-line tool.') do
+          #XXX cross platform support?
+          print ::Compass::Frameworks::ALL.map{|f| "-I #{f.stylesheets_directory}"}.join(' ')
+          exit
+        end
+
+        opts.on_tail("-?", "-h", "--help", "Show this message") do
+          puts opts
+          exit
+        end
+
+        opts.on_tail("-v", "--version", "Print version") do
+          self.options[:command] = :print_version
+        end
+      end
+      
+      def do_command(command)
+        require File.join(File.dirname(__FILE__), 'commands', command.to_s)
+        command_class_name = command.to_s.split(/_/).map{|p| p.capitalize}.join('')
+        command_class = eval("::Compass::Commands::#{command_class_name}")
+        command_class.new(Dir.getwd, options).perform
+      end
+
+    end
+  end
+end

data/lib/compass/frameworks/blueprint.rb

@@ -0,0 +1,2 @@
+blueprint_dir = File.join(Compass.base_directory, 'frameworks', 'blueprint')
+Compass::Frameworks.register('compass', blueprint_dir)

data/lib/compass/frameworks/compass.rb

@@ -0,0 +1,2 @@
+compass_dir = File.join(Compass.base_directory, 'frameworks', 'compass')
+Compass::Frameworks.register('compass', compass_dir)

data/lib/compass/frameworks/yui.rb

@@ -0,0 +1,2 @@
+yui_dir = File.join(Compass.base_directory, 'frameworks', 'yui')
+Compass::Frameworks.register('yui', yui_dir)

data/lib/compass/frameworks.rb

@@ -0,0 +1,27 @@
+module Compass
+  module Frameworks
+    ALL = []
+    class Framework
+      attr_accessor :name
+      attr_accessor :path
+      def initialize(name, path)
+        self.name = name
+        self.path = path
+      end
+      def template_directory
+        File.join(self.path, 'templates')
+      end
+      def stylesheets_directory
+        File.join(self.path, 'stylesheets')
+      end
+    end
+    def register(name, path)
+      ALL << Framework.new(name, path)
+    end
+    module_function :register
+  end
+end
+
+require File.join(File.dirname(__FILE__), 'frameworks', 'compass')
+require File.join(File.dirname(__FILE__), 'frameworks', 'blueprint')
+require File.join(File.dirname(__FILE__), 'frameworks', 'yui')

data/lib/compass/merb.rb

@@ -0,0 +1,43 @@
+# To configure Merb to use compass do the following:
+# Merb::BootLoader.after_app_loads do
+#   require 'merb-haml'
+#   require 'compass'
+# end
+#
+# To use a different sass stylesheets locations as is recommended by compass
+# add this configuration to your configuration block:
+#
+# Merb::Config.use do |c|
+#   c[:compass] = {
+#     :stylesheets => 'app/stylesheets',
+#     :compiled_stylesheets => 'public/stylesheets/compiled'
+#   }
+# end
+
+Merb::BootLoader.after_app_loads do
+  #set up sass if haml load didn't do it -- this happens when using a non-default stylesheet location.
+  unless defined?(Sass::Plugin)
+    require "sass/plugin" 
+    Sass::Plugin.options = Merb::Config[:sass] if Merb::Config[:sass]
+  end
+
+  # default the compass configuration if they didn't set it up yet.
+  Merb::Config[:compass] ||= {}
+  
+  # default sass stylesheet location unless configured to something else
+  Merb::Config[:compass][:stylesheets] ||= Merb.dir_for(:stylesheet) / "sass"
+  
+  # default sass css location unless configured to something else
+  Merb::Config[:compass][:compiled_stylesheets] ||= Merb.dir_for(:stylesheet)
+  
+  #define the template hash for the project stylesheets as well as the framework stylesheets.
+  template_location = {
+    Merb::Config[:compass][:stylesheets] => Merb::Config[:compass][:compiled_stylesheets]
+  }
+  Compass::Frameworks::ALL.each do |framework|
+    template_location[framework.stylesheets_directory] = Merb::Config[:compass][:compiled_stylesheets]
+  end
+  
+  #configure Sass to know about all these sass locations.
+  Sass::Plugin.options[:template_location] = template_location
+end

data/lib/compass/test_case.rb

@@ -0,0 +1,37 @@
+module Compass
+  # Write your unit test like this if you want to make sure all your stylesheets compile.
+  #
+  # require 'compass/test_case'
+  # class StylesheetsTest < Compass::TestCase
+  #   def test_stylesheets
+  #     my_sass_files.each do |sass_file|
+  #       assert_compiles(sass_file) do |result|
+  #         assert_not_blank result
+  #       end
+  #     end
+  #   end
+  #   protected
+  #   def my_sass_files
+  #     Dir.glob(File.expand_path(File.join(File.dirname(__FILE__), "../..", "app/stylesheets/**/[^_]*.sass")))
+  #   end
+  # end
+  class TestCase < Test::Unit::TestCase
+    def setup
+      @last_compile = nil
+    end
+
+    def compile(stylesheet)
+      input =  open(stylesheet)
+      template = input.read()
+      input.close()
+      @last_compile = ::Sass::Engine.new(template,
+        ::Sass::Plugin.engine_options(:style => :compact, :filename => stylesheet)).render
+      yield @last_compile if block_given?
+    end
+
+    def assert_compiles(stylesheet, &block)
+      compile(stylesheet, &block)
+    end
+
+  end
+end

data/lib/compass/validate/COPYRIGHT.html

@@ -0,0 +1,93 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang='en' lang='en'>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+<link rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/base.css" />
+<title>W3C IPR SOFTWARE NOTICE</title>
+</head>
+<body>
+<h1>W3C<sup>&reg;</sup> SOFTWARE NOTICE AND LICENSE</h1>
+
+<h3>Copyright &copy; 1997-2002 <a href="http://www.w3.org/">World
+Wide Web Consortium</a>, (<a
+href="http://www.lcs.mit.edu/">Massachusetts Institute of
+Technology</a>, <a href="http://www.inria.fr/">Institut National de
+Recherche en Informatique et en Automatique</a>, <a
+href="http://www.keio.ac.jp/">Keio University</a>). All Rights
+Reserved. http://www.w3.org/Consortium/Legal/</h3>
+
+<p>This W3C work (including software, documents, or other related
+items) is being provided by the copyright holders under the
+following license. By obtaining, using and/or copying this work,
+you (the licensee) agree that you have read, understood, and will
+comply with the following terms and conditions:</p>
+
+<p>Permission to use, copy, modify, and distribute this software
+and its documentation, with or without modification,&nbsp; for any
+purpose and without fee or royalty is hereby granted, provided that
+you include the following on ALL copies of the software and
+documentation or portions thereof, including modifications, that
+you make:</p>
+
+<ol>
+<li>The full text of this NOTICE in a location viewable to users of
+the redistributed or derivative work.</li>
+
+<li>Any pre-existing intellectual property disclaimers, notices, or
+terms and conditions. If none exist, a short notice of the
+following form (hypertext is preferred, text is permitted) should
+be used within the body of any redistributed or derivative code:
+"Copyright &copy; [$date-of-software] <a
+href="http://www.w3.org/">World Wide Web Consortium</a>, (<a
+href="http://www.lcs.mit.edu/">Massachusetts Institute of
+Technology</a>, <a href="http://www.inria.fr/">Institut National de
+Recherche en Informatique et en Automatique</a>, <a
+href="http://www.keio.ac.jp/">Keio University</a>). All Rights
+Reserved. http://www.w3.org/Consortium/Legal/"</li>
+
+<li>Notice of any changes or modifications to the W3C files,
+including the date changes were made. (We recommend you provide
+URIs to the location from which the code is derived.)</li>
+</ol>
+
+<p>THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND
+COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO, WARRANTIES OF
+MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE
+USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD
+PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.</p>
+
+<p>COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT,
+SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE
+SOFTWARE OR DOCUMENTATION.</p>
+
+<p>The name and trademarks of copyright holders may NOT be used in
+advertising or publicity pertaining to the software without
+specific, written prior permission. Title to copyright in this
+software and any associated documentation will at all times remain
+with copyright holders.</p>
+
+<p>____________________________________</p>
+
+<p>This formulation of W3C's notice and license became active on
+August 14 1998 so as to improve compatibility with GPL. This
+version ensures that W3C software licensing terms are no more
+restrictive than GPL and consequently W3C software may be
+distributed in GPL packages. See the <a
+href="copyright-software-19980519.html">older formulation</a> for
+the policy prior to this date. Please see our <a
+href="IPR-FAQ.html">Copyright FAQ</a> for common questions about
+using materials from our site, including specific terms and
+conditions for packages like libwww, Amaya, and Jigsaw. Other
+questions about this notice can be directed to <a
+href="mailto:site-policy@w3.org">site-policy@w3.org</a>.<br />
+&nbsp;</p>
+
+<p>&nbsp;</p>
+
+<address><a href="http://www.w3.org/Help/Webmaster.html">webmaster</a><br />
+ (last updated $Date: 2004/05/29 04:04:36 $)</address>
+
+</body>
+</html>

data/lib/compass/validate/JIGSAW_COPYRIGHT

@@ -0,0 +1,64 @@
+W3C IPR SOFTWARE NOTICE
+
+Copyright � 1995-1998 World Wide Web Consortium, (Massachusetts Institute of
+Technology, Institut National de Recherche en Informatique et en
+Automatique, Keio University). All Rights Reserved.
+http://www.w3.org/Consortium/Legal/
+
+This W3C work (including software, documents, or other related items) is
+being provided by the copyright holders under the following license. By
+obtaining, using and/or copying this work, you (the licensee) agree that you
+have read, understood, and will comply with the following terms and
+conditions:
+
+Permission to use, copy, and modify this software and its documentation,
+with or without modification,  for any purpose and without fee or royalty is
+hereby granted, provided that you include the following on ALL copies of the
+software and documentation or portions thereof, including modifications,
+that you make:
+
+  1. The full text of this NOTICE in a location viewable to users of the
+     redistributed or derivative work.
+  2. Any pre-existing intellectual property disclaimers, notices, or terms
+     and conditions. If none exist, a short notice of the following form
+     (hypertext is preferred, text is permitted) should be used within the
+     body of any redistributed or derivative code: "Copyright � World Wide
+     Web Consortium, (Massachusetts Institute of Technology, Institut
+     National de Recherche en Informatique et en Automatique, Keio
+     University). All Rights Reserved. http://www.w3.org/Consortium/Legal/"
+  3. Notice of any changes or modifications to the W3C files, including the
+     date changes were made. (We recommend you provide URIs to the location
+     from which the code is derived).
+
+In addition, creators of derivitive works must include the full text of this
+NOTICE in a location viewable to users of the derivitive work.
+
+THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS
+MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT
+LIMITED TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR
+PURPOSE OR THAT THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE
+ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.
+
+COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR
+CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR
+DOCUMENTATION.
+
+The name and trademarks of copyright holders may NOT be used in advertising
+or publicity pertaining to the software without specific, written prior
+permission. Title to copyright in this software and any associated
+documentation will at all times remain with copyright holders.
+
+____________________________________
+
+This formulation of W3C's notice and license became active on August 14
+1998. See the older formulation for the policy prior to this date. Please
+see our Copyright FAQ for common questions about using materials from our
+site, including specific terms and conditions for packages like libwww,
+Amaya, and Jigsaw. Other questions about this notice can be directed to
+site-policy@w3.org .
+
+
+
+
+webmaster
+(last updated 14-Aug-1998)