ruby-jss 1.2.10 → 1.3.2

data/lib/jss/api_object/printer.rb

@@ -0,0 +1,440 @@
+module JSS
+    ### Module Constants
+    #####################################
+
+    ### Module Variables
+    #####################################
+
+    ### Module Methods
+    #####################################
+
+    ### Classes
+    #####################################
+
+    ### Printer object inside JSS
+    ###
+    ### @see JSS::APIObject
+    class Printer < JSS::APIObject
+        ## Mix-Ins
+        #####################################
+        include JSS::Creatable
+        include JSS::Updatable
+        include JSS::Categorizable
+
+        ## Class Constants
+        #####################################
+
+        ### The base for REST resources of this class
+        RSRC_BASE = 'printers'.freeze
+
+        ### the hash key used for the JSON list output of all objects in the JSS
+        RSRC_LIST_KEY = :printers
+
+        ### The hash key used for the JSON object output
+        ### It's also used in various error messages
+        RSRC_OBJECT_KEY = :printer
+
+        # Where is the Category in the API JSON?
+        CATEGORY_SUBSET = :top
+
+        # How is the category stored in the API data?
+        CATEGORY_DATA_TYPE = String
+
+        ## Attributes
+        #####################################
+
+        ### @return [String] The URI path for the specific printer.
+        attr_reader :uri
+
+        ### @return [String] The CUPs name to be used
+        attr_reader :CUPS_name
+
+        ### @return [String] The physical location of the printer.
+        attr_reader :location
+
+        ### @return [String] The specific model of printer.
+        attr_reader :model
+
+        ### @return [Boolean] Is this printer to be shared?
+        attr_reader :shared
+
+        ### @return [String] Information for this specific printer.
+        attr_reader :info
+
+        ### @return [String] Notes for this specific printer.
+        attr_reader :notes
+
+        ### @return [Boolean] Make this printer as the default printer upon installation.
+        attr_reader :make_default
+
+        ### @return [Boolean] Use a generic PPD.
+        attr_reader :use_generic
+
+        ### @return [String] The PPD file name.
+        attr_reader :ppd
+
+        ### @return [String] The contents of the PPD file.
+        attr_reader :ppd_contents
+
+        ### @return [String] The path the PPD file will be installed.
+        attr_reader :ppd_path
+
+        ### @return [String] The OS version requirements seperated by commas
+        attr_reader :os_requirements
+
+        ## Constructor
+        #####################################
+
+        ###
+        def initialize(args = {})
+            super args
+
+            if self.in_jss?
+
+                @uri = @init_data[:uri]
+                @CUPS_name = @init_data[:CUPS_name]
+                @location = @init_data[:location]
+                @model = @init_data[:model]
+                @shared = @init_data[:shared]
+                @info = @init_data[:info]
+                @notes = @init_data[:notes]
+                @make_default = @init_data[:make_default]
+                @use_generic = @init_data[:use_generic]
+                @ppd = @init_data[:ppd]
+                @ppd_contents = @init_data[:ppd_contents]
+                @ppd_path = @init_data[:ppd_path]
+                @os_requirements = @init_data[:os_requirements]
+            else
+
+                raise JSS::MissingDataError, "CUPS_name must be provided." unless !@init_data[:CUPS_name].nil?
+                raise JSS::MissingDataError, "uri must be provided." unless !@init_data[:uri].nil?
+
+                raise JSS::InvalidDataError, "uri must be a String." unless @init_data[:uri].is_a?(String) || @init_data[:uri].nil?
+                raise JSS::InvalidDataError, "CUPS_name must be a String." unless @init_data[:CUPS_name].is_a?(String)
+                raise JSS::InvalidDataError, "location must be a String." unless @init_data[:location].is_a?(String) || @init_data[:location].nil?
+                raise JSS::InvalidDataError, "model must be a String." unless @init_data[:model].is_a?(String) || @init_data[:model].nil?
+                raise JSS::InvalidDataError, "info must be a String." unless @init_data[:info].is_a?(String) || @init_data[:info].nil?
+                raise JSS::InvalidDataError, "notes must be a String." unless @init_data[:notes].is_a?(String) || @init_data[:notes].nil?
+                raise JSS::InvalidDataError, "ppd must be a String." unless @init_data[:ppd].is_a?(String) || @init_data[:ppd].nil?
+                raise JSS::InvalidDataError, "ppd_contents must be a String." unless @init_data[:ppd_contents].is_a?(String) || @init_data[:ppd_contents].nil?
+                raise JSS::InvalidDataError, "ppd_path must be a String." unless @init_data[:ppd_path].is_a?(String) || @init_data[:ppd_path].nil?
+                raise JSS::InvalidDataError, "os_requirements must be a String." unless @init_data[:os_requirements].is_a?(String) || @init_data[:os_requirements].nil?
+                raise JSS::InvalidDataError, "shared must be a String." unless (@init_data[:shared].is_a?(TrueClass) || @init_data[:shared].is_a?(FalseClass)) || @init_data[:shared].nil?
+                raise JSS::InvalidDataError, "make_default must be a String." unless (@init_data[:make_default].is_a?(TrueClass) || @init_data[:make_default].is_a?(FalseClass)) || @init_data[:make_default].nil?
+                raise JSS::InvalidDataError, "use_generic must be a String." unless (@init_data[:use_generic].is_a?(TrueClass) || @init_data[:use_generic].is_a?(FalseClass)) || @init_data[:use_generic].nil?
+
+                @uri = @init_data[:uri]
+                @CUPS_name = @init_data[:CUPS_name]
+                @location = @init_data[:location]
+                @model = @init_data[:model]
+                @shared = @init_data[:shared]
+                @info = @init_data[:info]
+                @notes = @init_data[:notes]
+                @make_default = @init_data[:make_default]
+                @use_generic = @init_data[:use_generic]
+                @ppd = @init_data[:ppd]
+                @ppd_contents = @init_data[:ppd_contents]
+                @ppd_path = @init_data[:ppd_path]
+                @os_requirements = @init_data[:os_requirements]
+            end
+        end
+
+
+        ## Class Methods
+        #####################################
+
+
+        # The URI path for the specific printer.
+        #
+        # @author Tyler Morgan
+        #
+        # @param newvalue [String]
+        #
+        # @raise [JSS::InvalidDataError] If newvalue is not a String
+        #
+        # @return [void]
+        def uri=(newvalue)
+
+            raise JSS::InvalidDataError, "URI must be a string." unless newvalue.is_a? String
+
+            @uri = newvalue
+
+            @need_to_update = true
+        end
+
+
+        # The CUPs name to be used
+        #
+        # @author Tyler Morgan
+        #
+        # @param newvalue [String]
+        #
+        # @raise [JSS::InvalidDataError] If newvalue is not a String
+        #
+        # @return [void]
+        def CUPS_name=(newvalue)
+
+            raise JSS::InvalidDataError, "CUPS_name must be a string." unless newvalue.is_a? String
+
+            @CUPS_name = newvalue
+
+            @need_to_update = true
+        end
+
+
+        # The physical location of the printer.
+        #
+        # @author Tyler Morgan
+        #
+        # @param newvalue [String]
+        #
+        # @raise [JSS::InvalidDataError] If newvalue is not a String
+        #
+        # @return [void]
+        def location=(newvalue)
+
+            raise JSS::InvalidDataError, "location must be a string." unless newvalue.is_a? String
+
+            @location = newvalue
+
+            @need_to_update = true
+        end
+
+
+        # The specific model of printer.
+        #
+        # @author Tyler Morgan
+        #
+        # @param newvalue [String]
+        #
+        # @raise [JSS::InvalidDataError] If newvalue is not a String
+        #
+        # @return [void]
+        def model=(newvalue)
+
+            raise JSS::InvalidDataError, "model must be a string." unless newvalue.is_a? String
+
+            @model = newvalue
+
+            @need_to_update = true
+        end
+
+
+        # Is this printer to be shared?
+        #
+        # @author Tyler Morgan
+        #
+        # @param newvalue [Boolean]
+        #
+        # @raise [JSS::InvalidDataError] If newvalue is not a Boolean
+        #
+        # @return [void]
+        def shared=(newvalue)
+
+            raise JSS::InvalidDataError, "shared must be a string." unless newvalue.is_a?(TrueClass) || newvalue.is_a?(FalseClass)
+
+            @shared = newvalue
+
+            @need_to_update = true
+        end
+
+
+        # Information for this specific printer.
+        #
+        # @author Tyler Morgan
+        #
+        # @param newvalue [String]
+        #
+        # @raise [JSS::InvalidDataError] If newvalue is not a String
+        #
+        # @return [void]
+        def info=(newvalue)
+
+            raise JSS::InvalidDataError, "info must be a string." unless newvalue.is_a? String
+
+            @info = newvalue
+
+            @need_to_update = true
+        end
+
+
+        # Notes for this specific printer.
+        #
+        # @author Tyler Morgan
+        #
+        # @param newvalue [String]
+        #
+        # @raise [JSS::InvalidDataError] If newvalue is not a String
+        #
+        # @return [void]
+        def notes=(newvalue)
+
+            raise JSS::InvalidDataError, "notes must be a string." unless newvalue.is_a? String
+
+            @notes = newvalue
+
+            @need_to_update = true
+        end
+
+
+        # Make this printer as the default printer upon installation.
+        #
+        # @author Tyler Morgan
+        #
+        # @param newvalue [Boolean]
+        #
+        # @raise [JSS::InvalidDataError] If newvalue is not a Boolean
+        #
+        # @return [void]
+        def make_default=(newvalue)
+
+            raise JSS::InvalidDataError, "make_default must be a string." unless newvalue.is_a?(TrueClass) || newvalue.is_a?(FalseClass)
+
+            @make_default = newvalue
+
+            @need_to_update = true
+        end
+
+
+        # Use a generic PPD.
+        #
+        # @author Tyler Morgan
+        #
+        # @param newvalue [Boolean]
+        #
+        # @raise [JSS::InvalidDataError] If newvalue is not a Boolean
+        #
+        # @return [void]
+        def use_generic=(newvalue)
+
+            raise JSS::InvalidDataError, "use_generic must be a string." unless newvalue.is_a?(TrueClass) || newvalue.is_a?(FalseClass)
+
+            @use_generic = newvalue
+
+            @need_to_update = true
+        end
+
+
+        # The PPD file name.
+        #
+        # @author Tyler Morgan
+        #
+        # @param newvalue [String]
+        #
+        # @raise [JSS::InvalidDataError] If newvalue is not a String
+        #
+        # @return [void]
+        def ppd=(newvalue)
+
+            raise JSS::InvalidDataError, "ppd must be a string." unless newvalue.is_a? String
+
+            @ppd = newvalue
+
+            @need_to_update = true
+        end
+
+
+        # The contents of the PPD file.
+        #
+        # @author Tyler Morgan
+        #
+        # @param newvalue [String]
+        #
+        # @raise [JSS::InvalidDataError] If newvalue is not a String
+        #
+        # @return [void]
+        def ppd_contents=(newvalue)
+
+            raise JSS::InvalidDataError, "ppd_contents must be a string." unless newvalue.is_a? String
+
+            @ppd_contents = newvalue
+
+            @need_to_update = true
+        end
+
+
+        # The path the PPD file will be installed.
+        #
+        # @author Tyler Morgan
+        #
+        # @param newvalue [String]
+        #
+        # @raise [JSS::InvalidDataError] If newvalue is not a String
+        #
+        # @return [void]
+        def ppd_path=(newvalue)
+
+            raise JSS::InvalidDataError, "ppd_path must be a string." unless newvalue.is_a? String
+
+            @ppd_path = newvalue
+
+            @need_to_update = true
+        end
+
+
+        # The OS version requirements seperated by commas
+        #
+        # @author Tyler Morgan
+        #
+        # @param newvalue [String]
+        #
+        # @raise [JSS::InvalidDataError] If newvalue is not a String
+        #
+        # @example Limit Printer object to only High Sierra devices and Mojave 10.14.5 OS versions
+        #   printer.os_requirements = "10.13.x, 10.14.5"
+        #
+        # @return [void]
+        def os_requirements=(newvalue)
+
+            raise JSS::InvalidDataError, "os_requirements must be a string." unless newvalue.is_a? String
+
+            @os_requirements = newvalue
+
+            @need_to_update = true
+        end
+
+        # Remove the various large data
+        # from the instance_variables used to create
+        # pretty-print (pp) output.
+        #
+        # @return [Array] the desired instance_variables
+        #
+        def pretty_print_instance_variables
+          vars = super
+          vars.delete :@ppd_contents
+          vars
+        end
+
+
+        ## Private Instance Methods
+        #####################################
+        private
+
+        ### Return the xml for creating or updating this script in the JSS
+        ###
+        def rest_xml
+            doc = REXML::Document.new
+            printer = doc.add_element 'printer'
+
+            printer.add_element('id').text = @id
+            printer.add_element('name').text = @name
+            printer.add_element('uri').text = @uri
+            printer.add_element('CUPS_name').text = @CUPS_name
+            printer.add_element('location').text = @location
+            printer.add_element('model').text = @model
+            printer.add_element('shared').text = @shared
+            printer.add_element('info').text = @info
+            printer.add_element('notes').text = @notes
+            printer.add_element('make_default').text = @make_default
+            printer.add_element('use_generic').text = @use_generic
+            printer.add_element('ppd').text = @ppd
+            printer.add_element('ppd_contents').text = @ppd_contents
+            printer.add_element('ppd_path').text = @ppd_path
+            printer.add_element('os_requirements').text = @os_requirements
+            add_category_to_xml(doc)
+
+            doc.to_s
+
+        end
+    end
+end

