mabmapper 1.0.0.pre15

data/test/mabmapper/test_secondary_form_creationdate.rb

@@ -0,0 +1,6 @@
+# coding: utf-8
+module TestSecondaryFormCreationdate
+  define_field_test '000806191', secondary_form_creationdate: nil
+  define_field_test '000844686', secondary_form_creationdate: '2001'
+  define_field_test '001452439', secondary_form_creationdate: '2012'
+end

data/test/mabmapper/test_secondary_form_isbn.rb

@@ -0,0 +1,6 @@
+# coding: utf-8
+module TestSecondaryFormIsbn
+  define_field_test '000806191', secondary_form_isbn: '3-8288-0675-9'
+  define_field_test '000844686', secondary_form_isbn: '3-8288-1141-8'
+  define_field_test '001452439', secondary_form_isbn: nil
+end

data/test/mabmapper/test_secondary_form_physical_description.rb

@@ -0,0 +1,5 @@
+# coding: utf-8
+module TestSecondaryFormPhysicalDescription
+  define_field_test '000806191', secondary_form_physical_description: '2 Mikrofiches : 24x'
+  define_field_test '001452439', secondary_form_physical_description: nil
+end

data/test/mabmapper/test_secondary_form_preliminary_phrase.rb

@@ -0,0 +1,5 @@
+# coding: utf-8
+module TestSecondaryFormPreliminaryPhrase
+  define_field_test '000806191', secondary_form_preliminary_phrase: 'Mikrofiche-Ausg.:'
+  define_field_test '001452439', secondary_form_preliminary_phrase: 'Digitalisierte Ausg.'
+end

data/test/mabmapper/test_secondary_form_publisher.rb

@@ -0,0 +1,5 @@
+# coding: utf-8
+module TestSecondaryFormPublisher
+  define_field_test '000806191', secondary_form_publisher: 'Marburg : Tectum-Verl.'
+  define_field_test '001452439', secondary_form_publisher: 'Paderborn : Universitätsbibliothek Paderborn'
+end

data/test/mabmapper/test_secondary_form_superorder.rb

@@ -0,0 +1,9 @@
+# coding: utf-8
+module TestSecondaryFormSuperorder
+  define_field_test '000806191', secondary_form_superorder: {"ht_number" => "HT006670284","label" => "Edition Wissenschaft : Reihe Chemie ; 240","volume_count" => "240"}
+  define_field_test '000977734', secondary_form_superorder: [
+    {"ht_number"=>nil, "label"=>"Zeitschriften der HAAB Weimar. Projekt Sicherungsverfilmung der HAAB Weimar", "volume_count"=>nil},
+    {"ht_number"=>nil, "label"=>"Faustsammlung der HAAB Weimar", "volume_count"=>nil}
+  ]
+  define_field_test '001452439', secondary_form_superorder: {"ht_number" => nil, "label" => "Digitale Sammlungen der Universitätsbibliothek Paderborn", "volume_count" => nil}
+end

data/test/mabmapper/test_short_title_display.rb

