ruby-jss 4.1.1 → 4.2.0

data/lib/jamf/api/classic/api_objects/computer_invitation.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -139,7 +139,6 @@ module Jamf
       ssh_username: 'casper_remote',
       hide_account: 'true'
     })
-
       super args
 
       @name = @init_data[:invitation]
@@ -184,9 +183,7 @@ module Jamf
       obj = doc.add_element RSRC_OBJECT_KEY.to_s
       obj.add_element('invitation_type').text = invitation_type
       obj.add_element('create_account_if_does_not_exist').text = create_account_if_does_not_exist
-      if expiration_date_epoch
-        obj.add_element('expiration_date_epoch').text = expiration_date_epoch
-      end
+      obj.add_element('expiration_date_epoch').text = expiration_date_epoch if expiration_date_epoch
       obj.add_element('ssh_username').text = ssh_username
       obj.add_element('hide_account').text = hide_account
       obj.add_element('invitation_status').text = invitation_status

data/lib/jamf/api/classic/api_objects/creatable.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/classic/api_objects/criteriable/criteria.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -62,7 +62,7 @@ module Jamf
       #####################################
 
       ### Criterion instances we maintain need these attributes.s
-      CRITERION_ATTRIBUTES = [:priority, :and_or, :name, :search_type, :value].freeze
+      CRITERION_ATTRIBUTES = %i[priority and_or name search_type value].freeze
 
       #####################################
       ### Attributes
@@ -95,6 +95,7 @@ module Jamf
         unless new_criteria.is_a?(Array) && new_criteria.reject { |c| c.is_a?(Jamf::Criteriable::Criterion) }.empty?
           raise Jamf::InvalidDataError, 'Argument must be an Array of Jamf::Criteriable::Criterion instances.'
         end
+
         new_criteria.each { |nc| criterion_ok? nc }
         @criteria = new_criteria
         set_priorities
@@ -146,7 +147,7 @@ module Jamf
       ###
       ### @return [void]
       ###
-      def insert_criterion(priority, criterion)
+      def insert_criterion(_priority, criterion)
         criterion_ok? criterion
         @criteria.insert criterion[:priority], criterion
         set_priorities
@@ -163,6 +164,7 @@ module Jamf
       def delete_criterion(priority)
         if @criteria[priority]
           raise Jamf::MissingDataError, "Criteria can't be empty" if @criteria.count == 1
+
           @criteria.delete_at priority
           set_priorities
         end
@@ -182,6 +184,7 @@ module Jamf
       ###
       def set_criterion(priority, criterion)
         raise Jamf::NoSuchItemError, "No current criterion with priority '#{priority}'" unless @criteria[priority]
+
         criterion_ok? criterion
         @criteria[priority] = criterion
         set_priorities
@@ -240,6 +243,7 @@ module Jamf
         raise Jamf::InvalidDataError, "Missing :name for criterion: #{criterion.signature}" unless criterion.name
         raise Jamf::InvalidDataError, "Missing :search_type for criterion: #{criterion.signature}" unless criterion.search_type
         raise Jamf::InvalidDataError, "Missing :value for criterion: #{criterion.signature}" unless criterion.value
+
         true
       end
 

data/lib/jamf/api/classic/api_objects/criteriable/criterion.rb

@@ -1,4 +1,4 @@
-# Copyright 2023 Pixar
+# Copyright 2025 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -132,6 +132,7 @@ module Jamf
 
         if args[:search_type]
           raise Jamf::InvalidDataError, 'Invalid :search_type' unless SEARCH_TYPES.include? args[:search_type]
+
           @search_type = args[:search_type]
         end
 
@@ -190,6 +191,7 @@ module Jamf
       #
       def search_type=(new_val)
         raise Jamf::InvalidDataError, 'Invalid :search_type' unless SEARCH_TYPES.include? new_val
+
         @search_type = new_val
       end
 

data/lib/jamf/api/classic/api_objects/criteriable.rb

@@ -1,4 +1,4 @@
-# Copyright 2023 Pixar
+# Copyright 2025 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -187,6 +187,6 @@ module Jamf
       @need_to_update = true if @in_jss
     end
 
-    end # module Criteriable
+  end # module Criteriable
 
 end # module Jamf

data/lib/jamf/api/classic/api_objects/department.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -61,7 +61,7 @@ module Jamf
     #####################################
 
     ### The base for REST resources of this class
-    RSRC_BASE = "departments"
+    RSRC_BASE = 'departments'
 
     ### the hash key used for the JSON list output of all objects in the JSS
     RSRC_LIST_KEY = :departments

data/lib/jamf/api/classic/api_objects/distribution_point.rb

@@ -1,4 +1,4 @@
-# Copyright 2023 Pixar
+# Copyright 2025 Pixar
 
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
 #    with the following modification; you may not use this file except in
