Bumping 2.1.0

at-import · Jul 1, 2014 · 9ec01d6 · 9ec01d6
1 parent 8a5de71
commit 9ec01d6
Show file tree

Hide file tree

Showing 17 changed files with 174 additions and 36 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,7 +1,8 @@
 # Changelog
 
+* `2.1.0`: adding `sl-is-empty()`, `sl-to-list()` and `sl-comma-list()`
 * `2.0.0`: 
- * adding `to-map()`, `every()` and `some()`
+ * 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

diff --git a/Gruntfile.js b/Gruntfile.js
@@ -25,6 +25,7 @@ module.exports = function(grunt) {
  '<%= dir.src %>/SassyLists/helpers/_str-compare.scss',
  '<%= dir.src %>/SassyLists/helpers/_true.scss',
  '<%= dir.src %>/SassyLists/_chunk.scss',
+ '<%= dir.src %>/SassyLists/_comma-list.scss',
  '<%= dir.src %>/SassyLists/_contain.scss',
  '<%= dir.src %>/SassyLists/_count-values.scss',
  '<%= dir.src %>/SassyLists/_debug.scss',
@@ -34,6 +35,7 @@ module.exports = function(grunt) {
  '<%= dir.src %>/SassyLists/_flatten.scss',
  '<%= dir.src %>/SassyLists/_insert-nth.scss',
  '<%= dir.src %>/SassyLists/_intersection.scss',
+ '<%= dir.src %>/SassyLists/_is-empty.scss',
  '<%= dir.src %>/SassyLists/_is-symmetrical.scss',
  '<%= dir.src %>/SassyLists/_last-index.scss',
  '<%= dir.src %>/SassyLists/_last.scss',
@@ -53,6 +55,7 @@ module.exports = function(grunt) {
  '<%= dir.src %>/SassyLists/_some.scss',
  '<%= dir.src %>/SassyLists/_sum.scss',
  '<%= dir.src %>/SassyLists/_tail.scss',
+ '<%= dir.src %>/SassyLists/_to-list.scss',
  '<%= dir.src %>/SassyLists/_to-map.scss',
  '<%= dir.src %>/SassyLists/_to-string.scss',
  '<%= dir.src %>/SassyLists/_union.scss',

diff --git a/README.md b/README.md
@@ -15,6 +15,7 @@ Here is a powerful toolbox providing you all the functions you need to manipulat
 ## 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
@@ -24,6 +25,7 @@ Here is a powerful toolbox providing you all the functions you need to manipulat
 * `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
@@ -43,6 +45,7 @@ Here is a powerful toolbox providing you all the functions you need to manipulat
 * `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

diff --git a/bower.json b/bower.json
@@ -1,6 +1,6 @@
 {
  "name": "SassyLists",
- "version": "1.0.0",
+ "version": "2.1.0",
  "homepage": "https://github.com/Team-Sass/SassyLists",
  "authors": [
  "Hugo Giraudel"

diff --git a/dist/_SassyLists.scss b/dist/_SassyLists.scss
@@ -1,4 +1,4 @@
-/*! SassyLists - v2.0.0 - 2014-06-30 */
+/*! SassyLists - v2.1.0 - 2014-07-01 */
 // Checks whether `$functions` exist in global scope.
 //
 // @access private
@@ -63,7 +63,7 @@
 }
 // Chunks `$list` into `$size` large lists.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#chunk
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-chunk
 //
 // @param {List} $list - list to chunk
 // @param {Number} $size - length of lists
@@ -103,9 +103,16 @@
 
  @return $result;
 }
+// Initialize an empty comma-separated list.
+// 
+// @return {List}
+
+@function sl-comma-list() {
+ @return zip((), ());
+}
 // Returns whether `$list` contains `$value`.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#contain
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-contain
 //
 // @param {List} $list - list to check
 // @param {*} $value - value to look for
@@ -123,7 +130,7 @@
 }
 // Counts the number of occurrences of each value of `$list`.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#count-values
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-count-values
 //
 // @param {List} $list - list to count values from
 //
@@ -142,7 +149,7 @@
 }
 // Returns `$list` as a string, prettified if `$pre` is set to true.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#debug
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-debug
 //
 // @param {List} $list - list to debug
 // @param {Bool} $pre (false) - enable/disable variables type and proper indentation
@@ -239,7 +246,7 @@
 
 // Explode `$string` into a list using `$delimiter` as a delimiter.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#explode
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-explode
 //
 // @param {String} $string - string to explode
 // @param {String} $separator ('') - string to use as a delimiter
@@ -310,7 +317,7 @@
 
 // Returns first element of `$list`.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#first
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-first
 //
 // @param {List} $list - list to retrieve first item from
 //
@@ -370,7 +377,7 @@
 }
 // Adds `$value` at `$index` in `$list`.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#insert-nth
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-insert-nth
 //
 // @requires sl-is-true
 //
@@ -419,7 +426,7 @@
 
 // Returns a list of shared value from `$list` and `$lists` minus duplicates.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#intersection
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-intersection
 //
 // @requires sl-remove-duplicates
 //
@@ -448,9 +455,27 @@
  $result: sl-remove-duplicates($result);
  @return if(length($result) == 1, nth($result, 1), $result);
 }
