sfpark 0.0.1

data/.gitignore

@@ -0,0 +1,40 @@
+*.gem
+*.rbc
+*.sw[a-p]
+*.tmproj
+*.tmproject
+*.un~
+*~
+.DS_Store
+.Spotlight-V100
+.Trashes
+._*
+.bundle
+.config
+.directory
+.elc
+.emacs.desktop
+.emacs.desktop.lock
+.redcar
+.yardoc
+Desktop.ini
+Gemfile.lock
+Icon?
+InstalledFiles
+Session.vim
+Thumbs.db
+\#*\#
+_yardoc
+auto-save-list
+coverage
+doc
+lib/bundler/man
+pkg
+pkg/*
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+tmtags
+tramp

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format=nested
+--backtrace

data/.travis.yml

@@ -0,0 +1,8 @@
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - jruby
+  - rbx
+  - rbx-2.0
+  - ree

data/.yardopts

@@ -0,0 +1,3 @@
+--markup markdown
+-
+LICENSE.md

data/Gemfile

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

data/LICENSE.md

@@ -0,0 +1,10 @@
+Copyright (c) 2011, Code for America
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+* Neither the name of Code for America nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,90 @@
+# SF Park
+Ruby wrapper for the SF Park API
+
+## <a name="installation">Installation</a>
+    gem install sfpark
+
+## <a name="documentation">Documentation</a>
+[http://rdoc.info/gems/sfpark](http://rdoc.info/gems/sfpark)
+
+## <a name="ci">Continuous Integration</a>
+[![Build Status](https://secure.travis-ci.org/codeforamerica/sfpark.png)](http://travis-ci.org/codeforamerica/sfpark)
+
+## <a name="examples">Usage Examples</a>
+    require 'sfpark'
+
+    @client = SFPark.new
+    @client.availability # Return an array of 25 parking spots
+    @client.availability(:lat => 37.792275,:long => -122.397089,:radius => 0.25, :uom => 'mile') #Return array with specified area
+
+## <a name="contributing">Contributing</a>
+In the spirit of [free software](http://www.fsf.org/licensing/essays/free-sw.html), **everyone** is encouraged to help improve this project.
+
+Here are some ways *you* can contribute:
+
+* by using alpha, beta, and prerelease versions
+* by reporting bugs
+* by suggesting new features
+* by writing or editing documentation
+* by writing specifications
+* by writing code (**no patch is too small**: fix typos, add comments, clean up inconsistent whitespace)
+* by refactoring code
+* by resolving [issues](https://github.com/codeforamerica/sfpark/issues)
+* by reviewing patches
+* [financially](https://secure.codeforamerica.org/page/contribute)
+
+## <a name="issues">Submitting an Issue</a>
+We use the [GitHub issue tracker](https://github.com/codeforamerica/sfpark/issues)
+to track bugs and features. Before submitting a bug report or feature request,
+check to make sure it hasn't already been submitted. You can indicate support
+for an existing issuse by voting it up. When submitting a bug report, please
+include a [Gist](https://gist.github.com/) that includes a stack trace and any
+details that may be necessary to reproduce the bug, including your gem version,
+Ruby version, and operating system. Ideally, a bug report should include a pull
+request with failing specs.
+
+## <a name="pulls">Submitting a Pull Request</a>
+1. Fork the project.
+2. Create a topic branch.
+3. Implement your feature or bug fix.
+4. Add documentation for your feature or bug fix.
+5. Run <tt>bundle exec rake doc:yard</tt>. If your changes are not 100% documented, go back to step 4.
+6. Add specs for your feature or bug fix.
+7. Run <tt>bundle exec rake spec</tt>. If your changes are not 100% covered, go back to step 6.
+8. Commit and push your changes.
+9. Submit a pull request. Please do not include changes to the gemspec, version, or history file. (If you want to create your own version for some reason, please do so in a separate commit.)
+
+## <a name="rubies">Supported Rubies</a>
+This library aims to support and is [tested
+against](http://travis-ci.org/codeforamerica/sfpark) the following
+Ruby implementations:
+
+* Ruby 1.8.7
+* Ruby 1.9.2
+* Ruby 1.9.3
+* [JRuby](http://www.jruby.org/)
+* [Rubinius](http://rubini.us/)
+* [Ruby Enterprise Edition](http://www.rubyenterpriseedition.com/)
+
+If something doesn't work on one of these interpreters, it should be considered
+a bug.
+
+This library may inadvertently work (or seem to work) on other Ruby
+implementations, however support will only be provided for the versions listed
+above.
+
+If you would like this library to support another Ruby version, you may
+volunteer to be a maintainer. Being a maintainer entails making sure all tests
+run and pass on that implementation. When something breaks on your
+implementation, you will be personally responsible for providing patches in a
+timely fashion. If critical issues for a particular implementation exist at the
+time of a major release, support for that Ruby version may be dropped.
+
+## Credits
+SF Park API - [API](http://sfpark.org/resources/sfpark-availability-service-api-reference/)
+
+## <a name="copyright">Copyright</a>
+Copyright (c) 2011 Code for America.
+See [LICENSE](https://github.com/codeforamerica/sfpark/blob/master/LICENSE.md) for details.
+
+[![Code for America Tracker](http://stats.codeforamerica.org/codeforamerica/sfpark.png)](http://stats.codeforamerica.org/projects/sfpark)

data/Rakefile

@@ -0,0 +1,18 @@
+#!/usr/bin/env rake
+
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+task :test => :spec
+
+require 'yard'
+namespace :doc do
+  YARD::Rake::YardocTask.new do |task|
+    task.files   = ['LICENSE.md', 'lib/**/*.rb']
+    task.options = ['--markup', 'markdown']
+  end
+end

