ruby-jss 2.0.0a11 → 2.0.0b1

data/lib/jamf/client/management_action.rb

@@ -31,7 +31,7 @@ module Jamf
 
     #  Module for working with the Management Action.app, which is an interface
     # to the Notification Center
-    # This should be extended into Jamf::Client
+    # This should be included into Jamf::Client
     #####################################
     module ManagementAction
 
@@ -43,67 +43,77 @@ module Jamf
       # MGMT_ACTION_BUNDLE_ID = 'com.jamfsoftware.Management-Action'.freeze
       # HUP_NOTIF_CTR_CMD = '/usr/bin/killall sighup usernoted NotificationCenter'.freeze
 
+      # when this module is included, also extend our Class Methods
+      def self.included(includer)
+        Jamf.load_msg "--> #{includer} is including Jamf::Client::ManagementAction"
+        includer.extend(ClassMethods)
+      end
+
       # class Methods
       #####################################
 
-      def management_action(msg, title: nil, subtitle: nil, delay: 0)
-        raise Jamf::InvalidDataError, 'delay: must be a non-negative integer.' unless delay.is_a?(Integer) && delay > -1
+      module ClassMethods
 
-        cmd = Shellwords.escape MGMT_ACTION.to_s
-        cmd << " -message #{Shellwords.escape msg.to_s}"
-        cmd << " -title #{Shellwords.escape title.to_s}" if title
-        cmd << " -subtitle #{Shellwords.escape subtitle.to_s}" if subtitle
-        cmd << " -deliverydelay #{Shellwords.escape delay}" if delay > 0
-        `#{cmd} 2>&1`
-      end
-      alias nc_notify management_action
-
-      # Skipping all the force-alerts stuff until we figure out cleaner
-      # ways to do it in 10.13+
-      # The plan is to be able to make the NotificationCenter notification be an
-      # 'alert' (which stays visible til the user clicks) or a
-      # 'banner' (which vanishes in a few seconds), regardless of the user's
-      # setting in the NC prefs.
-
-      def force_alerts
-        orig_flags = {}
-        console_users.each do |user|
-          orig_flags[user] = set_mgmt_action_ncprefs_flags user, NC_ALERT_STYLE_FLAGS, hup: false
+        def management_action(msg, title: nil, subtitle: nil, delay: 0)
+          raise Jamf::InvalidDataError, 'delay: must be a non-negative integer.' unless delay.is_a?(Integer) && delay > -1
+
+          cmd = Shellwords.escape MGMT_ACTION.to_s
+          cmd << " -message #{Shellwords.escape msg.to_s}"
+          cmd << " -title #{Shellwords.escape title.to_s}" if title
+          cmd << " -subtitle #{Shellwords.escape subtitle.to_s}" if subtitle
+          cmd << " -deliverydelay #{Shellwords.escape delay}" if delay > 0
+          `#{cmd} 2>&1`
+        end
+        alias nc_notify management_action
+
+        # Skipping all the force-alerts stuff until we figure out cleaner
+        # ways to do it in 10.13+
+        # The plan is to be able to make the NotificationCenter notification be an
+        # 'alert' (which stays visible til the user clicks) or a
+        # 'banner' (which vanishes in a few seconds), regardless of the user's
+        # setting in the NC prefs.
+
+        def force_alerts
+          orig_flags = {}
+          console_users.each do |user|
+            orig_flags[user] = set_mgmt_action_ncprefs_flags user, NC_ALERT_STYLE_FLAGS, hup: false
+          end
+          system HUP_NOTIF_CTR_CMD unless orig_flags.empty?
+          sleep 1
+          orig_flags
         end
-        system HUP_NOTIF_CTR_CMD unless orig_flags.empty?
-        sleep 1
-        orig_flags
-      end
 
-      def restore_alerts(orig_flags)
-        orig_flags.each do |user, flags|
-          set_mgmt_action_ncprefs_flags user, flags, hup: false
+        def restore_alerts(orig_flags)
+          orig_flags.each do |user, flags|
+            set_mgmt_action_ncprefs_flags user, flags, hup: false
+          end
+          system HUP_NOTIF_CTR_CMD unless orig_flags.empty?
         end
-        system HUP_NOTIF_CTR_CMD unless orig_flags.empty?
-      end
 
