sass 3.3.0.alpha.184 → 3.3.0.alpha.195

data/REVISION

@@ -1 +1 @@
-9c8ae2980333f2715678c6737448ef738e0bb0cb
+a1dbbf37b919e9b45043a2ade97e7d355609f9de

data/VERSION

@@ -1 +1 @@
-3.3.0.alpha.184
+3.3.0.alpha.195

data/VERSION_DATE

@@ -1 +1 @@
-11 June 2013 21:31:46 GMT
+19 June 2013 23:49:23 GMT

data/lib/sass.rb

@@ -93,3 +93,4 @@ require 'sass/util'
 require 'sass/engine'
 require 'sass/plugin' if defined?(Merb::Plugins)
 require 'sass/railtie'
+require 'sass/features'

data/lib/sass/features.rb

@@ -0,0 +1,44 @@
+require 'set'
+
+# Provides `Sass.has_feature?` which allows for simple feature detection
+# by providing a feature name.
+module Sass
+  module Features
+
+    # This is the set of features that can be detected.
+    KNOWN_FEATURES = Set[*%w{
+    }]
+
+    # Check if a feature exists by name. This is used to implement
+    # the Sass function `feature-exists($feature)`
+    #
+    # @param feature_name [String] The case sensitive name of the feature to
+    #   check if it exists in this version of Sass.
+    # @return [Boolean] whether the feature of that name exists.
+    def has_feature?(feature_name)
+      KNOWN_FEATURES.include?(feature_name)
+    end
+
+    # Add a feature to Sass. Plugins can use this to easily expose their
+    # availability to end users. Plugins must prefix their feature
+    # names with a dash to distinguish them from official features.
+    #
+    # @example
+    #   Sass.add_feature("-import-globbing")
+    #   Sass.add_feature("-math-cos")
+    #
+    #
+    # @param feature_name [String] The case sensitive name of the feature to
+    #   to add to Sass. Must begin with a dash.
+    def add_feature(feature_name)
+      unless feature_name[0] == ?-
+        raise ArgumentError.new("Plugin feature names must begin with a dash")
+      end
+      KNOWN_FEATURES << feature_name
+    end
+  end
+
+  extend Features
+end
+
+

data/lib/sass/script/functions.rb

@@ -176,6 +176,9 @@ module Sass::Script
   #
   # ## Introspection Functions
   #
+  # \{#feature_exists feature-exists($feature)}
+  # : Returns whether the named feature exists in the current sass runtime.
+  #
   # \{#type_of type-of($value)}
   # : Returns the type of a value.
   #
@@ -1318,6 +1321,20 @@ module Sass::Script
     end
     declare :type_of, [:value]
 
+    # Returns true if the feature name specified exists in the current Sass runtime.
+    #
+    # @example
+    #   feature-exists(some-feature-that-exists) => true
+    #   feature-exists(what-is-this-i-dont-know) => false
+    #
+    # @param feature [Sass::Script::Value::String] The name of the feature to check
+    # @return [Sass::Script::Value::Bool] Whether the feature is supported in this version of Sass.
+    def feature_exists(feature)
+      Sass::Script::Value::Bool.new(Sass.has_feature?(feature.value))
+    end
+    declare :feature_exists, [:feature]
+
+
     # Inspects the unit of the number, returning it as a quoted string.
     # Complex units are sorted in alphabetical order by numerator and denominator.
     #
@@ -1481,28 +1498,30 @@ module Sass::Script
     # Gets the nth item in a list.
     #
     # Note that unlike some languages, the first item in a Sass list is number 1,
-    # the second number 2, and so forth.
+    # the second number 2, and so forth. You can also use negative numbers to
+    # count from the end of the list. So -1 is the last item, -2 is the
+    # second-to-last item, etc.
     #
     # @example
     #   nth(10px 20px 30px, 1) => 10px
     #   nth((Helvetica, Arial, sans-serif), 3) => sans-serif
+    #   nth((red, green, blue), -2) => green
     # @param list [Value] The list
     # @param n [Sass::Script::Value::Number] The index into the list
     # @return [Sass::Script::Value::Base] The nth item in the list
-    # @raise [ArgumentError] If `n` isn't an integer between 1 and the list's length.
+    # @raise [ArgumentError] If `n` isn't an integer whose absolute value is between 1 and the list's length.
     def nth(list, n)
       assert_type n, :Number
-      if !n.int?
-        raise ArgumentError.new("List index #{n} must be an integer")
-      elsif n.to_i < 1
-        raise ArgumentError.new("List index #{n} must be greater than or equal to 1")
+      if !n.int? || n.to_i == 0
+        raise ArgumentError.new("List index #{n} must be a non-zero integer")
       elsif list.to_a.size == 0
         raise ArgumentError.new("List index is #{n} but list has no items")
-      elsif n.to_i > (size = list.to_a.size)
+      elsif n.to_i.abs > (size = list.to_a.size)
         raise ArgumentError.new("List index is #{n} but list is only #{size} item#{'s' if size != 1} long")
       end
 
-      list.to_a[n.to_i - 1]
+      index = n.to_i > 0 ? n.to_i - 1 : n.to_i
+      list.to_a[index]
     end
     declare :nth, [:list, :n]
 