data/lib/sfpark.rb

@@ -0,0 +1,24 @@
+require 'sfpark/configuration'
+require 'sfpark/client'
+
+module SFPark
+  extend Configuration
+  class << self
+    # Alias for SFPark::Client.new
+    #
+    # @return [SFPark::Client]
+    def new(options={})
+      SFPark::Client.new(options)
+    end
+
+    # Delegate to SFPark::Client.new
+    def method_missing(method, *args, &block)
+      return super unless new.respond_to?(method)
+      new.send(method, *args, &block)
+    end
+
+    def respond_to?(method, include_private=false)
+      new.respond_to?(method, include_private) || super(method, include_private)
+    end
+  end
+end

data/lib/sfpark/client.rb

@@ -0,0 +1,23 @@
+require 'sfpark/connection'
+require 'sfpark/request'
+
+require 'sfpark/client/availability'
+
+module SFPark
+  class Client
+    attr_accessor(*Configuration::VALID_OPTIONS_KEYS)
+
+    def initialize(options={})
+      options = SFPark.options.merge(options)
+      Configuration::VALID_OPTIONS_KEYS.each do |key|
+        send("#{key}=", options[key])
+      end
+    end
+
+    include SFPark::Connection
+    include SFPark::Request
+
+    include SFPark::Client::Availability
+
+  end
+end

data/lib/sfpark/client/availability.rb

@@ -0,0 +1,27 @@
+module SFPark
+  class Client
+    module Availability
+
+      # Get the availiablity for parking in San Francisco
+      #
+      # @see http://sfpark.org/resources/sfpark-availability-service-api-reference/
+      # @param options [Hash] A customizable set of options.
+      # @option options requestid [String] Request parameter allows correlating a response to a particular request
+      # @option options lat [String]  Latitude in decimal format to be specified along with LONG.
+      # @option options long [String] Longitude in decimal format to be specified along with LAT.
+      # @option options radius [String] Search Radius
+      # @option options uom [String] Unit of Measurement for the search radius mile, km, foot, meter, m, yard
+      # @option options type [String] Limit data to specified parking type
+      # @option options method [String] Method to invoke
+      # @option options pricing [String]  Include rate information in response values: no, yes
+      # @return [Array<Hashie::Mash>]
+      # @example
+      #   SFPark.availability
+      #   SFPark.availability(:lat => 37.792275,:long => -122.397089,:radius => 0.25, :uom => 'mile')
+      def availability(options={})
+        get("availabilityservice", options)
+      end
+    end
+
+  end
+end

data/lib/sfpark/configuration.rb

@@ -0,0 +1,65 @@
+require 'sfpark/version'
+
+module SFPark
+  # Defines constants and methods related to configuration
+  module Configuration
+    # An array of valid keys in the options hash when configuring a {SfPark::API}
+    VALID_OPTIONS_KEYS = [
+      :adapter,
+      :endpoint,
+      :proxy,
+      :response,
+      :user_agent,
+      :faraday_options].freeze
+
+    # The adapter that will be used to connect if none is set
+    DEFAULT_ADAPTER = :net_http
+
+    # The endpoint that will be used to connect if none is set
+    DEFAULT_ENDPOINT = 'http://api.sfpark.org/sfpark/rest'.freeze
+
+    # The response format appended to the path and sent in the 'Accept' header if none is set
+    #
+    # @note JSON is preferred over XML because it is more concise and faster to parse.
+    DEFAULT_RESPONSE = :json
+
+    # By default, don't use a proxy server
+    DEFAULT_PROXY = nil
+
+    # The value sent in the 'User-Agent' header if none is set
+    DEFAULT_USER_AGENT = "SFPark Ruby Gem #{SFPark::VERSION}".freeze
+
+    DEFAULT_FARADAY_OPTIONS = {}.freeze
+
+    # @private
+    attr_accessor *VALID_OPTIONS_KEYS
+
+    # When this module is extended, set all configuration options to their default values
+    def self.extended(base)
+      base.reset
+    end
+
+    # Convenience method to allow configuration options to be set in a block
+    def configure
+      yield self
+    end
+
+    # Create a hash of options and their values
+    def options
+      options = {}
+      VALID_OPTIONS_KEYS.each{|k| options[k] = send(k)}
+      options
+    end
+
+    # Reset all configuration options to defaults
+    def reset
+      self.adapter                = DEFAULT_ADAPTER
+      self.endpoint               = DEFAULT_ENDPOINT
+      self.proxy                  = DEFAULT_PROXY
+      self.user_agent             = DEFAULT_USER_AGENT
+      self.response               = DEFAULT_RESPONSE
+      self.faraday_options        = DEFAULT_FARADAY_OPTIONS
+      self
+    end
+  end
+end

