ruby-jss 3.1.0b1 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4bce47ef4c036e883a7b41d44220f6405bec40d1c3ea20f141d4923ce29dc837
-  data.tar.gz: c14adc7dc8fd8b08c31c5cbe0257b667dcb18003b30754675da0c68edf268893
+  metadata.gz: 779e57b7a7c027827d1254a3e9ac100c648eea4d872c14a2bdd3af1b633613de
+  data.tar.gz: d8f19449e3bbd3c52031aaa4c9cfeeff83ac301be008e682db9cb9eacde2eb43
 SHA512:
-  metadata.gz: f8ea25d3586028883d908e6d7718b5ce8b5146d0412871c02d40f742c9bb86d7cb047c24a3a9e2e41cc3b011439fb901d7e657f4f1cf9193394d3d9ae8e75f02
-  data.tar.gz: fd6edb4cbf4941c67961c2da6863bdf37b0185f4b7512acf9c4783e8c2994e82f1f0eb8c1036227206f087c324d8695f22b869b151498956a84baa6d82a4623c
+  metadata.gz: 06a7448cf87691f9cf691de5836d43768d678daba0397bc3c21306ddb512c63204596962442be64a5e9a82653cc4446041b87bb0dff6274681c7bda1b81faea3
+  data.tar.gz: c3069994e4d1560b45f349b1d73b41834990c4e924b1dfbd65dcad3610ea3e258c8ce8f027fcf526a9bca47f7d8a2df4af686ca357e2e079d3ba5ea07b05f53b

data/CHANGES.md

@@ -15,21 +15,28 @@ __Please update all installations of ruby-jss to at least v1.6.0.__
 Many many thanks to actae0n of Blacksun Hackers Club for reporting this issue and providing examples of how it could be exploited.
 
 --------
-## \[3.1.0] 2023-06-05
+## \[3.1.0] 2023-06-06
 
 ### Added
   - Jamf::Computer.filevault_info and Jamf::Computer#filevault_info can retrieve FileVault info from v1/computer-inventory/filevault and related endpoints
   - Jamf::Computer.recovery_lock_password and Jamf::Computer#recovery_lock_password can retrieve stored recovery lock passwords
+  - Jamf::Pager#last_fetched_page - Integer, the last page returned by #fetch_next_page
   - There are now several ways to set scopes to all targets.
     - The original #include_all has been renamed #set_all_targets, and #include_all is an alias to it
     - The symbol :all can be passed to the #set_targets, and #add_target methods as they 'key' parameter, and they will just call #set_all_targets
     - There is now a setter #all_targets=(bool) which calls #set_all_targets, or sets @all_targets to false
+    - So All of these are identical:
+      - `some_scope.set_all_targets`
+      - `some_scope.include_all`
+      - `some_scope.set_targets :all`
+      - `some_scope.add_target :all`
+      - `some_scope.all_targets = true`
 
 ### Fixed
   - Fixed a bug in Jamf::Pager#initialize when constructing the query-path of the paged resource URL
   - Fixed a bug in Jamf::Pager#initialize: The instantiate: parameter takes a class, not a boolean
   - Fixed a bug in Jamf::CollectionResource.pager: The instantiate: parameter takes a boolean, but must pass a class to Jamf::Pager#initialize
-  - Jamf::OAPIObject base-class: can now instantiate objects that hold a single value
+  - Jamf::OAPIObject (base-class) can now instantiate objects that hold a single value
 
 ### Changed
   - Auto-generated OAPISchemas have been refreshed from Jamf Pro 10.46.0
@@ -90,13 +97,38 @@ Version 2.0.0 is a major refactoring of ruby-jss. While attempting to provide as
 
 Here are the high-level changes and there are many many others. For more details, see [CHANGES-2.0.0.md](CHANGES-2.0.0.md)
 
-- Support for Ruby 3.x
-  - tested in 3.0 and 3.1
-- Combined access to both the Classic and Jamf Pro APIs
-  - A single namespace module
+### Added
+
+  - Support for Ruby 3.x
+    - tested in 3.0 and 3.1
+  - Combined access to both the Classic and Jamf Pro APIs
+    - A single namespace module
   - Connection objects talk to both APIs & automatically handle details like bearer tokens
