SassyBitwise 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5ecf3c37e8178ad93df44d11ddd33bfac361cfa4
+  data.tar.gz: b0bece9d963e5763a55072f898719797259eaf5f
+SHA512:
+  metadata.gz: 1cb99b81efd15b9564f7b093710d889c36334c219fff17ca350234ba6cde9453ca4e8de179c0ab29766b2691941e5a4c339eb72138e905df27268d8a8f69ab06
+  data.tar.gz: cc086c572c15a7f7caf0f953eb1c2e044066be36a49469d290bff5b2bbcf2572cd9f789e8d8338021d810a9808c5019656bb43ee06c776b9b75cd6509c7bd449

data/CHANGELOG.md

@@ -0,0 +1,4 @@
+# Changelog
+
+* `1.0.0`: stable API, gem release
+* `0.0.1`: initial commit

data/lib/SassyBitwise.rb

@@ -0,0 +1,14 @@
+require 'compass'
+extension_path = File.expand_path(File.join(File.dirname(__FILE__), ".."))
+Compass::Frameworks.register('SassyBitwise', :path => extension_path)
+
+#  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 SassyBitwise
+  VERSION = "1.0.0"
+  DATE = "2014-06-04"
+end
+
+module Sass::Script::Functions
+
+end

data/stylesheets/SassyBitwise/api/_bitwise.scss

@@ -0,0 +1,46 @@
+// Bitwise helper function
+// ---
+// @param [list] $args: list of parameters
+// ---
+// @return [number]
+// ---
+@function bitwise($args) {
+  @if not arguments-validator($args) {
+    @return false;
+  }
+
+  // Handling not first
+  @if nth($args, 1) == "~" {
+    @return bw-not(nth($args, 2));
+  }
+
+  // Then all others
+  $operator: to-lower-case(nth($args, 2));
+  $x: nth($args, 1);
+  $y: nth($args, 3);
+
+  @if $operator == "^" {
+    @return bw-xor($x, $y);
+  }
+
+  @else if $operator == "|" {
+    @return bw-or($x, $y);
+  }
+
+  @else if $operator == "&" {
+    @return bw-and($x, $y);
+  }
+
+  @else if $operator == "<<" {
+    @return bw-shift-left($x, $y);
+  }
+
+  @else if $operator == ">>" {
+    @return bw-shift-right($x, $y);
+  }
+
+  @else {
+    @warn "Wrong operator `#{$operator}` for `bitwise` function.";
+    @return false
+  }
+}

data/stylesheets/SassyBitwise/helpers/_binary-length.scss

@@ -0,0 +1,9 @@
+// Returns binary length
+// ---
+// @param [number] $value: value
+// ---
+// @return [number]
+// ---
+@function binary-length($value) {
+  @return str-length(decimal-to-binary($value) + unquote(""))
+}

data/stylesheets/SassyBitwise/helpers/_binary-to-decimal.scss

@@ -0,0 +1,27 @@
+// Convert from base 2 to base 10
+// ---
+// @param [number] $value: binary to convert
+// ---
+// @return [number]
+// ---
+@function binary-to-decimal($value) {
+  $value: $value + unquote('');
+  $result: if(str-slice($value, 1, 1) == "0", 0, 1);
+
+  @for $i from 2 through str-length($value) {
+    $c: str-slice($value, $i, $i);
+
+    @if not index("0" "1", $c) {
+      @warn "Not binary.";
+      @return false
+    }
+
+    $result: $result * 2;
+
+    @if $c == "1" {
+      $result: $result + 1
+    }
+  }
+
+  @return $result
+}

data/stylesheets/SassyBitwise/helpers/_decimal-to-binary.scss

@@ -0,0 +1,24 @@
+// Convert from base 10 to base 2
+// ---
+// @param [number] $value: decimal to convert
+// ---
+// @return [number]
+// ---
+@function decimal-to-binary($value) {
+  $largest: largest-power-of-2($value);
+  $result: 0;
+
+  @while $largest >= 1 {
+    @if $value - $largest >= 0 {
+      $value: $value - $largest;
+      $result: $result * 10 + 1
+    }
+    @else {
+      $result: $result * 10
+    }
+
+    $largest: $largest / 2
+  }
+
+  @return $result
+}

data/stylesheets/SassyBitwise/helpers/_largest-power-of-2.scss

