compass-rails31 0.12.0.alpha.0.91a748a

data/lib/compass/app_integration/rails/runtime.rb

@@ -0,0 +1,17 @@
+unless defined?(Compass::RAILS_LOADED)
+  Compass::RAILS_LOADED = true
+  begin
+    require 'action_pack/version'
+    if ActionPack::VERSION::MAJOR >= 3
+      if ActionPack::VERSION::MINOR < 1
+        require 'compass/app_integration/rails/actionpack30'
+      else
+        require 'compass/app_integration/rails/actionpack31'
+      end
+    else
+      require 'compass/app_integration/rails/actionpack2x'
+    end
+  rescue LoadError, NameError
+    $stderr.puts "Compass could not access the rails environment."
+  end
+end

data/lib/compass/app_integration/rails/templates/compass-install-rails.rb

@@ -0,0 +1,78 @@
+# =================================================================
+# Compass Ruby on Rails Installer (template) v.1.0
+# written by Derek Perez (derek@derekperez.com)
+# -----------------------------------------------------------------
+# NOTE: This installer is designed to work as a Rails template,
+# and can only be used with Rails 2.3+.
+# -----------------------------------------------------------------
+# Copyright (c) 2009 Derek Perez
+#
+# 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.
+# =================================================================
+
+# Determine if we use sudo, defaults to true unless we are
+# on win32, cygwin, or mingw32 or they ask us not to
+def sudo_is_an_option?
+  return false if RUBY_PLATFORM =~ /(win|w)32$/ # true if win32, cygwin or mingw32
+  return false if ENV['NO_SUDO'] =~ /true/i
+  return true
+end
+
+puts "==================================================="
+puts "Welcome to the Compass Installer for Ruby on Rails!"
+puts "==================================================="
+puts
+
+# css framework prompt
+css_framework = ask("What CSS Framework install do you want to use with Compass?")
+
+# sass storage prompt
+sass_dir = ask("Where would you like to keep your sass files within your project? (default: 'app/stylesheets')")
+sass_dir = "app/stylesheets" if Compass::Util.blank?(sass_dir)
+
+# compiled css storage prompt
+css_dir = ask("Where would you like Compass to store your compiled css files? (default: 'public/stylesheets/compiled')")
+css_dir = "public/stylesheets/compiled" if Compass::Util.blank?(css_dir)
+
+# use sudo for gem commands?
+use_sudo = nil
+if sudo_is_an_option? # dont give them the option if they are on a system that can't use sudo (aka windows)
+  use_sudo = yes?("Use sudo for the gem commands? (the default for your system is #{sudo_is_an_option? ? 'yes' : 'no'})")
+end
+use_sudo = sudo_is_an_option? if Compass::Util.blank?(use_sudo)
+
+# define dependencies
+gem "haml", :version => ">=3.0.0"
+gem "compass", :version => ">= 0.10.0"
+
+# install and unpack
+rake "gems:install GEM=haml --trace", :sudo => use_sudo
+rake "gems:install GEM=compass --trace", :sudo => use_sudo
+rake "gems:unpack GEM=compass --trace"
+
+# build out compass command
+compass_command = "compass init rails . --css-dir=#{css_dir} --sass-dir=#{sass_dir} "
+compass_command << "--using #{css_framework} " unless Compass::Util.blank?(css_framework)
+
+# integrate it!
+run "haml --rails ."
+run compass_command

data/lib/compass/app_integration/stand_alone.rb

@@ -0,0 +1,22 @@
+%w(configuration_defaults installer).each do |lib|
+  require "compass/app_integration/stand_alone/#{lib}"
+end
+
+module Compass
+  module AppIntegration
+    module StandAlone
+
+      extend self
+
+      def installer(*args)
+        Installer.new(*args)
+      end
+
+      def configuration
+        Compass::Configuration::Data.new('stand_alone').
+          extend(ConfigurationDefaults)
+      end
+
+    end
+  end
+end

data/lib/compass/app_integration/stand_alone/configuration_defaults.rb