@@ -429,13 +429,14 @@ module Jamf
     def unmount
       return nil unless mounted?
 
-      if system "/sbin/umount '#{@mountpoint}'"
-        sleep 1 # the umount takes time.
-        @mountpoint.rmdir if @mountpoint.directory? && !@mountpoint.mountpoint?
-        @mounted = false
-      else
-        raise Jamf::FileServiceError, "There was a problem unmounting #{@mountpoint}"
-      end
+      raise Jamf::FileServiceError, "There was a problem unmounting #{@mountpoint}" unless system "/sbin/umount '#{@mountpoint}'"
+
+      sleep 1 # the umount takes time.
+      @mountpoint.rmdir if @mountpoint.directory? && !@mountpoint.mountpoint?
+      @mounted = false
+      
+        
+      
       nil
     end # unmount
 

data/lib/jamf/api/classic/api_objects/ebook.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -23,8 +23,6 @@
 ###
 ###
 
-
-#
 module Jamf
 
   # This is just a stub for now.

data/lib/jamf/api/classic/api_objects/extendable.rb

@@ -1,4 +1,4 @@
-# Copyright 2023 Pixar
+# Copyright 2025 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/classic/api_objects/ibeacon.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -67,7 +67,7 @@ module Jamf
     OBJECT_HISTORY_OBJECT_TYPE = 360
 
     # The major & minor values, if used, must be in this range
-    MAJOR_MINOR_RANGE = 0..65_535.freeze
+    MAJOR_MINOR_RANGE = 0..65_535
 
     # If not used, this is the value for the major and minor
     MAJOR_MINOR_UNUSED = -1
@@ -101,7 +101,6 @@ module Jamf
       @minor ||= MAJOR_MINOR_UNUSED
     end # init
 
-
     # Public Instance Methods
     #####################################
 
@@ -192,7 +191,6 @@ module Jamf
       doc.to_s
     end # rest_xml
 
-
   end # class ibeacon
 
 end # module

data/lib/jamf/api/classic/api_objects/icon.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -26,175 +26,175 @@
 ###
 module Jamf
 
-    # An Icon in the JSS, used in Self Service.
-    #
-    # At the moment, icons are not API objects, they are collections of data
-    # stored in the JSS that might be included in some API object's
-    # Self Service data.
-    #
-    # The data available for an icon are:
-    #
-    # - id: the icon's id in the JSS
-    # - name: the icon's non-unique name in the JSS
-    # - uri: the uri to download or preview the icon
-    # - data: the icon file itself, base-64 encoded.
-    #
-    # Icon instances are read-only. To change the icon for a self-servable object,
-    # see {SelfServable#icon=}.
-    #
-    # NOTE: Since icons are not APIObjects, there's no way to see a list of them
-    # via the API. The Jamf::Icon class methods .all, .all_ids, and .all_names
-    # require MySQL database access. See {Jamf::DBConnection}.
-    #
-    # This also means, if you use multiple API connections, you'll have to
-    # make sure to connect to the correct MySQL server for the
-    # APIConnection you care about.
-    #
-    class Icon
-
-      #  Class Methods
-      #####################################
-
-      # Return an Array of { id:, name: } Hashes for all icons known to the JSS
-      # Since Icon lists aren't accessible via the API, this method must
-      # query the SQL database directly, and will raise an exception if you
-      # aren't connected to the database.
-      #
-      # @param refresh[Boolean] re-read the data from the server?
-      #
-      # @return [Array<Hash>] The names and ids of all icons known to the JSS
-      #
-      def self.all(refresh = false)
-        @all_icons = nil if refresh
-        return @all_icons if @all_icons
-        @all_icons = []
-        qry = 'SELECT icon_id, filename FROM icons'
-        res = Jamf::DB_CNX.db.query qry
-        res.each_hash { |icon| @all_icons << { id: icon['icon_id'].to_i, name: icon['filename'] } }
-        @all_icons
-      end
+  # An Icon in the JSS, used in Self Service.
+  #
+  # At the moment, icons are not API objects, they are collections of data
+  # stored in the JSS that might be included in some API object's
+  # Self Service data.
+  #
+  # The data available for an icon are:
+  #
+  # - id: the icon's id in the JSS
+  # - name: the icon's non-unique name in the JSS
+  # - uri: the uri to download or preview the icon
+  # - data: the icon file itself, base-64 encoded.
+  #
+  # Icon instances are read-only. To change the icon for a self-servable object,
+  # see {SelfServable#icon=}.
+  #
+  # NOTE: Since icons are not APIObjects, there's no way to see a list of them
+  # via the API. The Jamf::Icon class methods .all, .all_ids, and .all_names
+  # require MySQL database access. See {Jamf::DBConnection}.
+  #
+  # This also means, if you use multiple API connections, you'll have to
+  # make sure to connect to the correct MySQL server for the
+  # APIConnection you care about.
+  #
+  class Icon
+
+    #  Class Methods
+    #####################################
+
+    # Return an Array of { id:, name: } Hashes for all icons known to the JSS
+    # Since Icon lists aren't accessible via the API, this method must
+    # query the SQL database directly, and will raise an exception if you
+    # aren't connected to the database.
+    #
+    # @param refresh[Boolean] re-read the data from the server?
+    #
+    # @return [Array<Hash>] The names and ids of all icons known to the JSS
+    #
+    def self.all(refresh = false)
+      @all_icons = nil if refresh
+      return @all_icons if @all_icons
+
+      @all_icons = []
+      qry = 'SELECT icon_id, filename FROM icons'
+      res = Jamf::DB_CNX.db.query qry
+      res.each_hash { |icon| @all_icons << { id: icon['icon_id'].to_i, name: icon['filename'] } }
+      @all_icons
+    end
+
+    # An Array of all icon ids known to the JSS.
+    # See {Icon.all}.
+    #
+    # @param refresh[Boolean] re-read the data from the server?
+    #
+    # @return [Array<Integer>] The ids of all icons known to the JSS
+    #
+    def self.all_ids(refresh = false)
+      all(refresh).map { |i| i[:id] }
+    end
 
