pvectl 0.2.0

data/lib/pvectl/presenters/node_operation_result.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Pvectl
+  module Presenters
+    # Presenter for node operation results (set/edit).
+    #
+    # Formats NodeOperationResult models for table/JSON/YAML output.
+    #
+    # @example Using with formatter
+    #   presenter = NodeOperationResult.new
+    #   formatter = Formatters::Table.new
+    #   output = formatter.format(results, presenter)
+    #
+    class NodeOperationResult < OperationResult
+      # Returns column headers for standard table output.
+      #
+      # @return [Array<String>] column headers
+      def columns
+        %w[NODE OPERATION STATUS MESSAGE]
+      end
+
+      # Converts result to table row values.
+      #
+      # @param model [Models::NodeOperationResult] result model
+      # @param context [Hash] optional context
+      # @return [Array<String>] row values
+      def to_row(model, **_context)
+        [
+          model.node_model&.name || "-",
+          model.operation&.to_s || "-",
+          status_display(model),
+          model.message
+        ]
+      end
+
+      # Converts result to hash for JSON/YAML output.
+      #
+      # @param model [Models::NodeOperationResult] result model
+      # @return [Hash] hash representation
+      def to_hash(model)
+        {
+          "node" => model.node_model&.name,
+          "operation" => model.operation&.to_s,
+          "status" => model.status_text,
+          "message" => model.message
+        }
+      end
+    end
+  end
+end

data/lib/pvectl/presenters/operation_result.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Pvectl
+  module Presenters
+    # Base presenter for lifecycle operation results.
+    #
+    # Provides shared formatting helpers (status colors, task UPID, duration)
+    # for subclasses like VmOperationResult and ContainerOperationResult.
+    #
+    # @abstract Subclass and implement columns, to_row, extra_values, to_hash.
+    #
+    class OperationResult < Base
+      include Formatters::ColorSupport
+
+      protected
+
+      # Returns colored status display.
+      #
+      # @param model [Models::OperationResult] result model
+      # @return [String] colored status
+      def status_display(model)
+        case model.status_text
+        when "Success" then colorize(model.status_text, :green)
+        when "Failed" then colorize(model.status_text, :red)
+        when "Pending" then colorize(model.status_text, :yellow)
+        when "Partial" then colorize(model.status_text, :bright_yellow)
+        else model.status_text
+        end
+      end
+
+      # Returns task UPID or dash.
+      #
+      # @param model [Models::OperationResult] result model
+      # @return [String] UPID or "-"
+      def task_upid(model)
+        model.task_upid || model.task&.upid || "-"
+      end
+
+      # Returns formatted duration.
+      #
+      # @param model [Models::OperationResult] result model
+      # @return [String] duration or "-"
+      def duration_display(model)
+        duration = model.task&.duration
+        return "-" unless duration
+
+        "#{duration.to_f.round(1)}s"
+      end
+
+      # Colorizes text using Pastel.
+      #
+      # @param text [String] text to colorize
+      # @param color [Symbol] color name (:green, :red, :yellow)
+      # @return [String] colored text
+      def colorize(text, color)
+        pastel = Formatters::ColorSupport.pastel(explicit_flag: nil)
+        pastel.public_send(color, text)
+      end
+    end
+  end
+end

