virtui-manager 1.1.5__py3-none-any.whl → 1.1.6__py3-none-any.whl

{virtui_manager-1.1.5.dist-info → virtui_manager-1.1.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: virtui-manager
-Version: 1.1.5
+Version: 1.1.6
 Summary: Terminal-based interface to manage virtual machines using libvirt
 Home-page: https://aginies.github.io/virtui-manager/
 Author: Antoine Ginies

{virtui_manager-1.1.5.dist-info → virtui_manager-1.1.6.dist-info}/RECORD

@@ -1,8 +1,8 @@
-virtui_manager-1.1.5.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+virtui_manager-1.1.6.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
 vmanager/__init__.py,sha256=-gTpOgkPAOtbLwxz-U9i2uVtFW1SB9JhBguViXnQPJ8,15
 vmanager/config.py,sha256=OBMWtXBTnmws1ITjQ7D_C0LVMxzvGaRH8nZOlW9cbqk,3102
 vmanager/connection_manager.py,sha256=osk0EHJ0ua2wnDOu-9faK8fMd7s9TGsI6OtgxLAMTCI,12984
-vmanager/constants.py,sha256=dtuqrTgud5YmkaVzW8JOvA7rkaSR-XeqovtbMf15lls,5907
+vmanager/constants.py,sha256=q7oX6P0XKLOKEh6JxY1Jduhl5Q5aMFKk8DfKii7BvyM,5907
 vmanager/dialog.css,sha256=iWGRlTZ-D-wc2uQQTftPoqDpysrAD6qMMENE3HXXlQg,11300
 vmanager/events.py,sha256=yvjcYHMoDnnDKsMjfweZYnu0-U7lxQlB2uuIbtK5FeY,1556
 vmanager/firmware_manager.py,sha256=i64S8uPKIj-Qe-xpQYAvelOLYZc0yO31ome9qMT8ObQ,3360
@@ -11,7 +11,7 @@ vmanager/libvirt_utils.py,sha256=fj74jXP2fHrn5VRWf8kwSlf57VyvWIVZ8gF0POyPUCA,160
 vmanager/network_manager.py,sha256=yMU3VXBCDDBKT2H7OL5s9XAD5uknfLPLH72e4228_Do,8627
 vmanager/remote_viewer.py,sha256=evFvp7ilKPuTf-YA4jCGMgO6dzdhbL1iea1lzETwWeU,89495
 vmanager/remote_viewer_gtk4.py,sha256=KIyejYq_PgmSL6yAUOnnloqpaIWdkYIPdoP6CmMaTOo,45994
-vmanager/storage_manager.py,sha256=Sb5xI-5yopF93NhoS8hIJiSIk81kfPShqV610LSFZ_w,41349
+vmanager/storage_manager.py,sha256=-Z-NqRklx9PjRhbipvHReSjTDkGqv5uO79vZRAZVv0g,42195
 vmanager/utils.py,sha256=V3jOjBVD9Hf29hC6xIRkfPkjqx-_VL7eozMomaMqW9U,17254
 vmanager/virtui_dev.py,sha256=M2pJEZRNApqezkj4RdEJR9neEdc_7HV3KInVGy9QgiQ,3118
 vmanager/vm_actions.py,sha256=HpK7O2TtpMj-RjBGfF2hdPElwh-aIXh3HbJwjbrEs3w,117279
@@ -36,11 +36,11 @@ vmanager/modals/config_modal.py,sha256=DMNGqjej-nAvN9t1OqK-uaR_r6d1m4Vi1X5eX7D3Z
 vmanager/modals/cpu_mem_pc_modals.py,sha256=puKOVeEqi36wzaXbKNyXjZQjCjXKntuIVTWKh5RsY38,9378
 vmanager/modals/custom_migration_modal.py,sha256=-kDRI8yeBJnh9jx5_ZJFWfXIfcmOZMO0dXUht3uowC8,2289
 vmanager/modals/disk_pool_modals.py,sha256=xme7vS52kkM4CBE3WduNfjqzJz5BAdVGxdD-HfMvw7o,28236
-vmanager/modals/howto_disk_modal.py,sha256=zvUb4dBFsObDdQK1J6bNczQ_sJfinvgUQiXOrGyczT4,3259
-vmanager/modals/howto_network_modal.py,sha256=kV4p5_fF1TudblOIJBJBGNb7SzX7rm54PR5TQwTUqs8,3940
-vmanager/modals/howto_overlay_modal.py,sha256=3L6-EaVVc5nv5sGIVazbYMTs67axaZXNu59IKaHwK0Q,3837
-vmanager/modals/howto_ssh_modal.py,sha256=F1E3c-aX2248CYjU5YmXlLJ1vSPQMxKwBuY50h5lTGw,2781
-vmanager/modals/howto_virtiofs_modal.py,sha256=9uNu3Ey6XglH1jCHDtGp2BQW5pi0Gk4NiZG8EtoAxSY,3392
+vmanager/modals/howto_disk_modal.py,sha256=yHMy4GFB39YXV4PVFyJe2y_1WgoeBCIlwr20gZEjF5c,1193
+vmanager/modals/howto_network_modal.py,sha256=arSiPHlq_wW7QLzwBkH_L5O-E7UmvwMXiuaEVlAGJdk,1215
+vmanager/modals/howto_overlay_modal.py,sha256=EJYrrW9nJsD0qSXBKabFbAEP_R1MOodsyDxEDW-ONbc,1228
+vmanager/modals/howto_ssh_modal.py,sha256=e0I-ntbk8-DZSl9t2T3eKW_EBcQvVqiwdqQKa9HIylM,1177
+vmanager/modals/howto_virtiofs_modal.py,sha256=GSnKjSBAutOXa16EToyuOWHycLRf94Qdlnq1XcJGHd0,1209
 vmanager/modals/input_modals.py,sha256=PEfM2IHc8QFR4BZf5uSuJz-7uiclRq6z65cZES_GJpk,7719
 vmanager/modals/log_modal.py,sha256=WXzha9mm5dO9jOmTSO52gJnOmgO7ZkBRrjS2_MiYMyQ,1095
 vmanager/modals/migration_modals.py,sha256=MkuGeDBe1v-BxP7BjrpGB8KxQh4x-SZHHKD1c9mV5wE,20422
@@ -49,7 +49,7 @@ vmanager/modals/provisioning_modals.py,sha256=Yx7zO8Zvo0qVpW9ctRZg0RmzIwik-tevXA
 vmanager/modals/select_server_modals.py,sha256=eAA9hmBjeK_2_AF7jRKyWcocj_LvmgP7ZFRp6H0NGi4,4994
 vmanager/modals/selection_modals.py,sha256=Pd8ZhQ-ezp2MUNT7SV0pdk2OpAYpI5YuuizaDJQTtek,6096
 vmanager/modals/server_modals.py,sha256=fQP8Sj7y7-i2UijS27yFvOywFAWiXdQcj27scYa2IoE,10191
-vmanager/modals/server_prefs_modals.py,sha256=-UNwWmBW6wbksd_Iet7x0Gy88uw7Xqj6bn276q_93m0,38669
+vmanager/modals/server_prefs_modals.py,sha256=AxRYfJm8Q-IFkKx1u3To_7yZkGhaPanabI-COdULD-k,39275
 vmanager/modals/utils_modals.py,sha256=ijJQZF68icCWNwmKFnoeS7avufjafc7Z4egaaB_79Xg,8675
 vmanager/modals/virsh_modals.py,sha256=t5TT8sNyb3vUJ0a7j6KpH8LdXAvjJ0U9L6NtulSB5x0,4782
 vmanager/modals/virtiofs_modals.py,sha256=R2R6Rcaeg3QLsUgC5v9BjJfvyXtXWVO_eL3iqchanuk,2145
@@ -58,8 +58,8 @@ vmanager/modals/vmanager_modals.py,sha256=Ix4SxO_e8SfBg0B2iou6M5xk1DigO814e6iwD5
 vmanager/modals/vmcard_dialog.py,sha256=EYS19Ooy6KviTPLVzBjGEkALvKRYLJG9rksMHXRO0VU,18674
 vmanager/modals/vmdetails_modals.py,sha256=YE0u71-K-GV5n_38oIzCD2EvqTCIJmJcv3B1Ofej5Rg,149636
 vmanager/modals/xml_modals.py,sha256=iY981cqzVnDYOUo-kw1DHpW9I7IVAU1K7rFqqvxltOk,1653
-virtui_manager-1.1.5.dist-info/METADATA,sha256=NkuWhmBKj2I_mR27vU01T4nhV-q2fLwztbEvCxH26mk,5329
-virtui_manager-1.1.5.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-virtui_manager-1.1.5.dist-info/entry_points.txt,sha256=hnJHxJyDFPSNdOaxmMYikXeoJMXG2llKG-l_Ygv7ges,163
-virtui_manager-1.1.5.dist-info/top_level.txt,sha256=fQ1nwH-4wZrf6Rc9HEHbudVahpy3TqeuMxgaaNHevxM,9
-virtui_manager-1.1.5.dist-info/RECORD,,
+virtui_manager-1.1.6.dist-info/METADATA,sha256=rVmqF190noCHtV6z3ZsXhWjC-OoAfUmnn6pKC0-8v9c,5329
+virtui_manager-1.1.6.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+virtui_manager-1.1.6.dist-info/entry_points.txt,sha256=hnJHxJyDFPSNdOaxmMYikXeoJMXG2llKG-l_Ygv7ges,163
+virtui_manager-1.1.6.dist-info/top_level.txt,sha256=fQ1nwH-4wZrf6Rc9HEHbudVahpy3TqeuMxgaaNHevxM,9
+virtui_manager-1.1.6.dist-info/RECORD,,

vmanager/constants.py

@@ -37,7 +37,7 @@ class AppInfo:
     """Define app data"""
     name = "virtui-manager"
     namecase = "VirtUI Manager"
-    version = "1.1.5"
+    version = "1.1.6"
 
 class VmAction:
     """Defines constants for VM action types."""

vmanager/modals/howto_disk_modal.py

@@ -1,89 +1,29 @@
 """
 Modal to show how to manage VM disks.
 """
+import os
+from pathlib import Path
 from textual.app import ComposeResult
 from textual.containers import Vertical, Horizontal, ScrollableContainer
 from textual.widgets import Button, Markdown
 from textual import on
 from .base_modals import BaseModal
 
-HOW_TO_DISK_TEXT = """
-# Managing VM Disks
-
-This guide explains the functions of the buttons available in the "Disks" tab.
-
----
-
-### Add Disk
-
-This button allows you to create a **brand new virtual disk** and attach it to the VM.
-
-- You will be prompted to select a **Storage Pool** where the new disk image file will be created.
-- You must provide a **Volume Name** for the new disk (e.g., `new-data-disk.qcow2`).
-- You must specify its **Size** and **Format** (`qcow2` or `raw`).
-- The VM does **not** need to be stopped to add a new disk.
-
----
-
-### Attach Existing Disk
-
-This attaches a **pre-existing disk image** to your VM. This is useful if you have an existing `.qcow2`, `.raw`, or `.iso` file you want to use.
-
-- The system will first ask you to select a **Storage Pool** that contains the disk volume you want to attach.
-- If the disk file is not part of a libvirt storage pool yet, you should first use the "Attach" button in the **Server Preferences -> Storage** tab to make it known to libvirt. This might involve creating a new storage pool for the directory containing your disk file.
-
----
-
-### Edit Disk
-
-*(This button is enabled only when a disk is selected in the table)*
-
-Allows you to modify properties of an attached disk, such as:
-- **Bus Type:** `virtio`, `sata`, `scsi`, etc.
-- **Cache Mode:** `none`, `writeback`, etc.
-- **Discard Mode:** `unmap`, `ignore`.
-
-> **Important:** The VM must be **stopped** to edit disk properties.
-
----
-
-### Remove Disk
-
-*(This button is enabled only when a disk is selected)*
-
-This **detaches** the selected disk from the virtual machine.
-
-- **This action does NOT delete the disk image file.** The file remains in its storage pool or on your filesystem.
-- It only removes the disk from this specific VM's configuration.
-- The VM must be **stopped** to remove most types of disks.
-
----
-
-### Disable Disk
-
-*(This button is enabled for active disks)*
-
-This temporarily "unplugs" the disk from the VM **without removing its configuration**.
-
-- The disk will become invisible to the guest operating system but remains in the disk list with a `(disabled)` status.
-- This is useful for troubleshooting or temporarily preventing access to a disk without fully removing it.
-
----
-
-### Enable Disk
-
-*(This button is enabled for disabled disks)*
-
-This "re-plugs" a disabled disk back into the VM, making it available to the guest operating system again.
-"""
-
 class HowToDiskModal(BaseModal[None]):
     """A modal to display instructions for managing VM disks."""
 
     def compose(self) -> ComposeResult:
+        # Load markdown from external file
+        docs_path = Path(__file__).parent.parent / "appdocs" / "howto_disk.md"
+        try:
+            with open(docs_path, "r") as f:
+                content = f.read()
+        except FileNotFoundError:
+            content = "# Error: Documentation file not found."
+
         with Vertical(id="howto-disk-dialog"):
             with ScrollableContainer(id="howto-disk-content"):
-                yield Markdown(HOW_TO_DISK_TEXT, id="howto-disk-markdown")
+                yield Markdown(content, id="howto-disk-markdown")
         with Horizontal(id="dialog-buttons"):
             yield Button("Close", id="close-btn", variant="primary")
 

vmanager/modals/howto_network_modal.py

@@ -1,56 +1,29 @@
 """
 Modal to show how to configure networks.
 """
+import os
+from pathlib import Path
 from textual.app import ComposeResult
 from textual.containers import Vertical, Horizontal, ScrollableContainer
 from textual.widgets import Button, Markdown
 from textual import on
 from .base_modals import BaseModal
 
-HOW_TO_NETWORK_TEXT = """
-# Understanding Network Configuration in libvirt
-
-libvirt provides flexible networking capabilities for virtual machines, allowing them to communicate with each other, the host, and external networks.
-
-### Types of Networks
-
-1.  **NAT (Network Address Translation) Network:**
-    *   **Purpose:** Allows VMs to access the external network (internet) but prevents external machines from directly initiating connections to the VMs.
-    *   **Mechanism:** libvirt creates a virtual bridge (e.g., `virbr0`) on the host, and VMs connect to this bridge. The host acts as a router, performing NAT for outgoing connections from VMs. VMs get IP addresses from a DHCP server managed by libvirt.
-    *   **Use Cases:** Most common setup for general VM usage where VMs just need internet access.
-
-2.  **Routed Network:**
-    *   **Purpose:** VMs can communicate with other machines on the host's physical network, and potentially external networks, with proper routing configured on the host and potentially external routers. VMs will have IP addresses on the same subnet as the host's physical network, or a dedicated routed subnet.
-    *   **Mechanism:** Similar to NAT, a virtual bridge is used, but without NAT. The host needs to be configured to route traffic between the virtual bridge and the physical interface. VMs typically get IP addresses from a DHCP server on the physical network or static IPs.
-    *   **Use Cases:** When VMs need to be directly accessible from the physical network, or participate as full members of an existing network.
-
-3.  **Isolated Network:**
-    *   **Purpose:** VMs on this network can only communicate with each other and the host, but not with external networks.
-    *   **Mechanism:** A virtual bridge is created, but no routing or NAT is configured to connect it to physical interfaces.
-    *   **Use Cases:** Testing environments, isolated services, or when you need a private network segment for VMs.
-
-### Key Concepts
-
-*   **Bridge:** A software-based network device that connects multiple network segments at the data link layer. VMs connect to a virtual bridge, which then connects to a physical interface (for NAT/routed) or remains isolated.
-*   **DHCP:** Dynamic Host Configuration Protocol. Automatically assigns IP addresses to VMs within a network.
-*   **Forward Device:** The physical network interface on the host through which the virtual network's traffic is forwarded (for NAT or routed modes).
-*   **MAC Address:** Media Access Control address. A unique identifier assigned to network interfaces. For KVM/QEMU, MAC addresses often start with `52:54:00:`.
-
-### Common Tasks
-
-*   **Create/Edit Network:** Define network parameters like name, IP range, DHCP settings, and forward mode.
-*   **Activate/Deactivate Network:** Start or stop a virtual network.
-*   **Autostart Network:** Configure a network to start automatically when the libvirt daemon starts.
-*   **View XML:** Examine the underlying libvirt XML definition of a network, which provides full details of its configuration.
-"""
-
 class HowToNetworkModal(BaseModal[None]):
     """A modal to display instructions for network configuration."""
 
     def compose(self) -> ComposeResult:
+        # Load markdown from external file
+        docs_path = Path(__file__).parent.parent / "appdocs" / "howto_network.md"
+        try:
+            with open(docs_path, "r") as f:
+                content = f.read()
+        except FileNotFoundError:
+            content = "# Error: Documentation file not found."
+
         with Vertical(id="howto-network-dialog"):
             with ScrollableContainer(id="howto-network-content"):
-                yield Markdown(HOW_TO_NETWORK_TEXT, id="howto-network-markdown")
+                yield Markdown(content, id="howto-network-markdown")
         with Horizontal(id="dialog-buttons"):
             yield Button("Close", id="close-btn", variant="primary")
 

vmanager/modals/howto_overlay_modal.py

@@ -1,69 +1,29 @@
 """
 Modal to show how overlay disks work.
 """
+import os
+from pathlib import Path
 from textual.app import ComposeResult
 from textual.containers import Vertical, Horizontal, ScrollableContainer
 from textual.widgets import Button, Markdown
 from textual import on
 from .base_modals import BaseModal
 
-HOW_TO_OVERLAY_TEXT = """
-# Understanding Snapshots and Disk Overlays
-
-Virtual machines in this manager support two ways to preserve states and manage changes: **Snapshots** and **Disk Overlays**. While they share similar goals, they work differently and are suited for different use cases.
-
----
-
-### 1. Snapshots (Internal)
-Snapshots are managed directly by libvirt and are typically stored **inside** the disk image (if using QCOW2 format).
-
-*   **How they work:** When you take a snapshot, libvirt records the current state of the VM's disks and, if the VM is running, its memory (RAM). You can have many snapshots for a single VM, creating a timeline you can jump back and forth in.
-*   **Operations:**
-    *   **Take Snapshot:** Creates a new restore point.
-    *   **Restore Snapshot:** Reverts the VM to a previous state.
-    *   **Delete Snapshot:** Removes the restore point from the timeline.
-*   **Best for:** Quick restore points before risky operations, and preserving the full "live" state of a running VM.
-
-### 2. Disk Overlays (External)
-Overlays are **new files** created on top of a base disk image. This is also known as "External Snapshots" or "Backing Files".
-
-*   **Key Concepts:**
-    *   **Base Image (Backing File):** The original disk image that becomes read-only.
-    *   **Overlay Image:** A new QCOW2 file that records only the changes made *after* its creation.
-    *   **Backing Chain:** The relationship between layers (e.g., Base -> Overlay 1 -> Overlay 2).
-*   **Operations:**
-    *   **New Overlay:** Freezes the current disk and starts a new layer.
-    *   **Discard Overlay (Revert):** Deletes the overlay file and reverts to the base image.
-    *   **Commit Disk (Merge):** Merges changes from the overlay into the base image, making them permanent.
-*   **Best for:** Maintaining "Golden Images", branching multiple VMs from a single base, and isolating large changes in separate files.
-
----
-
-### Comparison: Snapshot vs. Overlay
-
-| Feature | Snapshots (Internal) | Disk Overlays (External) |
-| :--- | :--- | :--- |
-| **Storage** | Inside the existing disk file | In a new, separate file |
-| **VM State** | Can include RAM (Live state) | Disk only (requires VM stop) |
-| **Management** | Timeline (multiple points) | Layered (Base + Changes) |
-| **Primary Use** | Quick restore points | Permanent branching / Golden images |
-
----
-
-### How Overlays Work (Technical)
-
-1.  **Creation:** When you create a "New Overlay", the current disk image is set as the backing file for a newly created QCOW2 file. The VM is then updated to point to this new overlay file instead of the original disk.
-2.  **Read Operations:** When the VM needs to read data, it first checks the overlay. If the data has been modified, it reads from the overlay. If not, it transparently reads from the backing file.
-3.  **Write Operations:** All writes are directed to the overlay file. The backing file remains untouched and pristine.
-"""
-
 class HowToOverlayModal(BaseModal[None]):
     """A modal to display instructions for disk overlays."""
 
     def compose(self) -> ComposeResult:
+        # Load markdown from external file
+        docs_path = Path(__file__).parent.parent / "appdocs" / "howto_overlay.md"
+        try:
+            with open(docs_path, "r") as f:
+                content = f.read()
+        except FileNotFoundError:
+            content = "# Error: Documentation file not found."
+
         with Vertical(id="howto-overlay-dialog", classes="howto-dialog"):
             with ScrollableContainer(id="howto-overlay-content"):
-                yield Markdown(HOW_TO_OVERLAY_TEXT, id="howto-overlay-markdown")
+                yield Markdown(content, id="howto-overlay-markdown")
         with Horizontal(id="dialog-buttons"):
             yield Button("Close", id="close-btn", variant="primary")
 

vmanager/modals/howto_ssh_modal.py

@@ -1,84 +1,28 @@
 """
 Modal to show how to use ssh-agent.
 """
+from pathlib import Path
 from textual.app import ComposeResult
 from textual.containers import Vertical, Horizontal, ScrollableContainer
 from textual.widgets import Button, Markdown
 from textual import on
 from .base_modals import BaseModal
 
-HOW_TO_SSH_TEXT = """
-# Using an SSH Agent for Passwordless Connections
-
-Using an `ssh-agent` is the standard and most secure way to handle passphrase-protected SSH keys, allowing you to connect without repeatedly entering your passphrase.
-
-### What is an SSH Agent?
-
-An `ssh-agent` is a background program that securely stores your private SSH keys in memory. When you try to connect to a remote server, SSH can ask the agent for the key, and the agent provides it. You only need to "unlock" your key once.
-
----
-
-### Step 1: Start the `ssh-agent`
-
-On most modern desktop environments, an agent is often started automatically. If not, run this in your terminal:
-
-```bash
-eval "$(ssh-agent -s)"
-```
-
-> To make this permanent, add the command to your shell's startup file (e.g., `~/.bashrc` or `~/.zshrc`).
-
----
-
-### Step 2: Add Your SSH Key to the Agent
-
-Use the `ssh-add` command. If your key is in a default location (`~/.ssh/id_rsa`, etc.), you can just run:
-
-```bash
-ssh-add
-```
-
-If your key is elsewhere, specify the path to the **private key**:
-
-```bash
-ssh-add /path/to/your/private_key
-```
-
-You will be prompted for your key's passphrase **one time**.
-
-To verify the key was added, list the agent's keys:
-```bash
-ssh-add -l
-```
----
-
-### Step 3: Connect
-
-That's it! `Virtui Manager` will now use the agent to authenticate for any `qemu+ssh://` connections without any more prompts.
-
----
-
-### SSH Compression for Performance
-
-For connections over slower networks, enabling SSH compression can significantly improve performance. This is configured in your SSH client's configuration file.
-
-To enable compression for a specific host, add the following to your `~/.ssh/config` file:
-
-```
-Host your_remote_host_name
-  Compression yes
-```
-
-Replace `your_remote_host_name` with the actual hostname or IP address you use in your `qemu+ssh://` URI. If you want to enable compression for all SSH connections, you can use `Host *`.
-"""
-
 class HowToSSHModal(BaseModal[None]):
     """A modal to display instructions for using an ssh-agent."""
 
     def compose(self) -> ComposeResult:
+        # Load markdown from external file
+        docs_path = Path(__file__).parent.parent / "appdocs" / "howto_ssh.md"
+        try:
+            with open(docs_path, "r") as f:
+                content = f.read()
+        except FileNotFoundError:
+            content = "# Error: Documentation file not found."
+
         with Vertical(id="howto-ssh-dialog"):
             with ScrollableContainer(id="howto-ssh-content"):
-                yield Markdown(HOW_TO_SSH_TEXT, id="howto-ssh-markdown")
+                yield Markdown(content, id="howto-ssh-markdown")
         with Horizontal(id="dialog-buttons"):
             yield Button("Close", id="close-btn", variant="primary")
 

vmanager/modals/howto_virtiofs_modal.py

@@ -1,81 +1,29 @@
 """
 Modal to show how to use VirtIO-FS.
 """
+import os
+from pathlib import Path
 from textual.app import ComposeResult
 from textual.containers import Vertical, Horizontal, ScrollableContainer
 from textual.widgets import Button, Markdown
 from textual import on
 from .base_modals import BaseModal
 
-HOW_TO_VIRTIOFS_TEXT = """
-# Using VirtIO-FS for Host-Guest File Sharing
-
-VirtIO-FS is a high-performance shared filesystem that lets you share a directory from your host machine directly with a guest VM.
-
----
-
-### Host Prerequisites
-
-1.  **Shared Memory:** VirtIO-FS requires shared memory to be enabled for the VM. You can enable this in the **"Mem"** tab.
-2.  **Permissions:** The user running QEMU/libvirt on the host must have the necessary permissions to read (and write, if needed) the source directory you want to share.
-
----
-
-### Adding a VirtIO-FS Mount
-
-- **Source Path:** The absolute path to the directory on your **host machine** that you want to share.
-- **Target Path:** This is a "mount tag" or a label that the guest VM will use to identify the shared directory. It is **not** a path inside the guest. For example, you could use `shared-data`.
-
----
-
-### Mounting in a Linux Guest
-
-Most modern Linux distributions include the necessary VirtIO-FS drivers.
-
-**1. Create a Mount Point:**
-This is the directory inside your VM where the shared files will appear.
-
-```bash
-sudo mkdir /mnt/my_host_share
-```
-
-**2. Mount the Share:**
-Use the `mount` command with the filesystem type `virtiofs` and the **Target Path (mount tag)** you defined.
-
-```bash
-sudo mount -t virtiofs 'your-target-path' /mnt/my_host_share
-```
-*(Replace `'your-target-path'` with the actual tag you set)*
-
-**3. Automount on Boot (Optional):**
-To make the share available automatically every time the VM boots, add an entry to `/etc/fstab`:
-
-```
-your-target-path /mnt/my_host_share virtiofs defaults,nofail 0 0
-```
-> The `nofail` option is recommended to prevent boot issues if the share is not available.
-
----
-
-### Mounting in a Windows Guest
-
-**1. Install Drivers:**
-You must install the VirtIO-FS drivers in the Windows guest. These are included in the **"VirtIO-Win Guest Tools"** package, which you can typically download as an ISO file.
-- Download the latest stable `virtio-win.iso` from the [Fedora VirtIO-Win project](https://github.com/virtio-win/virtio-win-pkg-scripts/blob/master/README.md).
-- Attach the ISO to your VM as a CD-ROM.
-- Open the CD-ROM in Windows and run the `virtio-win-guest-tools.exe` installer, ensuring the **"VirtIO-FS"** feature is selected.
-
-**2. Access the Share:**
-After installation and a reboot, the VirtIO-FS service will start. The shared folder will automatically appear as a network drive in **This PC** (or My Computer). The drive will be named after the **Target Path (mount tag)** you set.
-"""
-
 class HowToVirtIOFSModal(BaseModal[None]):
     """A modal to display instructions for using VirtIO-FS."""
 
     def compose(self) -> ComposeResult:
+        # Load markdown from external file
+        docs_path = Path(__file__).parent.parent / "appdocs" / "howto_virtiofs.md"
+        try:
+            with open(docs_path, "r") as f:
+                content = f.read()
+        except FileNotFoundError:
+            content = "# Error: Documentation file not found."
+
         with Vertical(id="howto-virtiofs-dialog"):
             with ScrollableContainer(id="howto-virtiofs-content"):
-                yield Markdown(HOW_TO_VIRTIOFS_TEXT, id="howto-virtiofs-markdown")
+                yield Markdown(content, id="howto-virtiofs-markdown")
         with Horizontal(id="dialog-buttons"):
             yield Button("Close", id="close-btn", variant="primary")
 

vmanager/modals/server_prefs_modals.py

@@ -248,20 +248,28 @@ class ServerPrefModal(BaseModal[None]):
         pools = storage_manager.list_storage_pools(self.conn)
         node_to_select = None
         for pool_data in pools:
-            pool_name = pool_data['name']
-            status = pool_data['status']
-            autostart = "autostart" if pool_data['autostart'] else "no autostart"
-            label = f"{pool_name} [{status}, {autostart}]"
-            pool_node = tree.root.add(label, data=pool_data)
-            pool_node.data["type"] = "pool"
-            # Add a dummy node to make the pool node expandable
-            pool_node.add_leaf("Loading volumes...")
-
-            if expand_pools and pool_name in expand_pools:
-                self.app.call_later(pool_node.expand)
-
-            if select_pool and pool_name == select_pool:
-                node_to_select = pool_node
+            try:
+                pool_name = pool_data['name']
+                status = pool_data['status']
+                autostart = "autostart" if pool_data['autostart'] else "no autostart"
+                label = f"{pool_name} [{status}, {autostart}]"
+                pool_node = tree.root.add(label, data=pool_data)
+                pool_node.data["type"] = "pool"
+                # Add a dummy node to make the pool node expandable
+                pool_node.add_leaf("Loading volumes...")
+
+                if expand_pools and pool_name in expand_pools:
+                    self.app.call_later(pool_node.expand)
+
+                if select_pool and pool_name == select_pool:
+                    node_to_select = pool_node
+            except libvirt.libvirtError:
+                # Handle cases where pool might be listed but inaccessible (e.g. NFS down)
+                pool_name = pool_data.get('name', 'Unknown')
+                label = f"{pool_name} [unavailable]"
+                pool_node = tree.root.add(label, data=pool_data)
+                pool_node.data["type"] = "pool"
+                pool_node.add_leaf("Pool unavailable")
 
         if node_to_select:
             self.app.call_later(tree.select_node, node_to_select)
@@ -308,7 +316,8 @@ class ServerPrefModal(BaseModal[None]):
         if len(node.children) == 1 and node.children[0].data is None:
             node.remove_children()
             pool = node_data.get('pool')
-            if pool and pool.isActive():
+            # Check cached status instead of calling pool.isActive() to avoid blocking
+            if pool and node_data.get('status') == 'active':
                 volumes = storage_manager.list_storage_volumes(pool)
                 for vol_data in volumes:
                     vol_name = vol_data['name']
@@ -404,7 +413,7 @@ class ServerPrefModal(BaseModal[None]):
             self.app.show_error_message("Could not find pool object to edit.")
             return
 
-        if pool.isActive():
+        if node_data.get('status') == 'active':
             self.app.show_error_message("Pool must be inactive to edit its XML definition.")
             return
 

vmanager/storage_manager.py

@@ -29,18 +29,40 @@ def list_storage_pools(conn: libvirt.virConnect) -> List[Dict[str, Any]]:
         pools = conn.listAllStoragePools(0)
         for pool in pools:
             try:
+                # Try to get basic info
+                try:
+                    name = pool.name()
+                except libvirt.libvirtError:
+                    name = "Unknown Pool"
+
                 is_active = pool.isActive()
                 info = pool.info()
                 pools_info.append({
-                    'name': pool.name(),
+                    'name': name,
                     'pool': pool,
                     'status': 'active' if is_active else 'inactive',
                     'autostart': pool.autostart() == 1,
                     'capacity': info[1],
                     'allocation': info[2],
                 })
-            except libvirt.libvirtError:
-                continue
+            except libvirt.libvirtError as e:
+                # If we fail to get details (e.g. NFS down), still list the pool but as unavailable
+                if 'name' not in locals():
+                     try:
+                        name = pool.name()
+                     except:
+                        name = "Unknown Pool"
+
+                logging.warning(f"Failed to get details for pool '{name}': {e}")
+                pools_info.append({
+                    'name': name,
+                    'pool': pool,
+                    'status': 'unavailable',
+                    'autostart': False,
+                    'capacity': 0,
+                    'allocation': 0,
+                    'error': str(e)
+                })
     except libvirt.libvirtError:
         return []