SassyStrings 1.1.3 → 1.1.4

data/stylesheets/public/_char-at.scss

@@ -1,31 +1,15 @@
-/*
- * Return character from $string at $index
- * ---
- * @access public
- * ---
- * @since 1.0.0
- * ---
- * @param {string} $string - string to check
- * @param {string} $index  - index to inspect
- * ---
- * @return {string}
- */
-
 @function char-at($string, $index) {
-    @if type-of($string) != "string" {
-        @warn "`char-at` function expecting a string for $string; #{type-of($string)} given.";
-        @return false;
-    }
+  @if type-of($string) != "string" {
+    @error "`char-at` function expecting a string for $string; #{type-of($string)} given.";
+  }
+
+  @if type-of($index) != "number" {
+    @error "`char-at` function expecting a number for $index; #{type-of($index)} given.";
+  }
 
-    @if type-of($index) != "number" {
-        @warn "`char-at` function expecting a number for $index; #{type-of($index)} given.";
-        @return false;
-    }
+  @if $index < 1 or $index > str-length($string) {
+    @error "Out of bounds $index for `char-at`.";
+  }
 
-    @if $index < 1 or $index > str-length($string) {
-        @warn "Out of bounds $index for `char-at`.";
-        @return false;
-    }
-    
-    @return _ss-char-at($string, $index);
-}
+  @return _ss-char-at($string, $index);
+}

data/stylesheets/public/_levenshtein.scss

@@ -1,26 +1,11 @@
-/*
- * Calculating Levenshtein distance between two strings
- * ---
- * @access public
- * ---
- * @since 1.0.0
- * ---
- * @param {string} $a - first string
- * @param {string} $b - second string
- * ---
- * @return {number}
- */
-
 @function levenshtein($a, $b) {
   @if type-of($a) != "string" {
-    @warn "`str-count` function expecting a string for $a; #{type-of($a)} given.";
-    @return false;
+    @error "`str-count` function expecting a string for $a; #{type-of($a)} given.";
   }
 
   @if type-of($b) != "string" {
-    @warn "`str-count` function expecting a string for $b; #{type-of($b)} given.";
-    @return false;
+    @error "`str-count` function expecting a string for $b; #{type-of($b)} given.";
   }
 
   @return _ss-levenshtein($a, $b);
-}
+}

data/stylesheets/public/_str-count.scss

@@ -1,26 +1,11 @@
-/*
- * Count the number of occurrences of $needle in $string
- * ---
- * @access public
- * ---
- * @since 1.0.0
- * ---
- * @param {string} $string - string
- * @param {string} $needle - substring to count in $string
- * ---
- * @return {number|false}
- */
-
 @function str-count($string, $needle) {
-    @if type-of($string) != "string" {
-        @warn "`str-count` function expecting a string for $string; #{type-of($string)} given.";
-        @return false;
-    }
+  @if type-of($string) != "string" {
+    @error "`str-count` function expecting a string for $string; #{type-of($string)} given.";
+  }
 
-    @if type-of($needle) != "string" {
-        @warn "`str-count` function expecting a string for $needle; #{type-of($needle)} given.";
-        @return false;
-    }
+  @if type-of($needle) != "string" {
+    @error "`str-count` function expecting a string for $needle; #{type-of($needle)} given.";
+  }
 
-    @return _ss-str-count($string, $needle);
-}
+  @return _ss-str-count($string, $needle);
+}

data/stylesheets/public/_str-ends-with.scss

@@ -1,25 +1,10 @@
-/*
- * Check whether $string ends with $needle
- * ---
- * @access public
- * ---
- * @since 1.0.0
- * ---
- * @param {string} $string - string to check
- * @param {string} $needle - substring to check
- * ---
- * @return {bool}
- */
-
 @function str-ends-with($string, $needle) {
   @if type-of($string) != "string" {
-    @warn "`str-starts-with` function expecting a string for $string; #{type-of($string)} given.";
-    @return false;
+    @error "`str-starts-with` function expecting a string for $string; #{type-of($string)} given.";
   }
 
   @if type-of($needle) != "string" {
-    @warn "`str-starts-with` function expecting a string for $needle; #{type-of($needle)} given.";
-    @return false;
+    @error "`str-starts-with` function expecting a string for $needle; #{type-of($needle)} given.";
   }
 
   @return _ss-str-ends-with($string, $needle);

data/stylesheets/public/_str-explode.scss

@@ -1,26 +1,11 @@
-/*
- * Split $string into several parts using $delimiter
- * ---
- * @access public
- * ---
- * @since 1.0.0
- * ---
- * @param {string} $string    - string to split
- * @param {string} $delimiter - string to use as a delimiter to split $string
- * ---
- * @return {list|false}
- */
-
 @function str-explode($string, $delimiter: '') {
   @if type-of($string) != "string" {
-    @warn "`explode` function expecting a string; #{type-of($string)} given.";
-    @return false;
+    @error "`explode` function expecting a string; #{type-of($string)} given.";
   }
 
   @if type-of($delimiter) != "string" {
-    @warn "`explode` function expecting a string; #{type-of($delimiter)} given.";
-    @return false;
+    @error "`explode` function expecting a string; #{type-of($delimiter)} given.";
   }
 
   @return _ss-str-explode($string, $delimiter);
-}
+}