data/lib/pvectl/presenters/service.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Pvectl
+  module Presenters
+    # Presenter for systemd services on Proxmox nodes.
+    #
+    # Defines column layout and formatting for table output of node services.
+    # Standard columns show node, name, state, active, enabled, description.
+    # Wide adds the systemd unit identifier.
+    #
+    # @example Using with formatter
+    #   presenter = Service.new
+    #   formatter = Formatters::Table.new
+    #   output = formatter.format(services, presenter)
+    #
+    # @see Pvectl::Models::Service Service model
+    # @see Pvectl::Formatters::Table Table formatter
+    #
+    class Service < Base
+      # Returns column headers for standard table output.
+      #
+      # @return [Array<String>] column headers
+      def columns
+        %w[NODE NAME STATE ACTIVE ENABLED DESCRIPTION]
+      end
+
+      # Returns additional column headers for wide output.
+      #
+      # @return [Array<String>] extra column headers
+      def extra_columns
+        %w[UNIT]
+      end
+
+      # Converts a Service model to table row values.
+      #
+      # @param model [Models::Service] Service model
+      # @param context [Hash] optional context
+      # @return [Array<String>] row values matching columns order
+      def to_row(model, **_context)
+        [
+          model.node || "-",
+          model.display_name || "-",
+          model.state || "-",
+          model.active_state || "-",
+          model.unit_state || "-",
+          model.desc || "-"
+        ]
+      end
+
+      # Returns additional values for wide output.
+      #
+      # @param model [Models::Service] Service model
+      # @param context [Hash] optional context
+      # @return [Array<String>] extra values matching extra_columns order
+      def extra_values(model, **_context)
+        [model.service || "-"]
+      end
+
+      # Converts a Service model to hash for JSON/YAML output.
+      #
+      # @param model [Models::Service] Service model
+      # @return [Hash{String => String?}] hash representation
+      def to_hash(model)
+        {
+          "node" => model.node,
+          "service" => model.service,
+          "name" => model.name,
+          "state" => model.state,
+          "active_state" => model.active_state,
+          "unit_state" => model.unit_state,
+          "desc" => model.desc
+        }
+      end
+    end
+  end
+end

data/lib/pvectl/presenters/snapshot.rb

