berkeley_library-av-core 0.4.0

data/.rubocop.yml

@@ -0,0 +1,241 @@
+inherit_mode:
+  merge:
+    - Exclude
+    - Include
+
+AllCops:
+  UseCache: false
+  # Exclude generated files
+  Exclude:
+    - 'bin/**/*'
+    - 'db/**/*'
+    - 'out/**/*'
+    # Exclude vendor files in GitHub build
+    - 'vendor/**/*'
+
+# Allow one line around block body (Layout/EmptyLines will still disallow two or more)
+Layout/EmptyLinesAroundBlockBody:
+  Enabled: false
+
+# Allow one line around class body (Layout/EmptyLines will still disallow two or more)
+Layout/EmptyLinesAroundClassBody:
+  Enabled: false
+
+# Allow one line around module body (Layout/EmptyLines will still disallow two or more)
+Layout/EmptyLinesAroundModuleBody:
+  Enabled: false
+
+# Reasonable line-length check; it's too easy for the cure to be worse than the disease
+Layout/LineLength:
+  Max: 150
+
+# Make indents consistent regardless of the lengths of variables and method names and whatnot
+Layout/MultilineMethodCallIndentation:
+  EnforcedStyle: indented
+
+# Produces monsters
+Layout/MultilineOperationIndentation:
+  Enabled: false
+
+# We meant to do that
+Naming/MemoizedInstanceVariableName:
+  Enabled: False
+
+# It works in context, trust us
+Naming/MethodParameterName:
+  Enabled: False
+
+# Confusing and weird
+Naming/VariableNumber:
+  Enabled: False
+
+# Whether vertical or horizontal is more readable depends on context
+Style/AccessorGrouping:
+  Enabled: false
+
+# Do what's readable in the context you're in
+Style/AccessModifierDeclarations:
+  Enabled: false
+
+# 👎 to cultural imperialism
+Style/AsciiComments:
+  Enabled: false
+
+#
+Style/ClassEqualityComparison:
+  Enabled: false
+
+# Seriously?
+Style/CommentedKeyword:
+  Enabled: False
+
+# Disable problematic module documentation check (see https://github.com/bbatsov/rubocop/issues/947)
+Style/Documentation:
+  Enabled: false
+
+# Adding more line noise to format strings will not improve them
+Style/FormatStringToken:
+  Enabled: false
+
+# Putting '# frozen_string_literal: true' everywhere does not make the world a better place
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+# Requiring the lambda() method just makes wordy calls wordier
+Style/Lambda:
+  EnforcedStyle: literal
+
+# `foo.positive?` is cute, but it's not actually more readable than `foo > 0`
+Style/NumericPredicate:
+  Enabled: false
+
+# Don't be unnecessarily redundant
+Style/ReturnNil:
+  Enabled: true
+  EnforcedStyle: return
+
+# Unclear why it's a good idea to give parameters semantically meaningless names
+Style/SingleLineBlockParams:
+  Enabled: false
+
+# The semantics of `foo&.bar` are a lot less interchangeable with `foo && foo.bar` than RuboCop thinks
+Style/SafeNavigation:
+  Enabled: false
+
+############################################################
+# Enable newer cops
+
+Style/HashEachMethods: # (new in 0.80)
+  Enabled: true
+Style/HashTransformKeys: # (new in 0.80)
+  Enabled: true
+Style/HashTransformValues: # (new in 0.80)
+  Enabled: true
+Lint/RaiseException: # (new in 0.81)
+  Enabled: true
+Lint/StructNewOverride: # (new in 0.81)
+  Enabled: true
+Layout/SpaceAroundMethodCallOperator: # (new in 0.82)
+  Enabled: true
+Style/ExponentialNotation: # (new in 0.82)
+  Enabled: false
+Layout/EmptyLinesAroundAttributeAccessor: # (new in 0.83)
+  Enabled: true
+Style/SlicingWithRange: # (new in 0.83)
+  Enabled: true
+Lint/DeprecatedOpenSSLConstant: # (new in 0.84)
+  Enabled: true
+Lint/MixedRegexpCaptureTypes: # (new in 0.85)
+  Enabled: true
+Style/RedundantRegexpCharacterClass: # (new in 0.85)
+  Enabled: true
+Style/RedundantRegexpEscape: # (new in 0.85)
+  Enabled: true
+Style/RedundantFetchBlock: # (new in 0.86)
+  Enabled: true
+Lint/DuplicateRegexpCharacterClassElement: # (new in 1.1)
+  Enabled: true
+Lint/EmptyBlock: # (new in 1.1)
+  Enabled: true
+Lint/ToEnumArguments: # (new in 1.1)
+  Enabled: true
+Lint/UnmodifiedReduceAccumulator: # (new in 1.1)
+  Enabled: true
+Style/ArgumentsForwarding: # (new in 1.1)
+  Enabled: true
+Style/DocumentDynamicEvalDefinition: # (new in 1.1)
+  Enabled: true
+Style/SwapValues: # (new in 1.1)
+  Enabled: true
+Lint/NoReturnInBeginEndBlocks: # (new in 1.2)
+  Enabled: true
+Style/CollectionCompact: # (new in 1.2)
+  Enabled: true
+Style/NegatedIfElseCondition: # (new in 1.2)
+  Enabled: true
+Lint/DuplicateBranch: # (new in 1.3)
+  Enabled: true
+Lint/EmptyClass: # (new in 1.3)
+  Enabled: true
+Style/NilLambda: # (new in 1.3)
+  Enabled: true
+Style/RedundantArgument: # (new in 1.4)
+  Enabled: true
+Lint/UnexpectedBlockArity: # (new in 1.5)
+  Enabled: true
+Layout/SpaceBeforeBrackets: # (new in 1.7)
+  Enabled: true
+Lint/AmbiguousAssignment: # (new in 1.7)
+  Enabled: true
+Style/HashExcept: # (new in 1.7)
+  Enabled: true
+Lint/DeprecatedConstants: # (new in 1.8)
+  Enabled: true
+Lint/LambdaWithoutLiteralBlock: # (new in 1.8)
+  Enabled: true
+Lint/RedundantDirGlobSort: # (new in 1.8)
+  Enabled: true
+Style/EndlessMethod: # (new in 1.8)
+  Enabled: true
+Lint/NumberedParameterAssignment: # (new in 1.9)
+  Enabled: true
+Lint/OrAssignmentToConstant: # (new in 1.9)
+  Enabled: true
+Lint/SymbolConversion: # (new in 1.9)
+  Enabled: true
+Lint/TripleQuotes: # (new in 1.9)
+  Enabled: true
+Style/IfWithBooleanLiteralBranches: # (new in 1.9)
+  Enabled: true
+Gemspec/DateAssignment: # (new in 1.10)
+  Enabled: true
+Style/HashConversion: # (new in 1.10)
+  Enabled: true
+Style/StringChars: # (new in 1.12)
+  Enabled: true
+Lint/EmptyInPattern: # (new in 1.16)
+  Enabled: true
+Style/InPatternThen: # (new in 1.16)
+  Enabled: true
+Style/MultilineInPatternThen: # (new in 1.16)
+  Enabled: true
+Style/QuotedSymbols: # (new in 1.16)
+  Enabled: true
+Layout/LineEndStringConcatenationIndentation: # (new in 1.18)
+  Enabled: true
+Naming/InclusiveLanguage: # (new in 1.18)
+  Enabled: true
+Lint/AmbiguousRange: # new in 1.19
+  Enabled: true
+Style/RedundantSelfAssignmentBranch: # new in 1.19
+  Enabled: true
+Lint/AmbiguousOperatorPrecedence: # new in 1.21
+  Enabled: true
+Lint/IncompatibleIoSelectWithFiberScheduler: # new in 1.21
+  Enabled: true
+Lint/RequireRelativeSelfPath: # new in 1.22
+  Enabled: true
+Security/IoMethods: # new in 1.22
+  Enabled: true
+Style/NumberedParameters: # new in 1.22
+  Enabled: true
+Style/NumberedParametersLimit: # new in 1.22
+  Enabled: true
+Style/SelectByRegexp: # new in 1.22
+  Enabled: true
+Gemspec/RequireMFA: # new in 1.23
+  Enabled: true
+Lint/UselessRuby2Keywords: # new in 1.23
+  Enabled: true
+Style/OpenStructUse: # new in 1.23
+  Enabled: true
+Naming/BlockForwarding: # new in 1.24
+  Enabled: true
+Style/FileRead: # new in 1.24
+  Enabled: true
+Style/FileWrite: # new in 1.24
+  Enabled: true
+Style/MapToHash: # new in 1.24
+  Enabled: true
+Style/NestedFileDirname: # new in 1.26
+  Enabled: true