data/lib/jss/api_object/scopable/scope.rb

@@ -392,7 +392,7 @@ module JSS
           @exclusions = {}
           @exclusion_keys.each { |k| @exclusions[k] = [] }
         end
-        @container&.should_update
+        @container.should_update if @container
       end
 
       # Replace a list of item names for as targets in this scope.
@@ -420,7 +420,7 @@ module JSS
         list.map! do |ident|
           item_id = validate_item(:target, key, ident)
 
-          if @exclusions[key]&.include?(item_id)
+          if @exclusions[key] && @exclusions[key].include?(item_id)
             raise JSS::AlreadyExistsError, \
                   "Can't set #{key} target to '#{ident}' because it's already an explicit exclusion."
           end
@@ -432,7 +432,7 @@ module JSS
 
         @inclusions[key] = list
         @all_targets = false
-        @container&.should_update
+        @container.should_update if @container
       end # sinclude_in_scope
       alias set_target set_targets
       alias set_inclusion set_targets
@@ -458,13 +458,13 @@ module JSS
       def add_target(key, item)
         key = pluralize_key(key)
         item_id = validate_item(:target, key, item)
-        return if @inclusions[key]&.include?(item_id)
+        return if @inclusions[key] && @exclusions[key].include?(item_id)
 
-        raise JSS::AlreadyExistsError, "Can't set #{key} target to '#{item}' because it's already an explicit exclusion." if @exclusions[key]&.include?(item_id)
+        raise JSS::AlreadyExistsError, "Can't set #{key} target to '#{item}' because it's already an explicit exclusion." if @exclusions[key] && @exclusions[key].include?(item_id)
 
         @inclusions[key] << item_id
         @all_targets = false