@@ -0,0 +1,32 @@
+module Compass
+  module AppIntegration
+    module StandAlone
+      module ConfigurationDefaults
+        def default_project_type
+          :stand_alone
+        end
+
+        def sass_dir_without_default
+          "sass"
+        end
+
+        def javascripts_dir_without_default
+          "javascripts"
+        end
+
+        def css_dir_without_default
+          "stylesheets"
+        end
+
+        def images_dir_without_default
+          "images"
+        end
+
+        def default_cache_dir
+          ".sass-cache"
+        end
+      end
+
+    end
+  end
+end

data/lib/compass/app_integration/stand_alone/installer.rb

@@ -0,0 +1,83 @@
+module Compass
+  module Installers
+    class Base
+    end
+    class ManifestInstaller < Base
+    end
+  end
+
+  module AppIntegration
+    module StandAlone
+      class Installer < Compass::Installers::ManifestInstaller
+
+        def init
+          directory targetize("")
+          super
+        end
+
+        def write_configuration_files(config_file = nil)
+          config_file ||= targetize('config.rb')
+          write_file config_file, config_contents
+        end
+
+        def config_files_exist?
+          File.exists? targetize('config.rb')
+        end
+
+        def config_contents
+          project_path, Compass.configuration.project_path = Compass.configuration.project_path, nil
+          Compass.configuration.serialize
+        ensure
+          Compass.configuration.project_path = project_path
+        end
+
+        def prepare
+          write_configuration_files unless config_files_exist? || !@manifest.generate_config?
+        end
+
+        def completed_configuration
+          nil
+        end
+
+        def finalize(options = {})
+          if options[:create] && !manifest.welcome_message_options[:replace]
+            puts <<-NEXTSTEPS
+
+*********************************************************************
+Congratulations! Your compass project has been created.
+
+You may now add and edit sass stylesheets in the #{Compass.configuration.sass_dir} subdirectory of your project.
+
+Sass files beginning with an underscore are called partials and won't be
+compiled to CSS, but they can be imported into other sass stylesheets.
+
+You can configure your project by editing the config.rb configuration file.
+
+You must compile your sass stylesheets into CSS when they change.
+This can be done in one of the following ways:
+  1. To compile on demand:
+     compass compile [path/to/project]
+  2. To monitor your project for changes and automatically recompile:
+     compass watch [path/to/project]
+
+More Resources:
+  * Website: http://compass-style.org/
+  * Sass: http://sass-lang.com
+  * Community: http://groups.google.com/group/compass-users/
+
+NEXTSTEPS
+          end
+          puts manifest.welcome_message if manifest.welcome_message
+          if manifest.has_stylesheet? && !manifest.welcome_message_options[:replace]
+            puts "\nTo import your new stylesheets add the following lines of HTML (or equivalent) to your webpage:"
+            puts stylesheet_links
+          end
+        end
+
+        def compilation_required?
+          @manifest.compile?
+        end
+      end
+    end
+  end
+end

data/lib/compass/browser_support.rb

@@ -0,0 +1,62 @@
+module Compass
+  module BrowserSupport
+    extend self
+
+    ASPECTS = %w(webkit moz o ms svg pie css2)
+
+    SIMPLE_FUNCTIONS = {
+           "image" => %w(), # No browsers implement this yet.
+      "cross-fade" => %w()  # No browsers implement this yet.
+    }
+
+    # Adds support for one or more aspects for the given simple function
+    # Example:
+    #
+    #   Compass::BrowserSupport.add_support("image", "moz", "webkit")
+    #   # => Adds support for moz and webkit to the image() function.
+    #
+    # This function can be called one or more times in a compass configuration
+    # file in order to add support for new, simple browser functions without
+    # waiting for a new compass release.
+    def add_support(function, *aspects)
+      aspects.each do |aspect|
+        unless ASPECTS.include?(aspect)
+          Compass::Util.compass_warn "Unknown support aspect: #{aspect}"
+          next
+        end
+        unless supports?(function, aspect)
+          SIMPLE_FUNCTIONS[function.to_s] ||= []
+          SIMPLE_FUNCTIONS[function.to_s] << aspect.to_s
+        end
+      end
+    end
+
+    # Removes support for one or more aspects for the given simple function
+    # Example:
+    #
+    #   Compass::BrowserSupport.remove_support("image", "o", "ms")
+    #   # => Adds support for moz and webkit to the image() function.
+    #
+    # This function can be called one or more times in a compass configuration
+    # file in order to remove support for simple functions that no longer need to
+    # a prefix without waiting for a new compass release.
+    def remove_support(function, *aspects)
+      aspects.each do |aspect|
+        unless ASPECTS.include?(aspect)
+          Compass::Util.compass_warn "Unknown support aspect: #{aspect}"
+          next
+        end
+        SIMPLE_FUNCTIONS[function.to_s].reject!{|a| a == aspect.to_s}
+      end
+    end
+
+    def supports?(function, aspect)
+      SIMPLE_FUNCTIONS.has_key?(function.to_s) && SIMPLE_FUNCTIONS[function.to_s].include?(aspect.to_s)
+    end
+
+    def has_aspect?(function)
+      SIMPLE_FUNCTIONS.has_key?(function.to_s) && SIMPLE_FUNCTIONS[function.to_s].size > 0
+    end
+
+  end
+end