-      # set the NotificationCenter option flags for a user
-      # flags = an integer.
-      #
-      # Doesn't seem to work in 10.13, so ignore this for now.
-      #
-      # @return [Integer] the original flags, or given flags if no originals.
-      #
-      def set_mgmt_action_ncprefs_flags(user, flags, hup: true)
-        plist = Pathname.new "/Users/#{user}/Library/Preferences/#{NCPREFS_DOMAIN}.plist"
-        prefs = JSS.parse_plist plist
-        mgmt_action_setting = prefs['apps'].select { |a| a['bundle-id'] == MGMT_ACTION_BUNDLE_ID }.first
-        if mgmt_action_setting
-          orig_flags = mgmt_action_setting['flags']
-          mgmt_action_setting['flags'] = flags
-        else
-          orig_flags = flags
-          prefs['apps'] << { 'bundle-id' => MGMT_ACTION_BUNDLE_ID, 'flags' => flags }
+        # set the NotificationCenter option flags for a user
+        # flags = an integer.
+        #
+        # Doesn't seem to work in 10.13, so ignore this for now.
+        #
+        # @return [Integer] the original flags, or given flags if no originals.
+        #
+        def set_mgmt_action_ncprefs_flags(user, flags, hup: true)
+          plist = Pathname.new "/Users/#{user}/Library/Preferences/#{NCPREFS_DOMAIN}.plist"
+          prefs = JSS.parse_plist plist
+          mgmt_action_setting = prefs['apps'].select { |a| a['bundle-id'] == MGMT_ACTION_BUNDLE_ID }.first
+          if mgmt_action_setting
+            orig_flags = mgmt_action_setting['flags']
+            mgmt_action_setting['flags'] = flags
+          else
+            orig_flags = flags
+            prefs['apps'] << { 'bundle-id' => MGMT_ACTION_BUNDLE_ID, 'flags' => flags }
+          end
+          plist.open('w') { |f| f.write JSS.xml_plist_from(prefs) }
+          system HUP_NOTIF_CTR_CMD if hup
+          orig_flags
         end
-        plist.open('w') { |f| f.write JSS.xml_plist_from(prefs) }
-        system HUP_NOTIF_CTR_CMD if hup
-        orig_flags
-      end
+
+      end # ClassMethods
 
     end # moculde
 

data/lib/jamf/client.rb

@@ -64,9 +64,9 @@ module Jamf
     # the path to a users byhost folder from home
     USER_PREFS_BYHOST_FOLDER = 'Library/Preferences/ByHost/'.freeze
 
-    extend Jamf::Client::JamfBinary
-    extend Jamf::Client::JamfHelper
-    extend Jamf::Client::ManagementAction
+    include Jamf::Client::JamfBinary
+    include Jamf::Client::JamfHelper
+    include Jamf::Client::ManagementAction
 
     # Class Methods
     #####################################

data/lib/jamf/deprecations/deprecated_api_constant.rb

@@ -22,4 +22,6 @@
 #    language governing permissions and limitations under the Apache License.
 
 # @deprecated Use Jamf.cnx to access the module-wide default connection
-Jamf::API = Jamf.cnx
+module Jamf
+  API = Jamf.cnx
+end

data/lib/jamf/deprecations/deprecated_config_constant.rb

@@ -22,4 +22,6 @@
 #    language governing permissions and limitations under the Apache License.
 
 # @deprecated Use Jamf.config to access the module-wide config settings
-Jamf::CONFIG = Jamf.config
+module Jamf
+  CONFIG = Jamf.config
+end

data/lib/jamf/version.rb

@@ -27,6 +27,6 @@
 module Jamf
 
   ### The version of ruby-jss
-  VERSION = '2.0.0a11'.freeze
+  VERSION = '2.0.0b1'.freeze
 
 end # module

data/lib/zeitwerk_config.rb

@@ -86,10 +86,11 @@ def setup_zeitwerk_loader(loader)
   loader.inflector.inflect 'md_prestage_name' => 'MobileDevicePrestageName'
   loader.inflector.inflect 'md_prestage_names' => 'MobileDevicePrestageNames'
   loader.inflector.inflect 'md_prestage_skip_setup_items' => 'MobileDevicePrestageSkipSetupItems'