@@ -1617,7 +1636,7 @@ module Sass::Script
       if index
         Sass::Script::Value::Number.new(index + 1)
       else
-        Sass::Script::Value::Bool.new(false)
+        Sass::Script::Value::Bool::FALSE
       end
     end
     declare :index, [:list, :value]

data/lib/sass/script/value/bool.rb

@@ -1,6 +1,26 @@
 module Sass::Script::Value
   # A SassScript object representing a boolean (true or false) value.
   class Bool < Base
+
+    # The true value in SassScript.
+    #
+    # This is assigned before new is overridden below so that we use the default implementation.
+    TRUE  = new(true)
+
+    # The false value in SassScript.
+    #
+    # This is assigned before new is overridden below so that we use the default implementation.
+    FALSE = new(false)
+
+    # We override object creation so that users of the core API
+    # will not need to know that booleans are specific constants.
+    #
+    # @param value A ruby value that will be tested for truthiness.
+    # @return [Bool] TRUE if value is truthy, FALSE if value is falsey
+    def self.new(value)
+      value ? TRUE : FALSE
+    end
+
     # The Ruby value of the boolean.
     #
     # @return [Boolean]

data/lib/sass/script/value/number.rb

@@ -192,7 +192,7 @@ module Sass::Script::Value
     # @param other [Value] The right-hand side of the operator
     # @return [Boolean] Whether this number is equal to the other object
     def eq(other)
-      return Sass::Script::Value::Bool.new(false) unless other.is_a?(Sass::Script::Value::Number)
+      return Bool::FALSE unless other.is_a?(Sass::Script::Value::Number)
       this = self
       begin
         if unitless?
@@ -201,10 +201,9 @@ module Sass::Script::Value
           other = other.coerce(@numerator_units, @denominator_units)
         end
       rescue Sass::UnitConversionError
-        return Sass::Script::Value::Bool.new(false)
+        return Bool::FALSE
       end
-
-      Sass::Script::Value::Bool.new(this.value == other.value)
+      Bool.new(this.value == other.value)
     end
 
     # The SassScript `>` operation.

data/test/sass/functions_test.rb

@@ -977,6 +977,18 @@ MSG
     assert_equal("null", evaluate("type-of(null)"))
   end
 
+  def test_feature_exists
+    assert_raises ArgumentError do
+      Sass.add_feature("my-test-feature")
+    end
+    Sass.add_feature("-my-test-feature")
+    assert_equal("true", evaluate("feature-exists(-my-test-feature)"))
+    assert_equal("false", evaluate("feature-exists(whatisthisidontevenknow)"))
+    assert_equal("true", evaluate("feature-exists($feature: -my-test-feature)"))
+  ensure
+    Sass::Features::KNOWN_FEATURES.delete("-my-test-feature")
+  end
+
   def test_unit
     assert_equal(%Q{""}, evaluate("unit(100)"))
     assert_equal(%Q{"px"}, evaluate("unit(100px)"))
@@ -1017,12 +1029,14 @@ MSG
   def test_nth
     assert_equal("1", evaluate("nth(1 2 3, 1)"))
     assert_equal("2", evaluate("nth(1 2 3, 2)"))
+    assert_equal("3", evaluate("nth(1 2 3, -1)"))
+    assert_equal("1", evaluate("nth(1 2 3, -3)"))
     assert_equal("3", evaluate("nth((1, 2, 3), 3)"))
     assert_equal("foo", evaluate("nth(foo, 1)"))
     assert_equal("bar baz", evaluate("nth(foo (bar baz) bang, 2)"))
-    assert_error_message("List index 0 must be greater than or equal to 1 for `nth'", "nth(foo, 0)")
-    assert_error_message("List index -10 must be greater than or equal to 1 for `nth'", "nth(foo, -10)")
-    assert_error_message("List index 1.5 must be an integer for `nth'", "nth(foo, 1.5)")
+    assert_error_message("List index 0 must be a non-zero integer for `nth'", "nth(foo, 0)")
+    assert_error_message("List index is -10 but list is only 1 item long for `nth'", "nth(foo, -10)")
+    assert_error_message("List index 1.5 must be a non-zero integer for `nth'", "nth(foo, 1.5)")
     assert_error_message("List index is 5 but list is only 4 items long for `nth'", "nth(1 2 3 4, 5)")
     assert_error_message("List index is 2 but list is only 1 item long for `nth'", "nth(foo, 2)")
     assert_error_message("List index is 1 but list has no items for `nth'", "nth((), 1)")

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification 
 name: sass
 version: !ruby/object:Gem::Version 
-  hash: 592302717
+  hash: 592302731
   prerelease: 6
   segments: 
   - 3
   - 3
   - 0
   - alpha
-  - 184
-  version: 3.3.0.alpha.184
+  - 195
+  version: 3.3.0.alpha.195
 platform: ruby
 authors: 
 - Nathan Weizenbaum
@@ -19,7 +19,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2013-06-11 00:00:00 -04:00
+date: 2013-06-19 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -193,6 +193,7 @@ files:
 - lib/sass/util/multibyte_string_scanner.rb
 - lib/sass/util/subset_map.rb
 - lib/sass/version.rb
+- lib/sass/features.rb
 - bin/sass
 - bin/sass-convert
 - bin/scss