data/stylesheets/public/_str-implode.scss

@@ -1,19 +1,7 @@
-/*
- * Implode $list into a string
- * ---
- * @access public
- * ---
- * @since 1.0.0
- * ---
- * @param {list} $list - list to convert to string
- * ---
- * @return {string}
- */
-
 @function str-implode($list) {
-    @if type-of($list) != list {
-        @error '$list for str-implode must be a list';
-    }
+  @if type-of($list) != "list" {
+    @error '$list for str-implode must be a list';
+  }
 
-    @return _ss-str-implode($list);
-}
+  @return _ss-str-implode($list);
+}

data/stylesheets/public/_str-last-index.scss

@@ -1,26 +1,11 @@
-/* 
- * Return last index of $needle in $string
- * ---
- * @access public
- * ---
- * @since 1.0.0
- * ---
- * @param {string} $string - string to search in
- * @param {string} $needle - substring to search for
- * ---
- * @return {number | null | false}
- */
-
 @function str-last-index($string, $needle) {
   @if type-of($string) != "string" {
-    @warn "`str-last-index` function expecting a string for $string; #{type-of($string)} given.";
-    @return false;
+    @error "`str-last-index` function expecting a string for $string; #{type-of($string)} given.";
   }
 
   @if type-of($needle) != "string" {
-    @warn "`str-last-index` function expecting a string for $needle; #{type-of($needle)} given.";
-    @return false;
+    @error "`str-last-index` function expecting a string for $needle; #{type-of($needle)} given.";
   }
 
   @return _ss-str-last-index($string, $needle);
-}
+}

data/stylesheets/public/_str-lcfirst.scss

@@ -1,20 +1,7 @@
-/*
- * Lower case first character of $string
- * ---
- * @access public
- * ---
- * @since 1.0.0
- * ---
- * @param {string} $string - string to lower the first character
- * ---
- * @return {string}
- */
-
 @function str-lcfirst($string) {
   @if type-of($string) != "string" {
-    @warn "`str-lcfirst` function expecting a string for $string; #{type-of($string)} given.";
-    @return false;
+    @error "`str-lcfirst` function expecting a string for $string; #{type-of($string)} given.";
   }
 
   @return _ss-str-lcfirst($string);
-}
+}

data/stylesheets/public/_str-pad.scss

@@ -1,33 +1,19 @@
-/*
- * Pad $string from $direction with $pad to reach $length characters
- * ---
- * @access public
- * ---
- * @since 1.0.0
- * ---
- * @param {string} $string    - string to pad
- * @param {number} $length    - number of characters to go for in returned string
- * @param {string} $pad       - string to use to pad $string
- * @param {string} $direction - direction left or right for padding
- * ---
- * @return {string|false}
- */
-
 @function str-pad($string, $length, $pad: " ", $direction: left) {
   @if type-of($string) != "string" {
-    @warn "`str-pad` function expecting a string for $string; #{type-of($string)} given.";
-    @return false;
+    @error "`str-pad` function expecting a string for $string; #{type-of($string)} given.";
   }
 
   @if type-of($pad) != "string" {
-    @warn "`str-pad` function expecting a string for $pad; #{type-of($pad)} given.";
-    @return false;
+    @error "`str-pad` function expecting a string for $pad; #{type-of($pad)} given.";
   }
 
   @if type-of($length) != "number" {
-    @warn "`str-pad` function expecting a number for $length; #{type-of($length)} given.";
-    @return false;
+    @error "`str-pad` function expecting a number for $length; #{type-of($length)} given.";
+  }
+
+  @if index(left right, $direction) == null {
+    @error "`str-pad` function expecting either `left` or `right` for $direction: #{$direction} given.";
   }
 
   @return _ss-str-pad($string, $length, $pad, $direction);
-}
+}

data/stylesheets/public/_str-printf.scss

