From 4e34171f109775a56a658d0b713a27d09a7f9b2b Mon Sep 17 00:00:00 2001
From: Jessica Dussault <jdussault4@gmail.com>
Date: Thu, 9 Jan 2020 15:00:19 -0600
Subject: [PATCH 001/128] moves code out of bin elasticsearch files and into
 module

in order to achieve support for multiple ES schemas
- adds configuration for different schema locations
- moves code from executables into Datura::Elasticsearch module
- Datura::Options combines settings into schema path
---
 bin/admin_es_create_index         |  16 +-
 bin/admin_es_delete_index         |  11 +-
 bin/es_alias_add                  |  25 +--
 bin/es_alias_delete               |  14 +-
 bin/es_alias_list                 |   9 +-
 bin/es_clear_index                |  89 +---------
 bin/es_get_schema                 |  16 +-
 bin/es_set_schema                 |  19 +-
 lib/config/api_schema.yml         | 194 ---------------------
 lib/config/es_api_schemas/1.0.yml | 191 ++++++++++++++++++++
 lib/config/es_api_schemas/2.0.yml | 279 ++++++++++++++++++++++++++++++
 lib/config/public.yml             |  18 +-
 lib/datura.rb                     |   1 +
 lib/datura/elasticsearch.rb       |  22 +++
 lib/datura/elasticsearch/alias.rb |  55 ++++++
 lib/datura/elasticsearch/data.rb  |  94 ++++++++++
 lib/datura/elasticsearch/index.rb |  77 +++++++++
 lib/datura/options.rb             |  18 ++
 lib/datura/requirer.rb            |   4 +-
 19 files changed, 777 insertions(+), 375 deletions(-)
 delete mode 100644 lib/config/api_schema.yml
 create mode 100644 lib/config/es_api_schemas/1.0.yml
 create mode 100644 lib/config/es_api_schemas/2.0.yml
 create mode 100644 lib/datura/elasticsearch.rb
 create mode 100644 lib/datura/elasticsearch/alias.rb
 create mode 100644 lib/datura/elasticsearch/data.rb
 create mode 100644 lib/datura/elasticsearch/index.rb

diff --git a/bin/admin_es_create_index b/bin/admin_es_create_index
index e27997e18..94bee8ea9 100755
--- a/bin/admin_es_create_index
+++ b/bin/admin_es_create_index
@@ -2,18 +2,10 @@
 
 require "datura"
 
-params = Datura::Parser.es_create_delete_index
-options = Datura::Options.new(params).all
-
-put_url = File.join(options["es_path"], "#{options["es_index"]}?pretty=true")
-get_url = File.join(options["es_path"], "_cat", "indices?v&pretty=true")
-
 begin
-  # TODO if we want to add any default settings to the new index,
-  # we can do that with the payload and then use rest-client again instead of exec
-  # however, rest-client appears to require a payload and won't allow simple "PUT" with none
-  puts "Creating new ES index: #{put_url}"
-  exec("curl -XPUT #{put_url}")
+  es = Datura::Elasticsearch::Index.new
+  es.create
+  es.set_schema
 rescue => e
-  puts "Error: #{e.inspect}"
+  puts e
 end
diff --git a/bin/admin_es_delete_index b/bin/admin_es_delete_index
index 76299afd4..8de5fbb06 100755
--- a/bin/admin_es_delete_index
+++ b/bin/admin_es_delete_index
@@ -1,15 +1,10 @@
 #!/usr/bin/env ruby
 
 require "datura"
-require "rest-client"
-
-params = Datura::Parser.es_create_delete_index
-options = Datura::Options.new(params).all
-
-url = File.join(options["es_path"], "#{options["es_index"]}?pretty=true")
 
 begin
-  puts JSON.parse(RestClient.delete(url))
+  es = Datura::Elasticsearch::Index.new
+  es.delete
 rescue => e
-  puts "Error with request, check that index exists before deleting: #{e}"
+  puts e
 end
diff --git a/bin/es_alias_add b/bin/es_alias_add
index e9c3f74d3..7f028dfe8 100755
--- a/bin/es_alias_add
+++ b/bin/es_alias_add
@@ -2,29 +2,8 @@
 
 require "datura"
 
-require "json"
-require "rest-client"
-
-params = Datura::Parser.es_alias_add
-options = Datura::Options.new(params).all
-
-ali = options["alias"]
-idx = options["index"]
-url = File.join(options["es_path"], "_aliases")
-
-data = {
-  actions: [
-    { remove: { alias: ali, index: "_all" } },
-    { add: { alias: ali, index: idx } }
-  ]
-}
-
 begin
-  res = RestClient.post(url, data.to_json, { content_type: :json })
-  puts "Results of setting alias #{ali} to index #{idx}"
-  puts res
-  list = JSON.parse(RestClient.get(url))
-  puts "\nAll aliases: #{JSON.pretty_generate(list)}"
+  puts Datura::Elasticsearch::Alias.add
 rescue => e
-  puts "Error: #{e.response}"
+  puts e
 end
diff --git a/bin/es_alias_delete b/bin/es_alias_delete
index d12a574d2..1317c39dc 100755
--- a/bin/es_alias_delete
+++ b/bin/es_alias_delete
@@ -2,12 +2,8 @@
 
 require "datura"
 
-require "json"
-require "rest-client"
-
-params = Datura::Parser.es_alias_delete
-options = Datura::Options.new(params).all
-url = File.join(options["es_path"], options["index"], "_alias", options["alias"])
-
-res = JSON.parse(RestClient.delete(url))
-puts JSON.pretty_generate(res)
+begin
+  puts Datura::Elasticsearch::Alias.delete
+rescue => e
+  puts e
+end
diff --git a/bin/es_alias_list b/bin/es_alias_list
index d37691626..ba6df4d7e 100755
--- a/bin/es_alias_list
+++ b/bin/es_alias_list
@@ -2,11 +2,4 @@
 
 require "datura"
 
-require "json"
-require "rest-client"
-
-options = Datura::Options.new({}).all
-url = File.join(options["es_path"], "_aliases")
-
-res = JSON.parse(RestClient.get(url))
-puts JSON.pretty_generate(res)
+puts Datura::Elasticsearch::Alias.list
diff --git a/bin/es_clear_index b/bin/es_clear_index
index 2890f6230..6cd7b8740 100755
--- a/bin/es_clear_index
+++ b/bin/es_clear_index
@@ -2,89 +2,8 @@
 
 require "datura"
 
-require "json"
-require "rest-client"
-
-def confirm_basic(options, url)
-  # verify that the user is really sure about the index they're about to wipe
-  puts "Are you sure that you want to remove entries from"
-  puts " #{options["collection"]}'s #{options['environment']} environment?"
-  puts "url: #{url}"
-  puts "y/N"
-  answer = STDIN.gets.chomp
-  # boolean
-  return !!(answer =~ /[yY]/)
-end
-
-def main
-
-  # run the parameters through the option parser
-  params = Datura::Parser.clear_index_params
-  options = Datura::Options.new(params).all
-  if options["collection"] == "all"
-    clear_all(options)
-  else
-    clear_index(options)
-  end
-end
-
-def build_data(options)
-  if options["regex"]
-    field = options["field"] || "identifier"
-    return {
-      "query" => {
-        "bool" => {
-          "must" => [
-            { "regexp" => { field => options["regex"] } },
-            { "term" => { "collection" => options["collection"] } }
-          ]
-        }
-      }
-    }
-  else
-    return {
-      "query" => { "term" => { "collection" => options["collection"] } }
-    }
-  end
-end
-
-def clear_all(options)
-  puts "Please verify that you want to clear EVERY ENTRY from the ENTIRE INDEX\n\n"
-  puts "== FIELD / REGEX FILTERS NOT AVAILABLE FOR THIS OPTION, YOU'LL WIPE EVERYTHING ==\n\n"
-  puts "Seriously, you probably do not want to do this"
-  puts "Are you running this on something other than your local machine?  RETHINK IT."
-  puts "Type: 'Yes I'm sure'"
-  confirm = STDIN.gets.chomp
-  if confirm == "Yes I'm sure"
-    url = "#{options["es_path"]}/#{options["es_index"]}/_doc/_delete_by_query?pretty=true"
-    post url, { "query" => { "match_all" => {} } }
-  else
-    puts "You typed '#{confirm}'. This is incorrect, exiting program"
-    exit
-  end
-end
-
-def clear_index(options)
-  url = "#{options["es_path"]}/#{options["es_index"]}/_doc/_delete_by_query?pretty=true"
-  confirmation = confirm_basic(options, url)
-
-  if confirmation
-    data = build_data(options)
-    post(url, data)
-  else
-    puts "come back anytime!"
-    exit
-  end
+begin
+  Datura::Elasticsearch::Data.clear
+rescue => e
+  puts e
 end
-
-def post(url, data={})
-  begin
-    puts "clearing from #{url}: #{data.to_json}"
-    res = RestClient.post(url, data.to_json, {:content_type => :json})
-    puts res.body
-  rescue => e
-    puts "error posting to ES: #{e.response}"
-  end
-end
-
-main
diff --git a/bin/es_get_schema b/bin/es_get_schema
index 14e41b847..1326d5e48 100755
--- a/bin/es_get_schema
+++ b/bin/es_get_schema
@@ -2,19 +2,9 @@
 
 require "datura"
 
-require "json"
-require "rest-client"
-require "yaml"
-
-params = Datura::Parser.es_set_schema_params
-options = Datura::Options.new(params).all
-
 begin
-  url = File.join(options["es_path"], options["es_index"], "_mapping", "_doc?pretty=true")
-  res = RestClient.get(url)
-  puts res.body
-  puts "environment: #{options["environment"]}"
-  puts "url: #{url}"
+  es = Datura::Elasticsearch::Index.new
+  es.get_schema
 rescue => e
-  puts "Error: #{e.response}"
+  puts e
 end
diff --git a/bin/es_set_schema b/bin/es_set_schema
index f40050016..6c461478d 100755
--- a/bin/es_set_schema
+++ b/bin/es_set_schema
@@ -2,22 +2,9 @@
 
 require "datura"
 
-require "json"
-require "rest-client"
-require "yaml"
-
-params = Datura::Parser.es_set_schema_params
-options = Datura::Options.new(params).all
-path = File.join(options["datura_dir"], options["es_schema_path"])
-schema = YAML.load_file(path)
-
 begin
-  idx = options["es_index"]
-
-  url = File.join(options["es_path"], options["es_index"], "_mapping", "_doc?pretty=true")
-  puts "environment: #{options["environment"]}"
-  puts "Setting schema: #{url}"
-  RestClient.put(url, schema.to_json, { :content_type => :json })
+  es = Datura::Elasticsearch::Index.new
+  es.set_schema
 rescue => e
-  puts "Error: #{e.response}"
+  puts e
 end
diff --git a/lib/config/api_schema.yml b/lib/config/api_schema.yml
deleted file mode 100644
index 26f1e6ccb..000000000
--- a/lib/config/api_schema.yml
+++ /dev/null
@@ -1,194 +0,0 @@
-properties:
-  identifier:
-    type: keyword
-  identifier:
-    type: keyword
-  collection:
-    type: keyword
-  collection_desc:
-    type: keyword
-  uri:
-    type: keyword
-  uri_data:
-    type: keyword
-  uri_html:
-    type: keyword
-  data_type:
-    type: keyword
-  image_location:
-    type: keyword
-  image_id:
-    type: keyword
-    # TODO copy to text?
-  title:
-    type: keyword
-  title_sort:
-    type: keyword
-    # TODO copy to text?
-  alternative:
-    type: keyword
-  creator_sort:
-    type: keyword
-  creator:
-    type: nested
-    properties:
-      name:
-        # TODO copy into text?
-        type: keyword
-      id:
-        type: keyword
-  subjects:
-    type: keyword
-    # TODO not sure yet if for display or search
-  abstract:
-    type: keyword
-    # TODO copy to text?
-  description:
-    type: keyword
-  publisher:
-    type: keyword
-  contributor:
-    type: nested
-    properties:
-      name:
-        type: keyword
-      id:
-        type: keyword
-      role:
-        type: keyword
-  date:
-    type: date
-    format: "yyyy-MM-dd||epoch_millis"
-    # ignore_malformed: true
-  date_display:
-    type: keyword
-  date_not_before:
-    type: date
-    format: "yyyy-MM-dd||epoch_millis"
-    # ignore_malformed: true
-  date_not_after:
-    type: date
-    format: "yyyy-MM-dd||epoch_millis"
-    # ignore_malformed: true
-  type:
-    type: keyword
-  format:
-    type: keyword
-  medium:
-    type: keyword
-  extent:
-    type: keyword
-  language:
-    type: keyword
-  languages:
-    type: keyword
-  relation:
-    type: keyword
-  source:
-    type: keyword
-  recipient:
-    type: nested
-    properties:
-      name:
-        type: keyword
-      id:
-        type: keyword
-      role:
-        type: keyword
-  rights_holder:
-    type: keyword
-  rights:
-    type: keyword
-  rights_uri:
-    type: keyword
-  spatial:
-    type: nested
-    properties:
-      id:
-        type: keyword
-      # display title for entire location
-      title:
-        type: keyword
-      type:
-        type: keyword
-      # specific name of building, park, mountain, etc
-      place_name:
-        type: keyword
-      coordinates:
-        type: geo_point
-      city:
-        type: keyword
-      county:
-        type: keyword
-      country:
-        type: keyword
-      region:
-        type: keyword
-      state:
-        type: keyword
-      street:
-        type: keyword
-      postal_code:
-        type: keyword
-  person:
-    type: nested
-    properties:
-      name:
-        # TODO copy into text?
-        type: keyword
-      id:
-        type: keyword
-      role:
-        type: keyword
-  annotations_text:
-    type: text
-    analyzer: english
-  category:
-    type: keyword
-  subcategory:
-    type: keyword
-  topics:
-    type: keyword
-  keywords:
-    type: keyword
-  people:
-    type: keyword
-  places:
-    type: keyword
-  works:
-    type: keyword
-  text:
-    type: text
-    analyzer: english
-dynamic_templates:
-  - date_fields:
-      match: "*_d"
-      mapping:
-        type: date
-        format: "yyyy-MM-dd||epoch_millis"
-  - integer_fields:
-      match: "*_i"
-      mapping:
-        type: integer
-  - keyword_fields:
-      match: "*_k"
-      mapping:
-        type: keyword
-  - text_fields:
-      match: "*_t"
-      mapping:
-        type: text
-        analyzer: english
-  # language fields are always text fields
-  # but specifying _t_ for clarity
-  # _t_en functionally the same as _t
-  - text_english:
-      match: "*_t_en"
-      mapping:
-        type: text
-        analyzer: english
-  - text_spanish:
-      match: "*_t_es"
-      mapping:
-        type: text
-        analyzer: spanish
diff --git a/lib/config/es_api_schemas/1.0.yml b/lib/config/es_api_schemas/1.0.yml
new file mode 100644
index 000000000..89747ddf5
--- /dev/null
+++ b/lib/config/es_api_schemas/1.0.yml
@@ -0,0 +1,191 @@
+# compatible with Apium v1.0
+mappings:
+  properties:
+    identifier:
+      type: keyword
+    identifier:
+      type: keyword
+    collection:
+      type: keyword
+    collection_desc:
+      type: keyword
+    uri:
+      type: keyword
+    uri_data:
+      type: keyword
+    uri_html:
+      type: keyword
+    data_type:
+      type: keyword
+    image_location:
+      type: keyword
+    image_id:
+      type: keyword
+      # TODO copy to text?
+    title:
+      type: keyword
+    title_sort:
+      type: keyword
+      # TODO copy to text?
+    alternative:
+      type: keyword
+    creator_sort:
+      type: keyword
+    creator:
+      type: nested
+      properties:
+        name:
+          # TODO copy into text?
+          type: keyword
+        id:
+          type: keyword
+    subjects:
+      type: keyword
+      # TODO not sure yet if for display or search
+    abstract:
+      type: keyword
+      # TODO copy to text?
+    description:
+      type: keyword
+    publisher:
+      type: keyword
+    contributor:
+      type: nested
+      properties:
+        name:
+          type: keyword
+        id:
+          type: keyword
+        role:
+          type: keyword
+    date:
+      type: date
+      format: "yyyy-MM-dd||epoch_millis"
+      # ignore_malformed: true
+    date_display:
+      type: keyword
+    date_not_before:
+      type: date
+      format: "yyyy-MM-dd||epoch_millis"
+      # ignore_malformed: true
+    date_not_after:
+      type: date
+      format: "yyyy-MM-dd||epoch_millis"
+      # ignore_malformed: true
+    type:
+      type: keyword
+    format:
+      type: keyword
+    medium:
+      type: keyword
+    extent:
+      type: keyword
+    language:
+      type: keyword
+    languages:
+      type: keyword
+    relation:
+      type: keyword
+    source:
+      type: keyword
+    recipient:
+      type: nested
+      properties:
+        name:
+          type: keyword
+        id:
+          type: keyword
+        role:
+          type: keyword
+    rights_holder:
+      type: keyword
+    rights:
+      type: keyword
+    rights_uri:
+      type: keyword
+    coverage-spatial:
+      type: nested
+      properties:
+        place_name:
+          # TODO copy into text?
+          type: keyword
+        coordinates:
+          type: geo_point
+        id:
+          type: keyword
+        city:
+          type: keyword
+        county:
+          type: keyword
+        country:
+          type: keyword
+        region:
+          type: keyword
+        state:
+          type: keyword
+        street:
+          type: keyword
+        postal_code:
+          type: keyword
+    person:
+      type: nested
+      properties:
+        name:
+          # TODO copy into text?
+          type: keyword
+        id:
+          type: keyword
+        role:
+          type: keyword
+    annotations_text:
+      type: text
+      analyzer: english
+    category:
+      type: keyword
+    subcategory:
+      type: keyword
+    topics:
+      type: keyword
+    keywords:
+      type: keyword
+    people:
+      type: keyword
+    places:
+      type: keyword
+    works:
+      type: keyword
+    text:
+      type: text
+      analyzer: english
+  dynamic_templates:
+    - date_fields:
+        match: "*_d"
+        mapping:
+          type: date
+          format: "yyyy-MM-dd||epoch_millis"
+    - integer_fields:
+        match: "*_i"
+        mapping:
+          type: integer
+    - keyword_fields:
+        match: "*_k"
+        mapping:
+          type: keyword
+    - text_fields:
+        match: "*_t"
+        mapping:
+          type: text
+          analyzer: english
+    # language fields are always text fields
+    # but specifying _t_ for clarity
+    # _t_en functionally the same as _t
+    - text_english:
+        match: "*_t_en"
+        mapping:
+          type: text
+          analyzer: english
+    - text_spanish:
+        match: "*_t_es"
+        mapping:
+          type: text
+          analyzer: spanish
diff --git a/lib/config/es_api_schemas/2.0.yml b/lib/config/es_api_schemas/2.0.yml
new file mode 100644
index 000000000..c34155bad
--- /dev/null
+++ b/lib/config/es_api_schemas/2.0.yml
@@ -0,0 +1,279 @@
+# compatible with Apium v2.0
+settings:
+  analysis:
+    char_filter:
+      escapes:
+        type: mapping
+        mappings:
+          - "<em> => "
+          - "</em> => "
+          - "<u> => "
+          - "</u> => "
+          - "<strong> => "
+          - "</strong> => "
+          - "- => "
+          - "& => "
+          - ": => "
+          - "; => "
+          - ", => "
+          - ". => "
+          - "$ => "
+          - "@ => "
+          - "~ => "
+          - "\" => "
+          - "' => "
+          - "[ => "
+          - "] => "
+    normalizer:
+      keyword_normalized:
+        type: custom
+        char_filter:
+          - escapes
+        filter:
+          - asciifolding
+          - lowercase
+mappings:
+  properties:
+    identifier:
+      type: keyword
+      normalizer: keyword_normalized
+    collection:
+      type: keyword
+      normalizer: keyword_normalized
+    collection_desc:
+      type: keyword
+      normalizer: keyword_normalized
+    uri:
+      type: keyword
+      normalizer: keyword_normalized
+    uri_data:
+      type: keyword
+      normalizer: keyword_normalized
+    uri_html:
+      type: keyword
+      normalizer: keyword_normalized
+    data_type:
+      type: keyword
+      normalizer: keyword_normalized
+    image_location:
+      type: keyword
+      normalizer: keyword_normalized
+    image_id:
+      type: keyword
+      normalizer: keyword_normalized
+      # TODO copy to text?
+    title:
+      type: keyword
+      normalizer: keyword_normalized
+    title_sort:
+      type: keyword
+      normalizer: keyword_normalized
+      # TODO copy to text?
+    alternative:
+      type: keyword
+      normalizer: keyword_normalized
+    creator_sort:
+      type: keyword
+      normalizer: keyword_normalized
+    creator:
+      type: nested
+      properties:
+        name:
+          # TODO copy into text?
+          type: keyword
+          normalizer: keyword_normalized
+        id:
+          type: keyword
+          normalizer: keyword_normalized
+    subjects:
+      type: keyword
+      normalizer: keyword_normalized
+      # TODO not sure yet if for display or search
+    abstract:
+      type: keyword
+      normalizer: keyword_normalized
+      # TODO copy to text?
+    description:
+      type: keyword
+      normalizer: keyword_normalized
+    publisher:
+      type: keyword
+      normalizer: keyword_normalized
+    contributor:
+      type: nested
+      properties:
+        name:
+          type: keyword
+          normalizer: keyword_normalized
+        id:
+          type: keyword
+          normalizer: keyword_normalized
+        role:
+          type: keyword
+          normalizer: keyword_normalized
+    date:
+      type: date
+      format: "yyyy-MM-dd||epoch_millis"
+      # ignore_malformed: true
+    date_display:
+      type: keyword
+      normalizer: keyword_normalized
+    date_not_before:
+      type: date
+      format: "yyyy-MM-dd||epoch_millis"
+      # ignore_malformed: true
+    date_not_after:
+      type: date
+      format: "yyyy-MM-dd||epoch_millis"
+      # ignore_malformed: true
+    type:
+      type: keyword
+      normalizer: keyword_normalized
+    format:
+      type: keyword
+      normalizer: keyword_normalized
+    medium:
+      type: keyword
+      normalizer: keyword_normalized
+    extent:
+      type: keyword
+      normalizer: keyword_normalized
+    language:
+      type: keyword
+      normalizer: keyword_normalized
+    languages:
+      type: keyword
+      normalizer: keyword_normalized
+    relation:
+      type: keyword
+      normalizer: keyword_normalized
+    source:
+      type: keyword
+      normalizer: keyword_normalized
+    recipient:
+      type: nested
+      properties:
+        name:
+          type: keyword
+          normalizer: keyword_normalized
+        id:
+          type: keyword
+          normalizer: keyword_normalized
+        role:
+          type: keyword
+          normalizer: keyword_normalized
+    rights_holder:
+      type: keyword
+      normalizer: keyword_normalized
+    rights:
+      type: keyword
+      normalizer: keyword_normalized
+    rights_uri:
+      type: keyword
+      normalizer: keyword_normalized
+    coverage-spatial:
+      type: nested
+      properties:
+        place_name:
+          # TODO copy into text?
+          type: keyword
+          normalizer: keyword_normalized
+        coordinates:
+          type: geo_point
+        id:
+          type: keyword
+          normalizer: keyword_normalized
+        city:
+          type: keyword
+          normalizer: keyword_normalized
+        county:
+          type: keyword
+          normalizer: keyword_normalized
+        country:
+          type: keyword
+          normalizer: keyword_normalized
+        region:
+          type: keyword
+          normalizer: keyword_normalized
+        state:
+          type: keyword
+          normalizer: keyword_normalized
+        street:
+          type: keyword
+          normalizer: keyword_normalized
+        postal_code:
+          type: keyword
+          normalizer: keyword_normalized
+    person:
+      type: nested
+      properties:
+        name:
+          # TODO copy into text?
+          type: keyword
+          normalizer: keyword_normalized
+        id:
+          type: keyword
+          normalizer: keyword_normalized
+        role:
+          type: keyword
+          normalizer: keyword_normalized
+    annotations_text:
+      type: text
+      analyzer: english
+    category:
+      type: keyword
+      normalizer: keyword_normalized
+    subcategory:
+      type: keyword
+      normalizer: keyword_normalized
+    topics:
+      type: keyword
+      normalizer: keyword_normalized
+    keywords:
+      type: keyword
+      normalizer: keyword_normalized
+    people:
+      type: keyword
+      normalizer: keyword_normalized
+    places:
+      type: keyword
+      normalizer: keyword_normalized
+    works:
+      type: keyword
+      normalizer: keyword_normalized
+    text:
+      type: text
+      analyzer: english
+  dynamic_templates:
+    - date_fields:
+        match: "*_d"
+        mapping:
+          type: date
+          format: "yyyy-MM-dd||epoch_millis"
+    - integer_fields:
+        match: "*_i"
+        mapping:
+          type: integer
+    - keyword_fields:
+        match: "*_k"
+        mapping:
+          type: keyword
+          normalizer: keyword_normalized
+    - text_fields:
+        match: "*_t"
+        mapping:
+          type: text
+          analyzer: english
+    # language fields are always text fields
+    # but specifying _t_ for clarity
+    # _t_en functionally the same as _t
+    - text_english:
+        match: "*_t_en"
+        mapping:
+          type: text
+          analyzer: english
+    - text_spanish:
+        match: "*_t_es"
+        mapping:
+          type: text
+          analyzer: spanish
diff --git a/lib/config/public.yml b/lib/config/public.yml
index 3fff24731..486e85037 100644
--- a/lib/config/public.yml
+++ b/lib/config/public.yml
@@ -26,12 +26,18 @@ default:
   log_size: 32768000          # size of log file in bytes
   log_level: Logger::INFO     # available levels: UNKNOWN, FATAL, ERROR, WARN, INFO, DEBUG
 
-  # SCHEMA LOCATION
-  # misleadingly, this is not currently overrideable per collection
-  # TODO make overrideable in es_set_schema and post
-  # or perhaps remove it from this config since it is not collection-specific
-  # in any sense of the word, except if working with an entirely separate ES index
-  es_schema_path: lib/config/api_schema.yml
+  # ELASTICSEARCH SCHEMA CONFIGURATION
+  # if es_schema_override is false, datura is base directory
+  # if es_schema_override is true, then host data repo is the base directory
+  # it is NOT recommended to set es_schema_override to true!
+  #   if you need something outside of your data repo's directory, consider
+  #   overridding the es_schema_path method in options.rb
+  es_schema_override: false
+  # path from base directory to schemas
+  es_schema_path: lib/config/es_api_schemas
+  # current version of the API (powered by Elasticsearch)
+  # this setting determines which of the schemas will be used
+  api_version: "override with value like '1.0' or '2.0'"
 
   # RESOURCE LOCATIONS
   data_base: https://cdrhmedia.unl.edu      # xml, csv, html snippets, etc
diff --git a/lib/datura.rb b/lib/datura.rb
index 5f46a4d55..3ff9278b2 100644
--- a/lib/datura.rb
+++ b/lib/datura.rb
@@ -1,5 +1,6 @@
 require "datura/version"
 require "datura/data_manager"
+require "datura/elasticsearch"
 
 module Datura
 
diff --git a/lib/datura/elasticsearch.rb b/lib/datura/elasticsearch.rb
new file mode 100644
index 000000000..fecba15fc
--- /dev/null
+++ b/lib/datura/elasticsearch.rb
@@ -0,0 +1,22 @@
+require_relative './helpers.rb'
+require_relative './options.rb'
+
+require "json"
+require "rest-client"
+require "yaml"
+
+module Datura::Elasticsearch
+
+  # clear data from the index (leaves index schema intact)
+  module Data
+  end
+
+  # manage the aliases used to refer to specific indexes
+  module Alias
+  end
+
+  # manage the creation / deletion / schema configuration of indexes
+  class Index
+  end
+
+end
diff --git a/lib/datura/elasticsearch/alias.rb b/lib/datura/elasticsearch/alias.rb
new file mode 100644
index 000000000..177ee14d1
--- /dev/null
+++ b/lib/datura/elasticsearch/alias.rb
@@ -0,0 +1,55 @@
+require "json"
+require "rest-client"
+
+require_relative "./../elasticsearch.rb"
+
+module Datura::Elasticsearch::Alias
+
+  def self.add
+    params = Datura::Parser.es_alias_add
+    options = Datura::Options.new(params).all
+
+    ali = options["alias"]
+    idx = options["index"]
+
+    base_url = File.join(options["es_path"], "_aliases")
+
+    data = {
+      actions: [
+        { remove: { alias: ali, index: "_all" } },
+        { add: { alias: ali, index: idx } }
+      ]
+    }
+    RestClient.post(base_url, data.to_json, { content_type: :json }) { |res, req, result|
+      if result.code == "200"
+        puts res
+        puts "Successfully added alias #{ali}. Current alias list:"
+        puts list
+      else
+        raise "#{result.code} error managing aliases: #{res}"
+      end
+    }
+  end
+
+  def self.delete
+    params = Datura::Parser.es_alias_add
+    options = Datura::Options.new(params).all
+
+    ali = options["alias"]
+    idx = options["index"]
+
+    url = File.join(options["es_path"], idx, "_alias", ali)
+
+    res = JSON.parse(RestClient.delete(url))
+    puts JSON.pretty_generate(res)
+    list
+  end
+
+  def self.list
+    options = Datura::Options.new({}).all
+
+    res = RestClient.get(File.join(options["es_path"], "_aliases"))
+    JSON.pretty_generate(JSON.parse(res))
+  end
+
+end
diff --git a/lib/datura/elasticsearch/data.rb b/lib/datura/elasticsearch/data.rb
new file mode 100644
index 000000000..5deedadb1
--- /dev/null
+++ b/lib/datura/elasticsearch/data.rb
@@ -0,0 +1,94 @@
+require "json"
+require "rest-client"
+
+require_relative "./../elasticsearch.rb"
+
+module Datura::Elasticsearch::Data
+
+  def self.clear
+    # run the parameters through the option parser
+    params = Datura::Parser.clear_index_params
+    options = Datura::Options.new(params).all
+    if options["collection"] == "all"
+      self.clear_all(options)
+    else
+      self.clear_index(options)
+    end
+  end
+
+  private
+
+  def self.build_clear_data(options)
+    if options["regex"]
+      field = options["field"] || "identifier"
+      {
+        "query" => {
+          "bool" => {
+            "must" => [
+              { "regexp" => { field => options["regex"] } },
+              { "term" => { "collection" => options["collection"] } }
+            ]
+          }
+        }
+      }
+    else
+      {
+        "query" => { "term" => { "collection" => options["collection"] } }
+      }
+    end
+  end
+
+  def self.clear_all(options)
+    puts "Please verify that you want to clear EVERY ENTRY from the ENTIRE INDEX\n\n"
+    puts "== FIELD / REGEX FILTERS NOT AVAILABLE FOR THIS OPTION, YOU'LL WIPE EVERYTHING ==\n\n"
+    puts "Running this on something other than your computer's localhost? DON'T."
+    puts "Type: 'Yes I'm sure'"
+    confirm = STDIN.gets.chomp
+    if confirm == "Yes I'm sure"
+      url = File.join(options["es_path"], options["es_index"], "_doc", "_delete_by_query?pretty=true")
+      json = { "query" => { "match_all" => {} } }
+      RestClient.post(url, json.to_json, { content_type: :json }) { |res, req, result|
+        if result.code == "200"
+          puts res
+        else
+          raise "#{result.code} error when clearing entire index: #{res}"
+        end
+      }
+    else
+      puts "You typed '#{confirm}'. This is incorrect, exiting program"
+      exit
+    end
+  end
+
+  def self.clear_index(options)
+    url = File.join(options["es_path"], options["es_index"], "_doc", "_delete_by_query?pretty=true")
+    confirmation = self.confirm_clear(options, url)
+
+    if confirmation
+      data = self.build_clear_data(options)
+      RestClient.post(url, data.to_json, { content_type: :json }) { |res, req, result|
+        if result.code == "200"
+          puts res
+        else
+          raise "#{result.code} error when clearing index: #{res}"
+        end
+      }
+    else
+      puts "come back anytime!"
+      exit
+    end
+  end
+
+  def self.confirm_clear(options, url)
+    # verify that the user is really sure about the index they're about to wipe
+    puts "Are you sure that you want to remove entries from"
+    puts " #{options["collection"]}'s #{options['environment']} environment?"
+    puts "url: #{url}"
+    puts "y/N"
+    answer = STDIN.gets.chomp
+    # boolean
+    !!(answer =~ /[yY]/)
+  end
+
+
+end
diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
new file mode 100644
index 000000000..1065eeff2
--- /dev/null
+++ b/lib/datura/elasticsearch/index.rb
@@ -0,0 +1,77 @@
+require "json"
+require "rest-client"
+require "yaml"
+
+require_relative "./../elasticsearch.rb"
+
+class Datura::Elasticsearch::Index
+  
+  def initialize
+    params = Datura::Parser.es_create_delete_index
+    @options = Datura::Options.new(params).all
+
+    @base_url = File.join(@options["es_path"], @options["es_index"])
+    @mapping_url = File.join(@base_url, "_mapping", "_doc?pretty=true")
+    @index_url = "#{@base_url}?pretty=true"
+
+    # yaml settings (if exist) and mappings
+    @schema = YAML.load_file(@options["es_schema"])
+  end
+
+  def create
+    json = @schema["settings"].to_json
+    puts "Creating ES index for API version #{@options["api_version"]}: #{@index_url}"
+
+    if json && json != "null"
+      RestClient.put(@index_url, json, { content_type: :json }) { |res, req, result|
+        if result.code == "200"
+          puts res
+        else
+          raise "#{result.code} error creating Elasticsearch index: #{res}"
+        end
+      }
+    else
+      RestClient.put(@index_url, nil) { |res, req, result|
+        if result.code == "200"
+          puts res
+        else
+          raise "#{result.code} error creating Elasticsearch index: #{res}"
+        end
+      }
+    end
+  end
+
+  def delete
+    puts "Deleting #{@options["es_index"]} via url #{@index_url}"
+
+    RestClient.delete(@index_url) { |res, req, result|
+      if result.code != "200"
+        raise "#{result.code} error deleting Elasticsearch index: #{res}"
+      end
+    }
+  end
+
+  def get_schema
+    RestClient.get(@mapping_url) { |res, req, result|
+      if result.code == "200"
+        puts res
+      else
+        raise "#{result.code} error getting Elasticsearch schema: #{res}"
+      end
+    }
+  end
+
+  def set_schema
+    json = @schema["mappings"].to_json
+
+    puts "Setting schema: #{@mapping_url}"
+    RestClient.put(@mapping_url, json, { content_type: :json }) { |res, req, result|
+      if result.code == "200"
+        puts res
+      else
+        raise "#{result.code} error setting Elasticsearch schema: #{res}"
+      end
+    }
+  end
+
+end
diff --git a/lib/datura/options.rb b/lib/datura/options.rb
index 36d4e47e2..c478ced42 100644
--- a/lib/datura/options.rb
+++ b/lib/datura/options.rb
@@ -22,6 +22,24 @@ def initialize(params)
     # include the collection and datura gem directories in the options
     @all["collection_dir"] = collection_dir
     @all["datura_dir"] = datura_dir
+
+    other_configuration
+  end
+
+  def es_schema_path
+    internal_path = File.join(@all["es_schema_path"], "#{@all["api_version"]}.yml")
+    if @all["es_schema_override"]
+      File.join(@all["collection_dir"], internal_path)
+    else
+      File.join(@all["datura_dir"], internal_path)
+    end
+  end
+
+  # after all options have been flattened, create customization by
+  # combining the set options, etc
+  def other_configuration
+    # put together the elasticsearch schema path
+    @all["es_schema"] = es_schema_path
   end
 
   def print_message(variable, name)
diff --git a/lib/datura/requirer.rb b/lib/datura/requirer.rb
index 75c7bb247..b3048c758 100644
--- a/lib/datura/requirer.rb
+++ b/lib/datura/requirer.rb
@@ -12,4 +12,6 @@
 Dir["#{current_dir}/to_es/**/*.rb"].each { |f| require f }
 
 # file types
-Dir["#{current_dir}/file_types/*.rb"].each { |f| require f }
+Dir["#{current_dir}/file_types/*.rb"].each {|f| require f }
+# elasticsearch files
+Dir["#{current_dir}/elasticsearch/*.rb"].each {|f| require f }

From 172c4aac82e21afb4a649847526034767e4d5f7e Mon Sep 17 00:00:00 2001
From: Jessica Dussault <jdussault4@gmail.com>
Date: Thu, 9 Jan 2020 15:00:32 -0600
Subject: [PATCH 002/128] removes unnecessary dtd for french 17

---
 lib/config/f17.dtd | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 lib/config/f17.dtd

diff --git a/lib/config/f17.dtd b/lib/config/f17.dtd
deleted file mode 100644
index e69de29bb..000000000

From 4483c4427b956956f3887aafa41b314fea7383ad Mon Sep 17 00:00:00 2001
From: Jessica Dussault <jdussault4@gmail.com>
Date: Thu, 9 Jan 2020 15:38:19 -0600
Subject: [PATCH 003/128] combines some parameter gathering files

---
 lib/datura/elasticsearch/alias.rb             |  4 +-
 lib/datura/elasticsearch/data.rb              |  2 +-
 lib/datura/elasticsearch/index.rb             |  2 +-
 lib/datura/parser_options/clear_index.rb      |  2 +-
 .../{es_alias_add.rb => es_alias.rb}          |  4 +-
 lib/datura/parser_options/es_alias_delete.rb  | 50 -------------------
 ...{es_create_delete_index.rb => es_index.rb} |  4 +-
 lib/datura/parser_options/es_set_schema.rb    | 26 ----------
 8 files changed, 9 insertions(+), 85 deletions(-)
 rename lib/datura/parser_options/{es_alias_add.rb => es_alias.rb} (92%)
 delete mode 100644 lib/datura/parser_options/es_alias_delete.rb
 rename lib/datura/parser_options/{es_create_delete_index.rb => es_index.rb} (86%)
 delete mode 100644 lib/datura/parser_options/es_set_schema.rb

diff --git a/lib/datura/elasticsearch/alias.rb b/lib/datura/elasticsearch/alias.rb
index 177ee14d1..aa7c2e4ad 100644
--- a/lib/datura/elasticsearch/alias.rb
+++ b/lib/datura/elasticsearch/alias.rb
@@ -6,7 +6,7 @@
 module Datura::Elasticsearch::Alias
 
   def self.add
-    params = Datura::Parser.es_alias_add
+    params = Datura::Parser.es_alias
     options = Datura::Options.new(params).all
 
     ali = options["alias"]
@@ -32,7 +32,7 @@ def self.add
   end
 
   def self.delete
-    params = Datura::Parser.es_alias_add
+    params = Datura::Parser.es_alias
     options = Datura::Options.new(params).all
 
     ali = options["alias"]
diff --git a/lib/datura/elasticsearch/data.rb b/lib/datura/elasticsearch/data.rb
index 5deedadb1..44b8bb848 100644
--- a/lib/datura/elasticsearch/data.rb
+++ b/lib/datura/elasticsearch/data.rb
@@ -7,7 +7,7 @@ module Datura::Elasticsearch::Data
 
   def self.clear
     # run the parameters through the option parser
-    params = Datura::Parser.clear_index_params
+    params = Datura::Parser.clear_index
     options = Datura::Options.new(params).all
     if options["collection"] == "all"
       self.clear_all(options)
diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index 1065eeff2..1c1718d26 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -7,7 +7,7 @@
 class Datura::Elasticsearch::Index
   
   def initialize
-    params = Datura::Parser.es_create_delete_index
+    params = Datura::Parser.es_index
     @options = Datura::Options.new(params).all
 
     @base_url = File.join(@options["es_path"], @options["es_index"])
diff --git a/lib/datura/parser_options/clear_index.rb b/lib/datura/parser_options/clear_index.rb
index 75176dbd0..e7e0f9a4b 100644
--- a/lib/datura/parser_options/clear_index.rb
+++ b/lib/datura/parser_options/clear_index.rb
@@ -1,5 +1,5 @@
 module Datura::Parser
-  def self.clear_index_params
+  def self.clear_index
     @usage = "Usage: (es|solr)_clear_index -[options]..."
     options = {}  # will hold all the options passed in by user
 
diff --git a/lib/datura/parser_options/es_alias_add.rb b/lib/datura/parser_options/es_alias.rb
similarity index 92%
rename from lib/datura/parser_options/es_alias_add.rb
rename to lib/datura/parser_options/es_alias.rb
index 03d88e2c5..bb36b420f 100644
--- a/lib/datura/parser_options/es_alias_add.rb
+++ b/lib/datura/parser_options/es_alias.rb
@@ -1,6 +1,6 @@
 module Datura::Parser
-  def self.es_alias_add
-    @usage = "Usage: es_alias_add -a alias -i index -e environment"
+  def self.es_alias
+    @usage = "Usage: (command) -a alias -i index -e environment"
     options = {}
 
     optparse = OptionParser.new do |opts|
diff --git a/lib/datura/parser_options/es_alias_delete.rb b/lib/datura/parser_options/es_alias_delete.rb
deleted file mode 100644
index ea38038b8..000000000
--- a/lib/datura/parser_options/es_alias_delete.rb
+++ /dev/null
@@ -1,50 +0,0 @@
-module Datura::Parser
-  def self.es_alias_delete
-    @usage = "Usage: es_alias_delete -a alias -i index -e environment"
-    options = {}
-
-    optparse = OptionParser.new do |opts|
-      opts.banner = @usage
-
-      opts.on( '-h', '--help', 'How does this work?') do
-        puts opts
-        exit
-      end
-
-      options["alias"] = nil
-      opts.on( '-a', '--alias [input]', 'Alias (cdrhapi-v1)') do |input|
-        if input && input.length > 0
-          options["alias"] = input
-        else
-          puts "Must specify an alias with -a flag"
-          exit
-        end
-      end
-
-      options["environment"] = "development"
-      opts.on( '-e', '--environment [input]', 'Environment (development, production)') do |input|
-        if input && input.length > 0
-          options["environment"] = input
-        end
-      end
-
-      options["index"] = nil
-      opts.on( '-i', '--index [input]', 'Index (cdrhapi-v1.1)') do |input|
-        if input && input.length > 0
-          options["index"] = input
-        else
-          puts "Must specify an index with -i flag"
-          exit
-        end
-      end
-
-    end
-
-    optparse.parse!
-    if options["alias"].nil? || options["index"].nil?
-      puts "must specify alias and index with -a and -i, respectively"
-      exit
-    end
-    options
-  end
-end
diff --git a/lib/datura/parser_options/es_create_delete_index.rb b/lib/datura/parser_options/es_index.rb
similarity index 86%
rename from lib/datura/parser_options/es_create_delete_index.rb
rename to lib/datura/parser_options/es_index.rb
index 22ed0d1cc..716835548 100644
--- a/lib/datura/parser_options/es_create_delete_index.rb
+++ b/lib/datura/parser_options/es_index.rb
@@ -1,6 +1,6 @@
 module Datura::Parser
-  def self.es_create_delete_index
-    @usage = "Usage: admin_es_(create|delete)_index -e environment"
+  def self.es_index
+    @usage = "Usage: (command) -e environment"
     options = {}  # will hold all the options passed in by user
 
     optparse = OptionParser.new do |opts|
diff --git a/lib/datura/parser_options/es_set_schema.rb b/lib/datura/parser_options/es_set_schema.rb
deleted file mode 100644
index 4f3d2388a..000000000
--- a/lib/datura/parser_options/es_set_schema.rb
+++ /dev/null
@@ -1,26 +0,0 @@
-module Datura::Parser
-  def self.es_set_schema_params
-    @usage = "Usage: es_set_schema -e environment"
-    options = {}
-
-    optparse = OptionParser.new do |opts|
-      opts.banner = @usage
-
-      opts.on( '-h', '--help', 'How does this work?') do
-        puts opts
-        exit
-      end
-
-      options["environment"] = "development"
-      opts.on( '-e', '--environment [input]', 'Environment (development, production)') do |input|
-        if input && input.length > 0
-          options["environment"] = input
-        end
-      end
-
-    end
-
-    optparse.parse!
-    options
-  end
-end

From c70169bb0e50851b7940792e7efc2d5358fb8322 Mon Sep 17 00:00:00 2001
From: Jessica Dussault <jdussault4@gmail.com>
Date: Thu, 9 Jan 2020 16:05:26 -0600
Subject: [PATCH 004/128] updates gems and fixes test suite

had suffered from errors and from gem deprecation warnings
---
 Gemfile.lock         | 4 ++--
 datura.gemspec       | 4 ++--
 test/options_test.rb | 4 +++-
 3 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/Gemfile.lock b/Gemfile.lock
index 77684b7e4..40873a8c0 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -3,8 +3,8 @@ PATH
   specs:
     datura (0.2.0.pre.beta)
       colorize (~> 0.8.1)
-      nokogiri (~> 1.8)
-      rest-client (~> 2.0.2)
+      nokogiri (~> 1.10)
+      rest-client (~> 2.1)
 
 GEM
   remote: https://rubygems.org/
diff --git a/datura.gemspec b/datura.gemspec
index ef85aa47d..ef3099880 100644
--- a/datura.gemspec
+++ b/datura.gemspec
@@ -55,8 +55,8 @@ Gem::Specification.new do |spec|
 
   spec.required_ruby_version = "~> 2.5"
   spec.add_runtime_dependency "colorize", "~> 0.8.1"
-  spec.add_runtime_dependency "nokogiri", "~> 1.8"
-  spec.add_runtime_dependency "rest-client", "~> 2.0.2"
+  spec.add_runtime_dependency "nokogiri", "~> 1.10"
+  spec.add_runtime_dependency "rest-client", "~> 2.1"
   spec.add_development_dependency "bundler", ">= 1.16.0", "< 3.0"
   spec.add_development_dependency "minitest", "~> 5.0"
   spec.add_development_dependency "rake", "~> 13.0"
diff --git a/test/options_test.rb b/test/options_test.rb
index cd088785b..9b4d6dff2 100644
--- a/test/options_test.rb
+++ b/test/options_test.rb
@@ -6,7 +6,9 @@ class Datura::Options
   def read_all_configs fake1, fake2
     @general_config_pub = {
       "default" => {
-        "a" => "general default public"
+        "a" => "general default public",
+        "es_schema_path" => "lib/config",
+        "api_version" => "2.0"
       }
     }
     @collection_config_pub = {

From 2aa5f389b7ee8629ee108c0c6ba6649721356880 Mon Sep 17 00:00:00 2001
From: Jessica Dussault <jdussault4@gmail.com>
Date: Fri, 10 Jan 2020 10:20:22 -0600
Subject: [PATCH 005/128] in progress working on validator for es fields)

---
 bin/es_get_schema                 |  2 +-
 lib/datura/data_manager.rb        | 31 ++++++++++++++----------
 lib/datura/elasticsearch.rb       |  4 ----
 lib/datura/elasticsearch/index.rb | 40 +++++++++++++++++++++++++------
 4 files changed, 53 insertions(+), 24 deletions(-)

diff --git a/bin/es_get_schema b/bin/es_get_schema
index 1326d5e48..664988d32 100755
--- a/bin/es_get_schema
+++ b/bin/es_get_schema
@@ -4,7 +4,7 @@ require "datura"
 
 begin
   es = Datura::Elasticsearch::Index.new
-  es.get_schema
+  puts es.get_schema
 rescue => e
   puts e
 end
diff --git a/lib/datura/data_manager.rb b/lib/datura/data_manager.rb
index 9ae304a43..7e71af4d2 100644
--- a/lib/datura/data_manager.rb
+++ b/lib/datura/data_manager.rb
@@ -17,6 +17,8 @@ class Datura::DataManager
   attr_accessor :options
   attr_accessor :collection
 
+  attr_accessor :es_schema_mapping
+
   def self.format_to_class
     classes = {
       "csv" => FileCsv,
@@ -49,6 +51,9 @@ def initialize
     # set up posting URLs
     @es_url = File.join(options["es_path"], options["es_index"])
     @solr_url = File.join(options["solr_path"], options["solr_core"], "update")
+
+    # retrieve the specified elasticsearch index's schema
+    set_schema_mappings
   end
 
   # NOTE: This step is what allows collection specific files to override ANY
@@ -76,7 +81,7 @@ def run
     puts msg
 
     check_options
-    set_schema
+    get_schema_mappings
     pre_file_preparation
     @files = prepare_files
 
@@ -135,6 +140,11 @@ def check_options
     if should_transform?("es")
       assert_option("es_path")
       assert_option("es_index")
+      # options used to obtain the mappings
+      assert_option("es_schema_override")
+      assert_option("es_schema_path")
+      assert_option("api_version")
+
       assert_option("collection")
     end
 
@@ -262,22 +272,19 @@ def prepare_xslt
     end
   end
 
-  def set_schema
-    # if ES is requested and not transform only, then set the schema
-    # to make sure that any new fields are stored with the correct fieldtype
+  # NOTE plural method name in order to accommodate other platforms
+  # we may be checking in the future
+  def set_schema_mappings
+    # only get the elasticsearch mapping if it is needed for post request
     if should_transform?("es") && !@options["transform_only"]
-      schema = YAML.load_file(File.join(@options["datura_dir"], @options["es_schema_path"]))
-      path, idx = ["es_path", "es_index"].map { |i| @options[i] }
-      url = "#{path}/#{idx}/_mapping/_doc?pretty=true"
       begin
-        RestClient.put(url, schema.to_json, { content_type: :json })
-        msg = "Successfully set elasticsearch schema for index #{idx} _doc"
-        @log.info(msg)
-        puts msg.green
+        es = Datura::Elasticsearch::Index.new(@options)
+        @es_schema_mapping = es.get_schema_mapping
       rescue => e
-        raise("Something went wrong setting the elasticsearch schema for index #{idx} _doc:\n#{e.to_s}".red)
+        raise "Unable to get the elasticsearch schema: #{e}"
       end
     end
+
   end
 
   def set_up_logger
diff --git a/lib/datura/elasticsearch.rb b/lib/datura/elasticsearch.rb
index fecba15fc..ffc4c710e 100644
--- a/lib/datura/elasticsearch.rb
+++ b/lib/datura/elasticsearch.rb
@@ -1,10 +1,6 @@
 require_relative './helpers.rb'
 require_relative './options.rb'
 
-require "json"
-require "rest-client"
-require "yaml"
-
 module Datura::Elasticsearch
 
   # clear data from the index (leaves index schema intact)
diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index 1c1718d26..e2cc9cbcc 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -6,20 +6,29 @@
 
 class Datura::Elasticsearch::Index
   
-  def initialize
-    params = Datura::Parser.es_index
-    @options = Datura::Options.new(params).all
+  attr_reader :schema_mapping
+
+  # if options are passed in, then commandline arguments
+  # do not need to be parsed
+  def initialize(options = nil)
+    if !options
+      params = Datura::Parser.es_index
+      @options = Datura::Options.new(params).all
+    else
+      @options = options
+    end
 
     @base_url = File.join(@options["es_path"], @options["es_index"])
     @mapping_url = File.join(@base_url, "_mapping", "_doc?pretty=true")
     @index_url = "#{@base_url}?pretty=true"
 
     # yaml settings (if exist) and mappings
-    @schema = YAML.load_file(@options["es_schema"])
+    @requested_schema = YAML.load_file(@options["es_schema"])
+    @schema_mapping = nil
   end
 
   def create
-    json = @schema["settings"].to_json
+    json = @requested_schema["settings"].to_json
     puts "Creating ES index for API version #{@options["api_version"]}: #{@index_url}"
 
     if json && json != "null"
@@ -54,15 +63,32 @@ def delete
   def get_schema
     RestClient.get(@mapping_url) { |res, req, result|
       if result.code == "200"
-        puts res
+        JSON.parse(res)
       else
         raise "#{result.code} error getting Elasticsearch schema: #{res}"
       end
     }
   end
 
+  def get_schema_mapping
+    # if mapping has not already been set, get the schema and manipulate
+    if !@schema_mapping
+      schema = get_schema[@options["es_index"]]
+      @schema_mapping["fields"] = schema["mappings"]["properties"].keys
+      @schema_mapping["dynamic"] = []
+      schema["mappings"]["dynamic_templates"].each do |field_type, info|
+        es_match = info["match"].sub("*", ".*")
+        regex = /^#{es_match}$/
+        @schema_mapping["dynamic"] << info["match"]
+      end
+      # dynamic fields are listed like *_k and will need
+      # to be converted to /_k$/ instead
+    end
+    @schema_mapping
+  end
+
   def set_schema
-    json = @schema["mappings"].to_json
+    json = @requested_schema["mappings"].to_json
 
     puts "Setting schema: #{@mapping_url}"
     RestClient.put(@mapping_url, json, { content_type: :json }) { |res, req, result|

From a5d0047ce8f4e285d1444a10adec490864c83db2 Mon Sep 17 00:00:00 2001
From: Jessica Dussault <jdussault4@gmail.com>
Date: Wed, 15 Jan 2020 10:20:57 -0600
Subject: [PATCH 006/128] creates validator for elasticsearch postings

the validator ensures that all fields have either an exact
mapping OR match a dynamic template, at least as far as our
current simple dynamic templates go. This may need to be adjusted
in the future if we start using more complex templates

refactors file_type post_es method to use Elasticsearch::Index
object and to rely less on repeated "returns" vs a final line at the end

also adds some helpful methods like should_post? to complement
should_transform? for ease
---
 lib/datura/data_manager.rb        | 53 +++++++++++-------------
 lib/datura/elasticsearch/index.rb | 67 ++++++++++++++++++++++---------
 lib/datura/file_type.rb           | 32 +++++++++------
 3 files changed, 90 insertions(+), 62 deletions(-)

diff --git a/lib/datura/data_manager.rb b/lib/datura/data_manager.rb
index 7e71af4d2..237cb1cf5 100644
--- a/lib/datura/data_manager.rb
+++ b/lib/datura/data_manager.rb
@@ -17,7 +17,6 @@ class Datura::DataManager
   attr_accessor :options
   attr_accessor :collection
 
-  attr_accessor :es_schema_mapping
 
   def self.format_to_class
     classes = {
@@ -47,13 +46,6 @@ def initialize
     prepare_xslt
     load_collection_classes
     set_up_logger
-
-    # set up posting URLs
-    @es_url = File.join(options["es_path"], options["es_index"])
-    @solr_url = File.join(options["solr_path"], options["solr_core"], "update")
-
-    # retrieve the specified elasticsearch index's schema
-    set_schema_mappings
   end
 
   # NOTE: This step is what allows collection specific files to override ANY
@@ -81,7 +73,7 @@ def run
     puts msg
 
     check_options
-    get_schema_mappings
+    set_up_services
     pre_file_preparation
     @files = prepare_files
 
@@ -115,7 +107,7 @@ def allowed_files(all_files)
 
   # TODO should this move to Options class?
   def assert_option(opt)
-    if !@options.has_key?(opt)
+    if !@options.key?(opt)
       puts "Option #{opt} was not found!  Check config files and add #{opt} to continue".red
       raise "Missing configuration options"
     end
@@ -137,7 +129,7 @@ def batch_process_files
 
   def check_options
     # verify that everything's all good before moving to per-file level processing
-    if should_transform?("es")
+    if should_post?("es")
       assert_option("es_path")
       assert_option("es_index")
       # options used to obtain the mappings
@@ -148,7 +140,7 @@ def check_options
       assert_option("collection")
     end
 
-    if should_transform?("solr")
+    if should_post?("solr")
       assert_option("solr_core")
       assert_option("solr_path")
     end
@@ -199,8 +191,8 @@ def options_msg
     msg << "Running script with following options:\n"
     msg << "collection:           #{@options['collection']}\n"
     msg << "Environment:          #{@options['environment']}\n"
-    msg << "Posting to:           #{@es_url}\n\n" if should_transform?("es")
-    msg << "Posting to:           #{@solr_url}\n\n" if should_transform?("solr")
+    msg << "Posting to:           #{@es.index_url}\n\n" if should_post?("es")
+    msg << "Posting to:           #{@solr_url}\n\n" if should_post?("solr")
     msg << "Format:               #{@options['format']}\n" if @options["format"]
     msg << "Regex:                #{@options['regex']}\n" if @options["regex"]
     msg << "Allowed Files:        #{@options['allowed_files']}\n" if @options["allowed_files"]
@@ -272,21 +264,6 @@ def prepare_xslt
     end
   end
 
-  # NOTE plural method name in order to accommodate other platforms
-  # we may be checking in the future
-  def set_schema_mappings
-    # only get the elasticsearch mapping if it is needed for post request
-    if should_transform?("es") && !@options["transform_only"]
-      begin
-        es = Datura::Elasticsearch::Index.new(@options)
-        @es_schema_mapping = es.get_schema_mapping
-      rescue => e
-        raise "Unable to get the elasticsearch schema: #{e}"
-      end
-    end
-
-  end
-
   def set_up_logger
     # make directory if one does not already exist
     log_dir = File.join(@options["collection_dir"], "logs")
@@ -300,6 +277,22 @@ def set_up_logger
     )
   end
 
+  def set_up_services
+    if should_post?("es")
+      # set up elasticsearch instance
+      @es = Datura::Elasticsearch::Index.new(@options, schema_mapping: true)
+    end
+
+    if should_post?("solr")
+      # set up posting URLs
+      @solr_url = File.join(options["solr_path"], options["solr_core"], "update")
+    end
+  end
+
+  def should_post?(type)
+    should_transform?(type) && !@options["transform_only"]
+  end
+
   def should_transform?(type)
     # adjust default transformation type in params parser
     @options["transform_types"].include?(type)
@@ -318,7 +311,7 @@ def transform_and_post(file)
           error_with_transform_and_post("#{e}", @error_es)
         end
       else
-        res_es = file.post_es(@es_url)
+        res_es = file.post_es(@es)
         if res_es && res_es.has_key?("error")
           error_with_transform_and_post(res_es["error"], @error_es)
         end
diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index e2cc9cbcc..f759de4ba 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -7,10 +7,11 @@
 class Datura::Elasticsearch::Index
   
   attr_reader :schema_mapping
+  attr_reader :index_url
 
   # if options are passed in, then commandline arguments
   # do not need to be parsed
-  def initialize(options = nil)
+  def initialize(options = nil, schema_mapping: false)
     if !options
       params = Datura::Parser.es_index
       @options = Datura::Options.new(params).all
@@ -18,21 +19,23 @@ def initialize(options = nil)
       @options = options
     end
 
-    @base_url = File.join(@options["es_path"], @options["es_index"])
-    @mapping_url = File.join(@base_url, "_mapping", "_doc?pretty=true")
-    @index_url = "#{@base_url}?pretty=true"
+    @index_url = File.join(@options["es_path"], @options["es_index"])
+    @pretty_url = "#{@index_url}?pretty=true"
+    @mapping_url = File.join(@index_url, "_mapping", "_doc?pretty=true")
 
     # yaml settings (if exist) and mappings
     @requested_schema = YAML.load_file(@options["es_schema"])
-    @schema_mapping = nil
+    # if requested, grab the mapping currently associated with this index
+    # otherwise wait until after the requested schema is loaded
+    get_schema_mapping if schema_mapping
   end
 
   def create
     json = @requested_schema["settings"].to_json
-    puts "Creating ES index for API version #{@options["api_version"]}: #{@index_url}"
+    puts "Creating ES index for API version #{@options["api_version"]}: #{@pretty_url}"
 
     if json && json != "null"
-      RestClient.put(@index_url, json, { content_type: :json }) { |res, req, result|
+      RestClient.put(@pretty_url, json, { content_type: :json }) { |res, req, result|
         if result.code == "200"
           puts res
         else
@@ -40,7 +43,7 @@ def create
         end
       }
     else
-      RestClient.put(@index_url, nil) { |res, req, result|
+      RestClient.put(@pretty_url, nil) { |res, req, result|
         if result.code == "200"
           puts res
         else
@@ -51,9 +54,9 @@ def create
   end
 
   def delete
-    puts "Deleting #{@options["es_index"]} via url #{@index_url}"
+    puts "Deleting #{@options["es_index"]} via url #{@pretty_url}"
 
-    RestClient.delete(@index_url) { |res, req, result|
+    RestClient.delete(@pretty_url) { |res, req, result|
       if result.code != "200"
         raise "#{result.code} error deleting Elasticsearch index: #{res}"
       end
@@ -72,17 +75,26 @@ def get_schema
 
   def get_schema_mapping
     # if mapping has not already been set, get the schema and manipulate
-    if !@schema_mapping
+    if @schema_mapping.nil?
+      @schema_mapping = {}
+      @schema_mapping["dynamic"] = nil
+
       schema = get_schema[@options["es_index"]]
-      @schema_mapping["fields"] = schema["mappings"]["properties"].keys
-      @schema_mapping["dynamic"] = []
-      schema["mappings"]["dynamic_templates"].each do |field_type, info|
-        es_match = info["match"].sub("*", ".*")
-        regex = /^#{es_match}$/
-        @schema_mapping["dynamic"] << info["match"]
+      @schema_mapping["fields"] = schema["mappings"]["_doc"]["properties"].keys
+
+      regex_pieces = []
+      schema["mappings"]["_doc"]["dynamic_templates"].each do |template|
+        mapping = template.map { |k,v| v["match"] }.first
+        # dynamic fields are listed like *_k and will need
+        # to be converted to ^.*_k$, then combined into a mega-regex
+        es_match = mapping.sub("*", ".*")
+        regex = "^#{es_match}$"
+        regex_pieces << regex
+      end
+      if !regex_pieces.empty?
+        regex_joined = regex_pieces.join("|")
+        @schema_mapping["dynamic"] = /#{regex_joined}/
       end
-      # dynamic fields are listed like *_k and will need
-      # to be converted to /_k$/ instead
     end
     @schema_mapping
   end
@@ -100,4 +112,21 @@ def set_schema
     }
   end
 
+  # doc: ruby hash corresponding with Elasticsearch document JSON
+  def valid_document?(doc)
+    get_schema_mapping if @schema_mapping.nil?
+    fields = @schema_mapping["fields"]
+    dynamic = @schema_mapping["dynamic"]
+    # NOTE: validation only checking the names of fields
+    # against the schema, NOT the contents of fields
+    # since Elasticsearch itself will know if you are sending it
+    # text instead of a date field, etc
+
+    valid = doc.keys.all? do |doc_field|
+      # check if exact match for a field or if it matches dynamic field mapping
+      fields.include?(doc_field) || doc_field.match(dynamic)
+    end
+    valid
+  end
+
 end
diff --git a/lib/datura/file_type.rb b/lib/datura/file_type.rb
index 236369a30..68eb6b8b5 100644
--- a/lib/datura/file_type.rb
+++ b/lib/datura/file_type.rb
@@ -49,30 +49,36 @@ def parse_markup_lang_file
     CommonXml.create_xml_object(self.file_location)
   end
 
-  def post_es(url=nil)
-    url = url || "#{@options["es_path"]}/#{@options["es_index"]}"
+  def post_es(es)
+    error = nil
     begin
       transformed = transform_es
     rescue => e
-      return { "error" => "Error transforming ES for #{self.filename(false)}: #{e}" }
+      "Error transforming ES for #{self.filename(false)}: #{e}"
     end
     if transformed && transformed.length > 0
       transformed.each do |doc|
         id = doc["identifier"]
-        puts "posting #{id}"
-        puts "PATH: #{url}/_doc/#{id}" if options["verbose"]
-        # NOTE: If you need to do partial updates rather than replacement of doc
-        # you will need to add _update at the end of this URL
-        begin
-          RestClient.put("#{url}/_doc/#{id}", doc.to_json, {:content_type => :json } )
-        rescue => e
-          return { "error" => "Error transforming or posting to ES for #{self.filename(false)}: #{e.response}" }
+        # before a document is posted, we need to make sure that the fields validate against the schema
+        if es.valid_document?(doc)
+
+          puts "posting #{id}"
+          puts "PATH: #{es.index_url}/_doc/#{id}" if options["verbose"]
+          # NOTE: If you need to do partial updates rather than replacement of doc
+          # you will need to add _update at the end of this URL
+          begin
+            RestClient.put("#{es.index_url}/_doc/#{id}", doc.to_json, {:content_type => :json } )
+          rescue => e
+            "Error transforming or posting to ES for #{self.filename(false)}: #{e.response}"
+          end
+        else
+          error = "Document #{id} did not validate against the elasticsearch schema"
         end
       end
     else
-      return { "error" => "No file was transformed" }
+      error = "No file was transformed"
     end
-    return { "docs" => transformed }
+    error ? { "error" => error } : { "docs" => transformed}
   end
 
   def post_solr(url=nil)

From 861521104115cfb1fb80edfd130c88776b44fcc9 Mon Sep 17 00:00:00 2001
From: Jessica Dussault <jdussault4@gmail.com>
Date: Fri, 17 Jan 2020 11:03:24 -0600
Subject: [PATCH 007/128] whoops missed one

---
 lib/datura/file_type.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/datura/file_type.rb b/lib/datura/file_type.rb
index 68eb6b8b5..0d4d755d8 100644
--- a/lib/datura/file_type.rb
+++ b/lib/datura/file_type.rb
@@ -69,7 +69,7 @@ def post_es(es)
           begin
             RestClient.put("#{es.index_url}/_doc/#{id}", doc.to_json, {:content_type => :json } )
           rescue => e
-            "Error transforming or posting to ES for #{self.filename(false)}: #{e.response}"
+            error = "Error transforming or posting to ES for #{self.filename(false)}: #{e.response}"
           end
         else
           error = "Document #{id} did not validate against the elasticsearch schema"

From 9459f9d7b2738eb6c7f76e98816edd697732c312 Mon Sep 17 00:00:00 2001
From: Jessica Dussault <jdussault4@gmail.com>
Date: Fri, 17 Jan 2020 11:16:42 -0600
Subject: [PATCH 008/128] refactored validator to handle nested field specific
 mapping

that is, previously it was assuming that nested subfields all
match a top level field or dynamic mapping
actually, nested fields can specify their own specific mapping
that the subfields may also access....sooooooo I had to redo stuff

tests should be passing! thank goodness for unit tests and tdd
---
 lib/config/es_api_schemas/2.0.yml |   4 +
 lib/config/public.yml             |   2 +
 lib/datura/data_manager.rb        |   5 +-
 lib/datura/elasticsearch/index.rb |  64 ++++--
 test/es_index_test.rb             | 130 +++++++++++
 test/fixtures/es_mapping_2.0.json | 345 ++++++++++++++++++++++++++++++
 6 files changed, 533 insertions(+), 17 deletions(-)
 create mode 100644 test/es_index_test.rb
 create mode 100644 test/fixtures/es_mapping_2.0.json

diff --git a/lib/config/es_api_schemas/2.0.yml b/lib/config/es_api_schemas/2.0.yml
index c34155bad..237c9cf8b 100644
--- a/lib/config/es_api_schemas/2.0.yml
+++ b/lib/config/es_api_schemas/2.0.yml
@@ -259,6 +259,10 @@ mappings:
         mapping:
           type: keyword
           normalizer: keyword_normalized
+    - nested_fields:
+        match: "*_n"
+        mapping:
+          type: nested
     - text_fields:
         match: "*_t"
         mapping:
diff --git a/lib/config/public.yml b/lib/config/public.yml
index 486e85037..5bee0d115 100644
--- a/lib/config/public.yml
+++ b/lib/config/public.yml
@@ -38,6 +38,8 @@ default:
   # current version of the API (powered by Elasticsearch)
   # this setting determines which of the schemas will be used
   api_version: "override with value like '1.0' or '2.0'"
+  # NOTE: es_schema option is set later as combination of above
+  # es_schema_override, es_schema_path, and api_version
 
   # RESOURCE LOCATIONS
   data_base: https://cdrhmedia.unl.edu      # xml, csv, html snippets, etc
diff --git a/lib/datura/data_manager.rb b/lib/datura/data_manager.rb
index 237cb1cf5..d35e2290a 100644
--- a/lib/datura/data_manager.rb
+++ b/lib/datura/data_manager.rb
@@ -68,12 +68,13 @@ def print_options
   def run
     @time = [Time.now]
     # log starting information for user
+    check_options
+    set_up_services
+
     msg = options_msg
     @log.info(msg)
     puts msg
 
-    check_options
-    set_up_services
     pre_file_preparation
     @files = prepare_files
 
diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index f759de4ba..6732552cb 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -75,15 +75,25 @@ def get_schema
 
   def get_schema_mapping
     # if mapping has not already been set, get the schema and manipulate
-    if @schema_mapping.nil?
-      @schema_mapping = {}
-      @schema_mapping["dynamic"] = nil
+    if !defined?(@schema_mapping)
+      @schema_mapping = {
+        "dyanmic" => nil,  # /regex|regex/
+        "fields" => [],    # [ fields ]
+        "nested" => {}     # { field: [ nested_fields ] }
+      }
 
       schema = get_schema[@options["es_index"]]
-      @schema_mapping["fields"] = schema["mappings"]["_doc"]["properties"].keys
+      doc = schema["mappings"]["_doc"]
+
+      doc["properties"].each do |field, value|
+        @schema_mapping["fields"] << field
+        if value["type"] == "nested"
+          @schema_mapping["nested"][field] = value["properties"].keys
+        end
+      end
 
       regex_pieces = []
-      schema["mappings"]["_doc"]["dynamic_templates"].each do |template|
+      doc["dynamic_templates"].each do |template|
         mapping = template.map { |k,v| v["match"] }.first
         # dynamic fields are listed like *_k and will need
         # to be converted to ^.*_k$, then combined into a mega-regex
@@ -114,19 +124,43 @@ def set_schema
 
   # doc: ruby hash corresponding with Elasticsearch document JSON
   def valid_document?(doc)
-    get_schema_mapping if @schema_mapping.nil?
-    fields = @schema_mapping["fields"]
-    dynamic = @schema_mapping["dynamic"]
+    get_schema_mapping if !defined?(@schema_mapping)
     # NOTE: validation only checking the names of fields
     # against the schema, NOT the contents of fields
-    # since Elasticsearch itself will know if you are sending it
-    # text instead of a date field, etc
-
-    valid = doc.keys.all? do |doc_field|
-      # check if exact match for a field or if it matches dynamic field mapping
-      fields.include?(doc_field) || doc_field.match(dynamic)
+    # Elasticsearch itself checks that you are sending date
+    # formats to date fields, etc
+
+    doc.all? do |field, value|
+      if valid_field?(field)
+        # great, the field is valid, now check if it is a parent
+        nested = Array(value).map do |nested|
+          if nested.class == Hash
+            nested.keys.all? { |k| valid_field?(k, field) }
+          end
+        end
+        # if the array is empty, ignore it, otherwise find out if any
+        # nested fields failed the validate
+        nested.compact.all? { |t| t }
+      else
+        false
+      end
     end
-    valid
+  end
+
+  # if a field, including those inside nested fields,
+  # matches a top level field mapping or a dynamic field,
+  # they are good to go
+  # further, if this is a nested field, they may check
+  # to see if the specific nesting mapping validates them
+  def valid_field?(field, parent=nil)
+    @schema_mapping["fields"].include?(field) ||
+      field.match(@schema_mapping["dynamic"]) ||
+      valid_nested_field?(field, parent)
+  end
+
+  def valid_nested_field?(field, parent)
+    parent_mapping = @schema_mapping["nested"][parent]
+    parent_mapping.include?(field) if parent_mapping
   end
 
 end
diff --git a/test/es_index_test.rb b/test/es_index_test.rb
new file mode 100644
index 000000000..9bf6d6018
--- /dev/null
+++ b/test/es_index_test.rb
@@ -0,0 +1,130 @@
+require "test_helper"
+
+class Datura::ElasticsearchIndexTest < Minitest::Test
+
+  @@options = {
+    "api_version" => "2.0",
+    "es_index" => "fake_index",
+    "es_path" => "fake_path",
+    "es_schema" => File.join(
+      File.expand_path(File.dirname(__FILE__)),
+        "../lib/config/es_api_schemas/2.0.yml"
+    )
+  }
+
+  # stub in get_schema so that we can test get_schema_mapping without
+  # worrying about integration with actual index
+
+  class Datura::Elasticsearch::Index
+    def get_schema
+      raw = File.read(
+        File.join(
+          File.expand_path(File.dirname(__FILE__)),
+          "fixtures/es_mapping_2.0.json"
+        )
+      )
+      JSON.parse(raw)
+    end
+  end
+
+  def test_initialize
+    # test that options populate if you pass existing ones in
+    es = Datura::Elasticsearch::Index.new(@@options)
+    path = File.join(@@options["es_path"], @@options["es_index"])
+    assert_equal path, es.index_url
+
+    # test that schema mapping occurs, although it will be with the stubbed
+    # in version of get_schema above, rather than index integration
+    es = Datura::Elasticsearch::Index.new(@@options, schema_mapping: true)
+    assert es.schema_mapping
+  end
+
+  def test_get_schema_mapping
+    # let's just see what happens
+    es = Datura::Elasticsearch::Index.new(@@options)
+    es.get_schema_mapping
+    assert es.schema_mapping["fields"]
+    assert_equal 46, es.schema_mapping["fields"].length
+    assert_equal(
+      /^.*_d$|^.*_i$|^.*_k$|^.*_n$|^.*_t$|^.*_t_en$|^.*_t_es$/,
+      es.schema_mapping["dynamic"]
+    )
+  end
+
+  def test_valid_document?
+    es = Datura::Elasticsearch::Index.new(@@options)
+
+    # basic fields
+    assert es.valid_document?({ "identifier" => "a" })
+    assert es.valid_document?({
+      "collection" => "a",
+      "date_not_before" => "2012-01-01",
+      "text" => "a",
+    })
+
+    # nested fields with child fields not matching top level field
+    assert es.valid_document?({
+      "creator" => [
+        {
+          "id" => "a",
+          "name" => "a"
+        }
+      ]
+    })
+
+    # nested fields with child fields matching top level / dynamic
+    assert es.valid_document?({
+      "creator" => [
+        {
+          "subcategory" => "a",
+          "data_type" => "a",
+          "keyword_k" => "a"
+        }
+      ]
+    })
+
+    # dynamic fields, each type
+    assert es.valid_document?({ "new_field_d" => "2012-01-1" })
+    assert es.valid_document?({ "new_field_i" => "1" })
+    assert es.valid_document?({ "new_field_k" => "a" })
+    assert es.valid_document?({ "new_field_t" => "a" })
+    assert es.valid_document?({ "new_field_t_en" => "a" })
+    assert es.valid_document?({ "new_field_t_es" => "a" })
+
+    # test failures of basic and dynamic fields
+    refute es.valid_document?({ "bad_field" => "a" })
+    refute es.valid_document?({ "dynamic_t_bad" => "a" })
+
+    # test failure of nested field with all bad subfields
+    refute es.valid_document?({
+      "creator" => [
+        {
+          "bad_field" => "a",
+          "another_one" => "a"
+        }
+      ]
+    })
+
+    # test feailure of nested field with mixture of good / bad
+    refute es.valid_document?({
+      "creator" => [
+        {
+          "id" => "a",
+          "keyword_k" => "a"
+        },
+        {
+          "id" => "a",
+          "bad_field" => "a"
+        }
+      ]
+    })
+
+    # test that bad fields hidden with good still fail
+    refute es.valid_document?({
+      "collection" => "a",
+      "keyword_k" => "a",
+      "bad_field" => "a"
+    })
+  end
+
+end
diff --git a/test/fixtures/es_mapping_2.0.json b/test/fixtures/es_mapping_2.0.json
new file mode 100644
index 000000000..f82189503
--- /dev/null
+++ b/test/fixtures/es_mapping_2.0.json
@@ -0,0 +1,345 @@
+{
+  "fake_index" : {
+    "mappings" : {
+      "_doc" : {
+        "dynamic_templates" : [
+          {
+            "date_fields" : {
+              "match" : "*_d",
+              "mapping" : {
+                "format" : "yyyy-MM-dd||epoch_millis",
+                "type" : "date"
+              }
+            }
+          },
+          {
+            "integer_fields" : {
+              "match" : "*_i",
+              "mapping" : {
+                "type" : "integer"
+              }
+            }
+          },
+          {
+            "keyword_fields" : {
+              "match" : "*_k",
+              "mapping" : {
+                "normalizer" : "keyword_normalized",
+                "type" : "keyword"
+              }
+            }
+          },
+          {
+            "nested_fields" : {
+              "match" : "*_n",
+              "mapping" : {
+                "type" : "nested"
+              }
+            }
+          },
+          {
+            "text_fields" : {
+              "match" : "*_t",
+              "mapping" : {
+                "analyzer" : "english",
+                "type" : "text"
+              }
+            }
+          },
+          {
+            "text_english" : {
+              "match" : "*_t_en",
+              "mapping" : {
+                "analyzer" : "english",
+                "type" : "text"
+              }
+            }
+          },
+          {
+            "text_spanish" : {
+              "match" : "*_t_es",
+              "mapping" : {
+                "analyzer" : "spanish",
+                "type" : "text"
+              }
+            }
+          }
+        ],
+        "properties" : {
+          "abstract" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "alternative" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "annotations_text" : {
+            "type" : "text",
+            "analyzer" : "english"
+          },
+          "category" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "collection" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "collection_desc" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "contributor" : {
+            "type" : "nested",
+            "properties" : {
+              "id" : {
+                "type" : "keyword",
+                "normalizer" : "keyword_normalized"
+              },
+              "name" : {
+                "type" : "keyword",
+                "normalizer" : "keyword_normalized"
+              },
+              "role" : {
+                "type" : "keyword",
+                "normalizer" : "keyword_normalized"
+              }
+            }
+          },
+          "coverage-spatial" : {
+            "type" : "nested",
+            "properties" : {
+              "city" : {
+                "type" : "keyword",
+                "normalizer" : "keyword_normalized"
+              },
+              "coordinates" : {
+                "type" : "geo_point"
+              },
+              "country" : {
+                "type" : "keyword",
+                "normalizer" : "keyword_normalized"
+              },
+              "county" : {
+                "type" : "keyword",
+                "normalizer" : "keyword_normalized"
+              },
+              "id" : {
+                "type" : "keyword",
+                "normalizer" : "keyword_normalized"
+              },
+              "place_name" : {
+                "type" : "keyword",
+                "normalizer" : "keyword_normalized"
+              },
+              "postal_code" : {
+                "type" : "keyword",
+                "normalizer" : "keyword_normalized"
+              },
+              "region" : {
+                "type" : "keyword",
+                "normalizer" : "keyword_normalized"
+              },
+              "state" : {
+                "type" : "keyword",
+                "normalizer" : "keyword_normalized"
+              },
+              "street" : {
+                "type" : "keyword",
+                "normalizer" : "keyword_normalized"
+              }
+            }
+          },
+          "creator" : {
+            "type" : "nested",
+            "properties" : {
+              "id" : {
+                "type" : "keyword",
+                "normalizer" : "keyword_normalized"
+              },
+              "name" : {
+                "type" : "keyword",
+                "normalizer" : "keyword_normalized"
+              }
+            }
+          },
+          "creator_sort" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "data_type" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "date" : {
+            "type" : "date",
+            "format" : "yyyy-MM-dd||epoch_millis"
+          },
+          "date_display" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "date_not_after" : {
+            "type" : "date",
+            "format" : "yyyy-MM-dd||epoch_millis"
+          },
+          "date_not_before" : {
+            "type" : "date",
+            "format" : "yyyy-MM-dd||epoch_millis"
+          },
+          "description" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "extent" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "format" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "identifier" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "image_id" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "image_location" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "keywords" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "language" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "languages" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "medium" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "people" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "person" : {
+            "type" : "nested",
+            "properties" : {
+              "id" : {
+                "type" : "keyword",
+                "normalizer" : "keyword_normalized"
+              },
+              "name" : {
+                "type" : "keyword",
+                "normalizer" : "keyword_normalized"
+              },
+              "role" : {
+                "type" : "keyword",
+                "normalizer" : "keyword_normalized"
+              }
+            }
+          },
+          "places" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "publisher" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "recipient" : {
+            "type" : "nested",
+            "properties" : {
+              "id" : {
+                "type" : "keyword",
+                "normalizer" : "keyword_normalized"
+              },
+              "name" : {
+                "type" : "keyword",
+                "normalizer" : "keyword_normalized"
+              },
+              "role" : {
+                "type" : "keyword",
+                "normalizer" : "keyword_normalized"
+              }
+            }
+          },
+          "relation" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "rights" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "rights_holder" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "rights_uri" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "source" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "subcategory" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "subjects" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "text" : {
+            "type" : "text",
+            "analyzer" : "english"
+          },
+          "title" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "title_sort" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "topics" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "type" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "uri" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "uri_data" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "uri_html" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          },
+          "works" : {
+            "type" : "keyword",
+            "normalizer" : "keyword_normalized"
+          }
+        }
+      }
+    }
+  }
+}

From 423511617981e80538cce902990d4fd1bf85cc0c Mon Sep 17 00:00:00 2001
From: Jessica Dussault <jdussault4@gmail.com>
Date: Fri, 17 Jan 2020 15:03:20 -0600
Subject: [PATCH 009/128] get rid of unnecessary variable definitions

---
 lib/datura/file_types/file_csv.rb | 1 -
 1 file changed, 1 deletion(-)

diff --git a/lib/datura/file_types/file_csv.rb b/lib/datura/file_types/file_csv.rb
index 65655a940..cd8a4e381 100644
--- a/lib/datura/file_types/file_csv.rb
+++ b/lib/datura/file_types/file_csv.rb
@@ -13,7 +13,6 @@ def build_html_from_csv
       # Note: if overriding this function, it's recommended to use
       # a more specific identifier for each row of the CSV
       # but since this is a generic version, simply using the current iteration number
-      id = index
       # using XML instead of HTML for simplicity's sake
       builder = Nokogiri::XML::Builder.new do |xml|
         xml.div(class: "main_content") {

From be55c600985088564aa04eff758d124773eaeee0 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Fri, 20 May 2022 10:10:35 -0500
Subject: [PATCH 010/128] put data methods in index class

---
 bin/es_clear_index                |  2 +-
 lib/datura/elasticsearch/data.rb  | 94 -------------------------------
 lib/datura/elasticsearch/index.rb | 85 ++++++++++++++++++++++++++++
 3 files changed, 86 insertions(+), 95 deletions(-)
 delete mode 100644 lib/datura/elasticsearch/data.rb

diff --git a/bin/es_clear_index b/bin/es_clear_index
index 6cd7b8740..c8534eba5 100755
--- a/bin/es_clear_index
+++ b/bin/es_clear_index
@@ -3,7 +3,7 @@
 require "datura"
 
 begin
-  Datura::Elasticsearch::Data.clear
+  Datura::Elasticsearch::Index.clear
 rescue => e
   puts e
 end
diff --git a/lib/datura/elasticsearch/data.rb b/lib/datura/elasticsearch/data.rb
deleted file mode 100644
index 44b8bb848..000000000
--- a/lib/datura/elasticsearch/data.rb
+++ /dev/null
@@ -1,94 +0,0 @@
-require "json"
-require "rest-client"
-
-require_relative "./../elasticsearch.rb"
-
-module Datura::Elasticsearch::Data
-
-  def self.clear
-    # run the parameters through the option parser
-    params = Datura::Parser.clear_index
-    options = Datura::Options.new(params).all
-    if options["collection"] == "all"
-      self.clear_all(options)
-    else
-      self.clear_index(options)
-    end
-  end
-
-  private
-
-  def self.build_clear_data(options)
-    if options["regex"]
-      field = options["field"] || "identifier"
-      {
-        "query" => {
-          "bool" => {
-            "must" => [
-              { "regexp" => { field => options["regex"] } },
-              { "term" => { "collection" => options["collection"] } }
-            ]
-          }
-        }
-      }
-    else
-      {
-        "query" => { "term" => { "collection" => options["collection"] } }
-      }
-    end
-  end
-
-  def self.clear_all(options)
-    puts "Please verify that you want to clear EVERY ENTRY from the ENTIRE INDEX\n\n"
-    puts "== FIELD / REGEX FILTERS NOT AVAILABLE FOR THIS OPTION, YOU'LL WIPE EVERYTHING ==\n\n"
-    puts "Running this on something other than your computer's localhost? DON'T."
-    puts "Type: 'Yes I'm sure'"
-    confirm = STDIN.gets.chomp
-    if confirm == "Yes I'm sure"
-      url = File.join(options["es_path"], options["es_index"], "_doc", "_delete_by_query?pretty=true")
-      json = { "query" => { "match_all" => {} } }
-      RestClient.post(url, json.to_json, { content_type: :json }) { |res, req, result|
-        if result.code == "200"
-          puts res
-        else
-          raise "#{result.code} error when clearing entire index: #{res}"
-        end
-      }
-    else
-      puts "You typed '#{confirm}'. This is incorrect, exiting program"
-      exit
-    end
-  end
-
-  def self.clear_index(options)
-    url = File.join(options["es_path"], options["es_index"], "_doc", "_delete_by_query?pretty=true")
-    confirmation = self.confirm_clear(options, url)
-
-    if confirmation
-      data = self.build_clear_data(options)
-      RestClient.post(url, data.to_json, { content_type: :json }) { |res, req, result|
-        if result.code == "200"
-          puts res
-        else
-          raise "#{result.code} error when clearing index: #{res}"
-        end
-      }
-    else
-      puts "come back anytime!"
-      exit
-    end
-  end
-
-  def self.confirm_clear(options, url)
-    # verify that the user is really sure about the index they're about to wipe
-    puts "Are you sure that you want to remove entries from"
-    puts " #{options["collection"]}'s #{options['environment']} environment?"
-    puts "url: #{url}"
-    puts "y/N"
-    answer = STDIN.gets.chomp
-    # boolean
-    !!(answer =~ /[yY]/)
-  end
-
-
-end
diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index 6732552cb..842d9316b 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -163,4 +163,89 @@ def valid_nested_field?(field, parent)
     parent_mapping.include?(field) if parent_mapping
   end
 
+  def self.clear
+    # run the parameters through the option parser
+    params = Datura::Parser.clear_index
+    options = Datura::Options.new(params).all
+    if options["collection"] == "all"
+      self.clear_all(options)
+    else
+      self.clear_index(options)
+    end
+  end
+
+  private
+
+  def self.build_clear_data(options)
+    if options["regex"]
+      field = options["field"] || "identifier"
+      {
+        "query" => {
+          "bool" => {
+            "must" => [
+              { "regexp" => { field => options["regex"] } },
+              { "term" => { "collection" => options["collection"] } }
+            ]
+          }
+        }
+      }
+    else
+      {
+        "query" => { "term" => { "collection" => options["collection"] } }
+      }
+    end
+  end
+
+  def self.clear_all(options)
+    puts "Please verify that you want to clear EVERY ENTRY from the ENTIRE INDEX\n\n"
+    puts "== FIELD / REGEX FILTERS NOT AVAILABLE FOR THIS OPTION, YOU'LL WIPE EVERYTHING ==\n\n"
+    puts "Running this on something other than your computer's localhost? DON'T."
+    puts "Type: 'Yes I'm sure'"
+    confirm = STDIN.gets.chomp
+    if confirm == "Yes I'm sure"
+      url = File.join(options["es_path"], options["es_index"], "_doc", "_delete_by_query?pretty=true")
+      json = { "query" => { "match_all" => {} } }
+      RestClient.post(url, json.to_json, { content_type: :json }) { |res, req, result|
+        if result.code == "200"
+          puts res
+        else
+          raise "#{result.code} error when clearing entire index: #{res}"
+        end
+      }
+    else
+      puts "You typed '#{confirm}'. This is incorrect, exiting program"
+      exit
+    end
+  end
+
+  def self.clear_index(options)
+    url = File.join(options["es_path"], options["es_index"], "_doc", "_delete_by_query?pretty=true")
+    confirmation = self.confirm_clear(options, url)
+
+    if confirmation
+      data = self.build_clear_data(options)
+      RestClient.post(url, data.to_json, { content_type: :json }) { |res, req, result|
+        if result.code == "200"
+          puts res
+        else
+          raise "#{result.code} error when clearing index: #{res}"
+        end
+      }
+    else
+      puts "come back anytime!"
+      exit
+    end
+  end
+
+  def self.confirm_clear(options, url)
+    # verify that the user is really sure about the index they're about to wipe
+    puts "Are you sure that you want to remove entries from"
+    puts " #{options["collection"]}'s #{options['environment']} environment?"
+    puts "url: #{url}"
+    puts "y/N"
+    answer = STDIN.gets.chomp
+    # boolean
+    !!(answer =~ /[yY]/)
+  end
+
 end

From 6bda669242c0d39561e51b779d7a480cbe72f0a6 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Fri, 20 May 2022 10:11:39 -0500
Subject: [PATCH 011/128] require_relative so that tests can be run from base
 directory

---
 test/common_xml_test.rb | 2 +-
 test/datura_test.rb     | 2 +-
 test/es_index_test.rb   | 2 +-
 test/helpers_test.rb    | 2 +-
 test/options_test.rb    | 2 +-
 test/tei_to_es_test.rb  | 3 ++-
 6 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/test/common_xml_test.rb b/test/common_xml_test.rb
index 765f85c97..6d5c22224 100644
--- a/test/common_xml_test.rb
+++ b/test/common_xml_test.rb
@@ -1,4 +1,4 @@
-require "test_helper"
+require_relative "test_helper"
 require "nokogiri"
 
 class CommonXmlTest < Minitest::Test
diff --git a/test/datura_test.rb b/test/datura_test.rb
index 92db7ee99..f0e256d1d 100644
--- a/test/datura_test.rb
+++ b/test/datura_test.rb
@@ -1,4 +1,4 @@
-require "test_helper"
+require_relative "test_helper"
 
 class DaturaTest < Minitest::Test
   def test_that_it_has_a_version_number
diff --git a/test/es_index_test.rb b/test/es_index_test.rb
index 9bf6d6018..5cee19c27 100644
--- a/test/es_index_test.rb
+++ b/test/es_index_test.rb
@@ -1,4 +1,4 @@
-require "test_helper"
+require_relative "test_helper"
 
 class Datura::ElasticsearchIndexTest < Minitest::Test
 
diff --git a/test/helpers_test.rb b/test/helpers_test.rb
index fcc4f9c7d..88d740ecf 100644
--- a/test/helpers_test.rb
+++ b/test/helpers_test.rb
@@ -1,4 +1,4 @@
-require "test_helper"
+require_relative "test_helper"
 require "nokogiri"
 
 class Datura::HelpersTest < Minitest::Test
diff --git a/test/options_test.rb b/test/options_test.rb
index 9b4d6dff2..1bf33b60f 100644
--- a/test/options_test.rb
+++ b/test/options_test.rb
@@ -1,4 +1,4 @@
-require "test_helper"
+require_relative "test_helper"
 
 # override the Options class method so that we
 # can test without real config files
diff --git a/test/tei_to_es_test.rb b/test/tei_to_es_test.rb
index abf22a898..19d59c9d1 100644
--- a/test/tei_to_es_test.rb
+++ b/test/tei_to_es_test.rb
@@ -1,4 +1,5 @@
-require "test_helper"
+require_relative "test_helper"
+require "nokogiri"
 
 class TeiToEsTest < Minitest::Test
   def setup

From 95356049b7f1abec4758dd52b85dfce8980c5be2 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Fri, 20 May 2022 11:22:47 -0500
Subject: [PATCH 012/128] move puts from bin methods into es classes

---
 bin/es_alias_add                  | 2 +-
 bin/es_alias_delete               | 2 +-
 bin/es_alias_list                 | 2 +-
 bin/es_get_schema                 | 2 +-
 lib/datura/elasticsearch/alias.rb | 2 +-
 lib/datura/elasticsearch/index.rb | 2 +-
 6 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/bin/es_alias_add b/bin/es_alias_add
index 7f028dfe8..6be2c564a 100755
--- a/bin/es_alias_add
+++ b/bin/es_alias_add
@@ -3,7 +3,7 @@
 require "datura"
 
 begin
-  puts Datura::Elasticsearch::Alias.add
+  Datura::Elasticsearch::Alias.add
 rescue => e
   puts e
 end
diff --git a/bin/es_alias_delete b/bin/es_alias_delete
index 1317c39dc..6c6f2ade4 100755
--- a/bin/es_alias_delete
+++ b/bin/es_alias_delete
@@ -3,7 +3,7 @@
 require "datura"
 
 begin
-  puts Datura::Elasticsearch::Alias.delete
+  Datura::Elasticsearch::Alias.delete
 rescue => e
   puts e
 end
diff --git a/bin/es_alias_list b/bin/es_alias_list
index ba6df4d7e..23ad183e8 100755
--- a/bin/es_alias_list
+++ b/bin/es_alias_list
@@ -2,4 +2,4 @@
 
 require "datura"
 
-puts Datura::Elasticsearch::Alias.list
+Datura::Elasticsearch::Alias.list
diff --git a/bin/es_get_schema b/bin/es_get_schema
index 664988d32..1326d5e48 100755
--- a/bin/es_get_schema
+++ b/bin/es_get_schema
@@ -4,7 +4,7 @@ require "datura"
 
 begin
   es = Datura::Elasticsearch::Index.new
-  puts es.get_schema
+  es.get_schema
 rescue => e
   puts e
 end
diff --git a/lib/datura/elasticsearch/alias.rb b/lib/datura/elasticsearch/alias.rb
index aa7c2e4ad..3dbdefe02 100644
--- a/lib/datura/elasticsearch/alias.rb
+++ b/lib/datura/elasticsearch/alias.rb
@@ -49,7 +49,7 @@ def self.list
     options = Datura::Options.new({}).all
 
     res = RestClient.get(File.join(options["es_path"], "_aliases"))
-    JSON.pretty_generate(JSON.parse(res))
+    puts JSON.pretty_generate(JSON.parse(res))
   end
 
 end
diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index 842d9316b..09e89c8bd 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -66,7 +66,7 @@ def delete
   def get_schema
     RestClient.get(@mapping_url) { |res, req, result|
       if result.code == "200"
-        JSON.parse(res)
+        puts JSON.parse(res)
       else
         raise "#{result.code} error getting Elasticsearch schema: #{res}"
       end

From 5cd5b4db7782a179a3f1c3d7de03ff2fedbc37fb Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Fri, 20 May 2022 16:19:23 -0500
Subject: [PATCH 013/128] change get_schema to return rather than puts

reverts my earlier change, it breaks other functions
---
 bin/es_get_schema                 | 2 +-
 lib/datura/elasticsearch/index.rb | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/bin/es_get_schema b/bin/es_get_schema
index 1326d5e48..664988d32 100755
--- a/bin/es_get_schema
+++ b/bin/es_get_schema
@@ -4,7 +4,7 @@ require "datura"
 
 begin
   es = Datura::Elasticsearch::Index.new
-  es.get_schema
+  puts es.get_schema
 rescue => e
   puts e
 end
diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index 09e89c8bd..842d9316b 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -66,7 +66,7 @@ def delete
   def get_schema
     RestClient.get(@mapping_url) { |res, req, result|
       if result.code == "200"
-        puts JSON.parse(res)
+        JSON.parse(res)
       else
         raise "#{result.code} error getting Elasticsearch schema: #{res}"
       end

From b3da61e2c85578de32e3d72d3c50bb26db0c5c4e Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Fri, 20 May 2022 16:19:53 -0500
Subject: [PATCH 014/128] simplify regex

---
 lib/datura/elasticsearch/index.rb | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index 842d9316b..68ce6b805 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -98,12 +98,11 @@ def get_schema_mapping
         # dynamic fields are listed like *_k and will need
         # to be converted to ^.*_k$, then combined into a mega-regex
         es_match = mapping.sub("*", ".*")
-        regex = "^#{es_match}$"
-        regex_pieces << regex
+        regex_pieces << es_match
       end
       if !regex_pieces.empty?
         regex_joined = regex_pieces.join("|")
-        @schema_mapping["dynamic"] = /#{regex_joined}/
+        @schema_mapping["dynamic"] = /^(?:#{regex_joined})$/
       end
     end
     @schema_mapping

From da6721feb4697e501c3c4a154a839d8d373857c5 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Fri, 20 May 2022 16:23:59 -0500
Subject: [PATCH 015/128] drop unnecessary conditional

---
 lib/datura/elasticsearch/index.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index 68ce6b805..2219d1503 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -123,7 +123,7 @@ def set_schema
 
   # doc: ruby hash corresponding with Elasticsearch document JSON
   def valid_document?(doc)
-    get_schema_mapping if !defined?(@schema_mapping)
+    get_schema_mapping
     # NOTE: validation only checking the names of fields
     # against the schema, NOT the contents of fields
     # Elasticsearch itself checks that you are sending date

From d7ec57903f156a4390321a53fadd2ee2612ce2e7 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Fri, 20 May 2022 16:53:49 -0500
Subject: [PATCH 016/128] return early if invalid nested field found

---
 lib/datura/elasticsearch/index.rb | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index 2219d1503..a409ca550 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -132,14 +132,18 @@ def valid_document?(doc)
     doc.all? do |field, value|
       if valid_field?(field)
         # great, the field is valid, now check if it is a parent
-        nested = Array(value).map do |nested|
+        Array(value).each do |nested|
           if nested.class == Hash
-            nested.keys.all? { |k| valid_field?(k, field) }
+            if nested.keys.all? { |k| valid_field?(k, field) }
+              next
+            else
+              # if one of the nested hashes fails, it 
+              return false
+            end
           end
         end
-        # if the array is empty, ignore it, otherwise find out if any
-        # nested fields failed the validate
-        nested.compact.all? { |t| t }
+        # all nested fields passed, so it is valid
+        true
       else
         false
       end

From 66396ab95424c91232f62f326774523f76f558c6 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Mon, 23 May 2022 11:44:29 -0500
Subject: [PATCH 017/128] change coverage-spatial to spatial

---
 lib/config/es_api_schemas/1.0.yml | 2 +-
 lib/config/es_api_schemas/2.0.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/config/es_api_schemas/1.0.yml b/lib/config/es_api_schemas/1.0.yml
index 89747ddf5..9d3a69650 100644
--- a/lib/config/es_api_schemas/1.0.yml
+++ b/lib/config/es_api_schemas/1.0.yml
@@ -103,7 +103,7 @@ mappings:
       type: keyword
     rights_uri:
       type: keyword
-    coverage-spatial:
+    spatial:
       type: nested
       properties:
         place_name:
diff --git a/lib/config/es_api_schemas/2.0.yml b/lib/config/es_api_schemas/2.0.yml
index 237c9cf8b..841da72a4 100644
--- a/lib/config/es_api_schemas/2.0.yml
+++ b/lib/config/es_api_schemas/2.0.yml
@@ -171,7 +171,7 @@ mappings:
     rights_uri:
       type: keyword
       normalizer: keyword_normalized
-    coverage-spatial:
+    spatial:
       type: nested
       properties:
         place_name:

From fefe2548a8b0fe2b4c1612f3ddf0c64e6aa70910 Mon Sep 17 00:00:00 2001
From: William Dewey <wdewey2@unl.edu>
Date: Mon, 23 May 2022 11:52:09 -0500
Subject: [PATCH 018/128] Update CHANGELOG.md

update documentation for changes to the schema
---
 CHANGELOG.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index e06d16f69..b90e11bf8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -50,6 +50,8 @@ Versioning](https://semver.org/spec/v2.0.0.html).
 - Tests and fixtures for all supported formats except CustomToEs
 - `get_elements` returns nodeset given xpath arguments
 - `spatial` nested fields `spatial.type` and `spatial.title`
+- Versioning system to support multiple elasticsearch schemas
+- Validator to check against the elasticsearch copy
 
 ### Changed
 - Arguments for `get_text`, `get_list`, and `get_xpaths`
@@ -58,12 +60,14 @@ Versioning](https://semver.org/spec/v2.0.0.html).
 - Documentation updated
 - Changed Install instructions to include RVM and gemset naming conventions
 - API field `coverage_spatial` is now just `spatial`
+- refactored executables into modules and classes
 
 ### Migration
 - Change `coverage_spatial` nested field to `spatial`
 - `get_text`, `get_list`, and `get_xpaths` require changing arguments to keyword (like `xml` and `keep_tags`)
 - Recommend checking xpaths and behavior of fields after updating to this version, as some defaults have changed
 - Possible to refactor previous FileCsv overrides to use new CsvToEs abilities, but not necessary
+- Config files should specify `api_version` as 1.0 or 2.0
 
 ## [v0.1.6](https://github.com/CDRH/datura/compare/v0.1.5...v0.1.6) - 2020-04-24 - Improvements to CSV, WEBS transformers and adds Custom transformer
 

From 621193dc4f155cd0646bd5f33740f5018d5fee05 Mon Sep 17 00:00:00 2001
From: Jessica Dussault <jdussault4@gmail.com>
Date: Thu, 9 Jan 2020 15:00:19 -0600
Subject: [PATCH 019/128] moves code out of bin elasticsearch files and into
 module

in order to achieve support for multiple ES schemas
- adds configuration for different schema locations
- moves code from executables into Datura::Elasticsearch module
- Datura::Options combines settings into schema path
---
 lib/datura/elasticsearch/alias.rb |  8 ++-
 lib/datura/elasticsearch/data.rb  | 94 +++++++++++++++++++++++++++++++
 2 files changed, 100 insertions(+), 2 deletions(-)
 create mode 100644 lib/datura/elasticsearch/data.rb

diff --git a/lib/datura/elasticsearch/alias.rb b/lib/datura/elasticsearch/alias.rb
index 3dbdefe02..adf1c5cf1 100644
--- a/lib/datura/elasticsearch/alias.rb
+++ b/lib/datura/elasticsearch/alias.rb
@@ -6,7 +6,11 @@
 module Datura::Elasticsearch::Alias
 
   def self.add
+<<<<<<< HEAD
     params = Datura::Parser.es_alias
+=======
+    params = Datura::Parser.es_alias_add
+>>>>>>> 01ed9e56d (moves code out of bin elasticsearch files and into module)
     options = Datura::Options.new(params).all
 
     ali = options["alias"]
@@ -32,7 +36,7 @@ def self.add
   end
 
   def self.delete
-    params = Datura::Parser.es_alias
+    params = Datura::Parser.es_alias_add
     options = Datura::Options.new(params).all
 
     ali = options["alias"]
@@ -49,7 +53,7 @@ def self.list
     options = Datura::Options.new({}).all
 
     res = RestClient.get(File.join(options["es_path"], "_aliases"))
-    puts JSON.pretty_generate(JSON.parse(res))
+    JSON.pretty_generate(JSON.parse(res))
   end
 
 end
diff --git a/lib/datura/elasticsearch/data.rb b/lib/datura/elasticsearch/data.rb
new file mode 100644
index 000000000..5deedadb1
--- /dev/null
+++ b/lib/datura/elasticsearch/data.rb
@@ -0,0 +1,94 @@
+require "json"
+require "rest-client"
+
+require_relative "./../elasticsearch.rb"
+
+module Datura::Elasticsearch::Data
+
+  def self.clear
+    # run the parameters through the option parser
+    params = Datura::Parser.clear_index_params
+    options = Datura::Options.new(params).all
+    if options["collection"] == "all"
+      self.clear_all(options)
+    else
+      self.clear_index(options)
+    end
+  end
+
+  private
+
+  def self.build_clear_data(options)
+    if options["regex"]
+      field = options["field"] || "identifier"
+      {
+        "query" => {
+          "bool" => {
+            "must" => [
+              { "regexp" => { field => options["regex"] } },
+              { "term" => { "collection" => options["collection"] } }
+            ]
+          }
+        }
+      }
+    else
+      {
+        "query" => { "term" => { "collection" => options["collection"] } }
+      }
+    end
+  end
+
+  def self.clear_all(options)
+    puts "Please verify that you want to clear EVERY ENTRY from the ENTIRE INDEX\n\n"
+    puts "== FIELD / REGEX FILTERS NOT AVAILABLE FOR THIS OPTION, YOU'LL WIPE EVERYTHING ==\n\n"
+    puts "Running this on something other than your computer's localhost? DON'T."
+    puts "Type: 'Yes I'm sure'"
+    confirm = STDIN.gets.chomp
+    if confirm == "Yes I'm sure"
+      url = File.join(options["es_path"], options["es_index"], "_doc", "_delete_by_query?pretty=true")
+      json = { "query" => { "match_all" => {} } }
+      RestClient.post(url, json.to_json, { content_type: :json }) { |res, req, result|
+        if result.code == "200"
+          puts res
+        else
+          raise "#{result.code} error when clearing entire index: #{res}"
+        end
+      }
+    else
+      puts "You typed '#{confirm}'. This is incorrect, exiting program"
+      exit
+    end
+  end
+
+  def self.clear_index(options)
+    url = File.join(options["es_path"], options["es_index"], "_doc", "_delete_by_query?pretty=true")
+    confirmation = self.confirm_clear(options, url)
+
+    if confirmation
+      data = self.build_clear_data(options)
+      RestClient.post(url, data.to_json, { content_type: :json }) { |res, req, result|
+        if result.code == "200"
+          puts res
+        else
+          raise "#{result.code} error when clearing index: #{res}"
+        end
+      }
+    else
+      puts "come back anytime!"
+      exit
+    end
+  end
+
+  def self.confirm_clear(options, url)
+    # verify that the user is really sure about the index they're about to wipe
+    puts "Are you sure that you want to remove entries from"
+    puts " #{options["collection"]}'s #{options['environment']} environment?"
+    puts "url: #{url}"
+    puts "y/N"
+    answer = STDIN.gets.chomp
+    # boolean
+    !!(answer =~ /[yY]/)
+  end
+
+
+end

From 59c9dd51e52e05ae7da8ce87e59b9379e6c12743 Mon Sep 17 00:00:00 2001
From: Jessica Dussault <jdussault4@gmail.com>
Date: Fri, 10 Jan 2020 10:20:22 -0600
Subject: [PATCH 020/128] in progress working on validator for es fields)

---
 lib/datura/data_manager.rb | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/lib/datura/data_manager.rb b/lib/datura/data_manager.rb
index d35e2290a..a063b28d0 100644
--- a/lib/datura/data_manager.rb
+++ b/lib/datura/data_manager.rb
@@ -17,6 +17,10 @@ class Datura::DataManager
   attr_accessor :options
   attr_accessor :collection
 
+<<<<<<< HEAD
+=======
+  attr_accessor :es_schema_mapping
+>>>>>>> 9c7eded0a (in progress working on validator for es fields))
 
   def self.format_to_class
     classes = {

From 162f980d1dc53c30ac9274f85f5712bab06a2597 Mon Sep 17 00:00:00 2001
From: Jessica Dussault <jdussault4@gmail.com>
Date: Wed, 15 Jan 2020 10:20:57 -0600
Subject: [PATCH 021/128] creates validator for elasticsearch postings

the validator ensures that all fields have either an exact
mapping OR match a dynamic template, at least as far as our
current simple dynamic templates go. This may need to be adjusted
in the future if we start using more complex templates

refactors file_type post_es method to use Elasticsearch::Index
object and to rely less on repeated "returns" vs a final line at the end

also adds some helpful methods like should_post? to complement
should_transform? for ease
---
 lib/datura/data_manager.rb | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/lib/datura/data_manager.rb b/lib/datura/data_manager.rb
index a063b28d0..9eac0d094 100644
--- a/lib/datura/data_manager.rb
+++ b/lib/datura/data_manager.rb
@@ -17,11 +17,6 @@ class Datura::DataManager
   attr_accessor :options
   attr_accessor :collection
 
-<<<<<<< HEAD
-=======
-  attr_accessor :es_schema_mapping
->>>>>>> 9c7eded0a (in progress working on validator for es fields))
-
   def self.format_to_class
     classes = {
       "csv" => FileCsv,

From ef20fe898d1a5388e95bf404898c46995e6845e8 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Wed, 3 Nov 2021 14:04:21 -0500
Subject: [PATCH 022/128] add byebug and update gems

---
 Gemfile      | 1 +
 Gemfile.lock | 2 ++
 2 files changed, 3 insertions(+)

diff --git a/Gemfile b/Gemfile
index 88e0e14c5..afaf20dc0 100644
--- a/Gemfile
+++ b/Gemfile
@@ -2,5 +2,6 @@ source "https://rubygems.org"
 
 git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
 
+gem "byebug"
 # Specify your gem's dependencies in datura.gemspec
 gemspec
diff --git a/Gemfile.lock b/Gemfile.lock
index 40873a8c0..82108be99 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -9,6 +9,7 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
+    byebug (11.1.3)
     colorize (0.8.1)
     domain_name (0.5.20190701)
       unf (>= 0.0.5, < 1.0.0)
@@ -38,6 +39,7 @@ PLATFORMS
 
 DEPENDENCIES
   bundler (>= 1.16.0, < 3.0)
+  byebug
   datura!
   minitest (~> 5.0)
   rake (~> 13.0)

From 1470e123e315fa6241261e3624a69585f61fc74e Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Wed, 3 Nov 2021 14:05:44 -0500
Subject: [PATCH 023/128] specify proper api_version, add xsl file for ead

---
 lib/config/public.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/lib/config/public.yml b/lib/config/public.yml
index 5bee0d115..11b42716c 100644
--- a/lib/config/public.yml
+++ b/lib/config/public.yml
@@ -37,7 +37,7 @@ default:
   es_schema_path: lib/config/es_api_schemas
   # current version of the API (powered by Elasticsearch)
   # this setting determines which of the schemas will be used
-  api_version: "override with value like '1.0' or '2.0'"
+  api_version: "1.0"
   # NOTE: es_schema option is set later as combination of above
   # es_schema_override, es_schema_path, and api_version
 
@@ -67,6 +67,7 @@ default:
   html_html_xsl: scripts/.xslt-datura/html_to_html/html_to_html.xsl
   tei_html_xsl: scripts/.xslt-datura/tei_to_html/tei_to_html.xsl
   vra_html_xsl: scripts/.xslt-datura/vra_to_html/vra_to_html.xsl
+  ead_html_xsl: scripts/.xslt-datura/ead_to_html/ead_to_html.xsl
 
   # XSLT PARAMETERS
   # NOTE! If you are altering ANY of the variables you must

From 17f3ac6c6c83d558df3fd1fd6a16c11359a21a40 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Wed, 3 Nov 2021 14:10:16 -0500
Subject: [PATCH 024/128] add ead to format_to_class

---
 lib/datura/data_manager.rb | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/lib/datura/data_manager.rb b/lib/datura/data_manager.rb
index 9eac0d094..96544e045 100644
--- a/lib/datura/data_manager.rb
+++ b/lib/datura/data_manager.rb
@@ -1,7 +1,7 @@
 require "colorize"
 require "logger"
 require "yaml"
-
+require "byebug"
 require_relative "./requirer.rb"
 
 class Datura::DataManager
@@ -20,6 +20,7 @@ class Datura::DataManager
   def self.format_to_class
     classes = {
       "csv" => FileCsv,
+      "ead" => FileEad,
       "html" => FileHtml,
       "tei" => FileTei,
       "vra" => FileVra,
@@ -76,7 +77,6 @@ def run
 
     pre_file_preparation
     @files = prepare_files
-
     pre_batch_processing
     batch_process_files
     post_batch_processing
@@ -299,7 +299,6 @@ def should_transform?(type)
   end
 
   def transform_and_post(file)
-
     # elasticsearch
     if should_transform?("es")
       if @options["transform_only"]

From e39f423610d137865acc124d55c489252d598719 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Wed, 3 Nov 2021 14:15:08 -0500
Subject: [PATCH 025/128] add date helpers from newer Datura version

---
 lib/datura/helpers.rb | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/lib/datura/helpers.rb b/lib/datura/helpers.rb
index efa0001ff..831d148c3 100644
--- a/lib/datura/helpers.rb
+++ b/lib/datura/helpers.rb
@@ -45,6 +45,38 @@ def self.date_standardize(date, before=true)
   #   params: directory (string)
   #   returns: returns array of all files found ([] if none),
   #     returns nil if no directory by that name exists
+  def self.date_display(date, nd_text="N.D.")
+    date_hyphen = self.date_standardize(date)
+    if date_hyphen
+      y, m, d = date_hyphen.split("-").map { |s| s.to_i }
+      date_obj = Date.new(y, m, d)
+      date_obj.strftime("%B %-d, %Y")
+    else
+      nd_text
+    end
+  end
+
+  # date_standardize
+  #   automatically defaults to setting incomplete dates to the earliest
+  #   date (2016-07 becomes 2016-07-01) but pass in "false" in order
+  #   to set it to the latest available date
+  def self.date_standardize(date, before=true)
+    if date
+      y, m, d = date.split(/-|\//)
+      if y && y.length == 4
+        # use -1 to indicate that this will be the last possible
+        m_default = before ? "01" : "-1"
+        d_default = before ? "01" : "-1"
+        m = m_default if !m
+        d = d_default if !d
+        if Date.valid_date?(y.to_i, m.to_i, d.to_i)
+          date = Date.new(y.to_i, m.to_i, d.to_i)
+          date.strftime("%Y-%m-%d")
+        end
+      end
+    end
+  end
+  
   def self.get_directory_files(directory, verbose_flag=false)
     exists = File.directory?(directory)
     if exists

From 95ea4542ca5ac1948f531e69b952a97071aa9a25 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Wed, 3 Nov 2021 14:17:32 -0500
Subject: [PATCH 026/128] add byebug to gemspec

---
 datura.gemspec | 1 +
 1 file changed, 1 insertion(+)

diff --git a/datura.gemspec b/datura.gemspec
index ef3099880..316a5e2a0 100644
--- a/datura.gemspec
+++ b/datura.gemspec
@@ -60,4 +60,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "bundler", ">= 1.16.0", "< 3.0"
   spec.add_development_dependency "minitest", "~> 5.0"
   spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "byebug", "~> 11.0"
 end

From ae49d184bb60dc21d2bdeb77b2ca9a317c7a307d Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Wed, 3 Nov 2021 14:21:05 -0500
Subject: [PATCH 027/128] add gem

---
 datura-0.1.4.gem | Bin 0 -> 91136 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 datura-0.1.4.gem

diff --git a/datura-0.1.4.gem b/datura-0.1.4.gem
new file mode 100644
index 0000000000000000000000000000000000000000..d1216675f068ebe213245adbfc7813a7c50f5b6e
GIT binary patch
literal 91136
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

literal 0
HcmV?d00001


From 5d56df7f14cbafcf133e2ad5e9e0c28e3f91a8a5 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Wed, 3 Nov 2021 14:22:23 -0500
Subject: [PATCH 028/128] add file_ead class

---
 lib/datura/file_types/file_ead.rb | 45 +++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 lib/datura/file_types/file_ead.rb

diff --git a/lib/datura/file_types/file_ead.rb b/lib/datura/file_types/file_ead.rb
new file mode 100644
index 000000000..110b9d5c0
--- /dev/null
+++ b/lib/datura/file_types/file_ead.rb
@@ -0,0 +1,45 @@
+require_relative "../helpers.rb"
+require_relative "../file_type.rb"
+require_relative "../solr_poster.rb"
+require "rest-client"
+
+class FileEad < FileType
+  # TODO we could include the tei_to_es and other modules directly here
+  # as a mixin, though then we'll need to namespace them or perish
+  attr_reader :es_req
+
+
+  def initialize(file_location, options)
+    super(file_location, options)
+    @script_html = File.join(options["collection_dir"], options["ead_html_xsl"]) # There needs to be an xsl file to transform into html
+    # I don't think we need solr at this point)
+    # @script_solr = File.join(options["collection_dir"], options["tei_solr_xsl"])
+  end
+
+  def subdoc_xpaths
+    # match subdocs against classes
+    return {
+      "/EAD" => EadToEs,
+      # "//dsc/c01" => EadToEsItems,
+    }
+  end
+
+  # if there should not be any html transformation taking place
+  # then leave this method empty but uncommented to override default behavior
+
+  # if you would like to use the default transformation behavior
+  # then comment or remove both of the following methods!
+
+  # def transform_es
+  # end
+
+  # def transform_html
+  # end
+
+  def transform_iiif
+    raise "EAD to IIIF is not yet generalized, please override on a per project basis"
+  end
+
+  # def transform_solr
+  # end
+end

From 5acd4f15d390cc32244b572b03caeee15445d6f7 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Wed, 3 Nov 2021 14:23:31 -0500
Subject: [PATCH 029/128] add EadToES class

---
 lib/datura/to_es/ead_to_es.rb | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 lib/datura/to_es/ead_to_es.rb

diff --git a/lib/datura/to_es/ead_to_es.rb b/lib/datura/to_es/ead_to_es.rb
new file mode 100644
index 000000000..318053df7
--- /dev/null
+++ b/lib/datura/to_es/ead_to_es.rb
@@ -0,0 +1,33 @@
+require_relative "xml_to_es.rb"
+require_relative "ead_to_es/fields.rb"
+require_relative "ead_to_es/request.rb"
+require_relative "ead_to_es/xpaths.rb"
+
+###########################################################
+# NOTE:  DO NOT EDIT EAD_TO_ES FILES IN SCRIPTS DIRECTORY #
+###########################################################
+
+#   (unless you are a CDRH dev and then you may do so very cautiously)
+#   this file provides defaults for ALL of the collections included
+#   in the API and changing it could alter dozens of sites unexpectedly!
+# PLEASE RUN LOADS OF TESTS AFTER A CHANGE BEFORE PUSHING TO PRODUCTION
+
+# HOW DO I CHANGE XPATHS?
+#   You may add or modify xpaths in each collection's ead_to_es.rb file
+#   located in the collections/<collection>/scripts directory
+
+# HOW DO I CHANGE FIELD CONTENT?
+#   You may need to alter an xpath, but otherwise you may also
+#   copy paste the field defined in ead_to_es/fields.rb and change
+#   it as needed. If you are dealing with something particularly complex
+#   you may need to consult with a CDRH dev for help
+
+# HOW DO I CUSTOMIZE THE FIELDS BEING SENT TO ELASTICSEARCH?
+#   You will need to look in the ead_to_es/request.rb file, which has
+#   collections of fields being sent to elasticsearch
+#   you can override individual chunks of fields in your collection
+
+class EadToEs < XmlToEs
+  # Override XmlToEs methods that need to be customized for EAD here
+  # rather than in one of the files in ead_to_es/
+end

From 5b6770755a1b642425847fd10e960b119429b9e9 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Wed, 3 Nov 2021 14:26:21 -0500
Subject: [PATCH 030/128] add files for EadToEs

---
 lib/datura/to_es/ead_to_es/fields.rb  | 250 ++++++++++++++++++++++++++
 lib/datura/to_es/ead_to_es/request.rb |   7 +
 lib/datura/to_es/ead_to_es/xpaths.rb  |  38 ++++
 3 files changed, 295 insertions(+)
 create mode 100644 lib/datura/to_es/ead_to_es/fields.rb
 create mode 100644 lib/datura/to_es/ead_to_es/request.rb
 create mode 100644 lib/datura/to_es/ead_to_es/xpaths.rb

diff --git a/lib/datura/to_es/ead_to_es/fields.rb b/lib/datura/to_es/ead_to_es/fields.rb
new file mode 100644
index 000000000..9c8f35e6c
--- /dev/null
+++ b/lib/datura/to_es/ead_to_es/fields.rb
@@ -0,0 +1,250 @@
+class EadToEs < XmlToEs
+  # Note to add custom fields, use "assemble_collection_specific" from request.rb
+  # and be sure to either use the _d, _i, _k, or _t to use the correct field type
+
+  ##########
+  # FIELDS #
+  ##########
+
+  def id
+    get_text(@xpaths["identifer"])
+  end
+
+  # def id_dc
+  #   # TODO use api path from config or something?
+  #   "https://cdrhapi.unl.edu/doc/#{@id}"
+  # end
+
+  # def annotations_text
+  #   # TODO what should default behavior be?
+  # end
+
+  # def category
+  #   category = get_text(@xpaths["category"])
+  #   return category.length > 0 ? CommonXml.normalize_space(category) : "none"
+  # end
+
+  # note this does not sort the creators
+  def creator
+    creators = get_list(@xpaths["creators"])
+    return creators.map { |creator| { "name" => CommonXml.normalize_space(creator) } }
+  end
+
+  # returns ; delineated string of alphabetized creators
+  def creator_sort
+    return get_text(@xpaths["creators"])
+  end
+
+  def collection
+    @options["collection"]
+  end
+
+  def collection_desc
+    @options["collection_desc"] || @options["collection"]
+  end
+
+  # def contributor
+  #   contribs = []
+  #   @xpaths["contributors"].each do |xpath|
+  #     eles = @xml.xpath(xpath)
+  #     eles.each do |ele|
+  #       contribs << {
+  #         "id" => ele["id"],
+  #         "name" => CommonXml.normalize_space(ele.text),
+  #         "role" => CommonXml.normalize_space(ele["role"])
+  #       }
+  #     end
+  #   end
+  #   contribs.uniq
+  # end
+
+  def data_type
+    "ead"
+  end
+
+  def date(before=true)
+    datestr = get_text(@xpaths["date"])
+    return CommonXml.date_standardize(datestr, before)
+  end
+
+  # def date_display
+  #   get_text(@xpaths["date_display"])
+  # end
+
+  def date_not_after
+    date(false)
+  end
+
+  def date_not_before
+    date(true)
+  end
+
+  def description
+    get_text(@xpaths["description"])
+  end
+
+  def extent
+    get_text(@xpaths["extent"])
+  end
+
+  def format
+    matched_format = nil
+    # iterate through all the formats until the first one matches
+    @xpaths["formats"].each do |type, xpath|
+      text = get_text(xpath)
+      matched_format = type if text && text.length > 0
+    end
+    matched_format
+  end
+
+  # def image_id
+  #   # Note: don't pull full path because will be pulled by IIIF
+  #   images = get_list(@xpaths["image_id"])
+  #   images[0] if images
+  # end
+
+  # def keywords
+  #   get_list(@xpaths["keywords"])
+  # end
+
+  # def language
+  #   get_text(@xpaths["language"])
+  # end
+
+  # def languages
+  #   get_list(@xpaths["languages"])
+  # end
+
+  def medium
+    # Default behavior is the same as "format" method
+    format
+  end
+
+  # def person
+  #   # TODO will need some examples of how this will work
+  #   # and put in the xpaths above, also for attributes, etc
+  #   # should contain name, id, and role
+  #   eles = @xml.xpath(@xpaths["person"])
+  #   people = eles.map do |p|
+  #     {
+  #       "id" => "",
+  #       "name" => CommonXml.normalize_space(p.text),
+  #       "role" => CommonXml.normalize_space(p["role"])
+  #     }
+  #   end
+  #   return people
+  # end
+
+  # def people
+  #   @json["person"].map { |p| CommonXml.normalize_space(p["name"]) }
+  # end
+
+  # def places
+  #   return get_list(@xpaths["places"])
+  # end
+
+  # def publisher
+  #   get_text(@xpaths["publisher"])
+  # end
+
+  # def recipient
+  #   eles = @xml.xpath(@xpaths["recipient"])
+  #   people = eles.map do |p|
+  #     {
+  #       "id" => "",
+  #       "name" => CommonXml.normalize_space(p.text),
+  #       "role" => "recipient"
+  #     }
+  #   end
+  #   return people
+  # end
+
+  # def rights
+  #   # Note: override by collection as needed
+  #   get_text(@xpaths["rights"])
+  # end
+
+  # def rights_holder
+  #   get_text(@xpaths["rights_holder"])
+  # end
+
+  def rights_uri
+    # by default collections have no uri associated with them
+    # copy this method into collection specific tei_to_es.rb
+    # to return specific string or xpath as required
+  end
+
+  # def source
+  #   get_text(@xpaths["source"])
+  # end
+
+  # def subjects
+  #   get_list(@xpaths["subjects"])
+  # end
+
+  # def subcategory
+  #   subcategory = get_text(@xpaths["subcategory"])
+  #   subcategory.length > 0 ? subcategory : "none"
+  # end
+
+  def text
+    # handling separate fields in array
+    # means no worrying about handling spacing between words
+    text = []
+    @xpaths.keys.each do [xpath] 
+      body = get_text(@xpaths[xpath])
+      text << body
+    end
+    # TODO: do we need to preserve tags like <i> in text? if so, turn get_text to true
+    # text << CommonXml.convert_tags_in_string(body)
+    # text += text_additional
+    # return CommonXml.normalize_space(text.join(" "))
+  end
+
+  # def text_additional
+  #   # Note: Override this per collection if you need additional
+  #   # searchable fields or information for collections
+  #   # just make sure you return an array at the end!
+
+  #   text = []
+  #   text << title
+  # end
+
+  def title
+    get_text(@xpaths["title"])
+  end
+
+  def title_sort
+    t = title
+    CommonXml.normalize_name(t)
+  end
+
+  def type
+    get_text(@xpaths["type"])
+  end
+
+  # def topics
+  #   get_list(@xpaths["topic"])
+  # end
+
+  # def uri
+  #   # override per collection
+  #   # should point at the live website view of resource
+  # end
+
+  # def uri_data
+  #   base = @options["data_base"]
+  #   subpath = "data/#{@options["collection"]}/source/tei"
+  #   return "#{base}/#{subpath}/#{@id}.xml"
+  # end
+
+  # def uri_html
+  #   base = @options["data_base"]
+  #   subpath = "data/#{@options["collection"]}/output/#{@options["environment"]}/html"
+  #   return "#{base}/#{subpath}/#{@id}.html"
+  # end
+
+  def works
+    # TODO need to create a list of items, maybe an array of ids
+  end
+end
diff --git a/lib/datura/to_es/ead_to_es/request.rb b/lib/datura/to_es/ead_to_es/request.rb
new file mode 100644
index 000000000..e0e0c9899
--- /dev/null
+++ b/lib/datura/to_es/ead_to_es/request.rb
@@ -0,0 +1,7 @@
+class EadToEs < XmlToEs
+
+  # please refer to generic xml to es request file, request.rb
+  # and override methods specific to TEI transformation here
+  # project specific overrides should go in the COLLECTION's overrides!
+
+end
diff --git a/lib/datura/to_es/ead_to_es/xpaths.rb b/lib/datura/to_es/ead_to_es/xpaths.rb
new file mode 100644
index 000000000..10a1147b5
--- /dev/null
+++ b/lib/datura/to_es/ead_to_es/xpaths.rb
@@ -0,0 +1,38 @@
+class EadToEs < XmlToEs
+  # These are the default xpaths that are used for collections
+  #  if you require a different xpath, please override the xpath in
+  #  the specific collection's TeiToEs file or create a new method
+  #  in that file which returns a different value
+  def xpaths_list
+      {
+        # "abstract" => "/ead/archdesc/did/abstract"
+        # "category" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='category'][1]/term",
+        # "contributors" => [
+        #   "/TEI/teiHeader/revisionDesc/change/name",
+        #   "/TEI/teiHeader/fileDesc/titleStmt/editor"
+        # ],
+        "creators" => ["/ead/archdesc/did/origination/persname", "/ead/eadheader/filedesc/titlestmt/creator"]
+        "date" => "/ead/eadheader/filedesc/publicationstmt/date",
+        "description" => "/ead/archdesc/scopecontent/p",
+        # a non normalized date taken directly from the source material ("Dec 9", "Winter 1889")
+        # "date_display" => "/TEI/teiHeader/fileDesc/sourceDesc/bibl/date",
+        "formats" => "/ead/archdesc/did/physdesc/genreform",
+        # "image_id" => "/TEI/text//pb/@facs",
+        # "keywords" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='keywords']/term",
+        # note: language is global attribute xml:lang
+        "identifier" => "/ead/archdesc/did/unitid",
+        "language" => "/ead/eadheader/profiledesc/langusage/language",
+        # "languages" => "//body/div1/@lang",
+        # "person" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='people']/term",
+        # "places" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='places']/term",
+        "publisher" => "/ead/eadheader/filedesc/publicationstmt/publisher",
+        # "recipient" => "/TEI/teiHeader/profileDesc/particDesc/person[@role='recipient']/persName",
+        "repository_contact" => "/ead/archdesc/did/repository/addresses",
+        "rights" => "/ead/archdesc/descgrp/accessrestrict/p",
+        "rights_holder" => "ead/archdesc/did/repository/corpname",
+        "source" => "/ead/archdesc/descgrp/prefercite/p",
+        "subjects" => "/ead/archdesc/controlaccess/*[not(name()="head")]"],
+        # "subcategory" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='subcategory'][1]/term",
+        "titles" => "ead/archdesc/did/unittitle",
+        "text" => "/ead/eadheader/filedesc/titlestmt/*",
+      }

From 023fd82f610885a27318da949f51973d74a13b4a Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Wed, 3 Nov 2021 14:28:44 -0500
Subject: [PATCH 031/128] add EadToEsItems class and associated files

---
 lib/datura/to_es/ead_to_es_items.rb         |  36 +++
 lib/datura/to_es/ead_to_es_items/fields.rb  | 244 ++++++++++++++++++++
 lib/datura/to_es/ead_to_es_items/request.rb |   7 +
 lib/datura/to_es/ead_to_es_items/xpaths.rb  |  45 ++++
 4 files changed, 332 insertions(+)
 create mode 100644 lib/datura/to_es/ead_to_es_items.rb
 create mode 100644 lib/datura/to_es/ead_to_es_items/fields.rb
 create mode 100644 lib/datura/to_es/ead_to_es_items/request.rb
 create mode 100644 lib/datura/to_es/ead_to_es_items/xpaths.rb

diff --git a/lib/datura/to_es/ead_to_es_items.rb b/lib/datura/to_es/ead_to_es_items.rb
new file mode 100644
index 000000000..ff6ec3e9c
--- /dev/null
+++ b/lib/datura/to_es/ead_to_es_items.rb
@@ -0,0 +1,36 @@
+require_relative "xml_to_es.rb"
+require_relative "ead_to_es_items/fields.rb"
+require_relative "ead_to_es_items/request.rb"
+require_relative "ead_to_es_items/xpaths.rb"
+
+###########################################################
+# NOTE:  DO NOT EDIT EAD_TO_ES FILES IN SCRIPTS DIRECTORY #
+###########################################################
+
+#   (unless you are a CDRH dev and then you may do so very cautiously)
+#   this file provides defaults for ALL of the collections included
+#   in the API and changing it could alter dozens of sites unexpectedly!
+# PLEASE RUN LOADS OF TESTS AFTER A CHANGE BEFORE PUSHING TO PRODUCTION
+
+# HOW DO I CHANGE XPATHS?
+#   You may add or modify xpaths in each collection's ead_to_es.rb file
+#   located in the collections/<collection>/scripts directory
+
+# HOW DO I CHANGE FIELD CONTENT?
+#   You may need to alter an xpath, but otherwise you may also
+#   copy paste the field defined in ead_to_es/fields.rb and change
+#   it as needed. If you are dealing with something particularly complex
+#   you may need to consult with a CDRH dev for help
+
+# HOW DO I CUSTOMIZE THE FIELDS BEING SENT TO ELASTICSEARCH?
+#   You will need to look in the ead_to_es/request.rb file, which has
+#   collections of fields being sent to elasticsearch
+#   you can override individual chunks of fields in your collection
+
+class EadToEs < XmlToEs
+  # Override XmlToEs methods that need to be customized for EAD here
+  # rather than in one of the files in ead_to_es/
+  def get_id
+    @id
+  end
+end
diff --git a/lib/datura/to_es/ead_to_es_items/fields.rb b/lib/datura/to_es/ead_to_es_items/fields.rb
new file mode 100644
index 000000000..b5ca56d79
--- /dev/null
+++ b/lib/datura/to_es/ead_to_es_items/fields.rb
@@ -0,0 +1,244 @@
+class EadToEsItems < XmlToEs
+  # Note to add custom fields, use "assemble_collection_specific" from request.rb
+  # and be sure to either use the _d, _i, _k, or _t to use the correct field type
+
+  ##########
+  # FIELDS #
+  ##########
+
+  def id
+    get_text(@xpaths["identifer"])
+  end
+
+  # def id_dc
+  #   # TODO use api path from config or something?
+  #   "https://cdrhapi.unl.edu/doc/#{@id}"
+  # end
+
+  # def annotations_text
+  #   # TODO what should default behavior be?
+  # end
+
+  # def category
+  #   category = get_text(@xpaths["category"])
+  #   return category.length > 0 ? CommonXml.normalize_space(category) : "none"
+  # end
+
+  # note this does not sort the creators
+  def creator
+    creators = get_list(@xpaths["creators"])
+    return creators.map { |creator| { "name" => CommonXml.normalize_space(creator) } }
+  end
+
+  # returns ; delineated string of alphabetized creators
+  def creator_sort
+    return get_text(@xpaths["creators"])
+  end
+
+  def collection
+    "manuscripts"
+  end
+
+  def collection_desc
+    @options["collection_desc"] || @options["collection"]
+  end
+
+  # def contributor
+  #   contribs = []
+  #   @xpaths["contributors"].each do |xpath|
+  #     eles = @xml.xpath(xpath)
+  #     eles.each do |ele|
+  #       contribs << {
+  #         "id" => ele["id"],
+  #         "name" => CommonXml.normalize_space(ele.text),
+  #         "role" => CommonXml.normalize_space(ele["role"])
+  #       }
+  #     end
+  #   end
+  #   contribs.uniq
+  # end
+
+  def data_type
+    "ead"
+  end
+
+  def date(before=true)
+    datestr = get_text(@xpaths["date"])
+    return CommonXml.date_standardize(datestr, before)
+  end
+
+  def date_display
+    get_text(@xpaths["date_display"])
+  end
+
+  def date_not_after
+    date(false)
+  end
+
+  def date_not_before
+    date(true)
+  end
+
+  def description
+    # Note: override per collection as needed
+  end
+
+  def format
+    matched_format = nil
+    # iterate through all the formats until the first one matches
+    @xpaths["formats"].each do |type, xpath|
+      text = get_text(xpath)
+      matched_format = type if text && text.length > 0
+    end
+    matched_format
+  end
+
+  def image_id
+    # Note: don't pull full path because will be pulled by IIIF
+    images = get_list(@xpaths["image_id"])
+    images[0] if images
+  end
+
+  def keywords
+    get_list(@xpaths["keywords"])
+  end
+
+  def language
+    get_text(@xpaths["language"])
+  end
+
+  def languages
+    get_list(@xpaths["languages"])
+  end
+
+  def medium
+    # Default behavior is the same as "format" method
+    format
+  end
+
+  def person
+    # TODO will need some examples of how this will work
+    # and put in the xpaths above, also for attributes, etc
+    # should contain name, id, and role
+    eles = @xml.xpath(@xpaths["person"])
+    people = eles.map do |p|
+      {
+        "id" => "",
+        "name" => CommonXml.normalize_space(p.text),
+        "role" => CommonXml.normalize_space(p["role"])
+      }
+    end
+    return people
+  end
+
+  def people
+    @json["person"].map { |p| CommonXml.normalize_space(p["name"]) }
+  end
+
+  def places
+    return get_list(@xpaths["places"])
+  end
+
+  def publisher
+    get_text(@xpaths["publisher"])
+  end
+
+  def recipient
+    eles = @xml.xpath(@xpaths["recipient"])
+    people = eles.map do |p|
+      {
+        "id" => "",
+        "name" => CommonXml.normalize_space(p.text),
+        "role" => "recipient"
+      }
+    end
+    return people
+  end
+
+  def rights
+    # Note: override by collection as needed
+    "All Rights Reserved"
+  end
+
+  def rights_holder
+    get_text(@xpaths["rights_holder"])
+  end
+
+  def rights_uri
+    # by default collections have no uri associated with them
+    # copy this method into collection specific tei_to_es.rb
+    # to return specific string or xpath as required
+  end
+
+  def source
+    get_text(@xpaths["source"])
+  end
+
+  def subjects
+    # TODO default behavior?
+  end
+
+  def subcategory
+    subcategory = get_text(@xpaths["subcategory"])
+    subcategory.length > 0 ? subcategory : "none"
+  end
+
+  def text
+    # handling separate fields in array
+    # means no worrying about handling spacing between words
+    text = []
+    body = get_text(@xpaths["text"], false)
+    text << body
+    # TODO: do we need to preserve tags like <i> in text? if so, turn get_text to true
+    # text << CommonXml.convert_tags_in_string(body)
+    text += text_additional
+    return CommonXml.normalize_space(text.join(" "))
+  end
+
+  def text_additional
+    # Note: Override this per collection if you need additional
+    # searchable fields or information for collections
+    # just make sure you return an array at the end!
+
+    text = []
+    text << title
+  end
+
+  def title
+    title = get_text(@xpaths["titles"]["main"])
+    if title.empty?
+      title = get_text(@xpaths["titles"]["alt"])
+    end
+    return title
+  end
+
+  def title_sort
+    t = title
+    CommonXml.normalize_name(t)
+  end
+
+  def topics
+    get_list(@xpaths["topic"])
+  end
+
+  def uri
+    # override per collection
+    # should point at the live website view of resource
+  end
+
+  def uri_data
+    base = @options["data_base"]
+    subpath = "data/#{@options["collection"]}/source/tei"
+    return "#{base}/#{subpath}/#{@id}.xml"
+  end
+
+  def uri_html
+    base = @options["data_base"]
+    subpath = "data/#{@options["collection"]}/output/#{@options["environment"]}/html"
+    return "#{base}/#{subpath}/#{@id}.html"
+  end
+
+  def works
+    # TODO figure out how this behavior should look
+  end
+end
diff --git a/lib/datura/to_es/ead_to_es_items/request.rb b/lib/datura/to_es/ead_to_es_items/request.rb
new file mode 100644
index 000000000..27f14d072
--- /dev/null
+++ b/lib/datura/to_es/ead_to_es_items/request.rb
@@ -0,0 +1,7 @@
+class EadToEsItems < XmlToEs
+
+  # please refer to generic xml to es request file, request.rb
+  # and override methods specific to TEI transformation here
+  # project specific overrides should go in the COLLECTION's overrides!
+
+end
diff --git a/lib/datura/to_es/ead_to_es_items/xpaths.rb b/lib/datura/to_es/ead_to_es_items/xpaths.rb
new file mode 100644
index 000000000..bab2fa935
--- /dev/null
+++ b/lib/datura/to_es/ead_to_es_items/xpaths.rb
@@ -0,0 +1,45 @@
+class EadToEsItems < XmlToEs
+  # These are the default xpaths that are used for collections
+  #  if you require a different xpath, please override the xpath in
+  #  the specific collection's TeiToEs file or create a new method
+  #  in that file which returns a different value
+  def xpaths_list
+      {
+        "abstract" => "/ead/archdesc/did/abstract",
+        # "category" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='category'][1]/term",
+        # "contributors" => [
+        #   "/TEI/teiHeader/revisionDesc/change/name",
+        #   "/TEI/teiHeader/fileDesc/titleStmt/editor"
+        # ],
+        "creators" => ["/ead/archdesc/did/origination/persname", "/ead/eadheader/filedesc/titlestmt/creator"],
+        "date" => "/ead/archdesc/dsc/c01/did/unitdate",
+        "description" => "/ead/archdesc/dsc/c01/scopecontent/p",
+        # a non normalized date taken directly from the source material ("Dec 9", "Winter 1889")
+        # "date_display" => "/TEI/teiHeader/fileDesc/sourceDesc/bibl/date",
+        "extent" => "/ead/archdesc/dsc/c01/did/physdesc/extent",
+        "format" => "/ead/archdesc/dsc/c01/did/physdesc/physfacet",
+        "image_url" => "/ead/archdesc/dsc/c01/dao/@href",
+        # "image_id" => "/TEI/text//pb/@facs",
+        # "keywords" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='keywords']/term",
+        # note: language is global attribute xml:lang
+        "identifier" => "/ead/archdesc/dsc/c01/did/unitid[@type='WWA']",
+        # "language" => "(//body/div1/@lang)[1]",
+        # "languages" => "//body/div1/@lang",
+        # "person" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='people']/term",
+        # "places" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='places']/term",
+        # "publisher" => "/TEI/teiHeader/fileDesc/sourceDesc/bibl[1]/publisher[1]",
+        # "recipient" => "/TEI/teiHeader/profileDesc/particDesc/person[@role='recipient']/persName",
+        "repository_id" => "/ead/archdes/dsc/c01/did/unitid[@type='repository']",
+        # "rights" => "/ead/archdesc/descgrp/accessrestrict/p",
+        # "rights_holder" => "/ead/archdesc/descgrp/accessrestrict/p",
+        # "source" => "/ead/archdesc/descgrp/prefercite/p",
+        # "subjects" => ["/ead/archdesc/controlaccess/[everything after head;persname, subject]"],
+        # "subcategory" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='subcategory'][1]/term",
+        # "text" => "//text",
+        "title" => "ead/archdesc/dsc/c01/did/unittitle",
+        # "topic" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='topic']/term",
+        "type" => "/ead/archdesc/dsc/c01/did/physdesc/genreform",
+        # "works" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='works']/term",
+      }.merge(override_xpaths)
+  end
+end

From fc6e4f0f7f096fd13cef06e366808529544e97b8 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Wed, 3 Nov 2021 14:29:30 -0500
Subject: [PATCH 032/128] add xsl file for ead (not functional yet)

---
 lib/xslt/ead_to_html/ead_to_html.xsl | 60 ++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 lib/xslt/ead_to_html/ead_to_html.xsl

diff --git a/lib/xslt/ead_to_html/ead_to_html.xsl b/lib/xslt/ead_to_html/ead_to_html.xsl
new file mode 100644
index 000000000..d0aa8f923
--- /dev/null
+++ b/lib/xslt/ead_to_html/ead_to_html.xsl
@@ -0,0 +1,60 @@
+<!-- Below is all copied from TEI and will need to change for EAD-->
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet 
+  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+  xmlns:tei="http://www.tei-c.org/ns/1.0"
+  xmlns:xs="http://www.w3.org/2001/XMLSchema"
+  xpath-default-namespace="http://www.tei-c.org/ns/1.0"
+  version="2.0"
+  exclude-result-prefixes="xsl tei xs">
+
+<!-- ==================================================================== -->
+<!--                             IMPORTS                                  -->
+<!-- ==================================================================== -->
+
+<xsl:import href="lib/formatting.xsl"/>
+<xsl:import href="lib/personography_encyclopedia.xsl"/>
+<xsl:import href="lib/cdrh.xsl"/>
+
+<!-- To override, copy this file into your collection's script directory
+    and change the above paths to:
+    "../../.xslt-datura/tei_to_html/lib/formatting.xsl"
+ -->
+
+<!-- For display in TEI framework, have changed all namespace declarations to http://www.tei-c.org/ns/1.0. If different (e.g. Whitman), will need to change -->
+<xsl:output method="xml" indent="yes" encoding="UTF-8" omit-xml-declaration="yes"/>
+
+
+<!-- ==================================================================== -->
+<!--                           PARAMETERS                                 -->
+<!-- ==================================================================== -->
+
+<xsl:param name="collection"/>
+<xsl:param name="data_base"/>
+<xsl:param name="environment">production</xsl:param>
+<xsl:param name="image_large"/>
+<xsl:param name="image_thumb"/>
+<xsl:param name="media_base"/>
+<xsl:param name="site_url"/>
+
+<!-- ==================================================================== -->
+<!--                            OVERRIDES                                 -->
+<!-- ==================================================================== -->
+
+<!-- Individual collections can override matched templates from the
+     imported stylesheets above by including new templates here -->
+<!-- Named templates can be overridden if included in matched templates
+     here.  You cannot call a named template from directly within the stylesheet tag
+     but you can redefine one here to be called by an imported template -->
+
+    <!-- The below will override the entire text matching template -->
+    <!-- <xsl:template match="text">
+      <xsl:call-template name="fake_template"/>
+    </xsl:template> -->
+
+    <!-- The below will override templates with the same name -->
+    <!-- <xsl:template name="fake_template">
+      This fake template would override fake_template if it was defined
+      in one of the imported files
+    </xsl:template> -->
+</xsl:stylesheet>

From ba17a76c9d3ded1afc94a63a6e7b8f83e67387dc Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Thu, 4 Nov 2021 10:42:27 -0500
Subject: [PATCH 033/128] remove gem doc that is messing things up

---
 datura-0.1.4.gem | Bin 91136 -> 0 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 datura-0.1.4.gem

diff --git a/datura-0.1.4.gem b/datura-0.1.4.gem
deleted file mode 100644
index d1216675f068ebe213245adbfc7813a7c50f5b6e..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 91136
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


From 3523b837a3865608cbad43d8f21746c9046666e8 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Thu, 4 Nov 2021 10:54:34 -0500
Subject: [PATCH 034/128] print full error message, not just something went
 wrong

---
 lib/datura/file_type.rb | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/lib/datura/file_type.rb b/lib/datura/file_type.rb
index 0d4d755d8..378aa734f 100644
--- a/lib/datura/file_type.rb
+++ b/lib/datura/file_type.rb
@@ -23,9 +23,9 @@ def initialize(location, options)
     @file_location = location
     @options = options
     add_xsl_params_options
-
     # set output directories
     output = File.join(@options["collection_dir"], "output", @options["environment"])
+    
     @out_es = File.join(output, "es")
     @out_html = File.join(output, "html")
     @out_iiif = File.join(output, "iiif")
@@ -127,10 +127,12 @@ def transform_es
       if results.length == 0
         raise "No possible xpaths found fo file #{self.filename}, check if XML is valid or customize 'subdoc_xpaths' method"
       end
+      
       subdoc_xpaths.each do |xpath, classname|
         subdocs = file_xml.xpath(xpath)
         subdocs.each do |subdoc|
           file_transformer = classname.new(subdoc, @options, file_xml, self.filename(false))
+          
           es_req << file_transformer.json
         end
       end
@@ -141,6 +143,7 @@ def transform_es
       return es_req
     rescue => e
       puts "something went wrong transforming #{self.filename}"
+      puts e
       raise e
     end
   end

From a6e2a51ef01d9e0ef189829ffbbc33a2badc43fd Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Thu, 4 Nov 2021 10:55:31 -0500
Subject: [PATCH 035/128] fix xpath

---
 lib/datura/file_types/file_ead.rb | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/lib/datura/file_types/file_ead.rb b/lib/datura/file_types/file_ead.rb
index 110b9d5c0..ebc1f9be3 100644
--- a/lib/datura/file_types/file_ead.rb
+++ b/lib/datura/file_types/file_ead.rb
@@ -11,7 +11,8 @@ class FileEad < FileType
 
   def initialize(file_location, options)
     super(file_location, options)
-    @script_html = File.join(options["collection_dir"], options["ead_html_xsl"]) # There needs to be an xsl file to transform into html
+    @script_html = File.join(options["collection_dir"], options["ead_html_xsl"])
+    # There needs to be an xsl file to transform into html
     # I don't think we need solr at this point)
     # @script_solr = File.join(options["collection_dir"], options["tei_solr_xsl"])
   end
@@ -19,7 +20,7 @@ def initialize(file_location, options)
   def subdoc_xpaths
     # match subdocs against classes
     return {
-      "/EAD" => EadToEs,
+      "/ead" => EadToEs,
       # "//dsc/c01" => EadToEsItems,
     }
   end

From 083952807d3679ef650d192b7515a73bd471b073 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Thu, 4 Nov 2021 11:10:23 -0500
Subject: [PATCH 036/128] add all require fields, including unfilled ones

---
 lib/datura/to_es/ead_to_es/fields.rb | 226 +++++++++++++--------------
 1 file changed, 111 insertions(+), 115 deletions(-)

diff --git a/lib/datura/to_es/ead_to_es/fields.rb b/lib/datura/to_es/ead_to_es/fields.rb
index 9c8f35e6c..39e4ca500 100644
--- a/lib/datura/to_es/ead_to_es/fields.rb
+++ b/lib/datura/to_es/ead_to_es/fields.rb
@@ -15,19 +15,19 @@ def id
   #   "https://cdrhapi.unl.edu/doc/#{@id}"
   # end
 
-  # def annotations_text
-  #   # TODO what should default behavior be?
-  # end
+  def annotations_text
+    # TODO what should default behavior be?
+  end
 
-  # def category
-  #   category = get_text(@xpaths["category"])
-  #   return category.length > 0 ? CommonXml.normalize_space(category) : "none"
-  # end
+  def category
+  end
 
   # note this does not sort the creators
   def creator
     creators = get_list(@xpaths["creators"])
-    return creators.map { |creator| { "name" => CommonXml.normalize_space(creator) } }
+    if creators
+      return creators.map { |creator| { "name" => CommonXml.normalize_space(creator) } }
+    end
   end
 
   # returns ; delineated string of alphabetized creators
@@ -43,20 +43,20 @@ def collection_desc
     @options["collection_desc"] || @options["collection"]
   end
 
-  # def contributor
-  #   contribs = []
-  #   @xpaths["contributors"].each do |xpath|
-  #     eles = @xml.xpath(xpath)
-  #     eles.each do |ele|
-  #       contribs << {
-  #         "id" => ele["id"],
-  #         "name" => CommonXml.normalize_space(ele.text),
-  #         "role" => CommonXml.normalize_space(ele["role"])
-  #       }
-  #     end
-  #   end
-  #   contribs.uniq
-  # end
+  def contributor
+    # contribs = []
+    # @xpaths["contributors"].each do |xpath|
+    #   eles = @xml.xpath(xpath)
+    #   eles.each do |ele|
+    #     contribs << {
+    #       "id" => ele["id"],
+    #       "name" => CommonXml.normalize_space(ele.text),
+    #       "role" => CommonXml.normalize_space(ele["role"])
+    #     }
+    #   end
+    # end
+    # contribs.uniq
+  end
 
   def data_type
     "ead"
@@ -67,9 +67,9 @@ def date(before=true)
     return CommonXml.date_standardize(datestr, before)
   end
 
-  # def date_display
-  #   get_text(@xpaths["date_display"])
-  # end
+  def date_display
+    get_text(@xpaths["date_display"])
+  end
 
   def date_not_after
     date(false)
@@ -88,85 +88,80 @@ def extent
   end
 
   def format
-    matched_format = nil
-    # iterate through all the formats until the first one matches
-    @xpaths["formats"].each do |type, xpath|
-      text = get_text(xpath)
-      matched_format = type if text && text.length > 0
-    end
-    matched_format
+    get_list(@xpaths["format"])
   end
 
-  # def image_id
-  #   # Note: don't pull full path because will be pulled by IIIF
-  #   images = get_list(@xpaths["image_id"])
-  #   images[0] if images
-  # end
+  def image_id
+    # Note: don't pull full path because will be pulled by IIIF
+    # How to deal with this?
+    images = get_list(@xpaths["image_id"])
+    images[0] if images
+  end
 
-  # def keywords
-  #   get_list(@xpaths["keywords"])
-  # end
+  def keywords
+    get_list(@xpaths["keywords"])
+  end
 
-  # def language
-  #   get_text(@xpaths["language"])
-  # end
+  def language
+    get_text(@xpaths["language"])
+  end
 
-  # def languages
-  #   get_list(@xpaths["languages"])
-  # end
+  def languages
+    get_list(@xpaths["languages"])
+  end
 
   def medium
     # Default behavior is the same as "format" method
     format
   end
 
-  # def person
-  #   # TODO will need some examples of how this will work
-  #   # and put in the xpaths above, also for attributes, etc
-  #   # should contain name, id, and role
-  #   eles = @xml.xpath(@xpaths["person"])
-  #   people = eles.map do |p|
-  #     {
-  #       "id" => "",
-  #       "name" => CommonXml.normalize_space(p.text),
-  #       "role" => CommonXml.normalize_space(p["role"])
-  #     }
-  #   end
-  #   return people
-  # end
+  def person
+    # TODO will need some examples of how this will work
+    # and put in the xpaths above, also for attributes, etc
+    # should contain name, id, and role
+    # eles = @xml.xpath(@xpaths["person"])
+    # people = eles.map do |p|
+    #   {
+    #     "id" => "",
+    #     "name" => CommonXml.normalize_space(p.text),
+    #     "role" => CommonXml.normalize_space(p["role"])
+    #   }
+    # end
+    # return people
+  end
 
-  # def people
-  #   @json["person"].map { |p| CommonXml.normalize_space(p["name"]) }
-  # end
+  def people
+    # @json["person"].map { |p| CommonXml.normalize_space(p["name"]) }
+  end
 
-  # def places
-  #   return get_list(@xpaths["places"])
-  # end
+  def places
+    return get_list(@xpaths["places"])
+  end
 
-  # def publisher
-  #   get_text(@xpaths["publisher"])
-  # end
+  def publisher
+    get_text(@xpaths["publisher"])
+  end
 
-  # def recipient
-  #   eles = @xml.xpath(@xpaths["recipient"])
-  #   people = eles.map do |p|
-  #     {
-  #       "id" => "",
-  #       "name" => CommonXml.normalize_space(p.text),
-  #       "role" => "recipient"
-  #     }
-  #   end
-  #   return people
-  # end
+  def recipient
+    # eles = @xml.xpath(@xpaths["recipient"])
+    # people = eles.map do |p|
+    #   {
+    #     "id" => "",
+    #     "name" => CommonXml.normalize_space(p.text),
+    #     "role" => "recipient"
+    #   }
+    # end
+    # return people
+  end
 
-  # def rights
-  #   # Note: override by collection as needed
-  #   get_text(@xpaths["rights"])
-  # end
+  def rights
+    # Note: override by collection as needed
+    get_text(@xpaths["rights"])
+  end
 
-  # def rights_holder
-  #   get_text(@xpaths["rights_holder"])
-  # end
+  def rights_holder
+    get_text(@xpaths["rights_holder"])
+  end
 
   def rights_uri
     # by default collections have no uri associated with them
@@ -174,27 +169,28 @@ def rights_uri
     # to return specific string or xpath as required
   end
 
-  # def source
-  #   get_text(@xpaths["source"])
-  # end
+  def source
+    get_text(@xpaths["source"])
+  end
 
-  # def subjects
-  #   get_list(@xpaths["subjects"])
-  # end
+  def subjects
+    get_list(@xpaths["subjects"])
+  end
 
-  # def subcategory
-  #   subcategory = get_text(@xpaths["subcategory"])
-  #   subcategory.length > 0 ? subcategory : "none"
-  # end
+  def subcategory
+    # subcategory = get_text(@xpaths["subcategory"])
+    # subcategory.length > 0 ? subcategory : "none"
+  end
 
   def text
     # handling separate fields in array
     # means no worrying about handling spacing between words
     text = []
-    @xpaths.keys.each do [xpath] 
+    @xpaths.keys.each do |xpath| 
       body = get_text(@xpaths[xpath])
       text << body
     end
+    text
     # TODO: do we need to preserve tags like <i> in text? if so, turn get_text to true
     # text << CommonXml.convert_tags_in_string(body)
     # text += text_additional
@@ -223,26 +219,26 @@ def type
     get_text(@xpaths["type"])
   end
 
-  # def topics
-  #   get_list(@xpaths["topic"])
-  # end
+  def topics
+    get_list(@xpaths["topic"])
+  end
 
-  # def uri
-  #   # override per collection
-  #   # should point at the live website view of resource
-  # end
+  def uri
+    # override per collection
+    # should point at the live website view of resource
+  end
 
-  # def uri_data
-  #   base = @options["data_base"]
-  #   subpath = "data/#{@options["collection"]}/source/tei"
-  #   return "#{base}/#{subpath}/#{@id}.xml"
-  # end
+  def uri_data
+    base = @options["data_base"]
+    subpath = "data/#{@options["collection"]}/source/tei"
+    return "#{base}/#{subpath}/#{@id}.xml"
+  end
 
-  # def uri_html
-  #   base = @options["data_base"]
-  #   subpath = "data/#{@options["collection"]}/output/#{@options["environment"]}/html"
-  #   return "#{base}/#{subpath}/#{@id}.html"
-  # end
+  def uri_html
+    base = @options["data_base"]
+    subpath = "data/#{@options["collection"]}/output/#{@options["environment"]}/html"
+    return "#{base}/#{subpath}/#{@id}.html"
+  end
 
   def works
     # TODO need to create a list of items, maybe an array of ids

From 3b1060725cf8456468e7dadfbb5fd833ead84023 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Thu, 4 Nov 2021 11:19:56 -0500
Subject: [PATCH 037/128] fix xpaths hash

---
 lib/datura/to_es/ead_to_es/xpaths.rb | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/lib/datura/to_es/ead_to_es/xpaths.rb b/lib/datura/to_es/ead_to_es/xpaths.rb
index 10a1147b5..a1bf82885 100644
--- a/lib/datura/to_es/ead_to_es/xpaths.rb
+++ b/lib/datura/to_es/ead_to_es/xpaths.rb
@@ -11,7 +11,7 @@ def xpaths_list
         #   "/TEI/teiHeader/revisionDesc/change/name",
         #   "/TEI/teiHeader/fileDesc/titleStmt/editor"
         # ],
-        "creators" => ["/ead/archdesc/did/origination/persname", "/ead/eadheader/filedesc/titlestmt/creator"]
+        "creators" => ["/ead/archdesc/did/origination/persname", "/ead/eadheader/filedesc/titlestmt/creator"],
         "date" => "/ead/eadheader/filedesc/publicationstmt/date",
         "description" => "/ead/archdesc/scopecontent/p",
         # a non normalized date taken directly from the source material ("Dec 9", "Winter 1889")
@@ -31,8 +31,10 @@ def xpaths_list
         "rights" => "/ead/archdesc/descgrp/accessrestrict/p",
         "rights_holder" => "ead/archdesc/did/repository/corpname",
         "source" => "/ead/archdesc/descgrp/prefercite/p",
-        "subjects" => "/ead/archdesc/controlaccess/*[not(name()="head")]"],
+        "subjects" => "/ead/archdesc/controlaccess/*[not(name()='head')]",
         # "subcategory" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='subcategory'][1]/term",
         "titles" => "ead/archdesc/did/unittitle",
         "text" => "/ead/eadheader/filedesc/titlestmt/*",
-      }
+      }.merge(override_xpaths)
+    end
+  end

From 90739d52b6be1d2b9b6405ea63804f58b469fd2d Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Thu, 4 Nov 2021 11:27:45 -0500
Subject: [PATCH 038/128] make EadToEsItems a separate class

---
 lib/datura/to_es/ead_to_es_items.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/datura/to_es/ead_to_es_items.rb b/lib/datura/to_es/ead_to_es_items.rb
index ff6ec3e9c..560a4a76c 100644
--- a/lib/datura/to_es/ead_to_es_items.rb
+++ b/lib/datura/to_es/ead_to_es_items.rb
@@ -27,7 +27,7 @@
 #   collections of fields being sent to elasticsearch
 #   you can override individual chunks of fields in your collection
 
-class EadToEs < XmlToEs
+class EadToEsItems < XmlToEs
   # Override XmlToEs methods that need to be customized for EAD here
   # rather than in one of the files in ead_to_es/
   def get_id

From 10543b7852ec878d450dfaedd915b324834a03a0 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Thu, 4 Nov 2021 13:22:03 -0500
Subject: [PATCH 039/128] add abstract field and fix bad xpaths

---
 lib/datura/to_es/ead_to_es/fields.rb | 4 ++++
 lib/datura/to_es/ead_to_es/xpaths.rb | 8 ++++----
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/lib/datura/to_es/ead_to_es/fields.rb b/lib/datura/to_es/ead_to_es/fields.rb
index 39e4ca500..44436709a 100644
--- a/lib/datura/to_es/ead_to_es/fields.rb
+++ b/lib/datura/to_es/ead_to_es/fields.rb
@@ -15,6 +15,10 @@ def id
   #   "https://cdrhapi.unl.edu/doc/#{@id}"
   # end
 
+  def abstract
+    get_text(@xpaths["abstract"])
+  end
+
   def annotations_text
     # TODO what should default behavior be?
   end
diff --git a/lib/datura/to_es/ead_to_es/xpaths.rb b/lib/datura/to_es/ead_to_es/xpaths.rb
index a1bf82885..b947f6bb9 100644
--- a/lib/datura/to_es/ead_to_es/xpaths.rb
+++ b/lib/datura/to_es/ead_to_es/xpaths.rb
@@ -5,7 +5,7 @@ class EadToEs < XmlToEs
   #  in that file which returns a different value
   def xpaths_list
       {
-        # "abstract" => "/ead/archdesc/did/abstract"
+        "abstract" => "/ead/archdesc/did/abstract",
         # "category" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='category'][1]/term",
         # "contributors" => [
         #   "/TEI/teiHeader/revisionDesc/change/name",
@@ -27,13 +27,13 @@ def xpaths_list
         # "places" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='places']/term",
         "publisher" => "/ead/eadheader/filedesc/publicationstmt/publisher",
         # "recipient" => "/TEI/teiHeader/profileDesc/particDesc/person[@role='recipient']/persName",
-        "repository_contact" => "/ead/archdesc/did/repository/addresses",
+        "repository_contact" => "/ead/archdesc/did/repository/address/*",
         "rights" => "/ead/archdesc/descgrp/accessrestrict/p",
-        "rights_holder" => "ead/archdesc/did/repository/corpname",
+        "rights_holder" => "/ead/archdesc/did/repository/corpname",
         "source" => "/ead/archdesc/descgrp/prefercite/p",
         "subjects" => "/ead/archdesc/controlaccess/*[not(name()='head')]",
         # "subcategory" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='subcategory'][1]/term",
-        "titles" => "ead/archdesc/did/unittitle",
+        "title" => "/ead/archdesc/did/unittitle",
         "text" => "/ead/eadheader/filedesc/titlestmt/*",
       }.merge(override_xpaths)
     end

From 0d3c07ad0216f20dfac5a0ac2d3ce5960bd5ef9f Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Mon, 8 Nov 2021 12:55:46 -0600
Subject: [PATCH 040/128] add a backtrace to error handling

---
 lib/datura/file_type.rb | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/lib/datura/file_type.rb b/lib/datura/file_type.rb
index 378aa734f..12a66b25f 100644
--- a/lib/datura/file_type.rb
+++ b/lib/datura/file_type.rb
@@ -69,6 +69,7 @@ def post_es(es)
           begin
             RestClient.put("#{es.index_url}/_doc/#{id}", doc.to_json, {:content_type => :json } )
           rescue => e
+            # byebug
             error = "Error transforming or posting to ES for #{self.filename(false)}: #{e.response}"
           end
         else
@@ -132,7 +133,6 @@ def transform_es
         subdocs = file_xml.xpath(xpath)
         subdocs.each do |subdoc|
           file_transformer = classname.new(subdoc, @options, file_xml, self.filename(false))
-          
           es_req << file_transformer.json
         end
       end
@@ -144,6 +144,7 @@ def transform_es
     rescue => e
       puts "something went wrong transforming #{self.filename}"
       puts e
+      puts e.backtrace
       raise e
     end
   end

From 49ba94b0434552d62042f800e1e0b6b233779528 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Mon, 8 Nov 2021 12:59:42 -0600
Subject: [PATCH 041/128] grab 'items' at any nesting of the EAD

---
 lib/datura/file_types/file_ead.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/datura/file_types/file_ead.rb b/lib/datura/file_types/file_ead.rb
index ebc1f9be3..a809ab9b4 100644
--- a/lib/datura/file_types/file_ead.rb
+++ b/lib/datura/file_types/file_ead.rb
@@ -21,7 +21,7 @@ def subdoc_xpaths
     # match subdocs against classes
     return {
       "/ead" => EadToEs,
-      # "//dsc/c01" => EadToEsItems,
+      "//*[@level='item']" => EadToEsItems,
     }
   end
 

From 860466336966a485e9851de1cde401753ce3eba5 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Mon, 8 Nov 2021 13:09:45 -0600
Subject: [PATCH 042/128] add xpaths and fields, and make sure eadtoesitems
 inherits from eadtoes

---
 lib/datura/to_es/ead_to_es_items.rb         |   7 +-
 lib/datura/to_es/ead_to_es_items/fields.rb  | 128 ++++++++++----------
 lib/datura/to_es/ead_to_es_items/request.rb |   2 +-
 lib/datura/to_es/ead_to_es_items/xpaths.rb  |  26 ++--
 4 files changed, 82 insertions(+), 81 deletions(-)

diff --git a/lib/datura/to_es/ead_to_es_items.rb b/lib/datura/to_es/ead_to_es_items.rb
index 560a4a76c..c4778cf3d 100644
--- a/lib/datura/to_es/ead_to_es_items.rb
+++ b/lib/datura/to_es/ead_to_es_items.rb
@@ -1,4 +1,4 @@
-require_relative "xml_to_es.rb"
+require_relative "ead_to_es.rb"
 require_relative "ead_to_es_items/fields.rb"
 require_relative "ead_to_es_items/request.rb"
 require_relative "ead_to_es_items/xpaths.rb"
@@ -27,10 +27,7 @@
 #   collections of fields being sent to elasticsearch
 #   you can override individual chunks of fields in your collection
 
-class EadToEsItems < XmlToEs
+class EadToEsItems < EadToEs
   # Override XmlToEs methods that need to be customized for EAD here
   # rather than in one of the files in ead_to_es/
-  def get_id
-    @id
-  end
 end
diff --git a/lib/datura/to_es/ead_to_es_items/fields.rb b/lib/datura/to_es/ead_to_es_items/fields.rb
index b5ca56d79..95869cb8f 100644
--- a/lib/datura/to_es/ead_to_es_items/fields.rb
+++ b/lib/datura/to_es/ead_to_es_items/fields.rb
@@ -1,4 +1,4 @@
-class EadToEsItems < XmlToEs
+class EadToEsItems < EadToEs
   # Note to add custom fields, use "assemble_collection_specific" from request.rb
   # and be sure to either use the _d, _i, _k, or _t to use the correct field type
 
@@ -15,14 +15,14 @@ def id
   #   "https://cdrhapi.unl.edu/doc/#{@id}"
   # end
 
-  # def annotations_text
-  #   # TODO what should default behavior be?
-  # end
+  def annotations_text
+    # TODO what should default behavior be?
+  end
 
-  # def category
-  #   category = get_text(@xpaths["category"])
-  #   return category.length > 0 ? CommonXml.normalize_space(category) : "none"
-  # end
+  def category
+    # category = get_text(@xpaths["category"])
+    # return category.length > 0 ? CommonXml.normalize_space(category) : "none"
+  end
 
   # note this does not sort the creators
   def creator
@@ -36,30 +36,30 @@ def creator_sort
   end
 
   def collection
-    "manuscripts"
+    # "manuscripts"
   end
 
   def collection_desc
-    @options["collection_desc"] || @options["collection"]
-  end
-
-  # def contributor
-  #   contribs = []
-  #   @xpaths["contributors"].each do |xpath|
-  #     eles = @xml.xpath(xpath)
-  #     eles.each do |ele|
-  #       contribs << {
-  #         "id" => ele["id"],
-  #         "name" => CommonXml.normalize_space(ele.text),
-  #         "role" => CommonXml.normalize_space(ele["role"])
-  #       }
-  #     end
-  #   end
-  #   contribs.uniq
-  # end
+    # @options["collection_desc"] || @options["collection"]
+  end
+
+  def contributor
+    # contribs = []
+    # @xpaths["contributors"].each do |xpath|
+    #   eles = @xml.xpath(xpath)
+    #   eles.each do |ele|
+    #     contribs << {
+    #       "id" => ele["id"],
+    #       "name" => CommonXml.normalize_space(ele.text),
+    #       "role" => CommonXml.normalize_space(ele["role"])
+    #     }
+    #   end
+    # end
+    # contribs.uniq
+  end
 
   def data_type
-    "ead"
+    "ead_item"
   end
 
   def date(before=true)
@@ -80,23 +80,31 @@ def date_not_before
   end
 
   def description
-    # Note: override per collection as needed
+    get_text(@xpaths["description"])
   end
 
   def format
-    matched_format = nil
-    # iterate through all the formats until the first one matches
-    @xpaths["formats"].each do |type, xpath|
-      text = get_text(xpath)
-      matched_format = type if text && text.length > 0
+    # matched_format = nil
+    # # iterate through all the formats until the first one matches
+    # @xpaths["formats"].each do |type, xpath|
+    #   text = get_text(xpath)
+    #   matched_format = type if text && text.length > 0
+    # end
+    # matched_format
+  end
+  def get_id
+    # doc = id
+    doc = get_text(@xpaths["identifier"])
+    if doc == ""
+      byebug
     end
-    matched_format
+    return "#{@filename}_#{doc}"
   end
 
   def image_id
-    # Note: don't pull full path because will be pulled by IIIF
-    images = get_list(@xpaths["image_id"])
-    images[0] if images
+    # # Note: don't pull full path because will be pulled by IIIF
+    # images = get_list(@xpaths["image_id"])
+    # images[0] if images
   end
 
   def keywords
@@ -120,19 +128,19 @@ def person
     # TODO will need some examples of how this will work
     # and put in the xpaths above, also for attributes, etc
     # should contain name, id, and role
-    eles = @xml.xpath(@xpaths["person"])
-    people = eles.map do |p|
-      {
-        "id" => "",
-        "name" => CommonXml.normalize_space(p.text),
-        "role" => CommonXml.normalize_space(p["role"])
-      }
-    end
-    return people
+    # eles = @xml.xpath(@xpaths["person"])
+    # people = eles.map do |p|
+    #   {
+    #     "id" => "",
+    #     "name" => CommonXml.normalize_space(p.text),
+    #     "role" => CommonXml.normalize_space(p["role"])
+    #   }
+    # end
+    # return people
   end
 
   def people
-    @json["person"].map { |p| CommonXml.normalize_space(p["name"]) }
+    # @json["person"].map { |p| CommonXml.normalize_space(p["name"]) }
   end
 
   def places
@@ -144,20 +152,20 @@ def publisher
   end
 
   def recipient
-    eles = @xml.xpath(@xpaths["recipient"])
-    people = eles.map do |p|
-      {
-        "id" => "",
-        "name" => CommonXml.normalize_space(p.text),
-        "role" => "recipient"
-      }
-    end
-    return people
+    # eles = @xml.xpath(@xpaths["recipient"])
+    # people = eles.map do |p|
+    #   {
+    #     "id" => "",
+    #     "name" => CommonXml.normalize_space(p.text),
+    #     "role" => "recipient"
+    #   }
+    # end
+    # return people
   end
 
   def rights
     # Note: override by collection as needed
-    "All Rights Reserved"
+    get_text(@xpaths["rights"])
   end
 
   def rights_holder
@@ -205,11 +213,7 @@ def text_additional
   end
 
   def title
-    title = get_text(@xpaths["titles"]["main"])
-    if title.empty?
-      title = get_text(@xpaths["titles"]["alt"])
-    end
-    return title
+    title = get_text(@xpaths["titles"])
   end
 
   def title_sort
diff --git a/lib/datura/to_es/ead_to_es_items/request.rb b/lib/datura/to_es/ead_to_es_items/request.rb
index 27f14d072..45e5f28c5 100644
--- a/lib/datura/to_es/ead_to_es_items/request.rb
+++ b/lib/datura/to_es/ead_to_es_items/request.rb
@@ -1,4 +1,4 @@
-class EadToEsItems < XmlToEs
+class EadToEsItems < EadToEs
 
   # please refer to generic xml to es request file, request.rb
   # and override methods specific to TEI transformation here
diff --git a/lib/datura/to_es/ead_to_es_items/xpaths.rb b/lib/datura/to_es/ead_to_es_items/xpaths.rb
index bab2fa935..cba8d7bf9 100644
--- a/lib/datura/to_es/ead_to_es_items/xpaths.rb
+++ b/lib/datura/to_es/ead_to_es_items/xpaths.rb
@@ -1,44 +1,44 @@
-class EadToEsItems < XmlToEs
+class EadToEsItems < EadToEs
   # These are the default xpaths that are used for collections
   #  if you require a different xpath, please override the xpath in
   #  the specific collection's TeiToEs file or create a new method
   #  in that file which returns a different value
   def xpaths_list
       {
-        "abstract" => "/ead/archdesc/did/abstract",
+        "abstract" => "did/abstract",
         # "category" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='category'][1]/term",
         # "contributors" => [
         #   "/TEI/teiHeader/revisionDesc/change/name",
         #   "/TEI/teiHeader/fileDesc/titleStmt/editor"
-        # ],
-        "creators" => ["/ead/archdesc/did/origination/persname", "/ead/eadheader/filedesc/titlestmt/creator"],
-        "date" => "/ead/archdesc/dsc/c01/did/unitdate",
-        "description" => "/ead/archdesc/dsc/c01/scopecontent/p",
+        # # ],
+        # "creators" => ["/ead/archdesc/did/origination/persname", "/ead/eadheader/filedesc/titlestmt/creator"],
+        "date" => "did/unitdate",
+        "description" => "scopecontent/p",
         # a non normalized date taken directly from the source material ("Dec 9", "Winter 1889")
         # "date_display" => "/TEI/teiHeader/fileDesc/sourceDesc/bibl/date",
-        "extent" => "/ead/archdesc/dsc/c01/did/physdesc/extent",
-        "format" => "/ead/archdesc/dsc/c01/did/physdesc/physfacet",
-        "image_url" => "/ead/archdesc/dsc/c01/dao/@href",
+        "extent" => "did/physdesc/extent",
+        "format" => "did/physdesc/physfacet",
+        "image_url" => "dao/@href",
         # "image_id" => "/TEI/text//pb/@facs",
         # "keywords" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='keywords']/term",
         # note: language is global attribute xml:lang
-        "identifier" => "/ead/archdesc/dsc/c01/did/unitid[@type='WWA']",
+        "identifier" => "did/unitid[@type='WWA']",
         # "language" => "(//body/div1/@lang)[1]",
         # "languages" => "//body/div1/@lang",
         # "person" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='people']/term",
         # "places" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='places']/term",
         # "publisher" => "/TEI/teiHeader/fileDesc/sourceDesc/bibl[1]/publisher[1]",
         # "recipient" => "/TEI/teiHeader/profileDesc/particDesc/person[@role='recipient']/persName",
-        "repository_id" => "/ead/archdes/dsc/c01/did/unitid[@type='repository']",
+        "repository_id" => "did/unitid[@type='repository']",
         # "rights" => "/ead/archdesc/descgrp/accessrestrict/p",
         # "rights_holder" => "/ead/archdesc/descgrp/accessrestrict/p",
         # "source" => "/ead/archdesc/descgrp/prefercite/p",
         # "subjects" => ["/ead/archdesc/controlaccess/[everything after head;persname, subject]"],
         # "subcategory" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='subcategory'][1]/term",
         # "text" => "//text",
-        "title" => "ead/archdesc/dsc/c01/did/unittitle",
+        "title" => "did/unittitle",
         # "topic" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='topic']/term",
-        "type" => "/ead/archdesc/dsc/c01/did/physdesc/genreform",
+        "type" => "did/physdesc/genreform",
         # "works" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='works']/term",
       }.merge(override_xpaths)
   end

From dbb56591d68654072b53e2311c66f3f4c6d0aa55 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Mon, 8 Nov 2021 13:21:23 -0600
Subject: [PATCH 043/128] change order of get id to fix bug

---
 lib/datura/to_es/xml_to_es.rb | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/lib/datura/to_es/xml_to_es.rb b/lib/datura/to_es/xml_to_es.rb
index 3cbbb1e46..8cf50029a 100644
--- a/lib/datura/to_es/xml_to_es.rb
+++ b/lib/datura/to_es/xml_to_es.rb
@@ -34,9 +34,8 @@ def initialize(xml, options={}, parent_xml=nil, filename=nil)
     @options = options
     @parent_xml = parent_xml
     @filename = filename
-    @id = get_id
     @xpaths = xpaths_list
-
+    @id = get_id
     create_json
   end
 

From f3628b68e95c26c35fa63a4a9d0fce3db0ef7528 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Mon, 8 Nov 2021 14:20:01 -0600
Subject: [PATCH 044/128] add documentation for adding new format

---
 docs/4_developers/new_formats.md | 94 ++++++++++++++++++++++++++++++++
 docs/README.md                   |  1 +
 2 files changed, 95 insertions(+)
 create mode 100644 docs/4_developers/new_formats.md

diff --git a/docs/4_developers/new_formats.md b/docs/4_developers/new_formats.md
new file mode 100644
index 000000000..a731bb9a7
--- /dev/null
+++ b/docs/4_developers/new_formats.md
@@ -0,0 +1,94 @@
+# Adding new formats to datura
+
+## Configuring datura
+
+In `lib/datura/data_manager.rb`, `self.format_to_class` contains a hash with the format as key and a file with format-specific methods as value. Add your desired format to this hash, with the corresponding file FileFornat.
+```
+ def self.format_to_class
+    {
+      "csv" => FileCsv,
+      "ead" => FileEad,
+      "html" => FileHtml,
+      "tei" => FileTei,
+      "vra" => FileVra,
+    }
+end
+```
+Modify `lib/datura/parser_options/post.rb` to accept parameters for the new format:
+```
+options["format"] = nil
+      opts.on( '-f', '--format [input]', 'Restrict to one format (csv, ead, html, tei, vra, webs)') do |input|
+        if %w[csv ead html tei vra webs].include?(input)
+          options["format"] = input
+        else
+          puts "Format #{input} is not recognized.".red
+          puts "Allowed formats are csv, ead, html, tei, vra, and webs (web-scraped html)"
+          exit
+        end
+      end
+```
+In the `config/public.yml` file you need to add a link to the xsl scripts for the specific format (you do not necessarily need to create a working script until you need to transform files), and also create a file and add it to the scripts folder:
+```
+  html_html_xsl: scripts/.xslt-datura/html_to_html/html_to_html.xsl
+  tei_html_xsl: scripts/.xslt-datura/tei_to_html/tei_to_html.xsl
+  vra_html_xsl: scripts/.xslt-datura/vra_to_html/vra_to_html.xsl
+  ead_html_xsl: scripts/.xslt-datura/ead_to_html/ead_to_html.xsl
+```
+
+## Datura overrides and new files
+You will need to create a `file_format.rb` (i.e. `file_ead.rb`) file in `lib/datura/file_types`. Copy from a similar file type (file_tei.rb is a good model for XML=based formats) and make any necessary changes for the file format. In particular the `subdoc_xpaths` should be modified to get the correct XPath for the files you want to transform:
+```
+def subdoc_xpaths
+    # match subdocs against classes
+    return {
+      "/ead" => EadToEs,
+    }
+  end
+```
+
+In the `/lib/datura/to_es` folder you also need to make a format_to_es.rb file, i.e. `ead_to_es.rb` and also a folder with fields.rb, request.rb, and xpaths.rb overrides
+Be sure to require all the necessary files at the top (and create them in the proper folder).
+```
+require_relative "xml_to_es.rb"
+require_relative "ead_to_es/fields.rb"
+require_relative "ead_to_es/request.rb"
+require_relative "ead_to_es/xpaths.rb"
+
+
+
+class EadToEs < XmlToEs
+end
+```
+The new files you have added must to be required in `lib/datura/requirer.rb`. Add the following to make sure they get picked up:
+```
+require_relative "to_es/ead_to_es.rb"
+```
+All code in these files should be within the same class, inheriting from XmlToEs.
+```
+class EadToEs < XmlToEs
+end
+```
+
+## Xpaths
+Add all the xpaths for your desired fields in xpaths.rb, in the hash inside the xpaths.rb file. it may be helpful to use an existing template like `tei_to_es/xpaths.rb`. There is no need to add all of them, you can comment out the fields you do not need.
+
+## Overrides with specific fields
+All fields must be defined within fields.rb. Even if you do not intend to index them, Datura requires that you at least have an empty method defining each field. (An empty field will be nil and not be displayed in Orchid).
+```
+def category
+end
+```
+Make appropriate changes to your fields as desired.
+
+## Dealing with subsections of XML files
+If you want to index subsections, the best way to do this is to define an xpaths selector for the desired sections in the `subdoc_xpaths` method as described above.
+```
+def subdoc_xpaths
+    # match subdocs against classes
+    return {
+      "/ead" => EadToEs,
+      "//*[@level='item']" => EadToEsItems,
+    }
+  end
+```
+Then add all the necessary overrides in the `to_es` folder like above. Depending on what you need to override, you may combine them into one file, or  have separate files. In any case, they should inherit from the main file, i.e. `class TeiToEsPersonography < TeiToEs`. 
diff --git a/docs/README.md b/docs/README.md
index 7e8487915..75618aa9d 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -39,6 +39,7 @@ The files are parsed and formatted into documents appropriate for Solr, IIIF, El
   - [Ruby / Gems](4_developers/ruby_gems.md)
   - Class organization
   - [Tests](4_developers/test.md)
+  - [Add new formats to Datura](4_developers/new_formats.md)
 - More
   - [Troubleshooting](troubleshooting.md)
   - [XSLT to Ruby reference](xslt_to_ruby_reference.md)

From 6cbe57744125e5cf2aa9da67be6210fef648eb6f Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Tue, 9 Nov 2021 11:02:39 -0600
Subject: [PATCH 045/128] adjust and add fields for items

---
 lib/datura/to_es/ead_to_es_items/fields.rb | 41 +++++++++++++---------
 1 file changed, 24 insertions(+), 17 deletions(-)

diff --git a/lib/datura/to_es/ead_to_es_items/fields.rb b/lib/datura/to_es/ead_to_es_items/fields.rb
index 95869cb8f..60a266445 100644
--- a/lib/datura/to_es/ead_to_es_items/fields.rb
+++ b/lib/datura/to_es/ead_to_es_items/fields.rb
@@ -20,15 +20,13 @@ def annotations_text
   end
 
   def category
-    # category = get_text(@xpaths["category"])
-    # return category.length > 0 ? CommonXml.normalize_space(category) : "none"
   end
 
   # note this does not sort the creators
-  def creator
-    creators = get_list(@xpaths["creators"])
-    return creators.map { |creator| { "name" => CommonXml.normalize_space(creator) } }
-  end
+  # def creator
+  #   creators = get_list(@xpaths["creators"])
+  #   return creators.map { |creator| { "name" => CommonXml.normalize_space(creator) } }
+  # end
 
   # returns ; delineated string of alphabetized creators
   def creator_sort
@@ -36,7 +34,7 @@ def creator_sort
   end
 
   def collection
-    # "manuscripts"
+    "whitman-finding_aid_manuscripts"
   end
 
   def collection_desc
@@ -68,7 +66,12 @@ def date(before=true)
   end
 
   def date_display
-    get_text(@xpaths["date_display"])
+    if get_text(@xpaths["date_display"]) == ""
+      return get_text(@xpaths["date"])
+    else
+      return get_text(@xpaths["date_display"])
+    end
+
   end
 
   def date_not_after
@@ -83,20 +86,20 @@ def description
     get_text(@xpaths["description"])
   end
 
+  def extent
+    get_text(@xpaths["extent"])
+  end
+
   def format
-    # matched_format = nil
-    # # iterate through all the formats until the first one matches
-    # @xpaths["formats"].each do |type, xpath|
-    #   text = get_text(xpath)
-    #   matched_format = type if text && text.length > 0
-    # end
-    # matched_format
+    get_text(@xpaths["format"])
   end
+
   def get_id
     # doc = id
     doc = get_text(@xpaths["identifier"])
     if doc == ""
-      byebug
+      title = get_text(@xpaths["file"])
+      return "#{@filename}_#{title}"
     end
     return "#{@filename}_#{doc}"
   end
@@ -213,7 +216,7 @@ def text_additional
   end
 
   def title
-    title = get_text(@xpaths["titles"])
+    title = get_text(@xpaths["title"])
   end
 
   def title_sort
@@ -225,6 +228,10 @@ def topics
     get_list(@xpaths["topic"])
   end
 
+  def type
+    get_text(@xpaths["type"])
+  end
+
   def uri
     # override per collection
     # should point at the live website view of resource

From 352efd1a804e86f3eb3ea4048ef4f7231cee392e Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Tue, 9 Nov 2021 11:10:31 -0600
Subject: [PATCH 046/128] add items to repository xpaths

---
 lib/datura/to_es/ead_to_es/xpaths.rb | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/datura/to_es/ead_to_es/xpaths.rb b/lib/datura/to_es/ead_to_es/xpaths.rb
index b947f6bb9..ddcc4d64f 100644
--- a/lib/datura/to_es/ead_to_es/xpaths.rb
+++ b/lib/datura/to_es/ead_to_es/xpaths.rb
@@ -35,6 +35,7 @@ def xpaths_list
         # "subcategory" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='subcategory'][1]/term",
         "title" => "/ead/archdesc/did/unittitle",
         "text" => "/ead/eadheader/filedesc/titlestmt/*",
+        "items" => "//*[@level='item']/did/unitid[@type='WWA']"
       }.merge(override_xpaths)
     end
   end

From ef6024ee08830b7e2615a036c3a60a6787108f01 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Tue, 9 Nov 2021 11:22:49 -0600
Subject: [PATCH 047/128] fix image_url xpath

---
 lib/datura/to_es/ead_to_es_items/xpaths.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/datura/to_es/ead_to_es_items/xpaths.rb b/lib/datura/to_es/ead_to_es_items/xpaths.rb
index cba8d7bf9..b39f2d802 100644
--- a/lib/datura/to_es/ead_to_es_items/xpaths.rb
+++ b/lib/datura/to_es/ead_to_es_items/xpaths.rb
@@ -18,7 +18,7 @@ def xpaths_list
         # "date_display" => "/TEI/teiHeader/fileDesc/sourceDesc/bibl/date",
         "extent" => "did/physdesc/extent",
         "format" => "did/physdesc/physfacet",
-        "image_url" => "dao/@href",
+        "image_url" => "did/dao/@href",
         # "image_id" => "/TEI/text//pb/@facs",
         # "keywords" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='keywords']/term",
         # note: language is global attribute xml:lang

From a7c0c9eb80df6bf25cb7f060c95ffafbefe91c7e Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Tue, 9 Nov 2021 14:36:35 -0600
Subject: [PATCH 048/128] add puts statements for debugging

---
 lib/datura/elasticsearch/index.rb | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index a409ca550..b8a3d9bda 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -83,8 +83,9 @@ def get_schema_mapping
       }
 
       schema = get_schema[@options["es_index"]]
+      puts schema
       doc = schema["mappings"]["_doc"]
-
+      puts doc
       doc["properties"].each do |field, value|
         @schema_mapping["fields"] << field
         if value["type"] == "nested"

From 9bd0e381f287c2e185a7691e483e0c18a64ca2e9 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Tue, 9 Nov 2021 14:42:05 -0600
Subject: [PATCH 049/128] try another way to debug

---
 lib/datura/elasticsearch/index.rb | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index b8a3d9bda..a19636609 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -83,7 +83,9 @@ def get_schema_mapping
       }
 
       schema = get_schema[@options["es_index"]]
-      puts schema
+      if schema == nil || schema == ""
+        puts "schema is nil!"
+      end
       doc = schema["mappings"]["_doc"]
       puts doc
       doc["properties"].each do |field, value|

From 7f1fa42fb3f40063f1f879ffd7e640d8f21e97e8 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Tue, 9 Nov 2021 14:43:20 -0600
Subject: [PATCH 050/128] test for nil specifically

---
 lib/datura/elasticsearch/index.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index a19636609..6078da308 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -83,7 +83,7 @@ def get_schema_mapping
       }
 
       schema = get_schema[@options["es_index"]]
-      if schema == nil || schema == ""
+      if schema == nil
         puts "schema is nil!"
       end
       doc = schema["mappings"]["_doc"]

From 30294ff14ec5371e2a257bc3852b0d2fb9040a5b Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Tue, 9 Nov 2021 14:57:58 -0600
Subject: [PATCH 051/128] add debugging statements to get_schema

---
 lib/datura/elasticsearch/index.rb | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index 6078da308..73f017ad7 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -66,6 +66,7 @@ def delete
   def get_schema
     RestClient.get(@mapping_url) { |res, req, result|
       if result.code == "200"
+        puts "res is #{res}, req is #{req}, result is #{result}"
         JSON.parse(res)
       else
         raise "#{result.code} error getting Elasticsearch schema: #{res}"

From f13dcaea677b118f261c85044ee817defeb494f5 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Tue, 9 Nov 2021 15:42:00 -0600
Subject: [PATCH 052/128] try debugging with byebug

---
 lib/datura/elasticsearch/index.rb | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index 73f017ad7..8d8cb5184 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -84,9 +84,7 @@ def get_schema_mapping
       }
 
       schema = get_schema[@options["es_index"]]
-      if schema == nil
-        puts "schema is nil!"
-      end
+      byebug
       doc = schema["mappings"]["_doc"]
       puts doc
       doc["properties"].each do |field, value|

From a61363add867eb0b692a76ca4c84599d1968fc46 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Tue, 9 Nov 2021 16:01:44 -0600
Subject: [PATCH 053/128] remove debugging info

---
 lib/datura/elasticsearch/index.rb | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index 8d8cb5184..f774e7278 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -66,7 +66,6 @@ def delete
   def get_schema
     RestClient.get(@mapping_url) { |res, req, result|
       if result.code == "200"
-        puts "res is #{res}, req is #{req}, result is #{result}"
         JSON.parse(res)
       else
         raise "#{result.code} error getting Elasticsearch schema: #{res}"
@@ -84,9 +83,7 @@ def get_schema_mapping
       }
 
       schema = get_schema[@options["es_index"]]
-      byebug
       doc = schema["mappings"]["_doc"]
-      puts doc
       doc["properties"].each do |field, value|
         @schema_mapping["fields"] << field
         if value["type"] == "nested"

From 5b87459d963e3f993bb9256feca1a51bbde336d8 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Wed, 10 Nov 2021 13:29:50 -0600
Subject: [PATCH 054/128] add alternative field

---
 lib/datura/to_es/ead_to_es/fields.rb       | 3 +++
 lib/datura/to_es/ead_to_es_items/fields.rb | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/lib/datura/to_es/ead_to_es/fields.rb b/lib/datura/to_es/ead_to_es/fields.rb
index 44436709a..73e9003f5 100644
--- a/lib/datura/to_es/ead_to_es/fields.rb
+++ b/lib/datura/to_es/ead_to_es/fields.rb
@@ -19,6 +19,9 @@ def abstract
     get_text(@xpaths["abstract"])
   end
 
+  def alternative
+  end
+
   def annotations_text
     # TODO what should default behavior be?
   end
diff --git a/lib/datura/to_es/ead_to_es_items/fields.rb b/lib/datura/to_es/ead_to_es_items/fields.rb
index 60a266445..e7669ac0b 100644
--- a/lib/datura/to_es/ead_to_es_items/fields.rb
+++ b/lib/datura/to_es/ead_to_es_items/fields.rb
@@ -15,6 +15,9 @@ def id
   #   "https://cdrhapi.unl.edu/doc/#{@id}"
   # end
 
+  def alternative
+  end
+
   def annotations_text
     # TODO what should default behavior be?
   end

From fcf01b3897bec8de651a8a79ab2aebde15b46389 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Wed, 10 Nov 2021 14:37:29 -0600
Subject: [PATCH 055/128] add relation field

---
 lib/datura/to_es/ead_to_es/fields.rb       | 3 +++
 lib/datura/to_es/ead_to_es_items/fields.rb | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/lib/datura/to_es/ead_to_es/fields.rb b/lib/datura/to_es/ead_to_es/fields.rb
index 73e9003f5..ca10636ed 100644
--- a/lib/datura/to_es/ead_to_es/fields.rb
+++ b/lib/datura/to_es/ead_to_es/fields.rb
@@ -161,6 +161,9 @@ def recipient
     # return people
   end
 
+  def relation
+  end
+
   def rights
     # Note: override by collection as needed
     get_text(@xpaths["rights"])
diff --git a/lib/datura/to_es/ead_to_es_items/fields.rb b/lib/datura/to_es/ead_to_es_items/fields.rb
index e7669ac0b..34b613495 100644
--- a/lib/datura/to_es/ead_to_es_items/fields.rb
+++ b/lib/datura/to_es/ead_to_es_items/fields.rb
@@ -169,6 +169,9 @@ def recipient
     # return people
   end
 
+  def relation
+  end
+
   def rights
     # Note: override by collection as needed
     get_text(@xpaths["rights"])

From d2d5939dc7483641aca635fbeb3e36b0790d709b Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Wed, 10 Nov 2021 14:51:00 -0600
Subject: [PATCH 056/128] add spatial field

---
 lib/datura/to_es/ead_to_es/fields.rb       | 3 +++
 lib/datura/to_es/ead_to_es_items/fields.rb | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/lib/datura/to_es/ead_to_es/fields.rb b/lib/datura/to_es/ead_to_es/fields.rb
index ca10636ed..54d03a359 100644
--- a/lib/datura/to_es/ead_to_es/fields.rb
+++ b/lib/datura/to_es/ead_to_es/fields.rb
@@ -183,6 +183,9 @@ def source
     get_text(@xpaths["source"])
   end
 
+  def spatial
+  end
+
   def subjects
     get_list(@xpaths["subjects"])
   end
diff --git a/lib/datura/to_es/ead_to_es_items/fields.rb b/lib/datura/to_es/ead_to_es_items/fields.rb
index 34b613495..888a8d982 100644
--- a/lib/datura/to_es/ead_to_es_items/fields.rb
+++ b/lib/datura/to_es/ead_to_es_items/fields.rb
@@ -191,6 +191,9 @@ def source
     get_text(@xpaths["source"])
   end
 
+  def spatial
+  end
+
   def subjects
     # TODO default behavior?
   end

From 102a5a89c0c0f4e23d8b812016fae4a58380f450 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Wed, 10 Nov 2021 15:14:05 -0600
Subject: [PATCH 057/128] fix a get_text method

---
 lib/datura/to_es/ead_to_es_items/fields.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/datura/to_es/ead_to_es_items/fields.rb b/lib/datura/to_es/ead_to_es_items/fields.rb
index 888a8d982..6668bdeca 100644
--- a/lib/datura/to_es/ead_to_es_items/fields.rb
+++ b/lib/datura/to_es/ead_to_es_items/fields.rb
@@ -207,7 +207,7 @@ def text
     # handling separate fields in array
     # means no worrying about handling spacing between words
     text = []
-    body = get_text(@xpaths["text"], false)
+    body = get_text(@xpaths["text"])
     text << body
     # TODO: do we need to preserve tags like <i> in text? if so, turn get_text to true
     # text << CommonXml.convert_tags_in_string(body)

From cf85953e846a978ad85ef147dfcf8394225ed824 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Wed, 10 Nov 2021 17:05:38 -0600
Subject: [PATCH 058/128] change post_es to match jessica's changes

---
 lib/datura/file_type.rb | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/datura/file_type.rb b/lib/datura/file_type.rb
index 12a66b25f..30875d335 100644
--- a/lib/datura/file_type.rb
+++ b/lib/datura/file_type.rb
@@ -49,6 +49,7 @@ def parse_markup_lang_file
     CommonXml.create_xml_object(self.file_location)
   end
 
+  # expecting an instance of Datura::Elasticsearch::Index
   def post_es(es)
     error = nil
     begin

From b35aaeba3dc9ba7e7da79d6cbfb8737987df1b85 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Thu, 11 Nov 2021 08:49:18 -0600
Subject: [PATCH 059/128] change CommonXML to Datura helpers

---
 lib/datura/to_es/ead_to_es/fields.rb       | 6 +++---
 lib/datura/to_es/ead_to_es_items/fields.rb | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/lib/datura/to_es/ead_to_es/fields.rb b/lib/datura/to_es/ead_to_es/fields.rb
index 54d03a359..9db742050 100644
--- a/lib/datura/to_es/ead_to_es/fields.rb
+++ b/lib/datura/to_es/ead_to_es/fields.rb
@@ -33,7 +33,7 @@ def category
   def creator
     creators = get_list(@xpaths["creators"])
     if creators
-      return creators.map { |creator| { "name" => CommonXml.normalize_space(creator) } }
+      return creators.map { |creator| { "name" => Datura::Helpers.normalize_space(creator) } }
     end
   end
 
@@ -71,7 +71,7 @@ def data_type
 
   def date(before=true)
     datestr = get_text(@xpaths["date"])
-    return CommonXml.date_standardize(datestr, before)
+    return Datura::Helpers.date_standardize(datestr, before)
   end
 
   def date_display
@@ -225,7 +225,7 @@ def title
 
   def title_sort
     t = title
-    CommonXml.normalize_name(t)
+    Datura::Helpers.normalize_name(t)
   end
 
   def type
diff --git a/lib/datura/to_es/ead_to_es_items/fields.rb b/lib/datura/to_es/ead_to_es_items/fields.rb
index 6668bdeca..731421cf5 100644
--- a/lib/datura/to_es/ead_to_es_items/fields.rb
+++ b/lib/datura/to_es/ead_to_es_items/fields.rb
@@ -65,7 +65,7 @@ def data_type
 
   def date(before=true)
     datestr = get_text(@xpaths["date"])
-    return CommonXml.date_standardize(datestr, before)
+    return Datura::Helpers.date_standardize(datestr, before)
   end
 
   def date_display
@@ -212,7 +212,7 @@ def text
     # TODO: do we need to preserve tags like <i> in text? if so, turn get_text to true
     # text << CommonXml.convert_tags_in_string(body)
     text += text_additional
-    return CommonXml.normalize_space(text.join(" "))
+    return Datura::Helpers.normalize_space(text.join(" "))
   end
 
   def text_additional
@@ -230,7 +230,7 @@ def title
 
   def title_sort
     t = title
-    CommonXml.normalize_name(t)
+    Datura::Helpers.normalize_name(t)
   end
 
   def topics

From 436f85d310f5f9bafe0cc2776b91749b3d0e772f Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Thu, 11 Nov 2021 11:04:00 -0600
Subject: [PATCH 060/128] change xpaths to be less specific to Walt Whitman

---
 lib/datura/to_es/ead_to_es/xpaths.rb       | 17 +-------------
 lib/datura/to_es/ead_to_es_items/xpaths.rb | 27 +---------------------
 2 files changed, 2 insertions(+), 42 deletions(-)

diff --git a/lib/datura/to_es/ead_to_es/xpaths.rb b/lib/datura/to_es/ead_to_es/xpaths.rb
index ddcc4d64f..b33e06c19 100644
--- a/lib/datura/to_es/ead_to_es/xpaths.rb
+++ b/lib/datura/to_es/ead_to_es/xpaths.rb
@@ -6,36 +6,21 @@ class EadToEs < XmlToEs
   def xpaths_list
       {
         "abstract" => "/ead/archdesc/did/abstract",
-        # "category" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='category'][1]/term",
-        # "contributors" => [
-        #   "/TEI/teiHeader/revisionDesc/change/name",
-        #   "/TEI/teiHeader/fileDesc/titleStmt/editor"
-        # ],
         "creators" => ["/ead/archdesc/did/origination/persname", "/ead/eadheader/filedesc/titlestmt/creator"],
         "date" => "/ead/eadheader/filedesc/publicationstmt/date",
         "description" => "/ead/archdesc/scopecontent/p",
-        # a non normalized date taken directly from the source material ("Dec 9", "Winter 1889")
-        # "date_display" => "/TEI/teiHeader/fileDesc/sourceDesc/bibl/date",
         "formats" => "/ead/archdesc/did/physdesc/genreform",
-        # "image_id" => "/TEI/text//pb/@facs",
-        # "keywords" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='keywords']/term",
-        # note: language is global attribute xml:lang
         "identifier" => "/ead/archdesc/did/unitid",
         "language" => "/ead/eadheader/profiledesc/langusage/language",
-        # "languages" => "//body/div1/@lang",
-        # "person" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='people']/term",
-        # "places" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='places']/term",
         "publisher" => "/ead/eadheader/filedesc/publicationstmt/publisher",
-        # "recipient" => "/TEI/teiHeader/profileDesc/particDesc/person[@role='recipient']/persName",
         "repository_contact" => "/ead/archdesc/did/repository/address/*",
         "rights" => "/ead/archdesc/descgrp/accessrestrict/p",
         "rights_holder" => "/ead/archdesc/did/repository/corpname",
         "source" => "/ead/archdesc/descgrp/prefercite/p",
         "subjects" => "/ead/archdesc/controlaccess/*[not(name()='head')]",
-        # "subcategory" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='subcategory'][1]/term",
         "title" => "/ead/archdesc/did/unittitle",
         "text" => "/ead/eadheader/filedesc/titlestmt/*",
-        "items" => "//*[@level='item']/did/unitid[@type='WWA']"
+        "items" => "//*[@level='item']/did/unitid"
       }.merge(override_xpaths)
     end
   end
diff --git a/lib/datura/to_es/ead_to_es_items/xpaths.rb b/lib/datura/to_es/ead_to_es_items/xpaths.rb
index b39f2d802..bec9aba4d 100644
--- a/lib/datura/to_es/ead_to_es_items/xpaths.rb
+++ b/lib/datura/to_es/ead_to_es_items/xpaths.rb
@@ -6,40 +6,15 @@ class EadToEsItems < EadToEs
   def xpaths_list
       {
         "abstract" => "did/abstract",
-        # "category" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='category'][1]/term",
-        # "contributors" => [
-        #   "/TEI/teiHeader/revisionDesc/change/name",
-        #   "/TEI/teiHeader/fileDesc/titleStmt/editor"
-        # # ],
-        # "creators" => ["/ead/archdesc/did/origination/persname", "/ead/eadheader/filedesc/titlestmt/creator"],
         "date" => "did/unitdate",
         "description" => "scopecontent/p",
-        # a non normalized date taken directly from the source material ("Dec 9", "Winter 1889")
-        # "date_display" => "/TEI/teiHeader/fileDesc/sourceDesc/bibl/date",
         "extent" => "did/physdesc/extent",
         "format" => "did/physdesc/physfacet",
         "image_url" => "did/dao/@href",
-        # "image_id" => "/TEI/text//pb/@facs",
-        # "keywords" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='keywords']/term",
-        # note: language is global attribute xml:lang
-        "identifier" => "did/unitid[@type='WWA']",
-        # "language" => "(//body/div1/@lang)[1]",
-        # "languages" => "//body/div1/@lang",
-        # "person" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='people']/term",
-        # "places" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='places']/term",
-        # "publisher" => "/TEI/teiHeader/fileDesc/sourceDesc/bibl[1]/publisher[1]",
-        # "recipient" => "/TEI/teiHeader/profileDesc/particDesc/person[@role='recipient']/persName",
+        "identifier" => "did/unitid",
         "repository_id" => "did/unitid[@type='repository']",
-        # "rights" => "/ead/archdesc/descgrp/accessrestrict/p",
-        # "rights_holder" => "/ead/archdesc/descgrp/accessrestrict/p",
-        # "source" => "/ead/archdesc/descgrp/prefercite/p",
-        # "subjects" => ["/ead/archdesc/controlaccess/[everything after head;persname, subject]"],
-        # "subcategory" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='subcategory'][1]/term",
-        # "text" => "//text",
         "title" => "did/unittitle",
-        # "topic" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='topic']/term",
         "type" => "did/physdesc/genreform",
-        # "works" => "/TEI/teiHeader/profileDesc/textClass/keywords[@n='works']/term",
       }.merge(override_xpaths)
   end
 end

From c85b31f80f20afba54d3b07804f7d86686366484 Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Thu, 11 Nov 2021 16:36:14 -0600
Subject: [PATCH 061/128] refactor title fields and xpaths

---
 lib/datura/to_es/ead_to_es/fields.rb       | 5 ++---
 lib/datura/to_es/ead_to_es_items/fields.rb | 5 ++---
 lib/datura/to_es/ead_to_es_items/xpaths.rb | 3 ++-
 3 files changed, 6 insertions(+), 7 deletions(-)

diff --git a/lib/datura/to_es/ead_to_es/fields.rb b/lib/datura/to_es/ead_to_es/fields.rb
index 9db742050..bf4a4e569 100644
--- a/lib/datura/to_es/ead_to_es/fields.rb
+++ b/lib/datura/to_es/ead_to_es/fields.rb
@@ -220,12 +220,11 @@ def text
   # end
 
   def title
-    get_text(@xpaths["title"])
+    get_list(@xpaths["title"])
   end
 
   def title_sort
-    t = title
-    Datura::Helpers.normalize_name(t)
+    Datura::Helpers.normalize_name(title)
   end
 
   def type
diff --git a/lib/datura/to_es/ead_to_es_items/fields.rb b/lib/datura/to_es/ead_to_es_items/fields.rb
index 731421cf5..9e0c48d87 100644
--- a/lib/datura/to_es/ead_to_es_items/fields.rb
+++ b/lib/datura/to_es/ead_to_es_items/fields.rb
@@ -225,12 +225,11 @@ def text_additional
   end
 
   def title
-    title = get_text(@xpaths["title"])
+    get_text(@xpaths["title"])[0]
   end
 
   def title_sort
-    t = title
-    Datura::Helpers.normalize_name(t)
+    Datura::Helpers.normalize_name(title)
   end
 
   def topics
diff --git a/lib/datura/to_es/ead_to_es_items/xpaths.rb b/lib/datura/to_es/ead_to_es_items/xpaths.rb
index bec9aba4d..23b941e29 100644
--- a/lib/datura/to_es/ead_to_es_items/xpaths.rb
+++ b/lib/datura/to_es/ead_to_es_items/xpaths.rb
@@ -7,13 +7,14 @@ def xpaths_list
       {
         "abstract" => "did/abstract",
         "date" => "did/unitdate",
+        "date_display" => "did/unitdate",
         "description" => "scopecontent/p",
         "extent" => "did/physdesc/extent",
         "format" => "did/physdesc/physfacet",
         "image_url" => "did/dao/@href",
         "identifier" => "did/unitid",
         "repository_id" => "did/unitid[@type='repository']",
-        "title" => "did/unittitle",
+        "title" => "did/unittitle/title",
         "type" => "did/physdesc/genreform",
       }.merge(override_xpaths)
   end

From 349ff66e5a693c4894c92669db4cf84df6cc832f Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Fri, 10 Dec 2021 11:21:37 -0600
Subject: [PATCH 062/128] add creator override for items so it is an array

---
 lib/datura/to_es/ead_to_es_items/fields.rb | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/lib/datura/to_es/ead_to_es_items/fields.rb b/lib/datura/to_es/ead_to_es_items/fields.rb
index 9e0c48d87..bf1fc99d6 100644
--- a/lib/datura/to_es/ead_to_es_items/fields.rb
+++ b/lib/datura/to_es/ead_to_es_items/fields.rb
@@ -26,10 +26,10 @@ def category
   end
 
   # note this does not sort the creators
-  # def creator
-  #   creators = get_list(@xpaths["creators"])
-  #   return creators.map { |creator| { "name" => CommonXml.normalize_space(creator) } }
-  # end
+  def creator
+    creators = get_list(@xpaths["creators"])
+    return creators.map { |creator| { "name" => CommonXml.normalize_space(creator) } }
+  end
 
   # returns ; delineated string of alphabetized creators
   def creator_sort

From e640971f8376d54df1d69abfc1ac257363139c2a Mon Sep 17 00:00:00 2001
From: William Dewey <william.dewey@unl.edu>
Date: Tue, 21 Dec 2021 11:18:17 -0600
Subject: [PATCH 063/128] change creators to creator

---
 lib/datura/to_es/ead_to_es/fields.rb | 2 +-
 lib/datura/to_es/ead_to_es/xpaths.rb | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/datura/to_es/ead_to_es/fields.rb b/lib/datura/to_es/ead_to_es/fields.rb
index bf4a4e569..f5599c97a 100644
--- a/lib/datura/to_es/ead_to_es/fields.rb
+++ b/lib/datura/to_es/ead_to_es/fields.rb
@@ -31,7 +31,7 @@ def category
 
   # note this does not sort the creators
   def creator
-    creators = get_list(@xpaths["creators"])
+    creators = get_list(@xpaths["creator"])
     if creators
       return creators.map { |creator| { "name" => Datura::Helpers.normalize_space(creator) } }
     end
diff --git a/lib/datura/to_es/ead_to_es/xpaths.rb b/lib/datura/to_es/ead_to_es/xpaths.rb
index b33e06c19..989d5122c 100644
--- a/lib/datura/to_es/ead_to_es/xpaths.rb
+++ b/lib/datura/to_es/ead_to_es/xpaths.rb
@@ -6,7 +6,7 @@ class EadToEs < XmlToEs
   def xpaths_list
       {
         "abstract" => "/ead/archdesc/did/abstract",
-        "creators" => ["/ead/archdesc/did/origination/persname", "/ead/eadheader/filedesc/titlestmt/creator"],
+        "creator" => ["/ead/archdesc/did/origination/persname", "/ead/eadheader/filedesc/titlestmt/creator"],
         "date" => "/ead/eadheader/filedesc/publicationstmt/date",
         "description" => "/ead/archdesc/scopecontent/p",
         "formats" => "/ead/archdesc/did/physdesc/genreform",

From 728611487226bf293cf0ebe944abf1cd2eb556dc Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Thu, 16 Jun 2022 12:22:31 -0500
Subject: [PATCH 064/128] add rdf schema

---
 lib/datura/to_es/es_request.rb | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/lib/datura/to_es/es_request.rb b/lib/datura/to_es/es_request.rb
index 6aeeef056..923f56f98 100644
--- a/lib/datura/to_es/es_request.rb
+++ b/lib/datura/to_es/es_request.rb
@@ -30,6 +30,7 @@ def assemble_json
     assemble_people
     assemble_spatial
     assemble_references
+    assemble_rdf
     assemble_text
     assemble_collection_specific
 
@@ -117,10 +118,16 @@ def assemble_spatial
     @json["spatial"] = spatial
   end
 
+  def assemble_rdf
+    @json["rdf"] = rdf
+  end
+
   def assemble_text
     @json["annotations_text"] = annotations_text
     @json["text"] = text
     # @json["abstract"]
   end
 
+  
+
 end

From d4f45f04838a273dacf17bcd397d82eab029f934 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Mon, 20 Jun 2022 11:55:02 -0500
Subject: [PATCH 065/128] update schemas to include rdf fields

---
 lib/config/es_api_schemas/1.0.yml | 15 +++++++++++++++
 lib/config/es_api_schemas/2.0.yml | 21 +++++++++++++++++++++
 2 files changed, 36 insertions(+)

diff --git a/lib/config/es_api_schemas/1.0.yml b/lib/config/es_api_schemas/1.0.yml
index 9d3a69650..4953b47be 100644
--- a/lib/config/es_api_schemas/1.0.yml
+++ b/lib/config/es_api_schemas/1.0.yml
@@ -88,6 +88,21 @@ mappings:
       type: keyword
     source:
       type: keyword
+    rdf:
+      type: nested
+      properties:
+        type:
+          type: keyword
+        subject:
+          type: keyword
+        predicate:
+          type: keyword
+        object:
+          type: keyword
+        source:
+          type: keyword
+        note:
+          type: keyword
     recipient:
       type: nested
       properties:
diff --git a/lib/config/es_api_schemas/2.0.yml b/lib/config/es_api_schemas/2.0.yml
index 841da72a4..06db363e3 100644
--- a/lib/config/es_api_schemas/2.0.yml
+++ b/lib/config/es_api_schemas/2.0.yml
@@ -150,6 +150,27 @@ mappings:
     source:
       type: keyword
       normalizer: keyword_normalized
+    rdf:
+      type: nested
+      properties:
+        type:
+          type: keyword
+          normalizer: keyword_normalized
+        subject:
+          type: keyword
+          normalizer: keyword_normalized
+        predicate:
+          type: keyword
+          normalizer: keyword_normalized
+        object:
+          type: keyword
+          normalizer: keyword_normalized
+        source:
+          type: keyword
+          normalizer: keyword_normalized
+        note:
+          type: keyword  
+          normalizer: keyword_normalized
     recipient:
       type: nested
       properties:

From f78ea7380a84872ef34e74e9d175d3e0bf11223f Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Mon, 20 Jun 2022 12:12:04 -0500
Subject: [PATCH 066/128] add rdf to default fields

---
 lib/datura/to_es/csv_to_es/fields.rb    | 4 ++++
 lib/datura/to_es/custom_to_es/fields.rb | 4 ++++
 lib/datura/to_es/html_to_es/fields.rb   | 4 ++++
 lib/datura/to_es/tei_to_es/fields.rb    | 4 ++++
 lib/datura/to_es/vra_to_es/fields.rb    | 4 ++++
 lib/datura/to_es/webs_to_es/fields.rb   | 4 ++++
 6 files changed, 24 insertions(+)

diff --git a/lib/datura/to_es/csv_to_es/fields.rb b/lib/datura/to_es/csv_to_es/fields.rb
index 0f4a2be61..1b649eb2a 100644
--- a/lib/datura/to_es/csv_to_es/fields.rb
+++ b/lib/datura/to_es/csv_to_es/fields.rb
@@ -139,6 +139,10 @@ def recipient
     end
   end
 
+  # nested field
+  def rdf
+  end
+
   def relation
     @row["relation"]
   end
diff --git a/lib/datura/to_es/custom_to_es/fields.rb b/lib/datura/to_es/custom_to_es/fields.rb
index 0818f94e7..7a430d3be 100644
--- a/lib/datura/to_es/custom_to_es/fields.rb
+++ b/lib/datura/to_es/custom_to_es/fields.rb
@@ -85,6 +85,10 @@ def places
   def publisher
   end
 
+  # nested field
+  def rdf
+  end
+
   # nested field
   def recipient
   end
diff --git a/lib/datura/to_es/html_to_es/fields.rb b/lib/datura/to_es/html_to_es/fields.rb
index c95d452e4..4b70303de 100644
--- a/lib/datura/to_es/html_to_es/fields.rb
+++ b/lib/datura/to_es/html_to_es/fields.rb
@@ -111,6 +111,10 @@ def publisher
     get_text(@xpaths["publisher"])
   end
 
+  # nested field
+  def rdf
+  end
+
   # nested field
   def recipient
   end
diff --git a/lib/datura/to_es/tei_to_es/fields.rb b/lib/datura/to_es/tei_to_es/fields.rb
index 861d42d70..f78b044f2 100644
--- a/lib/datura/to_es/tei_to_es/fields.rb
+++ b/lib/datura/to_es/tei_to_es/fields.rb
@@ -129,6 +129,10 @@ def publisher
     get_text(@xpaths["publisher"])
   end
 
+  # nested field
+  def rdf
+  end
+
   # nested field
   def recipient
     eles = @xml.xpath(@xpaths["recipient"])
diff --git a/lib/datura/to_es/vra_to_es/fields.rb b/lib/datura/to_es/vra_to_es/fields.rb
index 75e374e80..233778287 100644
--- a/lib/datura/to_es/vra_to_es/fields.rb
+++ b/lib/datura/to_es/vra_to_es/fields.rb
@@ -138,6 +138,10 @@ def publisher
     get_text(@xpaths["publisher"])
   end
 
+  # nested field
+  def rdf
+  end
+
   # nested field
   def recipient
     eles = get_elements(@xpaths["recipient"])
diff --git a/lib/datura/to_es/webs_to_es/fields.rb b/lib/datura/to_es/webs_to_es/fields.rb
index 815b78aa8..993813f63 100644
--- a/lib/datura/to_es/webs_to_es/fields.rb
+++ b/lib/datura/to_es/webs_to_es/fields.rb
@@ -111,6 +111,10 @@ def publisher
     get_text(@xpaths["publisher"])
   end
 
+  # nested field
+  def rdf
+  end
+
   # nested field
   def recipient
   end

From f5c9d625554b5fcaaf0e72dc719dcc392a6e7c86 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Tue, 21 Jun 2022 14:04:31 -0500
Subject: [PATCH 067/128] add spatial.title field

---
 lib/config/es_api_schemas/1.0.yml | 3 +++
 lib/config/es_api_schemas/2.0.yml | 4 ++++
 2 files changed, 7 insertions(+)

diff --git a/lib/config/es_api_schemas/1.0.yml b/lib/config/es_api_schemas/1.0.yml
index 4953b47be..da276c956 100644
--- a/lib/config/es_api_schemas/1.0.yml
+++ b/lib/config/es_api_schemas/1.0.yml
@@ -121,6 +121,9 @@ mappings:
     spatial:
       type: nested
       properties:
+        # display title for entire location
+        title:
+          type: keyword
         place_name:
           # TODO copy into text?
           type: keyword
diff --git a/lib/config/es_api_schemas/2.0.yml b/lib/config/es_api_schemas/2.0.yml
index 06db363e3..f67b8d519 100644
--- a/lib/config/es_api_schemas/2.0.yml
+++ b/lib/config/es_api_schemas/2.0.yml
@@ -195,6 +195,10 @@ mappings:
     spatial:
       type: nested
       properties:
+        # display title for entire location
+        title:
+          type: keyword
+          normalizer: keyword_normalized
         place_name:
           # TODO copy into text?
           type: keyword

From a2b78f6c212a96c350a7c13b908f09f194f2b5f2 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Mon, 18 Jul 2022 11:36:22 -0500
Subject: [PATCH 068/128] require byebug so it is in scope for posting etc.

---
 lib/datura/data_manager.rb | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/lib/datura/data_manager.rb b/lib/datura/data_manager.rb
index 96544e045..cdf80d9c3 100644
--- a/lib/datura/data_manager.rb
+++ b/lib/datura/data_manager.rb
@@ -3,7 +3,7 @@
 require "yaml"
 require "byebug"
 require_relative "./requirer.rb"
-
+require "byebug"
 class Datura::DataManager
   attr_reader :log
   attr_reader :time
@@ -46,6 +46,9 @@ def initialize
     prepare_xslt
     load_collection_classes
     set_up_logger
+    # set up posting URLs
+    @es_url = File.join(options["es_path"], options["es_index"])
+    @solr_url = File.join(options["solr_path"], options["solr_core"], "update")
   end
 
   # NOTE: This step is what allows collection specific files to override ANY
@@ -53,9 +56,13 @@ def initialize
   def load_collection_classes
     # load collection scripts at this point so they will override
     # any of the default ones (for example: TeiToEs)
+    puts !(defined?(byebug))
+
     path = File.join(@options["collection_dir"], "scripts", "overrides", "*.rb")
     Dir[path].each do |f|
+      puts "requiring" + f
       require f
+      puts defined?(byebug)
     end
   end
 
@@ -66,6 +73,7 @@ def print_options
   end
 
   def run
+    byebug
     @time = [Time.now]
     # log starting information for user
     check_options

From 330fcd6c70f94ac2db3f728f0bfc394f0f31409f Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Wed, 24 Aug 2022 13:39:45 -0500
Subject: [PATCH 069/128] remove inserted byebug

---
 lib/datura/data_manager.rb | 1 -
 1 file changed, 1 deletion(-)

diff --git a/lib/datura/data_manager.rb b/lib/datura/data_manager.rb
index cdf80d9c3..7e75815d9 100644
--- a/lib/datura/data_manager.rb
+++ b/lib/datura/data_manager.rb
@@ -73,7 +73,6 @@ def print_options
   end
 
   def run
-    byebug
     @time = [Time.now]
     # log starting information for user
     check_options

From f7ebd87da2f0e8cfe3d922f1419c8f06cda65c00 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Mon, 18 Jul 2022 11:36:22 -0500
Subject: [PATCH 070/128] require byebug so it is in scope for posting etc.

---
 lib/datura/data_manager.rb | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/lib/datura/data_manager.rb b/lib/datura/data_manager.rb
index 7e75815d9..d8c66936e 100644
--- a/lib/datura/data_manager.rb
+++ b/lib/datura/data_manager.rb
@@ -56,13 +56,10 @@ def initialize
   def load_collection_classes
     # load collection scripts at this point so they will override
     # any of the default ones (for example: TeiToEs)
-    puts !(defined?(byebug))
-
     path = File.join(@options["collection_dir"], "scripts", "overrides", "*.rb")
     Dir[path].each do |f|
       puts "requiring" + f
       require f
-      puts defined?(byebug)
     end
   end
 

From 73e7b198bdd192182d2e66499f24d31eca584403 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Mon, 8 Aug 2022 09:28:44 -0500
Subject: [PATCH 071/128] include full error message with backtrace

---
 lib/datura/file_type.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/datura/file_type.rb b/lib/datura/file_type.rb
index 30875d335..da92e7f85 100644
--- a/lib/datura/file_type.rb
+++ b/lib/datura/file_type.rb
@@ -55,7 +55,7 @@ def post_es(es)
     begin
       transformed = transform_es
     rescue => e
-      "Error transforming ES for #{self.filename(false)}: #{e}"
+      return { "error" => "Error transforming ES for #{self.filename(false)}: #{e.full_message}" }
     end
     if transformed && transformed.length > 0
       transformed.each do |doc|

From 4328acc63c4b5cebd00cf4b57acf434ad147bda7 Mon Sep 17 00:00:00 2001
From: Jessica Dussault <jdussault4@gmail.com>
Date: Thu, 9 Jan 2020 16:05:26 -0600
Subject: [PATCH 072/128] updates gems and fixes test suite

had suffered from errors and from gem deprecation warnings
---
 Gemfile.lock | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/Gemfile.lock b/Gemfile.lock
index 82108be99..2d67803de 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -13,7 +13,12 @@ GEM
     colorize (0.8.1)
     domain_name (0.5.20190701)
       unf (>= 0.0.5, < 1.0.0)
+<<<<<<< HEAD
     http-cookie (1.0.5)
+=======
+    http-accept (1.7.0)
+    http-cookie (1.0.3)
+>>>>>>> 4d02bee88 (updates gems and fixes test suite)
       domain_name (~> 0.5)
     mime-types (3.4.1)
       mime-types-data (~> 3.2015)
@@ -26,8 +31,8 @@ GEM
       racc (~> 1.4)
     racc (1.6.0)
     rake (13.0.6)
-    rest-client (2.0.2)
-      http-cookie (>= 1.0.2, < 2.0)
+    rest-client (2.1.0)
+      http-accept (>= 1.7.0, < 2.0)
       mime-types (>= 1.16, < 4.0)
       netrc (~> 0.8)
     unf (0.1.4)

From 1660fb18bf891ab0c5040593887675df05d0e0f7 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Wed, 25 May 2022 15:48:46 -0500
Subject: [PATCH 073/128] update gems in preparation for release

---
 Gemfile.lock | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Gemfile.lock b/Gemfile.lock
index 2d67803de..a20379abd 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -13,12 +13,16 @@ GEM
     colorize (0.8.1)
     domain_name (0.5.20190701)
       unf (>= 0.0.5, < 1.0.0)
+<<<<<<< HEAD
 <<<<<<< HEAD
     http-cookie (1.0.5)
 =======
     http-accept (1.7.0)
     http-cookie (1.0.3)
 >>>>>>> 4d02bee88 (updates gems and fixes test suite)
+=======
+    http-cookie (1.0.5)
+>>>>>>> deb1664b2 (update gems in preparation for release)
       domain_name (~> 0.5)
     mime-types (3.4.1)
       mime-types-data (~> 3.2015)

From ee596cc430f894fa6bb773950821d77a2ed328c2 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Tue, 9 Aug 2022 08:41:04 -0500
Subject: [PATCH 074/128] start adding new api fields

---
 lib/config/es_api_schemas/2.0.yml | 128 +++++++++++++++++++++++++-----
 1 file changed, 106 insertions(+), 22 deletions(-)

diff --git a/lib/config/es_api_schemas/2.0.yml b/lib/config/es_api_schemas/2.0.yml
index f67b8d519..688ba5bc9 100644
--- a/lib/config/es_api_schemas/2.0.yml
+++ b/lib/config/es_api_schemas/2.0.yml
@@ -37,39 +37,45 @@ mappings:
     identifier:
       type: keyword
       normalizer: keyword_normalized
-    collection:
+    cdrhCollection:
       type: keyword
       normalizer: keyword_normalized
-    collection_desc:
+    cdrhCollectionDesc:
       type: keyword
       normalizer: keyword_normalized
-    uri:
+    cdrhUri:
       type: keyword
       normalizer: keyword_normalized
-    uri_data:
+    cdrhUriData:
       type: keyword
       normalizer: keyword_normalized
-    uri_html:
+    cdrhUriHtml:
       type: keyword
       normalizer: keyword_normalized
-    data_type:
+    cdrhDataType:
       type: keyword
       normalizer: keyword_normalized
-    image_location:
+    cdrhFigLocation:
       type: keyword
       normalizer: keyword_normalized
-    image_id:
+    # image_location: TODO how is this field handled? is it same as above?
+    #   type: keyword
+    #   normalizer: keyword_normalized
+    cdrhCoverImage:
       type: keyword
       normalizer: keyword_normalized
       # TODO copy to text?
-    title:
+    dcTitle:
       type: keyword
       normalizer: keyword_normalized
     title_sort:
       type: keyword
       normalizer: keyword_normalized
       # TODO copy to text?
-    alternative:
+    dctermsAlternative:
+      type: keyword
+      normalizer: keyword_normalized
+    cdrhDateUpdated:
       type: keyword
       normalizer: keyword_normalized
     creator_sort:
@@ -85,15 +91,15 @@ mappings:
         id:
           type: keyword
           normalizer: keyword_normalized
-    subjects:
+    dctermsSubjects:
       type: keyword
       normalizer: keyword_normalized
       # TODO not sure yet if for display or search
-    abstract:
+    dctermsAbstract:
       type: keyword
       normalizer: keyword_normalized
       # TODO copy to text?
-    description:
+    dctermsDescription:
       type: keyword
       normalizer: keyword_normalized
     publisher:
@@ -111,7 +117,7 @@ mappings:
         role:
           type: keyword
           normalizer: keyword_normalized
-    date:
+    date_sort:
       type: date
       format: "yyyy-MM-dd||epoch_millis"
       # ignore_malformed: true
@@ -144,10 +150,10 @@ mappings:
     languages:
       type: keyword
       normalizer: keyword_normalized
-    relation:
+    dctermsRelation:
       type: keyword
       normalizer: keyword_normalized
-    source:
+    dctermsSource:
       type: keyword
       normalizer: keyword_normalized
     rdf:
@@ -227,6 +233,21 @@ mappings:
           type: keyword
           normalizer: keyword_normalized
         postal_code:
+          type: keyword
+          normalizer: keyword_normalized        
+        township:
+          type: keyword
+          normalizer: keyword_normalized        
+        note:
+          type: keyword
+          normalizer: keyword_normalized
+        role:
+          type: keyword
+          normalizer: keyword_normalized
+        description:
+          type: keyword
+          normalizer: keyword_normalized
+        type:
           type: keyword
           normalizer: keyword_normalized
     person:
@@ -245,27 +266,90 @@ mappings:
     annotations_text:
       type: text
       analyzer: english
-    category:
+    cdrhCategory1:
       type: keyword
       normalizer: keyword_normalized
-    subcategory:
+    cdrhCategory2:
       type: keyword
       normalizer: keyword_normalized
-    topics:
+    cdrhCategory3:
       type: keyword
       normalizer: keyword_normalized
-    keywords:
+    cdrhCategory4:
       type: keyword
       normalizer: keyword_normalized
-    people:
+    cdrhCategory5:
       type: keyword
       normalizer: keyword_normalized
-    places:
+    cdrhNotes:
       type: keyword
       normalizer: keyword_normalized
+    cdrhTopics:
+      type: keyword
+      normalizer: keyword_normalized
+    cdrhKeywords1:
+      type: keyword
+      normalizer: keyword_normalized
+    cdrhKeywords2:
+      type: keyword
+      normalizer: keyword_normalized
+    cdrhKeywords3:
+      type: keyword
+      normalizer: keyword_normalized
+    cdrhKeywords4:
+      type: keyword
+      normalizer: keyword_normalized
+    people:
+      type: keyword
+      normalizer: keyword_normalized
+    # places: #DEPRECATED
+    #   type: keyword
+    #   normalizer: keyword_normalized
     works:
       type: keyword
       normalizer: keyword_normalized
+    citation:
+      type: nested
+      properties:
+        role:
+          type: keyword
+          normalizer: keyword_normalized
+        date:
+          type: date
+          format: "yyyy-MM-dd||epoch_millis"
+        publisher:
+          type: keyword
+          normalizer: keyword_normalized
+        issue:
+          type: keyword
+          normalizer: keyword_normalized
+        page_begin:
+          type: keyword
+          normalizer: keyword_normalized
+        page_end:
+          type: keyword
+          normalizer: keyword_normalized
+        section:
+          type: keyword
+          normalizer: keyword_normalized
+        volume:
+          type: keyword
+          normalizer: keyword_normalized
+        place:
+          type: keyword
+          normalizer: keyword_normalized
+        title_a:
+          type: keyword
+          normalizer: keyword_normalized
+        title_m:
+          type: keyword
+          normalizer: keyword_normalized
+        title_j:
+          type: keyword
+          normalizer: keyword_normalized
+    date_created:
+      type: date
+      format: "yyyy-MM-dd||epoch_millis"
     text:
       type: text
       analyzer: english

From 2fe4238030b788a7f2c456ad05acb9ef09438313 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Thu, 11 Aug 2022 14:21:35 -0500
Subject: [PATCH 075/128] update schema to match spreadsheet with new field
 names

---
 lib/config/es_api_schemas/2.0.yml | 360 +++++++++++++++++-------------
 1 file changed, 209 insertions(+), 151 deletions(-)

diff --git a/lib/config/es_api_schemas/2.0.yml b/lib/config/es_api_schemas/2.0.yml
index 688ba5bc9..e744f7bdc 100644
--- a/lib/config/es_api_schemas/2.0.yml
+++ b/lib/config/es_api_schemas/2.0.yml
@@ -37,72 +37,60 @@ mappings:
     identifier:
       type: keyword
       normalizer: keyword_normalized
-    cdrhCollection:
+    collection:
       type: keyword
       normalizer: keyword_normalized
-    cdrhCollectionDesc:
+    collection_desc:
       type: keyword
       normalizer: keyword_normalized
-    cdrhUri:
+    uri:
       type: keyword
       normalizer: keyword_normalized
-    cdrhUriData:
+    uri_data:
       type: keyword
       normalizer: keyword_normalized
-    cdrhUriHtml:
+    uri_html:
       type: keyword
       normalizer: keyword_normalized
-    cdrhDataType:
+    data_type:
       type: keyword
       normalizer: keyword_normalized
-    cdrhFigLocation:
+    fig_location:
       type: keyword
       normalizer: keyword_normalized
-    # image_location: TODO how is this field handled? is it same as above?
-    #   type: keyword
-    #   normalizer: keyword_normalized
-    cdrhCoverImage:
+    cover_image:
       type: keyword
       normalizer: keyword_normalized
-      # TODO copy to text?
-    dcTitle:
+    title:
+      # TODO copy to text
       type: keyword
       normalizer: keyword_normalized
     title_sort:
       type: keyword
       normalizer: keyword_normalized
-      # TODO copy to text?
-    dctermsAlternative:
+    alternative:
+      # TODO copy to text
       type: keyword
       normalizer: keyword_normalized
-    cdrhDateUpdated:
+    date_updated:
+      type: date
+      format: "yyyy-MM-dd||epoch_millis"
+    category1:
       type: keyword
       normalizer: keyword_normalized
-    creator_sort:
+    category2:
       type: keyword
       normalizer: keyword_normalized
-    creator:
-      type: nested
-      properties:
-        name:
-          # TODO copy into text?
-          type: keyword
-          normalizer: keyword_normalized
-        id:
-          type: keyword
-          normalizer: keyword_normalized
-    dctermsSubjects:
+    category3:
       type: keyword
       normalizer: keyword_normalized
-      # TODO not sure yet if for display or search
-    dctermsAbstract:
+    category4:
       type: keyword
       normalizer: keyword_normalized
-      # TODO copy to text?
-    dctermsDescription:
+    category5:
       type: keyword
       normalizer: keyword_normalized
-    publisher:
+    notes:
       type: keyword
       normalizer: keyword_normalized
     contributor:
@@ -117,7 +105,58 @@ mappings:
         role:
           type: keyword
           normalizer: keyword_normalized
-    date_sort:
+    creator:
+      type: nested
+      properties:
+        name:
+          type: keyword
+          normalizer: keyword_normalized
+        id:
+          type: keyword
+          normalizer: keyword_normalized
+    citation:
+      type: nested
+      properties:
+        role:
+          type: keyword
+          normalizer: keyword_normalized
+        id:
+          type: keyword
+          normalizer: keyword_normalized
+        date:
+          type: date
+          format: "yyyy-MM-dd||epoch_millis"
+        publisher:
+          type: keyword
+          normalizer: keyword_normalized
+        issue:
+          type: keyword
+          normalizer: keyword_normalized
+        page_begin:
+          type: keyword
+          normalizer: keyword_normalized
+        page_end:
+          type: keyword
+          normalizer: keyword_normalized
+        section:
+          type: keyword
+          normalizer: keyword_normalized
+        volume:
+          type: keyword
+          normalizer: keyword_normalized
+        place:
+          type: keyword
+          normalizer: keyword_normalized
+        title_a:
+          type: keyword
+          normalizer: keyword_normalized
+        title_m:
+          type: keyword
+          normalizer: keyword_normalized
+        title_j:
+          type: keyword
+          normalizer: keyword_normalized
+    date:
       type: date
       format: "yyyy-MM-dd||epoch_millis"
       # ignore_malformed: true
@@ -132,9 +171,6 @@ mappings:
       type: date
       format: "yyyy-MM-dd||epoch_millis"
       # ignore_malformed: true
-    type:
-      type: keyword
-      normalizer: keyword_normalized
     format:
       type: keyword
       normalizer: keyword_normalized
@@ -147,37 +183,124 @@ mappings:
     language:
       type: keyword
       normalizer: keyword_normalized
-    languages:
+    rights_holder:
+      type: keyword
+      normalizer: keyword_normalized
+    rights:
       type: keyword
       normalizer: keyword_normalized
-    dctermsRelation:
+    rights_uri:
       type: keyword
       normalizer: keyword_normalized
-    dctermsSource:
+    subjects:
       type: keyword
       normalizer: keyword_normalized
-    rdf:
+      # TODO not sure yet if for display or search
+    abstract:
+      type: keyword
+      normalizer: keyword_normalized
+      # TODO copy to text?
+    description:
+      type: text
+      analyzer: english
+    type:
+      type: keyword
+      normalizer: keyword_normalized
+    topics:
+      type: keyword
+      normalizer: keyword_normalized
+    keywords1:
+      type: keyword
+      normalizer: keyword_normalized
+    keywords2:
+      type: keyword
+      normalizer: keyword_normalized
+    keywords3:
+      type: keyword
+      normalizer: keyword_normalized
+    keywords4:
+      type: keyword
+      normalizer: keyword_normalized
+    relation:
+      type: keyword
+      normalizer: keyword_normalized
+    source:
+      type: keyword
+      normalizer: keyword_normalized
+    has_part:
+      type: keyword
+      normalizer: keyword_normalized
+    is_part_of:
+      type: keyword
+      normalizer: keyword_normalized
+    # recipient: #DELETED
+    #   type: nested
+    #   properties:
+    #     name:
+    #       type: keyword
+    #       normalizer: keyword_normalized
+    #     id:
+    #       type: keyword
+    #       normalizer: keyword_normalized
+    #     role:
+    #       type: keyword
+    #       normalizer: keyword_normalized
+    spatial:
       type: nested
       properties:
+        role:
+          type: keyword
+          normalizer: keyword_normalized
+        name:
+          # display title for entire location
+          type: keyword
+          normalizer: keyword_normalized
+        description:
+          type: text
+          analyzer: english
         type:
           type: keyword
           normalizer: keyword_normalized
-        subject:
+        short_name:
+          # TODO copy into text?
           type: keyword
           normalizer: keyword_normalized
-        predicate:
+        coordinates:
+          type: geo_point
+        id:
           type: keyword
           normalizer: keyword_normalized
-        object:
+        city:
           type: keyword
           normalizer: keyword_normalized
-        source:
+        township:
+          type: keyword
+          normalizer: keyword_normalized
+        county:
+          type: keyword
+          normalizer: keyword_normalized
+        country:
+          type: keyword
+          normalizer: keyword_normalized
+        region:
+          type: keyword
+          normalizer: keyword_normalized
+        state:
+          type: keyword
+          normalizer: keyword_normalized
+        street:
           type: keyword
           normalizer: keyword_normalized
+        postal_code:
+          type: keyword
+          normalizer: keyword_normalized    
         note:
-          type: keyword  
+          type: keyword
           normalizer: keyword_normalized
-    recipient:
+    places: #DEPRECATED
+      type: keyword
+      normalizer: keyword_normalized
+    person:
       type: nested
       properties:
         name:
@@ -189,167 +312,102 @@ mappings:
         role:
           type: keyword
           normalizer: keyword_normalized
-    rights_holder:
-      type: keyword
-      normalizer: keyword_normalized
-    rights:
-      type: keyword
-      normalizer: keyword_normalized
-    rights_uri:
-      type: keyword
-      normalizer: keyword_normalized
-    spatial:
-      type: nested
-      properties:
-        # display title for entire location
-        title:
+        note:
           type: keyword
           normalizer: keyword_normalized
-        place_name:
-          # TODO copy into text?
+        order:
           type: keyword
           normalizer: keyword_normalized
-        coordinates:
-          type: geo_point
-        id:
+        birth_date:
           type: keyword
           normalizer: keyword_normalized
-        city:
+        death_date:
           type: keyword
           normalizer: keyword_normalized
-        county:
+        age_category:
           type: keyword
           normalizer: keyword_normalized
-        country:
+        name_last:
           type: keyword
           normalizer: keyword_normalized
-        region:
+        name_given:
           type: keyword
           normalizer: keyword_normalized
-        state:
+        name_alternate:
           type: keyword
           normalizer: keyword_normalized
-        street:
+        race:
           type: keyword
           normalizer: keyword_normalized
-        postal_code:
-          type: keyword
-          normalizer: keyword_normalized        
-        township:
+        sex:
           type: keyword
-          normalizer: keyword_normalized        
-        note:
+          normalizer: keyword_normalized
+        gender:
           type: keyword
           normalizer: keyword_normalized
-        role:
+        nationality:
           type: keyword
           normalizer: keyword_normalized
-        description:
+        trait1:
           type: keyword
           normalizer: keyword_normalized
-        type:
+        trait2:
           type: keyword
           normalizer: keyword_normalized
-    person:
+    event:
       type: nested
       properties:
-        name:
-          # TODO copy into text?
+        type:
           type: keyword
           normalizer: keyword_normalized
-        id:
+        agent:
           type: keyword
           normalizer: keyword_normalized
-        role:
+        factor:
           type: keyword
           normalizer: keyword_normalized
-    annotations_text:
-      type: text
-      analyzer: english
-    cdrhCategory1:
-      type: keyword
-      normalizer: keyword_normalized
-    cdrhCategory2:
-      type: keyword
-      normalizer: keyword_normalized
-    cdrhCategory3:
-      type: keyword
-      normalizer: keyword_normalized
-    cdrhCategory4:
-      type: keyword
-      normalizer: keyword_normalized
-    cdrhCategory5:
-      type: keyword
-      normalizer: keyword_normalized
-    cdrhNotes:
-      type: keyword
-      normalizer: keyword_normalized
-    cdrhTopics:
-      type: keyword
-      normalizer: keyword_normalized
-    cdrhKeywords1:
-      type: keyword
-      normalizer: keyword_normalized
-    cdrhKeywords2:
-      type: keyword
-      normalizer: keyword_normalized
-    cdrhKeywords3:
-      type: keyword
-      normalizer: keyword_normalized
-    cdrhKeywords4:
-      type: keyword
-      normalizer: keyword_normalized
-    people:
-      type: keyword
-      normalizer: keyword_normalized
-    # places: #DEPRECATED
-    #   type: keyword
-    #   normalizer: keyword_normalized
-    works:
-      type: keyword
-      normalizer: keyword_normalized
-    citation:
-      type: nested
-      properties:
-        role:
+        product:
           type: keyword
           normalizer: keyword_normalized
-        date:
-          type: date
-          format: "yyyy-MM-dd||epoch_millis"
-        publisher:
+        date_begin:
           type: keyword
           normalizer: keyword_normalized
-        issue:
+        date_end:
           type: keyword
           normalizer: keyword_normalized
-        page_begin:
+        trait1:
           type: keyword
           normalizer: keyword_normalized
-        page_end:
+        trait2:
           type: keyword
           normalizer: keyword_normalized
-        section:
+        notes:
           type: keyword
           normalizer: keyword_normalized
-        volume:
+    rdf:
+      type: nested
+      properties:
+        type:
           type: keyword
           normalizer: keyword_normalized
-        place:
+        subject:
           type: keyword
           normalizer: keyword_normalized
-        title_a:
+        predicate:
           type: keyword
           normalizer: keyword_normalized
-        title_m:
+        object:
           type: keyword
           normalizer: keyword_normalized
-        title_j:
+        source:
           type: keyword
           normalizer: keyword_normalized
-    date_created:
-      type: date
-      format: "yyyy-MM-dd||epoch_millis"
+        note:
+          type: keyword  
+          normalizer: keyword_normalized
+    annotations_text:
+      type: text
+      analyzer: english
     text:
       type: text
       analyzer: english

From e40a225f2439a66ef7318b4ba81e35d0c68925de Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Mon, 15 Aug 2022 15:29:25 -0500
Subject: [PATCH 076/128] assemble json based on api version

---
 lib/datura/to_es/es_request.rb | 154 +++++++++++++++++++++++++--------
 1 file changed, 120 insertions(+), 34 deletions(-)

diff --git a/lib/datura/to_es/es_request.rb b/lib/datura/to_es/es_request.rb
index 923f56f98..3b3ebe71e 100644
--- a/lib/datura/to_es/es_request.rb
+++ b/lib/datura/to_es/es_request.rb
@@ -19,29 +19,53 @@ def assemble_json
 
     # below not alphabetical to reflect their position
     # in the cdrh api schema
-
-    assemble_identifiers
-    assemble_categories
-    assemble_locations
-    assemble_descriptions    
-    assemble_other_metadata
-    assemble_dates
-    assemble_publishing
-    assemble_people
-    assemble_spatial
-    assemble_references
-    assemble_rdf
-    assemble_text
+    if @options["api_version"] == "1.0"
+      assemble_json_1
+    elsif @options["api_version"] == "2.0"
+      assemble_json_2
+    end
     assemble_collection_specific
-
+    assemble_text
     @json
   end
 
+  def assemble_json_1
+    #fields for API v 1.0
+    assemble_identifiers_1
+    assemble_categories_1
+    assemble_locations_1
+    assemble_descriptions_1    
+    assemble_other_metadata_1
+    assemble_dates_1
+    assemble_publishing_1
+    assemble_people_1
+    assemble_spatial_1
+    assemble_references_1
+    assemble_rdf_1
+    assemble_text_1
+  end
+
+  def assemble_json_2
+    #field for API v 2.0
+    assemble_identifiers_2
+    assemble_metadata_digital_2
+    assemble_metadata_original_2
+    assemble_metadata_interpretive_2
+    assemble_relations_2
+    assemble_additional_2
+    assemble_text_2
+  end
+
   ##############
   # components #
   ##############
+  def assemble_collection_specific
+    # add your own per collection
+    # with format
+    # @json["fieldname"] = field_contents
+  end
 
-  def assemble_categories
+  def assemble_categories_1
     @json["category"] = category
     @json["subcategory"] = subcategory
     @json["data_type"] = data_type
@@ -50,20 +74,14 @@ def assemble_categories
     @json["subjects"] = subjects
   end
 
-  def assemble_collection_specific
-    # add your own per collection
-    # with format
-    # @json["fieldname"] = field_contents
-  end
-
-  def assemble_dates
+  def assemble_dates_1
     @json["date"] = date
     @json["date_not_after"] = date_not_after
     @json["date_not_before"] = date_not_before
     @json["date_display"] = date_display
   end
 
-  def assemble_descriptions
+  def assemble_descriptions_1
     @json["alternative"] = alternative
     @json["description"] = description
     @json["title"] = title
@@ -71,18 +89,18 @@ def assemble_descriptions
     @json["topics"] = topics
   end
 
-  def assemble_identifiers
+  def assemble_identifiers_1
     @json["identifier"] = @id
   end
 
-  def assemble_locations
+  def assemble_locations_1
     @json["uri"] = uri
     @json["uri_data"] = uri_data
     @json["uri_html"] = uri_html
     @json["image_id"] = image_id
   end
 
-  def assemble_other_metadata
+  def assemble_other_metadata_1
     @json["format"] = format
     @json["language"] = language
     @json["languages"] = languages
@@ -92,7 +110,7 @@ def assemble_other_metadata
     @json["medium"] = medium
   end
 
-  def assemble_people
+  def assemble_people_1
     # container fields
     @json["person"] = person
     @json["contributor"] = contributor
@@ -100,7 +118,7 @@ def assemble_people
     @json["recipient"] = recipient
   end
 
-  def assemble_publishing
+  def assemble_publishing_1
     @json["publisher"] = publisher
     @json["rights"] = rights
     @json["rights_uri"] = rights_uri
@@ -108,26 +126,94 @@ def assemble_publishing
     @json["source"] = source
   end
 
-  def assemble_references
+  def assemble_references_1
     @json["keywords"] = keywords
     @json["places"] = places
     @json["works"] = works
   end
 
-  def assemble_spatial
+  def assemble_spatial_1
     @json["spatial"] = spatial
   end
 
-  def assemble_rdf
+  def assemble_rdf_1
+    @json["rdf"] = rdf
+  end
+  
+  def assemble_identifiers_2
+    @json["identifier"] = @id # does this still work?
+    @json["collection"] = collection
+    @json["collection_desc"] = collection_desc
+    @json["uri"] = uri
+    @json["uri_data"] = uri_data
+    @json["uri_html"] = uri_html
+    @json["data_type"] = data_type
+    @json["fig_location"] = fig_location
+    @json["cover_image"] = cover_image
+    @json["title"] = title
+    @json["title_sort"] = title_sort
+    @json["alternative"] = alternative
+    @json["date_updated"] = date_updated
+    @json["category"] = category
+    @json["category2"] = category2
+    @json["category3"] = category3
+    @json["category4"] = category4
+    @json["category5"] = category5
+    @json["notes"] = notes
+  end
+
+  def assemble_metadata_digital_2
+    @json["contributor"] = contributor
+  end
+
+  def assemble_metadata_original_2
+    @json["creator"] = creator
+    @json["citation"] = citation
+    @json["date"] = date
+    @json["date_display"] = date_display
+    @json["date_not_before"] = date_not_before
+    @json["date_not_after"] = date_not_after
+    @json["format"] = format
+    @json["medium"] = medium
+    @json["extent"] = extent
+    @json["language"] = language
+    @json["rights_holder"] = rights_holder
+    @json["rights"] = rights
+    @json["rights_uri"] = rights_uri
+  end
+
+  def assemble_metadata_interpretive_2
+    @json["subjects"] = subjects
+    @json["abstract"] = abstract
+    @json["description"] = description
+    @json["type"] = type
+    @json["topics"] = topics
+    @json["keywords"] = keywords
+    @json["keywords2"] = keywords2
+    @json["keywords3"] = keywords3
+    @json["keywords4"] = keywords4
+  end
+
+  def assemble_relations_2
+    @json["relation"] = relation
+    @json["source"] = source
+    @json["has_part"] = has_part
+    @json["is_part_of"] = is_part_of
+    @json["previous"] = previous
+    @json["next"] = next
+  end
+
+  def assemble_additional_2
+    @json["spatial"] = spatial
+    @json["places"] = places
+    @json["person"] = person
+    @json["event"] = event
     @json["rdf"] = rdf
   end
 
   def assemble_text
     @json["annotations_text"] = annotations_text
     @json["text"] = text
-    # @json["abstract"]
   end
 
-  
-
 end

From bfe1ca6d08cf194b8f4d7fcea0f4f64391fa184f Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Mon, 15 Aug 2022 15:39:17 -0500
Subject: [PATCH 077/128] add overrides for 2.0 fields

---
 lib/datura/to_es/csv_to_es/fields.rb  | 61 ++++++++++++++++++++--
 lib/datura/to_es/html_to_es/fields.rb | 74 +++++++++++++++++++++++++--
 lib/datura/to_es/tei_to_es/fields.rb  | 70 +++++++++++++++++++++++++
 lib/datura/to_es/vra_to_es/fields.rb  | 70 +++++++++++++++++++++++++
 lib/datura/to_es/webs_to_es/fields.rb | 71 +++++++++++++++++++++++++
 5 files changed, 338 insertions(+), 8 deletions(-)

diff --git a/lib/datura/to_es/csv_to_es/fields.rb b/lib/datura/to_es/csv_to_es/fields.rb
index 1b649eb2a..2f669fa86 100644
--- a/lib/datura/to_es/csv_to_es/fields.rb
+++ b/lib/datura/to_es/csv_to_es/fields.rb
@@ -5,6 +5,8 @@ class CsvToEs
   ##########
   # FIELDS #
   ##########
+  # beginning with fields from API 1.0, including those that are unchanged in 2.0
+
   def id
     @id
   end
@@ -139,10 +141,6 @@ def recipient
     end
   end
 
-  # nested field
-  def rdf
-  end
-
   def relation
     @row["relation"]
   end
@@ -245,4 +243,59 @@ def works
     end
   end
 
+  # new/moved fields for API 2.0
+
+  def cover_image
+    @row["image_id"]
+  end
+
+  def date_updated
+  end
+
+  def category2
+    @row["subcategory"]
+  end
+
+  def category3
+  end
+
+  def category4
+  end
+
+  def category5
+  end
+
+  def notes
+  end
+
+  def citation
+  end
+
+  def keywords2
+  end
+
+  def keywords3
+  end
+
+  def keywords4
+  end
+
+  def has_part
+  end
+
+  def is_part_of
+  end
+
+  def previous_item
+  end
+
+  def next_item
+  end
+
+  def event
+  end
+  
+  def rdf
+  end
+
 end
diff --git a/lib/datura/to_es/html_to_es/fields.rb b/lib/datura/to_es/html_to_es/fields.rb
index 4b70303de..f1b062824 100644
--- a/lib/datura/to_es/html_to_es/fields.rb
+++ b/lib/datura/to_es/html_to_es/fields.rb
@@ -111,10 +111,6 @@ def publisher
     get_text(@xpaths["publisher"])
   end
 
-  # nested field
-  def rdf
-  end
-
   # nested field
   def recipient
   end
@@ -222,4 +218,74 @@ def works
     get_list(@xpaths["works"])
   end
 
+  # new/moved fields for API 2.0
+
+  def cover_image
+    get_list(@xpaths["image_id"]).first
+  end
+
+  def date_updated
+    get_list(@xpaths["date_updated"])
+  end
+
+  def category2
+    get_list(@xpaths["subcategory"])
+  end
+
+  def category3
+    get_text(@xpaths["category3"])
+  end
+
+  def category4
+    get_text(@xpaths["category4"])
+  end
+
+  def category5
+    get_text(@xpaths["category5"])
+  end
+
+  def notes
+    get_text(@xpaths["notes"])
+  end
+
+  def citation
+    # nested
+  end
+
+  def keywords2
+    get_text(@xpaths["keywords2"])
+  end
+
+  def keywords3
+    get_text(@xpaths["keywords3"])
+  end
+
+  def keywords4
+    get_text(@xpaths["keywords4"])
+  end
+
+  def has_part
+    # nested
+  end
+
+  def is_part_of
+    # nested
+  end
+
+  def previous_item
+    # nested
+  end
+
+  def next_item
+    # nested
+  end
+
+  def event
+    # nested
+  end
+  
+  def rdf
+    # nested
+  end
+
 end
diff --git a/lib/datura/to_es/tei_to_es/fields.rb b/lib/datura/to_es/tei_to_es/fields.rb
index f78b044f2..bd351c004 100644
--- a/lib/datura/to_es/tei_to_es/fields.rb
+++ b/lib/datura/to_es/tei_to_es/fields.rb
@@ -255,6 +255,76 @@ def works
     get_list(@xpaths["works"])
   end
 
+  # new/moved fields for API 2.0
+
+  def cover_image
+    get_list(@xpaths["image_id"]).first
+  end
+
+  def date_updated
+    get_list(@xpaths["date_updated"])
+  end
+
+  def category2
+    get_list(@xpaths["subcategory"])
+  end
+
+  def category3
+    get_text(@xpaths["category3"])
+  end
+
+  def category4
+    get_text(@xpaths["category4"])
+  end
+
+  def category5
+    get_text(@xpaths["category5"])
+  end
+
+  def notes
+    get_text(@xpaths["notes"])
+  end
+
+  def citation
+    # nested
+  end
+
+  def keywords2
+    get_text(@xpaths["keywords2"])
+  end
+
+  def keywords3
+    get_text(@xpaths["keywords3"])
+  end
+
+  def keywords4
+    get_text(@xpaths["keywords4"])
+  end
+
+  def has_part
+    # nested
+  end
+
+  def is_part_of
+    # nested
+  end
+
+  def previous_item
+    # nested
+  end
+
+  def next_item
+    # nested
+  end
+
+  def event
+    # nested
+  end
+  
+  def rdf
+    # nested
+  end
+
   protected
 
   # default behavior is simply to comma delineate fields
diff --git a/lib/datura/to_es/vra_to_es/fields.rb b/lib/datura/to_es/vra_to_es/fields.rb
index 233778287..c2cb61c8a 100644
--- a/lib/datura/to_es/vra_to_es/fields.rb
+++ b/lib/datura/to_es/vra_to_es/fields.rb
@@ -255,4 +255,74 @@ def uri_html
   def works
     get_list(@xpaths["works"])
   end
+
+  # new/moved fields for API 2.0
+
+  def cover_image
+    get_list(@xpaths["image_id"]).first
+  end
+
+  def date_updated
+    get_list(@xpaths["date_updated"])
+  end
+
+  def category2
+    get_list(@xpaths["subcategory"])
+  end
+
+  def category3
+    get_text(@xpaths["category3"])
+  end
+
+  def category4
+    get_text(@xpaths["category4"])
+  end
+
+  def category5
+    get_text(@xpaths["category5"])
+  end
+
+  def notes
+    get_text(@xpaths["notes"])
+  end
+
+  def citation
+    # nested
+  end
+
+  def keywords2
+    get_text(@xpaths["keywords2"])
+  end
+
+  def keywords3
+    get_text(@xpaths["keywords3"])
+  end
+
+  def keywords4
+    get_text(@xpaths["keywords4"])
+  end
+
+  def has_part
+    # nested
+  end
+
+  def is_part_of
+    # nested
+  end
+
+  def previous_item
+    # nested
+  end
+
+  def next_item
+    # nested
+  end
+
+  def event
+    # nested
+  end
+  
+  def rdf
+    # nested
+  end
 end
diff --git a/lib/datura/to_es/webs_to_es/fields.rb b/lib/datura/to_es/webs_to_es/fields.rb
index 993813f63..5997b90d9 100644
--- a/lib/datura/to_es/webs_to_es/fields.rb
+++ b/lib/datura/to_es/webs_to_es/fields.rb
@@ -214,4 +214,75 @@ def uri_html
   def works
     get_list(@xpaths["works"])
   end
+
+  # new/moved fields for API 2.0
+
+  def cover_image
+    get_list(@xpaths["image_id"]).first
+  end
+
+  def date_updated
+    get_list(@xpaths["date_updated"])
+  end
+
+  def category2
+    get_list(@xpaths["subcategory"])
+  end
+
+  def category3
+    get_text(@xpaths["category3"])
+  end
+
+  def category4
+    get_text(@xpaths["category4"])
+  end
+
+  def category5
+    get_text(@xpaths["category5"])
+  end
+
+  def notes
+    get_text(@xpaths["notes"])
+  end
+
+  def citation
+    # nested
+  end
+
+  def keywords2
+    get_text(@xpaths["keywords2"])
+  end
+
+  def keywords3
+    get_text(@xpaths["keywords3"])
+  end
+
+  def keywords4
+    get_text(@xpaths["keywords4"])
+  end
+
+  def has_part
+    # nested
+  end
+
+  def is_part_of
+    # nested
+  end
+
+  def previous_item
+    # nested
+  end
+
+  def next_item
+    # nested
+  end
+
+  def event
+    # nested
+  end
+  
+  def rdf
+    # nested
+  end
+
 end

From 9c8bc724b7f372de89a9826fa18f58337222f60b Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Mon, 15 Aug 2022 16:09:26 -0500
Subject: [PATCH 078/128] change next and previous fields

---
 lib/datura/to_es/es_request.rb | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/datura/to_es/es_request.rb b/lib/datura/to_es/es_request.rb
index 3b3ebe71e..ff28f6cba 100644
--- a/lib/datura/to_es/es_request.rb
+++ b/lib/datura/to_es/es_request.rb
@@ -139,7 +139,7 @@ def assemble_spatial_1
   def assemble_rdf_1
     @json["rdf"] = rdf
   end
-  
+
   def assemble_identifiers_2
     @json["identifier"] = @id # does this still work?
     @json["collection"] = collection
@@ -199,8 +199,8 @@ def assemble_relations_2
     @json["source"] = source
     @json["has_part"] = has_part
     @json["is_part_of"] = is_part_of
-    @json["previous"] = previous
-    @json["next"] = next
+    @json["previous_item"] = previous_item
+    @json["next_item"] = next_item
   end
 
   def assemble_additional_2

From 9577bf39d952170dae4ac689b6b8deb58cd32899 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Mon, 15 Aug 2022 16:13:49 -0500
Subject: [PATCH 079/128] add fig_location

---
 lib/datura/to_es/csv_to_es/fields.rb  | 3 +++
 lib/datura/to_es/html_to_es/fields.rb | 4 ++++
 lib/datura/to_es/tei_to_es/fields.rb  | 4 ++++
 lib/datura/to_es/vra_to_es/fields.rb  | 4 ++++
 lib/datura/to_es/webs_to_es/fields.rb | 4 ++++
 5 files changed, 19 insertions(+)

diff --git a/lib/datura/to_es/csv_to_es/fields.rb b/lib/datura/to_es/csv_to_es/fields.rb
index 2f669fa86..b639954d8 100644
--- a/lib/datura/to_es/csv_to_es/fields.rb
+++ b/lib/datura/to_es/csv_to_es/fields.rb
@@ -252,6 +252,9 @@ def cover_image
   def date_updated
   end
 
+  def fig_location
+  end
+
   def category2
     @row["subcategory"]
   end
diff --git a/lib/datura/to_es/html_to_es/fields.rb b/lib/datura/to_es/html_to_es/fields.rb
index f1b062824..cb74c7ad3 100644
--- a/lib/datura/to_es/html_to_es/fields.rb
+++ b/lib/datura/to_es/html_to_es/fields.rb
@@ -228,6 +228,10 @@ def date_updated
     get_list(@xpaths["date_updated"])
   end
 
+  def fig_location
+    get_list(@xpaths["fig_location"])
+  end
+
   def category2
     get_list(@xpaths["subcategory"])
   end
diff --git a/lib/datura/to_es/tei_to_es/fields.rb b/lib/datura/to_es/tei_to_es/fields.rb
index bd351c004..2cc23db01 100644
--- a/lib/datura/to_es/tei_to_es/fields.rb
+++ b/lib/datura/to_es/tei_to_es/fields.rb
@@ -265,6 +265,10 @@ def date_updated
     get_list(@xpaths["date_updated"])
   end
 
+  def fig_location
+    get_list(@xpaths["fig_location"])
+  end
+
   def category2
     get_list(@xpaths["subcategory"])
   end
diff --git a/lib/datura/to_es/vra_to_es/fields.rb b/lib/datura/to_es/vra_to_es/fields.rb
index c2cb61c8a..8d3e5e65b 100644
--- a/lib/datura/to_es/vra_to_es/fields.rb
+++ b/lib/datura/to_es/vra_to_es/fields.rb
@@ -266,6 +266,10 @@ def date_updated
     get_list(@xpaths["date_updated"])
   end
 
+  def fig_location
+    get_list(@xpaths["fig_location"])
+  end
+
   def category2
     get_list(@xpaths["subcategory"])
   end
diff --git a/lib/datura/to_es/webs_to_es/fields.rb b/lib/datura/to_es/webs_to_es/fields.rb
index 5997b90d9..4fb7a42b6 100644
--- a/lib/datura/to_es/webs_to_es/fields.rb
+++ b/lib/datura/to_es/webs_to_es/fields.rb
@@ -225,6 +225,10 @@ def date_updated
     get_list(@xpaths["date_updated"])
   end
 
+  def fig_location
+    get_list(@xpaths["fig_location"])
+  end
+
   def category2
     get_list(@xpaths["subcategory"])
   end

From 3bd2eebbad94cd266da9b6bd4d2e414746591e8a Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Mon, 15 Aug 2022 16:20:11 -0500
Subject: [PATCH 080/128] add abstract

---
 lib/datura/to_es/csv_to_es/fields.rb  | 3 +++
 lib/datura/to_es/html_to_es/fields.rb | 4 ++++
 lib/datura/to_es/tei_to_es/fields.rb  | 4 ++++
 lib/datura/to_es/vra_to_es/fields.rb  | 4 ++++
 lib/datura/to_es/webs_to_es/fields.rb | 4 ++++
 5 files changed, 19 insertions(+)

diff --git a/lib/datura/to_es/csv_to_es/fields.rb b/lib/datura/to_es/csv_to_es/fields.rb
index b639954d8..1a626f2ee 100644
--- a/lib/datura/to_es/csv_to_es/fields.rb
+++ b/lib/datura/to_es/csv_to_es/fields.rb
@@ -274,6 +274,9 @@ def notes
   def citation
   end
 
+  def abstract
+  end
+
   def keywords2
   end
 
diff --git a/lib/datura/to_es/html_to_es/fields.rb b/lib/datura/to_es/html_to_es/fields.rb
index cb74c7ad3..3998a6400 100644
--- a/lib/datura/to_es/html_to_es/fields.rb
+++ b/lib/datura/to_es/html_to_es/fields.rb
@@ -256,6 +256,10 @@ def citation
     # nested
   end
 
+  def abstract
+    get_text(@xpaths["abstract"])
+  end
+
   def keywords2
     get_text(@xpaths["keywords2"])
   end
diff --git a/lib/datura/to_es/tei_to_es/fields.rb b/lib/datura/to_es/tei_to_es/fields.rb
index 2cc23db01..2fe1cdeb9 100644
--- a/lib/datura/to_es/tei_to_es/fields.rb
+++ b/lib/datura/to_es/tei_to_es/fields.rb
@@ -293,6 +293,10 @@ def citation
     # nested
   end
 
+  def abstract
+    get_text(@xpaths["abstract"])
+  end
+
   def keywords2
     get_text(@xpaths["keywords2"])
   end
diff --git a/lib/datura/to_es/vra_to_es/fields.rb b/lib/datura/to_es/vra_to_es/fields.rb
index 8d3e5e65b..824ae685a 100644
--- a/lib/datura/to_es/vra_to_es/fields.rb
+++ b/lib/datura/to_es/vra_to_es/fields.rb
@@ -294,6 +294,10 @@ def citation
     # nested
   end
 
+  def abstract
+    get_text(@xpaths["abstract"])
+  end
+
   def keywords2
     get_text(@xpaths["keywords2"])
   end
diff --git a/lib/datura/to_es/webs_to_es/fields.rb b/lib/datura/to_es/webs_to_es/fields.rb
index 4fb7a42b6..44a49af96 100644
--- a/lib/datura/to_es/webs_to_es/fields.rb
+++ b/lib/datura/to_es/webs_to_es/fields.rb
@@ -253,6 +253,10 @@ def citation
     # nested
   end
 
+  def abstract
+    get_text(@xpaths["abstract"])
+  end
+
   def keywords2
     get_text(@xpaths["keywords2"])
   end

From d30f76b4220a7e2614f7fb4c3948dd53fdf019ca Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Mon, 15 Aug 2022 16:36:02 -0500
Subject: [PATCH 081/128] remove split-out assemble_text methods

---
 lib/datura/to_es/es_request.rb | 2 --
 1 file changed, 2 deletions(-)

diff --git a/lib/datura/to_es/es_request.rb b/lib/datura/to_es/es_request.rb
index ff28f6cba..245b31a88 100644
--- a/lib/datura/to_es/es_request.rb
+++ b/lib/datura/to_es/es_request.rb
@@ -42,7 +42,6 @@ def assemble_json_1
     assemble_spatial_1
     assemble_references_1
     assemble_rdf_1
-    assemble_text_1
   end
 
   def assemble_json_2
@@ -53,7 +52,6 @@ def assemble_json_2
     assemble_metadata_interpretive_2
     assemble_relations_2
     assemble_additional_2
-    assemble_text_2
   end
 
   ##############

From 48e316e5230e67ba8360be0c6403dfc539892d97 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Wed, 24 Aug 2022 15:42:56 -0500
Subject: [PATCH 082/128] update gems and get rid of merge conflicts

---
 Gemfile.lock | 21 ++++++---------------
 1 file changed, 6 insertions(+), 15 deletions(-)

diff --git a/Gemfile.lock b/Gemfile.lock
index a20379abd..d5512b234 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -13,38 +13,29 @@ GEM
     colorize (0.8.1)
     domain_name (0.5.20190701)
       unf (>= 0.0.5, < 1.0.0)
-<<<<<<< HEAD
-<<<<<<< HEAD
-    http-cookie (1.0.5)
-=======
     http-accept (1.7.0)
-    http-cookie (1.0.3)
->>>>>>> 4d02bee88 (updates gems and fixes test suite)
-=======
     http-cookie (1.0.5)
->>>>>>> deb1664b2 (update gems in preparation for release)
       domain_name (~> 0.5)
     mime-types (3.4.1)
       mime-types-data (~> 3.2015)
     mime-types-data (3.2022.0105)
-    mini_portile2 (2.8.0)
-    minitest (5.15.0)
+    minitest (5.16.3)
     netrc (0.11.0)
-    nokogiri (1.13.6)
-      mini_portile2 (~> 2.8.0)
+    nokogiri (1.13.8-x86_64-darwin)
       racc (~> 1.4)
     racc (1.6.0)
     rake (13.0.6)
     rest-client (2.1.0)
       http-accept (>= 1.7.0, < 2.0)
+      http-cookie (>= 1.0.2, < 2.0)
       mime-types (>= 1.16, < 4.0)
       netrc (~> 0.8)
     unf (0.1.4)
       unf_ext
-    unf_ext (0.0.8.1)
+    unf_ext (0.0.8.2)
 
 PLATFORMS
-  ruby
+  x86_64-darwin-20
 
 DEPENDENCIES
   bundler (>= 1.16.0, < 3.0)
@@ -54,4 +45,4 @@ DEPENDENCIES
   rake (~> 13.0)
 
 BUNDLED WITH
-   2.1.4
+   2.2.26

From c9d8730c5cc9fbe2ff64a7065090059fb46d796f Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Wed, 24 Aug 2022 15:56:30 -0500
Subject: [PATCH 083/128] add new fields

---
 lib/config/es_api_schemas/2.0.yml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/lib/config/es_api_schemas/2.0.yml b/lib/config/es_api_schemas/2.0.yml
index e744f7bdc..bc56e4ac3 100644
--- a/lib/config/es_api_schemas/2.0.yml
+++ b/lib/config/es_api_schemas/2.0.yml
@@ -192,6 +192,12 @@ mappings:
     rights_uri:
       type: keyword
       normalizer: keyword_normalized
+    container_box:
+      type: keyword
+      normalizer: keyword_normalized
+    container_field:
+      type: keyword
+      normalizer: keyword_normalized
     subjects:
       type: keyword
       normalizer: keyword_normalized
@@ -336,6 +342,9 @@ mappings:
         name_alternate:
           type: keyword
           normalizer: keyword_normalized
+        name_previous:
+          type: keyword
+          normalizer: keyword_normalized
         race:
           type: keyword
           normalizer: keyword_normalized

From 96d419995f07e7cffe7f42898ae8ef6f9e97f01f Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Wed, 24 Aug 2022 16:15:51 -0500
Subject: [PATCH 084/128] correct field name

---
 lib/config/es_api_schemas/2.0.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/config/es_api_schemas/2.0.yml b/lib/config/es_api_schemas/2.0.yml
index bc56e4ac3..cdff6ffc7 100644
--- a/lib/config/es_api_schemas/2.0.yml
+++ b/lib/config/es_api_schemas/2.0.yml
@@ -195,7 +195,7 @@ mappings:
     container_box:
       type: keyword
       normalizer: keyword_normalized
-    container_field:
+    container_folder:
       type: keyword
       normalizer: keyword_normalized
     subjects:

From a3bbc140a62ffa91f911180618b5ff94d8f963ff Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Wed, 24 Aug 2022 16:16:38 -0500
Subject: [PATCH 085/128] add fields to ead overrides

---
 lib/datura/to_es/ead_to_es/fields.rb | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/lib/datura/to_es/ead_to_es/fields.rb b/lib/datura/to_es/ead_to_es/fields.rb
index f5599c97a..15cb7c9dc 100644
--- a/lib/datura/to_es/ead_to_es/fields.rb
+++ b/lib/datura/to_es/ead_to_es/fields.rb
@@ -50,6 +50,12 @@ def collection_desc
     @options["collection_desc"] || @options["collection"]
   end
 
+  def container_box
+  end
+
+  def container_folder
+  end
+
   def contributor
     # contribs = []
     # @xpaths["contributors"].each do |xpath|

From 75651f723580d5c175c85bfb17ec28e8c020dfbc Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Wed, 24 Aug 2022 16:23:39 -0500
Subject: [PATCH 086/128] populate new fields in json

---
 lib/datura/to_es/es_request.rb | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/lib/datura/to_es/es_request.rb b/lib/datura/to_es/es_request.rb
index 245b31a88..6b7f42382 100644
--- a/lib/datura/to_es/es_request.rb
+++ b/lib/datura/to_es/es_request.rb
@@ -178,6 +178,8 @@ def assemble_metadata_original_2
     @json["rights_holder"] = rights_holder
     @json["rights"] = rights
     @json["rights_uri"] = rights_uri
+    @json["container_box"] = container_box
+    @json["container_folder"] = container_folder
   end
 
   def assemble_metadata_interpretive_2

From f49f776ebf5734c13b0895b6c71a53bd3d0bb53a Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Wed, 24 Aug 2022 16:32:35 -0500
Subject: [PATCH 087/128] resolve merge conflict

---
 lib/datura/elasticsearch/alias.rb | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/lib/datura/elasticsearch/alias.rb b/lib/datura/elasticsearch/alias.rb
index adf1c5cf1..177ee14d1 100644
--- a/lib/datura/elasticsearch/alias.rb
+++ b/lib/datura/elasticsearch/alias.rb
@@ -6,11 +6,7 @@
 module Datura::Elasticsearch::Alias
 
   def self.add
-<<<<<<< HEAD
-    params = Datura::Parser.es_alias
-=======
     params = Datura::Parser.es_alias_add
->>>>>>> 01ed9e56d (moves code out of bin elasticsearch files and into module)
     options = Datura::Options.new(params).all
 
     ali = options["alias"]

From 91c79d6751d15bcdc0f95d9f63da655337fc4594 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Thu, 25 Aug 2022 08:59:07 -0500
Subject: [PATCH 088/128] add new fields

---
 lib/datura/to_es/csv_to_es/fields.rb  | 6 ++++++
 lib/datura/to_es/html_to_es/fields.rb | 6 ++++++
 lib/datura/to_es/tei_to_es/fields.rb  | 6 ++++++
 lib/datura/to_es/vra_to_es/fields.rb  | 6 ++++++
 lib/datura/to_es/webs_to_es/fields.rb | 6 ++++++
 5 files changed, 30 insertions(+)

diff --git a/lib/datura/to_es/csv_to_es/fields.rb b/lib/datura/to_es/csv_to_es/fields.rb
index 1a626f2ee..50c7efc81 100644
--- a/lib/datura/to_es/csv_to_es/fields.rb
+++ b/lib/datura/to_es/csv_to_es/fields.rb
@@ -39,6 +39,12 @@ def collection
   def collection_desc
     @options["collection_desc"] || @options["collection"]
   end
+  
+  def container_box
+  end
+
+  def container_folder
+  end
 
   # nested field
   def contributor
diff --git a/lib/datura/to_es/html_to_es/fields.rb b/lib/datura/to_es/html_to_es/fields.rb
index 3998a6400..886c1bd7d 100644
--- a/lib/datura/to_es/html_to_es/fields.rb
+++ b/lib/datura/to_es/html_to_es/fields.rb
@@ -256,6 +256,12 @@ def citation
     # nested
   end
 
+  def container_box
+  end
+
+  def container_folder
+  end
+
   def abstract
     get_text(@xpaths["abstract"])
   end
diff --git a/lib/datura/to_es/tei_to_es/fields.rb b/lib/datura/to_es/tei_to_es/fields.rb
index 2fe1cdeb9..4826635a3 100644
--- a/lib/datura/to_es/tei_to_es/fields.rb
+++ b/lib/datura/to_es/tei_to_es/fields.rb
@@ -293,6 +293,12 @@ def citation
     # nested
   end
 
+  def container_box
+  end
+
+  def container_folder
+  end
+
   def abstract
     get_text(@xpaths["abstract"])
   end
diff --git a/lib/datura/to_es/vra_to_es/fields.rb b/lib/datura/to_es/vra_to_es/fields.rb
index 824ae685a..c65dda8db 100644
--- a/lib/datura/to_es/vra_to_es/fields.rb
+++ b/lib/datura/to_es/vra_to_es/fields.rb
@@ -294,6 +294,12 @@ def citation
     # nested
   end
 
+  def container_box
+  end
+
+  def container_folder
+  end
+
   def abstract
     get_text(@xpaths["abstract"])
   end
diff --git a/lib/datura/to_es/webs_to_es/fields.rb b/lib/datura/to_es/webs_to_es/fields.rb
index 44a49af96..3163706be 100644
--- a/lib/datura/to_es/webs_to_es/fields.rb
+++ b/lib/datura/to_es/webs_to_es/fields.rb
@@ -245,6 +245,12 @@ def category5
     get_text(@xpaths["category5"])
   end
 
+  def container_box
+  end
+
+  def container_folder
+  end
+
   def notes
     get_text(@xpaths["notes"])
   end

From 95c6a2974e9d400d15db0fb89209addb235fbbfc Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Thu, 25 Aug 2022 13:33:03 -0500
Subject: [PATCH 089/128] update fields for related items, dates, order
 integers

---
 lib/config/es_api_schemas/2.0.yml | 79 +++++++++++++++++++++++++------
 1 file changed, 64 insertions(+), 15 deletions(-)

diff --git a/lib/config/es_api_schemas/2.0.yml b/lib/config/es_api_schemas/2.0.yml
index cdff6ffc7..d8ce637a3 100644
--- a/lib/config/es_api_schemas/2.0.yml
+++ b/lib/config/es_api_schemas/2.0.yml
@@ -75,7 +75,7 @@ mappings:
     date_updated:
       type: date
       format: "yyyy-MM-dd||epoch_millis"
-    category1:
+    category:
       type: keyword
       normalizer: keyword_normalized
     category2:
@@ -234,11 +234,61 @@ mappings:
       type: keyword
       normalizer: keyword_normalized
     has_part:
-      type: keyword
-      normalizer: keyword_normalized
+      type: nested
+      properties: 
+        role: keyword
+          type: keyword
+          normalizer: keyword_normalized
+        id: keyword
+          type: keyword
+          normalizer: keyword_normalized
+        title: keyword
+          type: keyword
+          normalizer: keyword_normalized
+        order:
+          type: integer
     is_part_of:
-      type: keyword
-      normalizer: keyword_normalized
+      type: nested
+      properties: 
+        role: keyword
+          type: keyword
+          normalizer: keyword_normalized
+        id: keyword
+          type: keyword
+          normalizer: keyword_normalized
+        title: keyword
+          type: keyword
+          normalizer: keyword_normalized
+        order:
+          type: integer
+    previous_item:
+      type: nested
+      properties: 
+        role: keyword
+          type: keyword
+          normalizer: keyword_normalized
+        id: keyword
+          type: keyword
+          normalizer: keyword_normalized
+        title: keyword
+          type: keyword
+          normalizer: keyword_normalized
+        order:
+          type: integer
+    next_item:
+      type: nested
+      properties: 
+        role: keyword
+          type: keyword
+          normalizer: keyword_normalized
+        id: keyword
+          type: keyword
+          normalizer: keyword_normalized
+        title: keyword
+          type: keyword
+          normalizer: keyword_normalized
+        order:
+          type: integer
     # recipient: #DELETED
     #   type: nested
     #   properties:
@@ -322,14 +372,13 @@ mappings:
           type: keyword
           normalizer: keyword_normalized
         order:
-          type: keyword
-          normalizer: keyword_normalized
+          type: integer
         birth_date:
-          type: keyword
-          normalizer: keyword_normalized
+          type: date
+          format: "yyyy-MM-dd||epoch_millis"
         death_date:
-          type: keyword
-          normalizer: keyword_normalized
+          type: date
+          format: "yyyy-MM-dd||epoch_millis"
         age_category:
           type: keyword
           normalizer: keyword_normalized
@@ -379,11 +428,11 @@ mappings:
           type: keyword
           normalizer: keyword_normalized
         date_begin:
-          type: keyword
-          normalizer: keyword_normalized
+          type: date
+          format: "yyyy-MM-dd||epoch_millis"
         date_end:
-          type: keyword
-          normalizer: keyword_normalized
+          type: date
+          format: "yyyy-MM-dd||epoch_millis"
         trait1:
           type: keyword
           normalizer: keyword_normalized

From 3c1ac53306d90703eeac46fde4f33290317a2cc5 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Thu, 25 Aug 2022 14:03:09 -0500
Subject: [PATCH 090/128] correct syntax errors

---
 lib/config/es_api_schemas/2.0.yml | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/lib/config/es_api_schemas/2.0.yml b/lib/config/es_api_schemas/2.0.yml
index d8ce637a3..93a804979 100644
--- a/lib/config/es_api_schemas/2.0.yml
+++ b/lib/config/es_api_schemas/2.0.yml
@@ -236,13 +236,13 @@ mappings:
     has_part:
       type: nested
       properties: 
-        role: keyword
+        role:
           type: keyword
           normalizer: keyword_normalized
-        id: keyword
+        id:
           type: keyword
           normalizer: keyword_normalized
-        title: keyword
+        title:
           type: keyword
           normalizer: keyword_normalized
         order:
@@ -250,13 +250,13 @@ mappings:
     is_part_of:
       type: nested
       properties: 
-        role: keyword
+        role:
           type: keyword
           normalizer: keyword_normalized
-        id: keyword
+        id:
           type: keyword
           normalizer: keyword_normalized
-        title: keyword
+        title:
           type: keyword
           normalizer: keyword_normalized
         order:
@@ -264,10 +264,10 @@ mappings:
     previous_item:
       type: nested
       properties: 
-        role: keyword
+        role:
           type: keyword
           normalizer: keyword_normalized
-        id: keyword
+        id:
           type: keyword
           normalizer: keyword_normalized
         title: keyword
@@ -278,13 +278,13 @@ mappings:
     next_item:
       type: nested
       properties: 
-        role: keyword
+        role:
           type: keyword
           normalizer: keyword_normalized
-        id: keyword
+        id:
           type: keyword
           normalizer: keyword_normalized
-        title: keyword
+        title:
           type: keyword
           normalizer: keyword_normalized
         order:

From 29f9bf2ce13c9db080eeec9cbcc74c9ccca64baa Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Thu, 25 Aug 2022 14:06:45 -0500
Subject: [PATCH 091/128] correct another syntax error

---
 lib/config/es_api_schemas/2.0.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/config/es_api_schemas/2.0.yml b/lib/config/es_api_schemas/2.0.yml
index 93a804979..95b9ebf16 100644
--- a/lib/config/es_api_schemas/2.0.yml
+++ b/lib/config/es_api_schemas/2.0.yml
@@ -270,7 +270,7 @@ mappings:
         id:
           type: keyword
           normalizer: keyword_normalized
-        title: keyword
+        title:
           type: keyword
           normalizer: keyword_normalized
         order:

From a70d4642b00bab4ba1128ce07a52ec82ce2d5e98 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Thu, 25 Aug 2022 15:51:20 -0500
Subject: [PATCH 092/128] change keywords1 to plain keywords

---
 lib/config/es_api_schemas/2.0.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/config/es_api_schemas/2.0.yml b/lib/config/es_api_schemas/2.0.yml
index 95b9ebf16..766dda287 100644
--- a/lib/config/es_api_schemas/2.0.yml
+++ b/lib/config/es_api_schemas/2.0.yml
@@ -215,7 +215,7 @@ mappings:
     topics:
       type: keyword
       normalizer: keyword_normalized
-    keywords1:
+    keywords:
       type: keyword
       normalizer: keyword_normalized
     keywords2:

From f7aa3dbe4c75dc34bdc7f9aa23f6e3e4984f04e1 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Tue, 30 Aug 2022 13:37:07 -0500
Subject: [PATCH 093/128] add more specific message to es validation

---
 lib/datura/elasticsearch/index.rb | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index f774e7278..cb8da9b84 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -136,7 +136,7 @@ def valid_document?(doc)
             if nested.keys.all? { |k| valid_field?(k, field) }
               next
             else
-              # if one of the nested hashes fails, it 
+              # if one of the nested hashes fails, it is invalid
               return false
             end
           end
@@ -144,6 +144,7 @@ def valid_document?(doc)
         # all nested fields passed, so it is valid
         true
       else
+        puts "Field '#{field}' is invalid"
         false
       end
     end

From ddb696046e5506f49b9baee0fc595de760fefec0 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Wed, 7 Sep 2022 11:33:50 -0500
Subject: [PATCH 094/128] remove extra byebug require

---
 lib/datura/data_manager.rb | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/lib/datura/data_manager.rb b/lib/datura/data_manager.rb
index d8c66936e..0b0ebae72 100644
--- a/lib/datura/data_manager.rb
+++ b/lib/datura/data_manager.rb
@@ -3,7 +3,7 @@
 require "yaml"
 require "byebug"
 require_relative "./requirer.rb"
-require "byebug"
+
 class Datura::DataManager
   attr_reader :log
   attr_reader :time
@@ -78,7 +78,6 @@ def run
     msg = options_msg
     @log.info(msg)
     puts msg
-
     pre_file_preparation
     @files = prepare_files
     pre_batch_processing

From b2ffb0c7f513106223de62036d55ea9f8ce2a643 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Wed, 7 Sep 2022 11:50:07 -0500
Subject: [PATCH 095/128] remove byebug, change error message

---
 lib/datura/file_type.rb | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/lib/datura/file_type.rb b/lib/datura/file_type.rb
index da92e7f85..c702457ce 100644
--- a/lib/datura/file_type.rb
+++ b/lib/datura/file_type.rb
@@ -70,7 +70,6 @@ def post_es(es)
           begin
             RestClient.put("#{es.index_url}/_doc/#{id}", doc.to_json, {:content_type => :json } )
           rescue => e
-            # byebug
             error = "Error transforming or posting to ES for #{self.filename(false)}: #{e.response}"
           end
         else
@@ -127,7 +126,7 @@ def transform_es
       # check if any xpaths hit before continuing
       results = file_xml.xpath(*subdoc_xpaths.keys)
       if results.length == 0
-        raise "No possible xpaths found fo file #{self.filename}, check if XML is valid or customize 'subdoc_xpaths' method"
+        raise "No possible xpaths found for file #{self.filename}, check if XML is valid or customize 'subdoc_xpaths' method"
       end
       
       subdoc_xpaths.each do |xpath, classname|

From 8008c9b3d2337ec4c67e4e815b3103becff487f4 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Wed, 7 Sep 2022 13:00:27 -0500
Subject: [PATCH 096/128] update schema under citations

---
 lib/config/es_api_schemas/2.0.yml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/lib/config/es_api_schemas/2.0.yml b/lib/config/es_api_schemas/2.0.yml
index 766dda287..f400161b2 100644
--- a/lib/config/es_api_schemas/2.0.yml
+++ b/lib/config/es_api_schemas/2.0.yml
@@ -126,13 +126,16 @@ mappings:
         date:
           type: date
           format: "yyyy-MM-dd||epoch_millis"
+        title:
+          type: keyword
+          normalizer: keyword_normalized
         publisher:
           type: keyword
           normalizer: keyword_normalized
         issue:
           type: keyword
           normalizer: keyword_normalized
-        page_begin:
+        page_start:
           type: keyword
           normalizer: keyword_normalized
         page_end:

From 7a7a0b1dc133a5177d05f9e178869f9cda80b213 Mon Sep 17 00:00:00 2001
From: wkdewey <william.dewey@unl.edu>
Date: Fri, 16 Sep 2022 14:32:35 -0500
Subject: [PATCH 097/128] require fileutils to avoid errors in setup

---
 bin/setup | 1 +
 1 file changed, 1 insertion(+)

diff --git a/bin/setup b/bin/setup
index 1a25e109c..45258adf1 100755
--- a/bin/setup
+++ b/bin/setup
@@ -1,6 +1,7 @@
 #!/usr/bin/env ruby
 
 require "colorize"
+require 'fileutils'
 
 coll = Dir.getwd
 

From e983197633ac44e1f6eedf8079750cf606df8ced Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Tue, 20 Sep 2022 10:55:06 -0500
Subject: [PATCH 098/128] skip title_sort if title is nil

---
 lib/datura/file_type.rb              | 1 -
 lib/datura/to_es/tei_to_es/fields.rb | 4 +++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/lib/datura/file_type.rb b/lib/datura/file_type.rb
index c702457ce..0526a7daf 100644
--- a/lib/datura/file_type.rb
+++ b/lib/datura/file_type.rb
@@ -128,7 +128,6 @@ def transform_es
       if results.length == 0
         raise "No possible xpaths found for file #{self.filename}, check if XML is valid or customize 'subdoc_xpaths' method"
       end
-      
       subdoc_xpaths.each do |xpath, classname|
         subdocs = file_xml.xpath(xpath)
         subdocs.each do |subdoc|
diff --git a/lib/datura/to_es/tei_to_es/fields.rb b/lib/datura/to_es/tei_to_es/fields.rb
index 4826635a3..0e1287428 100644
--- a/lib/datura/to_es/tei_to_es/fields.rb
+++ b/lib/datura/to_es/tei_to_es/fields.rb
@@ -213,7 +213,9 @@ def title
   end
 
   def title_sort
-    Datura::Helpers.normalize_name(title)
+    if title
+      Datura::Helpers.normalize_name(title)
+    end
   end
 
   def topics

From f12291b61aa45feba4f257fe3599142985df4ce4 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Fri, 23 Sep 2022 12:01:22 -0500
Subject: [PATCH 099/128] return nil instead of empty string, addresses
 https://github.com/whitmanarchive/whitman-issues/issues/157

---
 lib/datura/to_es/xml_to_es.rb | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/lib/datura/to_es/xml_to_es.rb b/lib/datura/to_es/xml_to_es.rb
index 8cf50029a..9c0072af7 100644
--- a/lib/datura/to_es/xml_to_es.rb
+++ b/lib/datura/to_es/xml_to_es.rb
@@ -92,6 +92,9 @@ def get_elements(*xpaths, xml: nil)
   def get_list(xpaths, keep_tags: false, xml: nil, sort: false)
     xpath_array = Array(xpaths)
     list = get_xpaths(xpath_array, keep_tags: keep_tags, xml: xml)
+    if !list || list.empty?
+      return nil
+    end
     sort ? list.sort : list
   end
 
@@ -103,6 +106,9 @@ def get_list(xpaths, keep_tags: false, xml: nil, sort: false)
   def get_text(xpaths, keep_tags: false, xml: nil, delimiter: ";", sort: false)
     # ensure all xpaths are an array before beginning
     list = get_list(xpaths, keep_tags: keep_tags, xml: xml, sort: sort)
+    if !list || list.empty?
+      return nil
+    end
     list.join("#{delimiter} ")
   end
 

From 974ab392798ca5fae31132fe3412659fc57e3ef1 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Mon, 26 Sep 2022 09:58:00 -0500
Subject: [PATCH 100/128] add more nil checks for results of xpath methods

---
 lib/datura/to_es/tei_to_es/fields.rb | 27 +++++++++++++++++++++------
 1 file changed, 21 insertions(+), 6 deletions(-)

diff --git a/lib/datura/to_es/tei_to_es/fields.rb b/lib/datura/to_es/tei_to_es/fields.rb
index 0e1287428..7ef94adb6 100644
--- a/lib/datura/to_es/tei_to_es/fields.rb
+++ b/lib/datura/to_es/tei_to_es/fields.rb
@@ -49,8 +49,14 @@ def data_type
   end
 
   def date(before=true)
-    datestr = get_list(@xpaths["date"]).first
-    Datura::Helpers.date_standardize(datestr, before)
+    if get_list(@xpaths["date"])
+      datestr = get_list(@xpaths["date"]).first
+    else
+      datestr = nil
+    end
+    if datestr && !datestr.empty?
+      Datura::Helpers.date_standardize(datestr, false)
+    end
   end
 
   def date_display
@@ -84,12 +90,16 @@ def extent
   end
 
   def format
-    get_list(@xpaths["format"]).first
+    if get_list(@xpaths["image_id"])
+      get_list(@xpaths["format"]).first
+    end
   end
 
   def image_id
     # Note: don't pull full path because will be pulled by IIIF
-    get_list(@xpaths["image_id"]).first
+    if get_list(@xpaths["image_id"])
+      get_list(@xpaths["image_id"]).first
+    end
   end
 
   def keywords
@@ -98,7 +108,9 @@ def keywords
 
   def language
     # uses the first language discovered in the document
-    get_list(@xpaths["language"]).first
+    if get_list(@xpaths["image_id"])
+      get_list(@xpaths["language"]).first
+    end
   end
 
   def languages
@@ -260,7 +272,9 @@ def works
   # new/moved fields for API 2.0
 
   def cover_image
-    get_list(@xpaths["image_id"]).first
+    if get_list(@xpaths["image_id"])
+      get_list(@xpaths["image_id"]).first
+    end
   end
 
   def date_updated
@@ -357,5 +371,6 @@ def source_to_s(f)
       .reject! { |value| value.nil? || value.strip.empty? }
       .join(", ")
   end
+  
 
 end

From 84d1a9ef9bf6075a8d35d60ab3864c36ef79a5ba Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Mon, 26 Sep 2022 11:43:37 -0500
Subject: [PATCH 101/128] check the correct xpath fields

---
 lib/datura/to_es/tei_to_es/fields.rb | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/datura/to_es/tei_to_es/fields.rb b/lib/datura/to_es/tei_to_es/fields.rb
index 7ef94adb6..100fff580 100644
--- a/lib/datura/to_es/tei_to_es/fields.rb
+++ b/lib/datura/to_es/tei_to_es/fields.rb
@@ -90,7 +90,7 @@ def extent
   end
 
   def format
-    if get_list(@xpaths["image_id"])
+    if get_list(@xpaths["format"])
       get_list(@xpaths["format"]).first
     end
   end
@@ -108,7 +108,7 @@ def keywords
 
   def language
     # uses the first language discovered in the document
-    if get_list(@xpaths["image_id"])
+    if get_list(@xpaths["language"])
       get_list(@xpaths["language"]).first
     end
   end

From ec81ddbfb973ec42a1cb19bf3145c0b2c7b47d99 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Mon, 26 Sep 2022 14:30:08 -0500
Subject: [PATCH 102/128] make sure input is in UTF-8

---
 lib/datura/helpers.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/datura/helpers.rb b/lib/datura/helpers.rb
index 831d148c3..ae2dc89f3 100644
--- a/lib/datura/helpers.rb
+++ b/lib/datura/helpers.rb
@@ -134,7 +134,7 @@ def self.normalize_name(abnormal)
   #   removes leading / trailing whitespace, newlines, repeating whitespace, etc
   def self.normalize_space(abnormal)
     if abnormal
-      normal = abnormal.strip.gsub(/\s+/, " ")
+      normal = abnormal.encode!('UTF-8', 'UTF-8', :invalid => :replace).strip.gsub(/\s+/, " ")
     end
     normal || abnormal
   end

From a3d2fbfe882252bb2a20e93fc8592d8b2fcac591 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Mon, 26 Sep 2022 14:30:57 -0500
Subject: [PATCH 103/128] make changes for new api schema and revised xpath
 methods

---
 lib/datura/to_es/ead_to_es/fields.rb       | 89 ++++++++++++++++++++++
 lib/datura/to_es/ead_to_es_items/fields.rb |  8 +-
 2 files changed, 95 insertions(+), 2 deletions(-)

diff --git a/lib/datura/to_es/ead_to_es/fields.rb b/lib/datura/to_es/ead_to_es/fields.rb
index 15cb7c9dc..5128f111e 100644
--- a/lib/datura/to_es/ead_to_es/fields.rb
+++ b/lib/datura/to_es/ead_to_es/fields.rb
@@ -92,6 +92,9 @@ def date_not_before
     date(true)
   end
 
+  def date_updated
+  end
+
   def description
     get_text(@xpaths["description"])
   end
@@ -261,4 +264,90 @@ def uri_html
   def works
     # TODO need to create a list of items, maybe an array of ids
   end
+
+  # new/moved fields for API 2.0
+
+  def cover_image
+    if get_list(@xpaths["image_id"])
+      get_list(@xpaths["image_id"]).first
+    end
+  end
+
+  def date_updated
+    get_list(@xpaths["date_updated"])
+  end
+
+  def fig_location
+    get_list(@xpaths["fig_location"])
+  end
+
+  def category2
+    get_list(@xpaths["subcategory"])
+  end
+
+  def category3
+    get_text(@xpaths["category3"])
+  end
+
+  def category4
+    get_text(@xpaths["category4"])
+  end
+
+  def category5
+    get_text(@xpaths["category5"])
+  end
+
+  def notes
+    get_text(@xpaths["notes"])
+  end
+
+  def citation
+    # nested
+  end
+
+  def container_box
+  end
+
+  def container_folder
+  end
+
+  def abstract
+    get_text(@xpaths["abstract"])
+  end
+
+  def keywords2
+    get_text(@xpaths["keywords2"])
+  end
+
+  def keywords3
+    get_text(@xpaths["keywords3"])
+  end
+
+  def keywords4
+    get_text(@xpaths["keywords4"])
+  end
+
+  def has_part
+    # nested
+  end
+
+  def is_part_of
+    # nested
+  end
+
+  def previous_item
+    # nested
+  end
+
+  def next_item
+    # nested
+  end
+
+  def event
+    # nested
+  end
+  
+  def rdf
+    # nested
+  end
 end
diff --git a/lib/datura/to_es/ead_to_es_items/fields.rb b/lib/datura/to_es/ead_to_es_items/fields.rb
index bf1fc99d6..6eaf9c718 100644
--- a/lib/datura/to_es/ead_to_es_items/fields.rb
+++ b/lib/datura/to_es/ead_to_es_items/fields.rb
@@ -28,7 +28,9 @@ def category
   # note this does not sort the creators
   def creator
     creators = get_list(@xpaths["creators"])
-    return creators.map { |creator| { "name" => CommonXml.normalize_space(creator) } }
+    if creators
+      return creators.map { |creator| { "name" => CommonXml.normalize_space(creator) } }
+    end
   end
 
   # returns ; delineated string of alphabetized creators
@@ -65,7 +67,9 @@ def data_type
 
   def date(before=true)
     datestr = get_text(@xpaths["date"])
-    return Datura::Helpers.date_standardize(datestr, before)
+    if datestr
+      return Datura::Helpers.date_standardize(datestr, before)
+    end
   end
 
   def date_display

From 9a18c1c58241153f515ff4d4066e2ce1bc3a1af8 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Mon, 26 Sep 2022 14:31:30 -0500
Subject: [PATCH 104/128] add a nil check for creators

---
 lib/datura/to_es/tei_to_es/fields.rb | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/lib/datura/to_es/tei_to_es/fields.rb b/lib/datura/to_es/tei_to_es/fields.rb
index 100fff580..757ea6f21 100644
--- a/lib/datura/to_es/tei_to_es/fields.rb
+++ b/lib/datura/to_es/tei_to_es/fields.rb
@@ -21,7 +21,9 @@ def category
   # nested field
   def creator
     creators = get_list(@xpaths["creator"])
-    creators.map { |c| { "name" => Datura::Helpers.normalize_space(c) } }
+    if creators
+      creators.map { |c| { "name" => Datura::Helpers.normalize_space(c) } }
+    end
   end
 
   def collection

From 31d0a3620c3097cdab5911c134c0eee2d09efc02 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Mon, 3 Oct 2022 09:53:28 -0500
Subject: [PATCH 105/128] Revert "make sure input is in UTF-8"

This reverts commit b71d028c5d410380fd82b9905a1683d77b6f7c6f.
---
 lib/datura/helpers.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/datura/helpers.rb b/lib/datura/helpers.rb
index ae2dc89f3..831d148c3 100644
--- a/lib/datura/helpers.rb
+++ b/lib/datura/helpers.rb
@@ -134,7 +134,7 @@ def self.normalize_name(abnormal)
   #   removes leading / trailing whitespace, newlines, repeating whitespace, etc
   def self.normalize_space(abnormal)
     if abnormal
-      normal = abnormal.encode!('UTF-8', 'UTF-8', :invalid => :replace).strip.gsub(/\s+/, " ")
+      normal = abnormal.strip.gsub(/\s+/, " ")
     end
     normal || abnormal
   end

From 74cd8099f79f68053f5b8289b571480aeb1c1202 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Mon, 17 Oct 2022 14:45:52 -0500
Subject: [PATCH 106/128] change error handling to avoid method that isn't
 present

---
 lib/datura/file_type.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/datura/file_type.rb b/lib/datura/file_type.rb
index 0526a7daf..d57a5b62a 100644
--- a/lib/datura/file_type.rb
+++ b/lib/datura/file_type.rb
@@ -70,7 +70,7 @@ def post_es(es)
           begin
             RestClient.put("#{es.index_url}/_doc/#{id}", doc.to_json, {:content_type => :json } )
           rescue => e
-            error = "Error transforming or posting to ES for #{self.filename(false)}: #{e.response}"
+            error = "Error transforming or posting to ES for #{self.filename(false)}: #{e}"
           end
         else
           error = "Document #{id} did not validate against the elasticsearch schema"

From 47533f937dbf3266222b5bae681b64b5630ebe03 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Thu, 20 Oct 2022 14:55:27 -0500
Subject: [PATCH 107/128] make sure person is an array

---
 lib/datura/to_es/es_request.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/datura/to_es/es_request.rb b/lib/datura/to_es/es_request.rb
index 6b7f42382..693a37e07 100644
--- a/lib/datura/to_es/es_request.rb
+++ b/lib/datura/to_es/es_request.rb
@@ -206,7 +206,7 @@ def assemble_relations_2
   def assemble_additional_2
     @json["spatial"] = spatial
     @json["places"] = places
-    @json["person"] = person
+    @json["person"] = Array(person)
     @json["event"] = event
     @json["rdf"] = rdf
   end

From 79d1455531fd3ae7b396d3280383b9be84c53041 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Fri, 21 Oct 2022 10:58:19 -0500
Subject: [PATCH 108/128] make sure settings hash is what elasticsearch expects

---
 lib/config/es_api_schemas/2.0.yml | 65 ++++++++++++++++---------------
 1 file changed, 33 insertions(+), 32 deletions(-)

diff --git a/lib/config/es_api_schemas/2.0.yml b/lib/config/es_api_schemas/2.0.yml
index f400161b2..d46c63ca0 100644
--- a/lib/config/es_api_schemas/2.0.yml
+++ b/lib/config/es_api_schemas/2.0.yml
@@ -1,37 +1,38 @@
 # compatible with Apium v2.0
 settings:
-  analysis:
-    char_filter:
-      escapes:
-        type: mapping
-        mappings:
-          - "<em> => "
-          - "</em> => "
-          - "<u> => "
-          - "</u> => "
-          - "<strong> => "
-          - "</strong> => "
-          - "- => "
-          - "& => "
-          - ": => "
-          - "; => "
-          - ", => "
-          - ". => "
-          - "$ => "
-          - "@ => "
-          - "~ => "
-          - "\" => "
-          - "' => "
-          - "[ => "
-          - "] => "
-    normalizer:
-      keyword_normalized:
-        type: custom
-        char_filter:
-          - escapes
-        filter:
-          - asciifolding
-          - lowercase
+  settings:
+    analysis:
+      char_filter:
+        escapes:
+          type: mapping
+          mappings:
+            - "<em> => "
+            - "</em> => "
+            - "<u> => "
+            - "</u> => "
+            - "<strong> => "
+            - "</strong> => "
+            - "- => "
+            - "& => "
+            - ": => "
+            - "; => "
+            - ", => "
+            - ". => "
+            - "$ => "
+            - "@ => "
+            - "~ => "
+            - "\" => "
+            - "' => "
+            - "[ => "
+            - "] => "
+      normalizer:
+        keyword_normalized:
+          type: custom
+          char_filter:
+            - escapes
+          filter:
+            - asciifolding
+            - lowercase
 mappings:
   properties:
     identifier:

From aab8145e6d2bbacacb26fc59b17650bce8387d01 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Fri, 21 Oct 2022 11:16:25 -0500
Subject: [PATCH 109/128] change where mappings are posted for es upgrade

---
 lib/datura/elasticsearch/index.rb | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index cb8da9b84..b90c4d0a0 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -21,7 +21,7 @@ def initialize(options = nil, schema_mapping: false)
 
     @index_url = File.join(@options["es_path"], @options["es_index"])
     @pretty_url = "#{@index_url}?pretty=true"
-    @mapping_url = File.join(@index_url, "_mapping", "_doc?pretty=true")
+    @mapping_url = File.join(@index_url, "_mapping?pretty=true")
 
     # yaml settings (if exist) and mappings
     @requested_schema = YAML.load_file(@options["es_schema"])
@@ -33,7 +33,6 @@ def initialize(options = nil, schema_mapping: false)
   def create
     json = @requested_schema["settings"].to_json
     puts "Creating ES index for API version #{@options["api_version"]}: #{@pretty_url}"
-
     if json && json != "null"
       RestClient.put(@pretty_url, json, { content_type: :json }) { |res, req, result|
         if result.code == "200"
@@ -77,13 +76,13 @@ def get_schema_mapping
     # if mapping has not already been set, get the schema and manipulate
     if !defined?(@schema_mapping)
       @schema_mapping = {
-        "dyanmic" => nil,  # /regex|regex/
+        "dynamic" => nil,  # /regex|regex/
         "fields" => [],    # [ fields ]
         "nested" => {}     # { field: [ nested_fields ] }
       }
 
       schema = get_schema[@options["es_index"]]
-      doc = schema["mappings"]["_doc"]
+      doc = schema["mappings"]
       doc["properties"].each do |field, value|
         @schema_mapping["fields"] << field
         if value["type"] == "nested"

From daeb43731f273646d41be9744d7b2fc087f595c6 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Tue, 25 Oct 2022 12:41:36 -0500
Subject: [PATCH 110/128] add headers to ES requests for authorization

---
 lib/datura/elasticsearch/alias.rb |  6 +++---
 lib/datura/elasticsearch/data.rb  |  4 ++--
 lib/datura/elasticsearch/index.rb | 18 +++++++++++-------
 lib/datura/file_type.rb           |  5 ++++-
 4 files changed, 20 insertions(+), 13 deletions(-)

diff --git a/lib/datura/elasticsearch/alias.rb b/lib/datura/elasticsearch/alias.rb
index 177ee14d1..4d6a3a118 100644
--- a/lib/datura/elasticsearch/alias.rb
+++ b/lib/datura/elasticsearch/alias.rb
@@ -20,7 +20,7 @@ def self.add
         { add: { alias: ali, index: idx } }
       ]
     }
-    RestClient.post(base_url, data.to_json, { content_type: :json }) { |res, req, result|
+    RestClient.post(base_url, data.to_json, @auth_header.merge({ content_type: :json })) { |res, req, result|
       if result.code == "200"
         puts res
         puts "Successfully added alias #{ali}. Current alias list:"
@@ -40,7 +40,7 @@ def self.delete
 
     url = File.join(options["es_path"], idx, "_alias", ali)
 
-    res = JSON.parse(RestClient.delete(url))
+    res = JSON.parse(RestClient.delete(url, @auth_header))
     puts JSON.pretty_generate(res)
     list
   end
@@ -48,7 +48,7 @@ def self.delete
   def self.list
     options = Datura::Options.new({}).all
 
-    res = RestClient.get(File.join(options["es_path"], "_aliases"))
+    res = RestClient.get(File.join(options["es_path"], "_aliases"), )
     JSON.pretty_generate(JSON.parse(res))
   end
 
diff --git a/lib/datura/elasticsearch/data.rb b/lib/datura/elasticsearch/data.rb
index 5deedadb1..4af171fce 100644
--- a/lib/datura/elasticsearch/data.rb
+++ b/lib/datura/elasticsearch/data.rb
@@ -47,7 +47,7 @@ def self.clear_all(options)
     if confirm == "Yes I'm sure"
       url = File.join(options["es_path"], options["es_index"], "_doc", "_delete_by_query?pretty=true")
       json = { "query" => { "match_all" => {} } }
-      RestClient.post(url, json.to_json, { content_type: :json }) { |res, req, result|
+      RestClient.post(url, json.to_json, @auth_header.merge({ content_type: :json })) { |res, req, result|
         if result.code == "200"
           puts res
         else
@@ -66,7 +66,7 @@ def self.clear_index(options)
 
     if confirmation
       data = self.build_clear_data(options)
-      RestClient.post(url, data.to_json, { content_type: :json }) { |res, req, result|
+      RestClient.post(url, data.to_json, @auth_header.merge({ content_type: :json })) { |res, req, result|
         if result.code == "200"
           puts res
         else
diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index b90c4d0a0..337f5cf04 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -1,6 +1,7 @@
 require "json"
 require "rest-client"
 require "yaml"
+require "base64"
 
 require_relative "./../elasticsearch.rb"
 
@@ -25,6 +26,7 @@ def initialize(options = nil, schema_mapping: false)
 
     # yaml settings (if exist) and mappings
     @requested_schema = YAML.load_file(@options["es_schema"])
+    @auth_header = Datura::Helpers.construct_auth_header(@options)
     # if requested, grab the mapping currently associated with this index
     # otherwise wait until after the requested schema is loaded
     get_schema_mapping if schema_mapping
@@ -34,7 +36,7 @@ def create
     json = @requested_schema["settings"].to_json
     puts "Creating ES index for API version #{@options["api_version"]}: #{@pretty_url}"
     if json && json != "null"
-      RestClient.put(@pretty_url, json, { content_type: :json }) { |res, req, result|
+      RestClient.put(@pretty_url, json, @auth_header.merge({ content_type: :json })) { |res, req, result|
         if result.code == "200"
           puts res
         else
@@ -42,7 +44,7 @@ def create
         end
       }
     else
-      RestClient.put(@pretty_url, nil) { |res, req, result|
+      RestClient.put(@pretty_url, nil, @auth_header) { |res, req, result|
         if result.code == "200"
           puts res
         else
@@ -55,7 +57,7 @@ def create
   def delete
     puts "Deleting #{@options["es_index"]} via url #{@pretty_url}"
 
-    RestClient.delete(@pretty_url) { |res, req, result|
+    RestClient.delete(@pretty_url, @auth_header) { |res, req, result|
       if result.code != "200"
         raise "#{result.code} error deleting Elasticsearch index: #{res}"
       end
@@ -63,7 +65,7 @@ def delete
   end
 
   def get_schema
-    RestClient.get(@mapping_url) { |res, req, result|
+    RestClient.get(@mapping_url, @auth_header) { |res, req, result|
       if result.code == "200"
         JSON.parse(res)
       else
@@ -110,7 +112,7 @@ def set_schema
     json = @requested_schema["mappings"].to_json
 
     puts "Setting schema: #{@mapping_url}"
-    RestClient.put(@mapping_url, json, { content_type: :json }) { |res, req, result|
+    RestClient.put(@mapping_url, json, @auth_header.merge({ content_type: :json })) { |res, req, result|
       if result.code == "200"
         puts res
       else
@@ -206,8 +208,9 @@ def self.clear_all(options)
     confirm = STDIN.gets.chomp
     if confirm == "Yes I'm sure"
       url = File.join(options["es_path"], options["es_index"], "_doc", "_delete_by_query?pretty=true")
+      auth_header = Datura::Helpers.construct_auth_header(options)
       json = { "query" => { "match_all" => {} } }
-      RestClient.post(url, json.to_json, { content_type: :json }) { |res, req, result|
+      RestClient.post(url, json.to_json, auth_header.merge({ content_type: :json })) { |res, req, result|
         if result.code == "200"
           puts res
         else
@@ -226,7 +229,8 @@ def self.clear_index(options)
 
     if confirmation
       data = self.build_clear_data(options)
-      RestClient.post(url, data.to_json, { content_type: :json }) { |res, req, result|
+      auth_header = Datura::Helpers.construct_auth_header(options)
+      RestClient.post(url, data.to_json, auth_header.merge({content_type: :json })) { |res, req, result|
         if result.code == "200"
           puts res
         else
diff --git a/lib/datura/file_type.rb b/lib/datura/file_type.rb
index d57a5b62a..aeb0f6f46 100644
--- a/lib/datura/file_type.rb
+++ b/lib/datura/file_type.rb
@@ -30,6 +30,7 @@ def initialize(location, options)
     @out_html = File.join(output, "html")
     @out_iiif = File.join(output, "iiif")
     @out_solr = File.join(output, "solr")
+    @auth_header = Datura::Helpers.construct_auth_header(options)
     Datura::Helpers.make_dirs(@out_es, @out_html, @out_iiif, @out_solr)
     # script locations set in child classes
   end
@@ -68,7 +69,9 @@ def post_es(es)
           # NOTE: If you need to do partial updates rather than replacement of doc
           # you will need to add _update at the end of this URL
           begin
-            RestClient.put("#{es.index_url}/_doc/#{id}", doc.to_json, {:content_type => :json } )
+            puts @auth_header
+            byebug
+            RestClient.put("#{es.index_url}/_doc/#{id}", doc.to_json, @auth_header.merge({:content_type => :json }) )
           rescue => e
             error = "Error transforming or posting to ES for #{self.filename(false)}: #{e}"
           end

From 04de44bdd30227ca9f6d4cf48d3ca2a1ddb5eeff Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Tue, 25 Oct 2022 12:42:20 -0500
Subject: [PATCH 111/128] add method to construct basic auth header from
 options

---
 lib/datura/helpers.rb | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/lib/datura/helpers.rb b/lib/datura/helpers.rb
index 831d148c3..6e64557e2 100644
--- a/lib/datura/helpers.rb
+++ b/lib/datura/helpers.rb
@@ -171,4 +171,10 @@ def self.should_update?(file, since_date=nil)
     end
   end
 
+  def self.construct_auth_header(options)
+    username = options["es_user"]
+    password = options["es_password"]
+    { "Authorization" => "Basic #{Base64::encode64("#{username}:#{password}")}" }
+  end
+
 end

From c7133341ad00264c3cf633290f0171221353bf0a Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Tue, 25 Oct 2022 14:52:59 -0500
Subject: [PATCH 112/128] remove debugging code

---
 lib/datura/file_type.rb | 2 --
 1 file changed, 2 deletions(-)

diff --git a/lib/datura/file_type.rb b/lib/datura/file_type.rb
index aeb0f6f46..e17114837 100644
--- a/lib/datura/file_type.rb
+++ b/lib/datura/file_type.rb
@@ -69,8 +69,6 @@ def post_es(es)
           # NOTE: If you need to do partial updates rather than replacement of doc
           # you will need to add _update at the end of this URL
           begin
-            puts @auth_header
-            byebug
             RestClient.put("#{es.index_url}/_doc/#{id}", doc.to_json, @auth_header.merge({:content_type => :json }) )
           rescue => e
             error = "Error transforming or posting to ES for #{self.filename(false)}: #{e}"

From 4da4062a663d89e80a66edd37d9aa95ce9ff5ef5 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Tue, 25 Oct 2022 14:56:24 -0500
Subject: [PATCH 113/128] update conditional logic for status code,
 dynamic_templates key

---
 lib/datura/elasticsearch/index.rb | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index 337f5cf04..664d5c690 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -93,12 +93,14 @@ def get_schema_mapping
       end
 
       regex_pieces = []
-      doc["dynamic_templates"].each do |template|
-        mapping = template.map { |k,v| v["match"] }.first
-        # dynamic fields are listed like *_k and will need
-        # to be converted to ^.*_k$, then combined into a mega-regex
-        es_match = mapping.sub("*", ".*")
-        regex_pieces << es_match
+      if doc["dynamic_templates"]
+        doc["dynamic_templates"].each do |template|
+          mapping = template.map { |k,v| v["match"] }.first
+          # dynamic fields are listed like *_k and will need
+          # to be converted to ^.*_k$, then combined into a mega-regex
+          es_match = mapping.sub("*", ".*")
+          regex_pieces << es_match
+        end
       end
       if !regex_pieces.empty?
         regex_joined = regex_pieces.join("|")
@@ -231,7 +233,7 @@ def self.clear_index(options)
       data = self.build_clear_data(options)
       auth_header = Datura::Helpers.construct_auth_header(options)
       RestClient.post(url, data.to_json, auth_header.merge({content_type: :json })) { |res, req, result|
-        if result.code == "200"
+        if result.code == "200" || result.code == "201"
           puts res
         else
           raise "#{result.code} error when clearing index: #{res}"

From 5bf8ca777b05e5dcfe351062171f9c44575779e7 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Thu, 26 Jan 2023 14:24:01 -0600
Subject: [PATCH 114/128] change endpoint for delete_by_query for ES8
 compatibility

---
 lib/datura/elasticsearch/index.rb | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index 664d5c690..71582e7ac 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -209,7 +209,7 @@ def self.clear_all(options)
     puts "Type: 'Yes I'm sure'"
     confirm = STDIN.gets.chomp
     if confirm == "Yes I'm sure"
-      url = File.join(options["es_path"], options["es_index"], "_doc", "_delete_by_query?pretty=true")
+      url = File.join(options["es_path"], options["es_index"], "_delete_by_query?pretty=true")
       auth_header = Datura::Helpers.construct_auth_header(options)
       json = { "query" => { "match_all" => {} } }
       RestClient.post(url, json.to_json, auth_header.merge({ content_type: :json })) { |res, req, result|
@@ -226,7 +226,7 @@ def self.clear_all(options)
   end
 
   def self.clear_index(options)
-    url = File.join(options["es_path"], options["es_index"], "_doc", "_delete_by_query?pretty=true")
+    url = File.join(options["es_path"], options["es_index"], "_delete_by_query?pretty=true")
     confirmation = self.confirm_clear(options, url)
 
     if confirmation

From a9d9fc009a2087e0c9d4f9124ab4f66b85f49ad8 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Thu, 27 Oct 2022 11:32:57 -0500
Subject: [PATCH 115/128] upgrade to Ruby 3.0.4

---
 .ruby-version  | 2 +-
 Gemfile.lock   | 9 +++++++--
 datura.gemspec | 2 +-
 3 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/.ruby-version b/.ruby-version
index 860487ca1..b0f2dcb32 100644
--- a/.ruby-version
+++ b/.ruby-version
@@ -1 +1 @@
-2.7.1
+3.0.4
diff --git a/Gemfile.lock b/Gemfile.lock
index d5512b234..fd39ff559 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -19,9 +19,13 @@ GEM
     mime-types (3.4.1)
       mime-types-data (~> 3.2015)
     mime-types-data (3.2022.0105)
+    mini_portile2 (2.8.0)
     minitest (5.16.3)
     netrc (0.11.0)
-    nokogiri (1.13.8-x86_64-darwin)
+    nokogiri (1.13.9)
+      mini_portile2 (~> 2.8.0)
+      racc (~> 1.4)
+    nokogiri (1.13.9-x86_64-darwin)
       racc (~> 1.4)
     racc (1.6.0)
     rake (13.0.6)
@@ -35,6 +39,7 @@ GEM
     unf_ext (0.0.8.2)
 
 PLATFORMS
+  ruby
   x86_64-darwin-20
 
 DEPENDENCIES
@@ -45,4 +50,4 @@ DEPENDENCIES
   rake (~> 13.0)
 
 BUNDLED WITH
-   2.2.26
+   2.2.33
diff --git a/datura.gemspec b/datura.gemspec
index 316a5e2a0..b673b8a1f 100644
--- a/datura.gemspec
+++ b/datura.gemspec
@@ -53,7 +53,7 @@ Gem::Specification.new do |spec|
   ]
   spec.require_paths = ["lib"]
 
-  spec.required_ruby_version = "~> 2.5"
+  spec.required_ruby_version = "~> 3.0"
   spec.add_runtime_dependency "colorize", "~> 0.8.1"
   spec.add_runtime_dependency "nokogiri", "~> 1.10"
   spec.add_runtime_dependency "rest-client", "~> 2.1"

From 9c013b81cfde13f77bf5ad9cebe5f46d4350ae74 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Thu, 27 Oct 2022 11:40:51 -0500
Subject: [PATCH 116/128] make keyword arguments compatible with Ruby 3

---
 lib/datura/file_types/file_csv.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/datura/file_types/file_csv.rb b/lib/datura/file_types/file_csv.rb
index cd8a4e381..92a1cbff6 100644
--- a/lib/datura/file_types/file_csv.rb
+++ b/lib/datura/file_types/file_csv.rb
@@ -33,7 +33,7 @@ def present?(item)
 
   # override to change encoding
   def read_csv(file_location, encoding="utf-8")
-    CSV.read(file_location, {
+    CSV.read(file_location, **{
       encoding: encoding,
       headers: true,
       return_headers: true

From c70d01ac1704fe62b751953cf6960897115c70bf Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Thu, 27 Oct 2022 12:55:37 -0500
Subject: [PATCH 117/128] go up to ruby 3.1.2

---
 .ruby-version  | 2 +-
 datura.gemspec | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.ruby-version b/.ruby-version
index b0f2dcb32..ef538c281 100644
--- a/.ruby-version
+++ b/.ruby-version
@@ -1 +1 @@
-3.0.4
+3.1.2
diff --git a/datura.gemspec b/datura.gemspec
index b673b8a1f..3d6f91b56 100644
--- a/datura.gemspec
+++ b/datura.gemspec
@@ -53,7 +53,7 @@ Gem::Specification.new do |spec|
   ]
   spec.require_paths = ["lib"]
 
-  spec.required_ruby_version = "~> 3.0"
+  spec.required_ruby_version = "~> 3.1"
   spec.add_runtime_dependency "colorize", "~> 0.8.1"
   spec.add_runtime_dependency "nokogiri", "~> 1.10"
   spec.add_runtime_dependency "rest-client", "~> 2.1"

From a784c1d1c0a3e4438c9f43638f6ff2942ea0bccf Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Tue, 8 Nov 2022 15:42:16 -0600
Subject: [PATCH 118/128] add output if nested field is invalid

---
 lib/datura/elasticsearch/index.rb | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/datura/elasticsearch/index.rb b/lib/datura/elasticsearch/index.rb
index 71582e7ac..09828d82f 100644
--- a/lib/datura/elasticsearch/index.rb
+++ b/lib/datura/elasticsearch/index.rb
@@ -140,6 +140,7 @@ def valid_document?(doc)
               next
             else
               # if one of the nested hashes fails, it is invalid
+              puts "Nested field '#{field}' is invalid"
               return false
             end
           end

From 2ec32e4e677ba44850051580288c7431ad16001b Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Tue, 8 Nov 2022 15:47:55 -0600
Subject: [PATCH 119/128] don't use array method on person to avoid errors

---
 lib/datura/to_es/es_request.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/datura/to_es/es_request.rb b/lib/datura/to_es/es_request.rb
index 693a37e07..6b7f42382 100644
--- a/lib/datura/to_es/es_request.rb
+++ b/lib/datura/to_es/es_request.rb
@@ -206,7 +206,7 @@ def assemble_relations_2
   def assemble_additional_2
     @json["spatial"] = spatial
     @json["places"] = places
-    @json["person"] = Array(person)
+    @json["person"] = person
     @json["event"] = event
     @json["rdf"] = rdf
   end

From 1ff5b88e3152e4fe268d6e01bbdd0d6890efc657 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Wed, 9 Nov 2022 16:15:03 -0600
Subject: [PATCH 120/128] update changelog for new version

---
 CHANGELOG.md | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b90e11bf8..ceaf30818 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -25,21 +25,46 @@ Versioning](https://semver.org/spec/v2.0.0.html).
 ### Security
 -->
 
-## [Unreleased](https://github.com/CDRH/datura/compare/v0.2.0-beta...dev)
+## [1.0.0](https://github.com/CDRH/datura/compare/v0.2.0-beta...dev)
 
 ### Added
 - minor test for Datura::Helpers.date_standardize
 - documentation for web scraping
 - documentation for CsvToEs (transforming CSV files and posting to elasticsearch)
+- documentation for adding new ingest formats to Datura
+- byebug gem for debugging
 - instructions for installing Javascript Runtime files for Saxon
+- API schema can either be 1.0 or 2.0 (which includes nested fields); 1.0 will be run by default unless 2.0 is specified. Add the following to `public.yml` or `private.yml` in the data repo:
+```
+api_version: '2.0'
+```
+- schema validation with API version 2.0, invalidly constructed documents will not post
+- authentication with Elasticesarch 8.5; add the following to `public.yml` or `private.yml` in the data repo:
+```
+  es_user: username
+  es_password: ********
+```
+- field overrides for new fields in the new API schema
+- Functionality to transform EAD files and post them to elasticsearch
 
 ### Changed
+- update ruby to 3.1.2
 - date_standardize now relies on strftime instead of manual zero padding for month, day
 - minor corrections to documentation
 - XPath: "text" is now ingested as an array and will be displayed delimitted by spaces
+- refactored command line methods into elasticsearch library
+- refactored and moved date_standardize and date_display helper methods
+- Nokogiri methods `get_text` and `get_list` on TEI now return nil rather than empty strings or arrays if there are no matches
 
 ### Migration
 - check to make sure "text" xpath is doing desired behavior
+- use Elasticsearch 8.5 or higher and add authentication as described above if security is enabled
+- upgrade data repos to Ruby 3.1.2
+- add api version to config as described above
+- make sure fields are consistent with the api schema, many have been renamed or changed in format
+- add nil checks with get_text and get_list methods
+- add EadToES overrides if ingesting EAD files
+- if overriding the `read_csv` method in `lib/datura/file_type.rb`, the hash must be prefixed with ** (`**{}`).
 
 ## [v0.2.0-beta](https://github.com/CDRH/datura/compare/v0.1.6...v0.2.0-beta) - 2020-08-17 - Altering field and xpath behavior, adds get_elements
 

From 5bcfeb30a6e23e571a7f944c923e864e234c9d79 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Wed, 9 Nov 2022 16:39:58 -0600
Subject: [PATCH 121/128] update reference to ruby version

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 5997622ee..55baa376f 100644
--- a/README.md
+++ b/README.md
@@ -7,7 +7,7 @@ Looking for information about how to post documents? Check out the
 
 ## Install / Set Up Data Repo
 
-Check that Ruby is installed, preferably 2.7.x or up. If you are using RVM, see the RVM section below. 
+Check that Ruby is installed, preferably 3.1.2 or up. If you are using RVM, see the RVM section below. 
 
 If your project already has a Gemfile, add the `gem "datura"` line. If not, create a new directory and add a file named `Gemfile` (no extension).
 

From 51ff02fbeab6ae469816795b562e00517c4edbb4 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Thu, 10 Nov 2022 12:00:34 -0600
Subject: [PATCH 122/128] make changes related to ES and API upgrade

---
 docs/1_setup/config.md        | 5 +++++
 docs/1_setup/prepare_index.md | 2 +-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/docs/1_setup/config.md b/docs/1_setup/config.md
index fe4e7b29f..e58ccd5b5 100644
--- a/docs/1_setup/config.md
+++ b/docs/1_setup/config.md
@@ -9,7 +9,10 @@ default:
   collection:
   es_index
   es_path
+  es_user
+  es_password
 ```
+(The options es_user and es_password are needed if you are using a secured Elasticsearch index.)
 
 If there are any settings which must be different based on the local environment (your computer vs the server), place these in `config/private.yml`.
 
@@ -118,6 +121,8 @@ Some stuff commonly in `private.yml`:
 - `threads: 5` (5 recommended for PC, 50 for powerful servers)
 - `es_path: http://localhost:9200`
 - `es_index: some_index`
+- `es_user: elastic` (if you want to use security on your local elasticsearch instance)
+- `es_password: ******`
 - `solr_path: http://localhost:8983/solr`
 - `solr_core: collection_name`
 
diff --git a/docs/1_setup/prepare_index.md b/docs/1_setup/prepare_index.md
index 944f9a719..fa79e7013 100644
--- a/docs/1_setup/prepare_index.md
+++ b/docs/1_setup/prepare_index.md
@@ -13,7 +13,7 @@ You will need to make sure that somewhere, the following are being set in your p
 
 ### Step 2: Prepare Elasticsearch Index
 
-Make sure elasticsearch is installed and running in the location you wish to push to.  If there is already an index you will be using, take note of its name and skip this step.  If you want to add an index, run this command with a specified environment:
+Make sure elasticsearch is installed and running in the location you wish to push to.  If there is already an index you will be using, take note of its name and skip this step. (Note that each index must be dedicated to data on one version of the API schema)  If you want to add an index, run this command with a specified environment:
 
 ```
 admin_es_create_index -e development

From bf82b87a72a5656533a50d85f64c326b63ee856f Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Thu, 10 Nov 2022 13:36:32 -0600
Subject: [PATCH 123/128] add links to more detailed documentation

---
 CHANGELOG.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ceaf30818..8861fe0f5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -38,6 +38,7 @@ Versioning](https://semver.org/spec/v2.0.0.html).
 ```
 api_version: '2.0'
 ```
+See new schema (2.0) documentation [here](https://github.com/CDRH/datura/docs/schema_v2.md)
 - schema validation with API version 2.0, invalidly constructed documents will not post
 - authentication with Elasticesarch 8.5; add the following to `public.yml` or `private.yml` in the data repo:
 ```
@@ -45,7 +46,7 @@ api_version: '2.0'
   es_password: ********
 ```
 - field overrides for new fields in the new API schema
-- Functionality to transform EAD files and post them to elasticsearch
+- functionality to transform EAD files and post them to elasticsearch
 
 ### Changed
 - update ruby to 3.1.2
@@ -58,7 +59,7 @@ api_version: '2.0'
 
 ### Migration
 - check to make sure "text" xpath is doing desired behavior
-- use Elasticsearch 8.5 or higher and add authentication as described above if security is enabled
+- use Elasticsearch 8.5 or higher and add authentication as described above if security is enabled. See [dev docs instructions](https://github.com/CDRH/cdrh_dev_docs/blob/update_elasticsearch_documentation/publishing/2_basic_requirements.md#downloading-elasticsearch).
 - upgrade data repos to Ruby 3.1.2
 - add api version to config as described above
 - make sure fields are consistent with the api schema, many have been renamed or changed in format

From e2d9d9f11b663b72601f721f8bdad57ce6197783 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Thu, 10 Nov 2022 15:02:19 -0600
Subject: [PATCH 124/128] add link to elasticsearch documentation

---
 docs/4_developers/installation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/4_developers/installation.md b/docs/4_developers/installation.md
index 37eb521c2..0e0171bda 100644
--- a/docs/4_developers/installation.md
+++ b/docs/4_developers/installation.md
@@ -6,7 +6,7 @@ TODO
 
 ### Elasticsearch
 
-TODO
+See installation instructions [here](https://github.com/CDRH/cdrh_dev_docs/blob/update_elasticsearch_documentation/publishing/2_basic_requirements.md#downloading-elasticsearch).
 
 ### Apache Permissions
 

From bda6d7ac34aa9ba51584b9a81ffad21a14ccc78a Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Fri, 18 Nov 2022 10:03:31 -0600
Subject: [PATCH 125/128] add conditional to creator for nil checking

---
 lib/datura/to_es/vra_to_es/fields.rb | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/lib/datura/to_es/vra_to_es/fields.rb b/lib/datura/to_es/vra_to_es/fields.rb
index c65dda8db..e8ecb1fb2 100644
--- a/lib/datura/to_es/vra_to_es/fields.rb
+++ b/lib/datura/to_es/vra_to_es/fields.rb
@@ -20,8 +20,10 @@ def category
 
   # nested field
   def creator
-    creators = get_list(@xpaths["creators"])
-    creators.map { |c| { "name" => Datura::Helpers.normalize_space(c) } }
+    creators = get_list(@xpaths["creator"])
+    if creators
+      creators.map { |c| { "name" => Datura::Helpers.normalize_space(c) } }
+    end
   end
 
   def collection

From 214c7776472f6daacde65f53de11f77b93a75e1a Mon Sep 17 00:00:00 2001
From: Karin Dalziel <karindalziel@users.noreply.github.com>
Date: Thu, 10 Nov 2022 09:29:26 -0600
Subject: [PATCH 126/128] Create schema_v2.md

---
 docs/schema_v2.md | 152 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 152 insertions(+)
 create mode 100644 docs/schema_v2.md

diff --git a/docs/schema_v2.md b/docs/schema_v2.md
new file mode 100644
index 000000000..e5985a32a
--- /dev/null
+++ b/docs/schema_v2.md
@@ -0,0 +1,152 @@
+## CDRH Schema, version 2
+
+| NEW FIELD NAME                                                                            | likely facet field? | Metadata Equivalent         | ORIGINAL FIELD NAME                         | DESCRIPTION                                                                                                                                                                                                                           | FIELD TYPE                               |                   | EXAMPLE                                                                                                                                                                         |
+| ----------------------------------------------------------------------------------------- | ------------------- | --------------------------- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Resourse identification, website display                                                  |
+| identifier                                                                                |                     |                             | identifier                                  | Unique identifier of the resource.                                                                                                                                                                                                    | keyword                                  |                   | oscys.case.0001.001                                                                                                                                                             |
+| collection                                                                                | y                   |                             | collection                                  | User friendly and URL valid name of project. Typically consists of directory under specified web domain.                                                                                                                              | keyword                                  |                   | oscys, quillsandfeathers                                                                                                                                                        |
+| collection\_desc                                                                          |                     |                             | collection\_desc                            | Full CDRH name of the project. (e.g. “The William F. Cody Archive”)                                                                                                                                                                   | keyword                                  |                   | O Say Can You See: Early Washington, D.C., Law & Family                                                                                                                         |
+| uri                                                                                       |                     |                             | uri                                         | Full URI of resource. (Actual site not API site)                                                                                                                                                                                      | keyword                                  |                   | [http://earlywashingtondc.org/doc/oscys.case.0001.001](http://earlywashingtondc.org/doc/oscys.case.0001.001)                                                                    |
+| uri\_data                                                                                 |                     |                             | uri\_data                                   | Full URL to XML of data, when available                                                                                                                                                                                               | keyword                                  |                   | [http://earlywashingtondc.org/files/oscys/tei/oscys.case.0001.001.xml](http://earlywashingtondc.org/files/oscys/tei/oscys.case.0001.001.xml)                                    |
+| uri\_html                                                                                 |                     |                             | uri\_html                                   | Full URL to HTML snippit of data                                                                                                                                                                                                      | keyword                                  |                   | [http://earlywashingtondc.org/files/oscys/html-generated/oscys.case.0001.001.txt](http://earlywashingtondc.org/files/oscys/html-generated/oscys.case.0001.001.txt)              |
+| data\_type                                                                                |                     |                             | data\_type                                  | Format the data was originally stored in at CDRH.                                                                                                                                                                                     | keyword                                  |                   | tei<br>                                                                                                                                                                         |
+| fig\_location                                                                             |                     |                             | fig\_location                               | URI to location of figure.                                                                                                                                                                                                            | keyword                                  |                   | [http://earlywashingtondc.org/figures/](http://earlywashingtondc.org/figures/)                                                                                                  |
+| cover\_image                                                                              |                     |                             | image\_id                                   | Unambiguous reference to the image when the image id does not match the file id.                                                                                                                                                      | keyword                                  |                   | oscys.case.0001.001.001.jpg                                                                                                                                                     |
+| title                                                                                     |                     | dcterms:title               | title                                       | Name given to the resource.                                                                                                                                                                                                           | keyword, copied into text                | text?             | The Once and Future King                                                                                                                                                        |
+| title\_sort                                                                               |                     |                             | title\_sort                                 | Name given to the resource lowercased with articles removed                                                                                                                                                                           | keyword                                  |                   | once and future king                                                                                                                                                            |
+| alternative                                                                               |                     | dcterms:alternative         | alternative                                 | Alternative name for the resource.                                                                                                                                                                                                    | keyword, copied into text                | text?             | Petition for Habeas Corpus                                                                                                                                                      |
+| date\_updated                                                                             | m                   |                             | NEW                                         |                                                                                                                                                                                                                                       | date                                     |                   |                                                                                                                                                                                 |
+| category                                                                                  | y                   |                             | category                                    | Category on web page where resource occurs. Category fields are meant to be hierarchical and exclusive, for other types of organization look to subjects, keywords, etc<br><br>Each site will have a controlled vocabulary of its own | keyword                                  |                   | works                                                                                                                                                                           |
+| category2                                                                                 | y                   |                             | subcategory                                 |                                                                                                                                                                                                                                       | keyword                                  |                   | works | novels                                                                                                                                                                  |
+| category3                                                                                 | y                   |                             | NEW                                         | 3rd level category                                                                                                                                                                                                                    | keyword                                  |                   | works | novels | historical fiction                                                                                                                                             |
+| category4                                                                                 | y                   |                             | NEW                                         | 4th level category                                                                                                                                                                                                                    | keyword                                  |                   | works | novels | historical fiction | civil war                                                                                                                                 |
+| category5                                                                                 | y                   |                             | NEW                                         | 5th level category                                                                                                                                                                                                                    | keyword                                  |                   | etc                                                                                                                                                                             |
+| notes                                                                                     |                     |                             | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| Metadata: Digital Item                                                                    |
+| contributor                                                                               |                     | dcterms:contributor         | contributor                                 | CONTAINER FIELD<br>"Entity responsible for making contributions<br>to the resource."                                                                                                                                                  |                                          |                   |                                                                                                                                                                                 |
+| contributor.name                                                                          |                     |                             | [contributor.name](http://contributor.name) | Entity responsible for making contributions<br>to the resource.                                                                                                                                                                       | keyword                                  |                   | \[Allison, Dee Ann\]<br>\[Walter, Katherine\]                                                                                                                                   |
+| [contributor.id](http://contributor.id/)                                                  |                     |                             | [contributor.id](http://contributor.id)     | ID of the contributor                                                                                                                                                                                                                 | keyword                                  |                   | \[https://orcid.org/0000-0002-4671-061X\]<br>(leave blank for no id)                                                                                                            |
+| contributor.role                                                                          |                     |                             | contributor.role                            |                                                                                                                                                                                                                                       | keyword                                  |                   | \[researcher\]<br>\[Principal Investigator\]<br>\[encoder\]                                                                                                                     |
+| Metadata: Original Item                                                                   |
+| creator                                                                                   |                     | dcterms:creator             | creator                                     | CONTAINER FIELD<br>An entity primarily responsible for making the resource.<br>Examples of a Creator include a person, an organization, or a service.                                                                                 |                                          |                   | Use person field with role instead                                                                                                                                              |
+| creator.name                                                                              | y                   |                             | [creator.name](http://creator.name)         | Creator field name                                                                                                                                                                                                                    | keyword                                  | copied into text  | Use person field with role instead                                                                                                                                              |
+| creator.id                                                                                | y                   |                             | [creator.id](http://creator.id)             | Creator field ID (if available)                                                                                                                                                                                                       | keyword                                  |                   | Use person field with role instead                                                                                                                                              |
+| citation                                                                                  |                     |                             |                                             |                                                                                                                                                                                                                                       |                                          |                   |                                                                                                                                                                                 |
+| citation.role                                                                             |                     |                             | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| [citation.id](http://citation.id/)                                                        |                     | bibo:identifier             | NEW                                         | an identifier of the original item                                                                                                                                                                                                    | keyword                                  |                   |                                                                                                                                                                                 |
+| citation.title                                                                            |                     | dcterms:title               | NEW                                         | Used to describe the title of a bibliographic resource                                                                                                                                                                                | keyword                                  | text?             |                                                                                                                                                                                 |
+| citation.publisher                                                                        | y                   | bibo:producer               | publisher                                   | Entity responsible for making the resource available.                                                                                                                                                                                 | keyword                                  |                   | University of Nebraska Press, Lincoln & London, 1992                                                                                                                            |
+| citation.date                                                                             |                     | dcterms:date                | NEW                                         | Date the resource was orginally created.                                                                                                                                                                                              | date                                     |                   | 1900-01-01                                                                                                                                                                      |
+| citation.issue                                                                            |                     | bibo:issue                  | NEW                                         | An issue number                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| citation.page\_start                                                                      |                     | bibo:pageStart              | NEW                                         | Starting page number within a continuous page range.                                                                                                                                                                                  | keyword (some pages are roman numerals)  |                   | 4                                                                                                                                                                               |
+| citation.page\_end                                                                        |                     | bibo:pageEnd                | NEW                                         | Ending page number within a continuous page range.                                                                                                                                                                                    | keyword                                  |                   | 5 (if applicable)                                                                                                                                                               |
+| citation.section                                                                          |                     | bibo:section                | NEW                                         | A section number                                                                                                                                                                                                                      | keyword                                  |                   |                                                                                                                                                                                 |
+| citation.volume                                                                           |                     | bibo:volume                 | NEW                                         | A volume number                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| citation.place                                                                            |                     | juso:name                   | NEW                                         | This property indicates the name of the spatial thing.                                                                                                                                                                                | keyword                                  |                   |                                                                                                                                                                                 |
+| citation.title\_a                                                                         |                     | tei title level a           | NEW                                         | typically an article                                                                                                                                                                                                                  | keyword                                  | text?             |                                                                                                                                                                                 |
+| citation.title\_m                                                                         |                     | tei title level m           | NEW                                         | typically a monograph                                                                                                                                                                                                                 | keyword                                  | text?             |                                                                                                                                                                                 |
+| citation.title\_j                                                                         | y                   | tei title level j           | NEW                                         | typically a journal name                                                                                                                                                                                                              | keyword                                  | text?             |                                                                                                                                                                                 |
+| date                                                                                      | y                   | dcterms:date                |                                             | the date that will be used to sort and run date queries on item                                                                                                                                                                       | date                                     |                   |                                                                                                                                                                                 |
+| date\_display                                                                             |                     |                             | date\_display                               | Date in whatever display format is used on the site                                                                                                                                                                                   | keyword                                  | text?             | January, 1900                                                                                                                                                                   |
+| date\_not\_before                                                                         |                     |                             | date\_not\_before                           | Inclusive beginning date of resource.                                                                                                                                                                                                 | date                                     |                   | 1900-01-01                                                                                                                                                                      |
+| date\_not\_after                                                                          |                     |                             | date\_not\_after                            | Inclusive ending date of resource.                                                                                                                                                                                                    | date                                     |                   | 1900-01-31                                                                                                                                                                      |
+| format                                                                                    | y                   | dcterms:format              | format                                      | File format, physical medium, or dimensions of the resource.                                                                                                                                                                          | keyword                                  | copied into text? | Film: 16mm Safety Film                                                                                                                                                          |
+| medium                                                                                    | y                   | dcterms:medium              | medium                                      | Material or physical carrier of the resource.                                                                                                                                                                                         | keyword                                  | copied into text? | Film                                                                                                                                                                            |
+| extent                                                                                    |                     | dcterms:extent              | extent                                      | Size or duration of the resource.                                                                                                                                                                                                     | keyword                                  |                   | 4:03                                                                                                                                                                            |
+| language                                                                                  | y                   | dcterms:language            | language                                    | Primary / original language of the resource                                                                                                                                                                                           | keyword                                  |                   | en                                                                                                                                                                              |
+| rights\_holder                                                                            | y                   | dcterms:rightsHolder        | rights\_holder                              | A person or organization owning or managing rights over the resource.                                                                                                                                                                 | keyword                                  | copied into text? | Huntington Library                                                                                                                                                              |
+| rights                                                                                    |                     | dcterms:rights              | rights                                      | Information about the rights held in and over the resource.                                                                                                                                                                           | keyword                                  | copied into text? | All Rights Reserved. Contact Rights Holder for Permissions Information.<br>or<br>Covered by a CC-By License https://creativecommons.org/licenses/by/2.0/                        |
+| rights\_uri                                                                               |                     |                             | rights\_uri                                 | URI to rights holder information.                                                                                                                                                                                                     | keyword                                  |                   | [http://www.huntington.org/](http://www.huntington.org/)                                                                                                                        |
+| container\_box                                                                            |                     | ead container type = box    | NEW                                         | box an item is kept in, as in an archive                                                                                                                                                                                              | keyword                                  |                   |                                                                                                                                                                                 |
+| container\_folder                                                                         |                     | ead container type = folder | NEW                                         | folder an item is kept in, as in an archive                                                                                                                                                                                           | keyword                                  |                   |                                                                                                                                                                                 |
+| Metadata: Interpretive                                                                    |
+| subjects                                                                                  | y                   | dcterms:subject             | subjects                                    | Topic of the content of the resource.                                                                                                                                                                                                 | keyword                                  | copied into text? | \[Horror in art\]<br>\[Poisonous spiders--Venom\]                                                                                                                               |
+| abstract                                                                                  |                     | dcterms:abstract            | abstract                                    | Abstract of the resource.                                                                                                                                                                                                             | keyword? (for display or searching?)<br> | text?             | The poem is not one of DGR's great sonnets, and it pales before the majestic painting it was written to accompany. Nevertheless, it is quite an interesting and important text. |
+| description                                                                               |                     | dcterms:description         | description                                 | Short description of the resource.                                                                                                                                                                                                    | text                                     | text?             | A Poem by Dante Gabriel Rossetti                                                                                                                                                |
+| type                                                                                      | y                   | dcterms:type                | type                                        | Nature or genre of the resource.                                                                                                                                                                                                      | keyword                                  | copied into text? | Video                                                                                                                                                                           |
+| topics                                                                                    | y                   |                             | topics                                      | Topics of content of resource.                                                                                                                                                                                                        | keyword                                  | copied into text? |                                                                                                                                                                                 |
+| keywords                                                                                  | y                   |                             | keywords                                    | Keywords used for resource.                                                                                                                                                                                                           | keyword                                  | copied into text? |                                                                                                                                                                                 |
+| keywords2                                                                                 | y                   |                             | NEW                                         | Another set of keywords, used in sites to create another way to browse                                                                                                                                                                | keyword                                  | copied into text? | decade                                                                                                                                                                          |
+| keywords3                                                                                 | y                   |                             | NEW                                         | Another set of keywords, used in sites to create another way to browse                                                                                                                                                                | keyword                                  | copied into text? |                                                                                                                                                                                 |
+| keywords4                                                                                 | y                   |                             | NEW                                         | Another set of keywords, used in sites to create another way to browse                                                                                                                                                                | keyword                                  | copied into text? |                                                                                                                                                                                 |
+| Relation to other items                                                                   |
+| relation                                                                                  |                     | dcterms:relation            | relation                                    | A related resource that is substantially the same as the described resource, but in another format.                                                                                                                                   | keyword                                  |                   | oscys.case.0001.001-B                                                                                                                                                           |
+| source                                                                                    |                     | dcterms:source              | source                                      | A related resource from which the described resource is derived                                                                                                                                                                       | keyword                                  |                   | oscys.case.0001.001-A                                                                                                                                                           |
+| has\_part                                                                                 |                     | dcterms:hasPart             | NEW                                         | parts of the resource, for example items pasted into a scrapbook                                                                                                                                                                      |                                          |                   |                                                                                                                                                                                 |
+| has\_part.role                                                                            |                     |                             |                                             |                                                                                                                                                                                                                                       |                                          |                   |                                                                                                                                                                                 |
+| has\_part.id                                                                              |                     |                             |                                             |                                                                                                                                                                                                                                       | keyword                                  |                   | cdrh.0001                                                                                                                                                                       |
+| has\_part.title                                                                           |                     |                             |                                             |                                                                                                                                                                                                                                       | keyword                                  |                   | Resource title                                                                                                                                                                  |
+| has\_part.order                                                                           |                     |                             |                                             |                                                                                                                                                                                                                                       | whole number                             |                   | 1                                                                                                                                                                               |
+| is\_part\_of                                                                              |                     | dcterms:isPartOf            | NEW                                         | the containing resource, for example the scrapbook the individual items are in                                                                                                                                                        |                                          |                   |                                                                                                                                                                                 |
+| is\_part\_of.role                                                                         |                     |                             |                                             |                                                                                                                                                                                                                                       |                                          |                   |                                                                                                                                                                                 |
+| is\_part\_of.id                                                                           |                     |                             |                                             |                                                                                                                                                                                                                                       | keyword                                  |                   | cdrh.0001                                                                                                                                                                       |
+| is\_part\_of.title                                                                        |                     |                             |                                             |                                                                                                                                                                                                                                       | keyword                                  |                   | Resource title                                                                                                                                                                  |
+| is\_part\_of.order                                                                        |                     |                             |                                             |                                                                                                                                                                                                                                       | whole number                             |                   | 1                                                                                                                                                                               |
+| previous\_item                                                                            |                     |                             | NEW                                         | previous item in a series. role can be used to create multiple nexts - for instance, previous letter in a mailing sequence, pervious letter by date                                                                                   |                                          |                   |                                                                                                                                                                                 |
+| previous\_item.role                                                                       |                     |                             |                                             |                                                                                                                                                                                                                                       |                                          |                   |                                                                                                                                                                                 |
+| [previous\_item.id](http://previous_item.id/)                                             |                     |                             |                                             |                                                                                                                                                                                                                                       | keyword                                  |                   | cdrh.0001                                                                                                                                                                       |
+| previous\_item.title                                                                      |                     |                             |                                             |                                                                                                                                                                                                                                       | keyword                                  |                   | Resource title                                                                                                                                                                  |
+| previous\_item.order                                                                      |                     |                             |                                             |                                                                                                                                                                                                                                       | whole number                             |                   | 1                                                                                                                                                                               |
+| next\_item                                                                                |                     |                             | NEW                                         | next item in a series. role can be used to create multiple nexts - for instance, next letter in a mailing sequence, next letter by date                                                                                               |                                          |                   |                                                                                                                                                                                 |
+| next\_item.role                                                                           |                     |                             |                                             |                                                                                                                                                                                                                                       |                                          |                   |                                                                                                                                                                                 |
+| [next\_item.id](http://next_item.id/)                                                     |                     |                             |                                             |                                                                                                                                                                                                                                       | keyword                                  |                   | cdrh.0001                                                                                                                                                                       |
+| next\_item.title                                                                          |                     |                             |                                             |                                                                                                                                                                                                                                       | keyword                                  |                   | Resource title                                                                                                                                                                  |
+| next\_item.order                                                                          |                     |                             |                                             |                                                                                                                                                                                                                                       | whole number                             |                   | 1                                                                                                                                                                               |
+| Additional Data types                                                                     |
+| spatial                                                                                   |                     |                             | spatial                                     | CONTAINER FIELD                                                                                                                                                                                                                       |                                          |                   |                                                                                                                                                                                 |
+| spatial.role                                                                              |                     |                             |                                             |                                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| spatial.name                                                                              | y                   | juso:name                   | spatial.title                               | Title / display name of location                                                                                                                                                                                                      | keyword                                  | copied into text? | Display name for this location, typically built from other fields, but potentially not.                                                                                         |
+| spatial.description                                                                       |                     |                             | spatial.description                         | Description                                                                                                                                                                                                                           | text                                     | text?             |                                                                                                                                                                                 |
+| spatial.type                                                                              | y                   |                             | spatial.type                                |                                                                                                                                                                                                                                       | keyword                                  | copied into text? | "origin" or "destination" used to distinguish multiple spatial records for one item (for example, for an item of correspondence)                                                |
+| spatial.short\_name                                                                       | y                   | juso:short\_name            | spatial.place\_name                         | Specific name of location in question, such as the army camp name, business, event title, etc                                                                                                                                         | keyword, copied into text                |                   | Camp Hollowell, Kimball Recital Hall, The Coffeehouse, Lancaster County Fairgrounds                                                                                             |
+| spatial.coordinates                                                                       | y                   | juso:geometry               | spatial.coordinates                         |                                                                                                                                                                                                                                       | geopoint                                 |                   | \[-96.6669600, 40.8000000\]                                                                                                                                                     |
+| spatial.id                                                                                |                     |                             | [spatial.id](http://coverage.spatial.id/)   |                                                                                                                                                                                                                                       | keyword                                  |                   | ????<br>                                                                                                                                                                        |
+| spatial.city                                                                              | y                   | juso:city                   | spatial.city                                |                                                                                                                                                                                                                                       | keyword                                  | copied into text? |                                                                                                                                                                                 |
+| spatial.township                                                                          |                     | juso:Township               | NEW                                         |                                                                                                                                                                                                                                       |                                          | copied into text? |                                                                                                                                                                                 |
+| spatial.county                                                                            |                     | juso:county                 | spatial.county                              |                                                                                                                                                                                                                                       | keyword                                  | copied into text? |                                                                                                                                                                                 |
+| spatial.country                                                                           | y                   | juso:country                | spatial.country                             |                                                                                                                                                                                                                                       | keyword                                  | copied into text? |                                                                                                                                                                                 |
+| spatial.region                                                                            | y                   | juso:within                 | NEW?                                        |                                                                                                                                                                                                                                       | keyword                                  | copied into text? |                                                                                                                                                                                 |
+| spatial.state                                                                             |                     | juso:state                  | spatial.state                               |                                                                                                                                                                                                                                       | keyword                                  | copied into text? |                                                                                                                                                                                 |
+| spatial.street                                                                            |                     | juso:street                 | spatial.street                              |                                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| spatial.postal\_code                                                                      |                     | juso:postal\_code           | spatial.postal\_code                        |                                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| spatial.note                                                                              |                     |                             |                                             |                                                                                                                                                                                                                                       |                                          |                   |                                                                                                                                                                                 |
+| deprecate and replace with place with role of "placename" and only place\_name filled out |                     |                             | places                                      | Place names mentioned in the resource.                                                                                                                                                                                                | keyword                                  |                   |                                                                                                                                                                                 |
+| person                                                                                    |                     | foaf:Person                 | person                                      | any people other than contributors associated with resource                                                                                                                                                                           |                                          |                   |                                                                                                                                                                                 |
+| person.name                                                                               | y                   | foaf:name                   | [person.name](http://person.name)           | Name as we wish it to appear                                                                                                                                                                                                          | keyword                                  | copied into text? | \[Cody, William F.\]                                                                                                                                                            |
+| [person.id](http://person.id/)                                                            | y                   |                             | [person.id](http://person.id)               | Optional, if exists, may be from VIAF or similar.                                                                                                                                                                                     | keyword                                  |                   | \[http://viaf.org/viaf/100252467\]                                                                                                                                              |
+| person.role                                                                               | y                   |                             | person.role                                 | Role of person. Common examples are recipient and sender, less common examples are attorney and defendant                                                                                                                             | keyword                                  | copied into text? | \[sender\]<br>\[recipient\]<br>\[creator\]<br>\[editor\]                                                                                                                        |
+| person.note                                                                               |                     |                             | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| person.order                                                                              |                     |                             | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| person.birth\_date                                                                        |                     | foaf:birthday               | NEW                                         |                                                                                                                                                                                                                                       | date                                     |                   | \[1899-03-04\]                                                                                                                                                                  |
+| person.death\_date                                                                        |                     |                             | NEW                                         |                                                                                                                                                                                                                                       | date                                     |                   |                                                                                                                                                                                 |
+| person.age\_category                                                                      | y                   |                             | NEW                                         | used when resources are categorizing the age of the participant at the time of the event. For instance, a minor in a court case                                                                                                       | keyword                                  |                   | \[minor\]<br>\[adult\]                                                                                                                                                          |
+| person.name\_last                                                                         |                     | foaf:lastName               | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| person.name\_given                                                                        |                     | foaf:givenName              | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| person.name\_alternate                                                                    |                     |                             | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| person.name\_previous                                                                     |                     |                             |                                             |                                                                                                                                                                                                                                       |                                          |                   |                                                                                                                                                                                 |
+| person.race                                                                               | y                   |                             | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| person.sex                                                                                | y                   |                             | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| person.gender                                                                             | y                   | foaf:gender                 | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| person.nationality                                                                        | y                   |                             | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| person.trait1                                                                             | y                   |                             | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| person.trait2                                                                             | y                   |                             | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| event                                                                                     |                     |                             |                                             |                                                                                                                                                                                                                                       |                                          |                   |                                                                                                                                                                                 |
+| event.type                                                                                | y                   |                             | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| event.agent                                                                               | y                   | event:agent                 | NEW                                         | Relates an event to an active agent (a person, a computer, ... :-) )                                                                                                                                                                  | keyword                                  |                   |                                                                                                                                                                                 |
+| event.factor                                                                              |                     | event:factor                | NEW                                         | Relates an event to a passive factor (a tool, an instrument, an abstract cause...)                                                                                                                                                    | keyword                                  |                   | points of law cited in a case                                                                                                                                                   |
+| event.product                                                                             | y                   | event:product               | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   | case outcome                                                                                                                                                                    |
+| event.date\_begin                                                                         |                     | event\_date\_begin          | NEW                                         |                                                                                                                                                                                                                                       | date                                     |                   |                                                                                                                                                                                 |
+| event.date\_end                                                                           |                     | event\_date\_end            | NEW                                         |                                                                                                                                                                                                                                       | date                                     |                   |                                                                                                                                                                                 |
+| event.trait1                                                                              |                     |                             | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   | can be used for case keywords, i.e. civil, criminal                                                                                                                             |
+| event.trait2                                                                              |                     |                             | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| event.notes                                                                               |                     |                             | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| RDF                                                                                       |                     |                             |                                             | The RDF field can be used to record any other data that needs to be associated with the record, for instance relationships                                                                                                            |                                          |                   |                                                                                                                                                                                 |
+| rdf.type                                                                                  |                     |                             | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   | \[relationship\]                                                                                                                                                                |
+| rdf.subject                                                                               | y                   | ref:subject                 | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   | \[Smith, John\]                                                                                                                                                                 |
+| rdf.predicate                                                                             | y                   | rdf:predicate               | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   | \[is married to\]                                                                                                                                                               |
+| rdf.object                                                                                | y                   | rdf:object                  | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   | \[Smith, Mary\]                                                                                                                                                                 |
+| rdf.source                                                                                |                     |                             | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   | item.0001                                                                                                                                                                       |
+| rdf.note                                                                                  |                     |                             | NEW                                         |                                                                                                                                                                                                                                       | keyword                                  |                   |                                                                                                                                                                                 |
+| Text search                                                                               |
+| annotations\_text                                                                         |                     |                             | annotations\_text                           | Place for annotations text, so we can search annotations separately from the main text                                                                                                                                                | text                                     |                   |                                                                                                                                                                                 |
+| text                                                                                      |                     |                             | text                                        | Combined text of all the above fields for key word searching.                                                                                                                                                                         | text<br>                                 |                   |                                                                                                                                                                                 |

From 5d6d2051e37fe63e166ef32e0b4bbbbdb546dd41 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Wed, 25 Jan 2023 12:44:34 -0600
Subject: [PATCH 127/128] make sure webs_to_es fields can handle nil values

---
 lib/datura/to_es/webs_to_es/fields.rb | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/lib/datura/to_es/webs_to_es/fields.rb b/lib/datura/to_es/webs_to_es/fields.rb
index 3163706be..1ef633126 100644
--- a/lib/datura/to_es/webs_to_es/fields.rb
+++ b/lib/datura/to_es/webs_to_es/fields.rb
@@ -39,7 +39,11 @@ def data_type
   end
 
   def date(before=true)
-    datestr = get_list(@xpaths["date"]).first
+    if get_list(@xpaths["date"])
+      datestr = get_list(@xpaths["date"]).first
+    else
+      datestr = nil
+    end    
     if datestr
       Datura::Helpers.date_standardize(datestr, true)
     end
@@ -80,7 +84,9 @@ def format
   end
 
   def image_id
-    get_list(@xpaths["image_id"]).first
+    if get_list(@xpaths["image_id"])
+      get_list(@xpaths["image_id"]).first
+    end
   end
 
   def keywords
@@ -218,7 +224,9 @@ def works
   # new/moved fields for API 2.0
 
   def cover_image
-    get_list(@xpaths["image_id"]).first
+    if get_list(@xpaths["image_id"])
+      get_list(@xpaths["image_id"]).first
+    end
   end
 
   def date_updated

From 4c65fb0e2e45813d6cf6862a0c294c217b78ef63 Mon Sep 17 00:00:00 2001
From: William Dewey <wkdewey@gmail.com>
Date: Wed, 1 Mar 2023 13:22:38 -0600
Subject: [PATCH 128/128] add documentation steps for starting a new data
 collection

---
 docs/1_setup/collection_setup.md |  6 +++++-
 docs/1_setup/config.md           | 11 ++++++-----
 2 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/docs/1_setup/collection_setup.md b/docs/1_setup/collection_setup.md
index a611e7140..48b4f4cb8 100644
--- a/docs/1_setup/collection_setup.md
+++ b/docs/1_setup/collection_setup.md
@@ -2,7 +2,11 @@
 
 ### Step 1:  Create a new collection directory
 
-Install datura, then run:
+Install datura by creating a new directory with a `Gemfile` with
+`gem "datura", git: 'https://github.com/CDRH/datura', branch: "dev"` 
+Make a file `.ruby-version` with the ruby version required by Datura (currently 3.1.2).
+Run `bundle install` and make sure Datura install successfulle.
+Then run:
 
 ```
 setup
diff --git a/docs/1_setup/config.md b/docs/1_setup/config.md
index e58ccd5b5..b0f401bea 100644
--- a/docs/1_setup/config.md
+++ b/docs/1_setup/config.md
@@ -7,12 +7,13 @@ Open up the `config/public.yml` file in your new collection and add or change th
 ```yaml
 default:
   collection:
-  es_index
-  es_path
-  es_user
-  es_password
+  es_index:
+  es_path:
+  es_user:
+  es_password:
+  api_version:
 ```
-(The options es_user and es_password are needed if you are using a secured Elasticsearch index.)
+(The options es_user and es_password are needed if you are using a secured Elasticsearch index.) api_version is required with the new API schema, please specify "2.0", or "1.0" if using with a legacy repository that uses the old fields.
 
 If there are any settings which must be different based on the local environment (your computer vs the server), place these in `config/private.yml`.