feat(pureref): add support for creating and deleting PureRef files

Author: SPluzh

main.py

@@ -2195,8 +2195,19 @@ def show_context_menu(self, pos):
             stats_action.triggered.connect(lambda: self.show_folder_stats(item))
 
             menu.addSeparator()
-            pureref_action = menu.addAction(tr("context_menu.open_pureref"))
-            pureref_action.triggered.connect(lambda: self.open_pureref(item))
+
+            folder_path = item.data(0, Qt.ItemDataRole.UserRole)
+            folder_root = item.data(0, Qt.ItemDataRole.UserRole + 3)
+            if folder_path and folder_root:
+                folder_full = Path(folder_root) / folder_path
+                has_pur = self.pureref_manager.has_pur_file(folder_full)
+                pureref_text = tr("context_menu.open_pureref") if has_pur else tr("context_menu.create_pureref")
+                pureref_action = menu.addAction(pureref_text)
+                pureref_action.triggered.connect(lambda: self.open_pureref(item))
+
+                delete_pureref_action = menu.addAction(tr("context_menu.delete_pureref"))
+                delete_pureref_action.setEnabled(has_pur)
+                delete_pureref_action.triggered.connect(lambda: self.delete_pureref(item))
 
             menu.addSeparator()
 
@@ -2723,6 +2734,42 @@ def open_pureref(self, item):
                 msg = tr("pureref.launch_error", error=err_detail)
             QMessageBox.warning(self, tr("error.title"), msg)
 
+    def delete_pureref(self, item):
+        """Delete PureRef file for the folder."""
+        path = item.data(0, Qt.ItemDataRole.UserRole)
+        root_path = item.data(0, Qt.ItemDataRole.UserRole + 3)
+
+        if not path or not root_path:
+            return
+
+        folder = Path(root_path) / path
+        
+        if not self.pureref_manager.has_pur_file(folder):
+            return
+
+        file_size = self.pureref_manager.get_file_size(folder)
+        
+        if file_size > 0:
+            reply = QMessageBox.question(
+                self,
+                tr("dialog.confirm"),
+                tr("pureref.confirm_delete_nonempty"),
+                QMessageBox.StandardButton.Yes | QMessageBox.StandardButton.No,
+                QMessageBox.StandardButton.No
+            )
+            if reply != QMessageBox.StandardButton.Yes:
+                return
+
+        success, error = self.pureref_manager.delete(folder)
+        if success:
+            self.info_label.setText(tr("pureref.delete_success"))
+            QTimer.singleShot(3000, lambda: self.info_label.clear())
+        else:
+            msg = tr("pureref.delete_error", error=error.split(":", 1)[1] if ":" in error else error)
+            QMessageBox.warning(self, tr("error.title"), msg)
+
+        self.load_courses()
+
     def open_video_directory(self, item):
         file_path = item.data(0, Qt.ItemDataRole.UserRole)
         if file_path and Path(file_path).exists():

pureref_manager.py

@@ -27,6 +27,54 @@ def has_pur_file(self, folder: Path) -> bool:
         filename = self.config.get_pureref_filename()
         return (folder / filename).exists()
 
+    def get_file_size(self, folder: Path) -> int:
+        """Get the size of the .pur file in bytes.
+        
+        Returns:
+            File size in bytes, or 0 if file doesn't exist.
+        """
+        filename = self.config.get_pureref_filename()
+        pur_file = folder / filename
+        if pur_file.exists():
+            try:
+                return pur_file.stat().st_size
+            except Exception as e:
+                logging.error(f"Error getting PureRef file size: {e}")
+                return 0
+        return 0
+
+    def delete(self, folder: Path) -> tuple[bool, str]:
+        """Delete the .pur file for the given folder.
+        
+        Returns:
+            (success, error_message) — success=True if ok,
+            otherwise error_message contains the reason.
+        """
+        filename = self.config.get_pureref_filename()
+        pur_file = folder / filename
+
+        if not pur_file.exists():
+            return False, "file_not_found"
+
+        # Clean up running process if any
+        key = folder.resolve()
+        proc = self._processes.pop(key, None)
+        if proc is not None and proc.poll() is None:
+            try:
+                proc.terminate()
+                proc.wait(timeout=3)
+            except Exception as e:
+                logging.warning(f"Error terminating PureRef process: {e}")
+
+        # Delete the file
+        try:
+            pur_file.unlink()
+            logging.info(f"Deleted PureRef file: {pur_file}")
+            return True, ""
+        except Exception as e:
+            logging.error(f"Error deleting PureRef file: {e}")
+            return False, f"delete_error:{e}"
+
     def is_running(self, folder: Path) -> bool:
         """Check if PureRef is currently running for this folder."""
         key = folder.resolve()

resources/translations/en.json

@@ -403,11 +403,16 @@
         "edit_tags": "Edit Tags...",
         "tags": "Tags",
         "folder_stats": "Course Statistics",
-        "open_pureref": "Open PureRef"
+        "open_pureref": "Open PureRef",
+        "create_pureref": "Create PureRef",
+        "delete_pureref": "Delete PureRef"
     },
     "pureref": {
         "exe_not_found": "PureRef not found at: {path}",
-        "launch_error": "Failed to launch PureRef: {error}"
+        "launch_error": "Failed to launch PureRef: {error}",
+        "confirm_delete_nonempty": "The PureRef file is not empty. Are you sure you want to delete it?",
+        "delete_success": "PureRef file deleted successfully",
+        "delete_error": "Failed to delete PureRef file: {error}"
     },
     "tags": {
         "title": "Manage Tags",

resources/translations/ru.json

@@ -403,11 +403,16 @@
         "edit_tags": "Редактировать теги...",
         "tags": "Теги",
         "folder_stats": "Статистика курса",
-        "open_pureref": "Открыть PureRef"
+        "open_pureref": "Открыть PureRef",
+        "create_pureref": "Создать PureRef",
+        "delete_pureref": "Удалить PureRef"
     },
     "pureref": {
         "exe_not_found": "PureRef не найден: {path}",
-        "launch_error": "Не удалось запустить PureRef: {error}"
+        "launch_error": "Не удалось запустить PureRef: {error}",
+        "confirm_delete_nonempty": "Файл PureRef не пустой. Вы уверены, что хотите его удалить?",
+        "delete_success": "Файл PureRef успешно удалён",
+        "delete_error": "Не удалось удалить файл PureRef: {error}"
     },
     "tags": {
         "title": "Управление тегами",