@@ -0,0 +1,27 @@
+# coding: utf-8
+module TestShortTitleDisplay
+  define_field_test '000057960', short_title_display: 'Sämtliche Werke : historisch-kritische Ausgabe'
+  define_field_test '000058000', short_title_display: 'Tannhäuser'
+  define_field_test '000215104', short_title_display: 'Hiersemanns bibliographische Handbücher'
+  define_field_test '000310864', short_title_display: 'Paderborner Universitätsreden'
+  define_field_test '000392641', short_title_display: 'Hegel-Jahrbuch'
+  define_field_test '000392645', short_title_display: 'Hegel-Jahrbuch'
+  define_field_test '000438377', short_title_display: 'Urkundenregesten zur Tätigkeit des deutschen Königs- und Hofgerichts bis 1451'
+  define_field_test '000479391', short_title_display: 'Quellen und Forschungen zur höchsten Gerichtsbarkeit im alten Reich'
+  define_field_test '000637121', short_title_display: 'Zeitschrift für Familienforschung : ZfF'
+  define_field_test '000676616', short_title_display: 'Recht und Staat'
+  define_field_test '000782994', short_title_display: 'Rot'
+  define_field_test '001006945', short_title_display: 'Die Zeit Wenzels 1397 - 1400'
+  define_field_test '001015067', short_title_display: 'Forum Geschichte kompakt'
+  define_field_test '001015070', short_title_display: 'Vom Ende des Ersten Weltkriegs bis zur Gegenwart [Schülerbd.]'
+  define_field_test '001108212', short_title_display: 'Johann Nestroy - Dokumente'
+  define_field_test '001249043', short_title_display: 'Fractions, decimals, ratios, and percents' # replace [Hauptbd.] with name of superorder
+  define_field_test '001499877', short_title_display: 'Fakten und Fiktionen : Werklexikon der deutschsprachigen Schlüsselliteratur ; 1900 - 2010'
+  define_field_test '001499879', short_title_display: 'Andres bis Loest'
+  define_field_test '001499880', short_title_display: 'Heinrich Mann bis Zwerenz'
+  define_field_test '001510878', short_title_display: 'Tanzhaus' # short title would be '[Buch]', so take the superorder title
+  define_field_test '001562173', short_title_display: 'Schwerpunktthema: Türkische Familien in Deutschland - Generationenbeziehungen und Generationenperspektiven'
+  define_field_test '001568334', short_title_display: 'Software Engineering 2013' # short title would be 'Buch', so take the superorder title
+  define_field_test '001572048', short_title_display: 'Paderborner Rathaus-Vorlesungen'
+  define_field_test '001572049', short_title_display: 'Alte und Neue Welt : zur wechselvollen Geschichte transatlanitischer Kulturkontakte'
+end

data/test/mabmapper/test_signature.rb

@@ -0,0 +1,12 @@
+# coding: utf-8
+module TestSignature
+  define_field_test '000321365', signature: 'P10/34k12'
+  define_field_test '000636652', signature: 'P10/34m3'
+  define_field_test '000857994', signature: 'P10/34t26'
+  define_field_test '000859176', signature: 'KDVD1105'
+  define_field_test '000969442', signature: 'TWR12765'
+
+  # Signatur mit anhängiger Bandzählung
+  define_field_test '000161445', signature: 'KXW4113-80/81'
+  define_field_test '001006945', signature: 'LKL2468-14'
+end

data/test/mabmapper/test_signature_search.rb

@@ -0,0 +1,12 @@
+# coding: utf-8
+module TestSignatureSearch
+  define_field_test '000321365', signature_search: ["34K12", "P10/34K12"]
+  define_field_test '000636652', signature_search: ["P10/34M3", "34M3"]
+  define_field_test '000857994', signature_search: ["34T26", "P10/34T26"]
+  define_field_test '000859176', signature_search: "KDVD1105"
+  define_field_test '000969442', signature_search: ["TWR12765+4", "TWR12765", "TWR12765+1", "TWR12765+2", "TWR12765+3"] 
+
+  # Signatur mit anhängiger Bandzählung
+  define_field_test '000161445', signature_search: ["KXW4113-80/81", "KXW4113-80", "KXW4113"]
+  define_field_test '001006945', signature_search: ["LKL2468-14", "LKL2468"]
+end

data/test/mabmapper/test_status.rb

@@ -0,0 +1,13 @@
+# coding: utf-8
+module TestStatus
+  # gelöscht -> LDR Position 6 == 'd'
+  define_field_test '000321365', status: 'D'
+
+  # ausgesondert über Feld 078
+  define_field_test '000392641', status: 'D'
+
+  # Standort Detmold unterdrücken
+  define_field_test 'detmold_1', status: 'D'
+  define_field_test 'detmold_2', status: 'A'
+  define_field_test 'detmold_3', status: 'A'
+end

data/test/mabmapper/test_subject.rb

@@ -0,0 +1,5 @@
+# coding: utf-8
+module TestSubject
+  # << ... >> should be removed
+  define_field_test '000972511', subject: ["Vischer, Friedrich Theodor von", "Faust"] # Vischer, Friedrich Theodor &lt;&lt;von&gt;&gt;
+end

