ruby-jss 1.6.0b1 → 2.0.0a10

data/lib/jss/validate.rb

@@ -1,248 +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 JSS
-
-  # A collection of methods for validating values. Mostly for
-  # ensuring the validity of data being set as attributes of APIObject
-  # subclass instances.
-  #
-  # Some of these methods can take multiple input types, such as a String
-  # or an Array.  All of them will either raise an exception
-  # if the value isn't valid, or will return a standardized form of the input
-  # (e.g. an Array, even if given a String)
-  #
-  module Validate
-
-    # The regular expression that matches a valid MAC address.
-    MAC_ADDR_RE = /^[a-f0-9]{2}(:[a-f0-9]{2}){5}$/i
-
-    # Validate the format and content of a MAC address
-    #
-    # @param val[String] The value to validate
-    #
-    # @param msg[String] A custom error message when the value is invalid
-    #
-    # @return [String] The valid value
-    #
-    def self.mac_address(val, msg = nil)
-      msg ||= "Not a valid MAC address: '#{val}'"
-      raise JSS::InvalidDataError, msg unless val =~ MAC_ADDR_RE
-
-      val
-    end
-
-    # Segments of a valid IPv4 address are integers in this range.
-    IP_SEGMENT_RANGE = 0..255
-
-    # Validate the format and content of an IPv4 address
-    #
-    # @param val[String] The value to validate
-    #
-    # @param msg[String] A custom error message when the value is invalid
-    #
-    # @return [String] The valid value
-    #
-    def self.ip_address(val, msg = nil)
-      msg ||= "Not a valid IPv4 address: '#{val}'"
-      ok = true
-      parts = val.strip.split '.'
-      ok = false unless parts.size == 4
-      parts.each { |p| ok = false unless p.jss_integer? && IP_SEGMENT_RANGE.include?(p.to_i) }
-      raise JSS::InvalidDataError, msg unless ok
-
-      val
-    end
-
-    # Validate that a value doesn't already exist for a given identifier of a
-    # given class
-    #
-    # e.g. when klass = JSS::Computer, identifier = :name, and val = 'foo'
-    # will raise an error when a computer named 'foo' exists
-    #
-    # Otherwise returns val.
-    #
-    # @param klass[JSS::APIObject] A subclass of JSS::APIObject, e.g. JSS::Computer
-    #
-    # @param identifier[Symbol] One of the keys of an Item of the class's #all Array
-    #
-    # @param val[Object] The value to check for uniqueness
-    #
-    # @param msg[String] A custom error message when the value is invalid
-    #
-    # @param api[JSS::APIConnection] The api connection to use for validation
-    #
-    # @return [Object] the validated unique value
-    #
-    def self.doesnt_already_exist(klass, identifier, val, msg = nil, api: JSS.api)
-      msg ||= "A #{klass} already exists with #{identifier} '#{val}'"
-      return val unless klass.all(:refresh, api: api).map { |i| i[identifier] }.include? val
-
-      key = klass.real_lookup_key identifier
-
-      # use map_all_ids_to cuz it works with any identifer, even non-existing
-      existing_values = klass.map_all_ids_to( key, api: api).values
-      matches = existing_values.select { |existing_val| existing_val.casecmp? val }
-      return val if matches.empty?
-
-      raise JSS::AlreadyExistsError, msg
-    end
-
-    # Confirm that the given value is a boolean value, accepting
-    # strings and symbols and returning real booleans as needed
-    # Accepts: true, false, 'true', 'false', 'yes', 'no', 't','f', 'y', or 'n'
-    # as strings or symbols, case insensitive
-    #
-    # TODO: use this throughout ruby-jss
-    #
-    # @param bool [Boolean,String,Symbol] The value to validate
-    #
-    # @param msg[String] A custom error message when the value is invalid
-    #
-    # @return [Boolean] the valid boolean
-    #
-    def self.boolean(bool, msg = nil)
-      return bool if JSS::TRUE_FALSE.include? bool
-      return true if bool.to_s =~ /^(t(rue)?|y(es)?)$/i
-      return false if bool.to_s =~ /^(f(alse)?|no?)$/i
-
-      msg ||= 'Value must be boolean true or false, or an equivalent string or symbol'
-      raise JSS::InvalidDataError, msg
-    end
-
-    # Confirm that a value is an integer or a string representation of an
-    # integer. Return the integer, or raise an error
-    #
-    # TODO: use this throughout ruby-jss
-    #
-    # @param val[Object] the value to validate
-    #
-    # @param msg[String] A custom error message when the value is invalid
-    #
-    # @return [void]
-    #
-    def self.integer(val, msg = nil)
-      msg ||= 'Value must be an integer'
-      val = val.to_i if val.is_a?(String) && val.jss_integer?
-      raise JSS::InvalidDataError, msg unless val.is_a? Integer
-
-      val
-    end
-
-    # validate that the given value is a non-empty string
-    #
-    # @param val [Object] the thing to validate
-    #
-    # @param msg[String] A custom error message when the value is invalid
-    #
-    # @return [String] the valid non-empty string
-    #
-    def self.non_empty_string(val, msg = nil)
-      msg ||= 'value must be a non-empty String'
-      raise JSS::InvalidDataError, msg unless val.is_a?(String) && !val.empty?
-
-      val
-    end
-
-    UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.freeze
-
-    # validate that the given value is a valid uuid string
-    #
-    # @param val [Object] the thing to validate
-    #
-    # @param msg[String] A custom error message when the value is invalid
-    #
-    # @return [String] the valid uuid string
-    #
-    def self.uuid(val, msg = nil)
-      return val if val.is_a?(String) && val =~ UUID_RE
-
-      msg ||= 'value must be valid uuid'
-      raise JSS::InvalidDataError, msg
-    end
-
-    # validate that the given value is an integer in the JSS::IBeacon::MAJOR_MINOR_RANGE
-    #
-    # @param val [Object] the thing to validate
-    #
-    # @param msg[String] A custom error message when the value is invalid
-    #
-    # @return [String] the valid integer
-    #
-    def self.ibeacon_major_minor(val, msg = nil)
-      val = val.to_i if val.is_a?(String) && val.jss_integer?
-      ok = val.is_a? Integer
-      ok = JSS::IBeacon::MAJOR_MINOR_RANGE.include? val if ok
-      return val if ok
-
-      msg ||= "value must be an integer in the range #{JSS::IBeacon::MAJOR_MINOR_RANGE}"
-      raise JSS::InvalidDataError, msg unless ok
-    end
-
-    # validate a country name or code from JSS::APP_STORE_COUNTRY_CODES
-    # returning the validated code, or raising an error
-    #
-    # @param country[String] The country name or code
-    #
-    # @param msg[String] A custom error message when the value is invalid
-    #
-    # @return [String] the valid two-letter country code
-    #
-    def self.app_store_country_code(country, msg = nil)
-      country = country.to_s.upcase
-      return country if JSS::APP_STORE_COUNTRY_CODES.value? country
-
-      JSS::APP_STORE_COUNTRY_CODES.each do |name, code|
-        return code if name.upcase == country
-      end
-
-      msg ||= 'Unknown country name or code. See JSS::APP_STORE_COUNTRY_CODES or JSS.country_code_match(str)'
-      raise JSS::InvalidDataError, msg
-    end
-
-    # validate an email address - must match the RegEx /^\S+@\S+\.\S+$/
-    # i.e.:
-    #  1 or more non-whitespace chars, followed by
-    #  an @ character, followed by
-    #  1 or more non-whitespace chars, followed by
-    #  a dot, followed by
-    #  1 or more non-whitespace chars
-    #
-    # @param email[String] The email address
-    #
-    # @param msg[String] A custom error message when the value is invalid
-    #
-    # @return [String] the validly formatted email address
-    #
-    def self.email_address(email, msg = nil)
-      msg ||= "'#{email}' is not formatted as a valid email address"
-      email = email.to_s
-      return email if email =~ /^\S+@\S+\.\S+$/
-
-      raise JSS::InvalidDataError, msg
-    end
-
-  end # module validate
-
-end # module JSS

data/test/lib/testhelper/auth.rb

@@ -1,275 +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 Auth
-
-    KEYCHAIN_LABEL_BASE = 'com.pixar.ruby-jss.testing'.freeze
-
-    KEYCHAIN_JSS_LABEL = KEYCHAIN_LABEL_BASE + '.api'
-    KEYCHAIN_DB_LABEL = KEYCHAIN_LABEL_BASE + '.db'
-    KEYCHAIN_DIST_LABEL = KEYCHAIN_LABEL_BASE + '.distribution'
-
-    KEYCHAIN_DIST_ACCT = 'From JSS'.freeze
-
-    KEYCHAIN_LABELS = {
-      jss: KEYCHAIN_JSS_LABEL,
-      db: KEYCHAIN_DB_LABEL,
-      dist: KEYCHAIN_DIST_LABEL
-    }.freeze
-
-    module_function
-
-    # return the user's API password, prompting for it if we don't already have
-    # it
-    #
-    def api_pw(server: nil, port: nil, user: nil)
-      return @api_pw if @api_pw
-      # If we're here, we need to get the pw via prompt
-      @api_pw = prompt_for_password prompt: "Enter the API password for #{user}@#{server}:#{port}" do |apw|
-        begin
-          JSS.api.disconnect
-          JSS.api.connect user: user, pw: apw, server: server, port: port
-          true
-        rescue JSS::AuthenticationError
-          false
-        end # begin
-      end # do apw
-      raise JSS::AuthenticationError, "Incorrect API password for #{user}@#{server}:#{port}" unless @api_pw
-      @api_pw
-    end
-
-    # return the server, port, and user, which we might have gotten fromthe keychain
-    def connect_to_api(server: nil, user: nil, port: nil, pw: nil)
-      return if JSS.api.connected?
-
-      JSS.api.connect server: server, port: port, user: user, pw: pw
-      @api_pw = pw
-      { server: JSS.api.hostname, port: JSS.api.port, user: JSS.api.jss_user }
-    rescue JSS::AuthenticationError
-      # If we're here, we need to prompt for the pw
-      pw = api_pw server: server, port: port, user: user
-    ensure
-      # store the pw
-      save_rw_credentials label: KEYCHAIN_JSS_LABEL, acct: JSS.api.jss_user, server: JSS.api.hostname, port: JSS.api.port, pw: pw if JSS.api.connected?
-    end
-
-    # TODO: update this as API above so there's only one per keychain.
-    def db_pw
-      return @db_pw if @db_pw
-
-      # If we're here, we need to get the passwd for the user
-      @db_pw = prompt_for_password prompt: "Enter the MySQL password for #{@db_user}@#{@db_server}" do |apw|
-        begin
-          JSS::DB_CNX.disconnect
-          JSS::DB_CNX.connect server: @db_server, user: @db_user, pw: apw
-          true
-        rescue Mysql::ServerError::AccessDeniedError
-          false
-        end # begin
-      end # do apw
-
-      raise JSS::AuthenticationError, "Incorrect MySQL password for #{@db_user}@#{@db_server}" unless @db_pw
-      @db_pw
-    end
-
-    # TODO: update this as API above so there's only one per keychain.
-    def connect_to_db(server: nil, user: nil)
-      return if JSS::DB_CNX.connected?
-      @db_server = server ? server : JSS::CONFIG.api_server_name
-      @db_user = user
-
-      raise 'No db_server_name defined in /etc/ruby-jss.conf. Please specify with --db-server' unless @db_server
-
-      # look in the keychain
-      keychain_creds = rw_credentials_from_keychain(:db, @db_server, @db_user)
-
-      # did we get a user/pw? Use it
-      if keychain_creds
-        @db_user ||= keychain_creds[:user]
-        begin
-          JSS::DB_CNX.connect server: @db_server, user: @db_user, pw: keychain_creds[:password]
-
-          return
-        rescue Mysql::ServerError::AccessDeniedError
-          # re-prompt if bad pw in keychain
-          say "Stored MySQL password for #{@db_user}@#{@db_server} is incorrect"
-        end # begin
-      else
-        # Couldn't find a stored user for server, and no user given on CLI - error.
-        raise "No user stored for MySQL server '#{@db_server}'. Please specify with --db-user" unless @db_user
-      end
-
-      # If we're here, we need to get the passwd for the user
-      pw = db_pw
-
-      # store the pw
-      save_rw_credentials KEYCHAIN_DB_LABEL, @db_user, @db_server, pw
-    end
-
-    # TODO: pass in the API server for which we want the dist point pw
-    # must be connected to api
-    # and make it like API connection above, 1 per keychain.
-    def dist_point_pw
-      keychain_creds = rw_credentials_from_keychain(:db, @api_server, KEYCHAIN_DIST_ACCT)
-      if keychain_creds
-        @distpw = keychain_creds[:password]
-        return @distpw if JSS::DistributionPoint.master_distribution_point.check_pw :rw, distpw
-      end
-
-      # if we're here, there was no stored pw or it was incorrect
-
-      # If we're here, we need to get the passwd for the master dist point
-      prmpt = "Enter the RW password for the Master Distribution Point on JSS #{@api_server}"
-      @distpw = prompt_for_password prompt: prmpt do |apw|
-        JSS::DistributionPoint.master_distribution_point.check_pw :rw, apw
-      end # do apw
-
-      raise JSS::AuthenticationError, "Incorrect RW password for the Master Distribution Point on JSS #{@api_server}" unless @distpw
-
-      # store the pw
-      save_rw_credentials KEYCHAIN_DIST_LABEL, KEYCHAIN_DIST_ACCT, @api_server, @distpw
-      @distpw
-    end
-
-    # Fetch read-write credentials from the login keychain
-    #
-    # If the login keychain is locked, the user will be prompted
-    # to unlock it in the GUI.
-    #
-    # @param kind[Symbol] which kind of credentials? :jss, :db, or :dist
-    #
-    # @return [Hash{Symbol => String}, nil] A Hash with :server, :user and :password
-    #   values, nil if no matching keychain item.
-    #
-    def rw_credentials_from_keychain(kind)
-      Keychain.user_interaction_allowed = true
-      unlock_keychain
-      label = KEYCHAIN_LABELS[kind]
-      raise JSS::InvalidDataError, "argument must be one of :#{RW_CREDENTIAL_KINDS.join ', :'}" unless label
-
-      pw_search = { label: label }
-      pw_item = Keychain.default.internet_passwords.where(pw_search).first
-
-      return nil unless pw_item
-
-      { server: pw_item.server, user: pw_item.account, pw: pw_item.password, port: pw_item.port }
-    end
-
-    # Save the credentials in the login keychain
-    #
-    # @param user[String] the username to save
-    #
-    # @param pw[String] the password to save with the username
-    #
-    # @return [void]
-    #
-    def save_rw_credentials(label: nil, acct: nil, server: nil, pw: nil, port: nil)
-      Keychain.default.internet_passwords.where(label: label).all.each(&:delete)
-      item = Keychain.default.internet_passwords.create label: label, account: acct, server: server, password: pw, port: port
-      item.save!
-    end
-
-    # Prompt the user to unlock the default keychain
-    #
-    # @return [void]
-    #
-    def unlock_keychain
-      return true unless Keychain.default.locked?
-      unlocked = prompt_for_password prompt: 'Enter your keychain password' do |pw|
-        begin
-          Keychain.default.unlock! pw
-          true
-        rescue Keychain::AuthFailedError
-          false
-        end # begin
-      end # prompt for pass
-      raise JSS::AuthenticationError, 'Failed to unlock default keychain' unless unlocked
-    end # unlock keychain
-
-    # Prompt the user for a password in the shell
-    # Returns:
-    #   - a valid password, or
-    #   - false if no valid password after the max number of tries
-    #
-    # Displays the provided promp. Passes what the user types to the block you
-    # provide, which must return a Boolean indicating if the password was correct.
-    #
-    # @param prompt[String] The message asking for the password
-    #
-    # @option max_tries[Integer] The max number of times to let the
-    #   user enter the passwd. Defaults to 3
-    #
-    # @option retry_msg[String] the text to display after a failure,
-    #   but before :max_tries failures. Defaults to "Try again: " followed
-    #   by the text arg.
-    #
-    # @option failed_msg[String] The message to display after :max_tries
-    #   failures. Defaults to  "Too many failed attempts"
-    #
-    # @yield The block should figure out if the user typed the correct password
-    #
-    # @yieldparam pw [String] The password typed by the user in the input field
-    #
-    # @yieldreturn [Boolean] Was the password correct?
-    #
-    # @return [String] The validated password
-    # @return [false] The user failed after max_tries: attempts.
-    #
-    #
-    def prompt_for_password(**options)
-      colon = ':'
-      # set defaults
-      options[:prompt] ||= 'Enter your password:'
-      options[:prompt] << colon unless options[:prompt].end_with? colon
-      options[:max_tries] ||= 3
-      options[:retry_msg] ||= "Try Again. #{options[:prompt]}"
-      options[:failed_msg] ||= 'Too many failed attempts'
-
-      tries = 0
-
-      prompt = options[:prompt]
-
-      while tries < options[:max_tries]
-        print "#{prompt} "
-        system 'stty -echo'
-        pw = $stdin.gets.chomp
-        puts
-        system 'stty echo'
-        return pw if yield pw
-        prompt = options[:retry_msg]
-        tries += 1
-      end
-      puts options[:failed_msg]
-      false
-    ensure # make sure terminal is usable at the end of this
-      system 'stty echo'
-    end # prompt_for_password
-
-  end # module auth
-
-end # module JSSTestHelper

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