deprecate bovigo\assert\predicate\Predicate::negate() in favor of bovigo\assert\predicate\not()

Author: mikey179

CHANGELOG.md

@@ -3,8 +3,9 @@
 
 ### BC breaks
 
-  * deprecated `bovigo\assert\predicate\Predicate::asWellAs()` in favor of the new `bovigo\assert\predicate\Predicate::and()` method, will be removed with 2.0.0
-  * deprecated `bovigo\assert\predicate\Predicate::orElse()` in favor of the new `bovigo\assert\predicate\Predicate::or()` method, will be removed with 2.0.0
+  * deprecated `bovigo\assert\predicate\Predicate::asWellAs()` in favor of `bovigo\assert\predicate\Predicate::and()`, will be removed with 2.0.0
+  * deprecated `bovigo\assert\predicate\Predicate::orElse()` in favor of `bovigo\assert\predicate\Predicate::or()`, will be removed with 2.0.0
+  * deprecated `bovigo\assert\predicate\Predicate::negate()` in favor of `bovigo\assert\predicate\not()`, will be removed with 2.0.0
 
 
 ### Other changes

src/main/php/predicate/Predicate.php

@@ -83,6 +83,7 @@ public function orElse($other)
      * returns a negated version of this predicate
      *
      * @return  \bovigo\assert\predicate\Predicate
+     * @deprecated  since 1.4.0, use not($predicate) instead, will be removed with 2.0.0
      */
     public function negate()
     {

src/test/php/predicate/PredicateTest.php

@@ -116,13 +116,24 @@ public function orReturnsOrPredicate()
 
     /**
      * @test
+     * @deprecated  since 1.4.0, will be removed with 2.0.0
      */
     public function negateReturnsNegatePredicate()
     {
         $predicate = new FooPredicate();
         assert($predicate->negate(), isInstanceOf(NegatePredicate::class));
     }
 
+    /**
+     * @test
+     * @since  1.4.0
+     */
+    public function everyPredicateCanBeNegated()
+    {
+        $isNotFoo = not(new FooPredicate());
+        assert('bar', $isNotFoo);
+    }
+
     /**
      * @test
      */
@@ -148,7 +159,7 @@ public function assertionFailureContainsMeaningfulInformation()
      */
     public function assertionFailureNegatedContainsMeaningfulInformation()
     {
-        assert('foo', (new FooPredicate())->negate());
+        assert('foo', not(new FooPredicate()));
     }
 
     /**