Added add and remove methods to Permissions class

Author: freost

CHANGELOG.md

@@ -9,6 +9,9 @@
 * Now possible to define custom input/output value objects for the query builder.
 * Added a `EventStream` response sender to simplify sending [sever-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events).
 * Permission calculations now fully support special bits (sticky, setgid and setuid).
+* Added the following methods to the `Permissions` class:
+ - `add`
+ - `remove`
 
 #### Deprecations
 

src/mako/file/Permissions.php

@@ -73,6 +73,32 @@ public static function fromInt(int $permissions): static
 		return new static(...$permission);
 	}
 
+	/**
+	 * Add permission.
+	 *
+	 * @return $this
+	 */
+	public function add(Permission ...$permissions): static
+	{
+		$this->permissions = [...$this->permissions, ...$permissions];
+
+		return $this;
+	}
+
+	/**
+	 * Remove permission.
+	 *
+	 * @return $this
+	 */
+	public function remove(Permission ...$permissions): static
+	{
+		foreach ($permissions as $permission) {
+			$this->permissions = array_filter($this->permissions, fn ($value) => $value !== $permission);
+		}
+
+		return $this;
+	}
+
 	/**
 	 * Returns the permissions.
 	 *

tests/unit/file/PermissionsTest.php

@@ -358,4 +358,72 @@ public function testToRwxString(): void
 
 		$this->assertSame('r-Sr-Sr-T', $permissions->toRwxString());
 	}
+
+	/**
+	 *
+	 */
+	public function testAdd(): void
+	{
+		$permissions = new Permissions;
+
+		$this->assertSame(0o0000, $permissions->toInt());
+
+		//
+
+		$this->assertInstanceOf(Permissions::class, $permissions->add(Permission::OWNER_FULL));
+
+		$this->assertSame(0o0700, $permissions->toInt());
+
+		//
+
+		$permissions->add(Permission::OWNER_FULL);
+
+		$this->assertSame(0o0700, $permissions->toInt());
+
+		//
+
+		$permissions->add(Permission::GROUP_FULL);
+
+		$this->assertSame(0o0770, $permissions->toInt());
+
+		//
+
+		$permissions->add(Permission::PUBLIC_READ, Permission::PUBLIC_WRITE, Permission::PUBLIC_EXECUTE);
+
+		$this->assertSame(0o0777, $permissions->toInt());
+	}
+
+	/**
+	 *
+	 */
+	public function testRemove(): void
+	{
+		$permissions = Permissions::fromInt(0o777);
+
+		$this->assertSame(0o0777, $permissions->toInt());
+
+		//
+
+		$this->assertInstanceOf(Permissions::class, $permissions->remove(Permission::PUBLIC_WRITE));
+
+		$this->assertSame(0o0775, $permissions->toInt());
+
+		//
+
+		$permissions->remove(Permission::PUBLIC_WRITE);
+
+		$this->assertSame(0o0775, $permissions->toInt());
+
+		//
+
+		$permissions->remove(Permission::GROUP_WRITE);
+
+		$this->assertSame(0o0755, $permissions->toInt());
+
+		//
+
+		$permissions->remove(Permission::PUBLIC_EXECUTE, Permission::GROUP_EXECUTE);
+
+		$this->assertSame(0o0744, $permissions->toInt());
+	}
 }