ruby-jss 1.6.4 → 2.0.0b1

data/test/lib/testhelper/patch_mgmt.rb

@@ -1,123 +0,0 @@
-### Copyright 2020 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 JSSTestHelper
-
-  # auth
-  module PatchMgmt
-
-    EXT_SRC_NAME = 'rubyjss-testPatchSource.company.com'.freeze
-    EXT_SRC_PORT = 8843
-
-    PATCH_TITLE_NAME = 'rubyjss-testPatchTitle'.freeze
-    PATCH_TITLE_SOURCE = 'Jamf'.freeze
-
-    PATCHCPOL_NAME = 'rubyjss-testPatchPolicy'.freeze
-
-    module_function
-
-    # Sources
-
-    def internal_src
-      @internal_src ||= JSS::PatchInternalSource.fetch id: 1
-    end
-
-    def external_src
-      @external_src ||= JSS::PatchExternalSource.make name: EXT_SRC_NAME
-    end
-
-    def refetch_external_src
-      @external_src = JSS::PatchExternalSource.fetch name: EXT_SRC_NAME
-    end
-
-    def delete_external_src
-      return [] unless JSS::PatchExternalSource.all_names(:refresh).include? EXT_SRC_NAME
-      JSS::PatchExternalSource.delete JSS::PatchExternalSource.map_all_ids_to(:name).invert[EXT_SRC_NAME]
-    end
-
-    # Titles
-
-    def name_id
-      @name_id ||= JSS::PatchInternalSource.available_name_ids(1).sample
-    end
-
-    def title(refresh = false)
-      @title = nil if refresh
-      return @title if @title
-      @title =
-        if JSS::PatchTitle.all_names.include? PATCH_TITLE_NAME
-          JSS::PatchTitle.fetch source: PATCH_TITLE_SOURCE, name_id: name_id
-        else
-          JSS::PatchTitle.make name: PATCH_TITLE_NAME, source: PATCH_TITLE_SOURCE, name_id: name_id
-        end
-    end
-
-    def delete_title
-      return [] unless JSS::PatchTitle.all_names(:refresh).include? PATCH_TITLE_NAME
-      JSS::PatchTitle.delete JSS::PatchTitle.map_all_ids_to(:name).invert[PATCH_TITLE_NAME]
-    end
-
-    # Versions
-
-    def version_key
-      @version_key ||= title.versions.keys.sample
-    end
-
-    # Patch Policies
-
-    def policy(refresh = false)
-      @policy = nil if refresh
-      return @policy if @policy
-
-      # make sure we have a title with which to create a patch pol
-      unless title.in_jss
-        title.source_id = 1 unless title.source_id
-        title.name_id = name_id unless title.name_id
-        title.save
-      end
-
-      # make sre the desired version has a package
-      unless title.versions[version_key].package_id.is_a? Integer
-        title.versions[version_key].package = JSS::Package.all_ids.sample
-        title.save
-      end
-
-      # if the policy exists fetch it, otherwise make it
-      @policy =
-        if JSS::PatchPolicy.all_names(:refresh).include? PATCHCPOL_NAME
-          JSS::PatchPolicy.fetch name: PATCHCPOL_NAME
-        else
-          JSS::PatchPolicy.make name: PATCHCPOL_NAME, patch_title: title
-        end
-    end
-
-    def delete_policy
-      return [] unless JSS::PatchPolicy.all_names(:refresh).include? PATCHCPOL_NAME
-      JSS::PatchPolicy.delete JSS::PatchPolicy.map_all_ids_to(:name).invert[PATCHCPOL_NAME]
-    end
-
-  end # module PatchMgmt
-
-end # module JSSTestHelper

data/test/specs/api_connection_spec.rb

@@ -1,57 +0,0 @@
-### Copyright 2020 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.
-###
-###
-
-describe JSS::APIConnection do
-
-  ##### Constants
-
-  TEST_CONNECTION_NAME = 'testconnection'.freeze
-
-  ##### Specs
-
-  # this happens before each 'it' block below.
-  before do
-    @newcon = JSS::APIConnection.new(
-      server: JSS.api.hostname,
-      user: JSS.api.jss_user,
-      pw: JSSTestHelper::Auth.api_pw(server: nil, port: nil, user: nil),
-      name: TEST_CONNECTION_NAME
-    )
-  end
-
-  it 'can be created' do
-    @newcon.must_be_instance_of JSS::APIConnection
-  end
-
-  it 'has a settable name at creation' do
-    @newcon.name.must_equal TEST_CONNECTION_NAME
-  end
-
-  it 'can be made default' do
-    JSS.use_api_connection @newcon
-    JSS.api.name.must_equal TEST_CONNECTION_NAME
-  end
-
-end

