cob_index is a repository that holds the Traject configuration files and scripts associated with the customized MARCXML-Solr metadata transformations and indexing for Temple University Libraries' Library Search (tul_cob).

Add this line to your application's Gemfile:

gem 'cob_index'

And then execute:

$ bundle

Or install it yourself as:

$ gem install cob_index

cob_index is an executable. You can use it to ingest files into SOLR_URL with

cob_index ingest $path_to_file

$path_file can also be a URL.

--commit If this switch is passed (cob_index ingest --commit), then cob_index will send commit at end of ingest process.

ALMAOAI_LAST_HARVEST_FROM_DATE: if provided used as one of the possible defaults for extract_update_date macro.

SOLR_DISABLE_UPDATE_DATE_CHECK: When set to "yes" will make extract_update_date macro use Time.now.utc.to_s effectively overriding date versioning on Solr instance.

cob_index delete  $path_to_file

--commit If this switch is passed (cob_index delete --commit), then cob_index will send commit at end of delete process.

--suppress If this switch is passed (cob_index delete --suppress), then instead of outright deleting the documents we enable a suppression field which we filter out at query time.

cob_index harvest  --type=alma-electronic

Runs pre defined harvesting endpoints for tul_cob. Note the only type currently defined is for the alma-electronic api and thus it is set by default.

cob_index commit

Sends a commit command to the Solr instance.

collection_notes.json and service_notes.json files get outputed to the working directory when cob_index harvest --type=alma-electronic is run.

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

To run the executable without installing, run bundle exec cob_index.

Sometimes it may be convenient to reindex a particular record in the production / qa Solr index to allow an acceptance tester to proceed without requiring a full reindex. In that case, a workflow like the following example can be used:

# set up some env vars to make this easy
export SOLR_URL_PROD="https://$SOLRCLOUD_USER:$SOLRCLOUD_PASSWORD@$SOLRCLOUD_HOST/solr/$CATALOG_COLLECTION"
export SOLR_DISABLE_UPDATE_DATE_CHECK=true
export ID=99999999999381
SOLR_URL=$SOLR_URL_PROD bundle exec cob_index ingest
 --commit https://librarysearch.temple.edu/catalog/${ID}.xml

Bug reports and pull requests are welcome on GitHub at https://github.com/tulibraries/cob_index. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

The gem is available as open source under the terms of the MIT License.

Everyone interacting in the CobIndex project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.