initial commit

Author: ldss-jm

.gitignore

@@ -0,0 +1,13 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+Gemfile.lock
+
+# rspec failure tracking
+.rspec_status

.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

.travis.yml

@@ -0,0 +1,7 @@
+---
+sudo: false
+language: ruby
+cache: bundler
+rvm:
+  - 2.3.3
+before_install: gem install bundler -v 2.0.2

Gemfile

@@ -0,0 +1,8 @@
+source 'https://rubygems.org'
+
+gem 'marc_to_argot', github: 'trln/marc-to-argot'
+gem 'sierra_postgres_utilities', github: 'UNC-Libraries/sierra-postgres-utilities'
+gem 'sierra_postgres_utilities-derivatives', github: 'UNC-Libraries/sierra-postgres-utilities-derivatives'
+
+# Specify your gem's dependencies in sierra_postgres_utilities-argot.gemspec
+gemspec

README.md

@@ -0,0 +1,28 @@
+# SierraPostgresUtilities::Argot
+
+[sierra_postgres_utilities gem](https://github.com/UNC-Libraries/sierra-postgres-utilities) addon to allow programmatic access to [Argot](https://github.com/trln/marc-to-argot) for a Sierra
+bib record (or TRLN Discovery bib).
+
+## Installation
+
+```bash
+bundle install
+bundle exec rake install
+```
+
+## Usage
+
+```ruby
+require 'sierra_postgres_utilities/argot'
+
+bib = Sierra::Data::Bib.first
+bib.argot
+  #=> {"record_data_source"=>["ILSMARC"], "publication_year"=>[1976],
+  #    "date_cataloged"=>["2004-10-01T04:00:00Z"], "language"=>["English"],
+  #    "lang_code"=>["eng"], "publisher"=>[{"value"=>"Black Sparrow Press"}],
+  #    "names"=>[{"name"=>"Kelly, Robert, 1935-", "type"=>"creator"}], ...
+
+trln = bib.trln_discovery_record
+trln.argot
+  #=> same as above
+```

Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "sierra_postgres_utilities/argot"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

lib/sierra_postgres_utilities/argot.rb

@@ -0,0 +1,22 @@
+require 'sierra_postgres_utilities'
+require 'sierra_postgres_utilities/derivatives'
+
+require 'marc_to_argot'
+
+module Sierra
+  # Allows programmatic access to Argot for a Sierra / TRLN Discovery bib.
+  module Argot
+    # marc_to_argot may appear differently (hyphens vs underscore) in the load
+    # path depending on whether or not bundler is involved
+    MTA_DATA_DIR =
+      File.join($LOAD_PATH.select { |x| x.match 'marc[-_]to[-_]argot' }.first,
+                'data')
+
+    COLLECTION = 'unc'.freeze
+
+    autoload :VERSION, 'sierra_postgres_utilities/argot/version'
+    autoload :Indexer, 'sierra_postgres_utilities/argot/indexer'
+
+    require 'sierra_postgres_utilities/argot/td_argot'
+  end
+end

lib/sierra_postgres_utilities/argot/indexer.rb

@@ -0,0 +1,78 @@
+module Sierra
+  module Argot
+    module TrajectLoader
+      # This module taken almost exactly from spec files of:
+      #   https://github.com/trln/marc-to-argot
+      # under the following license:
+      #
+      # The MIT License (MIT)
+      #
+      # Copyright (c) 2017 Luke Aeschleman
+      #
+      # 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.
+
+      def create_settings(collection, data_dir, extension)
+        spec = MarcToArgot::SpecGenerator.new(collection)
+        marc_source_type = extension == 'mrc' ? 'binary' : 'xml'
+        flatten_attributes = YAML.load_file("#{data_dir}/flatten_attributes.yml")
+        override = File.exist?("#{data_dir}/#{collection}/overrides.yml") ? YAML.load_file("#{data_dir}/#{collection}/overrides.yml") : []
+
+        {
+          'argot_writer.flatten_attributes' => flatten_attributes,
+          'argot_writer.pretty_print' => false,
+          'writer_class_name' => 'Traject::ArgotWriter',
+          'specs' => spec.generate_spec,
+          'processing_thread_pool' => 1,
+          'marc_source.type' => marc_source_type,
+          'marc_source.encoding' => 'utf-8',
+          'override' => override,
+          'log_level' => :error
+        }
+      end
+
+      def load_indexer(collection = 'argot', extension = 'xml')
+        data_dir = MTA_DATA_DIR
+        conf_files = ["#{data_dir}/extensions.rb", "#{data_dir}/argot/traject_config.rb", "#{data_dir}/#{collection}/traject_config.rb"]
+        indexer_class = MarcToArgot::Indexers.find(collection.to_sym)
+        traject_indexer = indexer_class.new create_settings(collection, data_dir, extension)
+        conf_files.each do |conf_path|
+          begin
+            traject_indexer.load_config_file(conf_path)
+          rescue Errno::ENOENT, Errno::EACCES => e
+            raise "Could not read configuration file '#{conf_path}', exiting..."
+          rescue Traject::Indexer::ConfigLoadError => e
+            raise e
+          rescue StandardError => e
+            raise e
+          end
+        end
+        traject_indexer
+      end
+    end
+
+    # A Traject Indexer to transform MARC into Argot
+    class Indexer
+      include TrajectLoader
+
+      def indexer
+        @indexer ||= load_indexer(COLLECTION, 'mrc')
+      end
+    end
+  end
+end

lib/sierra_postgres_utilities/argot/td_argot.rb

@@ -0,0 +1,32 @@
+module Sierra
+  module Argot
+    module TDArgot
+      def argot
+        @argot ||= TDArgot.argot(self)
+      end
+
+      # Transforms TRLN Discovery record's MARC into Argot
+      def self.argot(trln_rec)
+        indexer.map_record(trln_rec.altmarc)
+      end
+
+      def self.indexer
+        @indexer ||= Indexer.new.indexer
+      end
+    end
+  end
+
+  module Derivatives
+    class TRLNDiscoveryRecord
+      include Sierra::Argot::TDArgot
+    end
+  end
+
+  module Data
+    class Bib
+      def argot
+        @argot ||= trln_discovery_record.argot
+      end
+    end
+  end
+end

lib/sierra_postgres_utilities/argot/version.rb

@@ -0,0 +1,5 @@
+module Sierra
+  module Argot
+    VERSION = '1.0.0'.freeze
+  end
+end

sierra_postgres_utilities-argot.gemspec

@@ -0,0 +1,37 @@
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'sierra_postgres_utilities/argot/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'sierra_postgres_utilities-argot'
+  spec.version       = Sierra::Argot::VERSION
+  spec.authors       = ['ldss-jm']
+  spec.email         = ['[email protected]']
+
+  spec.summary       = 'Access Argot for a Sierra (or TRLN Discovery) bib'
+  spec.homepage      = 'https://github.com/UNC-Libraries/sierra-postgres-utilities-argot'
+
+  spec.metadata['allowed_push_host'] = "TODO: Set to 'http://mygemserver.com'"
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = spec.homepage
+  spec.metadata['changelog_uri'] = "#{spec.homepage}/releases"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+
+  spec.add_runtime_dependency 'marc_to_argot', '~> 0.4.0'
+  spec.add_runtime_dependency 'sierra_postgres_utilities', '~> 0.3.0'
+  spec.add_runtime_dependency 'sierra_postgres_utilities-derivatives', '~> 1.0.0'
+end

spec/sierra_postgres_utilities/argot_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+RSpec.describe Sierra::Argot do
+  it 'has a version number' do
+    expect(Sierra::Argot::VERSION).not_to be nil
+  end
+end

spec/sierra_postgres_utilities/td_argot_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+RSpec.describe Sierra do
+  let(:bib) { Sierra::Data::Bib.first }
+  let(:trln) { bib.trln_discovery_record }
+
+  describe Sierra::Derivatives::TRLNDiscoveryRecord do
+    describe '#argot' do
+      it 'returns hash of Argot json' do
+        expect(trln.argot['record_data_source']).to include 'ILSMARC'
+      end
+    end
+  end
+
+  describe Sierra::Data::Bib do
+    describe '#argot' do
+      it "returns hash of Argot json (for bib's TRLNDiscoveryRecord)" do
+        expect(bib.argot).to equal trln.argot
+      end
+    end
+  end
+end

spec/spec_helper.rb

@@ -0,0 +1,14 @@
+require 'bundler/setup'
+require 'sierra_postgres_utilities/argot'
+
+RSpec.configure do |config|
+  # Enable flags like --only-failures and --next-failure
+  config.example_status_persistence_file_path = '.rspec_status'
+
+  # Disable RSpec exposing methods globally on `Module` and `main`
+  config.disable_monkey_patching!
+
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+end