data/test/specs/patch01_source_spec.rb

@@ -1,54 +0,0 @@
-### Copyright 2020 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.
-###
-###
-
-# Patch Source MetaClass
-#
-describe JSS::PatchSource do
-
-  ##### Specs
-
-  it 'can list all patch sources' do
-    JSS::PatchSource.all.must_be_instance_of Array
-    JSS::PatchSource.all.first.must_be_instance_of Hash
-  end
-
-  it 'can be used to fetch subclass' do
-    JSS::PatchSource.fetch(id: 1).must_be_instance_of JSS::PatchInternalSource
-  end
-
-  it 'can list available titles for a subclass from class method' do
-    titles = JSS::PatchSource.available_titles 1
-    titles.must_be_instance_of Array
-    titles.first.must_be_instance_of Hash
-    titles.first[:last_modified].must_be_instance_of Time
-  end
-
-  it 'can list available name_ids for a subclass from class method' do
-    name_ids = JSS::PatchSource.available_name_ids 1
-    name_ids.must_be_instance_of Array
-    name_ids.first.must_be_instance_of String
-  end
-
-end # describe JSS::PatchSource

data/test/specs/patch02_internal_source_spec.rb

@@ -1,88 +0,0 @@
-### Copyright 2020 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.
-###
-###
-
-# Internal Sources
-#
-describe JSS::PatchInternalSource do
-
-  ##### Class Methods
-
-  ##### Instance Methods
-
-  # shortcut
-  def src
-    JSSTestHelper::PatchMgmt.internal_src
-  end
-
-  ##### Specs
-
-  it 'cannot be created' do
-    proc { JSS::PatchInternalSource.make name: 'foo' }.must_raise JSS::UnsupportedError
-  end
-
-  it 'cannot be modified' do
-    proc { src.host_name = 'foo' }.must_raise NoMethodError
-    proc { src.port = 'foo' }.must_raise NoMethodError
-  end
-
-  it 'cannot be disabled' do
-    proc { src.disable }.must_raise NoMethodError
-  end
-
-  it 'cannot be deleted' do
-    proc { src.delete }.must_raise JSS::UnsupportedError
-  end
-
-  it 'tells us if it is enabled' do
-    JSS::TRUE_FALSE.must_include src.enabled?
-  end
-
-  it 'tells us its hostname' do
-    src.host_name.must_be_instance_of String
-    src.host_name.wont_be_empty
-  end
-
-  it 'tells us its port' do
-    src.port.must_be_kind_of Integer
-  end
-
-  it 'tells us if ssl is enabled' do
-    JSS::TRUE_FALSE.must_include src.ssl_enabled?
-  end
-
-  it 'lists its available titles' do
-    titles = src.available_titles
-    titles.must_be_instance_of Array
-    titles.first.must_be_instance_of Hash
-    titles.first[:last_modified].must_be_instance_of Time
-  end
-
-  it 'lists its available name_ids' do
-    name_ids = src.available_name_ids
-    name_ids.must_be_instance_of Array
-    name_ids.first.must_be_instance_of String
-  end
-
-end # describe JSS::PatchInternalSource

data/test/specs/patch03_external_source_spec.rb

