SassyLists 2.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a296e7541de900b0667d9adc5982680695baf408
-  data.tar.gz: cfe6a3f3016520920a2109556c0315bef0fa0f59
+  metadata.gz: 08fe82b4659c4fbab4ee92f4b86801a4d794e103
+  data.tar.gz: 4ac22e42947a48ac6a4214931410c5ae6e4bbb5f
 SHA512:
-  metadata.gz: 130887373e83c97df31b98774bc78f8becd565fedbe99b2cb29278938ea0b1b7b95bbbda4038aded18c2881bc3c9ceea66d1ec6431e1c9d8580475867b4193dd
-  data.tar.gz: c832a9b26caee25bae587bf9519fd3b0d1a49d8256ec4c88837f24e7dcee0e1ecc40f210449ccb90628e4a1e364467cbe78ef6c2973c4e19c7554f48f45397cb
+  metadata.gz: e64638ebc69f93b974b9b87e82d1a2f9177cf80b2a03a37754a922946fc05e104fefeec907e439ef3774c064737b2b6198f5359c1a35d34cc2beb498314e5de3
+  data.tar.gz: 24344e3fe3ce0809bed78b2c7e29c26ed6a71223b843e53ebbdd479a8bd2bcd4a22232202b1a0dc95d1dd190f3fe1dc3bf3deeffbec5f792809a5d4a606241b0

data/CHANGELOG.md

