compass 0.8.17 → 0.10.0.pre1

data/examples/yui/extensions/yui/templates/project/manifest.rb

@@ -0,0 +1 @@
+stylesheet 'screen.sass', :media => "screen, projection"

data/examples/yui/extensions/yui/templates/project/screen.sass

@@ -0,0 +1,4 @@
+@import yui.sass
+@import compass/reset.sass
+
++yui

data/features/command_line.feature

@@ -0,0 +1,226 @@
+Feature: Command Line
+  In order to manage my stylesheets
+  As a user on the command line
+  I want to create a new project
+
+  Scenario: Install a project without a framework
+    When I create a project using: compass create my_project
+    Then a directory my_project/ is created
+    And a configuration file my_project/config.rb is created
+    And a sass file my_project/src/screen.sass is created
+    And a sass file my_project/src/print.sass is created
+    And a sass file my_project/src/ie.sass is created
+    And a sass file my_project/src/screen.sass is compiled
+    And a sass file my_project/src/print.sass is compiled
+    And a sass file my_project/src/ie.sass is compiled
+    And a css file my_project/stylesheets/screen.css is created
+    And a css file my_project/stylesheets/print.css is created
+    And a css file my_project/stylesheets/ie.css is created
+    And I am told how to link to /stylesheets/screen.css for media "screen, projection"
+    And I am told how to link to /stylesheets/print.css for media "print"
+    And I am told how to conditionally link "IE" to /stylesheets/ie.css for media "screen, projection"
+
+  Scenario: Install a project with blueprint
+    When I create a project using: compass create bp_project --using blueprint
+    Then a directory bp_project/ is created
+    And a configuration file bp_project/config.rb is created
+    And a sass file bp_project/src/screen.sass is created
+    And a sass file bp_project/src/print.sass is created
+    And a sass file bp_project/src/ie.sass is created
+    And a sass file bp_project/src/screen.sass is compiled
+    And a sass file bp_project/src/print.sass is compiled
+    And a sass file bp_project/src/ie.sass is compiled
+    And a css file bp_project/stylesheets/screen.css is created
+    And a css file bp_project/stylesheets/print.css is created
+    And a css file bp_project/stylesheets/ie.css is created
+    And an image file bp_project/images/grid.png is created
+    And I am told how to link to /stylesheets/screen.css for media "screen, projection"
+    And I am told how to link to /stylesheets/print.css for media "print"
+    And I am told how to conditionally link "lt IE 8" to /stylesheets/ie.css for media "screen, projection"
+
+  Scenario: Install a project with specific directories
+    When I create a project using: compass create custom_project --using blueprint --sass-dir sass --css-dir css --images-dir assets/imgs
+    Then a directory custom_project/ is created
+    And a directory custom_project/sass/ is created
+    And a directory custom_project/css/ is created
+    And a directory custom_project/assets/imgs/ is created
+    And a sass file custom_project/sass/screen.sass is created
+    And a css file custom_project/css/screen.css is created
+    And an image file custom_project/assets/imgs/grid.png is created
+
+  Scenario: Perform a dry run of creating a project
+    When I create a project using: compass create my_project --dry-run
+    Then a directory my_project/ is not created
+    But a configuration file my_project/config.rb is reported created
+    And a sass file my_project/src/screen.sass is reported created
+    And a sass file my_project/src/print.sass is reported created
+    And a sass file my_project/src/ie.sass is reported created
+    And I am told how to link to /stylesheets/screen.css for media "screen, projection"
+    And I am told how to link to /stylesheets/print.css for media "print"
+    And I am told how to conditionally link "IE" to /stylesheets/ie.css for media "screen, projection"
+
+  Scenario: Creating a bare project
+    When I create a project using: compass create bare_project --bare
+    Then a directory bare_project/ is created
+    And a configuration file bare_project/config.rb is created
+    And a directory bare_project/src/ is created
+    And a directory bare_project/stylesheets/ is not created
+    And I am congratulated
+    And I am told that I can place stylesheets in the src subdirectory
+    And I am told how to compile my sass stylesheets
+
+  Scenario: Creating a bare project with a framework
+    When I create a project using: compass create bare_project --using blueprint --bare
+    Then an error message is printed out: A bare project cannot be created when a framework is specified.
+    And the command exits with a non-zero error code
+
+  Scenario: Initializing a rails project
+    Given I'm in a newly created rails project: my_rails_project
+    When I initialize a project using: compass init rails --sass-dir app/stylesheets --css-dir public/stylesheets/compiled
+    Then a config file config/compass.rb is reported created
+    Then a config file config/compass.rb is created
+    And a sass file config/initializers/compass.rb is created
+    And a sass file app/stylesheets/screen.sass is created
+    And a sass file app/stylesheets/print.sass is created
+    And a sass file app/stylesheets/ie.sass is created
+
+  Scenario: Compiling an existing project.
+    Given I am using the existing project in test/fixtures/stylesheets/compass
+    When I run: compass compile
+    Then a directory tmp/ is created
+    And a sass file sass/layout.sass is reported compiled
+    And a sass file sass/print.sass is reported compiled
+    And a sass file sass/reset.sass is reported compiled
+    And a sass file sass/utilities.sass is reported compiled
+    And a css file tmp/layout.css is created
+    And a css file tmp/print.css is created
+    And a css file tmp/reset.css is created
+    And a css file tmp/utilities.css is created
+
+  Scenario: Compiling an existing project with a specified project
+    Given I am using the existing project in test/fixtures/stylesheets/compass
+    And I am in the parent directory
+    When I run: compass compile tmp_compass
+    Then a directory tmp_compass/tmp/ is created
+    And a sass file tmp_compass/sass/layout.sass is reported compiled
+    And a sass file tmp_compass/sass/print.sass is reported compiled
+    And a sass file tmp_compass/sass/reset.sass is reported compiled
+    And a sass file tmp_compass/sass/utilities.sass is reported compiled
+    And a css file tmp_compass/tmp/layout.css is created
+    And a css file tmp_compass/tmp/print.css is created
+    And a css file tmp_compass/tmp/reset.css is created
+    And a css file tmp_compass/tmp/utilities.css is created
+
+  Scenario: Recompiling a project with no changes
+    Given I am using the existing project in test/fixtures/stylesheets/compass
+    When I run: compass compile
+    And I run: compass compile
+    Then a sass file sass/layout.sass is reported unchanged
+    And a sass file sass/print.sass is reported unchanged
+    And a sass file sass/reset.sass is reported unchanged
+    And a sass file sass/utilities.sass is reported unchanged
+
+  Scenario: Installing a pattern into a project
+    Given I am using the existing project in test/fixtures/stylesheets/compass
+    When I run: compass install blueprint/buttons
+    Then a sass file sass/buttons.sass is created
+    And an image file images/buttons/cross.png is created
+    And an image file images/buttons/key.png is created
+    And an image file images/buttons/tick.png is created
+    And a css file tmp/buttons.css is created
+
+  @now
+  Scenario: Basic help
+    When I run: compass help
+    Then I should see the following "primary" commands:
+      | compile |
+      | create  |
+      | init    |
+      | watch   |
+    And I should see the following "other" commands:
+      | config      |
+      | grid-img    |
+      | help        |
+      | install     |
+      | interactive |
+      | stats       |
+      | validate    |
+      | version     |
+
+  Scenario: Recompiling a project with no material changes
+    Given I am using the existing project in test/fixtures/stylesheets/compass
+    When I run: compass compile
+    And I wait 1 second
+    And I touch sass/layout.sass
+    And I run: compass compile
+    Then a sass file sass/layout.sass is reported compiled
+    Then a css file tmp/layout.css is reported identical
+    And a sass file sass/print.sass is reported unchanged
+    And a sass file sass/reset.sass is reported unchanged
+    And a sass file sass/utilities.sass is reported unchanged
+
+  Scenario: Recompiling a project with changes
+    Given I am using the existing project in test/fixtures/stylesheets/compass
+    When I run: compass compile
+    And I wait 1 second
+    And I add some sass to sass/layout.sass
+    And I run: compass compile
+    Then a sass file sass/layout.sass is reported compiled
+    And a css file tmp/layout.css is reported overwritten
+    And a sass file sass/print.sass is reported unchanged
+    And a sass file sass/reset.sass is reported unchanged
+    And a sass file sass/utilities.sass is reported unchanged
+
+  Scenario: Watching a project for changes
+    Given I am using the existing project in test/fixtures/stylesheets/compass
+    When I run: compass compile
+    And I run in a separate process: compass watch 
+    And I wait 1 second
+    And I touch sass/layout.sass
+    And I wait 2 seconds
+    And I shutdown the other process
+    Then a css file tmp/layout.css is reported identical
+
+  Scenario: Generating a grid image so that I can debug my grid alignments
+    Given I am using the existing project in test/fixtures/stylesheets/compass
+    When I run: compass grid-img 30+10x24
+    Then a png file images/grid.png is created
+
+  Scenario: Generating a grid image to a specified path with custom dimensions
+    Given I am using the existing project in test/fixtures/stylesheets/compass
+    When I run: compass grid-img 50+10x24 assets/wide_grid.png
+    Then a directory assets is created
+    Then a png file assets/wide_grid.png is created
+
+  Scenario: Generating a grid image with invalid dimensions
+    Given I am using the existing project in test/fixtures/stylesheets/compass
+    When I run: compass grid-img 50x24 assets/wide_grid.png
+    Then a directory assets is not created
+    And a png file assets/wide_grid.png is not created
+
+  Scenario: Generate a compass configuration file
+    Given I should clean up the directory: config
+    When I run: compass config config/compass.rb --sass-dir sass --css-dir assets/css
+    Then a configuration file config/compass.rb is created
+    And the following configuration properties are set in config/compass.rb:
+      | property | value      |
+      | sass_dir | sass       |
+      | css_dir  | assets/css |
+
+  Scenario: Validate the generated CSS
+    Given I am using the existing project in test/fixtures/stylesheets/compass
+    When I run: compass validate
+    Then my css is validated
+    And I am informed that my css is valid.
+
+  Scenario: Get stats for my project
+    Given I am using the existing project in test/fixtures/stylesheets/compass
+    When I run: compass stats
+    Then I am told statistics for each file:
+      | Filename            | Rules | Properties | Mixins Defs | Mixins Used | CSS Rules | CSS Properties |
+      | sass/layout.sass    |     0 |          0 |           0 |           1 |         5 |              9 |
+      | sass/print.sass     |     0 |          0 |           0 |           2 |        61 |             61 |
+      | sass/reset.sass     |     4 |          1 |           0 |           2 |       191 |            665 |
+      | sass/utilities.sass |     2 |          0 |           0 |           2 |         5 |             11 |
+      | Total.*             |     6 |          1 |           0 |           7 |       262 |            746 |
+