data/lib/compass/commands.rb

@@ -0,0 +1,11 @@
+module Compass::Commands
+end
+
+require 'compass/commands/registry'
+
+%w(base generate_grid_background default help list_frameworks project_base
+   update_project watch_project create_project clean_project imports installer_command
+   print_version project_stats stamp_pattern sprite validate_project
+   write_configuration interactive unpack_extension).each do |lib|
+  require "compass/commands/#{lib}"
+end

data/lib/compass/commands/base.rb

@@ -0,0 +1,44 @@
+module Compass
+  module Commands
+    class Base
+      def self.register(command_name)
+        Compass::Commands[command_name] = self
+      end
+
+      include Actions
+
+      attr_accessor :working_path, :options
+
+      def initialize(working_path, options)
+        self.working_path = working_path.to_s
+        self.options = options
+      end
+      
+      def execute
+        perform
+      end
+
+      def perform
+        raise StandardError.new("Not Implemented")
+      end
+
+      def successful?
+        !@failed
+      end
+
+      def failed!
+        @failed = true
+      end
+
+      protected
+
+      def framework
+        unless Compass::Frameworks[options[:framework]]
+          raise Compass::Error.new("No such framework: #{options[:framework].inspect}")
+        end
+        Compass::Frameworks[options[:framework]]
+      end
+
+    end
+  end
+end

data/lib/compass/commands/clean_project.rb

@@ -0,0 +1,79 @@
+require 'compass/commands/project_base'
+require 'compass/compiler'
+
+module Compass
+  module Commands
+    module CleanProjectOptionsParser
+      def set_options(opts)
+        opts.banner = %Q{
+          Usage: compass clean [path/to/project] [options]
+
+          Description:
+          Remove generated files and the sass cache.
+
+          Options:
+        }.split("\n").map{|l| l.gsub(/^ */,'')}.join("\n")
+
+        super
+      end
+    end
+
+    class CleanProject < UpdateProject
+
+      register :clean
+
+      def initialize(working_path, options)
+        super
+        assert_project_directory_exists!
+      end
+
+      def perform
+        compiler = new_compiler_instance
+        compiler.clean!
+        Compass::SpriteImporter.find_all_sprite_map_files(Compass.configuration.images_path).each do |sprite|
+          remove sprite
+        end
+      end
+
+      def determine_cache_location
+        Compass.configuration.cache_path || Sass::Plugin.options[:cache_location] || File.join(working_path, ".sass-cache")
+      end
+
+      class << self
+        def option_parser(arguments)
+          parser = Compass::Exec::CommandOptionParser.new(arguments)
+          parser.extend(Compass::Exec::GlobalOptionsParser)
+          parser.extend(Compass::Exec::ProjectOptionsParser)
+          parser.extend(CleanProjectOptionsParser)
+        end
+
+        def usage
+          option_parser([]).to_s
+        end
+
+        def primary; true; end
+
+        def description(command)
+          "Remove generated files and the sass cache"
+        end
+
+        def parse!(arguments)
+          parser = option_parser(arguments)
+          parser.parse!
+          parse_arguments!(parser, arguments)
+          parser.options
+        end
+
+        def parse_arguments!(parser, arguments)
+          if arguments.size > 0
+            parser.options[:project_name] = arguments.shift if File.directory?(arguments.first)
+            unless arguments.empty?
+              parser.options[:sass_files] = arguments.dup
+              parser.options[:force] = true
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/compass/commands/create_project.rb

