collectionspace-client 0.14.1 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 89651eb1e87693f52f835cbe34eccc510f40888db54696a41082ae114a084817
-  data.tar.gz: e3c161e2a64848a1f0065e18da8aa23ad6117995daf62538cf5437bc0192cfc6
+  metadata.gz: d797561c0b44c79ce0bda224d05ff05de6fa7c932b2c33d4a9c888116c6d6fbb
+  data.tar.gz: bfbd46caa314f5fc6620b468e14e262983f3f52a444622ef55669c60ad5c4f84
 SHA512:
-  metadata.gz: 7d9d9989ff3272bffe9fc99c19036e72004b7e672bc3d02ce5556b69bb478a441a78768d394685534ba83144d76054903bac35fa4f715c50cff32b838e60132c
-  data.tar.gz: 7bea83ddcadf1aa7019e196c8ede59cd9e9ffd6fdd9b23a90ff7d0f89666122cb6c865a0b422287cb8a04d4032718e493e48f23b6356d65039a1bde00626e53b
+  metadata.gz: 697f5207854022997a0acf1e2249113c763447a5597677d4b7f7b157244467a2c0bee0d163d152ee2191950e41c9478a21443f967087c87e85a765c137542865
+  data.tar.gz: 71d59341de8048599691df601042915c803c10c6710982c76eeda366684aab1ba27ce694a285bcf349d9de08faba78d4951838114ff96059f24c417dc6b9f1a8

data/.git-blame-ignore-revs

@@ -0,0 +1,8 @@
+# Appease standard
+63444da90ce50afd5d282c6cfb5ca6dc3210be7d
+# Lint/format
+0dc6263edaed69d0d472626974a1317c059b3337
+# Make standard happy
+5cbdb2d41997f05e6cbad814c11e2893706ac152
+# Use standard for linting
+e5ba9f76a333609734079c3ec6102c2cbe4974b7

data/.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+on: [pull_request]
+
+jobs:
+  tests:
+    name: Tests
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby-version: ['3.2', '3.1', '3.0']
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Set up Ruby ${{ matrix.ruby-version }}
+        uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+          ruby-version: ${{ matrix.ruby-version }}
+
+      - name: Install dependencies
+        run: bundle install
+
+      - name: Lint
+        run: |
+          bundle exec standardrb
+
+      - name: Run tests
+        run: |
+          bundle exec rake

data/.gitignore

@@ -1,4 +1,6 @@
 *.gem
+*.jpg
+*.pdf
 *.swp
 /.bundle/
 /.vscode

data/.rubocop.yml

@@ -1,8 +1,4 @@
-# .rubocop.yml
-AllCops:
-  Exclude:
-    - '*.gemspec'
-    - '*.rake'
-Metrics/BlockLength:
-  Exclude:
-    - !ruby/regexp /_spec.rb/
+require: standard
+
+inherit_gem:
+  standard: config/base.yml

data/.ruby-version

@@ -1 +1 @@
-2.7.4
+3.2.1

data/Gemfile

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-source 'https://rubygems.org'
+source "https://rubygems.org"
 
 # Specify your gem's dependencies in collectionspace-client.gemspec
 gemspec

data/README.md

@@ -39,8 +39,8 @@ gem install gem-release
 # https://github.com/svenfuchs/gem-release#gem-bump
 gem bump --version $VERSION --tag
 # i.e.
