SassyCast 1.0.0 → 1.1.0

data/stylesheets/{types → private}/number/helpers/_find-digits.scss

@@ -1,34 +1,36 @@
-// Finding the digits part of a stringified number
-// --------------------------------------------------------------------------------
-// @param [string] $source: string source
-// @param [number] $pointer: current pointer
-// --------------------------------------------------------------------------------
-// @return [list] (new pointer, parsed number)
-
-@function _find-digits($source, $pointer) {
-  $source: to-lower-case($source);
-  $length: str-length($source);
-  $numbers: '0' '1' '2' '3' '4' '5' '6' '7' '8' '9';
-  $result: 0;
-  $runs: 1;
-
-  @while $pointer <= $length {
-    $token: str-slice($source, $pointer, $pointer);
-    $index: index($numbers, $token);
-
-    @if $token == '.' {
-      // @continue;
-    }
-    @else if $index and $index > 0 {
-      $runs: $runs * 10;
-      $result: $result * 10 + ($index - 1);
-    }
-    @else {
-      @return $pointer, $result / $runs;
-    }
-
-    $pointer: $pointer + 1;
-  }
-
-  @return $pointer, $result / $runs;
+/**
+ * Finding the digits part of a stringified number
+ * ---
+ * @param {string} $source - string source
+ * @param {number} $pointer - current pointer
+ * ---
+ * @return {list} - new pointer, parsed number
+ */
+
+@function _sc-find-digits($source, $pointer) {
+  $source: to-lower-case($source);
+  $length: str-length($source);
+  $numbers: '0' '1' '2' '3' '4' '5' '6' '7' '8' '9';
+  $result: 0;
+  $runs: 1;
+
+  @while $pointer <= $length {
+    $token: str-slice($source, $pointer, $pointer);
+    $index: index($numbers, $token);
+
+    @if $token == '.' {
+      // @continue;
+    }
+    @else if $index and $index > 0 {
+      $runs: $runs * 10;
+      $result: $result * 10 + ($index - 1);
+    }
+    @else {
+      @return $pointer, $result / $runs;
+    }
+
+    $pointer: $pointer + 1;
+  }
+
+  @return $pointer, $result / $runs;
 }

data/stylesheets/{types → private}/number/helpers/_find-integer.scss

@@ -1,33 +1,35 @@
-// Finding the integer part of a stringified number
-// --------------------------------------------------------------------------------
-// @param [string] $source: string source
-// @param [number] $pointer: current pointer
-// --------------------------------------------------------------------------------
-// @return [list] (new pointer, parsed number)
-
-@function _find-integer($source, $pointer) {
-  $source: to-lower-case($source);
-  $length: str-length($source);
-  $numbers: '0' '1' '2' '3' '4' '5' '6' '7' '8' '9';
-  $result: 0;
-
-  @while $pointer <= $length {
-    $token: str-slice($source, $pointer, $pointer);
-    $index: index($numbers, $token);
-
-    @if $token == '-' {
-      // @continue;
-    }
-    @else if $index {
-      $result: $result * 10 + ($index - 1);
-    }
-    @else {
-      @return $pointer, $result;
-    }
-
-    $pointer: $pointer + 1;
-  }
-
-  @return $pointer, $result;
-}
-
+/**
+ * Finding the integer part of a stringified number
+ * ---
+ * @param {string} $source  - string source
+ * @param {number} $pointer - current pointer
+ * ---
+ * @return {list} new pointer, parsed number
+ */
+
+@function _sc-find-integer($source, $pointer) {
+  $source: to-lower-case($source);
+  $length: str-length($source);
+  $numbers: '0' '1' '2' '3' '4' '5' '6' '7' '8' '9';
+  $result: 0;
+
+  @while $pointer <= $length {
+    $token: str-slice($source, $pointer, $pointer);
+    $index: index($numbers, $token);
+
+    @if $token == '-' {
+      // @continue;
+    }
+    @else if $index {
+      $result: $result * 10 + ($index - 1);
+    }
+    @else {
+      @return $pointer, $result;
+    }
+
+    $pointer: $pointer + 1;
+  }
+
+  @return $pointer, $result;
+}
+

data/stylesheets/private/number/helpers/_length.scss

@@ -0,0 +1,21 @@
+/**
+ * Tries to find a unit that would match a CSS length
+ * ---
+ * @param {number} $number - number
+ * @param {unit}   $unit   - potential unit
+ * ---
+ * @return {number} length (0 if cast failed)
+ */
+
+@function _sc-length($number, $unit) {
+  $strings: 'px' 'cm' 'mm' '%' 'ch' 'pica' 'in' 'em' 'rem' 'pt' 'pc' 'ex' 'vw' 'vh' 'vmin' 'vmax';
+  $units:   1px  1cm  1mm  1%  1ch  1pica  1in  1em  1rem  1pt  1pc  1ex  1vw  1vh  1vmin  1vmax;
+  $index: index($strings, $unit);
+  
+  @if not $index {
+    @warn "Unknown unit `#{inspect($unit)}`.";
+    @return 0;
+  }
+  
+  @return $number * nth($units, $index);
+}

data/stylesheets/private/number/helpers/_pow.scss

@@ -0,0 +1,24 @@
+/**
+ * Power function
+ * ---
+ * @param {number} $x - number
+ * @param {number} $n - power
+ * ---
+ * @return [number] $x ^ $n
+ */
+
+@function _sc-pow($x, $n) {
+  $ret: 1;
+
+  @if $n >= 0 {
+    @for $i from 1 through $n {
+      $ret: $ret * $x;
+    }
+  } @else {
+    @for $i from $n to 0 {
+      $ret: $ret / $x;
+    }
+  }
+
+  @return $ret;
+}

data/stylesheets/private/string/_string.scss

@@ -0,0 +1,15 @@
+/* Convert to string
+ * ---
+ * @access private
+ * ---
+ * @param {*} $value - value to cast
+ * ---
+ * @return {string}
+ */
+
+@function _sc-to-string($value) {
+  @if type-of($value) == color {
+    @warn "Beware! Sass does some color conversion. The resulting string may be different from the color input.";
+  }
+  @return if(type-of($value) != string, inspect($value), $value);
+}

data/stylesheets/public/_all.scss

@@ -0,0 +1,7 @@
+@import "bool/bool";
+@import "number/number";
+@import "string/string";
+@import "list/list";
+@import "map/map";
+@import "null/null";
+@import "color/color";

data/stylesheets/public/bool/_bool.scss

@@ -0,0 +1,13 @@
+/**
+ * Convert to bool
+ * ---
+ * @access public
+ * ---
+ * @param {*} $value - value to cast
+ * ---
+ * @return {bool}
+ */
+
+@function to-bool($value) {
+    @return _sc-to-bool($value);
+}

data/stylesheets/public/color/_color.scss

@@ -0,0 +1,13 @@
+/** 
+ * Convert to color
+ * ---
+ * @access public
+ * ---
+ * @param {*} $value - value to cast
+ * ---
+ * @return {color | null}
+ */
+
+@function to-color($value) {
+    @return _sc-to-color($value);
+}

data/stylesheets/public/list/_list.scss

@@ -0,0 +1,13 @@
+/**
+ * Convert to list
+ * ---
+ * @access public
+ * ---
+ * @param {*} $value - value to cast
+ * ---
+ * @return {list}
+ */
+
+@function to-list($value, $keep: 'both') {
+    @return _sc-to-list($value,$keep);
+}

data/stylesheets/public/map/_map.scss

@@ -0,0 +1,13 @@
+/**
+ * Convert to map
+ * ---
+ * @access public
+ * ---
+ * @param {*} $value - value to cast
+ * ---
+ * @return {map}
+ */
+
+@function to-map($value) {
+    @return _sc-to-map($value);
+}

data/stylesheets/public/null/_null.scss

@@ -0,0 +1,13 @@
+/**
+ * Convert to null
+ * ---
+ * @access public
+ * ---
+ * @param {*} $value - value to cast
+ * ---
+ * @return null
+ */
+
+@function to-null($value) {
+  @return _sc-to-null($value);
+}

data/stylesheets/public/number/_number.scss

@@ -0,0 +1,13 @@
+/*
+ * Cast a value to a number if possible or return 0
+ * ---
+ * @access public
+ * ---
+ * @param {string} $value - complete source
+ * ---
+ * @return {number}
+ */
+
+@function to-number($value) {
+    @return _sc-to-number($value);
+}

data/stylesheets/public/string/_string.scss

@@ -0,0 +1,12 @@
+/* Convert to string
+ * ---
+ * @access public
+ * ---
+ * @param {*} $value - value to cast
+ * ---
+ * @return {string}
+ */
+
+@function to-string($value) {
+    @return _sc-to-string($value);
+}

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: SassyCast
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Hugo Giraudel
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-01-31 00:00:00.000000000 Z
+date: 2014-10-03 00:00:00.000000000 Z
 dependencies: []
 description: Sass API for type conversion.
 email:
@@ -20,23 +20,32 @@ files:
 - README.md
 - CHANGELOG.md
 - lib/SassyCast.rb
+- stylesheets/private/_all.scss
+- stylesheets/private/bool/_bool.scss
+- stylesheets/private/color/_color.scss
+- stylesheets/private/color/helpers/_from-hex.scss
+- stylesheets/private/color/helpers/_from-hsl.scss
+- stylesheets/private/color/helpers/_from-rgb.scss
+- stylesheets/private/color/helpers/_get-color-value.scss
+- stylesheets/private/color/helpers/_hex-to-dec.scss
+- stylesheets/private/list/_list.scss
+- stylesheets/private/map/_map.scss
+- stylesheets/private/null/_null.scss
+- stylesheets/private/number/_number.scss
+- stylesheets/private/number/helpers/_find-digits.scss
+- stylesheets/private/number/helpers/_find-integer.scss
+- stylesheets/private/number/helpers/_length.scss
+- stylesheets/private/number/helpers/_pow.scss
+- stylesheets/private/string/_string.scss
+- stylesheets/public/_all.scss
+- stylesheets/public/bool/_bool.scss
+- stylesheets/public/color/_color.scss
+- stylesheets/public/list/_list.scss
+- stylesheets/public/map/_map.scss
+- stylesheets/public/null/_null.scss
+- stylesheets/public/number/_number.scss
+- stylesheets/public/string/_string.scss
 - stylesheets/SassyCast.scss
-- stylesheets/types/bool/_bool.scss
-- stylesheets/types/color/helpers/_from-hex.scss
-- stylesheets/types/color/helpers/_from-hsl.scss
-- stylesheets/types/color/helpers/_from-rgb.scss
-- stylesheets/types/color/helpers/_get-color-value.scss
-- stylesheets/types/color/helpers/_hex-to-dec.scss
-- stylesheets/types/color/_color.scss
-- stylesheets/types/list/_list.scss
-- stylesheets/types/map/_map.scss
-- stylesheets/types/null/_null.scss
-- stylesheets/types/number/helpers/_find-digits.scss
-- stylesheets/types/number/helpers/_find-integer.scss
-- stylesheets/types/number/helpers/_length.scss
-- stylesheets/types/number/helpers/_pow.scss
-- stylesheets/types/number/_number.scss
-- stylesheets/types/string/_string.scss
 homepage: https://github.com/HugoGiraudel/SassyCast/
 licenses: []
 metadata: {}
@@ -56,7 +65,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 1.3.6
 requirements: []
 rubyforge_project: SassyCast
-rubygems_version: 2.0.3
+rubygems_version: 2.0.14
 signing_key: 
 specification_version: 4
 summary: SassyCast is a Sass-powered API for type conversion.

data/stylesheets/types/bool/_bool.scss

@@ -1,12 +0,0 @@
-// Convert to bool
-// --------------------------------------------------------------------------------
-// @param $value: value to cast
-// --------------------------------------------------------------------------------
-// @return [bool]
-
-@function to-bool($value) {
-  @if not $value or $value == "" or $value == 0 {
-    @return false;
-  }
-  @return true;
-}

data/stylesheets/types/color/helpers/_get-color-value.scss

@@ -1,18 +0,0 @@
-// Cast a stringified number / stringified percentage into number type
-// --------------------------------------------------------------------------------
-// @param [string] $string: string
-// --------------------------------------------------------------------------------
-// @return [number] unitless number or percentage
-
-@function _get-color-value($string) {
-  $first: str-slice($string, 1, 1);
-
-  // Pad <1 values with a leading 0
-  @if $first == '.' {
-    $string: '0' + $string;
-  }
-
-  $last: str-slice($string, -1, -1);
-  
-  @return if($last == '%', to-number(str-slice($string, 1, -2), 2) * 1%, to-number($string));
-}

data/stylesheets/types/color/helpers/_hex-to-dec.scss

@@ -1,20 +0,0 @@
-// Convert an hexadecimal number to a decimal number
-// --------------------------------------------------------------------------------
-// @param [string] $string: hexadecimal value
-// --------------------------------------------------------------------------------
-// @return [number] decimal number
-
-@function _hex-to-dec($string){
-  $hex: "0" "1" "2" "3" "4" "5" "6" "7" "8" "9" "a" "b" "c" "d" "e" "f";
-  $string: to-lower-case($string);
-  $length: str-length($string);
-  
-  $dec: 0;
-  @for $i from 1 through $length {
-    $factor: 1 + ( 15 * ( $length - $i ));
-    $index: index($hex, str-slice($string, $i, $i));
-    $dec: $dec + $factor * ($index - 1);
-  }
-  
-  @return $dec;
-} 

data/stylesheets/types/map/_map.scss

@@ -1,17 +0,0 @@
-// Convert to map
-// --------------------------------------------------------------------------------
-// @param $value: value to cast
-// --------------------------------------------------------------------------------
-// @return [map]
-
-@function to-map($value) {
-  @if type-of($value) == list {
-    $map: ();
-    @for $i from 1 through length($value) {
-      $map: map-merge($map, ($i: nth($value, $i)));
-    }
-    @return $map;
-  }
-
-  @return if(type-of($value) != map, (1: $value), $value);
-}