data/test/mabmapper/test_suborders.rb

@@ -0,0 +1,192 @@
+# coding: utf-8
+module TestSuborders
+  # case 1 (a <- b AND a <- c)
+  def test_001015068_has_superorder; assert_has_superorder(doc_id_from_method_name(__method__), 'HT015707971'); end
+  def test_001015068_is_suborder;    assert_is_suborder(doc_id_from_method_name(__method__));                   end
+  def test_001015068_has_superorder_display
+    assert_has_superorder_display_value(doc_id_from_method_name(__method__), {
+      ht_number:       "HT015707971",
+      label:           "Forum Geschichte kompakt",
+      volume_count:    "Bd. 2, Teilbd. 1, Von der Frühen Neuzeit bis zum Ersten Weltkrieg [Schülerbd.]",
+      label_additions: nil
+    })
+  end
+
+  def test_001015070_has_superorder; assert_has_superorder(doc_id_from_method_name(__method__), 'HT015707971'); end
+  def test_001015070_is_suborder;    assert_is_suborder(doc_id_from_method_name(__method__));                   end
+  def test_001015070_has_superorder_display
+    assert_has_superorder_display_value(doc_id_from_method_name(__method__), {
+      ht_number:       "HT015707971",
+      label:           "Forum Geschichte kompakt",
+      volume_count:    "Bd. 2, Teilbd. 2, Vom Ende des Ersten Weltkriegs bis zur Gegenwart [Schülerbd.]",
+      label_additions: nil
+    })
+  end
+
+  # case 2 (a <- b <- c)
+  def test_001499879_has_superorder; assert_has_superorder(doc_id_from_method_name(__method__), 'HT017055615'); end;
+  def test_001499879_is_suborder;    assert_is_suborder(doc_id_from_method_name(__method__));                   end;
+  def test_001499879_has_superorder_display
+    assert_has_superorder_display_value(doc_id_from_method_name(__method__), {
+      ht_number:       "HT017055615",
+      label:           "Fakten und Fiktionen",
+      volume_count:    "1",
+      label_additions: nil
+    })
+  end
+
+  def test_001499880_has_superorder; assert_has_superorder(doc_id_from_method_name(__method__), 'HT017055615'); end;
+  def test_001499880_is_suborder;    assert_is_suborder(doc_id_from_method_name(__method__));                   end;
+  def test_001499880_has_superorder_display
+    assert_has_superorder_display_value(doc_id_from_method_name(__method__), {
+      ht_number:       "HT017055615",
+      label:           "Fakten und Fiktionen",
+      volume_count:    "2",
+      label_additions: nil
+    })
+  end
+
+  def test_001499877_has_superorder; assert_has_superorder(doc_id_from_method_name(__method__), 'HT001260573'); end;
+  def test_001499877_is_suborder;    assert_is_suborder(doc_id_from_method_name(__method__));                   end;
+  def test_001499877_has_superorder_display
+    assert_has_superorder_display_value(doc_id_from_method_name(__method__), {
+      ht_number:       "HT001260573",
+      label:           "Hiersemanns bibliographische Handbücher",
+      volume_count:    "21",
+      label_additions: nil
+    })
+  end
+
+  # case 3 (b <- a AND c <- a)
+  def test_001006945_has_superorders; assert_has_superorders(doc_id_from_method_name(__method__), ['HT002919097', 'HT003165994']); end;
+  def test_001006945_is_suborder;     assert_is_suborder(doc_id_from_method_name(__method__));                                     end;
+  def test_001006945_has_superorder_display
+    assert_has_superorder_display_values(doc_id_from_method_name(__method__), [{
+      "ht_number"       => "HT002919097",
+      "label"           => "Urkundenregesten zur Tätigkeit des deutschen Königs- und Hofgerichts bis 1451",
+      "volume_count"    => "14",
+      "label_additions" => nil
+    }, {
+      "ht_number"       => "HT003165994",
+      "label"           => "Quellen und Forschungen zur höchsten Gerichtsbarkeit im alten Reich",
+      "volume_count"    => "14",
+      "label_additions" => ["Sonderreihe"]
+    }])
+  end
+
+  # case 4 (a <- b)
+  def test_001562173_has_superorder; assert_has_superorder(doc_id_from_method_name(__method__), 'HT005081594'); end;
+  def test_001562173_is_suborder;    assert_is_suborder(doc_id_from_method_name(__method__));                   end;
+  def test_001562173_has_superorder_display
+    assert_has_superorder_display_value(doc_id_from_method_name(__method__), {
+      "ht_number"       => "HT005081594",
+      "label"           => "Zeitschrift für Familienforschung",
+      "volume_count"    => "25,1",
+      "label_additions" => nil
+    })
+  end
+
+  # case 5 (b <- a AND c <- a)
+  def test_001572049_has_superorders; assert_has_superorders(doc_id_from_method_name(__method__), ['HT002162049', 'HT017670666']); end;
+  def test_001572049_is_suborder;     assert_is_suborder(doc_id_from_method_name(__method__));                                     end;
+  def test_001572049_has_superorder_display
+    assert_has_superorder_display_values(doc_id_from_method_name(__method__), [{
+      "ht_number"       => "HT002162049",
+      "label"           => "Paderborner Universitätsreden",
+      "volume_count"    => "127",
+      "label_additions" => nil
+    }, {
+      "ht_number"       => "HT017670666",
+      "label"           => "Paderborner Rathaus-Vorlesungen",
+      "volume_count"    => "1",
+      "label_additions" => nil
+    }])
+  end
+
+  # case 6 (a <- b AND a <- c)
+  def test_000676616_has_superorder; assert_has_superorder(doc_id_from_method_name(__method__), 'HT002672902'); end;
+  def test_000676616_is_suborder;    assert_is_suborder(doc_id_from_method_name(__method__));                   end;
+  def test_000676616_has_superorder_display
+    assert_has_superorder_display_value(doc_id_from_method_name(__method__), {
+      "ht_number"       => "HT002672902",
+      "label"           => "Hegel-Jahrbuch",
+      "volume_count"    => "1993/94",
+      "label_additions" => nil
+    })
+  end
+
+  def test_000392645_has_superorder; assert_has_superorder(doc_id_from_method_name(__method__), 'HT002672902'); end;
+  def test_000392645_is_suborder;    assert_is_suborder(doc_id_from_method_name(__method__));                   end;
+  def test_000392645_has_superorder_display
+    assert_has_superorder_display_value(doc_id_from_method_name(__method__), {
+      "ht_number"       => "HT002672902",
+      "label"           => "Hegel-Jahrbuch",
+      "volume_count"    => "1966",
+      "label_additions" => nil
+    })
+  end
+
+  # case 7 (a <- b AND a <- c)
+  def test_000058000_has_superorder; assert_has_superorder(doc_id_from_method_name(__method__), 'HT000289652'); end;
+  def test_000058000_is_suborder;    assert_is_suborder(doc_id_from_method_name(__method__));                   end;
+  def test_000058000_has_superorder_display
+    assert_has_superorder_display_value(doc_id_from_method_name(__method__), {
+      "ht_number"       => "HT000289652",
+      "label"           => "Sämtliche Werke",
+      "volume_count"    => "Stücke 36",
+      "label_additions" => nil
+    })
+  end
+
+  def test_001108212_has_superorder; assert_has_superorder(doc_id_from_method_name(__method__), 'HT000289652'); end;
+  def test_001108212_is_suborder;    assert_is_suborder(doc_id_from_method_name(__method__));                   end;
+  def test_001108212_has_superorder_display
+    assert_has_superorder_display_value(doc_id_from_method_name(__method__), {
+      "ht_number"       => "HT000289652",
+      "label"           => "Sämtliche Werke / Johann Nestroy",
+      "volume_count"    => "",
+      "label_additions" => nil
+    })
+  end
+
+  private
+
+  def assert_has_superorder(doc_id, superorder_id)
+    assert_has_superorders(doc_id, [superorder_id])
+  end
+
+  def assert_has_superorder_display_value(doc_id, superorder_display_values)
+    assert_has_superorder_display_values(doc_id, [superorder_display_values])
+  end
+
+  def assert_has_superorder_display_values(doc_id, superorder_display_values)
+    doc = Nokogiri::XML(@engine.process('', load_mab('test_suborders', doc_id)).to_xml)
+    superorder_display_nodes = doc.css('superorder_display')
+
+    superorder_display_values.each_with_index do |superorder_display_value, index|
+      assert_equal(superorder_display_value.stringify_keys, JSON.parse(superorder_display_nodes[index].text))
+    end
+  end
+
+  def assert_has_superorders(doc_id, superorder_ids)
+    doc = Nokogiri::XML(@engine.process('', load_mab('test_suborders', doc_id)).to_xml)
+    superorders = doc.css('superorder')
+
+    assert_equal(true, superorders.present?)
+    assert_equal(superorder_ids.length, superorders.length)
+
+    superorder_ids.each do |superorder_id|
+      assert_includes(superorders.map(&:text), superorder_id)
+    end
+  end
+
+  def assert_is_suborder(doc_id)
+    doc = Nokogiri::XML(@engine.process('', load_mab('test_suborders', doc_id)).to_xml)
+    assert_equal(true, (value = doc.css('is_suborder').text).present?)
+    assert_equal('true', value)
+  end
+
+  def doc_id_from_method_name(method_name)
+    method_name[/\d+/]
+  end
+end

