ruby-jss 2.0.0b1 → 2.0.0rc1

data/lib/jamf/api/jamf_pro/mixins/collection_resource.rb

@@ -24,6 +24,7 @@
 #
 
 module Jamf
+
   # A Collection Resource in Jamf Pro
   #
   # See {Jamf::Resource} for general info about API resources.
@@ -60,6 +61,7 @@ module Jamf
   # @abstract
   ######################################
   module CollectionResource
+
     include Jamf::JPAPIResource
 
     # when this module is included, also extend our Class Methods
@@ -71,6 +73,7 @@ module Jamf
     # Class Methods
     #####################################
     module ClassMethods
+
       # 'include' all of these, so their methods become defined in this
       # module, and will become Class Methods when this module
       # is extended.
@@ -128,7 +131,6 @@ module Jamf
         @patch_path ||= defined?(self::PATCH_PATH) ? self::PATCH_PATH : self::LIST_PATH
       end
 
-
       # The path for POSTing to create a single object in the collection.
       #
       # Classes including CollectionResource really need to define POST_PATH if it
@@ -256,7 +258,6 @@ module Jamf
       #
       ######################################
       def all(sort: nil, filter: nil, instantiate: false, cnx: Jamf.cnx, refresh: nil)
-
         # if we are here, we need to query for all items, possibly filtered and
         # sorted
         sort = Jamf::Sortable.parse_url_sort_param(sort)
@@ -287,7 +288,6 @@ module Jamf
       #   arbitrary pages from the collection.
       #
       def pager(page_size: Jamf::Pager::DEFAULT_PAGE_SIZE, sort: nil, filter: nil, instantiate: false, cnx: Jamf.cnx)
-
         sort = Jamf::Sortable.parse_url_sort_param(sort)
         filter = filterable? ? Jamf::Filterable.parse_url_filter_param(filter) : nil
 
@@ -325,7 +325,6 @@ module Jamf
 
         raise Jamf::NoSuchItemError, "No attribute :#{to} for class #{self}" unless self::OAPI_PROPERTIES.key? to
 
-
         list = cached_list || all(cnx: cnx)
         to_class = self::OAPI_PROPERTIES[to][:class]
         to_multi = self::OAPI_PROPERTIES[to][:multi]
@@ -362,7 +361,7 @@ module Jamf
       #   raw_data some_value
       #
       # If some_value is an integer or a string containing an integer, it
-      # is assumed to be an :id otherwise all the available identifers
+      # is assumed to be an :id, otherwise all the available identifers
       # are searched, in the order you see them when you call <class>.identifiers
       #
       # If no matching object is found, nil is returned.
@@ -382,8 +381,6 @@ module Jamf
       #
       ######################################
       def raw_data(searchterm = nil, ident: nil, value: nil, cnx: Jamf.cnx)
-
-
         # given a value with no ident key
         return raw_data_by_searchterm_only(searchterm, cnx: cnx) if searchterm
 
@@ -491,15 +488,13 @@ module Jamf
       #
       # @return [Boolean]
       ######################################
-       def creatable?
+      def creatable?
         true
       end
 
       # Make a new thing to be added to the API
       ######################################
       def create(**params)
-
-
         # no such animal when .creating
         params.delete :id
 
@@ -582,7 +577,7 @@ module Jamf
       def delete(*ids, cnx: Jamf.cnx)
         raise Jamf::UnsupportedError, "Deleting #{self} objects is not currently supported" unless deletable?
 
-        return bulk_delete(ids, cnx: Jamf.cnx) if self.bulk_deletable?
+        return bulk_delete(ids, cnx: Jamf.cnx) if bulk_deletable?
 
         errs = []
         ids.each do |id_to_delete|
@@ -650,7 +645,6 @@ module Jamf
             raise NoMethodError, "no method '#{list_method_name}': '#{attr_name}' is not an indentifier for #{self}"
           end
         end
-
       end # create_identifier_list_method
       private :create_identifier_list_method
 
@@ -758,5 +752,7 @@ module Jamf
         raise Jamf::MissingDataError, "Attribute '#{attr_name}' cannot be nil, must be a #{attr_def[:class]}"
       end
     end
+
   end # class CollectionResource
+
 end # module JAMF

data/lib/jamf/api/jamf_pro/mixins/macos_managed_updates.rb