-        @container&.should_update
+        @container.should_update if @container
       end
       alias add_inclusion add_target
 
@@ -483,10 +483,10 @@ module JSS
         key = pluralize_key(key)
         item_id = validate_item :target, key, item, error_if_not_found: false
         return unless item_id
-        return unless @inclusions[key]&.include?(item_id)
+        return unless @inclusions[key] && @exclusions[key].include?(item_id)
 
         @inclusions[key].delete item_id
-        @container&.should_update
+        @container.should_update if @container
       end
       alias remove_inclusion remove_target
 
@@ -513,7 +513,7 @@ module JSS
         # check the idents
         list.map! do |ident|
           item_id = validate_item(:limitation, key, ident)
-          if @exclusions[key]&.include?(item_id)
+          if @exclusions[key] && @exclusions[key].include?(item_id)
             raise JSS::AlreadyExistsError, "Can't set #{key} limitation for '#{name}' because it's already an explicit exclusion."
           end
 
@@ -523,7 +523,7 @@ module JSS
         return nil if list.sort == @limitations[key].sort
 
         @limitations[key] = list
-        @container&.should_update
+        @container.should_update if @container
       end # set_limitation
       alias set_limitations set_limitation
 
@@ -545,14 +545,14 @@ module JSS
       def add_limitation(key, item)
         key = pluralize_key(key)
         item_id = validate_item(:limitation, key, item)