@@ -0,0 +1,239 @@
+# frozen_string_literal: true
+
+module Pvectl
+  module Presenters
+    # Presenter for VM/container snapshots.
+    #
+    # Defines column layout and formatting for snapshot table output.
+    # Supports both list (get) and describe output modes.
+    #
+    # Standard columns: VMID, NAME, CREATED, DESCRIPTION
+    # Wide columns add: TYPE, VMSTATE, PARENT
+    #
+    # @example Using with formatter
+    #   presenter = Snapshot.new
+    #   formatter = Formatters::Table.new
+    #   output = formatter.format(snapshots, presenter)
+    #
+    # @see Pvectl::Models::Snapshot Snapshot model
+    # @see Pvectl::Models::SnapshotDescription SnapshotDescription model
+    # @see Pvectl::Formatters::Table Table formatter
+    #
+    class Snapshot < Base
+      # Returns column headers for standard table output.
+      #
+      # @return [Array<String>] column headers
+      def columns
+        %w[VMID NAME CREATED DESCRIPTION]
+      end
+
+      # Returns additional column headers for wide output.
+      #
+      # @return [Array<String>] extra column headers
+      def extra_columns
+        %w[TYPE VMSTATE PARENT]
+      end
+
+      # Converts Snapshot model to table row values.
+      #
+      # @param model [Models::Snapshot] Snapshot model
+      # @param context [Hash] optional context
+      # @return [Array<String>] row values matching columns order
+      def to_row(model, **_context)
+        [
+          model.vmid.to_s,
+          model.name,
+          format_time(model.created_at),
+          model.description || "-"
+        ]
+      end
+
+      # Returns additional values for wide output.
+      #
+      # @param model [Models::Snapshot] Snapshot model
+      # @param context [Hash] optional context
+      # @return [Array<String>] extra values matching extra_columns order
+      def extra_values(model, **_context)
+        [
+          model.resource_type&.to_s || "-",
+          model.has_vmstate? ? "yes" : "no",
+          model.parent || "-"
+        ]
+      end
+
+      # Converts model to hash for JSON/YAML output.
+      #
+      # Handles both Models::Snapshot (for list) and
+      # Models::SnapshotDescription (for describe).
+      #
+      # @param model [Models::Snapshot, Models::SnapshotDescription] model
+      # @return [Hash, Array<Hash>] hash representation with string keys
+      def to_hash(model)
+        return snapshot_to_hash(model) unless model.is_a?(Models::SnapshotDescription)
+
+        if model.single?
+          entry = model.entries.first
+          snapshot_to_hash(entry.snapshot).merge(
+            "snapshot_tree" => build_tree_data(entry)
+          )
+        else
+          model.entries.map do |entry|
+            snapshot_to_hash(entry.snapshot).merge(
+              "snapshot_tree" => build_tree_data(entry)
+            )
+          end
+        end
+      end
+
+      # Returns describe output for SnapshotDescription or plain Snapshot.
+      #
+      # @param model [Models::SnapshotDescription, Models::Snapshot] model
+      # @return [Hash] description hash for formatter
+      def to_description(model)
+        return snapshot_to_hash(model) unless model.is_a?(Models::SnapshotDescription)
+
+        if model.single?
+          build_single_description(model.entries.first)
+        else
+          build_multi_description(model.entries)
+        end
+      end
+
+      private
+
+      # Converts a single Snapshot model to hash.
+      #
+      # @param model [Models::Snapshot] Snapshot model
+      # @return [Hash] hash representation
+      def snapshot_to_hash(model)
+        {
+          "vmid" => model.vmid,
+          "name" => model.name,
+          "node" => model.node,
+          "type" => model.resource_type&.to_s,
+          "description" => model.description,
+          "vmstate" => model.has_vmstate?,
+          "parent" => model.parent,
+          "created" => format_time(model.created_at)
+        }
+      end
+
+      # Builds describe hash for a single VM entry.
+      #
+      # @param entry [Models::SnapshotDescription::Entry] entry
+      # @return [Hash] description hash
+      def build_single_description(entry)
+        snap = entry.snapshot
+        {
+          "Name" => snap.name,
+          "VMID" => snap.vmid,
+          "Node" => snap.node,
+          "Type" => snap.resource_type&.to_s,
+          "Created" => format_time(snap.created_at),
+          "Description" => snap.description || "-",
+          "VM State" => snap.has_vmstate? ? "Yes" : "No",
+          "Parent" => snap.parent || "-",
+          "Snapshot Tree" => build_tree_string(entry)
+        }
+      end
+
+      # Builds describe hash for multiple VM entries.
+      #
+      # @param entries [Array<Models::SnapshotDescription::Entry>] entries
+      # @return [Hash] nested hash with section per VM
+      def build_multi_description(entries)
+        result = {}
+        entries.each do |entry|
+          snap = entry.snapshot
+          label = snap.vm? ? "VM" : "CT"
+          header = "#{label} #{snap.vmid} (#{snap.node})"
+          result[header] = build_single_description(entry)
+        end
+        result
+      end
+
+      # Builds tree string for display in table format.
+      #
+      # @param entry [Models::SnapshotDescription::Entry] entry with siblings
+      # @return [String] multi-line tree string
+      def build_tree_string(entry)
+        children_map = build_children_map(entry.siblings)
+        roots = entry.siblings.select { |s| s.parent.nil? }.map(&:name)
+        all_roots = roots + ["(current)"]
+
+        lines = []
+        all_roots.each_with_index do |root, idx|
+          last = idx == all_roots.length - 1
+          if root == "(current)"
+            lines << "#{last ? "\u2514\u2500" : "\u251c\u2500"} (current)"
+          else
+            render_tree_node(root, children_map, entry.snapshot.name, "", last, lines)
+          end
+        end
+
+        lines.join("\n")
+      end
+
+      # Recursively renders a tree node.
+      #
+      # @param name [String] snapshot name
+      # @param children_map [Hash] parent -> children mapping
+      # @param target [String] target snapshot name to mark
+      # @param prefix [String] indentation prefix
+      # @param last [Boolean] whether this is the last sibling
+      # @param lines [Array<String>] accumulator for output lines
+      # @return [void]
+      def render_tree_node(name, children_map, target, prefix, last, lines)
+        connector = last ? "\u2514\u2500" : "\u251c\u2500"
+        marker = name == target ? "  \u25c0" : ""
+        lines << "#{prefix}#{connector} #{name}#{marker}"
+
+        children = children_map[name] || []
+        children.each_with_index do |child, idx|
+          child_prefix = prefix + (last ? "   " : "\u2502  ")
+          child_last = idx == children.length - 1
+          render_tree_node(child, children_map, target, child_prefix, child_last, lines)
+        end
+      end
+
+      # Builds parent -> children mapping from siblings.
+      #
+      # @param siblings [Array<Models::Snapshot>] all snapshots for a VM
+      # @return [Hash<String, Array<String>>] parent name -> child names
+      def build_children_map(siblings)
+        map = Hash.new { |h, k| h[k] = [] }
+        siblings.each do |snap|
+          map[snap.parent] << snap.name if snap.parent
+        end
+        map
+      end
+
+      # Builds structured tree data for JSON/YAML output.
+      #
+      # @param entry [Models::SnapshotDescription::Entry] entry with siblings
+      # @return [Array<Hash>] tree nodes with children and current_target flag
+      def build_tree_data(entry)
+        children_map = build_children_map(entry.siblings)
+        entry.siblings.map do |snap|
+          node = {
+            "name" => snap.name,
+            "parent" => snap.parent,
+            "children" => children_map[snap.name] || []
+          }
+          node["current_target"] = true if snap.name == entry.snapshot.name
+          node
+        end
+      end
+
+      # Formats time for display.
+      #
+      # @param time [Time, nil] time to format
+      # @return [String] formatted time or "-" if nil
+      def format_time(time)
+        return "-" if time.nil?
+
+        time.strftime("%Y-%m-%d %H:%M:%S")
+      end
+    end
+  end
+end