@@ -49,6 +49,10 @@ module Jamf
     # https://developer.jamf.com/jamf-pro/reference/post_v1-macos-managed-software-updates-send-updates
     MANAGED_SW_UPDATES_SEND_UPDATES_RSRC = "#{MANAGED_SW_UPDATES_RSRC}/send-updates"
 
+    # These are the options available in Jamf::OAPISchemas::MacOsManagedSoftwareUpdate::UPDATE_ACTION_OPTIONS
+    DOWNLOAD_AND_INSTALL = 'DOWNLOAD_AND_INSTALL'
+    DOWNLOAD_ONLY = 'DOWNLOAD_ONLY'
+
     # Class Methods
     #####################################
     module ClassMethods
@@ -67,11 +71,11 @@ module Jamf
         Jamf::OAPISchemas::AvailableUpdates.new(data).availableUpdates
       end
 
-      # Send the os update command to target Macs or a group
+      # Send the os update command to target Computers or a ComputerGroup
       #
       # @param updateAction [String] Required. 'DOWNLOAD_AND_INSTALL' or 'DOWNLOAD_ONLY'
       #
-      # @param deviceIds [String, Integer, Array<String, Integer>] Identiiers for the 
+      # @param deviceIds [String, Integer, Array<String, Integer>] Identifiers for the 
       #   computer targets. Required if no groupId is given.
       #
       # @param groupId [String, Integer] Identifier for the computer group target.
@@ -82,19 +86,20 @@ module Jamf
       #   Update will use the InstallLater install action. MaxDeferral is ignored if using the 
       #   DOWNLOAD_ONLY updateAction.
       #
-      # @param version [String] If no value is provided, the version will default to latest
-      #   version based on device eligibility.
+      # @param version [String] The OS version to install. If no value is provided, the 
+      #   version will default to latest version based on device eligibility.
       #
-      # @param skipVersionVerification [Boolean] If no value is provided, will default to false.
+      # @param skipVersionVerification [Boolean] Should the specified version be installed
+      #   even it it isn't applicable to this machine? If no value is provided, will default to false.
       #   If true, the specified version will be forced to complete DownloadAndInstall
       #   install action.
       #
-      # @param applyMajorUpdate [Boolean] available only when updating to the latest version
+      # @param applyMajorUpdate [Boolean] Available only when updating to the latest version
       #   based on device eligibility. Defaults to false. If false the calculated latest version
       #   will only include minor version updates. If a value is provided, the calculated latest
       #   version will include minor and major version updates.
       #
-      # @param forceRestart [Boolean]  will default to false. Can only be true if updateAction 
+      # @param forceRestart [Boolean]  Will default to false. Can only be true if updateAction 
       #   is DOWNLOAD_AND_INSTALLn and the devices the command is sent to are on macOs 11 or higher. 
       #   If true, the DownloadAndInstall action is performed, a restart will be forced. 
       #   MaxDeferral will be ignored if true. 
@@ -146,6 +151,11 @@ module Jamf
     # Instance Methods
     ######################################
 
+    # Send a managed update command to an instance of Computer or ComputerGroup.
+    # This just calls the class method of the same name.
+    #
+    # @see MacOSManagedUpdates.send_managed_os_update
+    #
     def send_managed_os_update(updateAction:, maxDeferrals: nil, version: nil, skipVersionVerification: false, applyMajorUpdate: false, forceRestart: false, cnx: Jamf.cnx)
       deviceIds = is_a?(Jamf::Computer) ? @id : nil
       groupId = is_a?(Jamf::Computer) ? nil : @id

data/lib/jamf/deprecations/deprecated_api_connection_class.rb

@@ -0,0 +1,29 @@
+# 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.
+
+# @deprecated Use class Jamf::Connection
+module Jamf
+
+  APIConnection = Connection
+
+end

data/lib/jamf/version.rb

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

data/lib/jamf/zeitwerk_config.rb