-      # An Array of all icon ids known to the JSS.
-      # See {Icon.all}.
-      #
-      # @param refresh[Boolean] re-read the data from the server?
-      #
-      # @return [Array<Integer>] The ids of all icons known to the JSS
-      #
-      def self.all_ids(refresh = false)
-        all(refresh).map { |i| i[:id] }
-      end
+    # An Array of all icon names known to the JSS.
+    # See {Icon.all}.
+    # NOTE: Icon names are not unique
+    #
+    # @param refresh[Boolean] re-read the data from the server?
+    #
+    # @return [Array<Integer>] The names of all icons known to the JSS
+    #
+    def self.all_names(refresh = false)
+      all(refresh).map { |i| i[:name] }
+    end
 
-      # An Array of all icon names known to the JSS.
-      # See {Icon.all}.
-      # NOTE: Icon names are not unique
-      #
-      # @param refresh[Boolean] re-read the data from the server?
-      #
-      # @return [Array<Integer>] The names of all icons known to the JSS
-      #
-      def self.all_names(refresh = false)
-        all(refresh).map { |i| i[:name] }
-      end
+    #  Attributes
+    #####################################
 
-      #  Attributes
-      #####################################
-
-      # @return [Integer] the icon's id in the JSS
-      attr_reader :id
-
-      # @return [String] the icon's name in the JSS
-      #   NOTE: these are not unique
-      attr_reader :name
-      alias filename name
-
-      # @return [String] The URI for downloading or previewing the icon from the JSS
-      attr_reader :uri
-
-      # @return [String] The raw icon file.
-      attr_reader :data
-
-
-      #  Constructor
-      #####################################
-
-      # Set up a new Jamf::Icon instance
-      #
-      # @param icon_data[Hash] The :self_service_icon Hash from the :self_service
-      #   Hash of an object's API @init_data
-      #
-      # @return [Jamf::Icon] The new object
-      #
-      def initialize(icon_data)
-        return unless icon_data.is_a? Hash
-        @id = icon_data[:id]
-        @name = icon_data[:filename]
-        @uri = icon_data[:uri]
-        @data = icon_data[:data]
-
-        # if no :filename, its called :name
-        @name ||= icon_data[:name]
-
-        # if there's no id, as with MobileDeviceConfigurationProfile
-        # get it from the end of the uri if possible
-        if @uri && !@id
-          @id = Regexp.last_match(1).to_i if @uri =~ /(\d+)$/
-        end
-
-        # decode the icon data, or grab from
-        # the URI if needed
-        @data = Base64.decode64(@data) if @data
-        begin
-          @data ||= URI.parse(@uri).read if @uri
-        rescue
-          @data = nil
-        end
+    # @return [Integer] the icon's id in the JSS
+    attr_reader :id
 
-      end
+    # @return [String] the icon's name in the JSS
+    #   NOTE: these are not unique
+    attr_reader :name
+    alias filename name
 
-      # Instance Methods
-      #####################################
+    # @return [String] The URI for downloading or previewing the icon from the JSS
+    attr_reader :uri
 
-      # Open the icon's URL in the current user's browser
-      #
-      # @return [void]
-      #
-      def show_in_browser
-        return nil unless @uri
-        system "/usr/bin/open '#{@uri}'"
-      end
+    # @return [String] The raw icon file.
+    attr_reader :data
 
