SassyStrings 1.0.1 → 1.1.0

data/stylesheets/private/_str-repeat.scss

@@ -0,0 +1,22 @@
+/*
+ * Repeat $string $times times
+ * ---
+ * @access private
+ * ---
+ * @since 1.2.0
+ * ---
+ * @param {string} $string - string to repeat
+ * @param {number} $times  - number of times to repeat $string
+ * ---
+ * @return {string|false}
+ */
+
+@function _ss-str-repeat($string, $times) {
+  $result: "";
+
+  @for $i from 1 through $times {
+    $result: $result + $string;
+  }
+
+  @return $result;
+}

data/stylesheets/private/_str-replace.scss

@@ -0,0 +1,33 @@
+/*
+ * Replace $old occurrences by $new in $string respecting $case-sensitive
+ * ---
+ * @access private
+ * ---
+ * @since 1.2.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}
+ */
+
+@function _ss-str-replace($string, $old, $new: '', $case-sensitive: true) {
+  $index: if(not $case-sensitive, str-index(to-lower-case($string), to-lower-case($old)),  str-index($string, $old));
+
+  @if $index and $new != $old {
+    $result: if($index != 1, quote(str-slice($string, 1, $index - 1)), '');
+
+    @for $i from $index through str-length($string) {
+      @if $i < $index or $i >= $index + str-length($old) {
+        $result: $result + str-slice($string, $i, $i);
+      }
+    }
+
+    @return quote(str-replace(str-insert($result, $new, $index), $old, $new, $case-sensitive)); 
+  }
+
+  @return $string;
+}
+

data/stylesheets/private/_str-reverse.scss

@@ -0,0 +1,21 @@
+/*
+ * Reverse $string
+ * ---
+ * @access private
+ * ---
+ * @since 1.2.0
+ * ---
+ * @param {string} $string - string to reverse
+ * ---
+ * @return {string} 
+ */
+
+@function _ss-str-reverse($string) {
+  $result: "";
+
+  @for $i from str-length($string) * -1 through -1 {
+    $result: $result + str-slice($string, abs($i), abs($i));
+  }
+
+  @return $result;
+}

data/stylesheets/private/_str-rot.scss

@@ -0,0 +1,39 @@
+/*
+ * Rotate all characters from the alphabet in $string by $rot positions
+ * ---
+ * @access private
+ * ---
+ * @since 1.2.0
+ * ---
+ * @param {string} $string - string to rotate
+ * @param {number} $rot    - number of positions to switch in alphabet
+ * ---
+ * @return {string}
+ */
+
+@function _ss-str-rot($string, $rot: 13) {
+  $alphabet: a b c d e f g h i j k l m n o p q r s t u v w x y z;
+  $result: "";
+  $rot: if(type-of($rot) == "number", floor($rot), 13);
+
+  @for $i from 1 through str-length($string) {
+    $char: str-slice($string, $i, $i);
+    $index: index($alphabet, to-lower-case($char));
+    $is-caps: $index and (index($alphabet, to-lower-case($char)) != index($alphabet, $char));
+    $new-char: if($index, 
+      if($index + $rot > length($alphabet), 
+        nth($alphabet, $index + $rot - length($alphabet)), 
+        nth($alphabet, $index + $rot)
+      ),
+      $char
+    );
+
+    @if $is-caps {
+      $new-char: to-upper-case($new-char);
+    }
+
+    $result: $result + $new-char;
+  }
+
+  @return $result;
+}

data/stylesheets/private/_str-shuffle.scss

@@ -0,0 +1,36 @@
+/*
+ * Shuffle characters from $string
+ * ---
+ * @access private
+ * ---
+ * @since 1.2.0
+ * ---
+ * @param {string} $string - string to shuffle
+ * ---
+ * @return {string}
+ */
+
+@function _ss-str-shuffle($string) {
+    @return str-implode(_ss-shuffle(str-explode($string)));
+}
+
+/*
+ * Shuffle a list
+ * ---
+ * @access private
+ * ---
+ * @param {list} $list - shuffle a list
+ * ---
+ * @return {list}
+ */
+
+@function _ss-shuffle($list) {
+    @for $i from -1 * length($list) through -1 {
+        $i: abs($i);
+        $j: random(length($list) - 1) + 1;
+        $tmp: nth($list, $i);
+        $list: set-nth($list, $i, nth($list, $j));
+        $list: set-nth($list, $j, $tmp);
+    }
+    @return $list;
+}

data/stylesheets/private/_str-starts-with.scss

@@ -0,0 +1,16 @@
+/*
+ * Check whether $string stars with $needle
+ * ---
+ * @access private
+ * ---
+ * @since 1.2.0
+ * ---
+ * @param {string} $string - string to check
+ * @param {string} $needle - substring to check
+ * ---
+ * @return {bool}
+ */
+
+@function _ss-str-starts-with($string, $needle) {
+  @return str-slice($string, 1, str-length($needle)) == $needle;
+}