-        return nil if @limitations[key]&.include?(item_id)
+        return nil if @limitations[key] && @exclusions[key].include?(item_id)
 
-        if @exclusions[key]&.include?(item_id)
+        if @exclusions[key] && @exclusions[key].include?(item_id)
           raise JSS::AlreadyExistsError, "Can't set #{key} limitation for '#{name}' because it's already an explicit exclusion."
         end
 
         @limitations[key] << item_id
-        @container&.should_update
+        @container.should_update if @container
       end
 
       # Remove a single item for limiting this scope.
@@ -572,10 +572,10 @@ module JSS
         key = pluralize_key(key)
         item_id = validate_item :limitation, key, item, error_if_not_found: false
         return unless item_id
-        return unless @limitations[key]&.include?(item_id)
+        return unless @limitations[key] && @exclusions[key].include?(item_id)
 
         @limitations[key].delete item_id
-        @container&.should_update
+        @container.should_update if @container
       end ###
 
       # Replace an exclusion list for this scope
@@ -601,9 +601,9 @@ module JSS
           item_id = validate_item(:exclusion, key, ident)
           case key
           when *@inclusion_keys
-            raise JSS::AlreadyExistsError, "Can't exclude #{key} '#{ident}' because it's already explicitly included." if @inclusions[key]&.include?(item_id)
+            raise JSS::AlreadyExistsError, "Can't exclude #{key} '#{ident}' because it's already explicitly included." if @inclusions[key] && @exclusions[key].include?(item_id)
           when *LIMITATIONS