data/test/mabmapper/test_superorder.rb

@@ -0,0 +1,7 @@
+# coding: utf-8
+module TestSuperorder
+  # check for superorders of secondary forms (mab 623 and 629)
+  define_field_test '000806191', superorder: 'HT006670284'
+  define_field_test '000844686', superorder: 'HT007082773'
+  define_field_test '001452439', superorder: nil
+end

data/test/mabmapper/test_superorder_display.rb

@@ -0,0 +1,22 @@
+# coding: utf-8
+module TestSuperorderDisplay
+
+  # superorder label with leading '...' but without ';' or ':' between dots and label
+  define_field_test '000000872', superorder_display: [{"ht_number"=>"HT001310809", "label"=>"Wissenschaftliche Tagung der Arbeitsgemeinschaft für Klinische Diätetik", "volume_count"=>"2", "label_additions"=>nil}, {"ht_number"=>"HT002182783", "label"=>"Aktuelle Ernährungsmedizin", "volume_count"=>"[3], Suppl", "label_additions"=>nil}]
+
+  # for the label everything behind ':' should be removed
+  define_field_test '000162669', superorder_display: {"ht_number"=>"HT001231518", "label"=>"Handbuch der Dogmengeschichte", "volume_count"=>"Bd. 1, Das Dasein im Glauben ; Fasz. 4", "label_additions"=>nil}
+  define_field_test '000178500', superorder_display: {"ht_number"=>"HT001231518", "label"=>"Handbuch der Dogmengeschichte", "volume_count"=>"Bd. 3, Christologie, Soteriologie, Ekklesiologie, Mariologie, Gnadenlehre ; Fasz.4", "label_additions"=>nil}
+  define_field_test '000297043', superorder_display: {"ht_number"=>"HT001231518", "label"=>"Handbuch der Dogmengeschichte", "volume_count"=>"Bd. 4, Sakramente, Eschatologie ; Fasz. 1", "label_additions"=>nil}
+
+  # << ... >> should be removed
+  define_field_test '000958473', superorder_display: [{"ht_number"=>"HT001231617", "label"=>"Hessische Forschungen", "volume_count"=>"47", "label_additions"=>nil}, {"ht_number"=>"HT003779625", "label"=>"Die Geschichte unserer Heimat", "volume_count"=>"45", "label_additions"=>nil}]
+
+  # label additions
+  define_field_test '000160412', superorder_display: {"ht_number"=>"HT001237362", "label"=>"Historische Zeitschrift", "volume_count"=>"[N.F.],1", "label_additions"=>["Beiheft"]}
+  define_field_test '001006945', superorder_display: [{"ht_number"=>"HT002919097", "label"=>"Urkundenregesten zur Tätigkeit des deutschen Königs- und Hofgerichts bis 1451", "volume_count"=>"14", "label_additions"=>nil}, {"ht_number"=>"HT003165994", "label"=>"Quellen und Forschungen zur höchsten Gerichtsbarkeit im alten Reich", "volume_count"=>"14", "label_additions"=>["Sonderreihe"]}]
+
+  # sometimes there are multiple 451 fields with one startingen with '...', if this is the case, try the other one
+  define_field_test '000562878', superorder_display: [{"ht_number"=>"HT003809808", "label"=>"Management & marketing dictionary", "volume_count"=>"1", "label_additions"=>nil}, {"ht_number"=>"HT002100889", "label"=>"dtv", "volume_count"=>"5815 : Beck-Wirtschaftsberater", "label_additions"=>nil}]
+
+end