+  loader.inflector.inflect 'macos_managed_updates' => 'MacOSManagedUpdates'
 
   # deprecations, separated so they load only when used
-  loader.inflector.inflect("deprecated_api_constant" => "API")
-  loader.inflector.inflect("deprecated_config_constant" => "CONFIG")
+  loader.inflector.inflect('deprecated_api_constant' => 'API')
+  loader.inflector.inflect('deprecated_config_constant' => 'CONFIG')
 
   # These should be ignored, some will be required directly
   #####################################
@@ -134,7 +135,6 @@ def setup_zeitwerk_loader(loader)
       Jamf.load_msg "Parsed OAPI_PROPERTIES for #{value}" if parsed
     end
 
-
     # Generate the identifier list methods (.all_*) for subclasses of APIObject
     # in the Classic API
     if value.is_a?(Class) && value.superclass == Jamf::APIObject
@@ -158,6 +158,6 @@ def eager_load_for_testing
 
   @loader.eager_load(force: true)
   warn :loaded
-# rescue Zeitwerk::NameError => e
-#   warn e.message
+  # rescue Zeitwerk::NameError => e
+  #   warn e.message
 end

data/test/{README.md → README-TEST.md}

@@ -47,6 +47,9 @@ Want to test with a different version of ruby? Change the #! line of the `runtes
 
  - The individual tests are methods in classes defined in files in the 'tests' directory adjacent to this file.
  - In general, each class test a matching ruby-jss class, usually an APIObject (classic) or JPAPIResource (jamf pro).
+ - Shared code is in modules defined in the 'jamf_test' directory. See those files for more info. E.g.
+   - 'collection_tests.rb' defines common tests for all collection-resources
+   - 'prestage_tests.rb' defines common tests for 'computer_prestage' and 'mobile_device_prestage'
 
 **WARNING**: **DANGER DANGER** Be very careful about running these tests on your production Jamf Pro server!!!
 

data/test/bin/runtests

@@ -29,6 +29,40 @@ require 'pathname'
 require 'getoptlong'
 require 'ruby-jss'
 
+# Debug Trace support, Ideas from
+# https://gist.github.com/bendilley/1453a555e981ed533f68
+# and the other gist and stack overflow mentioned there.
+####################################
+
+# Enable tracing to help debug stack level too deep errors
+$do_tracing = false
+
+# set this to true to save the call traces to a file
+$save_trace = false
+
+# the file to hold the traces
+$trace_out = open('/tmp/ruby-jss-tests-trace.txt', 'w')
+
+# the max call-stack depth - adjust this to help catch and 
+# debug SystemStackError exceptions
+$trace_max_call_stack_depth = 1000
+
+# the tracing proc
+set_trace_func proc { |event, file, line, id, _binding, classname|
+  if $do_tracing
+    begin
+      if event == 'call'
+        $trace_out.puts "#{file}:#{line} #{classname}##{id}" if $save_trace 
+        raise 'MaxCallStackReached' if caller_locations.length > $trace_max_call_stack_depth
+      end
+    rescue => e
+      warn "ERROR: #{e.class}: #{e}"
+      e.backtrace.each { |l| warn "..#{l}" }
+      exit 1
+    end
+  end # if
+}
+
 # app
 class App
 
@@ -62,8 +96,8 @@ class App
     @testsdir = @appdir + 'tests'
 
     @tests_to_run = ARGV.dup
-    @tests_to_run = @testsdir.children.map { |c| c.basename.to_s }.sort if @tests_to_run .empty?
-    @tests_to_run.delete_if { |t| t.start_with? '.'}
+    @tests_to_run = @testsdir.children.map { |c| c.basename.to_s }.sort if @tests_to_run.empty?
+    @tests_to_run.delete_if { |t| t.start_with? '.' }
 
     @minitest_opts = ['--verbose']
 
@@ -126,6 +160,7 @@ class App
 
   ###################################
   def run_tests
+    puts
     JamfTest.say "Starting tests of ruby-jss v#{Jamf::VERSION}, using ruby version #{RUBY_VERSION}"
     JamfTest.say "API Connection: #{Jamf.cnx}; Server running Jamf Pro #{Jamf.cnx.jamf_version}"
 
@@ -158,6 +193,7 @@ class App
   ###################################
   def show_help
     return false unless @show_help
