berkeley_library-tind 0.5.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24232cda73f63d90367c05453c325f468d6103d667e820671f19c251cabd3814
-  data.tar.gz: 98d09880d886d8f351f0a038b8513aefe5dfe5c3a72108f634d79f7ad2485506
+  metadata.gz: 7e02344bc1a5d5c119c860bd357dfac55753bc809149cef7a068941f0566682c
+  data.tar.gz: aaba20e6650860ef0d89619522264746f1e689800e20abde0247ca0a3c55bad2
 SHA512:
-  metadata.gz: 15c2560d8bee4b55fbb66a51f101afd731ef02bf542c7e4433ea0b095efa492a9b7429a7bb8929226079bb24a40a9f5e27432c6c855812a0a29d913d6877958e
-  data.tar.gz: 6133181a93ef7a1204e6c73ea56a5fdee80f40817bfbe87c3c03ed063ec070e8c6f50dff732bbd987e30b929c14ba6e0b056a0b259f8327273f24e7048a069dc
+  metadata.gz: c83767367a893dd418c47bc1a74e5d2bf362bceeb009af7427a5e1f240dd4cb5ab57b8c032295e6e253dd5f71f5b512fd2bf112b1734a80d22d62a06b92d6c28
+  data.tar.gz: 224863c5c06224dbc4c2caae4e73c7f1752ee1f5303a758af1428667a938bb561a2d97e0a31306627cd37325e4518d4f674e22d270f2bcd40e631b90265eb62f

data/.github/workflows/build.yml

@@ -10,9 +10,21 @@ jobs:
     runs-on: ${{ matrix.os }}
 
     steps:
-      - uses: actions/checkout@v2
-      - uses: ruby/setup-ruby@v1
+      - name: Check out repository
+        uses: actions/checkout@v2
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby }}
           bundler-cache: true # runs 'bundle install' and caches installed gems automatically