+// Tests whether `$list` is empty.
+//
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-is-empty
+//
+// @param {List} $list - list to run test against
+//
+// @return {Bool}
+
+@function sl-is-empty($list) {
+ @return length($list) == 0;
+}
+
+// @requires sl-is-empty
+// @alias sl-is-empty
+
+@function sl-empty($list) {
+ @return sl-is-empty($list);
+}
 // Checks whether `$list` is symmetrical.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#is-symmetrical
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-is-symmetrical
 //
 // @requires sl-reverse
 //
@@ -471,7 +496,7 @@
 }
 // Returns last index of `$value` in `$list`.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#last-index
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-last-index
 //
 // @param {List} $list - list to search
 // @param {*} $value - value to be searched for
@@ -492,7 +517,7 @@
 
 // Returns last element of `$list`.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#last
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-last
 //
 // @param {List} $list - list to retrieve last value from
 //
@@ -512,7 +537,7 @@
 //
 // @author Ana Tudor
 //
-// @ignore Documentation: http://sassylists.com/documentation/#loop
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-loop
 //
 // @param {List} $list - list to update
 // @param {Number} $value (1) - number of position between old and new indexes
@@ -548,7 +573,7 @@
 }
 // Adds `$value` as first index of `$list`.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#prepend
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-prepend
 //
 // @requires sl-is-true
 //
@@ -631,7 +656,7 @@
 }
 // Removes duplicate values from `$list`.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#remove-duplicates
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-remove-duplicates
 //
 // @param {List} $list - list to remove duplicates from
 //
@@ -656,7 +681,7 @@
 }
 // Removes value from `$list` at index `$index`.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#remove-nth
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-remove-nth
 //
 // @requires sl-replace-nth
 //
@@ -678,7 +703,7 @@
 }
 // Removes value(s) `$value` from `$list`.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#remove
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-remove
 //
 // @requires sl-replace
 //
@@ -701,7 +726,7 @@
 }
 // Replaces value at `$index` from `$list` by `$value`.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#replace-nth
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-replace-nth
 //
 // @requires sl-purge
 // @requires sl-is-true
@@ -761,7 +786,7 @@
 }
 // Reverses the order of `$list`.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#reverse
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-reverse
 //
 // @param {List} $list - list to reverse
 //
@@ -791,7 +816,7 @@
 }
 // Shuffle `$list` using Fisher-Yates method.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#shuffle
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-shuffle
 //
 // @param {List} $list - list to shuffle
 //
@@ -822,7 +847,7 @@
 
 // Slices `$list` between `$start` and `$end`.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#slice
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-slice
 //
 // @param {List} $list - list to slice
 // @param {Number} $start (1) - start index
@@ -876,7 +901,7 @@
 }
 // Sorts values of `$list` using quick-sort algorithm using `$order`.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#sort
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-sort
 //
 // @requires sl-str-compare
 //
@@ -937,7 +962,7 @@
 
 // Sums up all numeric values in `$list`, stripping unit if `$force` set to `true`.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#sum
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-sum
 //
 // @param {List} $list - list
 // @param {Bool} $force (false) - enable/disable parseInt
@@ -966,7 +991,7 @@
 
 // Returns the tail of `$list`: all items except the first (head).
 //
-// @ignore Documentation: http://sassylists.com/documentation/#tail
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-tail
 //
 // @requires sl-slice
 //
@@ -985,13 +1010,32 @@
 @function sl-rest($list) {
  @return sl-tail($list);
 }
+// Cast `$value` into list
+//
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-to-list
+//
+// @param {*} $value - value to cast to list
+//
+// @return {List}
+
+@function sl-to-list($value) {
+ @return if(type-of($value) == "list", $value, ($value,));
+}
+
+// @requires sl-to-list
+// @alias sl-to-list
+
+@function sl-listify($value) {
+ @return sl-to-list($value);
+}
+
 // Cast a `$list` into a map, using indexes as keys (starting with `$start`).
 // Useful for iterating through a list with an index variable.
 // e.g. `@each $i, $value in to-map($list)`
 //
 // @author Andrey "Lolmaus" Mikhaylov
 // 
-// @ignore Documentation: http://sassylists.com/documentation/#to-map
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-to-map
 // 
 // @param {List} $list - list to turn into map
 // @param {Number} $start (1) - index to start with
@@ -1038,7 +1082,7 @@
 }
 // Joins all elements of `$list` with `$glue`.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#to-string
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-to-string
 //
 // @param {List} $list - list to cast
 // @param {String} $glue ('') - value to use as a join string
@@ -1064,7 +1108,7 @@
 }
 // Returns a list of values from `$lists` minus duplicates.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#union
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-union
 //
 // @requires sl-flatten
 // @requires sl-remove-duplicates
@@ -1089,7 +1133,7 @@
 
 // Apply `$function` to every item from `$list` passing $args as parameters.
 //
-// @ignore Documentation: http://sassylists.com/documentation/#walk
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-walk
 //
 // @param {List} $list - list to update
 // @param {String} $function - function to call on each value

diff --git a/lib/SassyLists.rb b/lib/SassyLists.rb
@@ -15,7 +15,7 @@
 # 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"
+ VERSION = "2.1.0"
+ DATE = "2014-07-01"
 end
 
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "SassyLists",
- "version": "2.0.0",
+ "version": "2.1.0",
  "description": "A Sass API for lists.",
  "scripts": {
  "test": "grunt test"

diff --git a/stylesheets/SassyLists/_comma-list.scss b/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((), ());
+}