compass 0.8.17 → 0.10.0.pre1

data/features/step_definitions/extension_steps.rb

@@ -0,0 +1,13 @@
+Given /^the "([^\"]*)" directory exists$/ do |directory|
+  FileUtils.mkdir_p directory
+end
+
+Given /^and I have a fake extension at (.*)$/ do |directory|
+  FileUtils.mkdir_p File.join(directory, 'stylesheets')
+  FileUtils.mkdir_p File.join(directory, 'templates/project')
+end
+
+Then /^the list of frameworks includes "([^\"]*)"$/ do |framework|
+  @last_result.split("\n").map{|f| f.strip}.should include(framework)
+end
+

data/lib/compass.rb

@@ -1,12 +1,13 @@
 module Compass
 end
 
-['dependencies', 'sass_extensions', 'core_ext', 'version', 'errors'].each do |file|
-  require File.join(File.dirname(__FILE__), 'compass', file)
+%w(dependencies sass_extensions core_ext version errors).each do |lib|
+  require "compass/#{lib}"
 end
 
 module Compass
   extend Compass::Version
+  VERSION = "#{version[:major]}.#{version[:minor]}.#{version[:patch]}"
   def base_directory
     File.expand_path(File.join(File.dirname(__FILE__), '..'))
   end
@@ -16,8 +17,6 @@ module Compass
   module_function :base_directory, :lib_directory
 end
 
-require File.join(File.dirname(__FILE__), 'compass', 'configuration')
-require File.join(File.dirname(__FILE__), 'compass', 'frameworks')
-require File.join(File.dirname(__FILE__), 'compass', 'app_integration')
-
-
+%w(configuration frameworks app_integration).each do |lib|
+  require "compass/#{lib}"
+end

data/lib/compass/actions.rb

@@ -32,6 +32,7 @@ module Compass
     def write_file(file_name, contents, options = nil, binary = false)
       options ||= self.options if self.respond_to?(:options)
       skip_write = options[:dry_run]
+      contents = process_erb(contents, options[:erb]) if options[:erb]
       if File.exists?(file_name)
         existing_contents = IO.read(file_name)
         if existing_contents == contents
@@ -47,7 +48,7 @@ module Compass
         logger.record :create, basename(file_name)
       end
       if skip_write
-        FileUtils.touch file_name
+        FileUtils.touch file_name unless options[:dry_run]
       else
         mode = "w"
         mode << "b" if binary
@@ -57,6 +58,11 @@ module Compass
       end
     end
 
+    def process_erb(contents, ctx = nil)
+      ctx = Object.new.instance_eval("binding") unless ctx.is_a? Binding
+      ERB.new(contents).result(ctx)
+    end
+
     # Compile one Sass file
     def compile(sass_filename, css_filename, options)
       if options[:force] || Sass::Plugin.exact_stylesheet_needs_update?(css_filename, sass_filename)

data/lib/compass/app_integration.rb

@@ -1,5 +1,24 @@
-# If we're running inside Rails
-require File.join(File.dirname(__FILE__), 'app_integration', 'rails') if defined?(ActionController::Base)
+%w(stand_alone rails merb).each do |lib|
+  require "compass/app_integration/#{lib}"
+end
 
-# If we're running inside Merb
-require File.join(File.dirname(__FILE__), 'app_integration', 'merb') if defined?(Merb::Plugins)
+module Compass
+  module AppIntegration
+    module Helpers
+      def lookup(project_type)
+        eval "Compass::AppIntegration::#{camelize(project_type)}"
+      rescue NameError
+        raise Compass::Error, "No application integration exists for #{project_type}"
+      end
+
+      protected
+
+      # Stolen from ActiveSupport
+      def camelize(s)
+        s.to_s.gsub(/\/(.?)/) { "::#{$1.upcase}" }.gsub(/(?:^|_)(.)/) { $1.upcase }
+      end
+
+    end
+    extend Helpers
+  end
+end

data/lib/compass/app_integration/merb.rb

@@ -1,43 +1 @@
-# 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
+require 'compass/app_integration/merb/runtime' if defined?(Merb::Plugins)

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