-      - run: bundle exec rake
+
+      - name: Run checks
+        run: bundle exec rake
+
+      - name: Upload artifacts
+        if: ${{ always() }}
+        uses: actions/upload-artifact@v3
+        with:
+          name: artifacts
+          path: artifacts/**

data/.gitignore

@@ -7,6 +7,9 @@
 # Additional IDEA/RubyMine ignores
 .idea/.rakeTasks
 
+# Visual Studio Code ignores
+.vscode
+
 # Don't commit Gemfile.lock for libraries
 Gemfile.lock
 

data/.idea/inspectionProfiles/Project_Default.xml

@@ -10,6 +10,14 @@
     <inspection_tool class="LanguageDetectionInspection" enabled="false" level="WARNING" enabled_by_default="false" />
     <inspection_tool class="Rubocop" enabled="false" level="WARNING" enabled_by_default="false" />
     <inspection_tool class="RubyCaseWithoutElseBlockInspection" enabled="false" level="WARNING" enabled_by_default="false" />
+    <inspection_tool class="RubyClassMethodNamingConvention" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
+    <inspection_tool class="RubyClassModuleNamingConvention" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
+    <inspection_tool class="RubyClassVariableNamingConvention" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
+    <inspection_tool class="RubyConstantNamingConvention" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
+    <inspection_tool class="RubyGlobalVariableNamingConvention" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
+    <inspection_tool class="RubyInstanceMethodNamingConvention" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
+    <inspection_tool class="RubyInstanceVariableNamingConvention" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
+    <inspection_tool class="RubyLocalVariableNamingConvention" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
     <inspection_tool class="RubyMismatchedArgumentType" enabled="true" level="WARNING" enabled_by_default="true">
       <option name="myCheckNilability" value="false" />
     </inspection_tool>
@@ -28,6 +36,8 @@
     <inspection_tool class="RubyMismatchedVariableType" enabled="true" level="WARNING" enabled_by_default="true">
       <option name="myCheckNilability" value="false" />
     </inspection_tool>
+    <inspection_tool class="RubyNilAnalysis" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
+    <inspection_tool class="RubyParameterNamingConvention" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
     <inspection_tool class="RubyStringKeysInHashInspection" enabled="true" level="INFORMATION" enabled_by_default="true" />
     <inspection_tool class="SpellCheckingInspection" enabled="false" level="TYPO" enabled_by_default="false">
       <option name="processCode" value="true" />

data/.idea/tind.iml

@@ -9,15 +9,16 @@
     </content>
     <orderEntry type="jdk" jdkName="RVM: ruby-2.7.5" jdkType="RUBY_SDK" />
     <orderEntry type="sourceFolder" forTests="false" />
-    <orderEntry type="library" scope="PROVIDED" name="actionpack (v7.0.2.3, RVM: ruby-2.7.5) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="actionview (v7.0.2.3, RVM: ruby-2.7.5) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="activesupport (v7.0.2.3, RVM: ruby-2.7.5) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="actionpack (v7.0.2.4, RVM: ruby-2.7.5) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="actionview (v7.0.2.4, RVM: ruby-2.7.5) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="activesupport (v7.0.2.4, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="addressable (v2.8.0, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="amazing_print (v1.4.0, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="ast (v2.4.2, RVM: ruby-2.7.5) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="berkeley_library-alma (v0.0.4, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="berkeley_library-logging (v0.2.6, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="berkeley_library-marc (v0.3.1, RVM: ruby-2.7.5) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="berkeley_library-util (v0.1.1, RVM: ruby-2.7.5) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="berkeley_library-util (v0.1.2, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="builder (v3.2.4, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="bundle-audit (v0.1.0, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="bundler (v2.2.31, RVM: ruby-2.7.5) [gem]" level="application" />
@@ -39,15 +40,15 @@
     <orderEntry type="library" scope="PROVIDED" name="http-cookie (v1.0.4, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="i18n (v1.10.0, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="ice_nine (v0.11.2, RVM: ruby-2.7.5) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="lograge (v0.11.2, RVM: ruby-2.7.5) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="loofah (v2.15.0, RVM: ruby-2.7.5) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="lograge (v0.12.0, RVM: ruby-2.7.5) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="loofah (v2.17.0, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="marc (v1.1.1, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="method_source (v1.0.0, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="mime-types (v3.4.1, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="mime-types-data (v3.2022.0105, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="minitest (v5.15.0, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="netrc (v0.11.0, RVM: ruby-2.7.5) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="nokogiri (v1.13.1, RVM: ruby-2.7.5) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="nokogiri (v1.13.5, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="oj (v3.13.11, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="ougai (v1.9.1, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="parallel (v1.21.0, RVM: ruby-2.7.5) [gem]" level="application" />
@@ -59,7 +60,7 @@
     <orderEntry type="library" scope="PROVIDED" name="rack-test (v1.1.0, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="rails-dom-testing (v2.0.3, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="rails-html-sanitizer (v1.4.2, RVM: ruby-2.7.5) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="railties (v7.0.2.3, RVM: ruby-2.7.5) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="railties (v7.0.2.4, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="rainbow (v3.1.1, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="rake (v13.0.6, RVM: ruby-2.7.5) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="rchardet (v1.8.0, RVM: ruby-2.7.5) [gem]" level="application" />
@@ -110,7 +111,7 @@
           </RakeTaskImpl>
           <RakeTaskImpl description="Run all specs in spec directory, with coverage" fullCommand="coverage" id="coverage" />
           <RakeTaskImpl description="Run tests, check test coverage, check code style, check for vulnerabilities, build gem" fullCommand="default" id="default" />
-          <RakeTaskImpl description="Build berkeley_library-tind.gemspec as berkeley_library-tind-0.4.3.gem" fullCommand="gem" id="gem" />
+          <RakeTaskImpl description="Build berkeley_library-tind.gemspec as berkeley_library-tind-0.6.0.gem" fullCommand="gem" id="gem" />
           <RakeTaskImpl description="Run RuboCop with auto-correct, and output results to console" fullCommand="ra" id="ra" />
           <RakeTaskImpl description="Run rubocop with HTML output" fullCommand="rubocop" id="rubocop" />
           <RakeTaskImpl id="rubocop">

data/.rubocop.yml

@@ -331,4 +331,4 @@ Style/SwapValues: # (new in 1.1)
 Gemspec/DateAssignment: # (new in 1.10)
   Enabled: true
 Style/HashConversion: # (new in 1.10)
-  Enabled: true
+  Enabled: true

data/CHANGES.md

@@ -1,4 +1,18 @@
-# 0.5.1 (2023-03-23)
+# 0.7.0 (2022-10-26)
+
+- Preserves subfield order insofar as possible when mapping Alma records to TIND.
+- Adds collection-specific configuration for mapping Alma records to TIND.
+- Adds `BerkeleyLibrary::TIND::Mapping::TindRecordUtil` class for manipulating
+  subfields in TIND MARC records.
+- Removes `BerkeleyLibrary::Util::Files` class, which is now part of `berkeley_library-util`.
+
+# 0.6.0 (2022-04-06)
+
+- Adds `BerkeleyLibrary::TIND::Mapping` module to map MARC records from Alma to TIND.
+- `BerkeleyLibrary::TIND::MARC::XMLWriter` now assumes that any object that response to `:write`
+  and `:close` is suffiently `IO`-like to write to.
+
+# 0.5.1 (2022-03-23)
 
 - Fix an issue where `BerkeleyLibrary::TIND::MARC::XMLWriter` would drop fields with nonstandard tags (e.g. `FFT` fields)
   and would group and sort fields by tag instead of preserving the original order.

data/README.md

@@ -30,7 +30,7 @@ To access the TIND API, you will need to set:
    it a "key", so that's the term we use here.)
 
 These can be set directly, via accessors in the `BerkeleyLibrary::TIND::Config` module;
-if they are not set, a value will be read from the environment, and if no 
+if they are not set, a value will be read from the environment, and if no
 value is present in the environment and Rails is loaded, from the Rails
 application configuration (`Rails.application.config`).
 
@@ -43,9 +43,18 @@ application configuration (`Rails.application.config`).
 object, but will always be returned as a `URI` object, and an invalid
 string setting will raise `URI::InvalidURIError`.
 
+### Alma configuration
+
+When mapping Alma records to TIND (see below), this gem uses
+[`berkeley_library-alma`](https://github.com/BerkeleyLibrary/alma) to load
+Alma records. The scripts in the `bin` directory use the default Alma
+configuration; see the `berkeley_library-alma`
+[README](https://github.com/BerkeleyLibrary/alma#configuration) for
+details.
+
 ## Command-line tool: `tind-export`
 
-The `tind-export` command allows you to list TIND collections, or to 
+The `tind-export` command allows you to list TIND collections, or to
 export a TIND collection from the command line. (If the gem is installed,
 `tind-export` should be in your `$PATH`. If you've cloned the gem source,
 you can invoke it with `bin/tind-export` from the project root directory.)
@@ -85,3 +94,157 @@ For the full list of options, type `tind-export --help`. Note that you can set
 the TIND base URL and API key either via the environment, as above, or as options
 passed to the `tind-export` command. If both an explicit option and an environment
 variable are set for either, the explicit option takes precedence.
+
+## Mapping MARC records from Alma to TIND
+
+### Transforming Class:
+
+1. BerkeleyLibrary::TIND::Mapping::AlmaSingleTIND    (Transforming one Alma record => One TIND record)
+2. BerkeleyLibrary::TIND::Mapping::AlmaMultipleTIND  (Transforming one Alma record => Multiple TIND records)
+
+### Source of TIND fields
+
+1. Mapped from an Alma record (automatically)
+
+2. Derived from collection information, mms_id, and date (automatically)
+
+    - 336$a
+    - 852$c
+    - 980$a
+    - 982$a,$b
+    - 991$a - (optional)
+    - 902$d
+    - 901$m
+    - 85641$u,$y
+
+3. Added at the time of transforming TIND record (fields of a collection or its record)
+
+    - FFT
+    - 035$a
+    - 998$a
+    - ...
+
+### Example
+
+1. Setup collection information
+
+   Include below collection level fields:
+   - 336:  type of resource
+   - 852:  collection's repository name
+   - 980:  collection's 980 value
+   - 982:  collection's short name and long name
+   - 991:  collection' restricted name (optional)
+
+``` ruby
+
+def setup_collection
+  # 1. Define collection level field information
+  BerkeleyLibrary::TIND::Mapping::AlmaBase.collection_parameter_hash = {
+    '336' => ['Image'],
+    '852' => ['East Asian Library'],
+    '980' => ['pre_1912'],
+    '982' => ['Pre 1912 Chinese Materials - short name', 'Pre 1912 Chinese Materials - long name'],
+    '991' => []
+  }
+
+  # 2. A flag to include a pre-defined 035 formated in "(980__$a)mms_id",
+  #    the default value is 'false'
+  # BerkeleyLibrary::TIND::Mapping::AlmaBase.is_035_from_mms_id = true  
+
+  # 3. A flag on getting Alma record using Barcode, the defalut value is 'false'
+  # BerkeleyLibrary::TIND::Mapping::AlmaBase.is_barcode = true    
+
+  # 4. Define a list of origin tags from an Alma record.
+  #    Only those related fields (including 880 fields) will be mapped to a TIND record.
+  #    The default value is []. '001', '008' will be included by default, no need to be listed here.
+  # BerkeleyLibrary::TIND::Mapping::AlmaBase.excluding_origin_tags = %w[256]
+
+  # 5. Define a list of origin tags from an Alma record which will be excluded during mapping.
+  #    The default value is []
+  #       1) When the list includes an 880 tag, all 880 fields will be excluded
+  #       2) When the list has no 880 tag, only related 880 fields will be excludded
+  # BerkeleyLibrary::TIND::Mapping::AlmaBase.including_origin_tags = %w[245 700]
+
+  # 6. Not allow to define both #5 and #6. Returning empty fields when defining both #5 and #6
+
+end
+```
+
+2. Praparing additional fields
+
+    Adding field using:
+    -  field methods from module:  BerkeleyLibrary::TIND::Mapping::TindField
+    -  Or the original method from Ruby Marc when field method found in above module  
+        ::MARC::DataField.new(tag, indicator1, indicator, [code1, value1], [code2, value2] ...)
+
+```ruby
+
+def additional_tind_fields_1
+  txt = 'v001_0064'
+  url = 'https://digitalassets.lib.berkeley.edu/pre1912ChineseMaterials/ucb/ready/991032333019706532/991032333019706532_v001_0064.jpg'
+  fft = BerkeleyLibrary::TIND::Mapping::TindField.f_fft(url, txt)
+
+  f = ::MARC::DataField.new('998', ' ', ' ', ['a', 'fake-value'])
+  [fft] << f
+end
+
+def additional_tind_fields_2
+  txt = 'v001_0065'
+  url = 'https://digitalassets.lib.berkeley.edu/pre1912ChineseMaterials/ucb/ready/991032333019706532/991032333019706532_v001_0065.jpg'
+  fft = BerkeleyLibrary::TIND::Mapping::TindField.f_fft(url, txt)
+  [fft]
+end
+```
+
+3. Transforming one Alma record => One TIND record
+
+```ruby
+setup_collection
+
+# id can be  1)mms_id;  2)Millennium no ; or 3)Barcode
+id = 'C084093187'
+
+alma_tind = BerkeleyLibrary::TIND::Mapping::AlmaSingleTIND.new
+tind_record = alma_tind.record(id, additional_tind_fields_1)
+```
+
+
+4. Or transforming one Alma record => Multiple TIND records
+
+``` ruby
+setup_collection
+
+# id can be 1) mms_id; 2) Millennium bib number; or 3) Item barcode
+# id = '991085821143406532'
+id = 'C084093187'
+
+alma_tind = BerkeleyLibrary::TIND::Mapping::AlmaMultipleTIND.new(id)
+tind_record_1 = alma_tind.record(additional_tind_fields_1)
+tind_record_2 = alma_tind.record(additional_tind_fields_2)
+```
+
+5. Updating TIND record with TindRecordUtil : 1) add/update subfields to one-occurrenced field; 2) remove fields.
+
+``` ruby
+# 5.1 This is an example hash for updating/adding subfields.  
+tag_subfield_hash = { '245' => { 'b' => 'subtitle', 'a' => 'title' }, '336' => { 'a' => 'Audio' }, '246' => {'a' => nil}}
+
+# if 245__$b existed, it will be replaced it with 'subtitle';
+# otherwise, adding a new 245__$b subfield with value 'subtile';
+# '246' => {'a' => nil}, since value is nil, it won't add/update 246__$a
+
+# 5.2 This is an example array of removing fields.
+fields_removal_list = [%w[856 4 1] %w[260 _ _]]
+
+# Each item includes field information: [tag, indicator1, indictor2].
+# if indicator is empty, using '_'
+
+# How to use it:
+    #   a.  add/update subfields of existed fields in a TIND Marc record:
+            new_record = BerkeleyLibrary::TIND::Mapping::TindRecordUtil.update_record(record, tag_subfield_hash)
+    #   b.  remove a list of fields in a TIND Marc record:
+            new_record = BerkeleyLibrary::TIND::Mapping::TindRecordUtil.update_record(record, nil, fields_removal_list)
+    #   c.  both a. and b. :
+            new_record = BerkeleyLibrary::TIND::Mapping::TindRecordUtil.update_record(record, tag_subfield_hash, fields_removal_list)
+
+```

data/berkeley_library-tind.gemspec

@@ -17,15 +17,15 @@ Gem::Specification.new do |spec|
   spec.homepage = BerkeleyLibrary::TIND::ModuleInfo::HOMEPAGE
 
   spec.files = `git ls-files -z`.split("\x0")
-  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ['lib']
   spec.executables << 'tind-export'
 
   spec.required_ruby_version = ruby_version
 
+  spec.add_dependency 'berkeley_library-alma', '~> 0.0.1'
   spec.add_dependency 'berkeley_library-logging', '~> 0.2'
   spec.add_dependency 'berkeley_library-marc', '~> 0.3.0', '>= 0.3.1'
-  spec.add_dependency 'berkeley_library-util', '~> 0.1'
+  spec.add_dependency 'berkeley_library-util', '~> 0.1', '>= 0.1.2'
   spec.add_dependency 'ice_nine', '~> 0.11'
   spec.add_dependency 'marc', '~> 1.0'
   spec.add_dependency 'rchardet', '~> 1.8'

data/bin/alma-multiple-tind

@@ -0,0 +1,50 @@
+#!/usr/bin/env ruby
+
+begin
+  # This should work if (1) the gem is installed, or
+  # (2) we're in development and used `bundle exec`
+  require 'berkeley_library/tind'
+  require 'berkeley_library/alma'
+rescue LoadError
+  # If we're in development, `require 'bundler/setup'`
+  # is roughly equivalent to `bundle exec`
+  require 'bundler/setup'
+  require 'berkeley_library/tind'
+  require 'berkeley_library/alma'
+end
+
+def setup
+  # set collection name information
+  BerkeleyLibrary::TIND::Mapping::AlmaBase.collection_parameter_hash = {
+    '336' => ['Image'],
+    '852' => ['East Asian Library'],
+    '980' => ['pre_1912'],
+    '982' => ['Pre 1912 Chinese Materials - short name', 'Pre 1912 Chinese Materials - long name'],
+    '991' => []
+  }
+
+  # flag: set it to true if using barcode getting Alma record; default is false
+  # BerkeleyLibrary::TIND::Mapping::AlmaBase.is_barcode = true
+end
+
+def additional_tind_fields
+  txt = 'v001_0064'
+  url = 'https://digitalassets.lib.berkeley.edu/pre1912ChineseMaterials/ucb/ready/991032333019706532/991032333019706532_v001_0064.jpg'
+  fft = BerkeleyLibrary::TIND::Mapping::TindField.f_fft(url, txt)
+  datafields = [fft]
+
+  f_035 = BerkeleyLibrary::TIND::Mapping::TindField.f_035_from_alma_id('pre_1912', '991085821143406532')
+  datafields << f_035
+end
+
+###########  Use this, when creating multiple TIND records from a single Alma record  ############
+alma_id = '991085821143406532'
+# alma_id = '99108582114340653'  # a bad alma_id
+# alma_id = '991084606989706532' # Host histrical record
+
+setup
+
+BerkeleyLibrary::Alma::Config.default!
+alma_multiple_tind = BerkeleyLibrary::TIND::Mapping::AlmaMultipleTIND.new(alma_id)
+tind_record = alma_multiple_tind.record(additional_tind_fields)
+alma_multiple_tind.save_tind_record_to_file(tind_record, 'tmp/multiple.xml')

data/bin/alma-single-tind

@@ -0,0 +1,48 @@
+#!/usr/bin/env ruby
+
+begin
+  # This should work if (1) the gem is installed, or
+  # (2) we're in development and used `bundle exec`
+  require 'berkeley_library/tind'
+  require 'berkeley_library/alma'
+rescue LoadError
+  # If we're in development, `require 'bundler/setup'`
+  # is roughly equivalent to `bundle exec`
+  require 'bundler/setup'
+  require 'berkeley_library/tind'
+  require 'berkeley_library/alma'
+end
+
+def setup
+  BerkeleyLibrary::TIND::Mapping::AlmaBase.collection_parameter_hash = {
+    '336' => ['Image'],
+    '852' => ['East Asian Library'],
+    '980' => ['pre_1912'],
+    '982' => ['Pre 1912 Chinese Materials - short name', 'Pre 1912 Chinese Materials - long name'],
+    '991' => []
+  }
+  BerkeleyLibrary::TIND::Mapping::AlmaBase.is_035_from_mms_id = true
+  BerkeleyLibrary::TIND::Mapping::AlmaBase.is_barcode = false
+end
+
+def additional_tind_fields
+  txt = 'v001_0064'
+  url = 'https://digitalassets.lib.berkeley.edu/pre1912ChineseMaterials/ucb/ready/991032333019706532/991032333019706532_v001_0064.jpg'
+  fft = BerkeleyLibrary::TIND::Mapping::TindField.f_fft(url, txt)
+  f = ::MARC::DataField.new('998', ' ', ' ', ['a', 'fake-value'])
+  [fft] << f
+end
+
+############## Use this, when creating a TIND record from each Alma record ############
+# alma_id = '991085821143406532'
+# alma_id_bad = '99108582114340653' # a bad alma_id
+# alma_id_not_qualified = '991084606989706532' # Host historical record
+barcode = 'C084093187'
+
+id = barcode
+setup
+
+BerkeleyLibrary::Alma::Config.default!
+alma_single_tind = BerkeleyLibrary::TIND::Mapping::AlmaSingleTIND.new
+tind_record = alma_single_tind.record(id, additional_tind_fields)
+alma_single_tind.save_tind_record_to_file(id, tind_record, 'tmp/test_single.xml')

data/bin/save_tind_records

@@ -0,0 +1,80 @@
+#!/usr/bin/env ruby
+
+begin
+  # This should work if (1) the gem is installed, or
+  # (2) we're in development and used `bundle exec`
+  require 'berkeley_library/tind'
+  require 'berkeley_library/alma'
+rescue LoadError
+  # If we're in development, `require 'bundler/setup'`
+  # is roughly equivalent to `bundle exec`
+  require 'bundler/setup'
+  require 'berkeley_library/tind'
+  require 'berkeley_library/alma'
+end
+
+def setup
+  BerkeleyLibrary::TIND::Mapping::AlmaBase.collection_parameter_hash = {
+    '336' => ['Image'],
+    '852' => ['Bioscience, Natural Resources & Public Health Library'],
+    '980' => ['Forestry'],
+    '982' => ['Forestry', 'Forestry'],
+    '991' => []
+  }
+
+  # BerkeleyLibrary::TIND::Mapping::AlmaBase.is_barcode = true
+end
+
+def fake_additional_tind_fields1
+  fields = []
+  txt = '001'
+  url = 'https://digitalassets.lib.berkeley.edu/forestry/ucb/images/b142086125_i180839998/b142086125_i180839998_001.jpg'
+  fft = BerkeleyLibrary::TIND::Mapping::TindField.f_fft(url, txt)
+  f_998 = ::MARC::DataField.new('998', ' ', ' ', ['a', 'fake-value'])
+  f_035 = BerkeleyLibrary::TIND::Mapping::TindField.f_035('b142086125')
+  fields << f_998
+  fields << f_035
+  fields << fft
+end
+
+def fake_additional_tind_fields2
+  fields = []
+  txt = '002'
+  url = 'https://digitalassets.lib.berkeley.edu/forestry/ucb/images/b142086125_i180839998/b142086125_i180839998_002.jpg'
+  fft = BerkeleyLibrary::TIND::Mapping::TindField.f_fft(url, txt)
+
+  f_998 = ::MARC::DataField.new('998', ' ', ' ', ['a', 'fake-value'])
+
+  f_035 = BerkeleyLibrary::TIND::Mapping::TindField.f_035('b142107827')
+  fields << f_998
+  fields << f_035
+  fields << fft
+end
+
+def tind_records
+  records = []
+  alma_tind = BerkeleyLibrary::TIND::Mapping::AlmaSingleTIND.new
+
+  record1 = alma_tind.record('b142086125', fake_additional_tind_fields1)
+  record2 = alma_tind.record('b142107827', fake_additional_tind_fields2)
+  records << record1
+  records << record2
+end
+
+def save_batch(file, with_tind_xmlwritter)
+  setup
+  writer = ::MARC::XMLWriter.new(file)
+  writer = BerkeleyLibrary::TIND::MARC::XMLWriter.new(file) if with_tind_xmlwritter
+
+  tind_records.each do |record|
+    record.leader = nil if with_tind_xmlwritter
+    writer.write(record)
+  end
+  writer.close
+end
+
+# save with tind xmlwritter
+save_batch('tmp/test_tind_xmlwritter.xml', true)
+
+# save with Marc xmlwritter
+save_batch('tmp/test_marc_xmlwritter.xml', false)

data/bin/tind-marc

@@ -0,0 +1,73 @@
+#!/usr/bin/env ruby
+
+begin
+  # This should work if (1) the gem is installed, or
+  # (2) we're in development and used `bundle exec`
+  require 'berkeley_library/tind'
+  require 'berkeley_library/alma'
+rescue LoadError
+  # If we're in development, `require 'bundler/setup'`
+  # is roughly equivalent to `bundle exec`
+  require 'bundler/setup'
+  require 'berkeley_library/tind'
+  require 'berkeley_library/alma'
+end
+
+# 1. get Alma record
+BerkeleyLibrary::Alma::Config.default!
+# oskicat_num = 'b11082434'
+# alma_num = '991011084939706532'
+# alma no 880 field
+alma_num = '991085821143406532'
+
+# alma no 880 field
+# alma_num =  '991039355849706532'
+record_id = BerkeleyLibrary::Alma::RecordId.parse(alma_num)
+oskicat_record = record_id.get_marc_record
+
+# 2. get collection information fields
+# This information from "collection name" table on share driver
+collection_parameters = {
+  '336' => ['Image'],
+  '852' => ['East Asian Library'],
+  '980' => ['pre_1912'],
+  '982' => ['Pre 1912 Chinese Materials', 'Pre 1912 Chinese Materials'],
+  '991' => []
+}
+
+collection_tind_fields = BerkeleyLibrary::TIND::Mapping::ExternalTindField.tind_fields_from_collection_information(collection_parameters)
+
+# 3. get other external tind fields
+other_external_tind_fields = []
+tind_fields_from_alma_id = BerkeleyLibrary::TIND::Mapping::ExternalTindField.tind_mms_id_fields('991011084939706532')
+
+other_external_tind_fields.concat tind_fields_from_alma_id
+
+# 4. get fft fields
+
+new_subfield1 = BerkeleyLibrary::TIND::Mapping::Util.subfield('a', 'https://digitalassets.lib.berkeley.edu/pre1912ChineseMaterials/ucb/ready/991032333019706532/991032333019706532_v001_0064.jpg')
+new_subfield2 = BerkeleyLibrary::TIND::Mapping::Util.subfield('d', 'v001_0064')
+fft_datafield = BerkeleyLibrary::TIND::Mapping::Util.datafield('FFT', [' ',  ' '], [new_subfield1, new_subfield2])
+ffts = [fft_datafield]
+
+# 5. put all external tind fields together
+external_tind_fields = collection_tind_fields
+external_tind_fields.concat other_external_tind_fields
+external_tind_fields.concat ffts
+
+# 6. create tind-marc object,
+tindmarc = BerkeleyLibrary::TIND::Mapping::TindMarc.new(oskicat_record)
+
+# 7. add external tind fields(these tind fields will paticipate in "additional process")
+tindmarc.tind_external_datafields = external_tind_fields
+
+##### output ####
+# 8. Get tind fields mapped from alma
+# tindmarc.tindfields
+
+# 9. get a tind record which including external tind fields
+# tindmarc.tind_record
+
+# 10. save the tind record to an xml file
+
+tindmarc.save('tmp/test.xml')

data/lib/berkeley_library/tind/export/ods_exporter.rb

@@ -67,12 +67,10 @@ module BerkeleyLibrary
 
         def header_cell_style_for(col_index)
           @header_cell_styles ||= []
-          @header_cell_styles[col_index] ||= begin
-            find_or_create_cell_style(
-              color: color_for(col_index),
-              font_weight: 'bold'
-            )
-          end
+          @header_cell_styles[col_index] ||= find_or_create_cell_style(
+            color: color_for(col_index),
+            font_weight: 'bold'
+          )
         end
 
         def find_or_create_cell_style(color:, font_weight: nil, wrap: false)