compass 0.8.16

data/lib/compass/app_integration.rb

@@ -0,0 +1,5 @@
+# If we're running inside Rails
+require File.join(File.dirname(__FILE__), 'app_integration', 'rails') if defined?(ActionController::Base)
+
+# If we're running inside Merb
+require File.join(File.dirname(__FILE__), 'app_integration', 'merb') if defined?(Merb::Plugins)

data/lib/compass/app_integration/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/app_integration/rails.rb

@@ -0,0 +1,12 @@
+unless defined?(Compass::RAILS_LOADED)
+  Compass::RAILS_LOADED = true
+  require File.join(File.dirname(__FILE__), 'rails', 'action_controller')
+  require File.join(File.dirname(__FILE__), 'rails', 'sass_plugin')
+  require File.join(File.dirname(__FILE__), 'rails', 'urls')
+  # Wierd that this has to be re-included to pick up sub-modules. Ruby bug?
+  class Sass::Script::Functions::EvaluationContext
+    include Sass::Script::Functions
+    private
+    include ActionView::Helpers::AssetTagHelper
+  end
+end

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

@@ -0,0 +1,15 @@
+# :stopdoc:
+module ActionController
+  class Base
+    def process_with_compass(*args)
+      Sass::Plugin.rails_controller = self
+      begin
+        process_without_compass(*args)
+      ensure
+        Sass::Plugin.rails_controller = nil
+      end
+    end
+    alias_method_chain :process, :compass
+  end
+end
+# :startdoc:

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

@@ -0,0 +1,5 @@
+module Sass::Plugin
+  class << self
+    attr_accessor :rails_controller
+  end
+end

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

@@ -0,0 +1,80 @@
+# =================================================================
+# 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.
+# =================================================================
+puts "==================================================="
+puts "Welcome to the Compass Installer for Ruby on Rails!"
+puts "==================================================="
+puts
+
+# css framework prompt
+css_framework = ask("What CSS Framework do you want to use with Compass? (default: 'blueprint')")
+css_framework = "blueprint" if css_framework.blank?
+
+# 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 sass_dir.blank?
+
+# 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 css_dir.blank?
+
+# define dependencies
+gem "haml", :lib => "haml", :version => ">=2.2.0"
+gem "chriseppstein-compass", :source => "http://gems.github.com/", :lib => "compass"
+
+# install and unpack
+rake "gems:install GEM=haml", :sudo => true
+rake "gems:install GEM=chriseppstein-compass", :sudo => true
+rake "gems:unpack GEM=chriseppstein-compass"
+
+# load any compass framework plugins
+if css_framework =~ /960/
+  gem "chriseppstein-compass-960-plugin", :source => "http://gems.github.com", :lib => "ninesixty"
+  rake "gems:install GEM=chriseppstein-compass-960-plugin", :sudo => true
+  rake "gems:unpack GEM=chriseppstein-compass-960-plugin"
+  css_framework = "960" # rename for command
+  plugin_require = "-r ninesixty"
+end
+
+# build out compass command
+compass_command = "compass --rails -f #{css_framework} . --css-dir=#{css_dir} --sass-dir=#{sass_dir} "
+compass_command << plugin_require if plugin_require
+
+# Require compass during plugin loading
+file 'vendor/plugins/compass/init.rb', <<-CODE
+# This is here to make sure that the right version of sass gets loaded (haml 2.2) by the compass requires.
+require 'compass'
+CODE
+
+# integrate it!
+run "haml --rails ."
+run compass_command
+
+puts "Compass (with #{css_framework}) is all setup, have fun!"

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

@@ -0,0 +1,14 @@
+module Compass::SassExtensions::Functions::Urls
+  def image_url_with_rails_integration(path)
+    if (@controller = Sass::Plugin.rails_controller) && @controller.respond_to?(:request) && @controller.request
+      begin
+        Sass::Script::String.new "url(#{image_path(path.value)})"
+      ensure
+        @controller = nil
+      end
+    else
+      image_url_without_rails_integration(path)
+    end
+  end
+  alias_method_chain :image_url, :rails_integration
+end

data/lib/compass/commands/base.rb

@@ -0,0 +1,33 @@
+module Compass
+  module Commands
+    class Base
+
+      include Actions
+
+      attr_accessor :working_path, :options
+
+      def initialize(working_path, options)
+        self.working_path = working_path
+        self.options = options
+      end
+      
+      def execute
+        perform
+      end
+
+      def perform
+        raise StandardError.new("Not Implemented")
+      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/create_project.rb

@@ -0,0 +1,19 @@
+require 'fileutils'
+require File.join(File.dirname(__FILE__), 'stamp_pattern')
+require File.join(File.dirname(__FILE__), 'update_project')
+
+module Compass
+  module Commands
+    class CreateProject < StampPattern
+
+      def initialize(working_path, options)
+        super(working_path, options.merge(:pattern => "project", :pattern_name => nil))
+      end
+
+      def is_project_creation?
+        true
+      end
+
+    end
+  end
+end

data/lib/compass/commands/generate_grid_background.rb

@@ -0,0 +1,24 @@
+require File.join(File.dirname(__FILE__), 'project_base')
+require File.join(File.dirname(__FILE__), 'update_project')
+require File.join(File.dirname(__FILE__), '..', 'grid_builder')
+
+module Compass
+  module Commands
+    class GenerateGridBackground < ProjectBase
+      include Actions
+      def initialize(working_path, options)
+        super
+        assert_project_directory_exists!
+      end
+
+      def perform
+        column_width, gutter_width = options[:grid_dimensions].split(/\+/).map{|d| d.to_i}
+        unless GridBuilder.new(options.merge(:column_width => column_width, :gutter_width => gutter_width, :output_path => projectize(project_images_subdirectory), :working_path => self.working_path)).generate!
+          puts "ERROR: Some library dependencies appear to be missing."
+          puts "Have you installed rmagick? If not, please run:"
+          puts "sudo gem install rmagick"
+        end
+      end
+    end
+  end
+end

