feat: Add rename method

README.md

@@ -643,6 +643,26 @@ Removes a compression flag.
 
 **Returns**: The current instance of the SevenZip class.
 
+### `rename(array $renameMap): string`
+
+Renames files in an archive.
+
+**Parameters**
+
+- `$renameMap`: An associative array where keys are old names and values are new names.
+
+**Returns**: the command output on success.
+
+**Throws**
+
+- `InvalidArgumentException`: If source path is not set.
+
+**Example**
+
+```php
+$sevenZip->rename(['old_name.txt' => 'new_name.txt']);
+```
+
 ### `reset(): SevenZip`
 
 Resets the property values to their original state.

src/SevenZip.php

@@ -1,3 +1,3 @@
 <?php
 
 namespace Verseles\SevenZip;
@@ -1086,6 +1086,42 @@
         return $this->parseFileInfoOutput($output);
     }
 
+    /**
+     * Renames files in an archive.
+     *
+     * @param array $renameMap An associative array where keys are old names and values are new names.
+     *
+     * @return string The output of the 7-Zip command.
+     * @throws \InvalidArgumentException If source path is not set.
+     */
+    public function rename(array $renameMap): string
+    {
+        if (!$this->getSourcePath()) {
+            throw new \InvalidArgumentException(
+                "Archive file path (source) must be set",
+            );
+        }
+
+        if ($this->getPassword()) {
+            $this->addFlag("p", $this->getPassword(), glued: true);
+        }
+
+        $command = [
+            $this->sevenZipPath,
+            "rn",
+            ...$this->flagrize($this->getAlwaysFlags()),
+            ...$this->flagrize($this->getCustomFlags()),
+            $this->getSourcePath(),
+        ];
+
+        foreach ($renameMap as $oldName => $newName) {
+            $command[] = $oldName;
+            $command[] = $newName;
+        }
+
+        return $this->runCommand($command);
+    }
+
     /**
      * Test the integrity of an archive.
      *

tests/SevenZipTest.php

@@ -260,6 +260,32 @@ public function testCompress(string $format): void
         $this->assertFileExists(filename: $archive);
     }
 
+    #[Covers('\Verseles\SevenZip\SevenZip::rename')]
+    #[DataProvider('compressAndExtractDataProvider')]
+    #[Depends('testCompress')]
+    public function testRename(string $format): void
+    {
+        $archive = $this->testDir . '/target/archive.' . $format;
+
+        // 7z doesn't support renaming in bzip2 format out of the box with `rn` command.
+        if (in_array($format, ['bzip2'])) {
+            $this->expectException(\RuntimeException::class);
+        }
+
+        $output = $this->sevenZip
+          ->source(path: $archive)
+          ->rename(['source/Avatart.svg' => 'source/Avatar_renamed.svg']);
+
+        if (!in_array($format, ['bzip2'])) {
+            $this->assertStringContainsString('Everything is Ok', $output);
+
+            // Revert back so extract test doesn't fail
+            $this->sevenZip
+              ->source(path: $archive)
+              ->rename(['source/Avatar_renamed.svg' => 'source/Avatart.svg']);
+        }
+    }
+
     #[Covers('\Verseles\SevenZip\SevenZip::verify')]
     #[DataProvider('compressAndExtractDataProvider')]
     #[Depends('testCompress')]