-      # Save the icon to a file.
-      #
-      # @param path[Pathname, String] The path to which the file should be saved.
-      # If the path given is an existing directory, the icon's current filename will
-      # be used, if known.
-      #
-      # @param overwrite[Boolean] Overwrite the file if it exists? Defaults to false
-      #
-      # @return [void]
-      #
-      def save(path, overwrite = false)
-        path = Pathname.new path
-        path = path + @name if path.directory? && @name
-
-        raise Jamf::AlreadyExistsError, "The file #{path} already exists" if path.exist? unless overwrite
-        path.delete if path.exist?
-        path.jss_save @data
-      end
+    #  Constructor
+    #####################################
 
-      # Remove the data  object from
-      # the instance_variables used to create
-      # pretty-print (pp) output.
-      #
-      # @return [Array] the desired instance_variables
-      #
-      def pretty_print_instance_variables
-        vars = instance_variables.sort
-        vars.delete :@data
-        vars
+    # Set up a new Jamf::Icon instance
+    #
+    # @param icon_data[Hash] The :self_service_icon Hash from the :self_service
+    #   Hash of an object's API @init_data
+    #
+    # @return [Jamf::Icon] The new object
+    #
+    def initialize(icon_data)
+      return unless icon_data.is_a? Hash
+
+      @id = icon_data[:id]
+      @name = icon_data[:filename]
+      @uri = icon_data[:uri]
+      @data = icon_data[:data]
+
+      # if no :filename, its called :name
+      @name ||= icon_data[:name]
+
+      # if there's no id, as with MobileDeviceConfigurationProfile
+      # get it from the end of the uri if possible
+      @id = Regexp.last_match(1).to_i if @uri && !@id && @uri =~ (/(\d+)$/)
+
+      # decode the icon data, or grab from
+      # the URI if needed
+      @data = Base64.decode64(@data) if @data
+      begin
+        @data ||= URI.parse(@uri).read if @uri
+      rescue
+        @data = nil
       end
+    end
+
+    # Instance Methods
+    #####################################
+
+    # Open the icon's URL in the current user's browser
+    #
+    # @return [void]
+    #
+    def show_in_browser
+      return nil unless @uri
+
+      system "/usr/bin/open '#{@uri}'"
+    end
+
+    # Save the icon to a file.
+    #
+    # @param path[Pathname, String] The path to which the file should be saved.
+    # If the path given is an existing directory, the icon's current filename will
+    # be used, if known.
+    #
+    # @param overwrite[Boolean] Overwrite the file if it exists? Defaults to false
+    #
+    # @return [void]
+    #
+    def save(path, overwrite = false)
+      path = Pathname.new path
+      path += @name if path.directory? && @name
+
+      raise Jamf::AlreadyExistsError, "The file #{path} already exists" if !overwrite && path.exist?
+
+      path.delete if path.exist?
+      path.jss_save @data
+    end
+
+    # Remove the data  object from
+    # the instance_variables used to create
+    # pretty-print (pp) output.
+    #
+    # @return [Array] the desired instance_variables
+    #
+    def pretty_print_instance_variables
+      vars = instance_variables.sort
+      vars.delete :@data
+      vars
+    end
 
-    end # class icon
+  end # class icon
 
 end # module

data/lib/jamf/api/classic/api_objects/ldap_server.rb

@@ -1,4 +1,4 @@
-# Copyright 2023 Pixar
+# Copyright 2025 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/classic/api_objects/locatable.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -158,7 +158,7 @@ module Jamf
 
       new_val = new_val.to_s.strip
       unless new_val.empty? or Jamf::Building.all_names(cnx: @cnx).include? new_val
-        raise Jamf::NoSuchItemError, 
+        raise Jamf::NoSuchItemError,
               "No building named #{new_val} exists in the JSS"
       end
 
@@ -172,7 +172,7 @@ module Jamf
 
       new_val = new_val.to_s.strip
       unless new_val.empty? or Jamf::Department.all_names(cnx: @cnx).include? new_val
-        raise Jamf::NoSuchItemError, 
+        raise Jamf::NoSuchItemError,
               "No department named #{new_val} exists in the JSS"
       end
 

data/lib/jamf/api/classic/api_objects/mac_application.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -146,7 +146,6 @@ module Jamf
       add_vpp_xml doc
 
       doc.to_s
-
     end
 
   end # class MacApplication

data/lib/jamf/api/classic/api_objects/management_history/audit_event.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/classic/api_objects/management_history/casper_imaging_log.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/classic/api_objects/management_history/casper_remote_log.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/classic/api_objects/management_history/computer_usage_log.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/classic/api_objects/management_history/ebook.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/classic/api_objects/management_history/hash_like.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -22,10 +22,8 @@
 ###    language governing permissions and limitations under the Apache License.
 ###
 
-#
 module Jamf
 
-  #
   module ManagementHistory
 
     # This is mixed in to the history event classes to

data/lib/jamf/api/classic/api_objects/management_history/mac_app_store_app.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")