@@ -1,120 +0,0 @@
-### Copyright 2020 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.
-###
-###
-
-# External Sources
-#
-describe JSS::PatchExternalSource do
-
-  ##### Constants
-
-  ##### Class methods
-
-  # this effectively makes the tests run in the order defined, which is
-  # needed in this situattion.
-  def self.test_order
-    :alpha
-  end
-
-  ##### Instance Methods
-
-  # shortcut
-  def src
-    JSSTestHelper::PatchMgmt.external_src
-  end
-
-  ##### Specs
-
-  it 'can delete crufty objects from earlier tests' do
-    crufty_name = JSSTestHelper::PatchMgmt::EXT_SRC_NAME
-    break unless JSS::PatchExternalSource.all_names(:refresh).include? crufty_name
-
-    puts 'Found crufty External Source from Previous Tests - deleting'
-
-    crufty_id = JSS::PatchExternalSource.map_all_ids_to(:name).invert[crufty_name]
-    deleted = JSS::PatchExternalSource.delete crufty_id
-
-    deleted.must_be_instance_of Array
-    deleted.must_be_empty
-    JSS::PatchExternalSource.all_names(:refresh).wont_include crufty_name
-  end
-
-  it 'can be made' do
-    src.must_be_instance_of JSS::PatchExternalSource
-  end
-
-  it 'cannot be created without a host' do
-    proc { src.save }.must_raise JSS::UnsupportedError
-  end
-
-  it 'can be created with a host' do
-    src.host_name = JSSTestHelper::PatchMgmt::EXT_SRC_NAME
-    src.save.must_be_kind_of Integer
-  end
-
-  it 'can set the port' do
-    src.port = JSSTestHelper::PatchMgmt::EXT_SRC_PORT
-    src.port.must_equal JSSTestHelper::PatchMgmt::EXT_SRC_PORT
-  end
-
-  it 'can be enabled and disabled' do
-    src.enable
-    src.enabled?.must_be_instance_of TrueClass
-    src.disable
-    src.enabled?.must_be_instance_of FalseClass
-  end
-
-  it 'can enable and disable ssl' do
-    src.disable_ssl
-    src.ssl_enabled?.must_be_instance_of FalseClass
-    src.enable_ssl
-    src.ssl_enabled?.must_be_instance_of TrueClass
-  end
-
-  it 'can update changes to the server' do
-    src.update
-  end
-
-  it 'can be fetched by name' do
-    JSSTestHelper::PatchMgmt.refetch_external_src
-    src.must_be_instance_of JSS::PatchExternalSource
-  end
-
-  it 'tells us its host' do
-    src.host_name.must_equal JSSTestHelper::PatchMgmt::EXT_SRC_NAME
-  end
-
-  it 'tells us its port' do
-    src.port.must_equal JSSTestHelper::PatchMgmt::EXT_SRC_PORT
-  end
-
-  it 'tells us if it is enabled' do
-    JSS::TRUE_FALSE.must_include src.enabled?
-  end
-
-  it 'tells us if ssl is enabled' do
-    JSS::TRUE_FALSE.must_include src.ssl_enabled?
-  end
-
-end # describe JSS::PatchInternalSource

data/test/specs/patch04_titles_spec.rb

