environment setup

Requirements

If you don't have them already, you'll need to install:

• Ruby
  • compatible ruby versions: 2.5, 2.6, 2.7
  • Windows installer: https://rubyinstaller.org/about/
  • Ruby installation documentation: https://www.ruby-lang.org/en/documentation/installation/
• Required gems (guide to installing gems):
  • marc
  • highline
  • enhanced_marc
  • unf_ext

Install

The best way to install the Wrangler requires git and bundler.

• Install git (e.g. Windows installers)
• Then:

  # install bundler
  gem install bundler
  
  # clone this repo
  git clone https://github.com/UNC-Libraries/MARC-record-set-wrangler
  
  # use bundler to install gems
  cd MARC-record-set-wrangler
  bundle install
  
  # Installation is done. When running the Wrangler, prefix your command with `bundle exec`
  # e.g.: `bundle exec ruby MARC_set_wrangler.rb`

Alternate installation:

• Download zip file from Wrangler project home page
• Put the resulting directory in a convenient place on your local machine
• Manually install the required gems:
  • e.g. gem install marc highline enhanced_marc unf_ext
  • you may run into complications using non-compatible or non-supported versions of gems

Consider

• Make sure your config.yaml file is under version control or is at least backed up. You won't want to lose your changes to this file.