+
     puts <<-USAGEBLURB
 Usage: #{File.basename __FILE__} [options] [spec [spec ...]]
 
@@ -209,6 +245,10 @@ if $PROGRAM_NAME == __FILE__
     app = App.new
     app.run
     exit 0
+  rescue SystemStackError
+    puts $!
+    puts caller[0..100]
+    exit 1
   rescue => e
     puts "ERROR #{e.class}: #{e}"
     puts e.backtrace

data/test/lib/jamf_test/collection_tests.rb

@@ -176,11 +176,11 @@ module JamfTest
       say "Ran #{collection_class}.all_ids"
       validate_array ids, item_class: id_class
 
-
       identifiers.each do |ident|
         next if ident == :id
 
         mth = ident.to_s.end_with?('s') ? "all_#{ident}es" : "all_#{ident}s"
+        say "Testing #{collection_class}.#{mth}"
         collection_class.send mth
         say "Ran #{collection_class}.#{mth}"
       end
@@ -196,7 +196,6 @@ module JamfTest
       cached_ids = collection_class.all_ids cached_list: @cached_all
       say "Ran #{collection_class}.all_ids cached_list: @cached_all"
       validate_array cached_ids, item_class: id_class
-
     end
 
     #################
@@ -223,7 +222,6 @@ module JamfTest
 
       validate_hash ids_to_other
       validate_array ids_to_other.keys, item_class: id_class
-
     end
 
     ################
@@ -250,7 +248,6 @@ module JamfTest
 
       validate_hash ids_to_other
       validate_array ids_to_other.keys, item_class: id_class
-
     end
 
     ################
@@ -265,7 +262,9 @@ module JamfTest
       id, other = ids_to_other_ident.to_a.sample
 
       valid_id = collection_class.valid_id other
-      raise "#{collection_class} id #{id}, has #{other_ident} '#{other}', but calling .valid_id('#{other}') returned id: #{valid_id}" unless id.to_s == valid_id.to_s
+      unless id.to_s == valid_id.to_s
+        raise "#{collection_class} id #{id}, has #{other_ident} '#{other}', but calling .valid_id('#{other}') returned id: #{valid_id}"
+      end
 
       say "#{collection_class}.valid_id for #{other_ident} '#{other}' returned the correct id"
     end
@@ -284,13 +283,11 @@ module JamfTest
     ########### Object Tests
     ####################################
 
-
     # override this if the class requires more than 'name' with .create
     ################
     def create_new
       @unsaved_new_object = collection_class.create name: test_object_name
       say "Created new #{collection_class}, to be saved in Jamf."
-
     end
 
     # override this if your class can take more than 'name'

data/test/tests/building.rb

@@ -0,0 +1,41 @@
+### Copyright 2022 Pixar
+
+###
+###    Licensed under the Apache License, Version 2.0 (the "Apache License")
+###    with the following modification; you may not use this file except in
+###    compliance with the Apache License and the following modification to it:
+###    Section 6. Trademarks. is deleted and replaced with:
+###
+###    6. Trademarks. This License does not grant permission to use the trade
+###       names, trademarks, service marks, or product names of the Licensor
+###       and its affiliates, except as required to comply with Section 4(c) of
+###       the License and to reproduce the content of the NOTICE file.
+###
+###    You may obtain a copy of the Apache License at
+###
+###        http://www.apache.org/licenses/LICENSE-2.0
+###
+###    Unless required by applicable law or agreed to in writing, software
+###    distributed under the Apache License with the above modification is
+###    distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+###    KIND, either express or implied. See the Apache License for the specific
+###    language governing permissions and limitations under the Apache License.
+###
+###
+
+module JamfTest
+
+  class Building < JamfTest::APITest
+
+    include JamfTest::CollectionTests
+
+    COLLECTION_CLASS = Jamf::Building
+
+    # run the tests
+    def run_class_tests
+      run_collection_tests
+    end
+
+  end # class
+
+end # module JamfTest

data/test/tests/computer.rb

