Allow to remove comments and flags

Author: oscarotero

CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 
 Previous releases are documented in [github releases](https://github.com/oscarotero/Gettext/releases)
 
+## [5.3.0] - 2020-02-18
+### Added
+- `Comments::delete()` and `Flags::delete()` methods [#247]
+
 ## [5.2.2] - 2020-02-09
 ### Fixed
 - MoLoader with plurals [#246]
@@ -51,7 +55,9 @@ Previous releases are documented in [github releases](https://github.com/oscarot
 
 [#244]: https://github.com/php-gettext/Gettext/issues/244
 [#246]: https://github.com/php-gettext/Gettext/issues/246
+[#247]: https://github.com/php-gettext/Gettext/issues/247
 
+[5.3.0]: https://github.com/php-gettext/Gettext/compare/v5.2.2...v5.3.0
 [5.2.2]: https://github.com/php-gettext/Gettext/compare/v5.2.1...v5.2.2
 [5.2.1]: https://github.com/php-gettext/Gettext/compare/v5.2.0...v5.2.1
 [5.2.0]: https://github.com/php-gettext/Gettext/compare/v5.1.0...v5.2.0

src/Comments.php

@@ -43,6 +43,19 @@ public function add(string ...$comments): self
         return $this;
     }
 
+    public function delete(string ...$comments): self
+    {
+        foreach ($comments as $comment) {
+            $key = array_search($comment, $this->comments);
+
+            if ($key !== false) {
+                array_splice($this->comments, $key, 1);
+            }
+        }
+
+        return $this;
+    }
+
     public function jsonSerialize()
     {
         return $this->toArray();

src/Flags.php

@@ -45,6 +45,19 @@ public function add(string ...$flags): self
         return $this;
     }
 
+    public function delete(string ...$flags): self
+    {
+        foreach ($flags as $flag) {
+            $key = array_search($flag, $this->flags);
+
+            if ($key !== false) {
+                array_splice($this->flags, $key, 1);
+            }
+        }
+
+        return $this;
+    }
+
     public function has(string $flag): bool
     {
         return in_array($flag, $this->flags, true);

tests/CommentsTest.php

@@ -29,6 +29,11 @@ public function testComments()
 
         $this->assertSame(['foo', 'bar'], $comments->toArray());
         $this->assertCount(2, $comments);
+
+        $comments->delete('foo');
+
+        $this->assertSame(['bar'], $comments->toArray());
+        $this->assertCount(1, $comments);
     }
 
     public function testMergeComments()

tests/FlagsTest.php

@@ -34,6 +34,11 @@ public function testFlags()
 
         $this->assertSame(['bar', 'foo', 'one', 'three', 'two'], $flags->toArray());
         $this->assertCount(5, $flags);
+
+        $flags->delete('bar', 'one', 'two');
+
+        $this->assertSame(['foo', 'three'], $flags->toArray());
+        $this->assertCount(2, $flags);
     }
 
     public function testMergeFlags()