@@ -0,0 +1,131 @@
+require 'fileutils'
+require 'compass/commands/stamp_pattern'
+
+module Compass
+  module Commands
+    module CreateProjectOptionsParser
+      def set_options(opts)
+
+        if $command == "create"
+          opts.banner = %Q{
+            Usage: compass create path/to/project [options]
+
+            Description:
+            Create a new compass project at the path specified.
+
+            Options:
+          }.split("\n").map{|l| l.gsub(/^ */,'')}.join("\n")
+
+          opts.on_tail("--bare", "Don't generate any Sass or CSS files.") do
+            self.options[:bare] = true
+          end
+        else
+          opts.banner = %Q{
+            Usage: compass init project_type path/to/project [options]
+
+            Description:
+            Initialize an existing project at the path specified.
+
+            Supported Project Types:
+            * rails
+
+            Options:
+          }.split("\n").map{|l| l.gsub(/^ */,'')}.join("\n").strip
+        end
+
+        opts.on("--using PATTERN", "A framework's pattern to use when creating the project.") do |framework|
+          framework = framework.split('/', 2)
+          self.options[:framework] = framework[0]
+          self.options[:pattern] = framework[1]
+        end
+
+        opts.on("-x", "--syntax SYNTAX", [:sass, :scss], "Specify the syntax to use when generating stylesheets.", "One of sass or scss. Defaults to scss.") do |syntax|
+          self.options[:preferred_syntax] = syntax
+        end
+
+        opts.on("--prepare", "Prepare the project by only creating configuration files.") do
+          self.options[:prepare] = true
+        end
+
+        super
+
+      end
+    end
+
+    class CreateProject < StampPattern
+
+      register :create
+      register :init
+
+      class << self
+        def option_parser(arguments)
+          parser = Compass::Exec::CommandOptionParser.new(arguments)
+          parser.extend(Compass::Exec::GlobalOptionsParser)
+          parser.extend(Compass::Exec::ProjectOptionsParser)
+          parser.extend(CreateProjectOptionsParser)
+        end
+
+        def usage
+          option_parser([]).to_s
+        end
+
+        def description(command)
+          if command.to_sym == :create
+            "Create a new compass project"
+          else
+            "Add compass to an existing project"
+          end
+        end
+
+        def primary; true; end
+
+        def parse!(arguments)
+          parser = option_parser(arguments)
+          parse_options!(parser, arguments)
+          parse_arguments!(parser, arguments)
+          if parser.options[:framework] && parser.options[:bare]
+            raise Compass::Error, "A bare project cannot be created when a framework is specified."
+          end
+          set_default_arguments(parser)
+          parser.options
+        end
+
+        def parse_init!(arguments)
+          parser = option_parser(arguments)
+          parse_options!(parser, arguments)
+          if arguments.size > 0
+            parser.options[:project_type] = arguments.shift.to_sym
+          end
+          parse_arguments!(parser, arguments)
+          set_default_arguments(parser)
+          parser.options
+        end
+
+        def parse_options!(parser, arguments)
+          parser.parse!
+          parser
+        end
+
+        def parse_arguments!(parser, arguments)
+          if arguments.size == 1
+            parser.options[:project_name] = arguments.shift
+          elsif arguments.size == 0
+            # default to the current directory.
+          else
+            raise Compass::Error, "Too many arguments were specified."
+          end
+        end
+
+        def set_default_arguments(parser)
+          parser.options[:framework] ||= :compass
+          parser.options[:pattern] ||= "project"
+        end
+      end
+
+      def is_project_creation?
+        true
+      end
+
+    end
+  end
+end