@@ -0,0 +1,41 @@
+### Copyright 2022 Pixar
+
+###
+###    Licensed under the Apache License, Version 2.0 (the "Apache License")
+###    with the following modification; you may not use this file except in
+###    compliance with the Apache License and the following modification to it:
+###    Section 6. Trademarks. is deleted and replaced with:
+###
+###    6. Trademarks. This License does not grant permission to use the trade
+###       names, trademarks, service marks, or product names of the Licensor
+###       and its affiliates, except as required to comply with Section 4(c) of
+###       the License and to reproduce the content of the NOTICE file.
+###
+###    You may obtain a copy of the Apache License at
+###
+###        http://www.apache.org/licenses/LICENSE-2.0
+###
+###    Unless required by applicable law or agreed to in writing, software
+###    distributed under the Apache License with the above modification is
+###    distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+###    KIND, either express or implied. See the Apache License for the specific
+###    language governing permissions and limitations under the Apache License.
+###
+###
+
+module JamfTest
+
+  class Computer < JamfTest::APITest
+
+    include JamfTest::CollectionTests
+
+    COLLECTION_CLASS = Jamf::Computer
+
+    # run the tests
+    def run_class_tests
+      run_collection_tests do_object_tests: false
+    end
+
+  end # class
+
+end # module JamfTest

data/test/tests/computer_group.rb

@@ -0,0 +1,132 @@
+### Copyright 2022 Pixar
+
+###
+###    Licensed under the Apache License, Version 2.0 (the "Apache License")
+###    with the following modification; you may not use this file except in
+###    compliance with the Apache License and the following modification to it:
+###    Section 6. Trademarks. is deleted and replaced with:
+###
+###    6. Trademarks. This License does not grant permission to use the trade
+###       names, trademarks, service marks, or product names of the Licensor
+###       and its affiliates, except as required to comply with Section 4(c) of
+###       the License and to reproduce the content of the NOTICE file.
+###
+###    You may obtain a copy of the Apache License at
+###
+###        http://www.apache.org/licenses/LICENSE-2.0
+###
+###    Unless required by applicable law or agreed to in writing, software
+###    distributed under the Apache License with the above modification is
+###    distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+###    KIND, either express or implied. See the Apache License for the specific
+###    language governing permissions and limitations under the Apache License.
+###
+###
+
+module JamfTest
+
+  class ComputerGroup < JamfTest::APITest
+
+    include JamfTest::CollectionTests
+
+    COLLECTION_CLASS = Jamf::ComputerGroup
+
+    # run the tests
+    def run_class_tests
+      run_collection_tests
+    end
+
+    #### Collection Test Overrides
+
+    ################
+    def create_new
+      @unsaved_new_object = collection_class.create name: test_object_name, type: :static
+      say "Created new Static #{collection_class}, to be saved in Jamf."
+    end
+
+    ################
+    def add_data_to_new
+      @all_comps_shuffled = Jamf::Computer.all.dup.shuffle
+      @comps_added_to_static_group = []
+
+      comp_1 = @all_comps_shuffled.shift
+      @unsaved_new_object.add_member comp_1[:id]
+      @comps_added_to_static_group << comp_1[:id]
+      say "Added computer id #{comp_1[:id]} to unsaved Static Group"
+
+      comp_2 = @all_comps_shuffled.shift
+      @unsaved_new_object.add_member comp_2[:name]
+      @comps_added_to_static_group << comp_2[:name]
+      say "Added computer name #{comp_2[:name]} to unsaved Static Group"
+
+      comp_3 = @all_comps_shuffled.shift
+      @unsaved_new_object.add_member comp_3[:serial_number]
+      @comps_added_to_static_group << comp_3[:serial_number]
+      say "Added computer serial_number #{comp_3[:serial_number]} to unsaved Static Group"
+
+      comp_4 = @all_comps_shuffled.shift
+      @unsaved_new_object.add_member comp_4[:udid]
+      @comps_added_to_static_group << comp_4[:udid]
+      say "Added computer udid #{comp_4[:udid]} to unsaved Static Group"
+
+      comp_5 = @all_comps_shuffled.shift
+      @unsaved_new_object.add_member comp_5[:mac_address]
+      @comps_added_to_static_group << comp_5[:mac_address]
+      say "Added computer mac_address #{comp_5[:mac_address]} to unsaved Static Group"
+    end
+
+    ################
+    def validate_fetched
+      super
+
+      unless @fetched_new_object.member_ids.sort == @unsaved_new_object.member_ids.sort
+        raise 'Original ruby object created with .create does not have the same member ids as the one re-fetched after saving!'
+      end
+
+      say "Fetched instance of #{collection_class} has the same members as the one we made with .create"
+    end
+
+    ################
+    def modify_fetched
+      super
+
+      @comps_added_to_static_group.shuffle!
+      3.times do
+        comp_to_remove = @comps_added_to_static_group.shift
+        @fetched_new_object.remove_member comp_to_remove
+        say "Removed member with identifier '#{comp_to_remove}'"
+      end      
+
+      @modified_member_ids = @fetched_new_object.member_ids
+    end
+
+    ################
+    def validate_changes
+      
+      unless @fetched_new_object.member_ids.sort == @fetched_edited_object.member_ids.sort
+        raise 'Modified ruby object saved after editing does not have the same member ids as the one originally saved!'
+      end
+
+      say "Modified/saved/refetched instance of #{collection_class} has correct membership."
+
+      # Test the class method for changing membership without instantiating/saving
+      adds = []
+      adds << @all_comps_shuffled.shift[:id]
+      adds << @all_comps_shuffled.shift[:serial_number]
+      adds << @all_comps_shuffled.shift[:udid]
+      removes = @fetched_edited_object.member_ids.sample
+
+      collection_class.change_membership @fetched_edited_object.id, add_members: adds, remove_members: removes 
+      say "Successfully used #{collection_class}.change_membership to immediately add and remove members."
+    end
+
+    ################
+    def confirm_deleted
+      say 'Pausing 15 secs for group deletion to complete...'
+      sleep 15
+      super
+    end
+
+  end # class ComputerGroup
+
+end # module JamfTest