data/test/mabmapper/test_superorders.rb

@@ -0,0 +1,38 @@
+# coding: utf-8
+module TestSuperorders
+  # case 1
+  def test_001015067_is_superorder; assert_is_superorder(doc_id_from_method_name(__method__)); end
+
+  # case 2
+  def test_001499877_is_superorder; assert_is_superorder(doc_id_from_method_name(__method__)); end
+  def test_000215104_is_superorder; assert_is_superorder(doc_id_from_method_name(__method__)); end
+
+  # case 3
+  def test_000438377_is_superorder; assert_is_superorder(doc_id_from_method_name(__method__)); end
+  def test_000479391_is_superorder; assert_is_superorder(doc_id_from_method_name(__method__)); end
+
+  # case 4
+  def test_000637121_is_superorder; assert_is_superorder(doc_id_from_method_name(__method__)); end
+
+  # case 5
+  def test_000310864_is_superorder; assert_is_superorder(doc_id_from_method_name(__method__)); end
+  def test_001572048_is_superorder; assert_is_superorder(doc_id_from_method_name(__method__)); end
+
+  # case 6
+  def test_000392641_is_superorder; assert_is_superorder(doc_id_from_method_name(__method__)); end
+
+  # case 7
+  def test_000057960_is_superorder; assert_is_superorder(doc_id_from_method_name(__method__)); end
+
+  private
+
+  def assert_is_superorder(doc_id)
+    doc = Nokogiri::XML(@engine.process('', load_mab('test_superorders', doc_id)).to_xml)
+    assert_equal(true, (value = doc.css('is_superorder').text).present?)
+    assert_equal('true', value)
+  end
+
+  def doc_id_from_method_name(method_name)
+    method_name[/\d+/]
+  end
+end