@@ -0,0 +1,217 @@
+# 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.
+
+# Gems
+######
+
+require 'zeitwerk'
+
+# Jamf's Zeitwerk Config and processes
+module JamfZeitwerkConfig
+
+  # touch this file to make zeitwerk and mixins send text to stderr as things load
+  # or get mixed in
+  VERBOSE_LOADING_FILE = Pathname.new('/tmp/ruby-jss-verbose-loading')
+
+  # Or, set this ENV var to also make zeitverk and mixins send text to stderr
+  VERBOSE_LOADING_ENV = 'RUBY_JSS_VERBOSE_LOADING'
+
+  # touch this file to make zeitwek  eager-load everything when the gem is required.
+  EAGER_LOAD_FILE = Pathname.new('/tmp/ruby-jss-zeitwerk-eager-load')
+
+  # Only look at the filesystem once.
+  def self.verbose_loading?
+    return @verbose_loading unless @verbose_loading.nil?
+
+    @verbose_loading = VERBOSE_LOADING_FILE.file?
+    @verbose_loading ||= ENV.include? VERBOSE_LOADING_ENV
+    @verbose_loading
+  end
+  
+  # rubocop: disable Style/StderrPuts
+  def self.load_msg(msg)
+    $stderr.puts msg if verbose_loading?    
+  end
+  # rubocop: enable Style/StderrPuts
+        
+  # The loader object for Xolo
+  def self.loader
+    @loader
+  end
+    
+  # Configure the Zeitwerk loader, See https://github.com/fxn/zeitwerk
+  def self.setup_zeitwerk_loader(zloader)
+    @loader = zloader
+
+    # Ignore this file (more ignores below)
+    loader.ignore __FILE__
+
+    ##### Collaped Paths
+    
+    # these paths all define classes & modules directly below 'Jamf'
+    # If we didn't collapse them, then e.g.
+    #   /jamf/api/base_classes/classic/group.rb
+    # would be expected to define
+    #   Jamf::Api::BaseClasses::Classic::Group
+    # rather than what we want:
+    #  Jamf::Group
+    ###################################################
+
+    loader.collapse("#{__dir__}/api")
+
+    loader.collapse("#{__dir__}/api/classic")
+    loader.collapse("#{__dir__}/api/classic/api_objects")
+    loader.collapse("#{__dir__}/api/classic/base_classes")
+
+    loader.collapse("#{__dir__}/api/jamf_pro")
+    loader.collapse("#{__dir__}/api/jamf_pro/api_objects")
+    loader.collapse("#{__dir__}/api/jamf_pro/mixins")
+    loader.collapse("#{__dir__}/api/jamf_pro/base_classes")
+    loader.collapse("#{__dir__}/api/jamf_pro/other_classes")
+
+    loader.collapse("#{__dir__}/deprecations")
+
+    ##### Inflected Paths
+    
+    # filenames => Constants, which don't adhere to zeitwerk's parsing standards.
+    #
+    # Mostly because the a filename like 'oapi_object' would be
+    # loaded by zeitwerk expecting it to define 'OapiObject', but it really
+    # defines 'OAPIObject'
+    ###############################################
+
+    # Connections
+    loader.inflector.inflect 'classic_api' => 'ClassicAPI'
+    loader.inflector.inflect 'jamf_pro_api' => 'JamfProAPI'
+    loader.inflector.inflect 'jamf_pro_api_error' => 'JamfProAPIError'
+
+    # API objects, resources, and mixins
+    loader.inflector.inflect 'oapi_schemas' => 'OAPISchemas'
+    loader.inflector.inflect 'oapi_object' => 'OAPIObject'
+    loader.inflector.inflect 'oapi_validate' => 'OAPIValidate'
+
+    loader.inflector.inflect 'jpapi_resource' => 'JPAPIResource'
+
+    loader.inflector.inflect 'api_object' => 'APIObject'
+    loader.inflector.inflect 'xml_workaround' => 'XMLWorkaround'
+    loader.inflector.inflect 'json_object' => 'JSONObject'
+    loader.inflector.inflect 'vppable' => 'VPPable'
+    loader.inflector.inflect 'osx_configuration_profile' => 'OSXConfigurationProfile'
+    loader.inflector.inflect 'jp_extendable' => 'JPExtendable'
+    loader.inflector.inflect 'mdm' => 'MDM'
+    loader.inflector.inflect 'ibeacon' => 'IBeacon'
+    loader.inflector.inflect 'powerbroker_identity_services' => 'PowerBroker'
+    loader.inflector.inflect 'admitmac' => 'ADmitMac'
+    loader.inflector.inflect 'ip_address' => 'IPAddress'
+    loader.inflector.inflect 'netboot_server' => 'NetBootServer'
+    loader.inflector.inflect 'vpp_account' => 'VPPAccount'
+    loader.inflector.inflect 'removable_macaddr' => 'RemovableMacAddress'
+    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.
+    # When its time to get rid of them, delete the files from the 
+    # 'deprecations' directory, and the matching line here.
+    loader.inflector.inflect('deprecated_api_constant' => 'API')
+    loader.inflector.inflect('deprecated_config_constant' => 'CONFIG')
+    loader.inflector.inflect('deprecated_api_connection_class' => 'APIConnection')
+
+    ##### Ingored Paths
+    
+    # These should be ignored, some will be required directly
+    #####################################
+
+    loader.ignore "#{__dir__}/db_connection.rb"
+    loader.ignore "#{__dir__}/ruby_extensions.rb"
+    loader.ignore "#{__dir__}/ruby_extensions"
+    loader.ignore "#{__dir__}/exceptions.rb"
+
+    lib_dir = Pathname.new(__dir__).parent.to_s
+    loader.ignore "#{lib_dir}/ruby-jss.rb" 
+    loader.ignore "#{lib_dir}/jss.rb" 
+    loader.ignore "#{lib_dir}/jss-api.rb" 
+    
+    ##### Callbacks
+
+    # callback for when a specific file/constant loads
+    # duplicate and uncomment this if desired to react to 
+    # specific things loading 
+    #####################################
+    # loader.on_load('Jamf::SomeClass') do |klass, abspath|
+    #   Jamf.load_msg "I just loaded #{klass} from #{abspath}"
+    # end
+
+    # callback for when anything loads
+    #  - const_path is like "Jamf::SomeClass" or "Jamf::SomeClass::SOME_CONST_ARRY"
+    #  - value is the value that constant contains after loading,
+    #    e.g. the class Jamf::SomeClass for 'Jamf::SomeClass' or
+    #    an Array for the constant  "Jamf::SomeClass::SOME_CONST_ARRY"
+    #  - abspath is the full path to the file where the constant was loaded from.
+    #####################################
+    loader.on_load do |const_path, value, abspath|
+      load_msg "Zeitwerk just loaded #{value.class} '#{const_path}' from:\n  #{abspath}"
+
+      # Parse OAPI_PROPERTIES into getters and setters for subclasses of
+      # OAPIObject in the JPAPI.
+      #
+      # The class we just loaded must have this method and constant
+      # and the method must not have run already for the class or any superclass.
+      # This prevents running parse_oapi_properties again in subclasses that
+      # don't need to do that
+      if value.respond_to?(:oapi_properties_parsed?) && \
+         defined?(value::OAPI_PROPERTIES) && \
+         !value.oapi_properties_parsed?
+
+        parsed = value.parse_oapi_properties
+        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
+
+        done = value.define_identifier_list_methods
+        load_msg "Defined identifier list methods for #{value}" if done
+      end
+    end
+
+    loader.setup
+  end # setup_zeitwerk_loader
+
+  # For testing the Zeitwrk Loader.
+  # Normally we want autoloading on demand,
+  # eager loading loads everything so we can see it
+  #
+  # To make this happen touch the file defined in EAGER_LOAD_FILE
+  def self.eager_load_for_testing
+    return unless EAGER_LOAD_FILE.file?
+
+    loader.eager_load(force: true)
+    warn :loaded
+    # rescue Zeitwerk::NameError => e
+    #   warn e.message
+  end
+
+end # module JamfZeitwerkConfig

