vagrant_utm 0.1.4 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8068bfaa981ae823b8b8ff96bfdd585641b26d6b8ddde8c06eb662c4c7ba69c
-  data.tar.gz: e78d77ad7c216bb42afeaa10b467d6f5ab2f0a5f485442e2b855064cb952b291
+  metadata.gz: 7e9244b20397925333750f59097f53ae24d91d577a2b576bb9708575900e6322
+  data.tar.gz: 661fdde402f8e5524c615ca564f2e2996ba802faae4e9def172c3cc40ad4b675
 SHA512:
-  metadata.gz: 55ec5ebe6824831aa5aa78449b09bfae56eeaff6bc5619e2f6c5662b1d272496612314e3c2ebad7bac223322c0edbbcb3c51da7e2d147e9a4ef93b7e020d6e9d
-  data.tar.gz: a2627971b85484b30ff57beeef300466bb1455aa464f956e3b99d066bbe36fa53e83adf9222a6c9cc65decb1aad79576e867e4d4dd7e284bb3cb525be4af3b60
+  metadata.gz: 443831d9674fa2256109ecae5d40bbd6e25034e6226287188238e2659d7b8e9ba6628b5bf26bbfed4e16e06000724b8008f39c099c5a4b018aaba2715fd00728
+  data.tar.gz: 21a86fd8e831745d6cac5b48d3b7d582e033be905afc1de4b1206984d8a9a9c6e8020ecd428c6a2dda11628d0ac4880ed44b6821ad144ac7321eebfb42343bc9

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 ## [Unreleased]
 
+## [0.1.6] - 2026-08-14
+
+### Added
+- Driver: Add support for UTM 5.0.x
+
+### Fixed
+- Fix AppleScript line continuation character encoding issue on Japanese/Korean locales
+- Allow shared folders with whitespace in the host path
+
+## [0.1.5] - 2025-11-16
+
+- Support vm icon
+
+
+
 ## [0.1.4] - 2025-10-11
 
 - Driver: Add support for UTM 4.7.x

data/docs/commands.md

@@ -155,6 +155,6 @@ List all IP addresses associated with network interfaces on the guest.
 
 `utmctl start --disposable`
 
-Start virtual machine in disposable mdoe, which allows you to run a virtual machine without saving any persistent changes to the drive.
+Start virtual machine in disposable mode, which allows you to run a virtual machine without saving any persistent changes to the drive.
 
