true 0.1.4 → 0.1.5

data/CHANGELOG.md

@@ -1,6 +1,10 @@
 True Changelog
 ==============
 
+0.1.5 (6/10/13)
+---------------
+- Append actual results to custom failure messages.
+
 0.1.4 (6/9/13)
 --------------
 - Null result is considered a failure.

data/README.md

@@ -1,11 +1,24 @@
 True
 ====
 
-A testing framework for compass/sass libraries.
+*Verb*
+
+1. To make true; shape, adjust, place, etc., exactly or accurately:
+  *True the wheels of a bicycle after striking a pothole.*
+2. To make even, symmetrical, level, etc. (often followed by *up*):
+  *True up the sides of a door.*
+3. A testing framework for Sass/Compass libraries:
+  *True your Sass before you deploy.*
 
 At this point
 True can only test values,
 not property/value output.
+I'd like that to change in the future,
+but it will require ruby code to achieve.
+In the meantime,
+you use True for logical unit tests,
+and use version-control for integration testing
+by comparing changes in output files.
 
 Install
 -------
@@ -36,12 +49,12 @@ in your scss:
 
     // Assert something, with a message to post if the assertion fails.
     @include assert-equal($test-1, 15,
-      'Simple multiplication failed.');
+      'Simple multiplication of `3*5` should return `15`.');
 
     // You can assert-equal, assert-unequal, assert-true, or assert-false.
     // A test can include as many assertions as you need.
     @include assert-true($test-2,
-      'Something returned false.');
+      '`something` should return `true` in the `if()` function.');
   }
 
 }

data/sass/true/_assert.scss

@@ -3,16 +3,20 @@
 
 @mixin assert-true(
   $assert,
-  $fail-message: '#{$assert} is not true.'
+  $fail-message: null
 ) {
+  $default-message: ' (#{$assert} is not true)';
+  $fail-message: $fail-message + $default-message;
   @if $assert { @include pass; }
   @else { @include fail($fail-message); }
 }
 
 @mixin assert-false(
   $assert,
-  $fail-message: '#{$assert} is not false.'
+  $fail-message: null
 ) {
+  $default-message: ' (#{$assert} is not false)';
+  $fail-message: $fail-message + $default-message;
   @if not $assert { @include pass; }
   @else { @include fail($fail-message); }
 }
@@ -20,8 +24,10 @@
 @mixin assert-equal(
   $assert,
   $expected,
-  $fail-message: '#{$assert} != #{$expected}'
+  $fail-message: null
 ) {
+  $default-message: ' (#{$assert} != #{$expected})';
+  $fail-message: $fail-message + $default-message;
   @if $assert == $expected { @include pass; }
   @else { @include fail($fail-message); }
 }
@@ -29,8 +35,10 @@
 @mixin assert-unequal(
   $assert,
   $expected,
-  $fail-message: '#{$assert} == #{$expected}'
+  $fail-message: null
 ) {
+  $default-message: ' (#{$assert} == #{$expected})';
+  $fail-message: $fail-message + $default-message;
   @if $assert != $expected { @include pass; }
   @else { @include fail($fail-message); }
 }

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: "true"
 version: !ruby/object:Gem::Version 
-  hash: 19
+  hash: 17
   prerelease: 
   segments: 
   - 0
   - 1
-  - 4
-  version: 0.1.4
+  - 5
+  version: 0.1.5
 platform: ruby
 authors: 
 - Eric Meyer
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2013-06-09 00:00:00 Z
+date: 2013-06-10 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: compass