compass 0.13.alpha.4 → 0.13.alpha.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ee5da32e1abc5dbc8067fddb8a30e67e7df94666
+  data.tar.gz: d0cf1dd621e9e80ba6457560d23267f33a7669f5
+SHA512:
+  metadata.gz: 691fc67fa9830a372bcb3f43b9b7aa5f21cb99d63b0d61d547a99fe9057830032d22965016c2465285bb44e4700725ef1c00d8da773fb1e82322f962bd006c07
+  data.tar.gz: ce6fd2a32e34cd4f0d7282c8a2c504541b2d095047a08c3413346d6f0202e29465aff72d4377122eb37ae67328d86e9d7e39a50448e73857b670f9a7dd731e92

data/README.markdown

@@ -11,15 +11,14 @@ Code Quality: [![Code Climate](https://codeclimate.com/github/chriseppstein/comp
 * [Compass Reference](http://compass-style.org/install/reference/)
 
 ## Author
-Compass is written by [Chris Eppstein](http://chriseppstein.github.com/).<br>
-Chris is the Software Architect of [Caring.com](http://caring.com) and a member of the [Sass](https://github.com/nex3/sass) core team.
+Compass is written by [Chris Eppstein](http://chriseppstein.github.io/).<br>
+Chris is a software engineer at [LinkedIn](http://www.linkedin.com/) and a member of the [Sass](https://github.com/nex3/sass) core team.
 
 ## Core Team Members
 
 * [Scott Davis](https://github.com/scottdavis)
 * [Eric Meyer](https://github.com/ericam)
 * [Brandon Mathis](https://github.com/imathis)
-* [Anthony Short](https://github.com/anthonyshort/)
 
 ## Major Contributors
 

data/Rakefile

@@ -3,7 +3,12 @@ if ENV["PKG"]
   $: << File.expand_path(File.dirname(__FILE__))+"/lib"
 else
   require 'bundler'
-  Bundler.setup 
+  Bundler.setup
+end
+
+unless ENV['CI']
+  require 'colorize'
+  require 'fileutils'
 end
 
 begin
@@ -58,6 +63,22 @@ Rake::TestTask.new :integrations do |t|
   t.verbose = true
 end
 
+desc "Download the latest browser stats data."
+task :caniuse do
+  require 'uri'
+  require 'net/http'
+  require 'net/https'
+  uri = URI.parse("https://raw.github.com/Fyrd/caniuse/master/data.json")
+  https = Net::HTTP.new(uri.host,uri.port)
+  https.use_ssl = true
+  req = Net::HTTP::Get.new(uri.path)
+  res = https.request(req)
+  filename = File.join(File.dirname(__FILE__), "data", "caniuse.json")
+  open(filename, "wb") do |file|
+    file.write(res.body)
+  end
+  puts "#{filename} (#{res.body.size} bytes)"
+end
 
 desc "Compile Examples into HTML and CSS"
 task :examples do
@@ -114,12 +135,12 @@ begin
   require 'cucumber/rake/task'
   require 'rcov/rcovtask'
   namespace :rcov do
-    Cucumber::Rake::Task.new(:cucumber) do |t|    
+    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'
       test_files = FileList['test/**/*_test.rb']
@@ -130,8 +151,8 @@ begin
       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")
@@ -160,3 +181,68 @@ begin
 rescue LoadError => e
   puts "WARNING: #{e}"
 end
+
+namespace :test do
+  debug = false
+  desc "update test expectations if needed"
+  task :update do
+    Rake::Task['test:update:fixtures'].invoke
+  end
+  task :debug do
+    debug = true
+    Rake::Task['test:update:fixtures'].invoke
+  end
+  namespace :update do
+    EXPECTED = 'css'
+    TMP = 'tmp'
+    #desc "update fixture expectations for test cases if needed"
+    task :fixtures do
+      fixtures = File.join('test/fixtures/stylesheets/compass'.split('/'))
+      # remove any existing temporary files
+      FileUtils.rm_rf(File.join(File.dirname(__FILE__), fixtures, TMP, '.'))
+      # compile the fixtures
+      puts "checking test cases..."
+      CHECKMARK = "\u2713 "
+      filter = debug ? '--trace' : "| grep 'error.*#{fixtures}'"
+      errors = %x[compass compile #{fixtures} #{filter}]
+      # check for compilation errors
+      if not errors.empty?
+        puts "Please fix the following errors before proceeding:".colorize(:red) if not debug
+        puts errors
+      else
+        # check to see what's changed
+        diff = %x[diff -r #{File.join(fixtures, EXPECTED, '')} #{File.join(fixtures, TMP, '')}]
+        # ignore non-CSS files in css/
+        diff = diff.gsub(/^Only in .*\/css\/(.*)\:.*[^.css]/, '')
+        if diff.empty?
+          puts "#{CHECKMARK}Cool! Looks like all the tests are up to date".colorize(:green)
+        else
+          puts "The following changes were found:"
+          puts "===================================="
+          # check for new or removed expectations
+          diff.scan(/^Only in .*\/(#{EXPECTED}|#{TMP})\/(.*)\: (.*).css/).each do |match|
+            config = (match[0] == TMP) ? [:green, '>', 'NEW TEST'] : [:red, '<', 'DELETED']
+            puts "[#{File.join(match[1], match[2])}]  #{config[2].colorize(config[0])}".colorize(:cyan)
+            new_file = File.join(File.dirname(__FILE__), fixtures, match[0], match[1], match[2]) + '.css'
+            puts File.read(new_file).gsub(/^(.*)/, config[1] + ' \1').colorize(config[0])
+          end
+          diff = diff.gsub(/^diff\s\-r\s.*\/tmp\/(.*).css/, '[\1]'.colorize(:cyan))
+          diff = diff.gsub(/^Only in .*\n?/, '')
+          diff = diff.gsub(/^(\<.*)/, '\1'.colorize(:red))
+          diff = diff.gsub(/^(\>.*)/, '\1'.colorize(:green))
+          diff = diff.gsub(/^(\d+.*)/, '\1'.colorize(:cyan))
+          puts diff
+          puts "===================================="
+          puts "Are all of these changes expected? [y/n]".colorize(:yellow)
+          if (($stdin.gets.chomp)[0] == 'y')
+            FileUtils.rm_rf(File.join(File.dirname(__FILE__), fixtures, EXPECTED, '.'))
+            FileUtils.cp_r(File.join(File.dirname(__FILE__), fixtures, TMP, '.'), File.join(File.dirname(__FILE__), fixtures, EXPECTED))
+            puts "#{CHECKMARK}Thanks! The test expectations have been updated".colorize(:green)
+          else
+            puts "Please manually update the test cases and expectations".colorize(:red)
+          end
+        end
+      end
+    end
+  end
+end

data/VERSION.yml

@@ -2,5 +2,5 @@
 :major: 0
 :minor: 13
 :state: alpha
-:iteration: 4
+:iteration: 5
 :name: Markab

data/features/command_line.feature

@@ -115,11 +115,6 @@ Feature: Command Line
     And a sass file sass/reset.sass is not mentioned
     And a css file tmp/utilities.css is reported identical
 
-  Scenario: Installing a pattern into a project
-    Given I am using the existing project in test/fixtures/stylesheets/compass
-    When I run: compass install compass/pie
-    Then a sass file sass/pie.scss is created
-
   Scenario: Basic help
     When I run: compass help
     Then I should see the following "primary" commands:
@@ -179,12 +174,13 @@ Feature: Command Line
       | tmp/fonts.css               |
       | images/flag-s5b4f509715.png |
 
+  @now
   Scenario: Watching a project for changes
     Given ruby supports fork
     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 3 seconds
+    And I wait 4 seconds
     And I touch sass/layout.sass
     And I wait 2 seconds
     And I shutdown the other process

data/features/step_definitions/command_line_steps.rb

@@ -1,6 +1,7 @@
 $:.unshift(File.expand_path(File.join(File.dirname(__FILE__), '../../test')))
 
 require 'test_helper'
+require 'true'
 
 require 'compass/exec'
 include Compass::TestCaseHelper

data/frameworks/compass/stylesheets/compass/_css3.scss

@@ -5,7 +5,6 @@
 @import "css3/text-shadow";
 @import "css3/columns";
 @import "css3/box-sizing";
-@import "css3/box";
 @import "css3/flexbox";
 @import "css3/images";
 @import "css3/background-clip";

data/frameworks/compass/stylesheets/compass/_support.scss

@@ -1,40 +1,358 @@
-// Usually compass hacks apply to both ie6 & 7 -- set this to false to disable support for both.
-$legacy-support-for-ie: true !default;
+// The list of browsers you want to support.
+// Defaults to all.
+$supported-browsers: browsers() !default;
 
-// Setting this to false will result in smaller output, but no support for ie6 hacks
-$legacy-support-for-ie6: $legacy-support-for-ie !default;
+// The browser usage threshold for features that gracefully degrade
+// Defaults to 1 user in 1,000.
+$graceful-usage-threshold: 0.1 !default;
 
-// Setting this to false will result in smaller output, but no support for ie7 hacks
-$legacy-support-for-ie7: $legacy-support-for-ie !default;
+// The browser usage threshold for features that cannot degrade gracefully
+// Defaults to 1 user in 10,000.
+$critical-usage-threshold: 0.01 !default;
 
-// Setting this to false will result in smaller output, but no support for legacy ie8 hacks
-$legacy-support-for-ie8: $legacy-support-for-ie !default;
+// Set this to true to generate comments that will explain why a prefix was included or omitted.
+$debug-browser-support: false !default;
+
+// Minimum browser versions that must be supported.
+// The keys of this map are any valid browser according to `browsers()`.
+// The values of this map are the min version that is valid for that browser
+// according to `browser-versions($browser)`
+$browser-minimum-versions: (
+  'chrome':  null,
+  'firefox': null,
+  'ie':      null,
+  'safari':  null,
+  'opera':   null
+) !default;
+
+
+// @private
+$default-capability-options: (
+  (full-support: true),
+  (partial-support: true)
+);
+
+// When a prefix is in a selector or directive scope, this is set to the current prefix value.
+$current-prefix: null;
+
+// When in a context that only exists in a particular version
+// this variable is set to those versions.
+$current-browser-minimum-versions: ();
+
+// The legacy support CSS 2.1 Selectors.
+// Defaults to the $critical-usage-threshold.
+$css-sel2-support-threshold: $critical-usage-threshold !default;
+
+// Check if the browser is in scope given the current prefix minimums.
+@function browser-out-of-scope($browser, $version: null) {
+  @if not ($current-prefix == null or $current-prefix == browser-prefix($browser)) {
+    @if $debug-browser-support {
+      @return "The #{$browser} #{$version} is incompatible with #{$current-prefix}."
+    } @else {
+      @return true;
+    }
+  }
+  $current-min: map-get($current-browser-minimum-versions, $browser);
+  @if not ($version and $current-min) {
+    // We don't have any versions to compare
+    @return false;
+  } @else {
+    // If the version is less than the current min, it is not supported
+    $too-old: compare-browser-versions($browser, $version, $current-min) < 0;
+    @if $too-old {
+      @if $debug-browser-support {
+        @return "The current scope only works with #{$browser} #{$current-min} or greater.";
+      } @else {
+        @return true;
+      }
+    } @else {
+      @return false;
+    }
+  }
+}
+
+// Check whether the browser is supported according to the declared minimum support
+// and usage thresholds.
+@function support-legacy-browser($browser, $version, $threshold: $critical-usage-threshold) {
+  // Check agaist usage stats and declared minimums
+  $min-version: map-get($browser-minimum-versions, $browser);
+  @return omitted-usage($browser, $version) > $threshold or
+          ($min-version and compare-browser-versions($browser, $version, $min-version) >= 0);
+}
+
+// Include content for a legacy browser
+// Version can be a single version string or a list of versions ordered from oldest to newest.
+@mixin for-legacy-browser($browser, $version, $threshold: $critical-usage-threshold, $mins: ($browser: $version)) {
+  $latest-version: nth($version, -1);
+  @if not browser-out-of-scope($browser, $latest-version) and
+      support-legacy-browser($browser, $latest-version, $threshold)
+  {
+    @if $debug-browser-support {
+      /* Content for #{$browser} #{$version}.
+      Min version: #{map-get($browser-minimum-versions, $browser) or unspecified}.
+      User threshold to keep: #{$threshold}%. If #{$browser} #{$version} and below are omitted: #{omitted-usage($browser, $version)}%. */
+    }
+    @include with-browser-minimums(map-merge($current-browser-minimum-versions, $mins)) {
+      @content;
+    }
+  } @else if $debug-browser-support and browser-out-of-scope($browser, $latest-version) {
+    /* Content for #{$browser} #{$version} omitted.
+       Not allowed in the current scope: #{browser-out-of-scope($browser, $latest-version)} */
+  } @else if $debug-browser-support and not support-legacy-browser($browser, $latest-version, $threshold) {
+    @if omitted-usage($browser, $version) > $threshold {
+      /* Content for #{$browser} #{$version} omitted.
+         User threshold to keep: #{$threshold}%. If #{$browser} #{$version} and below are omitted: #{omitted-usage($browser, $version)}%. */
+    } @else {
+      /* Content for #{$browser} #{$version} omitted.
+         Minimum support is #{map-get($browser-minimum-versions, $browser)}. */
+    }
+  }
+}
+
+// Renders the content once if any of the legacy browsers are supported.
+@mixin for-legacy-browsers($browsers, $threshold: $critical-usage-threshold) {
+  $rendered: false;
+  @each $browser, $version in $browsers {
+    @if not $rendered {
+      @include for-legacy-browser($browser, $version, $threshold, $mins: $browsers) {
+        $rendered: true;
+        @content;
+      }
+    }
+  }
+}
+
+// If there's a prefix context in scope, this will only output the content if the prefix matches.
+// Otherwise, sets the current prefix scope and outputs the content.
+@mixin with-prefix($prefix) {
+  @if $current-prefix {
+    @if $current-prefix == $prefix {
+      @content;
+    } @else if $debug-browser-support {
+      /* Omitting content for #{$prefix} because #{$current-prefix} is already in scope. */
+    }
+  } @else {
+    $current-prefix: $prefix;
+    @content;
+    $current-prefix: null;
+  }
+}
+
+@function prefixes-for-capability($capability, $threshold, $capability-options: $default-capability-options) {
+  $result: ();
+  @each $prefix in browser-prefixes($supported-browsers) {
+    $result: map-merge($result,
+                      ($prefix: use-prefix($prefix, $capability, $threshold, $capability-options)));
+  }
+  @return $result;
+}
+
+// Yields to the mixin content once for each prefix required.
+// The current prefix is set to the $current-prefix global for use by the included content.
+// Also yields to the content once with $current-prefix set to null for the official version
+// as long as there's not already a prefix in scope.
+@mixin with-each-prefix($capability, $threshold, $capability-options: $default-capability-options) {
+  @each $prefix, $should-use-prefix in prefixes-for-capability($capability, $threshold, $capability-options) {
+    @if $should-use-prefix {
+      @if $debug-browser-support and type-of($should-use-prefix) == list {
+        /* Capability #{$capability} is prefixed with #{$prefix} because #{$should-use-prefix} is required. */
+      } @else if $debug-browser-support and type-of($should-use-prefix) == number {
+        /* Capability #{$capability} is prefixed with #{$prefix} because omitting it would affect #{$should-use-prefix}% of users and the threshold is #{$threshold}%. */
+      }
+      @include with-prefix($prefix) {
+        @include with-browser-minimums($capability) {
+          @content;
+        }
+      }
+    }
+  }
+  @if not $current-prefix {
+    @include with-browser-minimums($capability) {
+      @content;
+    }
+  } @else if $debug-browser-support {
+    /* Not including prefix-free content for #{$capability} because the #{$current-prefix} prefix is in scope. */
+  }
+}
+
+// Returns true if at least one browser-version pair in $subset-mins
+// is a higher (or same) version than the browser-version pairs in $mins.
+@function has-browser-subset($mins, $subset-mins) {
+  $found-mismatch: false;
+  @each $browser, $subset-min-version in $subset-mins {
+    $min-version: map-get($mins, $browser);
+    @if $min-version {
+      @if compare-browser-versions($browser, $min-version, $subset-min-version) <= 0 {
+        @return true;
+      } @else {
+        $found-mismatch: true
+      }
+    }
+  }
+  @return not $found-mismatch;
+}
+
+@function merge-browser-minumums($mins, $new-mins) {
+  @each $browser, $new-min in $new-mins {
+    $old-min: map-get($mins, $browser);
+    @if $old-min {
+      $max-min: if(compare-browser-versions($browser, $old-min, $new-min) > 0,
+                   $old-min, $new-min);
+      $mins: map-merge($mins, ($browser: $max-min));
+    } @else {
+      $mins: map-merge($mins, ($browser: $new-min));
+    }
+  }
+  @return $mins;
+}
+
+// If passed a map, that will be the new browser minimums.
+// Otherwise a minimum map will be created based on the given capability and prefix
+// using the `browser-minimums($capability, $prefix)` function.
+//
+// If there are current minimums in scope and the new minimums have some overlap
+// with the current, then the minimums will be set to the max version of each browser.
+// If there is no overlap, then the content will not be rendered.
+@mixin with-browser-minimums($capability, $prefix: $current-prefix) {
+  $new-mins: null;
+  @if type-of($capability) == map {
+    $new-mins: $capability;
+  } @else {
+    $new-mins: browser-minimums($capability, $prefix);
+  }
+
+  @if has-browser-subset($current-browser-minimum-versions, $new-mins) {
+    $old-minimums: $current-browser-minimum-versions;
+    $current-browser-minimum-versions: merge-browser-minumums($old-minimums, $new-mins);
+    @content;
+    $current-browser-minimum-versions: $old-minimums;
+  }
+}
+
+// Returns true if the prefixed usage stats for the capability exceed the threshold
+// or if the minimum version for a supported browser would require a prefix for the capability.
+@function use-prefix($prefix, $capability, $threshold, $capability-options: $default-capability-options) {
+  $usage: prefix-usage($prefix, $capability, $capability-options);
+  @if $usage > $threshold {
+    @return $usage;
+  } @else {
+    @each $browser in browsers($prefix) {
+      @if index($supported-browsers, $browser) {
+        $min-version: map-get($browser-minimum-versions, $browser);
+        @if $min-version {
+          $actual-prefix: browser-requires-prefix($browser, $min-version, $capability, $capability-options);
+          @if $actual-prefix and $prefix == $actual-prefix {
+            @return $browser $min-version;
+          }
+        }
+      }
+    }
+  }
+  @return false;
+}
+
+@function prefix-identifier($ident, $prefix: $current-prefix) {
+  @return unquote("#{$prefix}#{if($prefix, '-', null)}#{$ident}");
+}
+
+// Output a property and value using the current prefix.
+// It will be unprefixed if $current-prefix is null.
+@mixin prefix-prop($property, $value, $prefix: $current-prefix) {
+  #{prefix-identifier($property, $prefix)}: $value;
+}
+
+// Emit a set of properties with the prefix governed by the capability and usage threshold given.
+//
+// Example:
+//
+//     @include prefixed-properties(css-animation, $animation-support-threshold,
+//       (animation-name: foo, animation-duration: 2s)
+//     );
+@mixin prefixed-properties($capability, $threshold, $properties, $capability-options: $default-capability-options) {
+  @include with-each-prefix($capability, $threshold, $capability-options) {
+    @each $prop, $value in $properties {
+      @include prefix-prop($prop, $value);
+    }
+  }
+}
+
+
+// @private
+@function warn-about-old-variables() {
+  $old-variables-in-use: ();
+  @each $old-variable-name in
+        (legacy-support-for-ie, legacy-support-for-ie6, legacy-support-for-ie7,
+         legacy-support-for-ie8, legacy-support-for-mozilla, legacy-support-for-webkit,
+         experimental-support-for-mozilla, experimental-support-for-webkit,
+         experimental-support-for-opera, experimental-support-for-microsoft,
+         experimental-support-for-khtml, experimental-support-for-svg)
+  {
+    @if global-variable-exists($old-variable-name) {
+      $old-variables-in-use: append($old-variables-in-use,
+                                    unquote("$#{$old-variable-name}"), comma);
+    }
+  }
+  @if length($old-variables-in-use) > 0 {
+    @warn "Compass has changed how browser support is configured. " +
+          "See the CHANGELOG for more details. The following configuration variables " +
+          "are no longer supported: #{$old-variables-in-use}."
+  }
+  @return $old-variables-in-use;
+}
+
+// @private
+@function warn-about-pie-removal() {
+  @if global-variable-exists(experimental-support-for-pie) {
+    @warn "Compass no longer supports css3pie.";
+  }
+  @return true;
+}
+
+// Enable browser support debugging within the content block.
+// Or you can enable it for the whole stylesheet by setting `$debug-browser-support` to true.
+@mixin with-browser-support-debugging {
+  $current-status: $debug-browser-support;
+  $debug-browser-support: true;
+  @content;
+  $debug-browser-support: $current-status;
+}
+
+// Set a default value if the given arglist is empty
+@function set-arglist-default($arglist, $default) {
+  $default-index: index($arglist, default);
+  @if $default-index {
+    $arglist: set-nth($arglist, $default-index, $default)
+  }
+  @return if(length($arglist) > 0, $arglist, $default);
+}
+
+
+// @private
+$old-variable-warnings-issued: warn-about-old-variables() !default;
 
 // @private
-// The user can simply set $legacy-support-for-ie and 6, 7, and 8 will be set accordingly,
-// But in case the user set each of those explicitly, we need to sync the value of
-// this combined variable.
-$legacy-support-for-ie: $legacy-support-for-ie6 or $legacy-support-for-ie7 or $legacy-support-for-ie8;
-
-// Whether to output legacy support for mozilla.
-$legacy-support-for-mozilla: true !default;
-
-// Whether to output legacy support for webkit.
-$legacy-support-for-webkit: true !default;
-
-// Support for mozilla in experimental css3 properties (-moz).
-$experimental-support-for-mozilla      : true !default;
-// Support for webkit in experimental css3 properties (-webkit).
-$experimental-support-for-webkit       : true !default;
-// Support for opera in experimental css3 properties (-o).
-$experimental-support-for-opera        : true !default;
-// Support for microsoft in experimental css3 properties (-ms).
-$experimental-support-for-microsoft    : true !default;
-// Support for khtml in experimental css3 properties (-khtml).
-$experimental-support-for-khtml        : false !default;
-// Support for svg in experimental css3 properties.
-// Setting this to true might add significant size to your
-// generated stylesheets.
-$experimental-support-for-svg          : false !default;
-// Support for CSS PIE in experimental css3 properties (-pie).
-$experimental-support-for-pie          : false !default;
+$pie-removal-warnging-issued: warn-about-pie-removal() !default;
+
+// @private
+@function warn-about-useless-prefix-arguments($moz: null, $webkit: null, $o: null, $khtml: null, $official: null) {
+  @if $moz != null or $webkit != null or $o != null or $khtml != null or $official != null {
+    @warn "Browser prefix arguments to this mixin are no longer used and " +
+          "will be removed in the next release.";
+  }
+  @return true;
+}
+
+// coerce a list to be comma delimited or make a new, empty comma delimited list.
+@function comma-list($list: ()) {
+  @return join((), $list, comma);
+}
+
+// @private Returns the legacy value for a given box-model
+// - Used by background-clip and -origin.
+@function legacy-box($box) {
+  $box: unquote($box);
+  @if $box == padding-box { $box: padding; }
+  @if $box == border-box { $box: border; }
+  @if $box == content-box { $box: content; }
+  @return $box;
+}