data/stylesheets/private/_str-trim.scss

@@ -0,0 +1,31 @@
+/*
+ * Remove all trailing and leading whitespaces from $string
+ * ---
+ * @access private
+ * ---
+ * @since 1.2.0
+ * ---
+ * @param {string} $string - string
+ * ---
+ * @return {string}
+ */
+
+@function _ss-str-trim($string) {
+  $start: 1;
+  $end: str-length($string);
+
+  @for $i from 1 through str-length($string) {
+    $first: str-slice($string, $i, $i);
+    $last: str-slice($string, -$i, -$i);
+
+    @if $first == " " and $i + 1 == $start + 1 {
+      $start: $i + 1;
+    }
+
+    @if $last == " " and str-length($string) - $i == $end - 1 {
+      $end: str-length($string) - $i;
+    }
+  }
+
+  @return str-slice($string, $start, $end);
+}

data/stylesheets/private/_str-ucfirst.scss

@@ -0,0 +1,15 @@
+/* 
+ * Capitalize first letter from $string
+ * ---
+ * @access private
+ * ---
+ * @since 1.2.0
+ * ---
+ * @param {string} $string - string for capitalization
+ * ---
+ * @return {string}
+ */
+
+@function _ss-str-ucfirst($string) {
+  @return to-upper-case(str-slice($string, 1, 1)) + str-slice($string, 2);
+}

data/stylesheets/{functions → private}/_str-word-count.scss

@@ -1,17 +1,16 @@
 /*
  * Count number of words in $string
  * ---
+ * @access private
+ * ---
+ * @since 1.2.0
+ * ---
  * @param {string} $string - string to check
  * ---
  * @return {string|false}
  */
 
-@function str-word-count($string) {
-    @if type-of($string) != "string" {
-        @warn "`str-word-count` function expecting a string for $string; #{type-of($string)} given.";
-        @return false;
-    }
-    
+@function _ss-str-word-count($string) {
     @if $string == '' {
         @return 0;
     }

data/stylesheets/private/_stringify.scss

@@ -0,0 +1,26 @@
+/*
+ * Cast anything to string
+ * ---
+ * @access private
+ * ---
+ * @since 1.2.0
+ * ---
+ * @param {literal} $literal: number to cast to string
+ * ---
+ * @return {string}
+ */
+
+@function _ss-stringify($literal) {
+    $result: "";
+
+    @if length($literal) == 1 {
+        $result: $literal + unquote("");
+    } @else {
+        @each $item in $literal {
+            $result: $result + stringify($item);
+        }
+    }
+
+    @return quote($result);
+    
+}

data/stylesheets/public/_all.scss

@@ -0,0 +1,23 @@
+//* ----------------------------------------------------- */
+// Public files for use in your project 
+//* ----------------------------------------------------- */
+@import "char-at";
+@import "levenshtein";
+@import "str-count";
+@import "str-ends-with";
+@import "str-explode";
+@import "str-implode";
+@import "str-last-index";
+@import "str-lcfirst";
+@import "str-pad";
+@import "str-printf";
+@import "str-repeat";
+@import "str-replace";
+@import "str-reverse";
+@import "str-rot";
+@import "str-shuffle";
+@import "str-starts-with";
+@import "str-trim";
+@import "str-ucfirst";
+@import "str-word-count";
+@import "stringify";

data/stylesheets/public/_char-at.scss

@@ -0,0 +1,31 @@
+/*
+ * 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($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) {
+        @warn "Out of bounds $index for `char-at`.";
+        @return false;
+    }
+    
+    @return _ss-char-at($string, $index);
+}

data/stylesheets/public/_levenshtein.scss

@@ -0,0 +1,26 @@
+/*
+ * 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;
+  }
+
+  @if type-of($b) != "string" {
+    @warn "`str-count` function expecting a string for $b; #{type-of($b)} given.";
+    @return false;
+  }
+
+  @return _ss-levenshtein($a, $b);
+}

data/stylesheets/public/_str-count.scss

@@ -0,0 +1,26 @@
+/*
+ * 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($needle) != "string" {
+        @warn "`str-count` function expecting a string for $needle; #{type-of($needle)} given.";
+        @return false;
+    }
+
+    @return _ss-str-count($string, $needle);
+}

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

@@ -0,0 +1,26 @@
+/*
+ * 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;
+  }
+
+  @if type-of($needle) != "string" {
+    @warn "`str-starts-with` function expecting a string for $needle; #{type-of($needle)} given.";
+    @return false;
+  }
+
+  @return _ss-str-ends-with($string, $needle);
+}

data/stylesheets/public/_str-explode.scss

@@ -0,0 +1,26 @@
+/*
+ * 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;
+  }
+
+  @if type-of($delimiter) != "string" {
+    @warn "`explode` function expecting a string; #{type-of($delimiter)} given.";
+    @return false;
+  }
+
+  @return _ss-str-explode($string, $delimiter);
+}