ruby-jss 2.0.0a10 → 2.0.0b3

data/lib/jamf/api/jamf_pro/oapi_schemas/v1_site.rb

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # This class may be used directly, e.g instances of other classes may
     # use instances of this class as one of their own properties/attributes.
@@ -60,7 +59,8 @@ module Jamf
     # Endpoints and Privileges:
     # API endpoints and HTTP operations that use this object
     # model, and the Jamf Pro privileges needed to access them.
-    #
+    #  - '/v1/sites:GET' needs permissions:
+    #    - Read Sites
     #
     #
     class V1Site < Jamf::OAPIObject

data/lib/jamf/api/jamf_pro/oapi_schemas/venafi_ca_record.rb

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # This class may be used directly, e.g instances of other classes may
     # use instances of this class as one of their own properties/attributes.

data/lib/jamf/api/jamf_pro/oapi_schemas/venafi_pki_payload_record.rb

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # This class may be used directly, e.g instances of other classes may
     # use instances of this class as one of their own properties/attributes.

data/lib/jamf/api/jamf_pro/oapi_schemas/venafi_pki_payload_record_search_results.rb

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # This class may be used directly, e.g instances of other classes may
     # use instances of this class as one of their own properties/attributes.

data/lib/jamf/api/jamf_pro/oapi_schemas/venafi_service_status.rb

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # This class may be used directly, e.g instances of other classes may
     # use instances of this class as one of their own properties/attributes.

data/lib/jamf/api/jamf_pro/oapi_schemas/verbose_package_deployment_response.rb

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # This class may be used directly, e.g instances of other classes may
     # use instances of this class as one of their own properties/attributes.

data/lib/jamf/api/jamf_pro/oapi_schemas/voice_roaming_setting.rb

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # This class may be used directly, e.g instances of other classes may
     # use instances of this class as one of their own properties/attributes.

data/lib/jamf/api/jamf_pro/oapi_schemas/volume_purchasing_content.rb

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # This class may be used directly, e.g instances of other classes may
     # use instances of this class as one of their own properties/attributes.

data/lib/jamf/api/jamf_pro/oapi_schemas/volume_purchasing_location.rb

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # This class may be used directly, e.g instances of other classes may
     # use instances of this class as one of their own properties/attributes.

data/lib/jamf/api/jamf_pro/oapi_schemas/volume_purchasing_location_list_view.rb

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # This class may be used directly, e.g instances of other classes may
     # use instances of this class as one of their own properties/attributes.

data/lib/jamf/api/jamf_pro/oapi_schemas/volume_purchasing_location_patch.rb

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # This class may be used directly, e.g instances of other classes may
     # use instances of this class as one of their own properties/attributes.

data/lib/jamf/api/jamf_pro/oapi_schemas/volume_purchasing_location_post.rb

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # This class may be used directly, e.g instances of other classes may
     # use instances of this class as one of their own properties/attributes.

data/lib/jamf/api/jamf_pro/oapi_schemas/volume_purchasing_locations.rb

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # This class may be used directly, e.g instances of other classes may
     # use instances of this class as one of their own properties/attributes.

data/lib/jamf/api/jamf_pro/oapi_schemas/volume_purchasing_subscription.rb

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # This class may be used directly, e.g instances of other classes may
     # use instances of this class as one of their own properties/attributes.

data/lib/jamf/api/jamf_pro/oapi_schemas/volume_purchasing_subscription_base.rb

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # This class may be used directly, e.g instances of other classes may
     # use instances of this class as one of their own properties/attributes.

data/lib/jamf/api/jamf_pro/oapi_schemas/volume_purchasing_subscriptions.rb

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # This class may be used directly, e.g instances of other classes may
     # use instances of this class as one of their own properties/attributes.

data/lib/jamf/api/jamf_pro/oapi_schemas/vpp_admin_account.rb

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # This class may be used directly, e.g instances of other classes may
     # use instances of this class as one of their own properties/attributes.