data/.ruby-version

@@ -0,0 +1 @@
+3.1.3

data/.simplecov

@@ -0,0 +1,8 @@
+require 'simplecov-rcov'
+
+SimpleCov.start 'rails' do
+  add_filter 'module_info.rb'
+  coverage_dir 'artifacts'
+  formatter SimpleCov::Formatter::RcovFormatter
+  minimum_coverage 100
+end

data/CHANGES.md

@@ -0,0 +1,38 @@
+# 0.3.0 (2022-02-01)
+
+- Rename `Record#ucb_access?` and `Metadata#ucb_access?` to `calnet_or_ip?` for clarity.
+- Remove the following methods:
+  - `Record#player_link_text`
+  - `Metadata#player_link_text`
+  - `Metadata#player_url`
+- Remove the following constants:
+  - `AV::Constants::RESTRICTIONS_CALNET` 
+  - `AV::Constants::RESTRICTIONS_UCB_IP`
+  - `AV::Constants::RESTRICTIONS`
+  - `AV::Constants::RESTRICTIONS_NONE`
+
+# 0.2.3 (2022-01-05)
+
+- `Record#bib_number` and `Metadata#bib_number` now return nil instead of raising an
+  exception when the MARC field expected to contain a Millennium bib number contains
+  something else.
+
+# 0.2.2 (2022-01-03)
+
+- Add `Record#calnet_only?` in addition to `Record#ucb_access?`
+
+# 0.2.1 (2021-11-08)
+
+- Add `Metadata#calnet_only?` in addition to `Metadata#ucb_access?`
+- Support declaring restrictions in 998$r as well as 95640$z (Alma) or 85642$y (TIND)
+
+# 0.2.0 (2021-10-21)
+
+- Add Alma support
+- Remove Millennium support
+- Switch to [`BerkeleyLibrary/logging`](https://github.com/BerkeleyLibrary/logging)
+
+# 0.1.0 (2021-08-05)
+
+- Initial prerelease
+- Send a custom `User-Agent` header to deal with new TIND firewall rules.

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Jenkinsfile

@@ -0,0 +1,16 @@
+dockerComposePipeline(
+    commands: [
+        'bundle exec rake coverage',
+        'bundle exec rake rubocop',
+        'bundle exec rake bundle:audit',
+        'bundle exec rake gem'
+    ],
+    artifacts: [
+        junit: 'artifacts/rspec/**/*.xml',
+        html : [
+            'Code Coverage': 'artifacts/rcov',
+            'RuboCop'      : 'artifacts/rubocop'
+        ],
+        raw  : ['artifacts/**/*.gem']
+    ]
+)

data/LICENSE.md

@@ -0,0 +1,21 @@
+# The MIT License (MIT)
+
+Copyright © 2023 The Regents of the University of California
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the “Software”),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,20 @@
+# BerkeleyLibrary::AV::Core
+
+[![Build Status](https://github.com/BerkeleyLibrary/av-core/actions/workflows/build.yml/badge.svg?branch=main)](https://github.com/BerkeleyLibrary/av-core/actions/workflows/build.yml)
+[![Gem Version](https://img.shields.io/gem/v/berkeley_library-av-core.svg)](https://rubygems.org/gems/berkeley_library-av-core)
+
+Gem for UC Berkeley Library shared audio/video code.
+
+## Installation
+
+In your Gemfile:
+
+```ruby
+gem 'berkeley_library-av-core'
+```
+
+In your code:
+
+```ruby
+require 'berkeley_library/av/core'
+```

data/Rakefile

@@ -0,0 +1,20 @@
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('Gemfile', __dir__)
+require 'bundler/setup' # Set up gems listed in the Gemfile.
+
+# ------------------------------------------------------------
+# Application code
+
+File.expand_path('lib', __dir__).tap do |lib|
+  $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+end
+
+# ------------------------------------------------------------
+# CI
+
+ENV['RAILS_ENV'] = 'test' if ENV['CI']
+
+# ------------------------------------------------------------
+# Custom tasks
+
+desc 'Run tests, check test coverage, check code style, check for vulnerabilities, build gem'
+task default: %i[coverage rubocop bundle:audit gem]

data/av_core.gemspec

@@ -0,0 +1,49 @@
+File.expand_path('lib', __dir__).tap do |lib|
+  $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+end
+
+ruby_version_file = File.expand_path('.ruby-version', __dir__)
+ruby_version_exact = File.read(ruby_version_file).strip
+ruby_minor_version = ruby_version_exact.gsub(/^(\d+\.\d+).*/, '\1')
+
+require 'berkeley_library/av/core/module_info'
+
+Gem::Specification.new do |spec|
+  spec.name = BerkeleyLibrary::AV::Core::ModuleInfo::NAME
+  spec.author = BerkeleyLibrary::AV::Core::ModuleInfo::AUTHOR
+  spec.email = BerkeleyLibrary::AV::Core::ModuleInfo::AUTHOR_EMAIL
+  spec.summary = BerkeleyLibrary::AV::Core::ModuleInfo::SUMMARY
+  spec.description = BerkeleyLibrary::AV::Core::ModuleInfo::DESCRIPTION
+  spec.license = BerkeleyLibrary::AV::Core::ModuleInfo::LICENSE
+  spec.version = BerkeleyLibrary::AV::Core::ModuleInfo::VERSION
+  spec.homepage = BerkeleyLibrary::AV::Core::ModuleInfo::HOMEPAGE
+
+  spec.files = `git ls-files -z -- ':!:Dockerfile' ':!:docker-compose.yml'`.split("\x0")
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.required_ruby_version = ">= #{ruby_minor_version}"
+
+  spec.add_dependency 'berkeley_library-logging', '~> 0.2'
+  spec.add_dependency 'berkeley_library-marc', '~> 0.2', '>= 0.2.1'
+  spec.add_dependency 'berkeley_library-util', '~> 0.1', '>= 0.1.1'
+  spec.add_dependency 'ruby-marc-spec', '~> 0.1', '>= 0.1.3'
+  spec.add_dependency 'typesafe_enum', '~> 0.3'
+
+  spec.add_development_dependency 'brakeman', '~> 4.9'
+  spec.add_development_dependency 'bundle-audit', '~> 0.1'
+  spec.add_development_dependency 'ci_reporter_rspec', '~> 1.0'
+  spec.add_development_dependency 'colorize', '~> 0.8'
+  spec.add_development_dependency 'dotenv', '~> 2.7'
+  spec.add_development_dependency 'irb', '~> 1.2' # workaroundfor https://github.com/bundler/bundler/issues/6929
+  spec.add_development_dependency 'listen', '>= 3.0.5', '< 3.2'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rspec-support', '~> 3.9'
+  spec.add_development_dependency 'rubocop', '1.26.0'
+  spec.add_development_dependency 'rubocop-rake', '~> 0.6.0'
+  spec.add_development_dependency 'rubocop-rspec', '~> 2.4.0'
+  spec.add_development_dependency 'simplecov', '~> 0.21'
+  spec.add_development_dependency 'simplecov-rcov', '~> 0.2'
+  spec.add_development_dependency 'webmock', '~> 3.8'
+  spec.metadata['rubygems_mfa_required'] = 'true'
+end

data/lib/berkeley_library/av/config.rb

@@ -0,0 +1,238 @@
+require 'berkeley_library/util/uris'
+
+module BerkeleyLibrary
+  module AV
+    # rubocop:disable Metrics/ClassLength
+    class Config
+      REQUIRED_SETTINGS = %i[
+        avplayer_base_uri
+        alma_sru_host
+        alma_primo_host
+        alma_institution_code
+        alma_permalink_key
+        tind_base_uri
+        wowza_base_uri
+      ].freeze
+
+      class << self
+        include BerkeleyLibrary::Util
+
+        # Alma SRU hostname, e.g. UC Berkeley = berkeley.alma.exlibrisgroup.com
+        def alma_sru_host
+          @alma_sru_host ||= value_from_rails_config(:alma_sru_host)
+        end
+
+        # Alma institution code, e.g. UC Berkeley = 01UCS_BER
+        def alma_institution_code
+          @alma_institution_code ||= value_from_rails_config(:alma_institution_code)
+        end
+
+        # Alma Primo host, e.g. UC Berkeley = search.library.berkeley.edu
+        def alma_primo_host
+          @alma_primo_host ||= value_from_rails_config(:alma_primo_host)
+        end
+
+        # View state key to use when generating Alma permalinks, e.g. `iqob43`; see
+        # https://knowledge.exlibrisgroup.com/Primo/Knowledge_Articles/What_is_the_key_in_short_permalinks%3F
+        def alma_permalink_key
+          @alma_permalink_key ||= value_from_rails_config(:alma_permalink_key)
+        end
+
+        def alma_sru_base_uri
+          ensure_configured(:alma_sru_host, :alma_institution_code)
+
+          sru_base_uri_for(alma_sru_host, alma_institution_code)
+        end
+
+        def alma_permalink_base_uri
+          ensure_configured(:alma_primo_host, :alma_institution_code, :alma_permalink_key)
+
+          primo_permalink_base_uri_for(alma_primo_host, alma_institution_code, alma_permalink_key)
+        end
+
+        def avplayer_base_uri
+          @avplayer_base_uri ||= uri_from_rails_config(:avplayer_base_uri)
+        end
+
+        def tind_base_uri
+          @tind_base_uri ||= uri_from_rails_config(:tind_base_uri)
+        end
+
+        def wowza_base_uri
+          @wowza_base_uri ||= uri_from_rails_config(:wowza_base_uri)
+        end
+
+        # Sets the AV Player base URI
+        #
+        # @param [URI, String] uri the base URI
+        # @return [URI] the URI
+        # @raise URI::InvalidURIError if the URI cannot be parsed, or is not HTTP/HTTPS
+        def avplayer_base_uri=(uri)
+          @avplayer_base_uri = clean_uri(uri)
+        end
+
+        # Sets the Alma SRU hostname
+        #
+        # @param [String] hostname the hostname
+        # @return [String] the hostname
+        # @raise ArgumentError if the hostname is nil or empty
+        # @raise URI::InvalidURIError if the resulting SRU URI cannot be parsed
+        def alma_sru_host=(hostname)
+          raise ArgumentError, "Invalid hostname: #{hostname.inspect}" if hostname.nil? || hostname.empty?
+
+          sru_uri = sru_base_uri_for(hostname, '') # Catch bad URIs early
+          @alma_sru_host = sru_uri.host
+        end
+
+        # Sets the Alma Primo hostname
+        #
+        # @param [String] hostname the hostname
+        # @return [String] the hostname
+        # @raise ArgumentError if the hostname is nil or empty
+        # @raise URI::InvalidURIError if the resulting Primo permalink URI cannot be parsed
+        def alma_primo_host=(hostname)
+          raise ArgumentError, "Invalid hostname: #{hostname.inspect}" if hostname.nil? || hostname.empty?
+
+          primo_uri = primo_permalink_base_uri_for(hostname, 'XXX', 'abc123') # Catch bad URIs early
+          @alma_primo_host = primo_uri.host
+        end
+
+        # Sets the Alma SRU institution code
+        #
+        # @param [String] inst_code the institution code
+        # @return [String] the institution code
+        # @raise ArgumentError if the institution code is nil or empty
+        # @raise URI::InvalidURIError if the resulting SRU URI cannot be parsed
+        def alma_institution_code=(inst_code)
+          raise ArgumentError, "Invalid institution code: #{inst_code.inspect}" if inst_code.nil? || inst_code.empty?
+
+          sru_uri = sru_base_uri_for('example.org', inst_code) # Catch bad URIs early
+          @alma_institution_code = sru_uri.path.split('/').last
+        end
+
+        # Sets the Alma permalink key
+        #
+        # @param [String] permalink_key the permalink key
+        # @return [String] the permalink key
+        # @raise ArgumentError if the permalink key is nil or empty
+        # @raise URI::InvalidURIError if the resulting Primo permalink URI cannot be parsed
+        def alma_permalink_key=(permalink_key)
+          raise ArgumentError, "Invalid permalink key: #{permalink_key.inspect}" if permalink_key.nil? || permalink_key.empty?
+
+          sru_uri = primo_permalink_base_uri_for('example.org', 'XXX', permalink_key) # Catch bad URIs early
+          @alma_permalink_key = sru_uri.path.split('/').last
+        end
+
+        # Sets the TIND base URI
+        #
+        # @param [URI, String] uri the base URI
+        # @return [URI] the URI
+        # @raise URI::InvalidURIError if the URI cannot be parsed, or is not HTTP/HTTPS
+        def tind_base_uri=(uri)
+          @tind_base_uri = clean_uri(uri)
+        end
+
+        # Sets the Wowza base URI
+        #
+        # @param [URI, String] uri the base URI
+        # @return [URI] the URI
+        # @raise URI::InvalidURIError if the URI cannot be parsed, or is not HTTP/HTTPS
+        def wowza_base_uri=(uri)
+          @wowza_base_uri = clean_uri(uri)
+        end
+
+        # Returns the list of missing required settings.
+        # @return [Array<Symbol>] the missing settings.
+        def missing(*settings)
+          settings = REQUIRED_SETTINGS if settings.empty?
+          [].tap do |unset|
+            settings.each do |setting|
+              unset << setting unless set?(setting)
+            end
+          end
+        end
+
+        def ensure_configured(*settings)
+          return if (missing_settings = missing(*settings)).empty?
+
+          raise ArgumentError, "Missing AV configuration settings: #{missing_settings.join(', ')}"
+        end
+
+        private
+
+        def sru_base_uri_for(domain, inst_code)
+          URIs.append("https://#{domain}/view/sru/", inst_code)
+        end
+
+        def primo_permalink_base_uri_for(alma_primo_host, inst_code, key)
+          URIs.append("https://#{alma_primo_host}/", 'permalink', inst_code, key)
+        end
+
+        # Returns a URI
+        # @param [URI, String] url the base URL
+        # @return [URI] the URI
+        # @raise URI::InvalidURIError if the URI cannot be parsed, or is not HTTP/HTTPS
+        def clean_uri(url)
+          BerkeleyLibrary::Util::URIs.uri_or_nil(url).tap do |uri|
+            raise URI::InvalidURIError, 'url cannot be nil' unless uri
+            raise URI::InvalidURIError, 'URL must have a scheme' unless (scheme = uri.scheme)
+            raise URI::InvalidURIError, 'URL must be HTTP or HTTPS' unless scheme.start_with?('http')
+          end
+        end
+
+        def uri_from_rails_config(sym)
+          return unless (config = rails_config)
+
+          result = config.send(sym)
+          clean_uri(result)
+        end
+
+        # Gets the specified value from the Rails configuraiton
+        # @return [Object, nil] the value, or nil if there is no Rails configuration or the value is not set
+        def value_from_rails_config(sym)
+          return unless (config = rails_config)
+
+          config.send(sym)
+        end
+
+        def rails_config
+          return unless defined?(Rails)
+          return unless (application = Rails.application)
+
+          application.config
+        end
+
+        def set?(setting)
+          !Config.send(setting).nil?
+        end
+
+        def clear!
+          REQUIRED_SETTINGS.each do |attr|
+            ivar_name = "@#{attr}"
+            next unless instance_variable_defined?(ivar_name)
+
+            send(:remove_instance_variable, ivar_name)
+          end
+        end
+      end
+
+      private_class_method :new
+
+    end
+    # rubocop:enable Metrics/ClassLength
+
+    class << self
+      def config
+        AV::Config
+      end
+
+      def configure(&)
+        class_eval(&)
+      end
+
+      def configured?
+        Config.missing.empty?
+      end
+    end
+  end
+end

data/lib/berkeley_library/av/constants.rb

@@ -0,0 +1,30 @@
+module BerkeleyLibrary
+  module AV
+    module Constants
+      TAG_TITLE_FIELD = '245'.freeze
+      TAG_LINK_FIELD = '856'.freeze
+      TAG_TRACK_FIELD = '998'.freeze
+      TAG_TIND_ID = '001'.freeze
+
+      # TODO: use marc/spec
+      TAG_TIND_CATALOG_ID = '901'.freeze
+      SUBFIELD_CODE_TIND_BIB_NUMBER = 'm'.freeze
+
+      # TODO: use marc/spec
+      TAG_ALMA_MIGRATION_INFO = '996'.freeze
+      SUBFIELD_CODE_ALMA_BIB_NUMBER = 'a'.freeze
+
+      SUBFIELD_CODE_DURATION = :a
+      SUBFIELD_CODE_TITLE = :t
+      SUBFIELD_CODE_PATH = :g
+      SUBFIELD_CODES_TRACKS = [SUBFIELD_CODE_DURATION, SUBFIELD_CODE_TITLE, SUBFIELD_CODE_PATH].freeze
+
+      UNKNOWN_TITLE = 'Unknown title'.freeze
+
+      # '99' is the Alma prefix for a Metadata Management System ID
+      ALMA_RECORD_RE = /^(?<type>99)[0-9]{9,12}(?<institution>[0-9]{4})$/
+      MILLENNIUM_RECORD_RE = /^b(?<digits>[0-9]{8})(?<check>[0-9ax])?$/
+      OCLC_RECORD_RE = /^o[0-9]+$/
+    end
+  end
+end