data/lib/jamf.rb

@@ -54,49 +54,20 @@ require 'jamf/exceptions'
 require 'jamf/db_connection'
 
 # Configure the Zeitwerk loader, See https://github.com/fxn/zeitwerk
-require 'zeitwerk'
-require 'zeitwerk_config'
-
-# touch this file to make zeitwerk and mixins send text to stderr as things load
-# or get mixed in
-JAMF_VERBOSE_LOADING_FILE = Pathname.new('/tmp/ruby-jss-verbose-loading')
-
-# Or, set this ENV var to also make zeitverk and mixins send text to stderr
-JAMF_VERBOSE_LOADING_ENV = 'RUBY_JSS_VERBOSE_LOADING'.freeze
-
-# touch this file to make zeitwek  eager-load everything when the gem is required.
-JAMF_ZEITWERK_EAGER_LOAD_FILE = Pathname.new('/tmp/ruby-jss-zeitwerk-eager-load')
+require 'jamf/zeitwerk_config'
 
 # the `Zeitwerk::Loader.for_gem` creates the loader object, and must
 # happen in this file, so we pass it into a method defined in
 # zeitwerk_config
-setup_zeitwerk_loader Zeitwerk::Loader.for_gem
+JamfZeitwerkConfig.setup_zeitwerk_loader Zeitwerk::Loader.for_gem
 
 # Jamf, A Ruby module for interacting with the JAMF Pro Server via both of its REST APIs
 module Jamf
 
