SassyLists 0.1

data/lib/SassyLists.rb

@@ -0,0 +1,30 @@
+# All gems that are required for this extension to work should go here.
+# These are the requires you would normally put in your config.rb file
+# By default, you should always included Compass. Do not include your
+#  extension.
+require 'compass'
+
+# This tells Compass what your Compass extension is called, and where to find
+#  its files
+# Replace 'ListFunctions' with the name of your extension. Spaces allowed.
+extension_path = File.expand_path(File.join(File.dirname(__FILE__), ".."))
+Compass::Frameworks.register('SassyLists', :path => extension_path)
+
+# Version and date of version for your Compass extension.
+# Replace MyExtension with the name of your extension
+#  Letters, numbers, and underscores only
+#  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.1"
+  DATE = "2013-10-16"
+end
+
+# This is where any custom SassScript should be placed. The functions will be  
+#  available on require of your extension without the need for users to import
+#  any partials. Uncomment below.
+
+# module Sass::Script::Functions
+# 
+# end

data/readme.md

@@ -0,0 +1,30 @@
+SassyLists - Advanced Sass list functions
+=========================================
+
+Here are a couple of advanced Sass (SCSS) list functions you may or may not need in your projects. Including:
+
+* `chunk()`: chunk list into size large lists
+* `count-values()`: count the number of occurrences of each value of list
+* `debug()`: returns list as a string
+* `first()`: return first item in list
+* `insert-nth()`: insert value at index
+* `is-symmetrical()`: check if list is symmetrical
+* `last()`: return last item in list
+* `last-index()`: return last index of value in list
+* `loop()`: shift indexes in list
+* `prepend()`: prepend value to list
+* `purge()`: remove all `false` and `null` values from list
+* `remove()`: remove value in list
+* `remove-duplicates()`: remove duplicate values from list
+* `remove-nth()`: remove value at index
+* `replace()`: replace value in list
+* `replace-nth()`: replace value at index
+* `reverse()`: reverse list
+* `slice()`: slice list
+* `sort()`: sort list
+* `sum()`: sum all unitless values in list
+* `to-string()`: cast list as string (JS `.join()`)
+
+Some functions depend on other functions. If you include functions individually, make sure to check for these dependencies in their respective docs.
+
+If you ever need to use them in one of your pen at [CodePen](http://codepen.io), just link to http://codepen.io/HugoGiraudel/pen/loAgq as an extra CSS resource. You'll have instant access to all functions.

data/stylesheets/SassyLists/_chunk.scss

@@ -0,0 +1,32 @@
+/** 
+ * Chunk $list into $size large lists
+ * -------------------------------------------------------------------------------
+ * @example chunk( (a, b, c, d, e), 2 ) => a b, c d, e
+ * @example chunk( (a, b, c, d, e), 3 ) => a b c, d e
+ * @example chunk( a, 3 )               => a
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * @param $size [Number] : length of lists
+ * -------------------------------------------------------------------------------
+ * @return [List]
+ */
+@function chunk($list, $size) {
+  $n: ceil(length($list) / $size);
+  $temp-index: 0;
+  $result: ();
+
+  @for $i from 1 through $n {
+    $temp-list: ();
+
+    @for $j from 1 + $temp-index through $size + $temp-index {
+      @if $j <= length($list) {
+        $temp-list: append($temp-list, nth($list, $j));
+      }
+    }
+
+    $result: append($result, $temp-list);
+    $temp-index: $temp-index + $size;
+  }
+
+  @return $result;
+}

data/stylesheets/SassyLists/_count-values.scss

@@ -0,0 +1,33 @@
+/** 
+ * Count the number of occurrences of each value of $list
+ * -------------------------------------------------------------------------------
+ * @dependence `replace-nth()`
+ * -------------------------------------------------------------------------------
+ * @example count-values( (a, b, c, d, e) ) 			=> a 1, b 1, c 1, d 1, e 1
+ * @example count-values( (a, b, c, a, d, b, a, e) ) 	=> a 3, b 2, c 1, d 1, e 1
+ * @example count-values( a ) 							=> a 1
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * -------------------------------------------------------------------------------
+ * @return [List]
+ */
+@function count-values($list) {
+  $keys   : ();
+  $counts : ();
+
+  @each $item in $list {
+    $index: index($keys, $item);
+
+    @if not $index {
+      $keys   : append($keys, $item);
+      $counts : append($counts, 1);
+    }
+
+    @else {
+      $count  : nth($counts, $index) + 1;
+      $counts : replace-nth($counts, $index, $count);
+    }
+  }
+
+  @return zip($keys, $counts);
+}

data/stylesheets/SassyLists/_debug.scss

@@ -0,0 +1,34 @@
+/** 
+ * Returns $list as a string
+ * -------------------------------------------------------------------------------
+ * @example debug( (a, b, c, d, e) ) => [ a, b, c, d, e ]
+ * @example debug( (a b (c d e) ) )  => [ a, b, [ c, d, e ] ]
+ * @example debug( a )               => [ a ]
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * -------------------------------------------------------------------------------
+ * @return [String]
+ */
+@function debug($list) {
+  $result: #{"[ "};
+
+  @each $item in $list {
+
+    @if length($item) > 1 {
+      $result: $result#{debug($item)};
+    }
+
+    @else {
+      $result: $result#{$item};
+    }
+
+    @if index($list, $item) != length($list) {
+      $result: $result#{", "};
+    }
+
+  } 
+
+  $result: $result#{" ]"};
+
+  @return quote($result);
+}

data/stylesheets/SassyLists/_first.scss

@@ -0,0 +1,13 @@
+/**
+ * Returns first element of $list
+ * -------------------------------------------------------------------------------
+ * @example first( (a, b, c) ) 	=> a
+ * @example first( a ) 			=> a
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * -------------------------------------------------------------------------------
+ * @return [Literal]
+ */
+@function first($list) {
+  @return nth($list, 1);
+}

data/stylesheets/SassyLists/_insert-nth.scss

@@ -0,0 +1,52 @@
+/** 
+ * Add $value at $index in $list
+ * -------------------------------------------------------------------------------
+ * @dependence `purge()`
+ * -------------------------------------------------------------------------------
+ * @example insert-nth( (a, b, c),  2, z ) => a, z, b, c
+ * @example insert-nth( (a, b, c),  0, z ) => error
+ * @example insert-nth( (a, b, c), -1, z ) => error
+ * @example insert-nth( (a, b, c), 10, z ) => error
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * @param $index [Number] : index to add
+ * @param $value [Literal] : value to add
+ * -------------------------------------------------------------------------------
+ * @raise [Error] if $index isn't an integer
+ * @raise [Error] if $index is strictly lesser than 1
+ * @raise [Error] if $index is strictly greater than length of $list
+ * -------------------------------------------------------------------------------
+ * @return [List] | false
+ */
+@function insert-nth($list, $index, $value) {
+  $result: false;
+      
+  @if type-of($index) != number {
+    @warn "$index: #{quote($index)} is not a number for `insert-nth`.";
+    @return $result;
+  }
+
+  @else if $index < 1 {
+    @warn "List index 0 must be a non-zero integer for `insert-nth`";
+    @return $result;
+  }
+
+  @else if $index > length($list) {
+    @warn "List index is #{$index} but list is only #{length($list)} item long for `insert-nth'.";
+    @return $result;
+  }
+
+  @else {
+    $result: ();
+        
+    @for $i from 1 through length($list) {
+      @if $i == $index {
+        $result: append($result, $value);
+      }
+
+      $result: append($result, nth($list, $i));
+    }
+  }
+
+  @return purge($result);
+}

data/stylesheets/SassyLists/_is-symmetrical.scss

@@ -0,0 +1,23 @@
+/**
+ * Test if $list is symmetrical (one-level deep)
+ * -------------------------------------------------------------------------------
+ * @dependence `reverse()`
+ * -------------------------------------------------------------------------------
+ * @example is-symmetrical( (a, b, c, d, e) ) => false
+ * @example is-symmetrical( (a, b, c, b, a) ) => true
+ * @example is-symmetrical( a )               => true
+ * @example is-symmetrical( a, b c d, a )     => true
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * -------------------------------------------------------------------------------
+ * @return [Boolean]
+ */
+@function is-symmetrical($list) {
+  $result: ();
+
+  @each $item in $list {
+    $result: append($result, $item, space); 
+  }
+      
+  @return $result == reverse($result); 
+}

data/stylesheets/SassyLists/_last-index.scss

@@ -0,0 +1,24 @@
+/**
+ * Returns last index of $value in $list
+ * -------------------------------------------------------------------------------
+ * @example last-index( (a, b, c, a), a ) => 4
+ * @example last-index( (a, b, c), z )    => null
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * @param $value [Literal] : value to be searched for
+ * -------------------------------------------------------------------------------
+ * @return [Number] | null
+ */
+@function last-index($list, $value) {
+  
+  @for $i from length($list) * -1 through -1 {
+    $i: abs($i);
+
+    @if nth($list, $i) == $value {
+      @return $i;
+    }
+    
+  }
+
+  @return null;
+}

data/stylesheets/SassyLists/_last.scss

@@ -0,0 +1,13 @@
+/**
+ * Returns last element of $list
+ * -------------------------------------------------------------------------------
+ * @example last( (a, b, c) ) => c
+ * @example last( a )         => a
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * -------------------------------------------------------------------------------
+ * @return [Literal]
+ */
+@function last($list) {
+  @return nth($list, length($list));
+}

data/stylesheets/SassyLists/_loop.scss

@@ -0,0 +1,21 @@
+/**
+ * Shift indexes from $list of $value
+ * -------------------------------------------------------------------------------
+ * @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
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * @param $value [Number] : number of position between old and new indexes
+ * -------------------------------------------------------------------------------
+ * @return [List]
+ */
+@function loop($list, $value: 1) {
+  $result: ();
+    
+  @for $i from 0 to length($list) {
+    $result: append($result, nth($list, ($i - $value) % length($list) + 1));
+  }
+  
+  @return $result;
+}

data/stylesheets/SassyLists/_prepend.scss

@@ -0,0 +1,16 @@
+/**
+ * Add $value as first index of $list
+ * -------------------------------------------------------------------------------
+ * @dependence `purge()`
+ * -------------------------------------------------------------------------------
+ * @example prepend( (a, b, c), z )   => z, a, b, c
+ * @example prepend( (a, b, c), y z ) => y z, a, b, c
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * @param $value [Literal] : value to prepend to the list
+ * -------------------------------------------------------------------------------
+ * @return [List]
+ */
+@function prepend($list, $value) {
+  @return purge(join($value, $list));
+}

data/stylesheets/SassyLists/_purge.scss

@@ -0,0 +1,21 @@
+/**
+ * Remove all false and null values from $list
+ * -------------------------------------------------------------------------------
+ * @example purge( (a, null, b, false, c, null) ) => a, b, c
+ * @example purge( (a, b, c) )                    => a, b, c
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * -------------------------------------------------------------------------------
+ * @return [List]
+ */
+@function purge($list) {
+  $result: ();
+  
+  @each $item in $list {
+    @if $item != null and $item != false and $item != "" {
+      $result: append($result, $item);
+    }
+  }
+  
+  @return $result;
+}

data/stylesheets/SassyLists/_remove-duplicates.scss

@@ -0,0 +1,30 @@
+/** 
+ * Remove duplicate values from $list
+ * -------------------------------------------------------------------------------
+ * @example remove-duplicates( (a, b, a, c, b, d, c, e) ) => a, b, c, d, e
+ * @example remove-duplicates( (a, b, (c, c, c)) )        => a, b, c
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * @param $recursive [Boolean] : enable / disable recursivity
+ * -------------------------------------------------------------------------------
+ * @return [List]
+ */
+@function remove-duplicates($list, $recursive: false) {
+  $result: ();
+  
+  @each $item in $list {
+
+    @if not index($result, $item) {
+      @if length($item) > 1 and $recursive {
+        $result: append($result, remove-duplicates($item, $recursive));
+      }
+      
+      @else {
+        $result: append($result, $item);
+      }
+    }
+
+  }
+  
+  @return $result;
+}

data/stylesheets/SassyLists/_remove-nth.scss

@@ -0,0 +1,23 @@
+/**
+ * Remove value from $list at index $index
+ * -------------------------------------------------------------------------------
+ * @dependence `replace-nth()`
+ * -------------------------------------------------------------------------------
+ * @example remove-nth( (a, b, c),   2 ) => a, c
+ * @example remove-nth( (a, b, c),   0 ) => error
+ * @example remove-nth( (a, b, c),  -1 ) => a, b
+ * @example remove-nth( (a, b, c),  10 ) => error
+ * @example remove-nth( (a, b, c), -10 ) => error
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * @param $index [Number] : index to remove
+ * -------------------------------------------------------------------------------
+ * @raise [Error] if $index isn't an integer
+ * @raise [Error] if $index is 0
+ * @raise [Error] if abs value of $index is strictly greater then length of $list
+ * -------------------------------------------------------------------------------
+ * @return [List] | false
+ */
+@function remove-nth($list, $index) {
+  @return replace-nth($list, $index, "");
+}

data/stylesheets/SassyLists/_remove.scss

@@ -0,0 +1,19 @@
+/**
+ * Remove value(s) $value from $list
+ * -------------------------------------------------------------------------------
+ * @dependence `replace()`
+ * -------------------------------------------------------------------------------
+ * @example remove( (a, b, c),   b )       => a, c
+ * @example remove( (a, b, c),   z )       => a, b, c
+ * @example remove( (a, b, c b), b )       => a, c b
+ * @example remove( (a, b, c b), b, true ) => a, c
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * @param $value [Literal] : value to remove
+ * @param $recursive [Boolean] : enable / disable recursivity
+ * -------------------------------------------------------------------------------
+ * @return [List]
+ */
+@function remove($list, $value, $recursive: false) {
+  @return replace($list, $value, "", $recursive);
+}

data/stylesheets/SassyLists/_replace-nth.scss

@@ -0,0 +1,50 @@
+/**
+ * Replace value at $index from $list by $value
+ * -------------------------------------------------------------------------------
+ * @dependence `purge()`
+ * -------------------------------------------------------------------------------
+ * @example replace-nth( (a, b, c),   2, z ) => a, z, c
+ * @example replace-nth( (a, b, c),   0, z ) => error
+ * @example replace-nth( (a, b, c),  -1, z ) => a, b, z
+ * @example replace-nth( (a, b, c),  10, z ) => error
+ * @example replace-nth( (a, b, c), -10, z ) => error
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * @param $index [Number] : index to update
+ * @param $value [Literal] : new value for index $index
+ * -------------------------------------------------------------------------------
+ * @raise [Error] if $index isn't an integer
+ * @raise [Error] if $index is 0
+ * @raise [Error] if abs value of $index is strictly greater than length of $list
+ * -------------------------------------------------------------------------------
+ * @return [List] | false
+ */
+@function replace-nth($list, $index, $value) {
+  $result: false;
+      
+  @if type-of($index) != number {
+    @warn "$index: #{quote($index)} is not a number for `replace-nth`/`remove-nth`.";
+    @return $result;
+  }
+
+  @else if $index == 0 {
+    @warn "List index 0 must be a non-zero integer for `replace-nth`/`remove-nth`.";
+    @return $result;
+  }
+      
+  @else if abs($index) > length($list) {
+    @warn "List index is #{$index} but list is only #{length($list)} item long for `replace-nth`/`remove-nth`.";
+    @return $result;
+  }
+
+  @else {
+    $result: ();
+    $index: if($index < 0, length($list) + $index + 1, $index);  
+
+    @for $i from 1 through length($list) {
+      $result: append($result, if($i == $index, $value, nth($list, $i)));
+    }
+  }
+ 
+  @return purge($result);
+}

data/stylesheets/SassyLists/_replace.scss

@@ -0,0 +1,32 @@
+/** 
+ * Replace $old-value by $new-value in $list
+ * -------------------------------------------------------------------------------
+ * @dependence `purge()`
+ * -------------------------------------------------------------------------------
+ * @example replace( (a, b, c), b, z )         => a, z, c
+ * @example replace( (a, b, c), y, z )         => a, b, c
+ * @example replace( (a, b, c a), a, z )       => z, b, c z
+ * @example replace( (a, b, c a), a, z, true ) => z, b, c z
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * @param $old-value [Literal] : value to replace
+ * @param $new-value [Literal] : new value for $old-value
+ * @param $recursive [Boolean] : enable / disable recursivity
+ * -------------------------------------------------------------------------------
+ * @return [List]
+ */
+@function replace($list, $old-value, $new-value, $recursive: false) {
+  $result: ();
+
+  @each $item in $list {
+    @if length($item) > 1 and $recursive {
+      $result: append($result, replace($item, $old-value, $new-value, $recursive));
+    }
+
+    @else {
+      $result: append($result, if($item == $old-value, $new-value, $item));
+    }
+  }
+
+  @return purge($result);
+}

data/stylesheets/SassyLists/_reverse.scss

@@ -0,0 +1,30 @@
+/**
+ * Reverses the order of $list
+ * -------------------------------------------------------------------------------
+ * @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
+ * @example reverse( a )                 => a
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * @param $recursive [Boolean] : enable / disable recursivity
+ * -------------------------------------------------------------------------------
+ * @return [List]
+ */
+@function reverse($list, $recursive: false) {
+  $result: ();
+
+  @for $i from length($list) * -1 through -1 {
+    $item: nth($list, abs($i));
+
+    @if length($item) > 1 and $recursive {
+      $result: append($result, reverse($item, $recursive));      
+    }
+
+    @else {
+      $result: append($result, $item);
+    }
+  }
+
+  @return $result;
+}

data/stylesheets/SassyLists/_slice.scss

@@ -0,0 +1,60 @@
+/**
+ * Slices $list between $start and $end
+ * -------------------------------------------------------------------------------
+ * @example slice( (a, b, c, d),  2, 3 ) => b, c
+ * @example slice( (a, b, c, d),  3, 2 ) => error
+ * @example slice( (a, b, c, d),  3, 5 ) => error
+ * @example slice( (a, b, c, d), -1, 3 ) => error
+ * @example slice( (a, b, c, d),  0, 3 ) => error
+ * @example slice( (a, b, c, d),  3, 3 ) => c
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * @param $start [Number] : start index
+ * @param $end [Number] : end index
+ * -------------------------------------------------------------------------------
+ * @raise [Error] if $start or $end aren't integers
+ * @raise [Error] if $start is greater than $end
+ * @raise [Error] if $start or $end is strictly lesser than 1
+ * @raise [Error] if $start is strictly greater than length of $list
+ * @raise [Error] if $end is strictly greater than length of $list
+ * -------------------------------------------------------------------------------
+ * @return [List] | false
+ */ 
+@function slice($list, $start: 1, $end: length($list)) {
+  $result: false;
+              
+  @if type-of($start) != number or type-of($end) != number {
+    @warn "Either $start or $end are not a number for `slice`.";
+    @return $result;
+  }
+             
+  @else if $start > $end {
+    @warn "The start index has to be lesser than or equals to the end index for `slice`.";
+    @return $result;
+  }
+
+  @else if $start < 1 or $end < 1 {
+    @warn "List indexes must be non-zero integers for `slice`.";
+    @return $result;
+  }
+
+  @else if $start > length($list) {
+    @warn "List index is #{$start} but list is only #{length($list)} item long for `slice`.";
+    @return $result;
+  }
+             
+  @else if $end > length($list) {
+    @warn "List index is #{$end} but list is only #{length($list)} item long for `slice`.";
+    @return $result;
+  }
+  
+  @else {
+    $result: ();
+                
+    @for $i from $start through $end {
+      $result: append($result, nth($list, $i));
+    }
+  }
+
+  @return $result;
+}

data/stylesheets/SassyLists/_sort.scss

@@ -0,0 +1,42 @@
+/** 
+ * Sort numeric values of $list
+ * -------------------------------------------------------------------------------
+ * @dependence `last()`
+ * @dependence `insert-nth()`
+ * -------------------------------------------------------------------------------
+ * @example sort( (5, 12, 4.7, 6, 69, 6) )            => 4.7, 5, 6, 6, 12, 69
+ * @example sort( (5, 12, 4.7, "8", 6, 14px, 69, 6) ) => 4.7, 5, 6, 6, 12, 69
+ * @example sort( 1 )                                 => 1
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * -------------------------------------------------------------------------------
+ * @return [List]
+ */
+@function sort($list) {
+  $result : nth($list, 1);
+  
+  @if length($list) > 1 {
+    @for $i from 2 through length($list) {
+      $item: nth($list, $i);
+      @if type-of($item) == number and unitless($item) { 
+        @if $item > last($result) {
+          $result: append($result, $item);
+        }
+        @else {
+          $index: 0;
+          @for $i from 1 through length($result) {
+            @if $item <= nth($result, $i) {
+              $index: $i;
+            }
+          }
+          $result: insert-nth($result, $index, $item); 
+        }
+      }
+      @else {
+        @warn "Not unitless number found. Omitted.";
+      }
+    }
+  }
+  
+  @return $result;
+}

data/stylesheets/SassyLists/_sum.scss

@@ -0,0 +1,32 @@
+/**
+ * Sum up all unitless values in $list
+ * -------------------------------------------------------------------------------
+ * @example sum( (1 2 3 4 5) )         => 15
+ * @example sum( (1 a 2 b 3) )         => 6
+ * @example sum( (10px 3em 5%) )       => 0
+ * @example sum( (10px 3em 5%, true) ) => 18
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * @param $force [Boolean] : enable / disable parseInt
+ * -------------------------------------------------------------------------------
+ * @return [Number]
+ */
+@function sum($list, $force: false) {
+  $result: 0;
+  
+  @each $item in $list {
+    @if type-of($item) == number {
+
+      @if $force and unit($item) {
+        $item: $item / ($item * 0 + 1);
+      }
+
+      @if unitless($item) {
+        $result: $result + $item;
+      }
+      
+    }
+  }
+  
+  @return $result;
+}

data/stylesheets/SassyLists/_to-string.scss

@@ -0,0 +1,29 @@
+/**
+ * Joins all elements of $list with $glue
+ * -------------------------------------------------------------------------------
+ * @example to-string( (a, b, c) )      => abc
+ * @example to-string( (a, b, c), '-' ) => a-b-c
+ * @example to-string( (a, b c, d) )    => abcd
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * @param $glue [String] : value to use as a join string
+ * @param $is-nested [Boolean] : strictly internal boolean for recursivity
+ * -------------------------------------------------------------------------------
+ * @return [String]
+ */
+@function to-string($list, $glue: '', $is-nested: false) {
+  $result: null;
+
+  @each $item in $list {
+    @if length($item) > 1 {
+      $result: $result#{to-string($item, $glue, true)};
+    }
+
+    @else {
+      $condition: index($list, item) != length($list) or $is-nested;
+      $result: if($condition, $result#{$item}#{$glue}, $result#{$item});
+    }
+  }
+
+  @return $result;
+}

data/stylesheets/_SassyLists.scss

@@ -0,0 +1,94 @@
+/* ------------------------------------------------------------------------------- *
+ * SassyLists - A couple of advanced Sass list functions
+ * ------------------------------------------------------------------------------- *
+ *
+ * chunk($list, $size)
+ * Chunk $list into $size large lists
+ *
+ * count-values($list)
+ * Count the number of occurrences of each value of $list
+ *
+ * debug($list)
+ * Returns $list as a string
+ *
+ * first($list)
+ * Return first element of $list
+ *
+ * insert-nth($list, $index, $value)
+ * Add $value at $index in $list
+ *
+ * is-symmetrical($list)
+ * Check if $list is symmetrical
+ * 
+ * last($list)
+ * Return last element of $list
+ *
+ * last-index($list, $value)
+ * Return last index of $value in $list
+ *
+ * loop($list, $value: 1)
+ * Shift indexes from $list of $value
+ *
+ * prepend($list, $value)
+ * Add $value as first index of $list
+ *
+ * purge($list)
+ * Remove all false and null values from $list
+ *
+ * remove($list, $value, $recursive: false)
+ * Remove value(s) $value from $list
+ *
+ * remove-duplicates($list, $recursive: false)
+ * Remove duplicate values from $list
+ *
+ * remove-nth($list, $index)
+ * Remove value from $list at index $index
+ *
+ * replace($list, $old-value, $new-value, $recursive: false)
+ * Replace $old-value by $new-value in $list
+ *
+ * replace-nth($list, $index, $value)
+ * Replace value at $index from $list by $value
+ *
+ * reverse($list, $recursive: false)
+ * Reverse the order of $list
+ *
+ * slice($list, $start: 1, $end: length($list))
+ * Slice $list between $start and $end
+ *
+ * sort($list)
+ * Sort all numeric values in $list
+ *
+ * sum($list, $force: false)
+ * Sum up all unitless values in $list
+ *
+ * to-string($list, $glue: '', $is-nested: false)
+ * Join all elements of $list with $glue
+ *
+ * ------------------------------------------------------------------------------- *
+ * CodePen (SCSS): http://codepen.io/HugoGiraudel/pen/loAgq
+ * CodePen (Sass): http://codepen.io/HugoGiraudel/pen/BskrE
+ * Repository: https://github.com/Team-Sass/Sass-list-functions/
+ * ------------------------------------------------------------------------------- */
+
+@import "SassyLists/chunk";
+@import "SassyLists/count-values";
+@import "SassyLists/debug";
+@import "SassyLists/first";
+@import "SassyLists/insert-nth";
+@import "SassyLists/is-symmetrical";
+@import "SassyLists/last";
+@import "SassyLists/last-index";
+@import "SassyLists/loop";
+@import "SassyLists/prepend";
+@import "SassyLists/purge";
+@import "SassyLists/remove";
+@import "SassyLists/remove-duplicates";
+@import "SassyLists/remove-nth";
+@import "SassyLists/replace";
+@import "SassyLists/replace-nth";
+@import "SassyLists/reverse";
+@import "SassyLists/slice";
+@import "SassyLists/sort";
+@import "SassyLists/sum";
+@import "SassyLists/to-string";

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification
+name: SassyLists
+version: !ruby/object:Gem::Version
+  version: '0.1'
+  prerelease: 
+platform: ruby
+authors:
+- Hugo Giraudel
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sass
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+- !ruby/object:Gem::Dependency
+  name: compass
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.12.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.12.1
+description: Advanced Sass list functions
+email:
+- hugo.giraudel@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- readme.md
+- lib/SassyLists.rb
+- stylesheets/SassyLists/_chunk.scss
+- stylesheets/SassyLists/_count-values.scss
+- stylesheets/SassyLists/_debug.scss
+- stylesheets/SassyLists/_first.scss
+- stylesheets/SassyLists/_insert-nth.scss
+- stylesheets/SassyLists/_is-symmetrical.scss
+- stylesheets/SassyLists/_last-index.scss
+- stylesheets/SassyLists/_last.scss
+- stylesheets/SassyLists/_loop.scss
+- stylesheets/SassyLists/_prepend.scss
+- stylesheets/SassyLists/_purge.scss
+- stylesheets/SassyLists/_remove-duplicates.scss
+- stylesheets/SassyLists/_remove-nth.scss
+- stylesheets/SassyLists/_remove.scss
+- stylesheets/SassyLists/_replace-nth.scss
+- stylesheets/SassyLists/_replace.scss
+- stylesheets/SassyLists/_reverse.scss
+- stylesheets/SassyLists/_slice.scss
+- stylesheets/SassyLists/_sort.scss
+- stylesheets/SassyLists/_sum.scss
+- stylesheets/SassyLists/_to-string.scss
+- stylesheets/_SassyLists.scss
+homepage: https://github.com/Team-Sass/Sass-list-functions
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: SassyLists
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: A collection of powerful Sass (SCSS) functions to deal with your lists.
+test_files: []