@@ -0,0 +1,16 @@
+// Returns largest power of 2 lesser than $value
+// ---
+// @param [number] $value: value
+// ---
+// @return [number]
+// ---
+@function largest-power-of-2($value) {
+  $result: 1;
+  @while $result <= $value {
+    @if $result * 2 > $value {
+      @return $result
+    }
+    $result: $result * 2
+  }
+  @return $result
+}

data/stylesheets/SassyBitwise/helpers/_power.scss

@@ -0,0 +1,25 @@
+// Power function
+// Using Compass if defined
+// ---
+// @param [number] $x: first value
+// @param [number] $y: second value
+// ---
+// @return [number]
+// ---
+@function power($x, $y) {
+  @if function-exists('pow') == true {
+    @return pow($x, $y)
+  }
+
+  $ret: 1;
+  @if $y >= 0 {
+      @for $i from 1 through $y {
+          $ret: $ret * $x
+      }
+  } @else {
+      @for $i from $y to 0 {
+          $ret: $ret / $x
+      }
+  }
+  @return $ret
+}

data/stylesheets/SassyBitwise/helpers/_sign.scss

@@ -0,0 +1,9 @@
+// Returns sign of $x
+// ---
+// @param [number] $x: value
+// ---
+// @return [number]
+// ---
+@function sign($x) {
+  @return if($x > 0, 1, if($x < 0, -1, 0))
+}

data/stylesheets/SassyBitwise/operators/_and.scss

@@ -0,0 +1,19 @@
+// `and` bitwise operator
+// $x & $y
+// ---
+// @param [number] $x: first value
+// @param [number] $y: second value
+// ---
+// @return [number]
+// ---
+@function bw-and($x, $y) {
+  $b: binary-length($x);
+  $res: 0;
+
+  @for $i from 0 through $b {
+    $h: power(2, $i);
+    $res: $res + $h * (floor($x / $h) % 2) * (floor($y / $h) % 2)
+  }
+
+  @return $res
+}

data/stylesheets/SassyBitwise/operators/_not.scss

@@ -0,0 +1,10 @@
+// `not` bitwise operator
+// ~ $x
+// ---
+// @param [number] $x: value
+// ---
+// @return [number]
+// ---
+@function bw-not($x) {
+  @return ($x + sign($x)) * -1
+}

data/stylesheets/SassyBitwise/operators/_or.scss

@@ -0,0 +1,21 @@
+// `or` bitwise operator
+// $x | $y
+// ---
+// @param [number] $x: first value
+// @param [number] $y: second value
+// ---
+// @return [number]
+// ---
+@function bw-or($x, $y) {
+  $b: binary-length($x);
+  $res: 0;
+
+  @for $i from 0 through $b {
+    $h: power(2, $i);
+    $tx: floor($x / $h) % 2;
+    $ty: floor($y / $h) % 2;
+    $res: $res + $h * (($tx + $ty + $tx * $ty % 2) % 2)
+  }
+
+  @return $res
+}

data/stylesheets/SassyBitwise/operators/_shift-left.scss

@@ -0,0 +1,11 @@
+// `<<` bitwise operator
+// $x << $y
+// ---
+// @param [number] $x: first value
+// @param [number] $y: second value
+// ---
+// @return [number]
+// ---
+@function bw-shift-left($x, $y) {
+  @return $x * power(2, $y)
+}

data/stylesheets/SassyBitwise/operators/_shift-right.scss

@@ -0,0 +1,11 @@
+// `>>` bitwise operator
+// $x >> $y
+// ---
+// @param [number] $x: first value
+// @param [number] $y: second value
+// ---
+// @return [number]
+// ---
+@function bw-shift-right($x, $y) {
+  @return floor($x / power(2, $y))
+}

data/stylesheets/SassyBitwise/operators/_xor.scss

@@ -0,0 +1,19 @@
+// `xor` bitwise operator
+// $x ^ $y
+// ---
+// @param [number] $x: first value
+// @param [number] $y: second value
+// ---
+// @return [number]
+// ---
+@function bw-xor($x, $y) {
+  $b: binary-length($x);
+  $res: 0;
+
+  @for $i from 0 through $b {
+    $h: power(2, $i);
+    $res: $res + $h * (((floor($x / $h) % 2) + (floor($y / $h) % 2)) % 2)
+  }
+
+  @return $res
+}

