SassyLists 0.3.0 → 0.3.1

data/CHANGELOG.md

@@ -1,5 +1,6 @@
 # Changelog
 
+* `0.3.1`: added aliases and cleaned `to-string()`
 * `0.3.0`: adding `contains()`, `flatten()`, `union()`
 * `0.2.4`: improving `debug()`
 * `0.2.3`: fixing important issues with comments

data/lib/SassyLists.rb

@@ -5,8 +5,8 @@ Compass::Frameworks.register('SassyLists', :path => extension_path)
 #  Version is a number. If a version contains alphas, it will be created as a prerelease version
 #  Date is in the form of YYYY-MM-DD
 module SassyLists
-  VERSION = "0.3.0"
-  DATE = "2013-11-04"
+  VERSION = "0.3.1"
+  DATE = "2013-11-05"
 end
 
 module Sass::Script::Functions

data/stylesheets/SassyLists/{_contains.scss → _contain.scss}

@@ -1,15 +1,22 @@
 // Returns whether $list contains $value
 // -------------------------------------------------------------------------------
-// @documentation http://sassylists.com/documentation/#contains
+// @documentation http://sassylists.com/documentation/#contain
 // -------------------------------------------------------------------------------
-// @example chunk(a b c, a) => true
-// @example chunk(a b c, z) => false
+// @alias `include()`
+// -------------------------------------------------------------------------------
+// @example contain(a b c, a) => true
+// @example contain(a b c, z) => false
 // -------------------------------------------------------------------------------
 // @param $list [List] : list
 // @param $value [Literal] : value to look for
 // -------------------------------------------------------------------------------
 // @return [Boolean]
 
-@function contains($list, $value) {
+@function contain($list, $value) {
 	@return not not index($list, $value)
 }
+
+// Alias
+@function include($list, $value) {
+	@return contain($list, $value);
+}

data/stylesheets/SassyLists/_flatten.scss

@@ -2,6 +2,8 @@
 // -------------------------------------------------------------------------------
 // @documentation http://sassylists.com/documentation.html#flatten
 // -------------------------------------------------------------------------------
+// @alias `unfold()`
+// -------------------------------------------------------------------------------
 // @example flatten(a b (c d (e f))) => a b c d e f
 // -------------------------------------------------------------------------------
 // @param $list [List] : list
@@ -24,4 +26,9 @@
     }
 
     @return $result;
+}
+
+// Alias
+@function unfold($list) {
+    @return flatten($list);
 }

data/stylesheets/SassyLists/_is-symmetrical.scss

@@ -2,6 +2,8 @@
 // -------------------------------------------------------------------------------
 // @documentation http://sassylists.com/documentation/#is-symmetrical
 // -------------------------------------------------------------------------------
+// @alias `unfold()`
+// -------------------------------------------------------------------------------
 // @dependence `reverse()`
 // -------------------------------------------------------------------------------
 // @example is-symmetrical(a b c d e)   => false
@@ -15,3 +17,8 @@
 @function is-symmetrical($list) {
 	@return reverse($list) == reverse(reverse($list));  
 }
+
+// Alias
+@function is-mirror($list) {
+	@return is-symmetrical($list);
+}

data/stylesheets/SassyLists/_loop.scss

@@ -2,6 +2,8 @@
 // -------------------------------------------------------------------------------
 // @documentation http://sassylists.com/documentation/#loop
 // -------------------------------------------------------------------------------
+// @alias `shift-indexes()`
+// -------------------------------------------------------------------------------
 // @example loop(a b c d e)     => e, a, b, c, d
 // @example loop(a b c d e,  2) => d, e, a, b, c
 // @example loop(a b c d e, -2) => c, d, e, a, b
@@ -19,4 +21,9 @@
 	}
 
 	@return $result;
+}
+
+// Alias
+@function shift-indexes($list, $value: 1) {
+	@return loop($list, $value);
 }

data/stylesheets/SassyLists/_purge.scss