data/features/extensions.feature

@@ -0,0 +1,20 @@
+Feature: Extensions
+  In order to have an open source ecosystem for stylesheets
+  As a compass user
+  I can install extensions that others have created
+  And I can create and publish my own extensions
+
+  Scenario: Extensions directory for stand_alone projects
+    Given I am using the existing project in test/fixtures/stylesheets/compass
+    And the "extensions" directory exists
+    And and I have a fake extension at extensions/testing
+    When I run: compass --list-frameworks
+    Then the list of frameworks includes "testing"
+
+  Scenario: Extensions directory for rails projects
+    Given I'm in a newly created rails project: my_rails_project
+    And the "my_rails_project/vendor/plugins/compass/extensions" directory exists
+    And and I have a fake extension at my_rails_project/vendor/plugins/compass/extensions/testing
+    When I run: compass --list-frameworks
+    Then the list of frameworks includes "testing"
+

data/features/step_definitions/command_line_steps.rb

@@ -0,0 +1,223 @@
+require 'spec/expectations'
+$:.unshift(File.expand_path(File.join(File.dirname(__FILE__), '../../test')))
+
+require 'test_helper'
+
+require 'compass/exec'
+
+include Compass::CommandLineHelper
+include Compass::IoHelper
+include Compass::RailsHelper
+
+Before do
+  Compass.reset_configuration!
+  @cleanup_directories = []
+  @original_working_directory = Dir.pwd
+end
+ 
+After do
+  Dir.chdir @original_working_directory
+  @cleanup_directories.each do |dir|
+    FileUtils.rm_rf dir
+  end
+end
+
+# Given Preconditions
+Given %r{^I am using the existing project in ([^\s]+)$} do |project|
+  tmp_project = "tmp_#{File.basename(project)}"
+  @cleanup_directories << tmp_project
+  FileUtils.cp_r project, tmp_project
+  Dir.chdir tmp_project
+end
+
+Given %r{^I am in the parent directory$} do
+  Dir.chdir ".."
+end
+
+Given /^I'm in a newly created rails project: (.+)$/ do |project_name|
+  @cleanup_directories << project_name
+  begin
+    generate_rails_app project_name
+    Dir.chdir project_name
+  rescue LoadError
+    pending "Missing Ruby-on-rails gems: sudo gem install rails"
+  end
+end
+
+Given /^I should clean up the directory: (\w+)$/ do |directory|
+  @cleanup_directories << directory
+end
+
+# When Actions are performed
+When /^I create a project using: compass create ([^\s]+) ?(.+)?$/ do |dir, args|
+  @cleanup_directories << dir
+  compass 'create', dir, *(args || '').split
+end
+
+When /^I initialize a project using: compass init ?(.+)?$/ do |args|
+  compass 'init', *(args || '').split
+end
+
+When /^I run: compass ([^\s]+) ?(.+)?$/ do |command, args|
+  compass command, *(args || '').split
+end
+
+When /^I run in a separate process: compass ([^\s]+) ?(.+)?$/ do |command, args|
+  unless @other_process = fork 
+    @last_result = ''
+    @last_error = ''
+    Signal.trap("HUP") do
+      open('/tmp/last_result.compass_test.txt', 'w') do |file|
+        file.puts $stdout.string
+      end
+      open('/tmp/last_error.compass_test.txt', 'w') do |file|
+        file.puts @stderr.string
+      end
+      exit!
+    end
+    # this command will run forever
+    # we kill it with a HUP signal from the parent process.
+    args = (args || '').split
+    args << { :wait => 5 }
+    compass command, *args
+    exit!
+  end
+end
+
+When /^I shutdown the other process$/ do
+  Process.kill("HUP", @other_process)
+  Process.wait
+  @last_result = File.read('/tmp/last_result.compass_test.txt')
+  @last_error = File.read('/tmp/last_error.compass_test.txt')
+end
+
+When /^I touch ([^\s]+)$/ do |filename|
+  FileUtils.touch filename
+end
+
+When /^I wait ([\d.]+) seconds?$/ do |count|
+  sleep count.to_f
+end
+
+When /^I add some sass to ([^\s]+)$/ do |filename|
+  open(filename, "w+") do |file|
+    file.puts ".added .some .arbitrary"
+    file.puts "  sass: code"
+  end
+end
+
+# Then postconditions
+Then /^a directory ([^ ]+) is (not )?created$/ do |directory, negated|
+  File.directory?(directory).should == !negated
+end
+ 
+Then /an? \w+ file ([^ ]+) is (not )?created/ do |filename, negated|
+  File.exists?(filename).should == !negated
+end
+
+Then /an? \w+ file ([^ ]+) is reported created/ do |filename|
+  @last_result.should =~ /create #{Regexp.escape(filename)}/
+end
+
+Then /a \w+ file ([^ ]+) is (?:reported )?compiled/ do |filename|
+  @last_result.should =~ /compile #{Regexp.escape(filename)}/
+end
+
+Then /a \w+ file ([^ ]+) is reported unchanged/ do |filename|
+  @last_result.should =~ /unchanged #{Regexp.escape(filename)}/
+end
+
+Then /a \w+ file ([^ ]+) is reported identical/ do |filename|
+  @last_result.should =~ /identical #{Regexp.escape(filename)}/
+end
+
+Then /a \w+ file ([^ ]+) is reported overwritten/ do |filename|
+  @last_result.should =~ /overwrite #{Regexp.escape(filename)}/
+end
+
+Then /I am told how to link to ([^ ]+) for media "([^"]+)"/ do |stylesheet, media|
+  @last_result.should =~ %r{<link href="#{stylesheet}" media="#{media}" rel="stylesheet" type="text/css" />}
+end
+
+Then /I am told how to conditionally link "([^"]+)" to ([^ ]+) for media "([^"]+)"/ do |condition, stylesheet, media|
+  @last_result.should =~ %r{<!--\[if #{condition}\]>\s+<link href="#{stylesheet}" media="#{media}" rel="stylesheet" type="text/css" />\s+<!\[endif\]-->}mi
+end
+
+Then /^an error message is printed out: (.+)$/ do |error_message|
+  @last_error.should =~ Regexp.new(Regexp.escape(error_message))
+end
+
+Then /^the command exits with a non\-zero error code$/ do
+  @last_exit_code.should_not == 0
+end
+
+
+Then /^I am congratulated$/ do
+  @last_result.should =~ /Congratulations!/
+end
+
+Then /^I am told that I can place stylesheets in the ([^\s]+) subdirectory$/ do |subdir|
+  @last_result.should =~ /You may now add sass stylesheets to the #{subdir} subdirectory of your project./
+end
+
+Then /^I am told how to compile my sass stylesheets$/ do
+  @last_result.should =~ /You must compile your sass stylesheets into CSS when they change.\nThis can be done in one of the following ways:/
+end
+
+Then /^I should be shown a list of "([^"]+)" commands$/ do |kind|
+  @last_result.should =~ /^#{kind.capitalize} Commands:$/
+  @last_command_list = []
+  found = false
+  indent = nil
+  @last_result.split("\n").each do |line|
+    if line =~ /^#{kind.capitalize} Commands:$/
+      found = true
+    elsif found && line =~ /^\s+/
+      @last_command_list << line
+    elsif found && line =~ /^$|^\w/
+      break
+    end
+  end
+
+end
+
+Then /^the list of commands should describe the ([^ ]+) command$/ do |command|
+  @last_result.should =~ /^\s+\* #{command}\s+- [A-Z].+$/
+end
+
+Then /^the following configuration properties are set in ([^ ]+):$/ do |config_file, table|
+  
+  config = Compass::Configuration::Data.new_from_file(config_file)
+  table.hashes.each do |hash|
+   config.send(hash['property']).should == hash['value']
+  end
+end
+
+Then /^my css is validated$/ do
+  if @last_error =~ /The Compass CSS Validator could not be loaded/
+    pending "Missing Dependency: sudo gem install chriseppstein-compass-validator"
+  else
+    @last_result.should =~ /Compass CSS Validator/
+  end
+end
+
+Then /^I am informed that my css is valid.$/ do
+  @last_result.should =~ /Your CSS files are valid\./
+end
+
+Then /^I am told statistics for each file:$/ do |table|
+  # table is a Cucumber::Ast::Table
+  table.raw.each do |row|
+    re = Regexp.new row.join(' *\| *')
+    @last_result.should =~ re
+  end
+end
+
+Then /^I should see the following "([^"]+)" commands:$/ do |kind, table|
+
+
+  Then %Q{I should be shown a list of "#{kind}" commands}
+
+  commands = @last_command_list.map{|c| c =~ /^\s+\* ([^ ]+)\s+- [A-Z].+$/; [$1]}
+  table.diff!(commands)
+end