Columbia Libraries Unified Search & Discovery
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
app
bin
config
db
doc
lib
public
spec
vcr/cassettes
.byebug_history
.codeclimate.yml
.coveralls.yml
.gitignore
.gitmodules
.hooves
.rspec
.travis.yml
Capfile
Gemfile
Gemfile.lock
Guardfile
README.md
Rakefile
VERSION
config.ru

README.md

clio-spectrum

Columbia Libraries Unified Search & Discovery

Getting started on OSX

  1. Install tools
  • install XCode from app store and Xcode command line tools

  • install mysql

  • install homebrew

    ````
    ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    ````
    
  • install git

    ````
    brew install git
    ````
    
  • install rvm

    ````
    \curl -sSL https://get.rvm.io | bash -s stable --ruby
    ````
    
  • install Qt webkit more information

    ````
    brew install qt
    ````
    
  1. Get set up with git
  • create an account on github.com if you don't already have one

  • configure your git user name and email

    ````
    git config --global user.name "Your Name"
    git config --global user.email "your_email@whatever.com"
    ````
    
  • Install github for mac (optional, but has some very nice features)

  1. Fork and clone the repo
  • fork the https://github.com/cul/clio-spectrum repo (fork button at top right of github web interface)

  • clone the new forked repo onto your dev machine

    ````
    git clone https://github.com/yourusername/clio-spectrum
    ````
    
  1. Prepare your local environment
  • change to the app directorycd clio-spectrum

  • check out the develop branch git checkout develop

  • run bundle to install the gems

  • run the database migrations rake db:migrate

  • rename the config files mv config/blacklight.yml.SAMPLE config/blacklight.yml mv config/database.yml.SAMPLE config/database.yml mv config/app_config.yml.SAMPLE config/app_config.yml

  • load the Locations, Libraries and Library Hours

     ````
     rake hours:sync
     rake locations:load
     ````
    
  1. Start the server rails s

  2. Visit the running app in your browser at localhost:3000

  3. Run the test suite

  • prepare your test database

    ````
    rake db:test:prepare
    rake hours:sync RAILS_ENV=test
    rake locations:load RAILS_ENV=test
    ````
    
  • run rspec and ensure that all tests are passing (green)

Contributing to CLIO

Contributions can be submitted to CLIO by making a pull request, following GitHub's fork-and-pull model. Pull requests should be submitted from feature (topic) branches and be based on CLIO's develop (not master) branch.

Read more about the GitHub workflow.

  1. Create a feature branch off the develop branch
git fetch origin
git checkout origin/develop
git checkout -b your-new-branch
  1. Make and commit your changes

  2. Assure that the test suite is all green

  3. Submit a pull request to the develop branch