-gem bump --version minor --tag --pretend # dryrun
-gem bump --version minor --tag # do it for real
+gem bump --version minor --pretend # dryrun
+gem bump --version minor # do it for real
 # PR and merge will publish new version
 ```
 

data/Rakefile

@@ -1,9 +1,10 @@
 # frozen_string_literal: true
 
-require 'bundler/gem_tasks'
-require 'rspec/core/rake_task'
-require 'base64'
-require 'collectionspace/client'
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require "base64"
+require "collectionspace/client"
+require "standard/rake"
 
 RSpec::Core::RakeTask.new(:spec)
 
@@ -16,10 +17,10 @@ end
 namespace :cli do
   desc "Update a user's password: requires an Admin level account to perform the update"
   task :update_password, [:endpoint, :admin, :password, :user, :new_password] do |_t, args|
-    endpoint     = args[:endpoint]
-    admin        = args[:admin]
-    password     = args[:password]
-    user         = args[:user]
+    endpoint = args[:endpoint]
+    admin = args[:admin]
+    password = args[:password]
+    user = args[:user]
     new_password = args[:new_password]
 
     client = CollectionSpace::Client.new(
@@ -37,9 +38,9 @@ namespace :cli do
       </ns2:accounts_common>
     XML
 
-    client.all('accounts').each do |account|
-      if account['email'] == user
-        puts client.put(account['uri'], payload).parsed
+    client.all("accounts").each do |account|
+      if account["email"] == user
+        puts client.put(account["uri"], payload).parsed
         break
       end
     end

data/bin/console

@@ -1,11 +1,11 @@
 #! /usr/bin/env ruby
 # frozen_string_literal: true
 
-require 'bundler/setup'
+require "bundler/setup"
 Bundler.require(:tools)
 
-require_relative '../lib/collectionspace/client'
-require 'irb'
+require_relative "../lib/collectionspace/client"
+require "irb"
 
 module CollectionSpace
   ::CS = CollectionSpace # alias only in console to minimize typing
@@ -15,9 +15,9 @@ module CollectionSpace
   def coredev
     CollectionSpace::Client.new(
       CollectionSpace::Configuration.new(
-        base_uri: 'https://core.dev.collectionspace.org/cspace-services',
-        username: 'admin@core.collectionspace.org',
-        password: 'Administrator'
+        base_uri: "https://core.dev.collectionspace.org/cspace-services",
+        username: "admin@core.collectionspace.org",
+        password: "Administrator"
       )
     )
   end

data/bin/rspec

@@ -15,7 +15,7 @@ ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
 bundle_binstub = File.expand_path("../bundle", __FILE__)
 
 if File.file?(bundle_binstub)
-  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+  if /This file was generated by Bundler/.match?(File.read(bundle_binstub, 300))
     load(bundle_binstub)
   else
     abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.

data/collectionspace-client.gemspec

@@ -1,33 +1,34 @@
-lib = File.expand_path('lib', __dir__)
+lib = File.expand_path("lib", __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'collectionspace/client/version'
+require "collectionspace/client/version"
 
 Gem::Specification.new do |spec|
-  spec.name          = 'collectionspace-client'
-  spec.version       = CollectionSpace::Client::VERSION
-  spec.authors       = ['Mark Cooper']
-  spec.email         = ['mark.cooper@lyrasis.org']
+  spec.name = "collectionspace-client"
+  spec.version = CollectionSpace::Client::VERSION
+  spec.authors = ["Mark Cooper"]
+  spec.email = ["mark.cooper@lyrasis.org"]
 
-  spec.summary       = 'CollectionSpace API client.'
-  spec.homepage      = 'https://github.com/lyrasis/collectionspace-client.git'
-  spec.license       = 'MIT'
+  spec.summary = "CollectionSpace API client."
+  spec.homepage = "https://github.com/lyrasis/collectionspace-client.git"
+  spec.license = "MIT"
 
-  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
-  spec.bindir        = 'exe'
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ['lib']
+  spec.files = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
 
-  spec.add_dependency 'httparty'
-  spec.add_dependency 'json'
-  spec.add_dependency 'nokogiri'
+  spec.add_dependency "httparty"
+  spec.add_dependency "json"
+  spec.add_dependency "nokogiri"
 
-  spec.add_development_dependency 'awesome_print'
-  spec.add_development_dependency 'bundler'
-  spec.add_development_dependency 'pry'
-  spec.add_development_dependency 'rake', '~> 10.0'
-  spec.add_development_dependency 'rspec'
-  spec.add_development_dependency 'rubocop'
-  spec.add_development_dependency 'simplecov', '~> 0.21'
-  spec.add_development_dependency 'vcr'
-  spec.add_development_dependency 'webmock'
+  spec.add_development_dependency "awesome_print"
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "rubocop"
+  spec.add_development_dependency "simplecov", "~> 0.21"
+  spec.add_development_dependency "standard"
+  spec.add_development_dependency "vcr", "~> 6.1"
+  spec.add_development_dependency "webmock"
 end

data/examples/batches.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+# Install batches (aka data updates)
+# Based on:
+# https://github.com/collectionspace/Tools/blob/master/scripts/install_batch_records.sh
+# https://github.com/collectionspace/Tools/blob/master/scripts/create-batch-records.sh
+
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require "awesome_print"
+require "collectionspace/client"
+require "pry"
+
+STANDARD_TENANTS = [
+  :anthro,
+  :bonsai,
+  :botgarden,
+  :core,
+  :fcart,
+  :herbarium,
+  :lhmc,
+  :materials,
+  :publicart
+]
+
+STANDARD_BATCHES = CollectionSpace::Batch.all
+
+STANDARD_TENANTS.each do |tenant|
+  client = CollectionSpace::Client.new(
+    CollectionSpace::Configuration.new(
+      base_uri: "https://#{tenant}.dev.collectionspace.org/cspace-services",
+      username: "admin@#{tenant}.collectionspace.org",
+      password: "Administrator"
+    )
+  )
+  base = client.config.base_uri
+    .delete_suffix("/cspace-services")
+    .delete_prefix("https://")
+  merge_doctypes = client.authority_doctypes
+
+  STANDARD_BATCHES.each do |batch|
+    batch[:doctype] = merge_doctypes if batch[:name] == "Merge Authority Items"
+    response = client.add_batch(batch)
+    if response.result.success?
+      puts "Added #{batch[:name]} to #{base}"
+    else
+      puts "FAILED TO ADD #{batch[:name]} to #{base}"
+      puts response.inspect
+    end
+  end
+end

data/examples/demo.rb

@@ -1,22 +1,22 @@
 # frozen_string_literal: true
 
-$LOAD_PATH.unshift File.expand_path('../lib', __dir__)
-require 'awesome_print'
-require 'collectionspace/client'
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require "awesome_print"
+require "collectionspace/client"
 
 client = CollectionSpace::Client.new(
   CollectionSpace::Configuration.new(
-    base_uri: 'https://core.dev.collectionspace.org/cspace-services',
-    username: 'admin@core.collectionspace.org',
-    password: 'Administrator'
+    base_uri: "https://core.dev.collectionspace.org/cspace-services",
+    username: "admin@core.collectionspace.org",
+    password: "Administrator"
   )
 )
 
 # GET REQUEST FOR CONDITIONCHECK RECORDS AND PRINT THE PARSED RESPONSE AND XML
-response = client.get('conditionchecks')
+response = client.get("conditionchecks")
 ap response.parsed if response.result.success?
 
 # GET ALL PERSON RECORDS AND PROCESS PER PAGE (INSTEAD OF WAITING FOR ALL)
-client.all('personauthorities/urn:cspace:name(person)/items').each do |item|
+client.all("personauthorities/urn:cspace:name(person)/items").each do |item|
   puts item
 end

data/examples/media_with_external_file.rb

@@ -1,19 +1,19 @@
 # frozen_string_literal: true
 
-$LOAD_PATH.unshift File.expand_path('../lib', __dir__)
-require 'awesome_print'
-require 'collectionspace/client'
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require "awesome_print"
+require "collectionspace/client"
 
 client = CollectionSpace::Client.new(
   CollectionSpace::Configuration.new(
-    base_uri: 'https://core.dev.collectionspace.org/cspace-services',
-    username: 'admin@core.collectionspace.org',
-    password: 'Administrator'
+    base_uri: "https://core.dev.collectionspace.org/cspace-services",
+    username: "admin@core.collectionspace.org",
+    password: "Administrator"
   )
 )
 client.config.throttle = 1
 
-media_url = 'https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png'
+media_url = "https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png"
 media = <<-XML
   <?xml version="1.0" encoding="UTF-8"?>
   <document name="media">
@@ -24,5 +24,5 @@ media = <<-XML
   </document>
 XML
 
-response = client.post('media', media, query: { 'blobUri' => media_url })
-puts response.result.headers['location'] if response.result.success?
+response = client.post("media", media, query: {"blobUri" => media_url})
+puts response.result.headers["location"] if response.result.success?

data/examples/purge_empty_vocabs.rb

@@ -1,22 +1,22 @@
 # frozen_string_literal: true
 
-$LOAD_PATH.unshift File.expand_path('../lib', __dir__)
-require 'collectionspace/client'
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require "collectionspace/client"
 
 client = CollectionSpace::Client.new(
   CollectionSpace::Configuration.new(
-    base_uri: 'https://core.dev.collectionspace.org/cspace-services',
-    username: 'admin@core.collectionspace.org',
-    password: 'Administrator'
+    base_uri: "https://core.dev.collectionspace.org/cspace-services",
+    username: "admin@core.collectionspace.org",
+    password: "Administrator"
   )
 )
 client.config.throttle = 1
 
-client.all('vocabularies').each do |item|
-  uri = item['uri']
+client.all("vocabularies").each do |item|
+  uri = item["uri"]
   puts "Checking vocabulary: #{uri}"
   next unless client.count("#{uri}/items").zero?
 
-  puts "Purging empty vocabulary:\t#{item['displayName']} (#{item['csid']})"
+  puts "Purging empty vocabulary:\t#{item["displayName"]} (#{item["csid"]})"
   client.delete uri
 end

data/examples/reports.rb

@@ -1,178 +1,45 @@
 # frozen_string_literal: true
 
-$LOAD_PATH.unshift File.expand_path('../lib', __dir__)
-require 'awesome_print'
-require 'collectionspace/client'
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require "awesome_print"
+require "collectionspace/client"
 
-client = CollectionSpace::Client.new(
-  CollectionSpace::Configuration.new(
-    base_uri: 'https://core.dev.collectionspace.org/cspace-services',
-    username: 'admin@core.collectionspace.org',
-    password: 'Administrator'
-  )
-)
+STANDARD_TENANTS = [
+  :anthro,
+  :bonsai,
+  :botgarden,
+  :core,
+  :fcart,
+  :herbarium,
+  :lhmc,
+  :materials,
+  :publicart
+]
 
 # https://github.com/collectionspace/Tools/blob/master/scripts/install_report_records.sh
 # https://github.com/collectionspace/Tools/blob/master/scripts/create-report-records.sh
 
-STANDARD_REPORTS = [
-  {
-    name: 'Acquisition Summary',
-    notes: 'An acquisition summary report. Runs on a single record only.',
-    doctype: 'Acquisition',
-    supports_single_doc: 'true',
-    supports_doc_list: 'false',
-    supports_group: 'false',
-    supports_no_context: 'false',
-    filename: 'acq_basic.jrxml',
-    mimetype: 'application/pdf'
-  },
-  {
-    name: 'Acquisition Basic List',
-    notes: 'Catalog info for objects related to an acquisition record. Runs on a single record only.',
-    doctype: 'Acquisition',
-    supports_single_doc: 'true',
-    supports_doc_list: 'false',
-    supports_group: 'false',
-    supports_no_context: 'false',
-    filename: 'Acq_List_Basic.jrxml',
-    mimetype: 'application/pdf'
-  },
-  {
-    name: 'Condition Check Basic List',
-    notes: 'Catalog info for objects related to a condition check record. Runs on a single record only.',
-    doctype: 'Conditioncheck',
-    supports_single_doc: 'true',
-    supports_doc_list: 'false',
-    supports_group: 'false',
-    supports_no_context: 'false',
-    filename: 'CC_List_Basic.jrxml',
-    mimetype: 'application/pdf'
-  },
-  {
-    name: 'Exhibition Basic List',
-    notes: 'Catalog info for objects related to a exhibition record. Runs on a single record only.',
-    doctype: 'Exhibition',
-    supports_single_doc: 'true',
-    supports_doc_list: 'false',
-    supports_group: 'false',
-    supports_no_context: 'false',
-    filename: 'Exhibition_List_Basic.jrxml',
-    mimetype: 'application/pdf'
-  },
-  {
-    name: 'Group Basic List',
-    notes: 'Catalog info for objects related to a group record. Runs on a single record only.',
-    doctype: 'Group',
-    supports_single_doc: 'true',
-    supports_doc_list: 'false',
-    supports_group: 'false',
-    supports_no_context: 'false',
-    filename: 'Group_List_Basic.jrxml',
-    mimetype: 'application/pdf'
-  },
-  {
-    name: 'Loan In Basic List',
-    notes: 'Catalog info for objects related to a loan in record. Runs on a single record only.',
-    doctype: 'Loanin',
-    supports_single_doc: 'true',
-    supports_doc_list: 'false',
-    supports_group: 'false',
-    supports_no_context: 'false',
-    filename: 'LoansIn_List_Basic.jrxml',
-    mimetype: 'application/pdf'
-  },
-  {
-    name: 'Loan Out Basic List',
-    notes: 'Catalog info for objects related to a loan out record. Runs on a single record only.',
-    doctype: 'Loanout',
-    supports_single_doc: 'true',
-    supports_doc_list: 'false',
-    supports_group: 'false',
-    supports_no_context: 'false',
-    filename: 'LoansOut_List_Basic.jrxml',
-    mimetype: 'application/pdf'
-  },
-  {
-    name: 'Acquisition Ethnographic Object List',
-    notes: 'Core acquisition report. Runs on a single record only.',
-    doctype: 'Acquisition',
-    supports_single_doc: 'true',
-    supports_doc_list: 'false',
-    supports_group: 'false',
-    supports_no_context: 'false',
-    filename: 'coreAcquisition.jrxml',
-    mimetype: 'application/pdf'
-  },
-  {
-    name: 'Group Object Ethnographic Object List',
-    notes: 'Core group object report. Runs on a single record only.',
-    doctype: 'Group',
-    supports_single_doc: 'true',
-    supports_doc_list: 'false',
-    supports_group: 'false',
-    supports_no_context: 'false',
-    filename: 'coreGroupObject.jrxml',
-    mimetype: 'application/pdf'
-  },
-  {
-    name: 'Intake Ethnographic Object List',
-    notes: 'Core intake report. Runs on a single record only.',
-    doctype: 'Intake',
-    supports_single_doc: 'true',
-    supports_doc_list: 'false',
-    supports_group: 'false',
-    supports_no_context: 'false',
-    filename: 'coreIntake.jrxml',
-    mimetype: 'application/pdf'
-  },
-  {
-    name: 'Loan In Ethnographic Object List',
-    notes: 'Core loan in report. Runs on a single record only.',
-    doctype: 'Loanin',
-    supports_single_doc: 'true',
-    supports_doc_list: 'false',
-    supports_group: 'false',
-    supports_no_context: 'false',
-    filename: 'coreLoanIn.jrxml',
-    mimetype: 'application/pdf'
-  },
-  {
-    name: 'Loan Out Ethnographic Object List',
-    notes: 'Core loan out report. Runs on a single record only.',
-    doctype: 'Loanout',
-    supports_single_doc: 'true',
-    supports_doc_list: 'false',
-    supports_group: 'false',
-    supports_no_context: 'false',
-    filename: 'coreLoanOut.jrxml',
-    mimetype: 'application/pdf'
-  },
-  {
-    name: 'Object Exit Ethnographic Object List',
-    notes: 'Core object exit report. Runs on a single record only.',
-    doctype: 'ObjectExit',
-    supports_single_doc: 'true',
-    supports_doc_list: 'false',
-    supports_group: 'false',
-    supports_no_context: 'false',
-    filename: 'coreObjectExit.jrxml',
-    mimetype: 'application/pdf'
-  },
-  {
-    name: 'Systematic Inventory',
-    notes: 'Generate a checklist for performing an inventory on a range of storage locations. Runs on all records, using the provided start and end locations.',
-    doctype: 'Locationitem',
-    supports_single_doc: 'false',
-    supports_doc_list: 'false',
-    supports_group: 'false',
-    supports_no_context: 'true',
-    filename: 'systematicInventory.jrxml',
-    mimetype: 'application/pdf'
-  }
-]
+STANDARD_REPORTS = CollectionSpace::Report.all
+
+STANDARD_TENANTS.each do |tenant|
+  client = CollectionSpace::Client.new(
+    CollectionSpace::Configuration.new(
+      base_uri: "https://#{tenant}.dev.collectionspace.org/cspace-services",
+      username: "admin@#{tenant}.collectionspace.org",
+      password: "Administrator"
+    )
+  )
+  base = client.config.base_uri
+    .delete_suffix("/cspace-services")
+    .delete_prefix("https://")
 
-STANDARD_REPORTS.each do |report|
-  response = client.add_report(report)
-  puts response.inspect
+  STANDARD_REPORTS.each do |report|
+    response = client.add_report(report)
+    if response.result.success?
+      puts "Added #{report[:name]} to #{base}"
+    else
+      puts "FAILED TO ADD #{report[:name]} to #{base}"
+      puts response.inspect
+    end
+  end
 end

data/examples/reset_media_blob.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require "awesome_print"
+require "collectionspace/client"
+require "csv"
+
+client = CollectionSpace::Client.new(
+  CollectionSpace::Configuration.new(
+    base_uri: "https://core.dev.collectionspace.org/cspace-services",
+    username: "admin@core.collectionspace.org",
+    password: "Administrator"
+  )
+)
+client.config.throttle = 1
+
+path = File.expand_path("~/your/path/here.csv")
+
+CSV.foreach(path, headers: true) do |row|
+  client.reset_media_blob(
+    id: row["identificationnumber"],
+    url: row["mediafileuri"],
+    verbose: true,
+    # client files are on same server as CS instance, and ingestable
+    #   file paths do not all parse as URIs safely
+    ensure_safe_url: false,
+    # This example script used to fix media where the blobs had already
+    #   been deleted, but the blobcsid value was not removed from the
+    #   media record. Attempts to delete the media failed, so this option
+    #   was used to add new blobs without attempting to delete the already
+    #   deleted old blobs (and erroring out)
+    delete_existing_blob: false
+  )
+  sleep 1.5
+end