data/test/mabmapper/test_title_display.rb

@@ -0,0 +1,12 @@
+# coding: utf-8
+module TestTitleDisplay
+  # should insert 'Bd.'
+  define_field_test '001499879', title_display: 'Fakten und Fiktionen : Werklexikon der deutschsprachigen Schlüsselliteratur ; 1900 - 2010. Bd. 1. Andres bis Loest'
+
+  # should not insert 'Bd.'
+  define_field_test '001015068', title_display: 'Forum Geschichte kompakt. Bd. 2, Teilbd. 1, Von der Frühen Neuzeit bis zum Ersten Weltkrieg [Schülerbd.]'
+
+  # '<<' and '>>' should be removed
+  define_field_test '000954111', title_display: 'Kitakantō-igaku = The Kitakanto medical journal'
+  define_field_test '000992332', title_display: 'Der Hexenbürgermeister von Lemgo : ein Lesedrama in Versen'
+end

data/test/mabmapper/test_title_search.rb

@@ -0,0 +1,4 @@
+# coding: utf-8
+module TestTitleSearch
+  define_field_test 'test_1', title: ['AAA', 'XXX', 'YYY']
+end

data/test/mabmapper/test_title_sort.rb

@@ -0,0 +1,6 @@
+# coding: utf-8
+module TestTitleSort
+  # << ... >> should be removed
+  define_field_test '000954111', title_sort: 'Kitakantō-igaku = Kitakanto medical journal'
+  define_field_test '000992332', title_sort: 'Hexenbürgermeister von Lemgo : ein Lesedrama in Versen'
+end

data/test/mabmapper/test_volume_count_sort.rb