data/lib/jamf/api/jamf_pro/oapi_schemas/vpp_token_subscription.rb

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # This class may be used directly, e.g instances of other classes may
     # use instances of this class as one of their own properties/attributes.

data/lib/jamf/api/jamf_pro/oapi_schemas/web_link.rb

@@ -20,7 +20,6 @@
 #    KIND, either express or implied. See the Apache License for the specific
 #    language governing permissions and limitations under the Apache License.
 #
-#
 
 
 module Jamf
@@ -36,7 +35,7 @@ module Jamf
     #
     #
     # This class was automatically genereated from the api/schema
-    # URL path on a Jamf Pro server version 10.36.1-t1645562643
+    # URL path on a Jamf Pro server version 10.40.0-t1657115323
     #
     # This class may be used directly, e.g instances of other classes may
     # use instances of this class as one of their own properties/attributes.

data/lib/jamf/client/jamf_binary.rb

@@ -28,22 +28,11 @@ module Jamf
   class Client
 
     # Module for working with the Jamf Binary on a managed client mac
-    # This should be extended into Jamf::Client
+    # This should be included into Jamf::Client
     module JamfBinary
 
-      # The bin folder with the jamf binary and a few other things
-      USR_LOCAL_BIN_FOLDER = Pathname.new '/usr/local/jamf/bin'
-
-      # The Pathname to the jamf binary executable
-      # Before SIP (macOS 10.10 and below)
-      ORIG_JAMF_BINARY = Pathname.new '/usr/sbin/jamf'
-
-      # The Pathname to the jamf binary executable
-      # After SIP (OS X 10.11 and above)
-      SIP_JAMF_BINARY = USR_LOCAL_BIN_FOLDER + 'jamf'
-
       # The path to the jamf binary