data/stylesheets/SassyBitwise/validators/_arguments-validator.scss

@@ -0,0 +1,45 @@
+// Checks whether argument list is valid
+// ---
+// @param [list] $args: argument list
+// ---
+// @return [bool]
+// ---
+@function arguments-validator($args) {
+  $valid-operators: "^", "|", "&", "<<", ">>";
+
+  @if length($args) == 2 {
+    @if nth($args, 1) != "~" {
+      @warn "Only 2 arguments specified but first is not `~`.";
+      @return false;
+    }
+
+    @if not is-number(nth($args, 2)) {
+      @warn "Only 2 arguments specified but second is not a valid unitless number.";
+      @return false;
+    }
+  }
+
+  @else if length($args) == 3 {
+    @if not index($valid-operators, nth($args, 2)) {
+      @warn "Invalid operator: `#{nth($args, 2)}` given, one of #{inspect($valid-operators)} expected.";
+      @return false;
+    }
+
+    @if not is-number(nth($args, 1)) {
+      @warn "Invalid number as first argument: `#{nth($args, 1)} given, valid unitless number expected.";
+      @return false;
+    }
+
+    @if not is-number(nth($args, 3)) {
+      @warn "Invalid number as third argument: `#{nth($args, 3)} given, valid unitless number expected.";
+      @return false;
+    }
+  }
+
+  @else {
+    @warn "Invalid number of arguments: #{length($args)} given, 2 or 3 expected.";
+    @return false;
+  }
+
+  @return true;
+}

data/stylesheets/SassyBitwise/validators/_is-number.scss

@@ -0,0 +1,9 @@
+// Checks whether $value is valid number
+// ---
+// @param [number] $value
+// ---
+// @return [bool]
+// ---
+@function is-number($value) {
+  @return type-of($value) == "number" and unitless($value)
+}

data/stylesheets/_SassyBitwise.scss

@@ -0,0 +1,15 @@
+@import "SassyBitwise/helpers/power";
+@import "SassyBitwise/helpers/sign";
+@import "SassyBitwise/helpers/largest-power-of-2";
+@import "SassyBitwise/helpers/binary-to-decimal";
+@import "SassyBitwise/helpers/decimal-to-binary";
+@import "SassyBitwise/helpers/binary-length";
+@import "SassyBitwise/validators/is-number";
+@import "SassyBitwise/validators/arguments-validator";
+@import "SassyBitwise/operators/and";
+@import "SassyBitwise/operators/not";
+@import "SassyBitwise/operators/or";
+@import "SassyBitwise/operators/xor";
+@import "SassyBitwise/operators/shift-left";
+@import "SassyBitwise/operators/shift-right";
+@import "SassyBitwise/api/bitwise";

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification
+name: SassyBitwise
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Hugo Giraudel
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-06-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sass
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.3'
+- !ruby/object:Gem::Dependency
+  name: compass
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.12'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.12'
+description: Bitwise operators in Sass.
+email:
+- hugo.giraudel@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- lib/SassyBitwise.rb
+- stylesheets/SassyBitwise/api/_bitwise.scss
+- stylesheets/SassyBitwise/helpers/_binary-length.scss
+- stylesheets/SassyBitwise/helpers/_binary-to-decimal.scss
+- stylesheets/SassyBitwise/helpers/_decimal-to-binary.scss
+- stylesheets/SassyBitwise/helpers/_largest-power-of-2.scss
+- stylesheets/SassyBitwise/helpers/_power.scss
+- stylesheets/SassyBitwise/helpers/_sign.scss
+- stylesheets/SassyBitwise/operators/_and.scss
+- stylesheets/SassyBitwise/operators/_not.scss
+- stylesheets/SassyBitwise/operators/_or.scss
+- stylesheets/SassyBitwise/operators/_shift-left.scss
+- stylesheets/SassyBitwise/operators/_shift-right.scss
+- stylesheets/SassyBitwise/operators/_xor.scss
+- stylesheets/SassyBitwise/validators/_arguments-validator.scss
+- stylesheets/SassyBitwise/validators/_is-number.scss
+- stylesheets/_SassyBitwise.scss
+homepage: http://github.com/HugoGiraudel/SassyBitwise
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: SassyBitwise
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: An implementation of bitwise operators in Sass without the use of Ruby.
+test_files: []