data/lib/sfpark/connection.rb

@@ -0,0 +1,27 @@
+require 'faraday_middleware'
+
+module SFPark
+  module Connection
+    private
+
+ def connection(options={})
+    merged_options = faraday_options.merge({
+        :headers => {
+          'Accept' => "application/#{response}",
+          'User-Agent' => user_agent
+        },
+        :ssl => {:verify => false},
+        :url => endpoint
+      })
+
+      Faraday.new(merged_options) do |builder|
+        builder.use Faraday::Request::UrlEncoded
+        builder.use Faraday::Response::RaiseError
+        builder.use Faraday::Response::Rashify
+        builder.use Faraday::Response::Mashify
+        builder.use Faraday::Response::ParseJson
+        builder.adapter(Faraday.default_adapter)
+      end
+    end
+  end
+end

data/lib/sfpark/request.rb

@@ -0,0 +1,17 @@
+module SFPark
+  module Request
+    def get(path, options={})
+      request(:get, path, options)
+    end
+
+    private
+
+    def request(method, path, options)
+      response = connection.send(method) do |request|
+        request.url(path, options)
+        request.params['response'] = 'json'
+      end
+      response.body
+    end
+  end
+end

data/lib/sfpark/version.rb

@@ -0,0 +1,3 @@
+module SFPark
+  VERSION = "0.0.1"
+end

data/sfpark.gemspec