-- Auto-generated code for Jamf Pro API objects
-- Autoloading of code using [Zeitwerk](https://github.com/fxn/zeitwerk)
+  - Auto-generated code for Jamf Pro API objects
+  - Autoloading of code using [Zeitwerk](https://github.com/fxn/zeitwerk)
+
+### Changed
+
+These things are notably different in v2.0.0
+  - Paged queries to the Jamf Pro API
+  - API data are no longer cached for the JP API, possibly eventually for the classic
+  - No Attribute aliases for Jamf Pro API objects
+  - Class/Mixin hierarchy for Jamf Pro API objects
+  - Support for 'Sticky Sessions' in Jamf Cloud
+  - The valid_id method for Classic API collection classes
+
+### Deprecated
+
+These things will go away in some future version of ruby-jss, please update your code sooner than later.
+
+  - Use of the term 'api'
+  - .map_all_ids_to method for Classic API collection classes
+  - Using .make, #create, and #update for Classic API objects
+  - JSS::CONFIG
+  - Jamf::Connection instance methods #next_refresh, #secs_to_refresh, &  #time_to_refresh
+  - Cross-object validation in setters
+  - fetch :random
+
 
 ## \[1.6.7] - 2022-02-22
 
@@ -164,10 +196,6 @@ Here are the high-level changes and there are many many others. For more details
 
 ### Changed
 
-  - ruby-jss no longer uses the 'plist' gem due to a remote code execution security issue when using `Plist.parse_xml`. Plists are now handled by the CFPropertyList gem.  The existing wrapper method `JSS.parse_plist` bas been updated to use the new gem, and a new wrapper method has been added to convert ruby data to XML plist: `JSS.xml_plist_from(data)`. All internal references to methods from the insecure 'plist' gem have been replaced with calls to those wrapper methods.
-
-  Many many thanks to actae0n of Blacksun Hackers Club for reporting this security issue and providing examples of how it could be exploited.
-
   - In preparation for the removal of the 'runScript' command in the jamf binary, JSS::Script no longer uses it within the 'run' instance method. Instead, it just does what the jamf binary did: It creates a private temp folder, writes the script to disk in that temp folder, executes the script with any given params, then deletes the folder, returning the exit status and output from the script.
 
   - Jamf::Script#run now takes parameters in the named params `p4:` through `p11:` for consistency with other parts of ruby-jss.
@@ -178,6 +206,11 @@ Here are the high-level changes and there are many many others. For more details
 
   - JSS.expand_min_os has been updated to handle Apple's new version numbers for macOS. This method takes a string like '>=10.14.3' and expands it into a large array of greater OS versions and is used by the 'os_limitations' method of Packages and Scripts.  For any range of versions that includes Big Sur, both '11.x.x' and '10.16' as included in the output, to catch machines that may have SYSTEM_VERSION_COMPAT set in their env.
 
+### Security
+
+  - ruby-jss no longer uses the 'plist' gem due to a remote code execution security issue when using `Plist.parse_xml`. Plists are now handled by the CFPropertyList gem.  The existing wrapper method `JSS.parse_plist` bas been updated to use the new gem, and a new wrapper method has been added to convert ruby data to XML plist: `JSS.xml_plist_from(data)`. All internal references to methods from the insecure 'plist' gem have been replaced with calls to those wrapper methods.
+
+  Many many thanks to actae0n of Blacksun Hackers Club for reporting this security issue and providing examples of how it could be exploited.
 
 ## \[1.5.3] - 2020-12-28
 

data/lib/jamf/api/classic/api_objects/scopable/scope.rb

@@ -430,7 +430,7 @@ module Jamf
       #
       # @return [void]
       #
-      def set_targets(key, list)
+      def set_targets(key, list = nil)
         if key == :all
           set_all_targets
           return
@@ -494,7 +494,7 @@ module Jamf
       #
       # @return [void]
       #
-      def add_target(key, item)
+      def add_target(key, item = nil)
         if key == :all
           set_all_targets
           return

data/lib/jamf/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby-jss
 version: !ruby/object:Gem::Version
-  version: 3.1.0b1
+  version: 3.1.0
 platform: ruby
 authors:
 - Chris Lasell
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-02 00:00:00.000000000 Z
+date: 2023-06-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: CFPropertyList
@@ -882,9 +882,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 2.6.3
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubygems_version: 3.0.3.1
 signing_key: