berkeley_library-util 0.1.9 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fdc84acc6adb94fcfbbcf7d18b9a6bead8ef484ef40028f139b07964b565b4e2
-  data.tar.gz: 43e850e1ee541d777c07f546f789e576b45a44580734206c44cd2dce4d3293a1
+  metadata.gz: 95474321e18bf12390800d829d0fd62e043e5d5e3a17a75df968944698a10328
+  data.tar.gz: 98d7b23d5be9bb910b707f53bafa517b51994f9e2fab5b963342027f54c26e84
 SHA512:
-  metadata.gz: dc47ba39cee501522db01aceeba7060f51ee4270ca03a2d4263e836190eddc2e953fd83eb292379ce4fcdbd5a9bac3831ec76c750cb2ecd9a375c86a60533079
-  data.tar.gz: 0dc4190292083d68066528c6a7efa815667ccc6ba79fb75ba0d0fa5e5f1ab354465447d1d7b53bbf825426e010bd4954b0ada17f3b935ae68095d8d0795940c1
+  metadata.gz: 835494737587ecf7b19aa9b88d1ba500f3919c830f6b3dbae1a45d10c42e0cc5520c6f401bcc678cdc2feae4e747caedaf8960804bbc98ecd2981b7157cc0ec1
+  data.tar.gz: 770fb93344dc72807d6bfed3d8d1c70e811546bd8698b4bb627dba0206a763b17f0d34f44bf30368837d4a2b7daf64e598d7917b626ee70f978f5095cb8afcdd

data/.github/workflows/build.yml

@@ -6,7 +6,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ ubuntu-latest, macos-latest ]
-        ruby: [ '2.7', '3.0', '3.1' ]
+        ruby: [ '3.3', '3.4' ]
     runs-on: ${{ matrix.os }}
 
     steps:
@@ -24,7 +24,7 @@ jobs:
 
       - name: Upload artifacts
         if: ${{ always() }}
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
-          name: artifacts
+          name: artifacts-${{ matrix.ruby }}-${{ matrix.os }}
           path: artifacts/**

data/.github/workflows/gem-push.yml

@@ -0,0 +1,33 @@
+name: Ruby Gem
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    name: Build + Publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: '3.3'
+        bundler-cache: true
+
+    - name: Publish to RubyGems
+      run: |
+        mkdir -p $HOME/.gem
+        touch $HOME/.gem/credentials
+        chmod 0600 $HOME/.gem/credentials
+        printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+        gem build *.gemspec
+        gem push *.gem
+      env:
+        GEM_HOST_API_KEY: "${{secrets.RUBYGEMS_AUTH_TOKEN}}"

data/.gitignore

@@ -35,6 +35,7 @@ Gemfile.lock
 /test/tmp/
 /test/version_tmp/
 /tmp/
+/vendor
 
 # Used by dotenv library to load environment variables.
 # .env
@@ -218,7 +219,8 @@ flycheck_*.el
 .LSOverride
 
 # Icon must end with two \r
-Icon
+Icon
+
 
 # Thumbnails
 ._*

data/.rubocop.yml

@@ -491,3 +491,141 @@ Style/RedundantStringEscape: # (new in 1.37)
 Style/RedundantEach: # (new in 1.38)
   Enabled: true
 
+Gemspec/AddRuntimeDependency: # new in 1.65
+  Enabled: true
+Gemspec/AttributeAssignment: # new in 1.77
+  Enabled: true
+Gemspec/DevelopmentDependencies: # new in 1.44
+  Enabled: false
+Lint/ArrayLiteralInRegexp: # new in 1.71
+  Enabled: true
+Lint/ConstantReassignment: # new in 1.70
+  Enabled: true
+Lint/CopDirectiveSyntax: # new in 1.72
+  Enabled: true
+Lint/DuplicateMatchPattern: # new in 1.50
+  Enabled: true
+Lint/DuplicateSetElement: # new in 1.67
+  Enabled: true
+Lint/HashNewWithKeywordArgumentsAsDefault: # new in 1.69
+  Enabled: true
+Lint/ItWithoutArgumentsInBlock: # new in 1.59
+  Enabled: true
+Lint/LiteralAssignmentInCondition: # new in 1.58
+  Enabled: true
+Lint/MixedCaseRange: # new in 1.53
+  Enabled: true
+Lint/NumericOperationWithConstantResult: # new in 1.69
+  Enabled: true
+Lint/RedundantRegexpQuantifiers: # new in 1.53
+  Enabled: true
+Lint/RedundantTypeConversion: # new in 1.72
+  Enabled: true
+Lint/SharedMutableDefault: # new in 1.70
+  Enabled: true
+Lint/SuppressedExceptionInNumberConversion: # new in 1.72
+  Enabled: true
+Lint/UnescapedBracketInRegexp: # new in 1.68
+  Enabled: true
+Lint/UselessConstantScoping: # new in 1.72
+  Enabled: true
+Lint/UselessDefaultValueArgument: # new in 1.76
+  Enabled: true
+Lint/UselessDefined: # new in 1.69
+  Enabled: true
+Lint/UselessNumericOperation: # new in 1.66
+  Enabled: true
+Lint/UselessOr: # new in 1.76
+  Enabled: true
+Lint/UselessRescue: # new in 1.43
+  Enabled: true
+Metrics/CollectionLiteralLength: # new in 1.47
+  Enabled: true
+Naming/PredicateMethod: # new in 1.76
+  Enabled: true
+Style/AmbiguousEndlessMethodDefinition: # new in 1.68
+  Enabled: true
+Style/ArrayIntersect: # new in 1.40
+  Enabled: true
+Style/BitwisePredicate: # new in 1.68
+  Enabled: true
+Style/CollectionQuerying: # new in 1.77
+  Enabled: true
+Style/CombinableDefined: # new in 1.68
+  Enabled: true
+Style/ComparableBetween: # new in 1.74
+  Enabled: true
+Style/ComparableClamp: # new in 1.44
+  Enabled: true
+Style/ConcatArrayLiterals: # new in 1.41
+  Enabled: true
+Style/DataInheritance: # new in 1.49
+  Enabled: true
+Style/DigChain: # new in 1.69
+  Enabled: true
+Style/DirEmpty: # new in 1.48
+  Enabled: true
+Style/EmptyStringInsideInterpolation: # new in 1.76
+  Enabled: true
+Style/ExactRegexpMatch: # new in 1.51
+  Enabled: true
+Style/FileEmpty: # new in 1.48
+  Enabled: true
+Style/FileNull: # new in 1.69
+  Enabled: true
+Style/FileTouch: # new in 1.69
+  Enabled: true
+Style/HashFetchChain: # new in 1.75
+  Enabled: true
+Style/HashSlice: # new in 1.71
+  Enabled: true
+Style/ItAssignment: # new in 1.70
+  Enabled: true
+Style/ItBlockParameter: # new in 1.75
+  Enabled: true
+Style/KeywordArgumentsMerging: # new in 1.68
+  Enabled: true
+Style/MapIntoArray: # new in 1.63
+  Enabled: true
+Style/MapToSet: # new in 1.42
+  Enabled: true
+Style/MinMaxComparison: # new in 1.42
+  Enabled: true
+Style/RedundantArrayConstructor: # new in 1.52
+  Enabled: true
+Style/RedundantArrayFlatten: # new in 1.76
+  Enabled: true
+Style/RedundantConstantBase: # new in 1.40
+  Enabled: true
+Style/RedundantCurrentDirectoryInPath: # new in 1.53
+  Enabled: true
+Style/RedundantDoubleSplatHashBraces: # new in 1.41
+  Enabled: true
+Style/RedundantFilterChain: # new in 1.52
+  Enabled: true
+Style/RedundantFormat: # new in 1.72
+  Enabled: true
+Style/RedundantHeredocDelimiterQuotes: # new in 1.45
+  Enabled: true
+Style/RedundantInterpolationUnfreeze: # new in 1.66
+  Enabled: true
+Style/RedundantLineContinuation: # new in 1.49
+  Enabled: true
+Style/RedundantRegexpArgument: # new in 1.53
+  Enabled: true
+Style/RedundantRegexpConstructor: # new in 1.52
+  Enabled: true
+Style/ReturnNilInPredicateMethodDefinition: # new in 1.53
+  Enabled: true
+Style/SafeNavigationChainLength: # new in 1.68
+  Enabled: true
+Style/SendWithLiteralMethodName: # new in 1.64
+  Enabled: true
+Style/SingleLineDoEndBlock: # new in 1.57
+  Enabled: true
+Style/SuperArguments: # new in 1.64
+  Enabled: true
+Style/SuperWithArgsParentheses: # new in 1.58
+  Enabled: true
+Style/YAMLFileRead: # new in 1.53
+  Enabled: true

data/.ruby-version

@@ -1 +1 @@
-2.7.4
+3.3

data/CHANGES.md

@@ -1,3 +1,15 @@
+# 0.3.0 (2026-02-04)
+
+- Add `URIs::HeadCheck`, an OkComputer check that performs a HEAD request
+  to verify the availability of a URL, with optional basic authentication.
+- updates Requester to support timeouts values passed to RestClient
+- Bumping to 0.3.0 to reflect changes to `Requester` and the addition of `URIs::HeadCheck`.
+
+# 0.2.0 (2025-07-24)
+
+- Update to support Ruby 3.3+.
+- Update Rubocop & style changes.
+
 # 0.1.9 (2023-06-01)
 
 - `URIs#path_escape` now attempts to convert non-UTF-8 strings to UTF-8 rather than immediately

data/Dockerfile

@@ -0,0 +1,58 @@
+# =============================================================================
+# Target: base
+
+FROM ruby:3.3-alpine AS base
+
+RUN apk --no-cache --update upgrade && \
+    apk --no-cache add \
+        bash \
+        ca-certificates \
+        git \
+        libc6-compat \
+        openssl \
+        tzdata \
+        xz-libs \
+        yaml-dev \
+    && rm -rf /var/cache/apk/*
+
+WORKDIR /opt/app
+
+# =============================================================================
+# Target: development
+#
+
+FROM base AS development
+
+# Install system packages needed to build gems with C extensions.
+RUN apk --update --no-cache add \
+        build-base \
+        coreutils \
+        git \
+    && rm -rf /var/cache/apk/*
+
+# The base image ships an older bundler, but we want something more recent
+RUN gem install bundler -v 2.5.22
+
+# Copy codebase to WORKDIR. Unlike application projects, for a gem project
+# we need to do this before running `bundle install`, in order for the gem
+# we're building to be able to "install" itself.
+COPY . .
+
+# Install gems.
+RUN bundle install --path=/usr/local/bundle
+
+# =============================================================================
+# Target: production
+
+FROM base AS production
+
+# Copy the built codebase from the dev stage
+COPY --from=development /opt/app /opt/app
+COPY --from=development /usr/local/bundle /usr/local/bundle
+
+# Sanity-check that everything was installed correctly and still runs in the
+# slimmed-down production image.
+RUN bundle config set deployment 'true'
+RUN bundle install --local --path=/usr/local/bundle
+
+CMD ["bundle", "exec", "rake"]

data/berkeley_library-util.gemspec

@@ -2,14 +2,14 @@ File.expand_path('lib', __dir__).tap do |lib|
   $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 end
 
-ruby_version = '>= 2.7'
+ruby_version = '~> 3.3'
 
 require 'berkeley_library/util/module_info'
 
 Gem::Specification.new do |spec|
   spec.name = BerkeleyLibrary::Util::ModuleInfo::NAME
-  spec.author = BerkeleyLibrary::Util::ModuleInfo::AUTHOR
-  spec.email = BerkeleyLibrary::Util::ModuleInfo::AUTHOR_EMAIL
+  spec.author = BerkeleyLibrary::Util::ModuleInfo::AUTHORS
+  spec.email = BerkeleyLibrary::Util::ModuleInfo::AUTHOR_EMAILS
   spec.summary = BerkeleyLibrary::Util::ModuleInfo::SUMMARY
   spec.description = BerkeleyLibrary::Util::ModuleInfo::DESCRIPTION
   spec.license = BerkeleyLibrary::Util::ModuleInfo::LICENSE
@@ -21,19 +21,20 @@ Gem::Specification.new do |spec|
 
   spec.required_ruby_version = ruby_version
 
-  spec.add_dependency 'berkeley_library-logging', '~> 0.2'
+  spec.add_dependency 'berkeley_library-logging', '~> 0.3'
   spec.add_dependency 'rest-client', '~> 2.1'
   spec.add_dependency 'typesafe_enum', '~> 0.3'
 
   spec.add_development_dependency 'ci_reporter_rspec', '~> 1.0'
-  spec.add_development_dependency 'colorize', '~> 0.8'
+  spec.add_development_dependency 'colorize', '~> 1.0'
   spec.add_development_dependency 'dotenv', '~> 2.7'
+  spec.add_development_dependency 'okcomputer', '~> 1.19'
   spec.add_development_dependency 'rake', '~> 13.0'
   spec.add_development_dependency 'rspec', '~> 3.10'
-  spec.add_development_dependency 'rubocop', '= 1.39'
-  spec.add_development_dependency 'rubocop-rake', '= 0.6.0'
-  spec.add_development_dependency 'rubocop-rspec', '= 2.4.0'
-  spec.add_development_dependency 'ruby-prof', '~> 0.17.0'
+  spec.add_development_dependency 'rubocop', '~> 1.78.0'
+  spec.add_development_dependency 'rubocop-rake', '~> 0.7.1'
+  spec.add_development_dependency 'rubocop-rspec', '~> 3.6.0'
+  spec.add_development_dependency 'ruby-prof'
   spec.add_development_dependency 'simplecov', '~> 0.21'
   spec.add_development_dependency 'webmock', '~> 3.12'
 

data/docker-compose.yml

@@ -0,0 +1,10 @@
+services:
+  gem:
+    build:
+      context: .
+      target: development
+    restart: always
+    volumes:
+      # Note that this mounts the *entire* repo directory (including
+      # files ignored in .dockerignore when building the image)
+      - ./:/opt/app

data/lib/berkeley_library/util/arrays.rb

@@ -63,8 +63,8 @@ module BerkeleyLibrary
       #   @yieldparam target [Object] the value to compare against
       #   @return [Array<Integer>, nil] the indices in `in_array` of each value in `for_array`,
       #     or `nil` if not all values could be found
-      def find_indices(for_array:, in_array:, &block)
-        return find_indices_matching(for_array, in_array, &block) if block_given?
+      def find_indices(for_array:, in_array:, &)
+        return find_indices_matching(for_array, in_array, &) if block_given?
 
         find_all_indices(for_array, in_array)
       end
@@ -89,10 +89,10 @@ module BerkeleyLibrary
       #   @param in_array [Array] the array to search
       #   @param start_index [Integer] the index to start with
       #   @return [Enumerator] a new enumerator
-      def find_index(*args, in_array:, start_index: 0, &block)
+      def find_index(*args, in_array:, start_index: 0, &)
         raise ArgumentError, "wrong number of arguments (given #{args.length}, expected 0..1" if args.size > 1
         return Enumerator.new { |y| find_index(in_array: in_array, start_index: start_index, &y) } if args.empty? && !block_given?
-        return unless (relative_index = in_array[start_index..].find_index(*args, &block))
+        return unless (relative_index = in_array[start_index..].find_index(*args, &))
 
         relative_index + start_index
       end
@@ -142,7 +142,7 @@ module BerkeleyLibrary
           shorter_unmatched = shorter[0...ix_s]
           longer_unmatched = longer[0...ix_l]
           all_unmatched = sort_by_first_and_flatten(shorter_unmatched, longer_unmatched)
-          return (all_unmatched << v) + merge(shorter[ix_s + 1..], longer[ix_l + 1..])
+          return (all_unmatched << v) + merge(shorter[(ix_s + 1)..], longer[(ix_l + 1)..])
         end
 
         sort_by_first_and_flatten(longer, shorter)

data/lib/berkeley_library/util/module_info.rb

@@ -2,12 +2,12 @@ module BerkeleyLibrary
   module Util
     class ModuleInfo
       NAME = 'berkeley_library-util'.freeze
-      AUTHOR = 'David Moles'.freeze
-      AUTHOR_EMAIL = 'dmoles@berkeley.edu'.freeze
+      AUTHORS = ['David Moles', 'maría a. matienzo', 'Jason Raitz'].freeze
+      AUTHOR_EMAILS = ['dmoles@berkeley.edu', 'matienzo@berkeley.edu', 'raitz@berkeley.edu'].freeze
       SUMMARY = 'Miscellaneous Ruby utilities for the UC Berkeley Library'.freeze
       DESCRIPTION = 'A collection of miscellaneous Ruby routines for the UC Berkeley Library.'.freeze
       LICENSE = 'MIT'.freeze
-      VERSION = '0.1.9'.freeze
+      VERSION = '0.3.0'.freeze
       HOMEPAGE = 'https://github.com/BerkeleyLibrary/util'.freeze
     end
   end

data/lib/berkeley_library/util/strings.rb

@@ -8,7 +8,7 @@ module BerkeleyLibrary
       def ascii_numeric?(s)
         s.chars.all? do |c|
           ord = c.ord
-          ord >= ASCII_0 && ord <= ASCII_9
+          ord.between?(ASCII_0, ASCII_9)
         end
       end
 

data/lib/berkeley_library/util/uris/head_check.rb

@@ -0,0 +1,27 @@
+require 'berkeley_library/util/uris'
+
+module BerkeleyLibrary
+  module Util
+    # :nocov:
+    if defined?(::OkComputer)
+      class HeadCheck < ::OkComputer::HttpCheck
+
+        def perform_request
+          headers = {}
+          if basic_auth_options.any?
+            user, password = basic_auth_options
+            headers['Authorization'] = "Basic #{Base64.strict_encode64("#{user}:#{password}")}"
+          end
+
+          options = { headers: headers, log: false }
+          options[:timeout] = request_timeout.to_i if request_timeout
+
+          URIs.head_response(url, **options)
+        rescue StandardError => e
+          raise OkComputer::HttpCheck::ConnectionFailed, e
+        end
+      end
+    end
+    # :nocov:
+  end
+end

data/lib/berkeley_library/util/uris/requester/class_methods.rb

@@ -13,9 +13,11 @@ module BerkeleyLibrary
           # @param log [Boolean] whether to log each request URL and response code
           # @param max_retries [Integer] the maximum number of times to retry after a 429 or 503 with Retry-After
           # @param max_retry_delay [Integer] the maximum retry delay (in seconds) to accept in a Retry-After header
+          # @param timeout [Integer] the request timeout in seconds (RestClient will use this to set both open and read timeouts)
           # @raise [RestClient::Exception] in the event of an unsuccessful request.
-          def get(uri, params: {}, headers: {}, log: true, max_retries: MAX_RETRIES, max_retry_delay: MAX_RETRY_DELAY_SECONDS)
-            resp = make_request(:get, uri, params, headers, log, max_retries, max_retry_delay)
+          def get(uri, params: {}, headers: {}, log: true, max_retries: MAX_RETRIES, max_retry_delay: MAX_RETRY_DELAY_SECONDS,
+                  timeout: DEFAULT_TIMEOUT_SECONDS)
+            resp = make_request(:get, uri, params, headers, log, max_retries, max_retry_delay, timeout)
             resp.body
           end
 
@@ -28,8 +30,10 @@ module BerkeleyLibrary
           # @param headers [Hash] the request headers.
           # @param log [Boolean] whether to log each request URL and response code
           # @return [Integer] the response code as an integer.
-          def head(uri, params: {}, headers: {}, log: true, max_retries: MAX_RETRIES, max_retry_delay: MAX_RETRY_DELAY_SECONDS)
-            head_response(uri, params: params, headers: headers, log: log, max_retries: max_retries, max_retry_delay: max_retry_delay).code
+          def head(uri, params: {}, headers: {}, log: true, max_retries: MAX_RETRIES, max_retry_delay: MAX_RETRY_DELAY_SECONDS,
+                   timeout: DEFAULT_TIMEOUT_SECONDS)
+            head_response(uri, params: params, headers: headers, log: log, max_retries: max_retries, max_retry_delay: max_retry_delay,
+                               timeout: timeout).code
           end
 
           # Performs a GET request and returns the response, even in the event of
@@ -40,8 +44,9 @@ module BerkeleyLibrary
           # @param headers [Hash] the request headers.
           # @param log [Boolean] whether to log each request URL and response code
           # @return [RestClient::Response] the response
-          def get_response(uri, params: {}, headers: {}, log: true, max_retries: MAX_RETRIES, max_retry_delay: MAX_RETRY_DELAY_SECONDS)
-            make_request(:get, uri, params, headers, log, max_retries, max_retry_delay)
+          def get_response(uri, params: {}, headers: {}, log: true, max_retries: MAX_RETRIES, max_retry_delay: MAX_RETRY_DELAY_SECONDS,
+                           timeout: DEFAULT_TIMEOUT_SECONDS)
+            make_request(:get, uri, params, headers, log, max_retries, max_retry_delay, timeout)
           rescue RestClient::Exception => e
             e.response
           end
@@ -54,15 +59,18 @@ module BerkeleyLibrary
           # @param headers [Hash] the request headers.
           # @param log [Boolean] whether to log each request URL and response code
           # @return [RestClient::Response] the response
-          def head_response(uri, params: {}, headers: {}, log: true, max_retries: MAX_RETRIES, max_retry_delay: MAX_RETRY_DELAY_SECONDS)
-            make_request(:head, uri, params, headers, log, max_retries, max_retry_delay)
+          def head_response(uri, params: {}, headers: {}, log: true, max_retries: MAX_RETRIES, max_retry_delay: MAX_RETRY_DELAY_SECONDS,
+                            timeout: DEFAULT_TIMEOUT_SECONDS)
+            make_request(:head, uri, params, headers, log, max_retries, max_retry_delay, timeout)
           rescue RestClient::Exception => e
-            e.response
+            return e.response if e.response
+
+            raise
           end
 
           private
 
-          def make_request(method, url, params, headers, log, max_retries, max_retry_delay)
+          def make_request(method, url, params, headers, log, max_retries, max_retry_delay, timeout)
             Requester.new(
               method,
               url,
@@ -70,7 +78,8 @@ module BerkeleyLibrary
               headers: headers,
               log: log,
               max_retries: max_retries,
-              max_retry_delay: max_retry_delay
+              max_retry_delay: max_retry_delay,
+              timeout: timeout
             ).make_request
           end
 

data/lib/berkeley_library/util/uris/requester.rb

@@ -20,11 +20,12 @@ module BerkeleyLibrary
         RETRY_STATUSES = [429, 503].freeze
         MAX_RETRY_DELAY_SECONDS = 10
         MAX_RETRIES = 3
+        DEFAULT_TIMEOUT_SECONDS = 10
 
         # ------------------------------------------------------------
         # Attributes
 
-        attr_reader :method, :url_str, :headers, :log, :max_retries, :max_retry_delay
+        attr_reader :method, :url_str, :headers, :log, :max_retries, :max_retry_delay, :timeout
 
         # ------------------------------------------------------------
         # Initializer
@@ -38,9 +39,11 @@ module BerkeleyLibrary
         # @param log [Boolean] whether to log each request URL and response code
         # @param max_retries [Integer] the maximum number of times to retry after a 429 or 503 with Retry-After
         # @param max_retry_delay [Integer] the maximum retry delay (in seconds) to accept in a Retry-After header
+        # @param timeout [Integer] the request timeout in seconds (RestClient will use this to set both open and read timeouts)
         # @raise URI::InvalidURIError if the specified URL is invalid
         # rubocop:disable Metrics/ParameterLists
-        def initialize(method, url, params: {}, headers: {}, log: true, max_retries: MAX_RETRIES, max_retry_delay: MAX_RETRY_DELAY_SECONDS)
+        def initialize(method, url, params: {}, headers: {}, log: true, max_retries: MAX_RETRIES, max_retry_delay: MAX_RETRY_DELAY_SECONDS,
+                       timeout: DEFAULT_TIMEOUT_SECONDS)
           raise ArgumentError, "#{method} not supported" unless SUPPORTED_METHODS.include?(method)
           raise ArgumentError, 'url cannot be nil' unless (uri = Validator.uri_or_nil(url))
 
@@ -50,6 +53,7 @@ module BerkeleyLibrary
           @log = log
           @max_retries = max_retries
           @max_retry_delay = max_retry_delay
+          @timeout = timeout
         end
 
         # rubocop:enable Metrics/ParameterLists
@@ -73,7 +77,7 @@ module BerkeleyLibrary
         private
 
         def log_response(response)
-          return unless log
+          return unless log && response&.code
 
           logger.info("#{method.to_s.upcase} #{url_str} returned #{response.code}")
         end
@@ -90,6 +94,8 @@ module BerkeleyLibrary
 
         def execute_request(retries_remaining = max_retries)
           try_execute_request
+        rescue RestClient::Exceptions::Timeout
+          raise
         rescue RestClient::Exception => e
           response = e.response
           raise unless (retry_delay = retry_delay_from(response))
@@ -99,7 +105,7 @@ module BerkeleyLibrary
         end
 
         def try_execute_request
-          RestClient::Request.execute(method: method, url: url_str, headers: headers).tap do |response|
+          RestClient::Request.execute(method: method, url: url_str, headers: headers, timeout: timeout).tap do |response|
             # Not all failed RestClient requests throw exceptions
             raise(exception_for(response)) unless response.code == 200
           end

data/lib/berkeley_library/util/uris.rb

@@ -34,8 +34,8 @@ module BerkeleyLibrary
       # @param log [Boolean] whether to log each request URL and response code
       # @return [String] the body as a string.
       # @raise [RestClient::Exception] in the event of an unsuccessful request.
-      def get(uri, params: {}, headers: {}, log: true)
-        Requester.get(uri, params: params, headers: headers, log: log)
+      def get(uri, params: {}, headers: {}, log: true, timeout: Requester::DEFAULT_TIMEOUT_SECONDS)
+        Requester.get(uri, params: params, headers: headers, log: log, timeout: timeout)
       end
 
       # Performs a HEAD request and returns the response status as an integer.
@@ -47,8 +47,8 @@ module BerkeleyLibrary
       # @param headers [Hash] the request headers.
       # @param log [Boolean] whether to log each request URL and response code
       # @return [Integer] the response code as an integer.
-      def head(uri, params: {}, headers: {}, log: true)
-        Requester.head(uri, params: params, headers: headers, log: log)
+      def head(uri, params: {}, headers: {}, log: true, timeout: Requester::DEFAULT_TIMEOUT_SECONDS)
+        Requester.head(uri, params: params, headers: headers, log: log, timeout: timeout)
       end
 
       # Performs a GET request and returns the response, even in the event of
@@ -59,8 +59,8 @@ module BerkeleyLibrary
       # @param headers [Hash] the request headers.
       # @param log [Boolean] whether to log each request URL and response code
       # @return [RestClient::Response] the response
-      def get_response(uri, params: {}, headers: {}, log: true)
-        Requester.get_response(uri, params: params, headers: headers, log: log)
+      def get_response(uri, params: {}, headers: {}, log: true, timeout: Requester::DEFAULT_TIMEOUT_SECONDS)
+        Requester.get_response(uri, params: params, headers: headers, log: log, timeout: timeout)
       end
 
       # Performs a HEAD request and returns the response, even in the event of
@@ -71,8 +71,8 @@ module BerkeleyLibrary
       # @param headers [Hash] the request headers.
       # @param log [Boolean] whether to log each request URL and response code
       # @return [RestClient::Response] the response
-      def head_response(uri, params: {}, headers: {}, log: true)
-        Requester.head_response(uri, params: params, headers: headers, log: log)
+      def head_response(uri, params: {}, headers: {}, log: true, timeout: Requester::DEFAULT_TIMEOUT_SECONDS)
+        Requester.head_response(uri, params: params, headers: headers, log: log, timeout: timeout)
       end
 
       # Returns the specified URL as a URI, or `nil` if the URL is `nil`.
@@ -109,14 +109,14 @@ module BerkeleyLibrary
         nil
       end
 
-      private
-
       # TODO: extend to cover other modes - host, zone, path, password, query, fragment
       #       cf. https://github.com/golang/go/blob/master/src/net/url/url.go
       ALLOWED_BYTES_BY_MODE = {
         path_segment: [0x24, 0x26, 0x2b, 0x3a, 0x3d, 0x40] # @ & = + $
       }.freeze
 
+      private
+
       def should_escape?(b, mode)
         return false if unreserved?(b)
         return false if ALLOWED_BYTES_BY_MODE[mode].include?(b)
@@ -124,16 +124,14 @@ module BerkeleyLibrary
         true
       end
 
-      # rubocop:disable Metrics/CyclomaticComplexity
       def unreserved?(byte)
-        return true if byte >= 0x41 && byte <= 0x5a # A-Z
-        return true if byte >= 0x61 && byte <= 0x7a # a-z
-        return true if byte >= 0x30 && byte <= 0x39 # 0-9
+        return true if byte.between?(0x41, 0x5a) # A-Z
+        return true if byte.between?(0x61, 0x7a) # a-z
+        return true if byte.between?(0x30, 0x39) # 0-9
         return true if [0x2d, 0x2e, 0x5f, 0x7e].include?(byte) # - . _ ~
 
         false
       end
-      # rubocop:enable Metrics/CyclomaticComplexity
     end
   end
 end

data/lib/berkeley_library/util.rb

@@ -1 +1 @@
-Dir.glob(File.expand_path('util/*.rb', __dir__)).sort.each(&method(:require))
+Dir.glob(File.expand_path('util/*.rb', __dir__)).each(&method(:require))

data/rakelib/.rubocop.yml

@@ -1,4 +1,4 @@
 inherit_from: ../.rubocop.yml
 
-require:
+plugins:
   - rubocop-rake

data/spec/.rubocop.yml

@@ -1,6 +1,6 @@
 inherit_from: ../.rubocop.yml
 
-require:
+plugins:
   - rubocop-rspec
 
 AllCops:
@@ -78,9 +78,12 @@ RSpec/ExpectInHook:
   Enabled: false
 
 # your naming scheme is not in possession of all the facts
-RSpec/FilePath:
+RSpec/SpecFilePathFormat:
   Enabled: false
 
+RSpec/SpecFilePathSuffix:
+  Enabled: true
+
 # explicit >>> implicit
 RSpec/InstanceVariable:
   Enabled: false
@@ -125,5 +128,3 @@ RSpec/VerifiedDoubles:
 RSpec/IdenticalEqualityAssertion: # new in 2.4
   Enabled: true
 
-RSpec/Rails/AvoidSetupHook: # new in 2.4
-  Enabled: true

data/spec/berkeley_library/util/arrays_spec.rb

@@ -8,11 +8,11 @@ module BerkeleyLibrary::Util
       let(:sup) { %w[a b c d e] }
 
       it 'returns true for an identical subset' do
-        expect(Arrays.ordered_superset?(superset: sup, subset: sup.dup)).to eq(true)
+        expect(Arrays.ordered_superset?(superset: sup, subset: sup.dup)).to be(true)
       end
 
       it 'returns true for an empty subset' do
-        expect(Arrays.ordered_superset?(superset: sup, subset: [])).to eq(true)
+        expect(Arrays.ordered_superset?(superset: sup, subset: [])).to be(true)
       end
 
       it 'returns true for an exact sublist' do
@@ -22,7 +22,7 @@ module BerkeleyLibrary::Util
           %w[c d e]
         ]
         subs.each do |sub|
-          expect(Arrays.ordered_superset?(superset: sup, subset: sub)).to eq(true)
+          expect(Arrays.ordered_superset?(superset: sup, subset: sub)).to be(true)
         end
       end
 
@@ -33,13 +33,13 @@ module BerkeleyLibrary::Util
           %w[a b d e]
         ]
         subs.each do |sub|
-          expect(Arrays.ordered_superset?(superset: sup, subset: sub)).to eq(true)
+          expect(Arrays.ordered_superset?(superset: sup, subset: sub)).to be(true)
         end
       end
 
       it 'returns false for a too-large subset' do
         sub = %w[a b c d e f g]
-        expect(Arrays.ordered_superset?(superset: sup, subset: sub)).to eq(false)
+        expect(Arrays.ordered_superset?(superset: sup, subset: sub)).to be(false)
       end
 
       it 'returns false when extra elements are present' do
@@ -49,7 +49,7 @@ module BerkeleyLibrary::Util
           %w[c d x e]
         ]
         subs.each do |sub|
-          expect(Arrays.ordered_superset?(superset: sup, subset: sub)).to eq(false)
+          expect(Arrays.ordered_superset?(superset: sup, subset: sub)).to be(false)
         end
       end
     end
@@ -150,7 +150,6 @@ module BerkeleyLibrary::Util
         expect { Arrays.find_index(1, 2, 3, in_array: [1, 2, 3]) }.to raise_error(ArgumentError)
       end
 
-      # rubocop:disable Lint/Void
       it 'returns an enumerator if given no arguments' do
         e = Arrays.find_index(in_array: arr)
         expect(e.each { |x| x > 3 }).to eq(2)
@@ -158,7 +157,6 @@ module BerkeleyLibrary::Util
         e = Arrays.find_index(in_array: arr, start_index: 3)
         expect(e.each { |x| x < 5 }).to eq(4)
       end
-      # rubocop:enable Lint/Void
     end
 
     describe :merge do
@@ -181,7 +179,7 @@ module BerkeleyLibrary::Util
 
         merged = Arrays.merge(a1, a2)
         [a1, a2].each do |a|
-          expect(Arrays.ordered_superset?(superset: merged, subset: a)).to eq(true), "merge(#{[a1.join, a2.join].inspect}): #{a.join} not found in #{merged.join}"
+          expect(Arrays.ordered_superset?(superset: merged, subset: a)).to be(true), "merge(#{[a1.join, a2.join].inspect}): #{a.join} not found in #{merged.join}"
         end
 
         expected = [1, 2, 2, 3, 4, 4, 5, 5, 6]
@@ -195,7 +193,7 @@ module BerkeleyLibrary::Util
 
         merged = Arrays.merge(a1, a2)
         [a1, a2].each do |a|
-          expect(Arrays.ordered_superset?(superset: merged, subset: a)).to eq(true), "merge(#{[a1.join, a2.join].inspect}): #{a.join} not found in #{merged.join}"
+          expect(Arrays.ordered_superset?(superset: merged, subset: a)).to be(true), "merge(#{[a1.join, a2.join].inspect}): #{a.join} not found in #{merged.join}"
         end
 
         expected = [1, 2, 3, 4, 5, 7, 8, 9]
@@ -209,7 +207,7 @@ module BerkeleyLibrary::Util
 
         merged = Arrays.merge(a1, a2)
         [a1, a2].each do |a|
-          expect(Arrays.ordered_superset?(superset: merged, subset: a)).to eq(true), "merge(#{[a1.join, a2.join].inspect}): #{a.join} not found in #{merged.join}"
+          expect(Arrays.ordered_superset?(superset: merged, subset: a)).to be(true), "merge(#{[a1.join, a2.join].inspect}): #{a.join} not found in #{merged.join}"
         end
 
         expected = [1, 2, 3, 2, 2, 4]
@@ -223,7 +221,7 @@ module BerkeleyLibrary::Util
 
         merged = Arrays.merge(a1, a2)
         [a1, a2].each do |a|
-          expect(Arrays.ordered_superset?(superset: merged, subset: a)).to eq(true), "merge(#{[a1.join, a2.join].inspect}): #{a.join} not found in #{merged.join}"
+          expect(Arrays.ordered_superset?(superset: merged, subset: a)).to be(true), "merge(#{[a1.join, a2.join].inspect}): #{a.join} not found in #{merged.join}"
         end
 
         expected = [1, nil, 3, nil, nil, 4]
@@ -237,7 +235,7 @@ module BerkeleyLibrary::Util
 
         merged = Arrays.merge(a1, a2)
         [a1, a2].each do |a|
-          expect(Arrays.ordered_superset?(superset: merged, subset: a)).to eq(true), "merge(#{[a1.join, a2.join].inspect}): #{a.join} not found in #{merged.join}"
+          expect(Arrays.ordered_superset?(superset: merged, subset: a)).to be(true), "merge(#{[a1.join, a2.join].inspect}): #{a.join} not found in #{merged.join}"
         end
 
         expected = [1, 'two', 3, 'two', 'two', 4]
@@ -251,7 +249,7 @@ module BerkeleyLibrary::Util
 
         merged = Arrays.merge(a1, a2)
         [a1, a2].each do |a|
-          expect(Arrays.ordered_superset?(superset: merged, subset: a)).to eq(true), "merge(#{[a1.join, a2.join].inspect}): #{a.join} not found in #{merged.join}"
+          expect(Arrays.ordered_superset?(superset: merged, subset: a)).to be(true), "merge(#{[a1.join, a2.join].inspect}): #{a.join} not found in #{merged.join}"
         end
 
         expected = a2
@@ -267,7 +265,7 @@ module BerkeleyLibrary::Util
 
         merged = Arrays.merge(a1, a2)
         [a1, a2].each do |a|
-          expect(Arrays.ordered_superset?(superset: merged, subset: a)).to eq(true), "merge(#{[a1.join, a2.join].inspect}): #{a.join} not found in #{merged.join}"
+          expect(Arrays.ordered_superset?(superset: merged, subset: a)).to be(true), "merge(#{[a1.join, a2.join].inspect}): #{a.join} not found in #{merged.join}"
         end
 
         expected = [1, 2, 3, 4, 5, 6, 9]
@@ -283,7 +281,7 @@ module BerkeleyLibrary::Util
 
         merged = Arrays.merge(a1, a2)
         [a1, a2].each do |a|
-          expect(Arrays.ordered_superset?(superset: merged, subset: a)).to eq(true), "merge(#{[a1.join, a2.join].inspect}): #{a.join} not found in #{merged.join}"
+          expect(Arrays.ordered_superset?(superset: merged, subset: a)).to be(true), "merge(#{[a1.join, a2.join].inspect}): #{a.join} not found in #{merged.join}"
         end
 
         expected = [1, 6, 9, 2, 3, 4, 5]
@@ -299,7 +297,7 @@ module BerkeleyLibrary::Util
 
         merged = Arrays.merge(a1, a2)
         [a1, a2].each do |a|
-          expect(Arrays.ordered_superset?(superset: merged, subset: a)).to eq(true), "merge(#{[a1.join, a2.join].inspect}): #{a.join} not found in #{merged.join}"
+          expect(Arrays.ordered_superset?(superset: merged, subset: a)).to be(true), "merge(#{[a1.join, a2.join].inspect}): #{a.join} not found in #{merged.join}"
         end
 
         expected = [1, 2, 3, 4, 5, 6, 9]
@@ -319,7 +317,7 @@ module BerkeleyLibrary::Util
 
             merged = Arrays.merge(a1, a2)
             [a1, a2].each do |a|
-              expect(Arrays.ordered_superset?(superset: merged, subset: a)).to eq(true), "merge(#{[a1.join, a2.join].inspect}): #{a.join} not found in #{merged.join}"
+              expect(Arrays.ordered_superset?(superset: merged, subset: a)).to be(true), "merge(#{[a1.join, a2.join].inspect}): #{a.join} not found in #{merged.join}"
             end
           end
         end

data/spec/berkeley_library/util/files_spec.rb

@@ -14,42 +14,42 @@ module BerkeleyLibrary
       describe :file_exists? do
         it 'returns true for files that exist' do
           path = Pathname.new(tmpdir).join('exists').tap { |p| FileUtils.touch(p) }
-          expect(path.exist?).to eq(true) # just to be sure
+          expect(path.exist?).to be(true) # just to be sure
           path_str = path.to_s
 
-          expect(Files.file_exists?(path)).to eq(true)
-          expect(Files.file_exists?(path_str)).to eq(true)
+          expect(Files.file_exists?(path)).to be(true)
+          expect(Files.file_exists?(path_str)).to be(true)
         end
 
         it 'returns false for files that do not exist' do
           path = Pathname.new(tmpdir).join('not-exists')
-          expect(path.exist?).to eq(false) # just to be sure
+          expect(path.exist?).to be(false) # just to be sure
           path_str = path.to_s
 
-          expect(Files.file_exists?(path)).to eq(false)
-          expect(Files.file_exists?(path_str)).to eq(false)
+          expect(Files.file_exists?(path)).to be(false)
+          expect(Files.file_exists?(path_str)).to be(false)
         end
       end
 
       describe :parent_exists? do
         it 'returns true for paths whose parent exists' do
           parent = Pathname.new(tmpdir).join('parent').tap(&:mkdir)
-          expect(parent.exist?).to eq(true) # just to be sure
+          expect(parent.exist?).to be(true) # just to be sure
           path = parent.join('child')
           path_str = path.to_s
 
-          expect(Files.parent_exists?(path)).to eq(true)
-          expect(Files.parent_exists?(path_str)).to eq(true)
+          expect(Files.parent_exists?(path)).to be(true)
+          expect(Files.parent_exists?(path_str)).to be(true)
         end
 
         it 'returns false for paths whose parent does not' do
           parent = Pathname.new(tmpdir).join('parent')
-          expect(parent.exist?).to eq(false) # just to be sure
+          expect(parent.exist?).to be(false) # just to be sure
           path = parent.join('child')
           path_str = path.to_s
 
-          expect(Files.parent_exists?(path)).to eq(false)
-          expect(Files.parent_exists?(path_str)).to eq(false)
+          expect(Files.parent_exists?(path)).to be(false)
+          expect(Files.parent_exists?(path_str)).to be(false)
         end
       end
 
@@ -59,19 +59,19 @@ module BerkeleyLibrary
           FileUtils.touch(filename)
 
           File.open(filename, 'rb') do |out|
-            expect(Files.reader_like?(out)).to eq(true)
+            expect(Files.reader_like?(out)).to be(true)
           end
         end
 
         it 'returns true for a StringIO' do
           out = StringIO.new
-          expect(Files.reader_like?(out)).to eq(true)
+          expect(Files.reader_like?(out)).to be(true)
         end
 
         it 'returns true for a Tempfile' do
           out = Tempfile.new('out')
           begin
-            expect(Files.reader_like?(out)).to eq(true)
+            expect(Files.reader_like?(out)).to be(true)
           ensure
             out.close
             out.unlink
@@ -79,7 +79,7 @@ module BerkeleyLibrary
         end
 
         it 'returns false for something that is not reader-like' do
-          expect(Files.reader_like?('not an IO')).to eq(false)
+          expect(Files.reader_like?('not an IO')).to be(false)
         end
       end
 
@@ -88,19 +88,19 @@ module BerkeleyLibrary
           filename = File.join(tmpdir, 'out')
 
           File.open(filename, 'wb') do |out|
-            expect(Files.writer_like?(out)).to eq(true)
+            expect(Files.writer_like?(out)).to be(true)
           end
         end
 
         it 'returns true for a StringIO' do
           out = StringIO.new
-          expect(Files.writer_like?(out)).to eq(true)
+          expect(Files.writer_like?(out)).to be(true)
         end
 
         it 'returns true for a Tempfile' do
           out = Tempfile.new('out')
           begin
-            expect(Files.writer_like?(out)).to eq(true)
+            expect(Files.writer_like?(out)).to be(true)
           ensure
             out.close
             out.unlink
@@ -108,7 +108,7 @@ module BerkeleyLibrary
         end
 
         it 'returns false for something that is not writer-like' do
-          expect(Files.writer_like?('not an IO')).to eq(false)
+          expect(Files.writer_like?('not an IO')).to be(false)
         end
       end
     end

data/spec/berkeley_library/util/strings_spec.rb

@@ -6,7 +6,7 @@ module BerkeleyLibrary
       describe :ascii_numeric do
         it 'returns true for ASCII numeric strings' do
           str = '8675309'
-          expect(Strings.ascii_numeric?(str)).to eq(true)
+          expect(Strings.ascii_numeric?(str)).to be(true)
         end
 
         it 'returns false for non-ASCII numeric strings' do
@@ -16,7 +16,7 @@ module BerkeleyLibrary
           ]
           aggregate_failures 'non-ASCII numeric strings' do
             strs.each do |str|
-              expect(Strings.ascii_numeric?(str)).to eq(false), "Expected #{str.inspect} to be non-ASCII-numeric"
+              expect(Strings.ascii_numeric?(str)).to be(false), "Expected #{str.inspect} to be non-ASCII-numeric"
             end
           end
         end
@@ -29,7 +29,7 @@ module BerkeleyLibrary
           ]
           aggregate_failures 'ASCII mixed numeric and non-numeric strings' do
             strs.each do |str|
-              expect(Strings.ascii_numeric?(str)).to eq(false), "Expected #{str.inspect} to be non-ASCII-numeric"
+              expect(Strings.ascii_numeric?(str)).to be(false), "Expected #{str.inspect} to be non-ASCII-numeric"
             end
           end
         end

data/spec/berkeley_library/util/uris/head_check_spec.rb

@@ -0,0 +1,61 @@
+require 'spec_helper'
+require 'okcomputer'
+require 'berkeley_library/util/uris/head_check'
+require 'base64'
+
+module BerkeleyLibrary
+  module Util
+    RSpec.describe HeadCheck do
+      let(:url) { 'http://example.com' }
+      let(:check) { described_class.new(url) }
+      let(:mock_response) { instance_double(RestClient::Response) }
+
+      before do
+        allow(BerkeleyLibrary::Util::URIs).to receive(:head_response).and_return(mock_response)
+      end
+
+      describe '#perform_request' do
+        context 'without basic auth' do
+          it 'does not add Authorization header' do
+            check.perform_request
+            expect(BerkeleyLibrary::Util::URIs).not_to have_received(:head_response).with(anything, hash_including('Authorization' => anything), anything)
+          end
+
+          it 'calls URIs.head_response with the correct URL' do
+            check.perform_request
+            expect(BerkeleyLibrary::Util::URIs).to have_received(:head_response).with(URI(url), headers: {}, log: false, timeout: 5)
+          end
+        end
+
+        context 'with basic auth' do
+          let(:user) { 'user' }
+          let(:password) { 'pass' }
+
+          # Stub the configuration on the instance directly
+          before do
+            allow(check).to receive(:basic_auth_options).and_return([user, password])
+          end
+
+          it 'adds the Authorization header' do
+            expected_headers = { 'Authorization' => "Basic #{Base64.strict_encode64("#{user}:#{password}")}" }
+
+            check.perform_request
+            expect(BerkeleyLibrary::Util::URIs).to have_received(:head_response).with(URI(url), headers: expected_headers, log: false, timeout: 5)
+          end
+        end
+
+        context 'when URIs.head_response raises an error' do
+          let(:error_message) { 'Something went wrong' }
+
+          before do
+            allow(BerkeleyLibrary::Util::URIs).to receive(:head_response).and_raise(StandardError, error_message)
+          end
+
+          it 'raises an OkComputer::HttpCheck::ConnectionFailed error' do
+            expect { check.perform_request }.to raise_error(OkComputer::HttpCheck::ConnectionFailed, error_message)
+          end
+        end
+      end
+    end
+  end
+end

data/spec/berkeley_library/util/uris/requester_spec.rb

@@ -305,6 +305,13 @@ module BerkeleyLibrary
                   requester = Requester.new(:get, url)
                   expect { requester.make_request }.to raise_error(RestClient::ServiceUnavailable)
                 end
+
+                it "raises #{RestClient::Exceptions::Timeout} when the request times out" do
+                  url = 'http://example.edu/timeout'
+                  stub_request(:get, url).to_raise(RestClient::Exceptions::Timeout)
+
+                  expect { Requester.get(url, timeout: 10) }.to raise_error(RestClient::Exceptions::Timeout)
+                end
               end
             end
           end
@@ -374,6 +381,13 @@ module BerkeleyLibrary
             end
           end
 
+          it "raises #{RestClient::Exceptions::Timeout} when the request times out" do
+            url = 'http://example.edu/timeout'
+            stub_request(:head, url).to_raise(RestClient::Exceptions::Timeout)
+
+            expect { Requester.head(url, timeout: 10) }.to raise_error(RestClient::Exceptions::Timeout)
+          end
+
           it 'handles redirects' do
             url1 = 'https://example.org/'
             url2 = 'https://example.edu/'

metadata

@@ -1,14 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: berkeley_library-util
 version: !ruby/object:Gem::Version
-  version: 0.1.9
+  version: 0.3.0
 platform: ruby
 authors:
 - David Moles
+- maría a. matienzo
+- Jason Raitz
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-06-01 00:00:00.000000000 Z
+date: 2026-02-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: berkeley_library-logging
@@ -16,14 +18,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.3'
 - !ruby/object:Gem::Dependency
   name: rest-client
   requirement: !ruby/object:Gem::Requirement
@@ -72,14 +74,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: dotenv
   requirement: !ruby/object:Gem::Requirement
@@ -94,6 +96,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.7'
+- !ruby/object:Gem::Dependency
+  name: okcomputer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.19'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.19'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -126,58 +142,58 @@ dependencies:
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.39'
+        version: 1.78.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.39'
+        version: 1.78.0
 - !ruby/object:Gem::Dependency
   name: rubocop-rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.6.0
+        version: 0.7.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.6.0
+        version: 0.7.1
 - !ruby/object:Gem::Dependency
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.4.0
+        version: 3.6.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.4.0
+        version: 3.6.0
 - !ruby/object:Gem::Dependency
   name: ruby-prof
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.17.0
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.17.0
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -207,12 +223,16 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '3.12'
 description: A collection of miscellaneous Ruby routines for the UC Berkeley Library.
-email: dmoles@berkeley.edu
+email:
+- dmoles@berkeley.edu
+- matienzo@berkeley.edu
+- raitz@berkeley.edu
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - ".github/workflows/build.yml"
+- ".github/workflows/gem-push.yml"
 - ".gitignore"
 - ".idea/.gitignore"
 - ".idea/inspectionProfiles/Project_Default.xml"
@@ -225,11 +245,13 @@ files:
 - ".simplecov"
 - ".yardopts"
 - CHANGES.md
+- Dockerfile
 - Gemfile
 - LICENSE.md
 - README.md
 - Rakefile
 - berkeley_library-util.gemspec
+- docker-compose.yml
 - lib/berkeley_library/util.rb
 - lib/berkeley_library/util/arrays.rb
 - lib/berkeley_library/util/files.rb
@@ -242,6 +264,7 @@ files:
 - lib/berkeley_library/util/uris.rb
 - lib/berkeley_library/util/uris/appender.rb
 - lib/berkeley_library/util/uris/exceptions.rb
+- lib/berkeley_library/util/uris/head_check.rb
 - lib/berkeley_library/util/uris/requester.rb
 - lib/berkeley_library/util/uris/requester/class_methods.rb
 - lib/berkeley_library/util/uris/validator.rb
@@ -257,6 +280,7 @@ files:
 - spec/berkeley_library/util/stringios_spec.rb
 - spec/berkeley_library/util/strings_spec.rb
 - spec/berkeley_library/util/times_spec.rb
+- spec/berkeley_library/util/uris/head_check_spec.rb
 - spec/berkeley_library/util/uris/requester_spec.rb
 - spec/berkeley_library/util/uris/validator_spec.rb
 - spec/berkeley_library/util/uris_spec.rb
@@ -272,16 +296,16 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - "~>"
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: Miscellaneous Ruby utilities for the UC Berkeley Library