chriseppstein-compass 0.1.1

data/lib/compass/exec.rb

@@ -0,0 +1,156 @@
+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('-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.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/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/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.rb

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+require File.join(File.dirname(__FILE__), 'compass', 'validator')
+
+# This script will validate the core Compass files. 
+# 
+# The files are not completely valid. This has to do 
+# with a small number of CSS hacks needed to ensure 
+# consistent rendering across browsers.
+#
+# To add your own CSS files for validation, see
+# /lib/compass/validator.rb
+
+Compass::Validator.new.validate

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)