@@ -0,0 +1,63 @@
+# To configure Merb to use compass do the following:
+# 
+# Add dependencies to config/dependencies.rb
+# 
+# dependency "haml", ">=2.2.0" 
+# dependency "merb-haml", merb_gems_version
+# dependency "chriseppstein-compass", :require_as => 'compass'
+# 
+# 
+# To use a different sass stylesheets locations as is recommended by compass
+# add this configuration to your configuration block:
+#
+# Merb::BootLoader.before_app_loads do
+#   Merb::Plugins.config[:compass] = {
+#     :stylesheets => "app/stylesheets",
+#     :compiled_stylesheets => "public/stylesheets/compiled"
+#   }
+# end
+# 
+module Compass
+  def self.setup_template_location
+    # default the compass configuration if they didn't set it up yet.
+    Merb::Plugins.config[:compass] ||= {}
+
+    # default sass stylesheet location unless configured to something else
+    Merb::Plugins.config[:compass][:stylesheets] ||= Merb.dir_for(:stylesheet) / "sass"
+
+    # default sass css location unless configured to something else
+    Merb::Plugins.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::Plugins.config[:compass][:stylesheets] => Merb::Plugins.config[:compass][:compiled_stylesheets]
+    }
+    Compass::Frameworks::ALL.each do |framework|
+      template_location[framework.stylesheets_directory] = Merb::Plugins.config[:compass][:compiled_stylesheets]
+    end
+
+    # merge existing template locations if present
+    if Merb::Plugins.config[:sass][:template_location].is_a?(Hash)
+      template_location.merge!(Merb::Plugins.config[:sass][:template_location])
+      Merb::Plugins.config[:sass][:template_location] = template_location
+    end
+
+    #configure Sass to know about all these sass locations.
+    Sass::Plugin.options[:template_location] = template_location
+  end
+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" 
+    if Merb::Plugins.config[:sass]
+      Sass::Plugin.options = Merb::Plugins.config[:sass] 
+    # support old (deprecatd Merb::Config[:sass] option)
+    elsif Merb::Config[:sass] 
+      Sass::Plugin.options = Merb::Config[:sass] 
+    end
+  end
+
+  Compass.setup_template_location
+end

data/lib/compass/app_integration/rails.rb

@@ -1,12 +1,26 @@
-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
+%w(configuration_defaults installer).each do |lib|
+  require "compass/app_integration/rails/#{lib}"
+end
+
+require 'compass/app_integration/rails/runtime' if defined?(ActionController::Base)
+
+
+module Compass
+  module AppIntegration
+    module Rails
+
+      extend self
+
+      def installer(*args)
+        Installer.new(*args)
+      end
+
+      def configuration
+        Compass::Configuration::Data.new('rails').
+          extend(ConfigurationDefaults)
+      end
+
+    end
   end
 end
+

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

@@ -0,0 +1,45 @@
+module Compass
+  module AppIntegration
+    module Rails
+      module ConfigurationDefaults
+
+        def project_type_without_default
+          :rails
+        end
+
+        def default_images_dir
+          File.join("public", "images")
+        end
+
+        def default_fonts_dir
+          File.join("public", "fonts")
+        end
+
+        def default_javascripts_dir
+          File.join("public", "javascripts")
+        end
+
+        def default_http_images_path
+          "/images"
+        end
+
+        def default_http_javascripts_path
+          "/javascripts"
+        end
+
+        def default_http_fonts_path
+          "/fonts"
+        end
+
+        def default_http_stylesheets_path
+          "/stylesheets"
+        end
+
+        def default_extensions_dir
+          "vendor/plugins/compass/extensions"
+        end
+
+      end
+    end
+  end
+end

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

