Busbud Coding Challenge

Getting Started

Begin by forking this repo and cloning your fork. GitHub has apps for Mac and Windows that make this easier.

Setting up a Ruby environment

Get started by installing rbenv and ruby-build.

For OS X users, this will require the Xcode Command Line tools and a few Homebrew packages. Details here.

Once that's done run

rbenv install 2.0.0-p247

followed by

rbenv shell 2.0.0-p247

Setting up the project

In the project directory run

gem install bundler

followed by

bundle install

(You may need to run rbenv rehash if the bundle command is unavailable).

Running the tests

The test suite can be run with

bundle exec rspec

Starting the application

To start a local server run

bundle exec thin start

which should produce output similar to

Using rack adapter
Thin web server (v1.6.1 codename Death Proof)
Maximum connections set to 1024
Listening on 0.0.0.0:3000, CTRL+C to stop

Requirements

Write a simple API endpoint that runs a query string against the Google Geocoding API to return a list of suggested cities.

• Requests must be authenticated against username and password using http basic auth.
• All functional tests should pass (additional tests may be implemented as necessary).
• The final application should be deployed to Heroku.

Non-functional

• All code should be written in Ruby
• Work should be submitted as a pull-request to this repo
• Documentation and maintainability is a plus