Install & Update

Squib is a Ruby gem, and installation is handled like most gems.

Pre-requisites

Squib works with both x86 and x86_64 versions of Ruby.

On Windows, we recommend using RubyInstaller. Use the version with DevKit.

Typical Install

Regardless of your OS, installation is

$ gem install squib

If you’re using Bundler, add this line to your application’s Gemfile:

gem 'squib'

And then execute:

$ bundle install

Squib has some native dependencies, such as Cairo, Pango, and Nokogiri, which will compile upon installation - this is normal.

Updating Squib

At this time we consider Squib to be still in initial development, so we are not supporting older versions. Please upgrade your Squib as often as possible.

To keep track of when new Squib releases come out, you can watch the BoardGameGeek thread or follow the RSS feed for Squib on its RubyGems page.

In RubyGems, the command looks like this:

$ gem up squib

As a quirk of Ruby/RubyGems, sometimes older versions of gems get caught in caches. You can see which versions of Squib are installed and clean them up, use gem list and gem cleanup:

$ gem list squib

*** LOCAL GEMS ***

squib (0.9.0, 0.8.0)

$ gem cleanup squib
Cleaning up installed gems...
Attempting to uninstall squib-0.8.0
Successfully uninstalled squib-0.8.0
Clean Up Complete

This will remove all prior versions of Squib.

As a sanity check, you can see what version of Squib you’re using by referencing the Squib::VERSION constant:

require 'squib'
puts Squib::VERSION

OS-Specific Quirks

See the wiki for idiosyncracies about specific operating systems, dependency clashes, and other installation issues. If you’ve run into issues and solved them, please post your solutions for others!