@@ -0,0 +1,127 @@
+module Compass
+  module Installers
+    class Base
+    end
+    class ManifestInstaller < Base
+    end
+  end
+
+  module AppIntegration
+    module Rails    
+      class Installer < Compass::Installers::ManifestInstaller
+
+        def completed_configuration
+          config = {}
+          config[:sass_dir] = prompt_sass_dir unless sass_dir_without_default
+          config[:css_dir] = prompt_css_dir unless css_dir_without_default
+          config unless config.empty?
+        end
+
+        def write_configuration_files(config_file = nil)
+          config_file ||= targetize('config/compass.rb')
+          directory File.dirname(config_file)
+          write_file config_file, config_contents
+          directory File.dirname(targetize('config/initializers/compass.rb'))
+          write_file targetize('config/initializers/compass.rb'), initializer_contents
+        end
+
+        def config_files_exist?
+          File.exists?(targetize('config/compass.config')) &&
+          File.exists?(targetize('config/initializers/compass.rb'))
+        end
+
+        def prepare
+          write_configuration_files unless config_files_exist?
+        end
+
+        def finalize(options = {})
+          if options[:create]
+            puts <<-NEXTSTEPS
+
+  Congratulations! Your rails project has been configured to use Compass.
+  Sass will automatically compile your stylesheets during the next
+  page request and keep them up to date when they change.
+  Make sure you restart your server!
+  NEXTSTEPS
+          end
+          if manifest.has_stylesheet?
+            puts "\nNext add these lines to the head of your layouts:\n\n"
+            puts stylesheet_links
+            puts "\n(You are using haml, aren't you?)"
+          end
+        end
+
+
+        def install_location_for_html(to, options)
+          separate("public/#{pattern_name_as_dir}#{to}")
+        end
+
+        def prompt_sass_dir
+          recommended_location = separate('app/stylesheets')
+          default_location = separate('public/stylesheets/sass')
+          print %Q{Compass recommends that you keep your stylesheets in #{recommended_location}
+  instead of the Sass default location of #{default_location}.
+  Is this OK? (Y/n) }
+          answer = gets.downcase[0]
+          answer == ?n ? default_location : recommended_location
+        end
+
+        def prompt_css_dir
+          recommended_location = separate("public/stylesheets/compiled")
+          default_location = separate("public/stylesheets")
+          puts
+          print %Q{Compass recommends that you keep your compiled css in #{recommended_location}/
+  instead the Sass default of #{default_location}/.
+  However, if you're exclusively using Sass, then #{default_location}/ is recommended.
+  Emit compiled stylesheets to #{recommended_location}/? (Y/n) }
+          answer = gets.downcase[0]
+          answer == ?n ? default_location : recommended_location
+        end
+
+        def config_contents
+          Compass.configuration.serialize do |prop, value|
+            if prop == :project_path
+              "project_path = RAILS_ROOT if defined?(RAILS_ROOT)\n"
+            elsif prop == :output_style
+              ""
+            end
+          end
+        end
+
+        def initializer_contents
+          %Q{require 'compass'
+  # If you have any compass plugins, require them here.
+  Compass.configuration.parse(File.join(RAILS_ROOT, "config", "compass.config"))
+  Compass.configuration.environment = RAILS_ENV.to_sym
+  Compass.configure_sass_plugin!
+  }
+        end
+
+        def stylesheet_prefix
+          if css_dir.length >= 19
+            "#{css_dir[19..-1]}/"
+          else
+            nil
+          end
+        end
+
+        def stylesheet_links
+          html = "%head\n"
+          manifest.each_stylesheet do |stylesheet|
+            # Skip partials.
+            next if File.basename(stylesheet.from)[0..0] == "_"
+            ss_line = "  = stylesheet_link_tag '#{stylesheet_prefix}#{stylesheet.to.sub(/\.sass$/,'.css')}'"
+            if stylesheet.options[:media]
+              ss_line += ", :media => '#{stylesheet.options[:media]}'"
+            end
+            if stylesheet.options[:condition]
+              ss_line = "  /[if #{stylesheet.options[:condition]}]\n  " + ss_line
+            end
+            html << ss_line + "\n"
+          end
+          html
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,14 @@
+unless defined?(Compass::RAILS_LOADED)
+  Compass::RAILS_LOADED = true
+
+  %w(action_controller sass_plugin urls).each do |lib|
+    require "compass/app_integration/rails/#{lib}"
+  end
+
+  # 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/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