Fix #163: Rename FilterableDataInterface::withFilterHandlers() to FilterableDataInterface::withAddedFilterHandlers()

CHANGELOG.md

@@ -27,6 +27,7 @@
 - New #176: Add `OrderHelper` (@vjik)
 - New #173, #184: Add `$caseSensitive` parameter to `Like` filter to control whether the search must be case-sensitive
   or not (@arogachev)
+- Chg #163: Rename `FilterableDataInterface::withFilterHandlers()` to `FilterableDataInterface::withAddedFilterHandlers()` (@samdark)
 
 ## 1.0.1 January 25, 2023
 

src/Reader/FilterableDataInterface.php

@@ -35,5 +35,5 @@ public function withFilter(FilterInterface $filter): static;
      * @return static New instance.
      * @psalm-return $this
      */
-    public function withFilterHandlers(FilterHandlerInterface ...$filterHandlers): static;
+    public function withAddedFilterHandlers(FilterHandlerInterface ...$filterHandlers): static;
 }

src/Reader/Iterable/IterableDataReader.php

@@ -84,7 +84,7 @@ public function __construct(private iterable $data)
     /**
      * @psalm-return $this
      */
-    public function withFilterHandlers(FilterHandlerInterface ...$filterHandlers): static
+    public function withAddedFilterHandlers(FilterHandlerInterface ...$filterHandlers): static
     {
         $new = clone $this;
         $new->iterableFilterHandlers = array_merge(

tests/Paginator/KeysetPaginatorTest.php

@@ -116,7 +116,7 @@ public function withFilter(FilterInterface $filter): static
                 return clone $this;
             }
 
-            public function withFilterHandlers(FilterHandlerInterface ...$filterHandlers): static
+            public function withAddedFilterHandlers(FilterHandlerInterface ...$filterHandlers): static
             {
                 return clone $this;
             }
@@ -603,7 +603,7 @@ public function withFilter(FilterInterface $filter): static
                 return clone $this;
             }
 
-            public function withFilterHandlers(FilterHandlerInterface ...$filterHandlers): static
+            public function withAddedFilterHandlers(FilterHandlerInterface ...$filterHandlers): static
             {
                 return clone $this;
             }

tests/Reader/Iterable/IterableDataReaderTest.php

@@ -67,7 +67,7 @@ public function testImmutability(): void
     {
         $reader = new IterableDataReader([]);
 
-        $this->assertNotSame($reader, $reader->withFilterHandlers());
+        $this->assertNotSame($reader, $reader->withAddedFilterHandlers());
         $this->assertNotSame($reader, $reader->withFilter(null));
         $this->assertNotSame($reader, $reader->withSort(null));
         $this->assertNotSame($reader, $reader->withOffset(1));
@@ -91,7 +91,7 @@ public function getFilterClass(): string
         );
         $this->expectExceptionMessage($message);
 
-        (new IterableDataReader([]))->withFilterHandlers($nonIterableFilterHandler);
+        (new IterableDataReader([]))->withAddedFilterHandlers($nonIterableFilterHandler);
     }
 
     public function testWithLimitFailForNegativeValues(): void
@@ -383,7 +383,7 @@ public function testGeneratorAsDataSet(): void
     public function testCustomFilter(): void
     {
         $reader = (new IterableDataReader(self::DEFAULT_DATASET))
-            ->withFilterHandlers(new DigitalHandler())
+            ->withAddedFilterHandlers(new DigitalHandler())
             ->withFilter(
                 new All(new GreaterThan('id', 0), new Digital('name'))
             );
@@ -398,7 +398,7 @@ public function testCustomEqualsProcessor(): void
 
         $dataReader = (new IterableDataReader(self::DEFAULT_DATASET))
             ->withSort($sort)
-            ->withFilterHandlers(
+            ->withAddedFilterHandlers(
                 new class () implements IterableFilterHandlerInterface {
                     public function getFilterClass(): string
                     {

tests/Support/MutationDataReader.php

@@ -33,10 +33,10 @@ public function withFilter(FilterInterface $filter): static
         return $new;
     }
 
-    public function withFilterHandlers(FilterHandlerInterface ...$filterHandlers): static
+    public function withAddedFilterHandlers(FilterHandlerInterface ...$filterHandlers): static
     {
         $new = clone $this;
-        $new->decorated = $this->decorated->withFilterHandlers(...$filterHandlers);
+        $new->decorated = $this->decorated->withAddedFilterHandlers(...$filterHandlers);
         return $new;
     }