@@ -0,0 +1,5 @@
+# coding: utf-8
+module TestVolumeCountSort
+  define_field_test '001015068', volume_count_sort: '0002,x,1,schuel'
+  define_field_test '001499879', volume_count_sort: '000000000000001'
+end

data/test/test_helper.rb

@@ -0,0 +1,53 @@
+# doesn't feel right to mess with $LOAD_PATH, but cannot require mabmapper without it
+$LOAD_PATH.unshift(File.expand_path('../../lib', __FILE__))
+
+# silence that minitest related error about minitest/autorun (since minitest version >= 5)
+gem 'minitest'
+
+require 'mabmapper'
+require 'minitest/autorun'
+require 'nokogiri'
+require 'pry'
+
+# Extending Ruby's Module class simplifys tests massively
+class Module
+  def define_field_test(doc_id, assertion_options)
+    field_name = self.to_s.gsub(/\ATest/, '').underscore.to_sym
+    expected_value = assertion_options.values.first
+
+    define_method "test_#{field_name}_for_#{doc_id}" do
+      assert_doc_field_value_equal(doc_id, field_name, expected_value)
+    end
+  end
+end
+
+def load_engine!
+  begin
+    engine_file = "mabmapper/aleph_mab_xml_engine" # TODO: Make me configurable
+    require engine_file
+    "#{engine_file}".classify.constantize.new
+  rescue LoadError
+    exit 1
+  end
+end
+
+def assert_doc_field_value_equal(doc_id, field_name, expected_value)
+  doc = Nokogiri::XML(@engine.process('', load_mab("test_#{field_name}", doc_id)).to_xml)
+  field_values = doc.css(field_name.to_s).map(&:text).map { |field_value| (field_value.first == '{' && field_value.last == '}') ? JSON.parse(field_value) : field_value }
+
+  if field_values.length == 0
+    assert_equal expected_value, nil
+  elsif field_values.length == 1
+    assert_equal expected_value, field_values.first.presence
+  else
+    assert_equal expected_value, field_values
+  end
+end
+
+def load_mab(directory_name, record_id)
+  mab_file_name = ["../mab_files/#{directory_name}/PAD01.#{record_id}.PRIMO.xml", "../mab_files/#{directory_name}/#{record_id}.xml"]
+    .map  { |path| File.expand_path path, __FILE__ }
+    .find { |path| FileTest.exist? path }
+
+  File.read(mab_file_name)
+end

data/test/test_mabmapper.rb

@@ -0,0 +1,19 @@
+require File.expand_path '../test_helper.rb', __FILE__
+
+class TestMabmapper < MiniTest::Unit::TestCase #Minitest::Test
+  def setup
+    @engine = load_engine!
+  end
+end
+
+tests_to_run = ENV['TESTS'].split unless ENV['TESTS'].nil?
+  
+# require and include all mabmapper test modules
+Dir.glob(File.expand_path '../mabmapper/test_*.rb', __FILE__).each do |filename|
+  if tests_to_run.nil? || tests_to_run.any? { |name_of_test| "test_#{name_of_test}" == File.basename(filename, '.rb') }
+    require filename
+    TestMabmapper.instance_eval do
+      include File.basename(filename, '.rb').camelize.constantize
+    end
+  end
+end

data/utils/mab_by_docid.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+#
+# Extracts a single mab/mabmapper xml file from a numbered archive
+#
+# Usage:
+# ./mab_by_docid.sh 000636652 (call this from within the directory where the archives are located)
+#
+# Dependencies: bash, sed, xmllint (from libxml)
+docid_with_zeros=$1
+docid_without_zeros="$(echo $docid_with_zeros| sed 's/0*//')"
+archive_number="$(((docid_without_zeros/50000)+1))"
+archive_file_name=$(find . -name "aleph.PRIMO.*.$archive_number.tar.gz")
+mab_file_name="PAD01.$docid_with_zeros.PRIMO.xml"
+
+# grab the file from the tar.gz
+tar -xvzf $archive_file_name $mab_file_name
+
+# format output using xmllint
+xmllint --format $mab_file_name --output $mab_file_name