data/lib/pvectl/presenters/snapshot_operation_result.rb

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+module Pvectl
+  module Presenters
+    # Presenter for snapshot operation results.
+    #
+    # Formats OperationResult models from snapshot operations for table/JSON/YAML output.
+    # Unlike OperationResult presenter, this handles resource hash instead of VM model.
+    #
+    # @example Using with formatter
+    #   presenter = SnapshotOperationResult.new
+    #   formatter = Formatters::Table.new
+    #   output = formatter.format(results, presenter)
+    #
+    class SnapshotOperationResult < Base
+      include Formatters::ColorSupport
+
+      # Returns column headers for standard table output.
+      #
+      # @return [Array<String>] column headers
+      def columns
+        %w[VMID NAME TYPE NODE STATUS MESSAGE]
+      end
+
+      # Returns additional columns for wide output.
+      #
+      # @return [Array<String>] extra column headers
+      def extra_columns
+        %w[TASK DURATION]
+      end
+
+      # Converts result to table row values.
+      #
+      # @param model [Models::OperationResult] result model
+      # @param context [Hash] optional context
+      # @return [Array<String>] row values
+      def to_row(model, **_context)
+        resource = model.resource || {}
+        [
+          resource[:vmid].to_s,
+          resource[:name] || "-",
+          resource[:type]&.to_s || "-",
+          resource[:node] || "-",
+          status_display(model),
+          model.message
+        ]
+      end
+
+      # Returns additional values for wide output.
+      #
+      # @param model [Models::OperationResult] result model
+      # @param context [Hash] optional context
+      # @return [Array<String>] extra values
+      def extra_values(model, **_context)
+        [
+          task_upid(model),
+          duration_display(model)
+        ]
+      end
+
+      # Converts result to hash for JSON/YAML output.
+      #
+      # @param model [Models::OperationResult] result model
+      # @return [Hash] hash representation
+      def to_hash(model)
+        resource = model.resource || {}
+        {
+          "vmid" => resource[:vmid],
+          "name" => resource[:name],
+          "type" => resource[:type]&.to_s,
+          "node" => resource[:node],
+          "operation" => model.operation&.to_s,
+          "status" => model.status_text,
+          "message" => model.message,
+          "task_upid" => model.task_upid || model.task&.upid
+        }
+      end
+
+      private
+
+      # Returns colored status display.
+      #
+      # @param model [Models::OperationResult] result model
+      # @return [String] colored status
+      def status_display(model)
+        case model.status_text
+        when "Success" then colorize(model.status_text, :green)
+        when "Failed" then colorize(model.status_text, :red)
+        when "Pending" then colorize(model.status_text, :yellow)
+        when "Partial" then colorize(model.status_text, :bright_yellow)
+        else model.status_text
+        end
+      end
+
+      # Returns task UPID or dash.
+      #
+      # @param model [Models::OperationResult] result model
+      # @return [String] UPID or "-"
+      def task_upid(model)
+        model.task_upid || model.task&.upid || "-"
+      end
+
+      # Returns formatted duration.
+      #
+      # @param model [Models::OperationResult] result model
+      # @return [String] duration or "-"
+      def duration_display(model)
+        duration = model.task&.duration
+        return "-" unless duration
+
+        "#{duration.to_f.round(1)}s"
+      end
+
+      # Colorizes text using Pastel.
+      #
+      # @param text [String] text to colorize
+      # @param color [Symbol] color name (:green, :red, :yellow)
+      # @return [String] colored text
+      def colorize(text, color)
+        pastel = Formatters::ColorSupport.pastel(explicit_flag: nil)
+        pastel.public_send(color, text)
+      end
+    end
+  end
+end