-            if @limitations[key]&.include?(item_id)
+            if @limitations[key] && @exclusions[key].include?(item_id)
               raise JSS::AlreadyExistsError, "Can't exclude #{key} '#{ident}' because it's already an explicit limitation."
             end
           end
@@ -613,7 +613,7 @@ module JSS
         return nil if list.sort == @exclusions[key].sort
 
         @exclusions[key] = list
-        @container&.should_update
+        @container.should_update if @container
       end # limit scope
 
       # Add a single item for exclusions of this scope.
@@ -632,14 +632,14 @@ module JSS
       def add_exclusion(key, item)
         key = pluralize_key(key)
         item_id = validate_item(:exclusion, key, item)
-        return if @exclusions[key]&.include?(item_id)
+        return if @exclusions[key] && @exclusions[key].include?(item_id)
 
-        raise JSS::AlreadyExistsError, "Can't exclude #{key} scope to '#{item}' because it's already explicitly included." if @inclusions[key]&.include?(item)
+        raise JSS::AlreadyExistsError, "Can't exclude #{key} scope to '#{item}' because it's already explicitly included." if @inclusions[key] && @inclusions[key].include?(item)
 
-        raise JSS::AlreadyExistsError, "Can't exclude #{key} '#{item}' because it's already an explicit limitation." if @limitations[key]&.include?(item)
+        raise JSS::AlreadyExistsError, "Can't exclude #{key} '#{item}' because it's already an explicit limitation." if @limitations[key] && @limitations[key].include?(item)
 
         @exclusions[key] << item_id
-        @container&.should_update
+        @container.should_update if @container
       end
 
       # Remove a single item for exclusions of this scope
@@ -656,10 +656,10 @@ module JSS
       def remove_exclusion(key, item)
         key = pluralize_key(key)
         item_id = validate_item :exclusion, key, item, error_if_not_found: false
-        return unless @exclusions[key]&.include?(item_id)
+        return unless @exclusions[key] && @exclusions[key].include?(item_id)
 
         @exclusions[key].delete item_id
-        @container&.should_update
+        @container.should_update if @container
       end
 
       # @api private