data/lib/compass/commands/installer_command.rb

@@ -0,0 +1,31 @@
+require File.join(Compass.lib_directory, 'compass', 'installers')
+
+module Compass
+  module Commands
+    module InstallerCommand
+      include Compass::Installers
+
+      def configure!
+        read_project_configuration
+        Compass.configuration.set_maybe(options)
+        Compass.configuration.default_all(installer.configuration_defaults)
+        Compass.configuration.set_defaults!
+      end
+
+      def installer
+        @installer ||= case options[:project_type]
+        when :stand_alone
+          StandAloneInstaller.new *installer_args
+        when :rails
+          RailsInstaller.new *installer_args
+        else
+          raise "Unknown project type: #{options[:project_type].inspect}"
+        end
+      end
+
+      def installer_args
+        [template_directory(options[:pattern]), project_directory, options]
+      end
+    end
+  end
+end

data/lib/compass/commands/list_frameworks.rb

@@ -0,0 +1,16 @@
+module Compass
+  module Commands
+    class ListFrameworks
+      attr_accessor :options
+      def initialize(working_path, options)
+        self.options = options
+      end
+  
+      def execute
+        Compass::Frameworks::ALL.each do |framework|
+          puts framework.name
+        end
+      end
+    end
+  end
+end

data/lib/compass/commands/print_version.rb

@@ -0,0 +1,23 @@
+module Compass
+  module Commands
+    class PrintVersion
+      attr_accessor :options
+      def initialize(working_path, options)
+        self.options = options
+      end
+  
+      def execute
+        if options[:quiet]
+          # The quiet option may make scripting easier
+          puts ::Compass.version[:string]
+        else
+          lines = []
+          lines << "Compass #{::Compass.version[:string]}"
+          lines << "Copyright (c) 2008-2009 Chris Eppstein"
+          lines << "Released under the MIT License."
+          puts lines.join("\n")
+        end
+      end
+    end
+  end
+end

data/lib/compass/commands/project_base.rb

@@ -0,0 +1,112 @@
+require 'fileutils'
+require 'pathname'
+require File.join(File.dirname(__FILE__), 'base')
+require File.join(File.dirname(__FILE__), 'installer_command')
+
+module Compass
+  module Commands
+    class ProjectBase < Base
+      attr_accessor :project_directory, :project_name, :options
+
+      def initialize(working_path, options = {})
+        super(working_path, options)
+        self.project_name = determine_project_name(working_path, options)
+        Compass.configuration.project_path = determine_project_directory(working_path, options)
+      end
+
+      def execute
+        configure!
+        super
+      end
+
+      protected
+
+      def configure!
+        read_project_configuration
+        Compass.configuration.set_maybe(options)
+        Compass.configuration.set_defaults!
+      end
+
+      def projectize(path)
+        File.join(project_directory, separate(path))
+      end
+
+      def project_directory
+        Compass.configuration.project_path
+      end
+
+      def project_css_subdirectory
+        Compass.configuration.css_dir
+      end
+
+      def project_src_subdirectory
+        Compass.configuration.sass_dir
+      end
+
+      def project_images_subdirectory
+        Compass.configuration.images_dir
+      end
+
+      # Read the configuration file for this project
+      def read_project_configuration
+        if file = detect_configuration_file
+          Compass.configuration.parse(file) if File.readable?(file)
+        end
+      end
+
+      def explicit_config_file_must_be_readable?
+        true
+      end
+
+      # TODO: Deprecate the src/config.rb location.
+      KNOWN_CONFIG_LOCATIONS = [".compass/config.rb", "config/compass.config", "config.rb", "src/config.rb"]
+
+      # Finds the configuration file, if it exists in a known location.
+      def detect_configuration_file
+        if options[:configuration_file]
+          if explicit_config_file_must_be_readable? && !File.readable?(options[:configuration_file])
+            raise Compass::Error, "Configuration file, #{file}, not found or not readable."
+          end
+          return options[:configuration_file]
+        end
+        KNOWN_CONFIG_LOCATIONS.map{|f| projectize(f)}.detect{|f| File.exists?(f)}
+      end
+
+      def assert_project_directory_exists!
+        if File.exists?(project_directory) && !File.directory?(project_directory)
+          raise Compass::FilesystemConflict.new("#{project_directory} is not a directory.")
+        elsif !File.directory?(project_directory)
+          raise Compass::Error.new("#{project_directory} does not exist.")
+        end
+      end
+
+      private
+
+      def determine_project_name(working_path, options)
+        if options[:project_name]
+          File.basename(strip_trailing_separator(options[:project_name]))
+        else
+          File.basename(working_path)
+        end
+      end
+
+      def determine_project_directory(working_path, options)
+        if options[:project_name]
+          if absolute_path?(options[:project_name])
+            options[:project_name]
+          else
+            File.join(working_path, options[:project_name])
+          end
+        else
+          working_path
+        end
+      end
+
+      def absolute_path?(path)
+        # This is only going to work on unix, gonna need a better implementation.
+        path.index(File::SEPARATOR) == 0
+      end
+
+    end
+  end
+end