pygpt-net 2.7.0__tar.gz → 2.7.2__tar.gz

{pygpt_net-2.7.0 → pygpt_net-2.7.2}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # CHANGELOG
 
+## 2.7.2 (2025-12-29)
+
+- Fixed: non-searchable combobox width.
+- Improved updater.
+- Added .AppImage build.
+
+## 2.7.1 (2025-12-28)
+
+- Improved UI elements.
+- Optimized Painter rendering and redraw functions.
+- Added Pack/Unpack feature to File Explorer.
+- Fixed: image restoration in Painter.
+- Fixed: tab title updating upon context deletion.
+
 ## 2.7.0 (2025-12-28)
 
 - Added multi-select functionality using CTRL or SHIFT and batch actions to the context list, preset list, attachments list, and other list-based widgets.

{pygpt_net-2.7.0 → pygpt_net-2.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pygpt-net
-Version: 2.7.0
+Version: 2.7.2
 Summary: Desktop AI Assistant powered by: OpenAI GPT-5, GPT-4, o1, o3, Gemini, Claude, Grok, DeepSeek, and other models supported by Llama Index, and Ollama. Chatbot, agents, completion, image generation, vision analysis, speech-to-text, plugins, MCP, internet access, file handling, command execution and more.
 License: MIT
 Keywords: ai,api,api key,app,assistant,bielik,chat,chatbot,chatgpt,claude,dall-e,deepseek,desktop,gemini,gpt,gpt-3.5,gpt-4,gpt-4-vision,gpt-4o,gpt-5,gpt-oss,gpt3.5,gpt4,grok,langchain,llama-index,llama3,mistral,o1,o3,ollama,openai,presets,py-gpt,py_gpt,pygpt,pyside,qt,text completion,tts,ui,vision,whisper
@@ -119,7 +119,7 @@ Description-Content-Type: text/markdown
 
 [![pygpt](https://snapcraft.io/pygpt/badge.svg)](https://snapcraft.io/pygpt)
 
-Release: **2.7.0** | build: **2025-12-28** | Python: **>=3.10, <3.14**
+Release: **2.7.2** | build: **2025-12-29** | Python: **>=3.10, <3.14**
 
 > Official website: https://pygpt.net | Documentation: https://pygpt.readthedocs.io
 > 
@@ -216,7 +216,33 @@ You can download compiled binary versions for `Linux` and `Windows` (10/11).
 
 Linux version requires `GLIBC` >= `2.35`.
 
-## Snap Store
+## Microsoft Store (Windows)
+
+For Windows 10/11, you can install **PyGPT** directly from Microsoft Store:
+
+[![Get it from Microsoft Store](https://get.microsoft.com/images/en-us%20dark.svg)](https://apps.microsoft.com/detail/XP99R4MX3X65VQ)
+
+Link to MS Store: https://apps.microsoft.com/detail/XP99R4MX3X65VQ
+
+## AppImage (Linux)
+
+You can download the latest **PyGPT** `AppImage` for Linux from the release page:
+
+**Releases:** https://github.com/szczyglis-dev/py-gpt/releases
+
+**Tip:** Remember to give execution permissions to the downloaded file:
+
+```chmod +x ./PyGPT-X.X.X-x86_64.AppImage```
+
+To manage future updates you can use `AppImageUpdate` tool:
+
+You can download it from: https://github.com/AppImage/AppImageUpdate/releases
+
+After downloading, run the following command in terminal:
+
+```appimageupdatetool ./PyGPT-X.X.X-x86_64.AppImage```
+
+## Snap Store (Linux)
 
 You can install **PyGPT** directly from Snap Store:
 
@@ -224,7 +250,7 @@ You can install **PyGPT** directly from Snap Store:
 sudo snap install pygpt
 ```
 
-To manage future updates just use:
+To manage future updates use:
 
 ```commandline
 sudo snap refresh pygpt
@@ -3753,6 +3779,20 @@ may consume additional tokens that are not displayed in the main window.
 
 ## Recent changes:
 
+**2.7.2 (2025-12-29)**
+
+- Fixed: non-searchable combobox width.
+- Improved updater.
+- Added .AppImage build.
+
+**2.7.1 (2025-12-28)**
+
+- Improved UI elements.
+- Optimized Painter rendering and redraw functions.
+- Added Pack/Unpack feature to File Explorer.
+- Fixed: image restoration in Painter.
+- Fixed: tab title updating upon context deletion.
+
 **2.7.0 (2025-12-28)**
 
 - Added multi-select functionality using CTRL or SHIFT and batch actions to the context list, preset list, attachments list, and other list-based widgets.

{pygpt_net-2.7.0 → pygpt_net-2.7.2}/README.md

@@ -2,7 +2,7 @@
 
 [![pygpt](https://snapcraft.io/pygpt/badge.svg)](https://snapcraft.io/pygpt)
 
-Release: **2.7.0** | build: **2025-12-28** | Python: **>=3.10, <3.14**
+Release: **2.7.2** | build: **2025-12-29** | Python: **>=3.10, <3.14**
 
 > Official website: https://pygpt.net | Documentation: https://pygpt.readthedocs.io
 > 
@@ -99,7 +99,33 @@ You can download compiled binary versions for `Linux` and `Windows` (10/11).
 
 Linux version requires `GLIBC` >= `2.35`.
 
-## Snap Store
+## Microsoft Store (Windows)
+
+For Windows 10/11, you can install **PyGPT** directly from Microsoft Store:
+
+[![Get it from Microsoft Store](https://get.microsoft.com/images/en-us%20dark.svg)](https://apps.microsoft.com/detail/XP99R4MX3X65VQ)
+
+Link to MS Store: https://apps.microsoft.com/detail/XP99R4MX3X65VQ
+
+## AppImage (Linux)
+
+You can download the latest **PyGPT** `AppImage` for Linux from the release page:
+
+**Releases:** https://github.com/szczyglis-dev/py-gpt/releases
+
+**Tip:** Remember to give execution permissions to the downloaded file:
+
+```chmod +x ./PyGPT-X.X.X-x86_64.AppImage```
+
+To manage future updates you can use `AppImageUpdate` tool:
+
+You can download it from: https://github.com/AppImage/AppImageUpdate/releases
+
+After downloading, run the following command in terminal:
+
+```appimageupdatetool ./PyGPT-X.X.X-x86_64.AppImage```
+
+## Snap Store (Linux)
 
 You can install **PyGPT** directly from Snap Store:
 
@@ -107,7 +133,7 @@ You can install **PyGPT** directly from Snap Store:
 sudo snap install pygpt
 ```
 
-To manage future updates just use:
+To manage future updates use:
 
 ```commandline
 sudo snap refresh pygpt
@@ -3636,6 +3662,20 @@ may consume additional tokens that are not displayed in the main window.
 
 ## Recent changes:
 
+**2.7.2 (2025-12-29)**
+
+- Fixed: non-searchable combobox width.
+- Improved updater.
+- Added .AppImage build.
+
+**2.7.1 (2025-12-28)**
+
+- Improved UI elements.
+- Optimized Painter rendering and redraw functions.
+- Added Pack/Unpack feature to File Explorer.
+- Fixed: image restoration in Painter.
+- Fixed: tab title updating upon context deletion.
+
 **2.7.0 (2025-12-28)**
 
 - Added multi-select functionality using CTRL or SHIFT and batch actions to the context list, preset list, attachments list, and other list-based widgets.

{pygpt_net-2.7.0 → pygpt_net-2.7.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "pygpt-net"
-version = "2.7.0"
+version = "2.7.2"
 description = "Desktop AI Assistant powered by: OpenAI GPT-5, GPT-4, o1, o3, Gemini, Claude, Grok, DeepSeek, and other models supported by Llama Index, and Ollama. Chatbot, agents, completion, image generation, vision analysis, speech-to-text, plugins, MCP, internet access, file handling, command execution and more."
 authors = ["Marcin Szczyglinski <info@pygpt.net>"]
 license = "MIT"

{pygpt_net-2.7.0 → pygpt_net-2.7.2}/src/pygpt_net/CHANGELOG.txt

@@ -1,3 +1,17 @@
+2.7.2 (2025-12-29)
+
+- Fixed: non-searchable combobox width.
+- Improved updater.
+- Added .AppImage build.
+
+2.7.1 (2025-12-28)
+
+- Improved UI elements.
+- Optimized Painter rendering and redraw functions.
+- Added Pack/Unpack feature to File Explorer.
+- Fixed: image restoration in Painter.
+- Fixed: tab title updating upon context deletion.
+
 2.7.0 (2025-12-28)
 
 - Added multi-select functionality using CTRL or SHIFT and batch actions to the context list, preset list, attachments list, and other list-based widgets.

{pygpt_net-2.7.0 → pygpt_net-2.7.2}/src/pygpt_net/__init__.py

@@ -6,15 +6,15 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2025.12.28 00:00:00                  #
+# Updated Date: 2025.12.29 00:00:00                  #
 # ================================================== #
 
 __author__ = "Marcin Szczygliński"
 __copyright__ = "Copyright 2025, Marcin Szczygliński"
 __credits__ = ["Marcin Szczygliński"]
 __license__ = "MIT"
-__version__ = "2.7.0"
-__build__ = "2025-12-28"
+__version__ = "2.7.2"
+__build__ = "2025-12-29"
 __maintainer__ = "Marcin Szczygliński"
 __github__ = "https://github.com/szczyglis-dev/py-gpt"
 __report__ = "https://github.com/szczyglis-dev/py-gpt/issues"

{pygpt_net-2.7.0 → pygpt_net-2.7.2}/src/pygpt_net/controller/ctx/ctx.py

@@ -622,6 +622,7 @@ class Ctx:
             )
             return
         updated = False
+        updated_current = False
         ids = id if isinstance(id, list) else [id]
         for id in ids:
             try:
@@ -633,6 +634,7 @@ class Ctx:
             if self.window.core.ctx.get_current() == id:
                 items = self.window.core.ctx.all()  # TODO: get by meta id(s)
                 self.window.core.history.remove_items(items)
+                updated_current = True
             self.window.core.attachments.context.delete_by_meta_id(id)
             self.window.core.ctx.remove(id)
             self.remove_selected(id)
@@ -645,7 +647,8 @@ class Ctx:
 
         if updated:
             self.update_and_restore()
-            self.window.controller.ui.tabs.update_title_current("...")
+            if updated_current:
+                self.window.controller.ui.tabs.update_title_current("...")
 
     def delete_meta_from_idx(self, id: int):
         """

{pygpt_net-2.7.0 → pygpt_net-2.7.2}/src/pygpt_net/controller/painter/common.py

@@ -47,7 +47,12 @@ class Common:
         :param width: Canvas width
         :param height: Canvas height
         """
-        self.window.ui.painter.setFixedSize(QSize(width, height))
+        painter = self.window.ui.painter
+        if hasattr(painter, "set_canvas_size_pixels"):
+            painter.set_canvas_size_pixels(width, height)
+        else:
+            # required on image open
+            self.window.ui.painter.setFixedSize(QSize(width, height))
 
     def set_brush_mode(self, enabled: bool):
         """
@@ -81,14 +86,21 @@ class Common:
         if self._changing_canvas_size:
             return
 
-        combo: QComboBox = self.window.ui.nodes['painter.select.canvas.size']
+        # Be resilient if combobox node is not present in a given UI layout
+        combo: Optional[QComboBox] = None
+        try:
+            if hasattr(self.window.ui, "nodes"):
+                combo = self.window.ui.nodes.get('painter.select.canvas.size', None)
+        except Exception:
+            combo = None
+
         painter = self.window.ui.painter
 
         # Heuristic to detect manual UI change vs programmatic call
         # - manual if: no arg, or int index (Qt int overload), or arg equals currentText/currentData
         raw_arg = selected
-        current_text = combo.currentText()
-        current_data = combo.currentData()
+        current_text = combo.currentText() if combo is not None else ""
+        current_data = combo.currentData() if combo is not None else None
         current_data_str = current_data if isinstance(current_data, str) else None
         is_manual = (
             raw_arg is None
@@ -105,8 +117,15 @@ class Common:
         if not selected_norm:
             return
 
+        # Use true logical canvas size when available
+        if hasattr(painter, "get_canvas_size"):
+            cur_sz = painter.get_canvas_size()
+            cur_val = f"{cur_sz.width()}x{cur_sz.height()}"
+        else:
+            cur_val = f"{painter.width()}x{painter.height()}"
+
         # Save undo only for manual changes and only if size will change
-        will_change = selected_norm != f"{painter.width()}x{painter.height()}"
+        will_change = selected_norm != cur_val
         if is_manual and will_change:
             painter.saveForUndo()
 
@@ -124,9 +143,10 @@ class Common:
                     self._sticky_custom_value = selected_norm
 
             # Ensure combo reflects single custom at index 0 (sticky respected), then select current value
-            self._sync_canvas_size_combo(combo, selected_norm, sticky_to_keep=self._sticky_custom_value)
+            if combo is not None:
+                self._sync_canvas_size_combo(combo, selected_norm, sticky_to_keep=self._sticky_custom_value)
 
-            # Apply canvas size; PainterWidget handles rescaling in resizeEvent
+            # Apply canvas size; PainterWidget handles rescaling in its own logic
             w, h = self.convert_to_size(selected_norm)
             self.set_canvas_size(w, h)
 
@@ -272,10 +292,22 @@ class Common:
         if self._changing_canvas_size:
             return
 
-        combo: QComboBox = self.window.ui.nodes['painter.select.canvas.size']
+        combo: Optional[QComboBox] = None
+        try:
+            if hasattr(self.window.ui, "nodes"):
+                combo = self.window.ui.nodes.get('painter.select.canvas.size', None)
+        except Exception:
+            combo = None
+
         painter = self.window.ui.painter
 
-        canvas_value = f"{painter.width()}x{painter.height()}"
+        # Use true logical canvas size, not widget size
+        if hasattr(painter, "get_canvas_size"):
+            sz = painter.get_canvas_size()
+            canvas_value = f"{sz.width()}x{sz.height()}"
+        else:
+            canvas_value = f"{painter.width()}x{painter.height()}"
+
         canvas_norm = self._normalize_canvas_value(canvas_value)
         if not canvas_norm:
             return
@@ -292,7 +324,8 @@ class Common:
         try:
             self._changing_canvas_size = True
             self._sticky_custom_value = sticky
-            self._sync_canvas_size_combo(combo, canvas_norm, sticky_to_keep=sticky)
+            if combo is not None:
+                self._sync_canvas_size_combo(combo, canvas_norm, sticky_to_keep=sticky)
 
             # Persist canvas size only (do not change sticky config-scope)
             self.window.core.config.set('painter.canvas.size', canvas_norm)
@@ -409,7 +442,6 @@ class Common:
                 combo.setCurrentText(value)
         else:
             # Current value is custom: ensure it exists at index 0 and select it
-            # If sticky differs or is None, overwrite/create the custom at index 0 to reflect true current value.
             if not sticky_to_keep or sticky_to_keep != value:
                 self._ensure_custom_index0(combo, value, predef)
             if combo.currentIndex() != 0:

{pygpt_net-2.7.0 → pygpt_net-2.7.2}/src/pygpt_net/core/filesystem/filesystem.py

@@ -480,3 +480,73 @@ class Filesystem:
         else:
             files = [os.path.join(path, f) for f in os.listdir(path) if os.path.isfile(os.path.join(path, f))]
         return files
+
+    # ===== Helpers for pack/unpack =====
+
+    def common_parent_dir(self, paths: List[str]) -> str:
+        """
+        Return a sensible common parent directory for the given paths.
+        For a single directory selection returns that directory; for a single file returns its parent.
+        For multiple selections returns a common existing parent, if resolvable, otherwise the parent of the first path.
+        """
+        if not paths:
+            return self.window.core.config.get_user_path()
+        norm = []
+        for p in paths:
+            p = os.path.abspath(p)
+            norm.append(p if os.path.isdir(p) else os.path.dirname(p))
+        if len(norm) == 1:
+            return norm[0]
+        try:
+            cp = os.path.commonpath(norm)
+            if os.path.isdir(cp):
+                return cp
+            return os.path.dirname(cp)
+        except Exception:
+            return norm[0]
+
+    def unique_path(self, directory: str, base_name: str, ext: str) -> str:
+        """
+        Return a unique file path within 'directory' for 'base_name' and 'ext' (ext should include dot or be empty).
+        Uses 'name', 'name (1)', 'name (2)', ... scheme.
+        """
+        os.makedirs(directory, exist_ok=True)
+        candidate = os.path.join(directory, f"{base_name}{ext}")
+        if not os.path.exists(candidate):
+            return candidate
+        i = 1
+        while True:
+            cand = os.path.join(directory, f"{base_name} ({i}){ext}")
+            if not os.path.exists(cand):
+                return cand
+            i += 1
+
+    def unique_dir(self, directory: str, base_name: str) -> str:
+        """
+        Return a unique directory path 'directory/base_name', adding ' (n)' suffix when needed.
+        """
+        os.makedirs(directory, exist_ok=True)
+        candidate = os.path.join(directory, base_name)
+        if not os.path.exists(candidate):
+            return candidate
+        i = 1
+        while True:
+            cand = os.path.join(directory, f"{base_name} ({i})")
+            if not os.path.exists(cand):
+                return cand
+            i += 1
+
+    def strip_archive_name(self, filename: str) -> str:
+        """
+        Strip known archive extensions (.zip, .tar, .tar.gz, .tar.bz2, .tar.xz, .tgz, .tbz2, .txz) from a filename.
+        Returns filename without extension(s).
+        """
+        combos = ['.tar.gz', '.tar.bz2', '.tar.xz', '.tgz', '.tbz2', '.txz']
+        lower = filename.lower()
+        for suf in combos:
+            if lower.endswith(suf):
+                return filename[:-len(suf)]
+        root, ext = os.path.splitext(filename)
+        if ext.lower() in ('.zip', '.tar'):
+            return root
+        return root

pygpt_net-2.7.2/src/pygpt_net/core/filesystem/packer.py

@@ -0,0 +1,247 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# ================================================== #
+# This file is a part of PYGPT package               #
+# Website: https://pygpt.net                         #
+# GitHub:  https://github.com/szczyglis-dev/py-gpt   #
+# MIT License                                        #
+# Created By  : Marcin Szczygliński                  #
+# Updated Date: 2024.11.23 21:00:00                  #
+# ================================================== #
+
+import os
+import shutil
+
+from uuid import uuid4
+
+class Packer:
+    def __init__(self, window=None):
+        """
+        Archive packer/unpacker
+
+        :param window: Window instance
+        """
+        self.window = window
+        self.zip_ext = [".zip"]
+        self.tar_ext = [".tar", ".gz", ".bz2"]
+
+    def is_archive(self, path: str) -> bool:
+        """
+        Check if path is archive
+
+        :param path: Path to file
+        :return: True if archive
+        """
+        ext = os.path.splitext(path)[1]
+        return ext in self.zip_ext or ext in self.tar_ext
+
+    def unpack(self, path: str) -> str:
+        """
+        Unpack archive
+
+        :param path: path to archive
+        :return: path to unpacked directory
+        """
+        uuid = str(uuid4())
+        tmp_dir = os.path.join(self.window.core.config.get_user_dir("tmp"), uuid)
+        os.makedirs(tmp_dir, exist_ok=True)
+        ext = os.path.splitext(path)[1]
+        if ext in self.zip_ext:
+            return self.unpack_zip(path, tmp_dir)
+        elif ext in self.tar_ext:
+            return self.unpack_tar(path, tmp_dir)
+
+    def unpack_zip(self, path: str, dir: str) -> str:
+        """
+        Unpack archive to temporary directory
+
+        :param path: path to archive
+        :param dir: temporary directory
+        :return: path to unpacked directory
+        """
+        import zipfile
+        with zipfile.ZipFile(path, 'r') as zip_ref:
+            zip_ref.extractall(dir)
+        return dir
+
+    def unpack_tar(self, path: str, dir: str) -> str:
+        """
+        Unpack archive to temporary directory
+
+        :param path: path to archive
+        :param dir: temporary directory
+        :return: path to unpacked directory
+        """
+        import tarfile
+        with tarfile.open(path, 'r') as tar_ref:
+            tar_ref.extractall(dir)
+        return dir
+
+    def remove_tmp(self, path: str):
+        """
+        Remove temporary directory
+
+        :param path: path to directory
+        """
+        if os.path.exists(path) and os.path.isdir(path):
+            shutil.rmtree(path)
+
+    # ===== New high-level pack/unpack API (non-breaking) =====
+
+    def can_unpack(self, path: str) -> bool:
+        """
+        Check using stdlib detectors whether given file is a supported archive.
+        """
+        if not (path and os.path.isfile(path)):
+            return False
+        try:
+            import zipfile, tarfile
+            return zipfile.is_zipfile(path) or tarfile.is_tarfile(path)
+        except Exception:
+            return False
+
+    def _detect_kind(self, path: str) -> str:
+        """
+        Detect archive kind: 'zip' or 'tar'. Returns '' if unknown.
+        """
+        try:
+            import zipfile, tarfile
+            if zipfile.is_zipfile(path):
+                return 'zip'
+            if tarfile.is_tarfile(path):
+                return 'tar'
+        except Exception:
+            pass
+        return ''
+
+    def pack_paths(self, paths: list, fmt: str, dest_dir: str = None, base_name: str = None) -> str:
+        """
+        Pack given paths into a single archive.
+
+        :param paths: list of files/dirs to include
+        :param fmt: 'zip' or 'tar.gz'
+        :param dest_dir: output directory (default: common parent of paths)
+        :param base_name: output archive base name without extension (optional)
+        :return: created archive path or empty string on error
+        """
+        if not paths:
+            return ""
+        fs = self.window.core.filesystem
+        paths = [os.path.abspath(p) for p in paths if p]
+        dest_dir = dest_dir or fs.common_parent_dir(paths)
+
+        if base_name is None:
+            if len(paths) == 1:
+                name = os.path.basename(paths[0].rstrip(os.sep))
+                if os.path.isfile(paths[0]):
+                    root, _ = os.path.splitext(name)
+                    base_name = root or name
+                else:
+                    base_name = name
+            else:
+                base_name = "archive"
+
+        fmt = (fmt or "").lower()
+        if fmt == 'zip':
+            ext = ".zip"
+            out_path = fs.unique_path(dest_dir, base_name, ext)
+            try:
+                self._pack_zip(paths, out_path)
+                return out_path
+            except Exception as e:
+                try:
+                    self.window.core.debug.log(e)
+                except Exception:
+                    pass
+                return ""
+        elif fmt in ('tar.gz', 'tgz'):
+            ext = ".tar.gz"
+            out_path = fs.unique_path(dest_dir, base_name, ext)
+            try:
+                self._pack_tar_gz(paths, out_path)
+                return out_path
+            except Exception as e:
+                try:
+                    self.window.core.debug.log(e)
+                except Exception:
+                    pass
+                return ""
+        else:
+            return ""
+
+    def _pack_zip(self, paths: list, out_path: str):
+        """
+        Create ZIP archive with selected paths, preserving top-level names.
+        """
+        import zipfile
+        with zipfile.ZipFile(out_path, 'w', compression=zipfile.ZIP_DEFLATED) as zf:
+            for src in paths:
+                top = os.path.basename(src.rstrip(os.sep))
+                if os.path.isdir(src):
+                    for root, dirs, files in os.walk(src):
+                        rel = os.path.relpath(root, src)
+                        arc_root = top if rel == "." else os.path.join(top, rel)
+                        # Add empty directories explicitly
+                        if not files and not dirs:
+                            zinfo = zipfile.ZipInfo(arc_root + "/")
+                            zf.writestr(zinfo, "")
+                        for f in files:
+                            absf = os.path.join(root, f)
+                            arcf = os.path.join(arc_root, f)
+                            zf.write(absf, arcf)
+                else:
+                    zf.write(src, top)
+
+    def _pack_tar_gz(self, paths: list, out_path: str):
+        """
+        Create TAR.GZ archive with selected paths, preserving top-level names.
+        """
+        import tarfile
+        with tarfile.open(out_path, 'w:gz') as tf:
+            for src in paths:
+                top = os.path.basename(src.rstrip(os.sep))
+                tf.add(src, arcname=top, recursive=True)
+
+    def unpack_to_dir(self, path: str, dest_dir: str) -> str:
+        """
+        Unpack archive at 'path' into 'dest_dir'.
+
+        :param path: archive file path
+        :param dest_dir: destination directory to extract into
+        :return: dest_dir on success, empty string otherwise
+        """
+        if not self.can_unpack(path):
+            return ""
+        try:
+            import zipfile, tarfile
+            os.makedirs(dest_dir, exist_ok=True)
+            kind = self._detect_kind(path)
+            if kind == 'zip':
+                with zipfile.ZipFile(path, 'r') as zf:
+                    zf.extractall(dest_dir)
+            elif kind == 'tar':
+                with tarfile.open(path, 'r:*') as tf:
+                    tf.extractall(dest_dir)
+            else:
+                return ""
+            return dest_dir
+        except Exception as e:
+            try:
+                self.window.core.debug.log(e)
+            except Exception:
+                pass
+            return ""
+
+    def unpack_to_sibling_dir(self, path: str) -> str:
+        """
+        Unpack archive into directory placed next to the archive, named after archive base name.
+
+        :param path: archive file path
+        :return: created directory path or empty string
+        """
+        if not (path and os.path.isfile(path)):
+            return ""
+        parent = os.path.dirname(path)
+        base = self.window.core.filesystem.strip_archive_name(os.path.basename(path))
+        out_dir = self.window.core.filesystem.unique_dir(parent, base)
+        return self.unpack_to_dir(path, out_dir)