@@ -2,8 +2,11 @@
 // -------------------------------------------------------------------------------
 // @documentation http://sassylists.com/documentation.html#purge
 // -------------------------------------------------------------------------------
+// @alias `compact()`
+// @alias `clean()`
+// -------------------------------------------------------------------------------
 // @example purge(a null b false c) => a, b, c
-// @example purge(a b c)            => a, b, c
+// @example purge(a b c '')         => a, b, c
 // -------------------------------------------------------------------------------
 // @param $list [List] : list
 // -------------------------------------------------------------------------------
@@ -13,10 +16,19 @@
 	$result: ();
 
 	@each $item in $list {
-		@if $item != null and $item != false and $item != "" {
+		@if $item and $item != "" {
 			$result: append($result, $item);
 		}
 	}
 
 	@return $result;
+}
+
+// Aliases
+@function compact($list) {
+	@return purge($list);
+}
+
+@function clean($list) {
+	@return purge($list);
 }

data/stylesheets/SassyLists/_random-value.scss

@@ -2,7 +2,10 @@
 // -------------------------------------------------------------------------------
 // @documentation http://sassylists.com/documentation.html#random-value
 // -------------------------------------------------------------------------------
-// @dependence `rand` (Ruby)
+// @alias `roll()`
+// @alias `luck()`
+// -------------------------------------------------------------------------------
+// @dependence `rand()` (Ruby)
 // -------------------------------------------------------------------------------
 // @example random-value(a b c d e) => c
 // -------------------------------------------------------------------------------
@@ -13,3 +16,12 @@
 @function random-value($list) {
 	@return nth($list, random(length($list)) + 1);
 }
+
+// Aliases
+@function roll($list) {
+	@return random-value($list);
+}
+
+@function luck($list) {
+	@return random-value($list);
+}

data/stylesheets/SassyLists/_remove-duplicates.scss

@@ -2,6 +2,8 @@
 // -------------------------------------------------------------------------------
 // @documentation http://sassylists.com/documentation/#remove-duplicates
 // -------------------------------------------------------------------------------
+// @alias `unique()`
+// -------------------------------------------------------------------------------
 // @example remove-duplicates(a b a c b d c e)   => a, b, c, d, e
 // @example remove-duplicates(a b (c c c), true) => a, b, c
 // -------------------------------------------------------------------------------
@@ -26,4 +28,9 @@
     }
 
     @return $result;
+}
+
+// Alias
+@function unique($list, $recursive: false) {
+    @return remove-duplicates($list, $recursive);
 }

data/stylesheets/SassyLists/_remove-nth.scss

@@ -2,6 +2,8 @@
 // -------------------------------------------------------------------------------
 // @documentation http://sassylists.com/documentation/#remove-nth
 // -------------------------------------------------------------------------------
+// @alias `without-nth()`
+// -------------------------------------------------------------------------------
 // @dependence `replace-nth()`
 // -------------------------------------------------------------------------------
 // @example remove-nth(a b c,   2) => a, c
@@ -21,4 +23,9 @@
 
 @function remove-nth($list, $index) {
 	@return replace-nth($list, $index, "");
+}
+
+// Alias
+@function without-nth($list, $index) {
+	@return remove-nth($list, $index);
 }

data/stylesheets/SassyLists/_remove.scss

@@ -2,6 +2,8 @@
 // -------------------------------------------------------------------------------
 // @documentation http://sassylists.com/documentation/#remove
 // -------------------------------------------------------------------------------
+// @alias `without()`
+// -------------------------------------------------------------------------------
 // @dependence `replace()`
 // -------------------------------------------------------------------------------
 // @example remove(a b c,   b)       => a, c
@@ -17,4 +19,9 @@
 
 @function remove($list, $value, $recursive: false) {
 	@return replace($list, $value, "", $recursive);
+}
+
+// Alias
+@function without($list, $value, $recursive: false) {
+	@return remove($list, $value, $recursive);
 }

data/stylesheets/SassyLists/_reverse.scss