-      JAMF_BINARY = SIP_JAMF_BINARY.executable? ? SIP_JAMF_BINARY : ORIG_JAMF_BINARY
+      JAMF_BINARY = Pathname.new '/usr/local/jamf/bin/jamf'
 
       # These jamf commands don't need root privs (most do)
       ROOTLESS_JAMF_COMMANDS = %i[
@@ -59,77 +48,87 @@ module Jamf
       # the option that makes the jamf binary verbose
       JAMF_VERBOSE_OPT = ' -verbose'.freeze
 
+      # when this module is included, also extend our Class Methods
+      def self.included(includer)
+        Jamf.load_msg "--> #{includer} is including Jamf::Client::JamfBinary"
+        includer.extend(ClassMethods)
+      end
+
       # class Methods
       #####################################
 
-      # Run an arbitrary jamf binary command.
-      #
-      # @note Most jamf commands require superuser/root privileges.
-      #
-      # @param command[String,Symbol] the jamf binary command to run
-      #   The command is the single jamf command that comes after the/usr/bin/jamf.
-      #
-      # @param args[String,Array] the arguments passed to the jamf command.
-      #   This is to be passed to Kernel.` (backtick), after being combined with the
-      #   jamf binary and the jamf command
-      #
-      # @param verbose[Boolean] Should the stdout & stderr of the jamf binary be sent to
-      #  the current stdout in realtime, as well as returned as a string?
-      #
-      # @return [String] the stdout & stderr of the jamf binary.
-      #
-      # @example
-      #   These two are equivalent:
-      #
-      #     Jamf::Client.run_jamf "recon", "-assetTag 12345 -department 'IT Support'"
-      #
-      #     Jamf::Client.run_jamf :recon, ['-assetTag', '12345', '-department', 'IT Support'"]
-      #
-      #
-      # The details of the Process::Status for the jamf binary process can be
-      # captured from $CHILD_STATUS immediately after calling. (See Process::Status)
-      #
-      def run_jamf(command, args = nil, verbose = false)
-        raise Jamf::UnmanagedError, 'The jamf binary is not installed on this computer.' unless installed?
-        unless ROOTLESS_JAMF_COMMANDS.include?(command.to_sym) || JSS.superuser?
-          raise Jamf::UnsupportedError, 'You must have root privileges to run that jamf binary command'
-        end
+      module ClassMethods
+
+        # Run an arbitrary jamf binary command.
+        #
+        # @note Most jamf commands require superuser/root privileges.
+        #
+        # @param command[String,Symbol] the jamf binary command to run
+        #   The command is the single jamf command that comes after the/usr/bin/jamf.
+        #
+        # @param args[String,Array] the arguments passed to the jamf command.
+        #   This is to be passed to Kernel.` (backtick), after being combined with the
+        #   jamf binary and the jamf command
+        #
+        # @param verbose[Boolean] Should the stdout & stderr of the jamf binary be sent to
+        #  the current stdout in realtime, as well as returned as a string?
+        #
+        # @return [String] the stdout & stderr of the jamf binary.
+        #
+        # @example
+        #   These two are equivalent:
+        #
+        #     Jamf::Client.run_jamf "recon", "-assetTag 12345 -department 'IT Support'"
+        #
+        #     Jamf::Client.run_jamf :recon, ['-assetTag', '12345', '-department', 'IT Support'"]
+        #
+        #
+        # The details of the Process::Status for the jamf binary process can be
+        # captured from $CHILD_STATUS immediately after calling. (See Process::Status)
+        #
+        def run_jamf(command, args = nil, verbose = false)
+          raise Jamf::UnmanagedError, 'The jamf binary is not installed on this computer.' unless installed?
+          unless ROOTLESS_JAMF_COMMANDS.include?(command.to_sym) || JSS.superuser?
+            raise Jamf::UnsupportedError, 'You must have root privileges to run that jamf binary command'
+          end
 
-        cmd = build_jamf_command command, args
-        cmd += " #{JAMF_VERBOSE_OPT}" if verbose && !cmd.include?(JAMF_VERBOSE_OPT)
-        execute_jamf cmd, verbose
-      end # run_jamf
-
-      #####
-      def build_jamf_command(command, args)
-        case args
-        when nil
-          "#{JAMF_BINARY} #{command}"
-        when String
-          "#{JAMF_BINARY} #{command} #{args}"
-        when Array
-          ([JAMF_BINARY.to_s, command] + args).join(' ')
-        else
-          raise Jamf::InvalidDataError, 'args must be a String or Array of Strings'
-        end # case
-      end
+          cmd = build_jamf_command command, args
+          cmd += " #{JAMF_VERBOSE_OPT}" if verbose && !cmd.include?(JAMF_VERBOSE_OPT)
+          execute_jamf cmd, verbose
+        end # run_jamf
+
+        #####
+        def build_jamf_command(command, args)
+          case args
+          when nil
+            "#{JAMF_BINARY} #{command}"
+          when String
+            "#{JAMF_BINARY} #{command} #{args}"
+          when Array
+            ([JAMF_BINARY.to_s, command] + args).join(' ')
+          else
+            raise Jamf::InvalidDataError, 'args must be a String or Array of Strings'
+          end # case
+        end
 
-      ######
-      def execute_jamf(cmd, verbose)
-        puts "Running: #{cmd}" if verbose
-        output = ''
-        IO.popen("#{cmd} 2>&1") do |proc|
-          loop do
-            line = proc.gets
-            break unless line
-
-            output << line
-            puts line if verbose
+        ######
+        def execute_jamf(cmd, verbose)
+          puts "Running: #{cmd}" if verbose
+          output = ''
+          IO.popen("#{cmd} 2>&1") do |proc|
+            loop do
+              line = proc.gets
+              break unless line
+
+              output << line
+              puts line if verbose
+            end
           end
+          output.force_encoding('UTF-8')
+          output
         end
-        output.force_encoding('UTF-8')
-        output
-      end
+
+      end # ClassMethods
 
     end # module