freerider 0.0.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3061fdf8fe5483f8247586cc3f6dafaa42ddf734
+  data.tar.gz: a0a40bc31bc9d7578de11fdaebbe8c0a62760251
+SHA512:
+  metadata.gz: 4efcef6d3dc651253124bc22479e594a24506fbaf4fdfae68e76374349ea9111ed7695da774961be6a6886f7a9b4e3fca1cde07e43fcb8a273aca3e212749c0a
+  data.tar.gz: d29eaaac9fbb47b89813608d2dfab6cf96ee5921ede3ffa5156f0e70eb34d832e8cf351a4023ab68fd36c98c66708e6869f229b1de5239d631ca313f56fde96f

data/.gitignore

@@ -0,0 +1,34 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in freerider.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,94 @@
+PATH
+  remote: .
+  specs:
+    freerider (0.0.3)
+      caruby2go
+      geocoder
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    caruby2go (0.0.2)
+      thor (~> 0.19.1)
+    celluloid (0.16.0)
+      timers (~> 4.0.0)
+    coderay (1.1.0)
+    diff-lcs (1.2.5)
+    ffi (1.9.6)
+    formatador (0.2.5)
+    geocoder (1.2.8)
+    guard (2.11.1)
+      formatador (>= 0.2.4)
+      listen (~> 2.7)
+      lumberjack (~> 1.0)
+      nenv (~> 0.1)
+      notiffany (~> 0.0)
+      pry (>= 0.9.12)
+      shellany (~> 0.0)
+      thor (>= 0.18.1)
+    guard-compat (1.2.1)
+    guard-rspec (4.5.0)
+      guard (~> 2.1)
+      guard-compat (~> 1.1)
+      rspec (>= 2.99.0, < 4.0)
+    hitimes (1.2.2)
+    listen (2.8.5)
+      celluloid (>= 0.15.2)
+      rb-fsevent (>= 0.9.3)
+      rb-inotify (>= 0.9)
+    lumberjack (1.0.9)
+    method_source (0.8.2)
+    nenv (0.2.0)
+    notiffany (0.0.4)
+      nenv (~> 0.1)
+      shellany (~> 0.0)
+    pry (0.10.1)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    pry-nav (0.2.4)
+      pry (>= 0.9.10, < 0.11.0)
+    pry-remote (0.1.8)
+      pry (~> 0.9)
+      slop (~> 3.0)
+    rake (10.4.2)
+    rb-fsevent (0.9.4)
+    rb-inotify (0.9.5)
+      ffi (>= 0.5.0)
+    rspec (3.2.0)
+      rspec-core (~> 3.2.0)
+      rspec-expectations (~> 3.2.0)
+      rspec-mocks (~> 3.2.0)
+    rspec-core (3.2.0)
+      rspec-support (~> 3.2.0)
+    rspec-expectations (3.2.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-mocks (3.2.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-nc (0.2.0)
+      rspec (>= 2.9)
+      terminal-notifier (>= 1.4)
+    rspec-support (3.2.1)
+    shellany (0.0.1)
+    slop (3.6.0)
+    terminal-notifier (1.6.2)
+    thor (0.19.1)
+    timers (4.0.1)
+      hitimes
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.7)
+  freerider!
+  guard
+  guard-rspec
+  pry
+  pry-nav
+  pry-remote
+  rake (~> 10.0)
+  rspec
+  rspec-nc

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Eric Ebbesen
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,79 @@
+# Freerider
+
+freerider identifies car2go vehicles in your area which you can refuel for free minutes!
+
+
+### What?
+freerider is a gem that uses [the car2go api](https://code.google.com/p/car2go/wiki/index_v2_1) to locate local car2go vehicles that are less than a specified percent fueled.
+
+You need to [get your own consumer key from car2go](https://www.car2go.com/en/austin/car2go-apps/).
+
+### Why?
+car2go offers 20 minutes of free time when you refuel a vehicle that is less than 25 percent fueled.  See the Parking and refueling section of [this page](https://www.car2go.com/en/minneapolis/how-does-car2go-work/) for details.
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'freerider'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install freerider
+
+## Packaging
+`rake build`
+
+or run
+
+`./build`
+
+to build _and_ install the gem
+
+## Usage
+
+After packaging you can run
+
+    $ CONSUMER_KEY=<your_car2go_consumer_key> FROM_LOCATION='Tivoli, Danmark' bin/freerider [-l <location>] [-f <fuel_threshold>] [-r <radius>]
+or
+
+    $ export CONSUMER_KEY=<your_car2go_consumer_key> 
+    $ bin/freerider [-l <location>] [-f <fuel_threshold>] [-r <radius>]
+
+For example
+
+    $ export CONSUMER_KEY=conkey bin/freerider v -l kobenhavn -f 20 -r 3
+will use your consumer key and retrieve all vehicles in Copenhagen that are 20 or less fueled
+
+`location` will default to `twincities` (represent!).
+`fuel_threshold` will default to `25`.
+
+## Dependencies
+I work/test using Ruby 2.2.x but any version 2.0.0 or greater will work.  Ruby 1.9.3 is right out.
+
+## Contributing
+
+1. Fork it ( https://github.com/eebbesen/freerider/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request
+
+
+## Helpful tools
+### Geocoder gem
+#### Get geocode for address or business name
+
+    Geocoder.coordinates("Fasika, Saint Paul, MN")
+
+#### Distance calculation
+
+    geo_distance = Geocoder::Calculations.distance_between([-93.09774, 44.93669],[-93.17795, 44.94289])
+    Geocoder::Calculations.to_miles(geo_distance)

data/Rakefile

@@ -0,0 +1,10 @@
+require 'rspec/core/rake_task'
+require 'bundler/gem_tasks'
+
+# Default directory to look in is `/specs`
+# Run with `rake spec`
+RSpec::Core::RakeTask.new(:spec) do |task|
+  task.rspec_opts = ['--color', '--format', 'progress']
+end
+
+task default: :spec

data/bin/freerider

@@ -0,0 +1,63 @@
+#!/usr/bin/env ruby
+
+require 'thor'
+require_relative '../lib/freerider'
+require_relative '../lib/formatter'
+require_relative '../lib/geolocutor'
+
+##
+# Command-line interface for Freerider
+class FreeriderScript < Thor
+  SUMMARY_BORDER = '=========================='
+  RECORD_DELIMITER = SUMMARY_BORDER + SUMMARY_BORDER
+
+  desc 'vehicles', "Get vehicles: location defaults to 'twincities', fuel_threshold defaults to '25'"
+  option :location, default: 'twincities', aliases: :l
+  option :fuel_threshold, type: :numeric, default: 25, aliases: :f
+  option :radius, type: :numeric, aliases: :r
+  def vehicles
+    require_key
+    vehicles = Freerider.new((options[:location] || ENV['FROM_LOCATION']), ENV['CONSUMER_KEY'])
+    display(vehicles.find_vehicles(options[:fuel_threshold], options[:radius]))
+  end
+
+  private
+
+  def display(vehicles)
+    vehicles.each do |vehicle|
+      puts RECORD_DELIMITER
+      puts Formatter.format_vehicle(vehicle.to_json)
+    end
+    summarize(vehicles)
+  end
+
+  def summarize(vehicles)
+    puts SUMMARY_BORDER
+
+    notify_suffix = "with a fuel level below #{options[:fuel_threshold]} percent and within radius #{options[:radius]}"
+    if vehicles.size > 0
+      cars = if vehicles.size > 1
+               'cars'
+             else
+               'car'
+             end
+
+      print "#{vehicles.size} #{cars} found #{notify_suffix}"
+    else
+      print "No cars found #{notify_suffix}"
+    end
+
+    puts "\n#{SUMMARY_BORDER}"
+  end
+
+  # this is set using an environment variable
+  def require_key
+    return if ENV['CONSUMER_KEY']
+    puts 'Set environment variable CONSUMER_KEY to your Car2Go consumer key.'
+    puts 'For example:'
+    puts '    $ CONSUMER_KEY=mykey bin/freerider v'
+    false
+  end
+end
+
+FreeriderScript.start(ARGV)

data/build

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+require 'fileutils'
+
+build_return = `gem build freerider.gemspec`
+
+gemfile = ''
+lines = build_return.split "\n"
+puts lines
+lines.each do |line|
+  gemfile = line.split(' ')[1] if line.start_with? '  File: '
+end
+
+puts `gem install freerider`
+
+FileUtils.mv(gemfile, './pkg/')

data/freerider.gemspec

@@ -0,0 +1,37 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'freerider/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'freerider'
+  spec.version       = Freerider::VERSION
+  spec.authors       = ['Eric Ebbesen']
+  spec.email         = ['git.eebbesen@gmail.com']
+  spec.summary       = 'Locate local car2go vehicles that need to be fueled.'
+  spec.description   = 'car2go offers 20 minutes of free time when you refuel a vehicle that is less than 25 percent fueled. freerider identifies car2go vehicles in your area which you can refuel for free minutes!'
+  spec.homepage      = 'https://github.com/eebbesen/freerider'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.required_ruby_version = '>= 2.0'
+
+  spec.add_dependency 'caruby2go'
+  spec.add_dependency 'geocoder'
+
+  spec.add_development_dependency 'bundler', '~> 1.7'
+  spec.add_development_dependency 'rake', '~> 10.0'
+
+  # rspec
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'rspec-nc'
+  spec.add_development_dependency 'guard'
+  spec.add_development_dependency 'guard-rspec'
+  spec.add_development_dependency 'pry'
+  spec.add_development_dependency 'pry-remote'
+  spec.add_development_dependency 'pry-nav'
+end

data/lib/formatter.rb

@@ -0,0 +1,55 @@
+##
+# Addresses don't always have
+# * a city
+# * a zip code
+# * a numeric component of the street address
+class Formatter
+  def self.format_vehicle(vehicle)
+    address = format_address vehicle
+    maps_uri = format_maps_uri vehicle
+    stats = format_status vehicle
+
+    "#{address}\n#{stats}\n#{maps_uri}"
+  end
+
+  def self.format_address(vehicle)
+    address_parts = (JSON.parse vehicle)['address'].split ','
+    return address_parts[0] if address_parts.size == 1
+
+    street_address = address_parts[0].split ' '
+
+    # Prepend with number if address has number part
+    display_address = if (street_address.last =~ /\d/).nil?
+                        street_address.join ' '
+                      else
+                        number = street_address.pop
+                        street_address = street_address.join ' '
+                        "#{number} #{street_address}"
+                      end
+
+    # Add city if address has city part
+    if address_parts[1]
+      ciudad = address_parts[1].split ' '
+      ciudad.shift unless (ciudad.first =~ /\d/).nil? # zipcode
+      display_address += ", #{ciudad.join ' '}"
+    end
+
+    display_address
+  end
+
+  def self.format_maps_uri(vehicle)
+    geocode = (JSON.parse vehicle)['coordinates']
+    latitude = geocode[0]
+    longitude = geocode[1]
+    # accuracy = geocode[2]
+
+    "https://www.google.com/maps/preview?q=#{longitude},#{latitude}"
+  end
+
+  def self.format_status(vehicle)
+    fuel_level = (JSON.parse vehicle)['fuel']
+    license_plate = (JSON.parse vehicle)['name']
+
+    "<<FUEL: #{fuel_level}>> #{license_plate}"
+  end
+end

data/lib/freerider.rb

@@ -0,0 +1,42 @@
+require 'freerider/version'
+require 'caruby2go'
+
+##
+# Process values from car2go API calls
+class Freerider
+  TC = 'twincities'
+
+  def initialize(location,
+                 consumer_key = ENV['CONSUMER_KEY'],
+                 from_location = ENV['FROM_LOCATION'])
+    @car2go = Caruby2go.new(consumer_key, default_if_empty(location, TC))
+    @geolocutor = Geolocutor.new(from_location)
+  end
+
+  def find_vehicles(upper_fuel_threshold = 25, radius = 100)
+    upper_fuel_threshold = default_if_empty(upper_fuel_threshold, 25)
+    radius = default_if_empty(radius, 100)
+    (@car2go.vehicles.select do |vehicle|
+      within_fuel_range(vehicle, upper_fuel_threshold) && within_radius(vehicle, radius)
+     end
+    ).compact
+  end
+
+  private
+
+  def within_fuel_range(vehicle, upper_fuel_threshold)
+    vehicle['fuel'] < upper_fuel_threshold
+  end
+
+  def within_radius(vehicle, radius)
+    @geolocutor.distance_from_here(vehicle) <= radius
+  end
+
+  def default_if_empty(value, default)
+    if !value || (value.respond_to?('empty?') && value.empty?)
+      default
+    else
+      value
+    end
+  end
+end

data/lib/freerider/version.rb

@@ -0,0 +1,3 @@
+class Freerider
+  VERSION = '0.0.4'
+end

data/lib/geolocutor.rb

@@ -0,0 +1,37 @@
+require 'geocoder'
+
+##
+# Wrap Geocoder gem to calculate relative distances
+class Geolocutor
+  include Geocoder
+
+  attr_reader :coordinates
+
+  def initialize(location, metric = false)
+    @coordinates = coordinatize(location)
+    @metric = metric
+  end
+
+  def distance_from_here(there)
+    there = coordinatize(extract_coordinates(there))
+    distance = Geocoder::Calculations.distance_between(@coordinates, there)
+
+    return Geocoder::Calculations.to_kilometers(distance) if @metric
+    Geocoder::Calculations.to_miles(distance)
+  end
+
+  private
+
+  def coordinatize(location)
+    fail(ArgumentError, 'You must supply coordinates, and address or a location name') if location.nil?
+    Geocoder.coordinates(location)
+  end
+
+  # car2go reverses the lat/long
+  # and also includes an accuracy value which must be removed
+  def extract_coordinates(vehicle_json)
+    coordinates = vehicle_json['coordinates']
+    coordinates.pop
+    coordinates.reverse
+  end
+end

data/spec/formatter_spec.rb

@@ -0,0 +1,37 @@
+require 'spec_helper'
+
+describe Formatter do
+  let(:vehicle) { '{"address":"Grand Ave 1600, 55105 St Paul","coordinates":[-93.16789,44.93999,0],"engineType":"CE","exterior":"GOOD","fuel":26,"interior":"GOOD","name":"AB0000","smartPhoneRequired":false,"vin":"AAAAA0AA0AA000000"}' }
+  let(:vehicle_2) { '{"address":"10th & Park   park spot","coordinates":[-93.26529,44.97035,0],"engineType":"CE","exterior":"GOOD","fuel":18,"interior":"GOOD","name":"AB1111","smartPhoneRequired":false,"vin":"BAAAA0AA0AA000000"}' }
+  let(:vehicle_3) { '{"address":"Dr Justus Ohage Blvd, 55107 St Paul","coordinates":[-93.09774,44.93669,0],"engineType":"CE","exterior":"GOOD","fuel":100,"interior":"GOOD","name":"AB2222","smartPhoneRequired":false,"vin":"BAAAA0AA0AA000001"}' }
+  let(:vehicle_4) { '{"address":"Abbot Parkspot","coordinates":[-93.27623,44.96604,0],"engineType":"CE","exterior":"BAD","fuel":1,"interior":"GOOD","name":"AB3333","smartPhoneRequired":false,"vin":"BAAAA0AA0AA000003"}' }
+
+  describe '#format_vehicle' do
+    it 'should return a formatted representation of a vehicle' do
+      expect(Formatter.format_vehicle(vehicle)).to eq "1600 Grand Ave, St Paul\n<<FUEL: 26>> AB0000\nhttps://www.google.com/maps/preview?q=44.93999,-93.16789"
+      expect(Formatter.format_vehicle(vehicle_2)).to eq "10th & Park   park spot\n<<FUEL: 18>> AB1111\nhttps://www.google.com/maps/preview?q=44.97035,-93.26529"
+      expect(Formatter.format_vehicle(vehicle_3)).to eq "Dr Justus Ohage Blvd, St Paul\n<<FUEL: 100>> AB2222\nhttps://www.google.com/maps/preview?q=44.93669,-93.09774"
+    end
+  end
+
+  describe '#format_address' do
+    it "should return a formatted representation of the vehicle's street address location" do
+      expect(Formatter.format_address(vehicle)).to eq '1600 Grand Ave, St Paul'
+      expect(Formatter.format_address(vehicle_2)).to eq '10th & Park   park spot'
+      expect(Formatter.format_address(vehicle_3)).to eq 'Dr Justus Ohage Blvd, St Paul'
+      expect(Formatter.format_address(vehicle_4)).to eq 'Abbot Parkspot'
+    end
+  end
+
+  describe '#format_maps_uri' do
+    it "should return a google maps uri of the vehicle's street address location" do
+      expect(Formatter.format_maps_uri(vehicle)).to eq 'https://www.google.com/maps/preview?q=44.93999,-93.16789'
+    end
+  end
+
+  describe '#format_status' do
+    it ' should display the fuel leve and license plate of the vehicle' do
+      expect(Formatter.format_status(vehicle)).to eq '<<FUEL: 26>> AB0000'
+    end
+  end
+end

data/spec/freerider_spec.rb

@@ -0,0 +1,50 @@
+require 'spec_helper'
+# Read up on this to address deprecation warnings
+# http://stackoverflow.com/questions/20275510/how-to-avoid-deprecation-warning-for-stub-chain-in-rspec-3-0
+
+VEHICLES_JSON = '[{"address": "Grand Ave 1600, 55105 St Paul", "coordinates": [-93.16789, 44.93999, 0], "engineType": "CE", "exterior": "GOOD", "fuel": 26, "interior": "GOOD", "name": "AB1111", "smartPhoneRequired": false, "vin": "AAAAA0AA0AA000000" }, { "address": "West Kellogg Boulevard 15, 55102 St Paul", "coordinates": [-93.093654, 44.943895, 0], "engineType": "CE", "exterior": "GOOD", "fuel": 25, "interior": "GOOD", "name": "AB6860", "smartPhoneRequired": false, "vin": "AAAAA1AA1AA111111" }, { "address": "South 5th Street 350, 55415 Minneapolis", "coordinates": [-93.265769, 44.976851, 0], "engineType": "CE", "exterior": "GOOD", "fuel": 24, "interior": "GOOD", "name": "AB0000", "smartPhoneRequired": false, "vin": "AAAAA2AA2AA222222"}]'
+
+##
+# Test stub for Caruby2go
+class Caruby2go
+  attr_accessor :key
+  attr_accessor :location
+
+  def initialize(key, location)
+    @key = key
+    @location = location
+  end
+
+  def vehicles
+    JSON.parse VEHICLES_JSON
+  end
+end
+
+##
+# Add accessor for Caruby2go instance to Freerider
+class Freerider
+  attr_reader :car2go
+end
+
+describe Freerider do
+  subject { Freerider.new('twincities', 'fake_key', 'Grand Ave 1600, 55105 St Paul') }
+
+  describe '#find_vehicles' do
+    it 'should return json for all vehicles below 25 by default' do
+      vehicles = subject.find_vehicles
+      expect(vehicles.size).to eq 1
+      expect(subject.car2go.location).to eq 'twincities'
+    end
+
+    it 'should return json for all vehicles below specified threshold' do
+      vehicles = subject.find_vehicles(26)
+      expect(vehicles.size).to eq 2
+      expect(subject.car2go.location).to eq 'twincities'
+    end
+
+    it 'should return json for all vehicles within the given radius' do
+      vehicles = subject.find_vehicles(100, 1)
+      expect(vehicles.size).to eq 1
+    end
+  end
+end

data/spec/geolocutor_spec.rb

@@ -0,0 +1,58 @@
+require 'spec_helper'
+
+describe Geolocutor do
+  let(:vehicle) { '{"address":"Grand Ave 1600, 55105 St Paul","coordinates":[-93.16789,44.93999,0],"engineType":"CE","exterior":"GOOD","fuel":26,"interior":"GOOD","name":"AB0000","smartPhoneRequired":false,"vin":"AAAAA0AA0AA000000"}' }
+  let(:vehicle_2) { '{"address":"10th & Park   park spot","coordinates":[-93.26529,44.97035,0],"engineType":"CE","exterior":"GOOD","fuel":18,"interior":"GOOD","name":"AB1111","smartPhoneRequired":false,"vin":"BAAAA0AA0AA000000"}' }
+  let(:vehicle_3) { '{"address":"Dr Justus Ohage Blvd, 55107 St Paul","coordinates":[-93.09774,44.93669,0],"engineType":"CE","exterior":"GOOD","fuel":100,"interior":"GOOD","name":"AB2222","smartPhoneRequired":false,"vin":"BAAAA0AA0AA000001"}' }
+  let(:vehicle_4) { '{"address":"Abbot Parkspot","coordinates":[-93.27623,44.96604,0],"engineType":"CE","exterior":"BAD","fuel":1,"interior":"GOOD","name":"AB3333","smartPhoneRequired":false,"vin":"BAAAA0AA0AA000003"}' }
+
+  describe '#initialize' do
+    it 'should create coordinates from address' do
+      geolocutor = Geolocutor.new('1600 Grand Ave, Saint Paul, MN')
+      (geolocutor.coordinates).should eql([44.9397631, -93.1687294])
+    end
+
+    it 'should preserve passed-in coordinates' do
+      geolocutor = Geolocutor.new [44.93999, -93.16789]
+      (geolocutor.coordinates).should eql([44.9397631, -93.1687294])
+    end
+
+    it 'should raise an error if no location passed in' do
+      expect { Geolocutor.new nil }.to raise_error(ArgumentError, 'You must supply coordinates, and address or a location name')
+    end
+  end
+
+  describe '#extract_coordinates' do
+    it 'should grab coordinates from vehicle JSON' do
+      geolocutor = Geolocutor.new('1600 Grand Ave, Saint Paul, MN')
+      coordinates = geolocutor.send(:extract_coordinates, JSON.parse(vehicle))
+      coordinates.should eql([44.93999, -93.16789])
+    end
+  end
+
+  describe '#distance_from_here' do
+    before do
+      @geolocutor = Geolocutor.new('1600 Grand Ave, Saint Paul, MN')
+    end
+
+    it 'should return zero when the from and to are the same' do
+      distance = @geolocutor.distance_from_here(JSON.parse(vehicle))
+      distance.should eq 0
+    end
+
+    context 'when looking for the disance in miles' do
+      it 'should return the proper value' do
+        distance = @geolocutor.distance_from_here(JSON.parse(vehicle_2))
+        distance.should eql 3.215852550959139
+      end
+    end
+
+    context 'when looking for the disance in kilometers' do
+      it 'should return the proper value' do
+        geolocutor = Geolocutor.new('1600 Grand Ave, Saint Paul, MN', true)
+        distance = geolocutor.distance_from_here(JSON.parse(vehicle_2))
+        distance.should eq 8.329019877940437
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+require 'pry'
+require 'freerider'
+require 'formatter'
+require 'geolocutor'

metadata

@@ -0,0 +1,222 @@
+--- !ruby/object:Gem::Specification
+name: freerider
+version: !ruby/object:Gem::Version
+  version: 0.0.4
+platform: ruby
+authors:
+- Eric Ebbesen
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: caruby2go
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: geocoder
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-nc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry-remote
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry-nav
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: car2go offers 20 minutes of free time when you refuel a vehicle that
+  is less than 25 percent fueled. freerider identifies car2go vehicles in your area
+  which you can refuel for free minutes!
+email:
+- git.eebbesen@gmail.com
+executables:
+- freerider
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/freerider
+- build
+- freerider.gemspec
+- lib/formatter.rb
+- lib/freerider.rb
+- lib/freerider/version.rb
+- lib/geolocutor.rb
+- spec/formatter_spec.rb
+- spec/freerider_spec.rb
+- spec/geolocutor_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/eebbesen/freerider
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Locate local car2go vehicles that need to be fueled.
+test_files:
+- spec/formatter_spec.rb
+- spec/freerider_spec.rb
+- spec/geolocutor_spec.rb
+- spec/spec_helper.rb