@@ -2,6 +2,8 @@
 // -------------------------------------------------------------------------------
 // @documentation http://sassylists.com/documentation/#reverse
 // -------------------------------------------------------------------------------
+// @alias `mirror()`
+// -------------------------------------------------------------------------------
 // @example reverse(a b c)           => c, b, a
 // @example reverse(a b (c a))       => c a, b, a
 // @example reverse(a b (c a), true) => a c, b, a
@@ -27,4 +29,9 @@
     }
 
     @return $result;
+}
+
+// Alias
+@function mirror($list, $recursive: false) {
+    @return reverse($list, $recursive);
 }

data/stylesheets/SassyLists/_sort.scss

@@ -2,6 +2,8 @@
 // -------------------------------------------------------------------------------
 // @documentation http://sassylists.com/documentation/#sort
 // -------------------------------------------------------------------------------
+// @alias `order()`
+// -------------------------------------------------------------------------------
 // @dependence `last()`
 // @dependence `insert-nth()`
 // -------------------------------------------------------------------------------
@@ -60,3 +62,8 @@
 
     @return $result;
 }
+
+// Alias
+@function order($list, $force: false) {
+    @return sort($list, $force);
+}

data/stylesheets/SassyLists/_to-string.scss

@@ -2,6 +2,8 @@
 // -------------------------------------------------------------------------------
 // @documentation http://sassylists.com/documentation/#to-string
 // -------------------------------------------------------------------------------
+// @alias `stringify()`
+// -------------------------------------------------------------------------------
 // @example to-string(a b c)      => abc
 // @example to-string(a (b c) d)  => abcd
 // @example to-string(a b c, '-') => a-b-c
@@ -13,18 +15,23 @@
 // @return [String]
 
 @function to-string($list, $glue: '', $root: true) {
-    $result: null;
+    $result: '';
 
     @each $item in $list {
         @if length($item) > 1 {
-            $result: $result#{to-string($item, $glue, false)};
+            $result: $result + to-string($item, $glue, false);
         }
 
         @else {
             $condition: index($list, $item) != length($list) or not $root;
-            $result: if($condition, $result#{$item}#{$glue}, $result#{$item});
+            $result: if($condition, $result + $item + $glue, $result + $item);
         }
     }
 
     @return quote($result);
+}
+
+// Alias
+@function stringify($list, $glue: '', $root: true) {
+    @return to-string($list, $glue, $root);
 }

data/stylesheets/SassyLists/_union.scss

@@ -2,6 +2,8 @@
 // -------------------------------------------------------------------------------
 // @documentation http://sassylists.com/documentation/#union
 // -------------------------------------------------------------------------------
+// @alias `merge()`
+// -------------------------------------------------------------------------------
 // @dependence `flatten()`
 // @dependence `remove-duplicates()`
 // -------------------------------------------------------------------------------
@@ -13,4 +15,9 @@
 
 @function union($lists...) {
 	@return remove-duplicates(flatten($lists));
+}
+
+// Alias
+@function merge($lists...) {
+	@return union($lists...);
 }

data/stylesheets/_SassyLists.scss

@@ -7,7 +7,7 @@
 // -------------------------------------------------------------------------------
 
 @import "SassyLists/chunk";
-@import "SassyLists/contains";
+@import "SassyLists/contain";
 @import "SassyLists/count-values";
 @import "SassyLists/debug";
 @import "SassyLists/first";

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: SassyLists
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-11-04 00:00:00.000000000 Z
+date: 2013-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sass
@@ -53,7 +53,7 @@ files:
 - CHANGELOG.md
 - lib/SassyLists.rb
 - stylesheets/SassyLists/_chunk.scss
-- stylesheets/SassyLists/_contains.scss
+- stylesheets/SassyLists/_contain.scss
 - stylesheets/SassyLists/_count-values.scss
 - stylesheets/SassyLists/_debug.scss
 - stylesheets/SassyLists/_first.scss