@@ -1,207 +0,0 @@
-### Copyright 2020 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.
-###
-###
-
-describe JSS::PatchTitle do
-
-  ##### Constants
-
-  ##### Class Methods
-
-  # this effectively makes the tests run in the order defined, which is
-  # needed in this situattion.
-  def self.test_order
-    :alpha
-  end
-
-  ##### Instance Methods
-
-  # shortcuts
-
-  def tt
-    JSSTestHelper::PatchMgmt.title
-  end
-
-  def tv
-    tt.versions[JSSTestHelper::PatchMgmt.version_key]
-  end
-
-  def prompt_for_name_id
-    puts '***************************'
-    puts 'Enter an unused Patch Title name_id for testing.'
-    puts 'Must be one of the following:'
-    unused_name_ids = self.class.unused_name_ids
-    unused_name_ids.each { |ni| puts "  #{ni}" }
-    puts
-    print 'which one?: '
-    chosen = $stdin.gets.chomp
-    until unused_name_ids.include? chosen
-      puts 'that one isnt on the list'
-      print 'which one?: '
-      chosen = $stdin.gets.chomp
-    end
-    chosen
-  end
-
-  ##### Specs
-
-  it 'can delete crufty title from earlier tests' do
-    deleted = JSSTestHelper::PatchMgmt.delete_title
-    deleted.must_be_instance_of Array
-    deleted.must_be_empty
-    JSS::PatchTitle.all_names(:refresh).wont_include JSSTestHelper::PatchMgmt::PATCH_TITLE_NAME
-  end
-
-  it 'can list all patch title source_name_ids' do
-    source_name_ids = JSS::PatchTitle.all_source_name_ids
-    source_name_ids.must_be_instance_of Array
-    break if source_name_ids.empty?
-    source_name_ids.first.must_be_instance_of String
-  end
-
-  it 'can list source_ids in use' do
-    srcids = JSS::PatchTitle.all_source_ids
-    srcids.must_be_instance_of Array
-    break if srcids.empty?
-    srcids.first.must_be_kind_of Integer
-  end
-
-  it 'cannot be made without a source and name_id' do
-    proc {
-      JSS::PatchTitle.make name: JSSTestHelper::PatchMgmt::PATCH_TITLE_NAME
-    }.must_raise JSS::MissingDataError
-
-    proc {
-      JSS::PatchTitle.make name: JSSTestHelper::PatchMgmt::PATCH_TITLE_NAME,
-      source: 'Foobar'
-    }.must_raise JSS::MissingDataError
-
-    proc {
-      JSS::PatchTitle.make name: JSSTestHelper::PatchMgmt::PATCH_TITLE_NAME,
-      name_id: 'Foobar'
-    }.must_raise JSS::MissingDataError
-  end
-
-  it 'must check that the source exists' do
-    proc {
-      JSS::PatchTitle.make(
-        name: JSSTestHelper::PatchMgmt::PATCH_TITLE_NAME,
-        source: 'Foobar',
-        name_id: 'FoobarNoSuchNameId'
-      )
-    }.must_raise JSS::NoSuchItemError
-  end
-
-  it 'must check that the name_id is available in the source' do
-    proc {
-      JSS::PatchTitle.make(
-        name: JSSTestHelper::PatchMgmt::PATCH_TITLE_NAME,
-        source: JSSTestHelper::PatchMgmt::PATCH_TITLE_SOURCE,
-        name_id: 'FoobarNoSuchNameId'
-      )
-    }.must_raise JSS::NoSuchItemError
-  end
-
-  it 'can be made with name, source, and name_id' do
-    tt.must_be_instance_of JSS::PatchTitle
-  end
-
-  it 'can be created' do
-    tt.create
-    JSS::PatchTitle.all_names(:refresh).must_include JSSTestHelper::PatchMgmt::PATCH_TITLE_NAME
-    tt.in_jss.must_be_instance_of TrueClass
-  end
-
-  it 'can be fetched by souce and name_id' do
-    id = tt.id
-    JSSTestHelper::PatchMgmt.title(:refetch)
-    tt.id.must_equal id
-  end
-
-  # TODO: simplify this when we aren't reading the data via
-  # XMLWorkaround
-  it 'can get a patch report' do
-    report = JSS::PatchTitle.patch_report tt.id
-    report.must_be_instance_of Hash
-    report.keys.must_include :versions
-    report[:versions].must_be_instance_of Hash
-    break if report[:versions].empty?
-
-    vers_name = report[:versions].keys.sample
-    vers_name.must_be_instance_of String
-    report[:versions][vers_name].must_be_instance_of Array
-    break if report[:versions][vers_name].empty?
-
-    client = report[:versions][vers_name].sample
-    client.must_be_instance_of Hash
-    client[:id].must_be_kind_of Integer
-  end
-
-  it 'has an array of Version objects' do
-    tt.versions.must_be_instance_of Hash
-    tv.must_be_instance_of JSS::PatchTitle::Version
-  end
-
-  it 'has no packages assigned by default' do
-    tv.package_assigned?.must_be_instance_of FalseClass
-    tt.versions_with_packages.size.must_be :==, 0
-  end
-
-  it 'cannot assign a non-existing package to a version' do
-    proc { tv.package = 'there should be no such package here' }.must_raise JSS::NoSuchItemError
-  end
-
-  it 'can assign a package to a version' do
-    pkg = JSS::Package.all.sample
-    tv.package = pkg[:id]
-    tv.package_name.must_equal pkg[:name]
-  end
-
-  it 'can get a patch report from a version' do
-    tv.patch_report.must_be_instance_of Hash
-  end
-
-  it 'can set email notifications' do
-    tt.email_notification = true
-  end
-
-  it 'can set web notifications' do
-    tt.web_notification = true
-  end
-
-  it 'can update the JSS with changes' do
-    tt.update
-    tt.need_to_update.must_be_instance_of FalseClass
-  end
-
-  it 'has the saved values when re-fetched' do
-    JSSTestHelper::PatchMgmt.title :refetch
-    tt.email_notification.must_be_instance_of TrueClass
-    tt.web_notification.must_be_instance_of TrueClass
-    verss = tt.versions_with_packages
-    verss.size.must_be :==, 1
-    verss.keys.first.must_equal tv.version
-  end
-
-end