@@ -1,43 +1,44 @@
-# Changelog
-
-* `2.0.0`: 
-    * adding `to-map()`, `every()` and `some()`
-    * adding and improved tests
-    * prefixing all functions with `sl-`
-    * fixing an issue with `random-value()` sometimes failing
-    * changing all `false` returns into `null` in case of error
-    * removing Compass dependency
-* `1.1.0`: adding `walk()` and `tail()`, updated backward loops and fixed broken tests
-* `1.0.0`: moving code base to Sass 3.3 + adding a Grunt workflow
-    * adding `explode`
-    * making use of `list-separator()` and `set-nth()`
-    * updating `sort()` to make it able to sort strings
-    * removing all notion of recursion for sake of simplicity
-    * making `count-values()` return a map
-    * minor fixes and improvements
-    * improving overall performances
-* `0.4.9`: removing `compact()` alias for `purge()` (ref [#23](https://github.com/Team-Sass/SassyLists/issues/23))
-* `0.4.8`: adding `shuffle()`
-* `0.4.7`: dramatically improving `sort()` performances and removing all its dependencies
-* `0.4.6`: fixing an issue when passing an empty list to `chunk()` and improved code quality
-* `0.4.5`: making `sort()` able to return in descending order
-* `0.4.4`: fixing a typo in `purge()`
-* `0.4.3`: improving `insert-nth()`, `prepend()`, `replace-nth()` and `replace()` to prevent from adding empty lists
-* `0.4.2`: improving `insert-nth()` and cleaning some indentation issues
-* `0.4.1`: improving `intersection()` perf
-* `0.4.0`: adding `intersection()`
-* `0.3.5`: improving `debug()`, `to-string()` and `chunk()`
-* `0.3.4`: fixing a minor issue in `insert-nth()`, `replace-nth()` and `prepend()`
-* `0.3.3`: removing dependence to `purge()` from all functions; fixed an issue with `sort()`; fixed an issue with error messages
-* `0.3.2`: removing dependence to `purge()` from `replace()`
-* `0.3.1`: adding 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
-* `0.2.2`: moving all comments to invisible
-* `0.2.1`: fixing an issue with `random-value()`
-* `0.2.0`: adding `random-value()`
-* `0.1.4`: fixing an issue with `sort()`, `is-symmetrical()`
-* `0.1.3`: fixing an issue with `sort()`
-* `0.1.2`: improving `debug()`
-* `0.1.1`: initial commit
+# Changelog
+
+* `2.1.0`: adding `sl-is-empty()`, `sl-to-list()` and `sl-comma-list()`
+* `2.0.0`: 
+    * adding `sl-to-map()`, `sl-every()` and `sl-some()`
+    * adding and improved tests
+    * prefixing all functions with `sl-`
+    * fixing an issue with `random-value()` sometimes failing
+    * changing all `false` returns into `null` in case of error
+    * removing Compass dependency
+* `1.1.0`: adding `walk()` and `tail()`, updated backward loops and fixed broken tests
+* `1.0.0`: moving code base to Sass 3.3 + adding a Grunt workflow
+    * adding `explode`
+    * making use of `list-separator()` and `set-nth()`
+    * updating `sort()` to make it able to sort strings
+    * removing all notion of recursion for sake of simplicity
+    * making `count-values()` return a map
+    * minor fixes and improvements
+    * improving overall performances
+* `0.4.9`: removing `compact()` alias for `purge()` (ref [#23](https://github.com/Team-Sass/SassyLists/issues/23))
+* `0.4.8`: adding `shuffle()`
+* `0.4.7`: dramatically improving `sort()` performances and removing all its dependencies
+* `0.4.6`: fixing an issue when passing an empty list to `chunk()` and improved code quality
+* `0.4.5`: making `sort()` able to return in descending order
+* `0.4.4`: fixing a typo in `purge()`
+* `0.4.3`: improving `insert-nth()`, `prepend()`, `replace-nth()` and `replace()` to prevent from adding empty lists
+* `0.4.2`: improving `insert-nth()` and cleaning some indentation issues
+* `0.4.1`: improving `intersection()` perf
+* `0.4.0`: adding `intersection()`
+* `0.3.5`: improving `debug()`, `to-string()` and `chunk()`
+* `0.3.4`: fixing a minor issue in `insert-nth()`, `replace-nth()` and `prepend()`
+* `0.3.3`: removing dependence to `purge()` from all functions; fixed an issue with `sort()`; fixed an issue with error messages
+* `0.3.2`: removing dependence to `purge()` from `replace()`
+* `0.3.1`: adding 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
+* `0.2.2`: moving all comments to invisible
+* `0.2.1`: fixing an issue with `random-value()`
+* `0.2.0`: adding `random-value()`
+* `0.1.4`: fixing an issue with `sort()`, `is-symmetrical()`
+* `0.1.3`: fixing an issue with `sort()`
+* `0.1.2`: improving `debug()`
+* `0.1.1`: initial commit

data/README.md

@@ -1,73 +1,73 @@
-# SassyLists [![Gem Version](https://badge.fury.io/rb/SassyLists.png)](http://badge.fury.io/rb/SassyLists)
-
-Here is a [Compass Extension](http://compass-style.org/) providing you all functions you need to manipulate your [Sass](http://sass-lang.com/) lists. See complete documentation [here](http://sassylists.com/).
-
-## How to use it
-
-### Install with Gem 
-
-1. `gem install SassyLists`
-2. Add `require 'SassyLists'` to your `config.rb`
-3. Import it in your stylesheets with `@import 'SassyLists'`
-
-### Install with [Bower](http://bower.io/ "BOWER: A package manager for the web")
-1. `bower install SassyLists --save-dev`
-2. Import the partial in your Sass files
-
-## What's in there? 
-
-* `sl-chunk()`: returns whether list contains $value
-* `sl-contain()`: returns whether the list contains the value
-* `sl-count-values()`: counts the number of occurrences of each value of list
-* `sl-debug()`: returns list as a string
-* `sl-every()`: returns whether all items from list pass test from given function
-* `sl-explode()`: explodes a string into a list using a string as a delimiter
-* `sl-first()`: returns first item in list
-* `sl-flatten()`: turns multidimensional list into a one-level list
-* `sl-insert-nth()`: inserts value at index
-* `sl-intersection()`: returns a list of shared values across all given lists
-* `sl-is-symmetrical()`: checks if list is symmetrical
-* `sl-last()`: returns last item in list
-* `sl-last-index()`: returns last index of value in list
-* `sl-loop()`: shifts indexes in list
-* `sl-prepend()`: prepends value to list
-* `sl-purge()`: removes all `false` and `null` values from list
-* `sl-random-value()`: returns random value from list
-* `sl-remove()`: removes value in list
-* `sl-remove-duplicates()`: removes duplicate values from list
-* `sl-remove-nth()`: removes value at index
-* `sl-replace()`: replaces value in list
-* `sl-replace-nth()`: replaces value at index
-* `sl-reverse()`: reverses list
-* `sl-shuffle()`: shuffles list
-* `sl-slice()`: slices list
-* `sl-sort()`: sorts list
-* `sl-some()`: returns whether some items from list pass test from given function
-* `sl-sum()`: sums all unitless values in list
-* `sl-tail()`: returns anything but the first element in list
-* `sl-to-map()`: casts list as map using indexes as keys
-* `sl-to-string()`: casts list as string (JS `.join()`)
-* `sl-union()`: returns a list of values from given lists minus duplicates
-* `sl-walk()`: applies a function to every item of list
-
-If you feel like an explorer, you can have a look at the code [here](https://github.com/Team-Sass/SassyLists/tree/master/stylesheets).
-
-## Requirements
-
-* Sass ~> 3.3.0
-* Compass ~> 1.0.0
-
-If you are looking for the last version of SassyLists running on Sass 3.2, install `0.4.9`.
-
-Some functions depend on other functions. If you include functions individually, make sure to check for these dependencies in their respective docs.
-
-## Also read
-
-* [Official site](http://sassylists.com)
-* [Advanced Sass list functions](http://hugogiraudel.com/2013/08/08/advanced-sass-list-functions/)
-* [Advanced Sass list functions again](http://hugogiraudel.com/2013/10/09/advanced-sass-list-functions-again/)
-* [How I made a Sass debug function](http://hugogiraudel.com/2013/10/21/sass-debug/)
-
-## Credits
-
-A million thanks to [Vinay Raghu](http://viii.in/) for making this Compass extension out of my original work and to [Team-Sass](https://github.com/Team-Sass) for their [Compass Extension template](https://github.com/Team-Sass/Compass-Extension-Template).
+# SassyLists [![Gem Version](https://badge.fury.io/rb/SassyLists.png)](http://badge.fury.io/rb/SassyLists)
+
+Here is a powerful toolbox providing you all the functions you need to manipulate your [Sass](http://sass-lang.com/) lists. See complete documentation [here](http://sassylists.com/).
+
+## How to use it
+
+### Install with Gem 
+
+1. `gem install SassyLists`
+
+### Install with [Bower](http://bower.io/ "BOWER: A package manager for the web")
+1. `bower install SassyLists --save-dev`
+2. Import the partial in your Sass files
+
+## What's in there? 
+
+* `sl-chunk()`: returns whether list contains $value
+* `sl-comma-list()`: initializes an empty comma-separated list
+* `sl-contain()`: returns whether the list contains the value
+* `sl-count-values()`: counts the number of occurrences of each value of list
+* `sl-debug()`: returns list as a string
+* `sl-every()`: returns whether all items from list pass test from given function
+* `sl-explode()`: explodes a string into a list using a string as a delimiter
+* `sl-first()`: returns first item in list
+* `sl-flatten()`: turns multidimensional list into a one-level list
+* `sl-insert-nth()`: inserts value at index
+* `sl-intersection()`: returns a list of shared values across all given lists
+* `sl-is-empty()`: checks if list is empty
+* `sl-is-symmetrical()`: checks if list is symmetrical
+* `sl-last()`: returns last item in list
+* `sl-last-index()`: returns last index of value in list
+* `sl-loop()`: shifts indexes in list
+* `sl-prepend()`: prepends value to list
+* `sl-purge()`: removes all `false` and `null` values from list
+* `sl-random-value()`: returns random value from list
+* `sl-remove()`: removes value in list
+* `sl-remove-duplicates()`: removes duplicate values from list
+* `sl-remove-nth()`: removes value at index
+* `sl-replace()`: replaces value in list
+* `sl-replace-nth()`: replaces value at index
+* `sl-reverse()`: reverses list
+* `sl-shuffle()`: shuffles list
+* `sl-slice()`: slices list
+* `sl-sort()`: sorts list
+* `sl-some()`: returns whether some items from list pass test from given function
+* `sl-sum()`: sums all unitless values in list
+* `sl-tail()`: returns anything but the first element in list
+* `sl-to-list()`: casts value as list
+* `sl-to-map()`: casts list as map using indexes as keys
+* `sl-to-string()`: casts list as string (JS `.join()`)
+* `sl-union()`: returns a list of values from given lists minus duplicates
+* `sl-walk()`: applies a function to every item of list
+
+If you feel like an explorer, you can have a look at the code [here](https://github.com/Team-Sass/SassyLists/tree/master/stylesheets).
+
+## Requirements
+
+* Sass ~> 3.3
+
+If you are looking for the last version of SassyLists running on Sass 3.2, install `0.4.9`.
+
+Some functions depend on other functions. If you include functions individually, make sure to check for these dependencies in their respective docs.
+
+## Also read
+
+* [Official site](http://sassylists.com)
+* [Advanced Sass list functions](http://hugogiraudel.com/2013/08/08/advanced-sass-list-functions/)
+* [Advanced Sass list functions again](http://hugogiraudel.com/2013/10/09/advanced-sass-list-functions-again/)
+* [How I made a Sass debug function](http://hugogiraudel.com/2013/10/21/sass-debug/)
+
+## Credits
+
+A lot of thanks to all contributors and to [Team-Sass](https://github.com/Team-Sass) for their support.

data/lib/SassyLists.rb

@@ -1,21 +1,21 @@
-extension_path   = File.expand_path(File.join(File.dirname(__FILE__), '..'))
-stylesheets_path = File.join(extension_path, 'stylesheets')
-
-if (defined? Compass)
-  Compass::Frameworks.register('SassyLists', :path => extension_path)
-else
-  # compass not found, register on the Sass path via the environment.
-  if ENV.has_key?("SASS_PATH")
-    ENV["SASS_PATH"] = ENV["SASS_PATH"] + File::PATH_SEPARATOR + stylesheets_path
-  else
-    ENV["SASS_PATH"] = stylesheets_path
-  end
-end
-
-#  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 = "2.0.0"
-  DATE = "2014-06-30"
-end
-
+extension_path   = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+stylesheets_path = File.join(extension_path, 'stylesheets')
+
+if (defined? Compass)
+  Compass::Frameworks.register('SassyLists', :path => extension_path)
+else
+  # compass not found, register on the Sass path via the environment.
+  if ENV.has_key?("SASS_PATH")
+    ENV["SASS_PATH"] = ENV["SASS_PATH"] + File::PATH_SEPARATOR + stylesheets_path
+  else
+    ENV["SASS_PATH"] = stylesheets_path
+  end
+end
+
+#  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 = "2.1.0"
+  DATE = "2014-07-01"
+end
+

data/stylesheets/SassyLists/_chunk.scss

@@ -1,42 +1,42 @@
-// Chunks `$list` into `$size` large lists.
-//
-// @ignore Documentation: http://sassylists.com/documentation/#chunk
-//
-// @param {List}   $list  - list to chunk
-// @param {Number} $size  - length of lists
-//
-// @throws $size is not a number for `sl-chunk`.
-//
-// @return {List | Null}
-
-@function sl-chunk($list, $size) {
-  @if type-of($size) != "number" {
-    @warn "#{$size} is not a number for `sl-chunk`.";
-    @return null;
-  }
-
-  @if $size >= length($list) {
-    @return $list;
-  }
-
-  $index: 1;
-  $result: ();
-  $length: length($list);
-  $end: ceil($length / $size);
-
-  @for $i from 1 through $end {
-    $tmp: ();
-
-    @for $j from 1 through $size {
-      @if $index <= $length {
-        $is-orphan: $length % $size == 1 and $j == 1;
-        $tmp: if($is-orphan, nth($list, $index), append($tmp, nth($list, $index)));
-      }
-      $index: $index + 1;
-    }
-
-    $result: append($result, $tmp);
-  }
-
-  @return $result;
+// Chunks `$list` into `$size` large lists.
+//
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-chunk
+//
+// @param {List}   $list  - list to chunk
+// @param {Number} $size  - length of lists
+//
+// @throws $size is not a number for `sl-chunk`.
+//
+// @return {List | Null}
+
+@function sl-chunk($list, $size) {
+  @if type-of($size) != "number" {
+    @warn "#{$size} is not a number for `sl-chunk`.";
+    @return null;
+  }
+
+  @if $size >= length($list) {
+    @return $list;
+  }
+
+  $index: 1;
+  $result: ();
+  $length: length($list);
+  $end: ceil($length / $size);
+
+  @for $i from 1 through $end {
+    $tmp: ();
+
+    @for $j from 1 through $size {
+      @if $index <= $length {
+        $is-orphan: $length % $size == 1 and $j == 1;
+        $tmp: if($is-orphan, nth($list, $index), append($tmp, nth($list, $index)));
+      }
+      $index: $index + 1;
+    }
+
+    $result: append($result, $tmp);
+  }
+
+  @return $result;
 }

data/stylesheets/SassyLists/_comma-list.scss

@@ -0,0 +1,9 @@
+// Initialize an empty comma-separated list.
+// 
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-comma-list
+//
+// @return {List}
+
+@function sl-comma-list() {
+  @return zip((), ());
+}

data/stylesheets/SassyLists/_contain.scss

@@ -1,18 +1,18 @@
-// Returns whether `$list` contains `$value`.
-//
-// @ignore Documentation: http://sassylists.com/documentation/#contain
-//
-// @param {List}    $list  - list to check
-// @param {*}       $value - value to look for
-//
-// @return {Bool}
-
-@function sl-contain($list, $value) {
-  @return not not index($list, $value);
-}
-
-// @alias sl-contain
-
-@function sl-include($list, $value) {
-  @return sl-contain($list, $value);
+// Returns whether `$list` contains `$value`.
+//
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-contain
+//
+// @param {List}    $list  - list to check
+// @param {*}       $value - value to look for
+//
+// @return {Bool}
+
+@function sl-contain($list, $value) {
+  @return not not index($list, $value);
+}
+
+// @alias sl-contain
+
+@function sl-include($list, $value) {
+  @return sl-contain($list, $value);
 }

data/stylesheets/SassyLists/_count-values.scss

@@ -1,19 +1,19 @@
-// Counts the number of occurrences of each value of `$list`.
-//
-// @ignore Documentation: http://sassylists.com/documentation/#count-values
-//
-// @param {List} $list - list to count values from
-//
-// @return {Map} Values mapped to their count
-
-@function sl-count-values($list) {
-  $map: ();
-
-  @each $item in $list {
-    $index: map-get($map, $item);
-    $value: if($index, $index + 1, 1);
-    $map: map-merge($map, ($item: $value));
-  }
-
-  @return $map;
+// Counts the number of occurrences of each value of `$list`.
+//
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-count-values
+//
+// @param {List} $list - list to count values from
+//
+// @return {Map} Values mapped to their count
+
+@function sl-count-values($list) {
+  $map: ();
+
+  @each $item in $list {
+    $index: map-get($map, $item);
+    $value: if($index, $index + 1, 1);
+    $map: map-merge($map, ($item: $value));
+  }
+
+  @return $map;
 }