Merge branch 'fix/archive_contains_empty_name_directory' into 'main'

fix: empty name directory in archive

Closes PACMAN-1195

See merge request espressif/idf-component-manager!559

Author: kumekay

idf_component_tools/archive_tools.py

@@ -114,6 +114,6 @@ def pack_archive(source_dir: t.Union[str, Path], archive_filepath: str) -> None:
     """Create tar+gzip archive"""
     try:
         with tarfile.open(archive_filepath, 'w:gz') as archive:
-            archive.add(source_dir, arcname='')
+            archive.add(source_dir, arcname='./')
     except tarfile.TarError:
         raise ArchiveError(f'{archive_filepath} is not a valid tar archive')

tests/test_archive_tools.py

@@ -1,8 +1,9 @@
-# SPDX-FileCopyrightText: 2022-2023 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 import os
 import shutil
+import tarfile
 import tempfile
 from filecmp import dircmp
 
@@ -12,6 +13,7 @@
     ArchiveError,
     get_format_from_path,
     is_known_format,
+    pack_archive,
     unpack_archive,
     unpack_tar,
     unpack_zip,
@@ -76,3 +78,19 @@ def test_unpack_archive(self, archive_path):
 
         finally:
             shutil.rmtree(tempdir)
+
+    def test_pack_archive_creates_valid_relative_tar(self, tmp_path):
+        source_dir = tmp_path / 'test_component'
+        source_dir.mkdir()
+        (source_dir / 'file.txt').touch()
+        archive_file = tmp_path / 'archive'
+        pack_archive(source_dir, archive_file)
+
+        assert archive_file.exists()
+
+        with tarfile.open(archive_file, 'r:gz') as tar:
+            names = tar.getnames()
+
+        # Verify: no absolute paths, files stored at top-level (relative './')
+        assert all(not n.startswith('/') for n in names)
+        assert './file.txt' in names