data/test/tests/department.rb

@@ -0,0 +1,41 @@
+### Copyright 2022 Pixar
+
+###
+###    Licensed under the Apache License, Version 2.0 (the "Apache License")
+###    with the following modification; you may not use this file except in
+###    compliance with the Apache License and the following modification to it:
+###    Section 6. Trademarks. is deleted and replaced with:
+###
+###    6. Trademarks. This License does not grant permission to use the trade
+###       names, trademarks, service marks, or product names of the Licensor
+###       and its affiliates, except as required to comply with Section 4(c) of
+###       the License and to reproduce the content of the NOTICE file.
+###
+###    You may obtain a copy of the Apache License at
+###
+###        http://www.apache.org/licenses/LICENSE-2.0
+###
+###    Unless required by applicable law or agreed to in writing, software
+###    distributed under the Apache License with the above modification is
+###    distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+###    KIND, either express or implied. See the Apache License for the specific
+###    language governing permissions and limitations under the Apache License.
+###
+###
+
+module JamfTest
+
+  class Department < JamfTest::APITest
+
+    include JamfTest::CollectionTests
+
+    COLLECTION_CLASS = Jamf::Department
+
+    # run the tests
+    def run_class_tests
+      run_collection_tests
+    end
+
+  end # class
+
+end # module JamfTest

data/test/tests/mobile_device.rb

@@ -0,0 +1,41 @@
+### Copyright 2022 Pixar
+
+###
+###    Licensed under the Apache License, Version 2.0 (the "Apache License")
+###    with the following modification; you may not use this file except in
+###    compliance with the Apache License and the following modification to it:
+###    Section 6. Trademarks. is deleted and replaced with:
+###
+###    6. Trademarks. This License does not grant permission to use the trade
+###       names, trademarks, service marks, or product names of the Licensor
+###       and its affiliates, except as required to comply with Section 4(c) of
+###       the License and to reproduce the content of the NOTICE file.
+###
+###    You may obtain a copy of the Apache License at
+###
+###        http://www.apache.org/licenses/LICENSE-2.0
+###
+###    Unless required by applicable law or agreed to in writing, software
+###    distributed under the Apache License with the above modification is
+###    distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+###    KIND, either express or implied. See the Apache License for the specific
+###    language governing permissions and limitations under the Apache License.
+###
+###
+
+module JamfTest
+
+  class MobileDevice < JamfTest::APITest
+
+    include JamfTest::CollectionTests
+
+    COLLECTION_CLASS = Jamf::MobileDevice
+
+    # run the tests
+    def run_class_tests
+      run_collection_tests do_object_tests: false
+    end
+
+  end # class
+
+end # module JamfTest