-Read about Disposable mode in [UTM docs](https://docs.getutm.app/advanced/disposable/)
+Read about Disposable mode in [UTM docs](https://docs.getutm.app/advanced/disposable/)

data/docs/configuration.md

@@ -45,6 +45,8 @@ Vagrant.configure("2") do |config|
     u.cpus = 1
     # Memory in MB
     u.memory = 1024
+    # VM icon (Available icons https://github.com/utmapp/UTM/tree/main/Icons)
+    u.icon = "debian"
     # Notes for UTM VM (Appears in UTM UI)
     u.notes = "Vagrant: For testing plugin development"
     # QEMU Directoy Share mode for the VM. 

data/docs/index.md

@@ -24,6 +24,7 @@ allowing Vagrant to control and provision machines via UTM's API.
 
 [UTM] is a free, full-featured system emulator and virtual machine host for iOS and macOS.  
 The UTM provider currently supports UTM versions 
+* 5.0.x
 * 4.7.x
 * 4.6.x   
 * 4.5.x (Obsolete, use plugin version 0.0.1)  

data/lib/vagrant_utm/action/boot.rb

@@ -9,10 +9,35 @@ module VagrantPlugins
           @app = app
         end
 
-        def call(env)
+        def call(env) # rubocop:disable Metrics/AbcSize
           # Start up the VM and wait for it to boot.
           env[:ui].info I18n.t("vagrant.actions.vm.boot.booting")
-          env[:machine].provider.driver.start
+
+          # Wait for AppleScript configuration changes to be fully saved
+          # before attempting to start the VM to avoid OSStatus error -609
+          # We retry the start command with exponential backoff if it fails
+          max_retries = 3
+          retry_count = 0
+          retry_delay = 1
+
+          max_retries.times do
+            env[:machine].provider.driver.start
+            break # Success, exit the loop
+          rescue VagrantPlugins::Utm::Errors::UtmctlError => e
+            # Only retry if it's an OSStatus error (configuration still being saved)
+            raise unless e.message.include?("OSStatus")
+
+            retry_count += 1
+
+            # If we've exhausted all retries, re-raise the error
+            raise if retry_count >= max_retries
+
+            message = "VM configuration may still be saving. Retrying in #{retry_delay} seconds... " \
+                      "(#{retry_count}/#{max_retries})"
+            env[:ui].warn message
+            sleep retry_delay
+            retry_delay *= 2 # Exponential backoff: 1s, 2s, 4s
+          end
 
           @app.call(env)
         end

data/lib/vagrant_utm/config.rb

@@ -85,6 +85,20 @@ module VagrantPlugins
         customize("pre-boot", ["customize_vm.applescript", :id, "--notes", notes])
       end
 
+      # Shortcut for setting the icon of the virtual machine.
+      # Calls #customize internally.
+      #
+      # Available icons can be found at:
+      # https://github.com/utmapp/UTM/tree/main/Icons
+      #
+      # Common icons include: linux, ubuntu, debian, fedora, archlinux,
+      # openbsd, freebsd, windows, macos, android, etc.
+      #
+      # @param icon [String] the icon name for the VM (e.g., "ubuntu", "debian")
+      def icon=(icon)
+        customize("pre-boot", ["customize_vm.applescript", :id, "--icon", icon.to_s])
+      end
+
       # TODO: All warning if user sets directory_share_mode,
       # because default implementation is 'virtFS'
       # Shortcut for setting the directory share mode of the virtual machine.

data/lib/vagrant_utm/driver/meta.rb

@@ -56,7 +56,8 @@ module VagrantPlugins
           @logger.debug("Finding driver for UTM version: #{@version}")
           driver_map = {
             "4.6" => Version_4_6,
-            "4.7" => Version_4_7
+            "4.7" => Version_4_7,
+            "5.0" => Version_5_0
           }
 
           # UTM version < 4.6.5  doesn't have

data/lib/vagrant_utm/driver/version_5_0.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require File.expand_path("version_4_7", __dir__)
+
+module VagrantPlugins
+  module Utm
+    module Driver
+      # Driver for UTM 5.0.x
+      class Version_5_0 < Version_4_7 # rubocop:disable Naming/ClassAndModuleCamelCase
+        def initialize(uuid)
+          super
+
+          @logger = Log4r::Logger.new("vagrant::provider::utm::version_5_0")
+        end
+      end
+    end
+  end
+end

data/lib/vagrant_utm/scripts/add_folder_share.applescript

@@ -8,7 +8,7 @@
 on createQemuArgsForDir(dirId, dirPath)
 
     -- Prepare the QEMU argument strings
-    set fsdevArgStr to "-fsdev local,id=" & dirId & ",path=" & dirPath & ",security_model=mapped-xattr" 
+    set fsdevArgStr to "-fsdev \"local,id=" & dirId & ",path=" & dirPath & ",security_model=mapped-xattr\"" 
     set deviceArgStr to "-device virtio-9p-pci,fsdev=" & dirId & ",mount_tag=" & dirId
 
     return {fsdevArgStr, deviceArgStr}
@@ -93,4 +93,4 @@ on run argv
         -- Update registry of vm with new directory shares
         update registry of vm with reg
     end tell
-end run
+end run

data/lib/vagrant_utm/scripts/add_port_forwards.applescript

@@ -25,11 +25,12 @@ on run argv
     set ruleComponents to text items of ruleArg
     
     -- Create a port forwarding rule record
-    set portForwardRule to { �
-          indexVal:indexNumber, protocolVal:item 1 of ruleComponents, �
-          guestAddress:item 2 of ruleComponents, guestPort:item 3 of ruleComponents, �
-          hostAddress:item 4 of ruleComponents, hostPort:item 5 of ruleComponents �
-        }
+    set ruleProtocol to item 1 of ruleComponents
+    set ruleGuestAddress to item 2 of ruleComponents
+    set ruleGuestPort to item 3 of ruleComponents
+    set ruleHostAddress to item 4 of ruleComponents
+    set ruleHostPort to item 5 of ruleComponents
+    set portForwardRule to {indexVal:indexNumber, protocolVal:ruleProtocol, guestAddress:ruleGuestAddress, guestPort:ruleGuestPort, hostAddress:ruleHostAddress, hostPort:ruleHostPort}
     
     -- Add the rule to the list
     set end of portForwardRules to portForwardRule
@@ -49,13 +50,12 @@ on run argv
           set portForwards to port forwards of anInterface
           
           -- Create a new port forward configuration
-          set newPortForward to { �
-                protocol:(protocolVal of portForwardRule), �
-                guest address:(guestAddress of portForwardRule), � 
-                guest port:(guestPort of portForwardRule), �
-                host address:(hostAddress of portForwardRule), �
-                host port:(hostPort of portForwardRule) �
-              }
+          set forwardProtocol to protocolVal of portForwardRule
+          set forwardGuestAddress to guestAddress of portForwardRule
+          set forwardGuestPort to guestPort of portForwardRule
+          set forwardHostAddress to hostAddress of portForwardRule
+          set forwardHostPort to hostPort of portForwardRule
+          set newPortForward to {protocol:forwardProtocol, guest address:forwardGuestAddress, guest port:forwardGuestPort, host address:forwardHostAddress, host port:forwardHostPort}
           
           -- Add new port forward to the list
           copy newPortForward to the end of portForwards
@@ -69,4 +69,4 @@ on run argv
     -- Update the VM configuration
     update configuration of vm with config
   end tell
-end run
+end run

data/lib/vagrant_utm/scripts/customize_vm.applescript

@@ -6,6 +6,7 @@ on run argv
         set memorySize to 0
         set vmNotes to ""
         set directoryShareMode to null
+        set vmIcon to ""
 
         -- Parse arguments
         repeat with i from 2 to (count argv)
@@ -20,6 +21,8 @@ on run argv
                 set vmNotes to item (i + 1) of argv
             else if currentArg is "--directory-share-mode" then
                 set directoryShareMode to item (i + 1) of argv
+            else if currentArg is "--icon" then
+                set vmIcon to item (i + 1) of argv
             end if
         end repeat
         
@@ -52,6 +55,11 @@ on run argv
             set directory share mode of config to directoryShareMode -- mode is assumed to be enum value
         end if
 
+        -- Set icon if provided
+        if vmIcon is not "" then
+            set icon of config to vmIcon
+        end if
+
         -- Save the configuration
         update configuration of vm with config
  

data/lib/vagrant_utm/scripts/read_forwarded_ports.applescript

@@ -17,11 +17,12 @@ on run argv
                     set i to i + 1
                     # Log the port forward details Virtualbox style 
                     # 'Forwarding(nicIndex)(ruleIndex)="protocol,guestAddress,guestPort,hostAddress,hostPort"'
-                    log "Forwarding(" & index of anInterface & ")(" & i & ")=\"" & protocol of aPortForward & "," �
-                        & guest address of aPortForward & "," & guest port of aPortForward & "," �
-                        & host address of aPortForward & "," & host port of aPortForward & "\""
+                    set forwardingLine to "Forwarding(" & index of anInterface & ")(" & i & ")=\"" & protocol of aPortForward & ","
+                    set forwardingLine to forwardingLine & guest address of aPortForward & "," & guest port of aPortForward & ","
+                    set forwardingLine to forwardingLine & host address of aPortForward & "," & host port of aPortForward & "\""
+                    log forwardingLine
                 end repeat
             end if
         end repeat
     end tell
-end run
+end run

data/lib/vagrant_utm/version.rb

@@ -4,6 +4,6 @@ module VagrantPlugins
   # Top level module for the Utm provider plugin.
   module Utm
     # Current version of the Utm provider plugin.
-    VERSION = "0.1.4"
+    VERSION = "0.1.6"
   end
 end

data/lib/vagrant_utm.rb

@@ -18,6 +18,7 @@ module VagrantPlugins
       autoload :Version_4_5, lib_path.join("version_4_5") # rubocop:disable Naming/VariableNumber
       autoload :Version_4_6, lib_path.join("version_4_6") # rubocop:disable Naming/VariableNumber
       autoload :Version_4_7, lib_path.join("version_4_7") # rubocop:disable Naming/VariableNumber
+      autoload :Version_5_0, lib_path.join("version_5_0") # rubocop:disable Naming/VariableNumber
     end
 
     # Drop some autoloads for the model classes

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vagrant_utm
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.6
 platform: ruby
 authors:
 - Naveenraj M
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-10-11 00:00:00.000000000 Z
+date: 2026-08-14 00:00:00.000000000 Z
 dependencies: []
 description: Vagrant UTM provider that allows you to manage UTM virtual machines.
 email:
@@ -104,6 +104,7 @@ files:
 - lib/vagrant_utm/driver/version_4_5.rb
 - lib/vagrant_utm/driver/version_4_6.rb
 - lib/vagrant_utm/driver/version_4_7.rb
+- lib/vagrant_utm/driver/version_5_0.rb
 - lib/vagrant_utm/errors.rb
 - lib/vagrant_utm/model/forwarded_port.rb
 - lib/vagrant_utm/model/list_result.rb