-  def self.validate_ruby_version
-    return if Gem::Version.new(RUBY_VERSION) >= Gem::Version.new(MINIMUM_RUBY_VERSION)
-
-    raise "Can't use ruby-jss #{Jamf::VERSION}, ruby itself must be version #{MINIMUM_RUBY_VERSION} or greater, this is ruby #{RUBY_VERSION}."
-  end
-
-  # Only look at the filesystem once.
-  def self.verbose_loading?
-    return @verbose_loading unless @verbose_loading.nil?
-
-    @verbose_loading = JAMF_VERBOSE_LOADING_FILE.file?
-    @verbose_loading ||= ENV.include? JAMF_VERBOSE_LOADING_ENV
-    @verbose_loading
-  end
-
-  # rubocop: disable Style/StderrPuts
+  # Use the load_msg method defined for Zeitwerk
   def self.load_msg(msg)
-    return unless verbose_loading?
-
-    $stderr.puts msg
-  end
-  # rubocop: enable Style/StderrPuts
+    JamfZeitwerkConfig.load_msg msg
+  end  
 
   # the single instance of our configuration object
   def self.config
@@ -113,11 +84,8 @@ module Jamf
 
 end # module Jamf
 
-# make sure we can run
-Jamf.validate_ruby_version
-
 # JSS module is now a synonym for Jamf module
 JSS = Jamf
 
-# testing zeitwerk loading
-eager_load_for_testing if JAMF_ZEITWERK_EAGER_LOAD_FILE.file?
+# testing zeitwerk loading, the the desired file is present
+JamfZeitwerkConfig.eager_load_for_testing 

data/test/tests/policy.rb

@@ -25,6 +25,7 @@
 
 module JamfTest
 
+  # Policy Tests
   class Policy < JamfTest::APITest
 
     include JamfTest::CollectionTests

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby-jss
 version: !ruby/object:Gem::Version
-  version: 2.0.0b1
+  version: 2.0.0rc1
 platform: ruby
 authors:
 - Chris Lasell
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-08-02 00:00:00.000000000 Z
+date: 2022-09-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: CFPropertyList
@@ -50,42 +50,30 @@ dependencies:
   name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.0.0
-    - - "<="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.1
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.0.0
-    - - "<="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.1
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: faraday_middleware
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.0.0
-    - - "<="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.1
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.0.0
-    - - "<="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.1
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
   requirement: !ruby/object:Gem::Requirement
@@ -107,9 +95,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.3'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -117,9 +102,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.3'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.3.0
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -144,6 +126,9 @@ dependencies:
   name: rexml
   requirement: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
         version: 3.1.9
@@ -151,6 +136,9 @@ dependencies:
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
         version: 3.1.9
@@ -159,9 +147,9 @@ description: |
   an enterprise/education tool for managing Apple devices, from jamf.com.
   The Jamf module provides access to both the 'Classic' API and the more modern
   'Jamf Pro' API. Jamf Pro objects are implemented as classes and can interact
-  with each other. Connection tokens, data transfer using JSON or XML and other
+  with each other. Authentication tokens, data transfer using JSON or XML and other
   details are handled automatically under the hood to allow simpler, intuitive
-  automation of Jamf-related Tasks.
+  automation of Jamf-related tasks.
 email: ruby-jss@pixar.com
 executables:
 - cgrouper
@@ -759,6 +747,7 @@ files:
 - lib/jamf/configuration.rb
 - lib/jamf/constants.rb
 - lib/jamf/db_connection.rb
+- lib/jamf/deprecations/deprecated_api_connection_class.rb
 - lib/jamf/deprecations/deprecated_api_constant.rb
 - lib/jamf/deprecations/deprecated_config_constant.rb
 - lib/jamf/exceptions.rb
@@ -786,10 +775,10 @@ files:
 - lib/jamf/utility.rb
 - lib/jamf/validate.rb
 - lib/jamf/version.rb
+- lib/jamf/zeitwerk_config.rb
 - lib/jss-api.rb
 - lib/jss.rb
 - lib/ruby-jss.rb
-- lib/zeitwerk_config.rb
 - test/README-TEST.md
 - test/bin/runtests
 - test/lib/jamf_test.rb