@@ -0,0 +1,27 @@
+# encoding: utf-8
+require File.expand_path('../lib/sfpark/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.add_dependency 'faraday', '~> 0.7.4'
+  gem.add_dependency 'faraday_middleware', '~> 0.7.0'
+  gem.add_dependency 'hashie', '~> 1.1.0'
+  gem.add_dependency 'multi_json', '~> 1.0.2'
+  gem.add_dependency 'rash', '~> 0.3.0'
+  gem.add_development_dependency 'rake', '~> 0.9'
+  gem.add_development_dependency 'rdiscount', '~> 1.6'
+  gem.add_development_dependency 'rspec', '~> 2.6'
+  gem.add_development_dependency 'simplecov', '~> 0.4'
+  gem.add_development_dependency 'webmock', '~> 1.7'
+  gem.add_development_dependency 'yard', '~> 0.7'
+  gem.author      = "Ryan Resella"
+  gem.description = %q{Ruby Wrapper for the SF Park API}
+  gem.email       = 'ryan@codeforamerica.org'
+  gem.executables = `git ls-files -- bin/*`.split("\n").map{|f| File.basename(f)}
+  gem.files       = `git ls-files`.split("\n")
+  gem.homepage    = ''
+  gem.name        = 'sfpark'
+  gem.require_paths = ['lib']
+  gem.summary     = gem.description
+  gem.test_files  = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.version     = SFPark::VERSION
+end

data/spec/faraday/response_spec.rb

@@ -0,0 +1,33 @@
+require 'helper'
+
+describe Faraday::Response do
+  before do
+    @client = SFPark::Client.new
+  end
+
+  {
+    400 => Faraday::Error::ClientError,
+    401 => Faraday::Error::ClientError,
+    403 => Faraday::Error::ClientError,
+    404 => Faraday::Error::ResourceNotFound,
+    406 => Faraday::Error::ClientError,
+    500 => Faraday::Error::ClientError,
+    501 => Faraday::Error::ClientError,
+    502 => Faraday::Error::ClientError,
+    503 => Faraday::Error::ClientError,
+  }.each do |status, exception|
+    context "when HTTP status is #{status}" do
+
+      before do
+        stub_get("/availabilityservice?response=json").
+          to_return(:status => status, :body => fixture("availability.json"))
+      end
+
+      it "should raise #{exception.name} error" do
+        lambda do
+          @client.availability
+        end.should raise_error exception
+      end
+    end
+  end
+end

data/spec/fixtures/availability.json

@@ -0,0 +1 @@
+{"STATUS":"SUCCESS","NUM_RECORDS":"25","MESSAGE":"25 records found","AVAILABILITY_UPDATED_TIMESTAMP":"2011-10-27T14:08:11.378-07:00","AVAILABILITY_REQUEST_TIMESTAMP":"2011-10-27T14:08:11.292-07:00","AVL":[{"TYPE":"OFF","OSPID":"931","NAME":"Civic Center Garage","DESC":"355 McAllister Street","INTER":"McAllister between Larkin & Polk","TEL":"(415) 863-1537","OPHRS":{"OPS":[{"FROM":"Monday","TO":"Friday","BEG":"6:00 AM","END":"12:00 AM"},{"FROM":"Saturday","BEG":"8:00 AM","END":"12:00 AM"},{"FROM":"Sunday","BEG":"9:00 AM","END":"10:00 PM"}]},"OCC":"608","OPER":"843","PTS":"1","LOC":"-122.4177671135,37.7802465669"},{"TYPE":"ON","BFID":"640011","NAME":"Redwood St (101-199)","OCC":"3","OPER":"4","PTS":"2","LOC":"-122.4192828405,37.7806708912,-122.4201217059,37.7805642728"},{"TYPE":"ON","BFID":"442061","NAME":"Golden Gate Ave (601-699)","OCC":"15","OPER":"16","PTS":"2","LOC":"-122.4206608328,37.7809344196,-122.4218356468,37.7807855562"},{"TYPE":"ON","BFID":"542022","NAME":"Larkin St (200-298)","OCC":"1","OPER":"3","PTS":"2","LOC":"-122.4167139409,37.7798410783,-122.4167913901,37.7802293301"},{"TYPE":"ON","BFID":"419042","NAME":"Franklin St (400-598)","OCC":"6","OPER":"6","PTS":"2","LOC":"-122.4214765641,37.7782428083,-122.4216354858,37.7790283645"},{"TYPE":"ON","BFID":"419051","NAME":"Franklin St (501-599)","OCC":"10","OPER":"12","PTS":"2","LOC":"-122.4218175417,37.7790474754,-122.4219603701,37.779757594"},{"TYPE":"ON","BFID":"701042","NAME":"Van Ness Ave (300-498)","OCC":"6","OPER":"6","PTS":"2","LOC":"-122.4199114866,37.7792134379,-122.4200020117,37.7796640515"},{"TYPE":"ON","BFID":"701052","NAME":"Van Ness Ave (500-598)","OCC":"7","OPER":"7","PTS":"2","LOC":"-122.4201267351,37.7802806276,-122.4202504526,37.7808901629"},{"TYPE":"ON","BFID":"701031","NAME":"Van Ness Ave (301-499)","OCC":"3","OPER":"8","PTS":"2","LOC":"-122.4201589217,37.7785515993,-122.4201981493,37.7790243412"},{"TYPE":"ON","BFID":"701032","NAME":"Van Ness Ave (300-498)","OCC":"5","OPER":"6","PTS":"2","LOC":"-122.4198189499,37.7787557835,-122.4199014283,37.7791641521"},{"TYPE":"ON","BFID":"612032","NAME":"Polk St (300-398)","OCC":"10","OPER":"12","PTS":"2","LOC":"-122.4183011467,37.7794659022,-122.4184238584,37.7800704084"},{"TYPE":"ON","BFID":"419052","NAME":"Franklin St (466-598)","OCC":"3","OPER":"7","PTS":"2","LOC":"-122.4216807483,37.7792536713,-122.4217873667,37.7797777107"},{"TYPE":"ON","BFID":"442072","NAME":"Golden Gate Ave (700-798)","OCC":"8","OPER":"17","PTS":"2","LOC":"-122.4222450211,37.7808690404,-122.4235083484,37.780708107"},{"TYPE":"ON","BFID":"442062","NAME":"Golden Gate Ave (600-698)","OCC":"11","OPER":"13","PTS":"2","LOC":"-122.4207402937,37.7810601489,-122.4218507343,37.7809193321"},{"TYPE":"ON","BFID":"563042","NAME":"Mcallister St (400-498)","OCC":"12","OPER":"13","PTS":"2","LOC":"-122.419091732,37.780308791,-122.4200211225,37.7801901026"},{"TYPE":"ON","BFID":"563032","NAME":"Mcallister St (300-398)","OCC":"6","OPER":"7","PTS":"2","LOC":"-122.4174542346,37.7805169986,-122.4184771676,37.780387246"},{"TYPE":"ON","BFID":"701041","NAME":"Van Ness Ave (301-499)","OCC":"5","OPER":"5","PTS":"2","LOC":"-122.4202253068,37.7791571112,-122.4203791994,37.7796399115"},{"TYPE":"ON","BFID":"563031","NAME":"Mcallister St (301-399)","OCC":"13","OPER":"16","PTS":"2","LOC":"-122.4171685778,37.7803480185,-122.4177942064,37.7802675518"},{"TYPE":"ON","BFID":"563051","NAME":"Mcallister St (501-599)","OCC":"8","OPER":"10","PTS":"2","LOC":"-122.4205019111,37.7800040233,-122.4217109234,37.7798501308"},{"TYPE":"ON","BFID":"563052","NAME":"Mcallister St (500-598)","OCC":"3","OPER":"15","PTS":"2","LOC":"-122.4207986321,37.7800915309,-122.4217742909,37.7799668075"},{"TYPE":"ON","BFID":"542021","NAME":"Larkin St (201-299)","OCC":"7","OPER":"7","PTS":"2","LOC":"-122.4169814927,37.779933615,-122.4170207202,37.7801307584"},{"TYPE":"ON","BFID":"419041","NAME":"Franklin St (401-499)","OCC":"4","OPER":"9","PTS":"2","LOC":"-122.4216395092,37.7781683766,-122.4217521625,37.7787276202"},{"TYPE":"ON","BFID":"701051","NAME":"Van Ness Ave (501-599)","OCC":"10","OPER":"11","PTS":"2","LOC":"-122.4204455844,37.7802454235,-122.4205703078,37.7808619996"},{"TYPE":"ON","BFID":"542011","NAME":"Larkin St (101-199)","OCC":"7","OPER":"14","PTS":"2","LOC":"-122.4167682559,37.7788654194,-122.4168587809,37.7793200563"},{"TYPE":"ON","BFID":"442071","NAME":"Golden Gate Ave (701-799)","OCC":"2","OPER":"11","PTS":"2","LOC":"-122.4222550795,37.780732247,-122.4235234359,37.7805703078"}]}

data/spec/fixtures/availability_params.json

@@ -0,0 +1 @@
+{"STATUS":"SUCCESS","NUM_RECORDS":"67","MESSAGE":"67 records found","AVAILABILITY_UPDATED_TIMESTAMP":"2011-10-27T14:07:41.749-07:00","AVAILABILITY_REQUEST_TIMESTAMP":"2011-10-27T14:07:41.655-07:00","AVL":[{"TYPE":"OFF","OSPID":"934","NAME":"Golden Gateway Garage","DESC":"250 Clay Street","INTER":"Clay between Front & Davis","TEL":"(415) 433-4722","OPHRS":{"OPS":[{"FROM":"Monday","TO":"Friday","BEG":"4:00 AM","END":"10:00 PM"},{"FROM":"Saturday","BEG":"7:00 AM","END":"10:00 PM"},{"FROM":"Sunday","BEG":"9:00 AM","END":"10:00 PM"}]},"OCC":"1054","OPER":"1095","PTS":"1","LOC":"-122.3986032,37.79544154"},{"TYPE":"ON","BFID":"651001","NAME":"Sansome St (1-99)","OCC":"0","OPER":"0","PTS":"2","LOC":"-122.4007030779,37.790581372,-122.4007936029,37.7910219272"},{"TYPE":"ON","BFID":"380002","NAME":"Davis St (2-98)","OCC":"1","OPER":"3","PTS":"2","LOC":"-122.3973757795,37.792760008,-122.3974994971,37.7933584792"},{"TYPE":"ON","BFID":"650011","NAME":"Sacramento St (101-199)","OCC":"0","OPER":"0","PTS":"2","LOC":"-122.3967843492,37.7945222289,-122.397572923,37.7944216455"},{"TYPE":"ON","BFID":"606011","NAME":"Pine St (101-199)","OCC":"0","OPER":"0","PTS":"2","LOC":"-122.3986944277,37.792336552,-122.3995503923,37.7922289278"},{"TYPE":"ON","BFID":"568003","NAME":"Mission St (35-99)","OCC":"7","OPER":"10","PTS":"2","LOC":"-122.393262925,37.7930637699,-122.3938030577,37.7926352847"},{"TYPE":"ON","BFID":"380001","NAME":"Davis St (1-99)","OCC":"2","OPER":"4","PTS":"2","LOC":"-122.3975186079,37.7926704888,-122.3976483605,37.793299135"},{"TYPE":"ON","BFID":"380022","NAME":"Davis St (200-398)","OCC":"0","OPER":"1","PTS":"2","LOC":"-122.3977318447,37.7945564273,-122.3978585798,37.7951810501"},{"TYPE":"ON","BFID":"651012","NAME":"Sansome St (100-198)","OCC":"1","OPER":"1","PTS":"2","LOC":"-122.4007131362,37.7914031382,-122.4007875679,37.7917632267"},{"TYPE":"ON","BFID":"568002","NAME":"Mission St (2-34)","OCC":"1","OPER":"1","PTS":"2","LOC":"-122.3928002414,37.7936552002,-122.3931090324,37.7934087709"},{"TYPE":"ON","BFID":"422021","NAME":"Front St (201-299)","OCC":"2","OPER":"3","PTS":"2","LOC":"-122.3989307986,37.7936883927,-122.3990062362,37.7941762221"},{"TYPE":"ON","BFID":"665012","NAME":"Steuart St (100-198)","OCC":"11","OPER":"17","PTS":"2","LOC":"-122.393068799,37.793032589,-122.3918446993,37.7920559244"},{"TYPE":"ON","BFID":"324032","NAME":"Battery St (300-398)","OCC":"0","OPER":"2","PTS":"2","LOC":"-122.4001046067,37.7943049688,-122.4002162543,37.7948481191"},{"TYPE":"ON","BFID":"380031","NAME":"Davis St (301-399)","OCC":"9","OPER":"11","PTS":"2","LOC":"-122.3980818749,37.7954475961,-122.3982035808,37.796047073"},{"TYPE":"ON","BFID":"606031","NAME":"Pine St (301-399)","OCC":"7","OPER":"10","PTS":"2","LOC":"-122.4011265339,37.7920297727,-122.4024381412,37.7918628043"},{"TYPE":"ON","BFID":"561002","NAME":"Main St (2-98)","OCC":"2","OPER":"3","PTS":"2","LOC":"-122.3964272782,37.7929330115,-122.3951579159,37.7919201368"},{"TYPE":"ON","BFID":"568004","NAME":"Mission St (36-98)","OCC":"6","OPER":"8","PTS":"2","LOC":"-122.3939800845,37.7926986522,-122.3934148059,37.7931472541"},{"TYPE":"ON","BFID":"661001","NAME":"Stevenson St (1-37)","OCC":"0","OPER":"0","PTS":"2","LOC":"-122.3987688594,37.7903832227,-122.3992053913,37.7900382217"},{"TYPE":"ON","BFID":"324021","NAME":"Battery St (201-299)","OCC":"0","OPER":"0","PTS":"2","LOC":"-122.4000673909,37.7933393683,-122.4002001609,37.793983102"},{"TYPE":"ON","BFID":"386022","NAME":"Drumm St (200-298)","OCC":"4","OPER":"5","PTS":"2","LOC":"-122.3966596258,37.7956276403,-122.3967752967,37.7962180648"},{"TYPE":"ON","BFID":"665011","NAME":"Steuart St (101-199)","OCC":"1","OPER":"7","PTS":"2","LOC":"-122.392966204,37.7931754174,-122.3916908067,37.7921575136"},{"TYPE":"ON","BFID":"359012","NAME":"Clay St (100-198)","OCC":"12","OPER":"13","PTS":"2","LOC":"-122.3970046268,37.7954828002,-122.3978314222,37.7953771877"},{"TYPE":"ON","BFID":"324022","NAME":"Battery St (200-298)","OCC":"0","OPER":"2","PTS":"2","LOC":"-122.3999064575,37.7933433917,-122.4000432509,37.7940112653"},{"TYPE":"ON","BFID":"650041","NAME":"Sacramento St (401-499)","OCC":"2","OPER":"2","PTS":"2","LOC":"-122.4003480185,37.7940625629,-122.4011607322,37.793958962"},{"TYPE":"ON","BFID":"651022","NAME":"Sansome St (200-298)","OCC":"0","OPER":"0","PTS":"2","LOC":"-122.4008951921,37.7922802253,-122.4010309797,37.7929370348"},{"TYPE":"ON","BFID":"460021","NAME":"Halleck St (101-149)","OCC":"0","OPER":"0","PTS":"2","LOC":"-122.4013840274,37.7935013076,-122.4015520016,37.7934801851"},{"TYPE":"ON","BFID":"386011","NAME":"Drumm St (101-199)","OCC":"0","OPER":"0","PTS":"2","LOC":"-122.3967179642,37.7946710923,-122.3968074834,37.7951146651"},{"TYPE":"ON","BFID":"606002","NAME":"Pine St (2-98)","OCC":"5","OPER":"6","PTS":"2","LOC":"-122.3976644538,37.7925900221,-122.3984671092,37.7924874271"},{"TYPE":"ON","BFID":"420001","NAME":"Fremont St (1-99)","OCC":"0","OPER":"0","PTS":"2","LOC":"-122.3975528063,37.7912502515,-122.3967773084,37.7906326695"},{"TYPE":"ON","BFID":"201001","NAME":"1st St (1-99)","OCC":"0","OPER":"0","PTS":"2","LOC":"-122.3989076645,37.7909273788,-122.3976322671,37.7899245625"},{"TYPE":"ON","BFID":"666001","NAME":"Sutter St (51-99)","OCC":"0","OPER":"1","PTS":"2","LOC":"-122.4007825387,37.7901649567,-122.4020478777,37.7900030175"},{"TYPE":"ON","BFID":"328002","NAME":"Beale St (2-98)","OCC":"3","OPER":"4","PTS":"2","LOC":"-122.3972812311,37.7922017703,-122.396047073,37.7912180648"},{"TYPE":"ON","BFID":"651021","NAME":"Sansome St (201-299)","OCC":"2","OPER":"2","PTS":"2","LOC":"-122.4010440555,37.7922420036,-122.4011748139,37.7928766848"},{"TYPE":"ON","BFID":"422032","NAME":"Front St (300-398)","OCC":"0","OPER":"0","PTS":"2","LOC":"-122.3989187286,37.7944669081,-122.3990474754,37.7950985717"},{"TYPE":"ON","BFID":"386001","NAME":"Drumm St (7-99)","OCC":"4","OPER":"7","PTS":"2","LOC":"-122.3965379199,37.7937869644,-122.3966686783,37.7944276805"},{"TYPE":"ON","BFID":"328001","NAME":"Beale St (1-99)","OCC":"9","OPER":"9","PTS":"2","LOC":"-122.3970891169,37.7922751961,-122.3958911688,37.7913367532"},{"TYPE":"ON","BFID":"568001","NAME":"Mission St (1-33)","OCC":"3","OPER":"3","PTS":"2","LOC":"-122.3927398914,37.7934781734,-122.3930094548,37.7932649366"},{"TYPE":"ON","BFID":"422011","NAME":"Front St (101-199)","OCC":"0","OPER":"1","PTS":"2","LOC":"-122.3986873868,37.7925005029,-122.3988372561,37.7932247033"},{"TYPE":"ON","BFID":"359011","NAME":"Clay St (101-199)","OCC":"0","OPER":"0","PTS":"2","LOC":"-122.3975568296,37.795338966,-122.397729833,37.7953178435"},{"TYPE":"ON","BFID":"422002","NAME":"Front St (2-98)","OCC":"0","OPER":"0","PTS":"2","LOC":"-122.3984842084,37.7922892778,-122.3984701267,37.7922208811"},{"TYPE":"ON","BFID":"422012","NAME":"Front St (100-198)","OCC":"0","OPER":"0","PTS":"2","LOC":"-122.3985405351,37.7925598471,-122.3986813518,37.7932438141"},{"TYPE":"ON","BFID":"606012","NAME":"Pine St (100-198)","OCC":"2","OPER":"2","PTS":"2","LOC":"-122.398734661,37.7924421646,-122.3996509757,37.7923264937"},{"TYPE":"ON","BFID":"380011","NAME":"Davis St (101-199)","OCC":"4","OPER":"8","PTS":"2","LOC":"-122.3977690606,37.7938915711,-122.3978525448,37.7942848521"},{"TYPE":"ON","BFID":"386012","NAME":"Drumm St (100-198)","OCC":"2","OPER":"2","PTS":"2","LOC":"-122.3964765641,37.7947254074,-122.3966073225,37.7953701469"},{"TYPE":"ON","BFID":"420002","NAME":"Fremont St (2-98)","OCC":"2","OPER":"3","PTS":"2","LOC":"-122.397735868,37.7911929189,-122.3968638101,37.7904968819"},{"TYPE":"ON","BFID":"650021","NAME":"Sacramento St (201-299)","OCC":"0","OPER":"1","PTS":"2","LOC":"-122.3980114665,37.7943663247,-122.3987799236,37.794267753"},{"TYPE":"ON","BFID":"422001","NAME":"Front St (1-99)","OCC":"0","OPER":"0","PTS":"2","LOC":"-122.3985566284,37.7918607926,-122.3986391068,37.7922711728"},{"TYPE":"ON","BFID":"386021","NAME":"Drumm St (201-299)","OCC":"5","OPER":"5","PTS":"2","LOC":"-122.3969020318,37.7955773486,-122.3970348019,37.7962321464"},{"TYPE":"ON","BFID":"569002","NAME":"Market St (2-198)","OCC":"3","OPER":"4","PTS":"2","LOC":"-122.3948551599,37.7945956548,-122.3949617783,37.7945161939"},{"TYPE":"ON","BFID":"380012","NAME":"Davis St (100-198)","OCC":"2","OPER":"3","PTS":"2","LOC":"-122.3975648763,37.7936793402,-122.3976976463,37.7943049688"},{"TYPE":"ON","BFID":"420021","NAME":"Fremont St (201-299)","OCC":"5","OPER":"6","PTS":"2","LOC":"-122.3949446791,37.7891882921,-122.3942295313,37.7886179843"},{"TYPE":"ON","BFID":"830001","NAME":"The Embarcadero (101-199)","OCC":"12","OPER":"16","PTS":"2","LOC":"-122.3944407564,37.7950170992,-122.3949829008,37.7958308187"},{"TYPE":"ON","BFID":"651011","NAME":"Sansome St (101-199)","OCC":"0","OPER":"2","PTS":"2","LOC":"-122.4008509354,37.7912965198,-122.4009847113,37.7919472943"},{"TYPE":"ON","BFID":"651032","NAME":"Sansome St (300-398)","OCC":"0","OPER":"0","PTS":"2","LOC":"-122.4010963589,37.7932578958,-122.4012311406,37.7939187286"},{"TYPE":"ON","BFID":"831001","NAME":"The Embarcadero (101-199)","OCC":"6","OPER":"9","PTS":"2","LOC":"-122.394091732,37.7946871857,-122.3935445584,37.7943301147"},{"TYPE":"ON","BFID":"665002","NAME":"Steuart St (2-78)","OCC":"2","OPER":"5","PTS":"2","LOC":"-122.3946157715,37.7942657413,-122.394043452,37.7938090927"},{"TYPE":"ON","BFID":"606001","NAME":"Pine St (1-99)","OCC":"4","OPER":"5","PTS":"2","LOC":"-122.3977318447,37.7924542346,-122.3984349226,37.7923647153"},{"TYPE":"ON","BFID":"359032","NAME":"Clay St (302-398)","OCC":"7","OPER":"10","PTS":"2","LOC":"-122.3993260913,37.7952353651,-122.4001619392,37.7951287467"},{"TYPE":"ON","BFID":"422031","NAME":"Front St (301-399)","OCC":"0","OPER":"0","PTS":"2","LOC":"-122.3990897204,37.7944296922,-122.3992184671,37.795066385"},{"TYPE":"ON","BFID":"650031","NAME":"Sacramento St (301-399)","OCC":"0","OPER":"1","PTS":"2","LOC":"-122.3991711929,37.7942134379,-122.4000020117,37.7941078254"},{"TYPE":"ON","BFID":"606032","NAME":"Pine St (300-398)","OCC":"5","OPER":"5","PTS":"2","LOC":"-122.4011084289,37.7921384027,-122.4024441762,37.7919684168"},{"TYPE":"ON","BFID":"324031","NAME":"Battery St (301-399)","OCC":"2","OPER":"7","PTS":"2","LOC":"-122.4002474351,37.7942164554,-122.4003661235,37.7947917924"},{"TYPE":"ON","BFID":"201002","NAME":"1st St (2-98)","OCC":"4","OPER":"7","PTS":"2","LOC":"-122.3989941662,37.7907925971,-122.3978696439,37.7899084691"},{"TYPE":"ON","BFID":"422022","NAME":"Front St (200-298)","OCC":"1","OPER":"1","PTS":"2","LOC":"-122.3988322269,37.7939780728,-122.3987316435,37.7934992959"},{"TYPE":"ON","BFID":"380021","NAME":"Davis St (201-399)","OCC":"0","OPER":"0","PTS":"2","LOC":"-122.3979139006,37.7945755381,-122.3979973848,37.79498793"},{"TYPE":"ON","BFID":"651031","NAME":"Sansome St (343-399)","OCC":"0","OPER":"0","PTS":"2","LOC":"-122.4013216657,37.7935928385,-122.4013749749,37.7938523436"},{"TYPE":"ON","BFID":"359022","NAME":"Clay St (200-300)","OCC":"2","OPER":"2","PTS":"2","LOC":"-122.3981452424,37.7953862402,-122.3991098371,37.7952625226"}]}

data/spec/helper.rb

@@ -0,0 +1,27 @@
+$:.unshift File.expand_path('..', __FILE__)
+$:.unshift File.expand_path('../../lib', __FILE__)
+require 'simplecov'
+SimpleCov.start
+require 'sfpark'
+require 'rspec'
+require 'webmock/rspec'
+
+def a_get(url)
+  a_request(:get, sfpark_url(url))
+end
+
+def stub_get(url)
+  stub_request(:get, sfpark_url(url))
+end
+
+def fixture_path
+  File.expand_path("../fixtures", __FILE__)
+end
+
+def fixture(file)
+  File.new(fixture_path + '/' + file)
+end
+
+def sfpark_url(url)
+  "http://api.sfpark.org/sfpark/rest#{url}"
+end

data/spec/sfpark/availability_spec.rb

@@ -0,0 +1,34 @@
+require 'helper'
+
+describe SFPark::Client::Availability do
+  before do
+    @client = SFPark.new
+  end
+
+  describe "#availability" do
+    context "with no query parameters" do
+      before do
+        stub_get("/availabilityservice?response=json").
+          to_return(:status => 200, :body => fixture("availability.json"))
+      end
+
+      it "should return search the number of records available" do
+        search = @client.availability
+        search.num_records.should == "25"
+      end
+    end
+
+    context "with query paramaters" do
+      before do
+        stub_get("/availabilityservice?lat=37.792275&long=-122.397089&radius=0.25&uom=mile&response=json").
+          to_return(:status => 200, :body => fixture("availability_params.json"))
+      end
+
+      it "should return the num of records available" do
+        search = @client.availability(:lat => 37.792275,:long => -122.397089,:radius => 0.25, :uom => 'mile')
+        search.num_records.should == "67"
+      end
+    end
+
+  end
+end

data/spec/sfpark_spec.rb

@@ -0,0 +1,28 @@
+require 'helper'
+
+describe SFPark do
+  after do
+    SFPark.reset
+  end
+
+  describe ".respond_to?" do
+    it "should be true if method exists" do
+      SFPark.respond_to?(:new, true).should be_true
+    end
+  end
+
+  describe ".new" do
+    it "should be a SFPark::Client" do
+      SFPark.new.should be_a SFPark::Client
+    end
+  end
+
+  describe ".delegate" do
+    it "should delegate missing methods to SFPark::Client" do
+      stub_get("/availabilityservice?response=json").
+          to_return(:status => 200, :body => fixture("availability.json"))
+      records  = SFPark.availability
+      records.num_records.should == "25"
+    end
+  end
+end

metadata

@@ -0,0 +1,194 @@
+--- !ruby/object:Gem::Specification
+name: sfpark
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Ryan Resella
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-10-28 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: &70135710220620 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.4
+  type: :runtime
+  prerelease: false
+  version_requirements: *70135710220620
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: &70135710220120 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *70135710220120
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: &70135710219660 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *70135710219660
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: &70135710219200 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: *70135710219200
+- !ruby/object:Gem::Dependency
+  name: rash
+  requirement: &70135710218740 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *70135710218740
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &70135710218280 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: *70135710218280
+- !ruby/object:Gem::Dependency
+  name: rdiscount
+  requirement: &70135710217820 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: *70135710217820
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70135710217360 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :development
+  prerelease: false
+  version_requirements: *70135710217360
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: &70135710216900 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :development
+  prerelease: false
+  version_requirements: *70135710216900
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: &70135710247900 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: *70135710247900
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: &70135710247440 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: *70135710247440
+description: Ruby Wrapper for the SF Park API
+email: ryan@codeforamerica.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gemtest
+- .gitignore
+- .rspec
+- .travis.yml
+- .yardopts
+- Gemfile
+- LICENSE.md
+- README.md
+- Rakefile
+- lib/sfpark.rb
+- lib/sfpark/client.rb
+- lib/sfpark/client/availability.rb
+- lib/sfpark/configuration.rb
+- lib/sfpark/connection.rb
+- lib/sfpark/request.rb
+- lib/sfpark/version.rb
+- sfpark.gemspec
+- spec/faraday/response_spec.rb
+- spec/fixtures/availability.json
+- spec/fixtures/availability_params.json
+- spec/helper.rb
+- spec/sfpark/availability_spec.rb
+- spec/sfpark_spec.rb
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.6
+signing_key: 
+specification_version: 3
+summary: Ruby Wrapper for the SF Park API
+test_files:
+- spec/faraday/response_spec.rb
+- spec/fixtures/availability.json
+- spec/fixtures/availability_params.json
+- spec/helper.rb
+- spec/sfpark/availability_spec.rb
+- spec/sfpark_spec.rb