enhanced documentation

Pazus · Pazus · commit b861d8251f68 · 2017-05-06T09:59:07.000+03:00
added not_to_be_true and not_to_be_false matchers
diff --git a/docs/userguide/expectations.md b/docs/userguide/expectations.md
@@ -7,6 +7,7 @@ Example of unit test procedure body with a single expectation.
 ```sql
 begin
   ut.expect( 'the tested value' ).to_equal('the expected value');
+  ut.expect( 'the tested value' ).to_( equal('the expected value') );
 end;
 ```
 
@@ -19,13 +20,12 @@ Pseudo-code:
   ut.expect( a_actual {data-type} ).not_to( {matcher} );
 ```
 
-Most of the matchers have shortcuts like:
+All matchers have shortcuts like:
 ```sql
   ut.expect( a_actual {data-type} ).to_{matcher};
   ut.expect( a_actual {data-type} ).not_to{matcher};
 ```
 
-
 # Matchers
 utPLSQL provides following matchers to perform checks on the expected and actual values.  
 - `be_between`
@@ -183,8 +183,6 @@ end;
 ```
 The `a_nulls_are_equal` parameter decides on the behavior of `null=null` comparison (**this comparison by default is true!**)
 
-There are no shortcuts for `not_to_equal`, so use `not_to (equal(...))`
-
 ### Comparing cursors
 
 The `equal` matcher accepts additional parameter `a_exclude varchar2` or `a_exclude ut_varchar2_list`, when used to compare `cursor` data. 
@@ -270,7 +268,7 @@ create or replace package body test_get_events is
     ut.reset_nls();
 
     ut.expect(l_actual).to_equal(l_expected);                        
-    ut.expect(l_actual).not_to( equal(l_expected_bad_date) );                        
+    ut.expect(l_actual).not_to_equal(l_expected_bad_date);
   end;
 
 end;
@@ -385,9 +383,9 @@ end;
 
 Syntax of check for matcher evaluating to false:
 ```sql
-begin 
-  ut.expect( a_actual {data-type} ).not_to( {matcher} );
+begin
   ut.expect( a_actual {data-type} ).not_to_{matcher};
+  ut.expect( a_actual {data-type} ).not_to( {matcher} );
 end;
 ```
 
diff --git a/source/expectations/ut_expectation_boolean.tpb b/source/expectations/ut_expectation_boolean.tpb
@@ -38,6 +38,18 @@ create or replace type body ut_expectation_boolean as
     ut_utils.debug_log('ut_expectation_boolean.not_to_equal(self in ut_expectation_boolean, a_expected boolean, a_nulls_are_equal boolean := null)');
     self.not_to( ut_equal(a_expected, a_nulls_are_equal) );
   end;
+  
+  member procedure not_to_be_true(self in ut_expectation_boolean) is
+  begin
+    ut_utils.debug_log('ut_expectation_boolean.not_to_be_true(self in ut_expectation_boolean)');
+    self.not_to( ut_be_true() );
+  end;
+
+  member procedure not_to_be_false(self in ut_expectation_boolean) is
+  begin
+    ut_utils.debug_log('ut_expectation_boolean.not_to_be_false(self in ut_expectation_boolean)');
+    self.not_to( ut_be_false() );
+  end;
 
 end;
 /
diff --git a/source/expectations/ut_expectation_boolean.tps b/source/expectations/ut_expectation_boolean.tps
@@ -19,6 +19,8 @@ create or replace type ut_expectation_boolean under ut_expectation(
   member procedure to_be_true(self in ut_expectation_boolean),
   member procedure to_be_false(self in ut_expectation_boolean),
   
-  overriding member procedure not_to_equal(self in ut_expectation_boolean, a_expected boolean, a_nulls_are_equal boolean := null)
+  overriding member procedure not_to_equal(self in ut_expectation_boolean, a_expected boolean, a_nulls_are_equal boolean := null),
+  member procedure not_to_be_true(self in ut_expectation_boolean),
+  member procedure not_to_be_false(self in ut_expectation_boolean)
 )
 /

Original file line number	Diff line number	Diff line change
`@@ -19,6 +19,8 @@ create or replace type ut_expectation_boolean under ut_expectation(`
`19`	`19`	`member procedure to_be_true(self in ut_expectation_boolean),`
`20`	`20`	`member procedure to_be_false(self in ut_expectation_boolean),`
`21`	`21`
`22`		`- overriding member procedure not_to_equal(self in ut_expectation_boolean, a_expected boolean, a_nulls_are_equal boolean := null)`
	`22`	`+ overriding member procedure not_to_equal(self in ut_expectation_boolean, a_expected boolean, a_nulls_are_equal boolean := null),`
	`23`	`+ member procedure not_to_be_true(self in ut_expectation_boolean),`
	`24`	`+ member procedure not_to_be_false(self in ut_expectation_boolean)`
`23`	`25`	`)`
`24`	`26`	`/`