@@ -1,21 +1,7 @@
-/*
- * Replace occurrences of %s in $string by $elements
- * ---
- * @access public
- * ---
- * @since 1.0.0
- * ---
- * @param {string}  $string   - string to check
- * @param {arglist} $elements - strings to use for replacements in %s
- * ---
- * @return {string | false}
- */
-
 @function str-printf($string, $elements...) {
   @if type-of($string) != "string" {
-    @warn "`str-printf` function expecting a string for $string; #{type-of($string)} given.";
-    @return false;
+    @error "`str-printf` function expecting a string for $string; #{type-of($string)} given.";
   }
 
   @return _ss-str-printf($string, $elements...);
-}
+}

data/stylesheets/public/_str-repeat.scss

@@ -1,26 +1,11 @@
-/*
- * Repeat $string $times times
- * ---
- * @access public
- * ---
- * @since 1.0.0
- * ---
- * @param {string} $string - string to repeat
- * @param {number} $times  - number of times to repeat $string
- * ---
- * @return {string|false}
- */
-
 @function str-repeat($string, $times) {
   @if type-of($string) != "string" {
-    @warn "`str-repeat` function expecting a string for $string; #{type-of($string)} given.";
-    @return false;
+    @error "`str-repeat` function expecting a string for $string; #{type-of($string)} given.";
   }
 
   @if type-of($times) != "number" {
-    @warn "`str-repeat` function expecting a number for $times; #{type-of($times)} given.";
-    @return false;
+    @error "`str-repeat` function expecting a number for $times; #{type-of($times)} given.";
   }
 
   @return _ss-str-repeat($string, $times);
-}
+}

data/stylesheets/public/_str-replace.scss

@@ -1,39 +1,16 @@
-/*
- * Replace $old occurrences by $new in $string respecting $case-sensitive
- * ---
- * @access public
- * ---
- * @since 1.0.0
- * ---
- * @param {string} $string         - string
- * @param {string} $old            - old substring to replace by $new
- * @param {string} $new            - new substring to replace $old
- * @param {bool}   $case-sensitive - case-sensitivity
- * ---
- * @return {string|false}
- */
-
-@function str-replace($string, $old, $new: '', $case-sensitive: true) {
+@function str-replace($string, $search, $replace: '') {
   @if type-of($string) != "string" {
-    @warn "`str-replace` function expecting a string for $string; #{type-of($string)} given.";
-    @return false;
-  }
-
-  @if type-of($old) != "string" {
-    @warn "`str-replace` function expecting a string for $old; #{type-of($old)} given.";
-    @return false;
+    @error "`str-replace` function expecting a string for $string; #{type-of($string)} given.";
   }
 
-  @if type-of($new) != "string" {
-    @warn "`str-replace` function expecting a string for $new; #{type-of($new)} given.";
-    @return false;
+  @if type-of($search) != "string" {
+    @error "`str-replace` function expecting a string for $search; #{type-of($search)} given.";
   }
 
-  @if str-index($new, $old) {
-    @warn "The string to be replaced is contained in the new string. Infinite recursion avoided.";
-    @return $string;
+  @if type-of($replace) != "string" {
+    @error "`str-replace` function expecting a string for $replace; #{type-of($replace)} given.";
   }
 
-  @return _ss-str-replace($string, $old, $new, $case-sensitive);
+  @return _ss-str-replace($string, $search, $replace);
 }
 

data/stylesheets/public/_str-reverse.scss

@@ -1,20 +1,7 @@
-/*
- * Reverse $string
- * ---
- * @access public
- * ---
- * @since 1.0.0
- * ---
- * @param {string} $string - string to reverse
- * ---
- * @return {string|false}
- */
-
 @function str-reverse($string) {
   @if type-of($string) != "string" {
-    @warn "`str-reverse` function expecting a string for $string; #{type-of($string)} given.";
-    @return false;
+    @error "`str-reverse` function expecting a string for $string; #{type-of($string)} given.";
   }
 
   @return _ss-str-reverse($string);
-}
+}

data/stylesheets/public/_str-rot.scss

@@ -1,26 +1,11 @@
-/*
- * Rotate all characters from the alphabet in $string by $rot positions
- * ---
- * @access public
- * ---
- * @since 1.0.0
- * ---
- * @param {string} $string - string to rotate
- * @param {number} $rot    - number of positions to switch in alphabet
- * ---
- * @return {string|false}
- */
-
 @function str-rot($string, $rot: 13) {
   @if type-of($string) != "string" {
-    @warn "`str-rot` function expecting a string for $string; #{type-of($string)} given.";
-    @return false;
+    @error "`str-rot` function expecting a string for $string; #{type-of($string)} given.";
   }
 
   @if type-of($rot) != "number" {
-    @warn "`str-rot` function expecting a number for $rot; #{type-of($rot)} given.";
-    @return false;
+    @error "`str-rot` function expecting a number for $rot; #{type-of($rot)} given.";
   }
 
   @return _ss-str-rot($string, $rot);
-}
+}