compass-edge 0.9.1 → 0.9.2

data/Rakefile

@@ -14,6 +14,7 @@ require 'rubygems'
 require 'rake'
 $:.unshift File.join(File.dirname(__FILE__), 'lib')
 require 'compass'
+require 'rcov/rcovtask'
 
 # ----- Default: Testing ------
 
@@ -39,7 +40,7 @@ begin
   require 'jeweler'
   Jeweler::Tasks.new do |gemspec|
     gemspec.rubyforge_project = "compass"
-    gemspec.name = "compass"
+    gemspec.name = "compass-edge"
     gemspec.summary = "A Real Stylesheet Framework"
     gemspec.email = "chris@eppsteins.net"
     gemspec.homepage = "http://compass-style.org"
@@ -65,6 +66,7 @@ begin
     gemspec.files -= Dir.glob("test/fixtures/stylesheets/*/saved/**/*.*")
     gemspec.test_files = Dir.glob("test/**/*.*")
     gemspec.test_files -= Dir.glob("test/fixtures/stylesheets/*/saved/**/*.*")
+    gemspec.test_files += Dir.glob("features/**/*.*")
   end
 rescue LoadError
   puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
@@ -129,3 +131,34 @@ namespace :git do
     sh "git", "clean", "-fdx"
   end
 end
+
+require 'cucumber/rake/task'
+
+namespace :rcov do
+  Cucumber::Rake::Task.new(:cucumber) do |t|    
+    t.rcov = true
+    t.rcov_opts = %w{--exclude osx\/objc,gems\/,spec\/,features\/ --aggregate coverage.data}
+    t.rcov_opts << %[-o "coverage"]
+  end
+  
+  Rcov::RcovTask.new(:units) do |rcov|
+    rcov.libs << 'lib'
+    rcov.libs << 'haml/lib' if ENV["RUN_CODE_RUN"]
+    test_files = FileList['test/**/*_test.rb']
+    test_files.exclude('test/rails/*', 'test/haml/*')
+    rcov.pattern    = test_files
+    rcov.output_dir = 'coverage'
+    rcov.verbose    = true
+    rcov.rcov_opts = %w{--exclude osx\/objc,gems\/,spec\/,features\/ --aggregate coverage.data}
+    rcov.rcov_opts << %[-o "coverage" --sort coverage]
+  end
+  
+  
+  desc "Run both specs and features to generate aggregated coverage"
+  task :all do |t|
+    rm "coverage.data" if File.exist?("coverage.data")
+    Rake::Task["rcov:units"].invoke
+    Rake::Task["rcov:cucumber"].invoke
+  end
+end
+

data/VERSION.yml

@@ -1,4 +1,5 @@
 --- 
-:patch: 0
-:major: 0
 :minor: 9
+:build: 
+:patch: 2
+:major: 0

data/features/command_line.feature

@@ -0,0 +1,219 @@
+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.config is reported created
+    Then a config file config/compass.config is created
+    And a ruby file config/compass.config 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
+
+  Scenario: Basic help
+    When I run: compass help
+    Then I should be shown a list of available commands
+    And the list of commands should describe the compile command
+    And the list of commands should describe the create command
+    And the list of commands should describe the grid-img command
+    And the list of commands should describe the help command
+    And the list of commands should describe the init command
+    And the list of commands should describe the install command
+    And the list of commands should describe the version command
+
+  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
+    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/step_definitions/command_line_steps.rb

@@ -0,0 +1,199 @@
+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
+
+# 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 available commands$/ do
+  @last_result.should =~ /^Available commands:$/
+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
+
+