startupstats 0.0.1

data/.gitignore

@@ -0,0 +1,7 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+coverage/*
+.idea
+.DS_Store

data/.rvmrc

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+
+# This is an RVM Project .rvmrc file, used to automatically load the ruby
+# development environment upon cd'ing into the directory
+
+# First we specify our desired <ruby>[@<gemset>], the @gemset name is optional,
+# Only full ruby name is supported here, for short names use:
+#     echo "rvm use 1.9.3" > .rvmrc
+environment_id="ruby-1.9.3-p194@startupstats-client"
+
+# Uncomment the following lines if you want to verify rvm version per project
+# rvmrc_rvm_version="1.14.12 ()" # 1.10.1 seams as a safe start
+# eval "$(echo ${rvm_version}.${rvmrc_rvm_version} | awk -F. '{print "[[ "$1*65536+$2*256+$3" -ge "$4*65536+$5*256+$6" ]]"}' )" || {
+#   echo "This .rvmrc file requires at least RVM ${rvmrc_rvm_version}, aborting loading."
+#   return 1
+# }
+
+# First we attempt to load the desired environment directly from the environment
+# file. This is very fast and efficient compared to running through the entire
+# CLI and selector. If you want feedback on which environment was used then
+# insert the word 'use' after --create as this triggers verbose mode.
+if [[ -d "${rvm_path:-$HOME/.rvm}/environments"
+  && -s "${rvm_path:-$HOME/.rvm}/environments/$environment_id" ]]
+then
+  \. "${rvm_path:-$HOME/.rvm}/environments/$environment_id"
+  [[ -s "${rvm_path:-$HOME/.rvm}/hooks/after_use" ]] &&
+    \. "${rvm_path:-$HOME/.rvm}/hooks/after_use" || true
+else
+  # If the environment file has not yet been created, use the RVM CLI to select.
+  rvm --create  "$environment_id" || {
+    echo "Failed to create RVM environment '${environment_id}'."
+    return 1
+  }
+fi
+
+# If you use bundler, this might be useful to you:
+# if [[ -s Gemfile ]] && {
+#   ! builtin command -v bundle >/dev/null ||
+#   builtin command -v bundle | GREP_OPTIONS= \grep $rvm_path/bin/bundle >/dev/null
+# }
+# then
+#   printf "%b" "The rubygem 'bundler' is not installed. Installing it now.\n"
+#   gem install bundler
+# fi
+# if [[ -s Gemfile ]] && builtin command -v bundle >/dev/null
+# then
+#   bundle install | GREP_OPTIONS= \grep -vE '^Using|Your bundle is complete'
+# fi

data/Gemfile

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

data/README.md

@@ -0,0 +1,24 @@
+# The StartupStats Client Ruby Gem
+
+## Installation
+```sh
+gem install startupstats
+```
+
+## Documentation
+Coming soon!
+
+## Configuration
+Given that this is a library of multiple API clients, you must configure each client that you have been granted access to individually.  This is straight-forward.  Here is an example of configuring the Formd API for usage:
+
+```ruby
+StartupStats::Formd.configure do |config|
+  	config.access_token = "2f309awf30a9wf3jaw39faaf903ja3"
+ 	config.endpoint = "http://formd.startupstats.com/"
+end
+```
+
+After configuration, you can make calls directly to the API that you have setup.  Here's an example:
+```ruby
+@filings = StartupStats::Formd.filings( start = 0 , limit = 5 )
+```

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/startupstats-client.rb

@@ -0,0 +1,31 @@
+require "startupstats/version"
+require "startupstats/configurable"
+require "startupstats/formd/client"
+#Dir[File.dirname(__FILE__) + '/startupstats/formd/*'].each {|file| require file }
+
+module StartupStats
+  	# TODO: figure out way to automaticaly generate the following code for each new module/API Client
+	module Formd
+		class << self
+			include StartupStats::Configurable
+
+	    	# Delegate to a StartupStats::Formd::Client
+			#
+			# @return [StartupStats::Formd::Client]
+			def client
+				@client = StartupStats::Formd::Client.new(options) unless defined?(@client) && @client.cache_key == options.hash
+				@client
+			end
+
+			def respond_to_missing?(method_name, include_private=false); client.respond_to?(method_name, include_private); end if RUBY_VERSION >= "1.9"
+			def respond_to?(method_name, include_private=false); client.respond_to?(method_name, include_private) || super; end if RUBY_VERSION < "1.9"
+
+		private
+			def method_missing(method_name, *args, &block)
+				return super unless client.respond_to?(method_name)
+				client.send(method_name, *args, &block)
+			end
+		end
+	end
+
+end

data/lib/startupstats/configurable.rb

@@ -0,0 +1,61 @@
+require 'startupstats/default'
+module StartupStats
+  module Configurable
+    attr_writer :access_token, :access_token_key
+    attr_accessor :endpoint, :connection_options, :middleware
+
+    class << self
+
+      def keys
+        @keys ||= [
+          :access_token, 
+          :access_token_key,
+          :endpoint,
+          :connection_options,
+          :middleware,
+        ]
+      end
+
+    end
+    
+    # Convenience method to allow configuration options to be set in a block
+    def configure
+      yield self
+      self
+    end
+
+    # @return [Boolean]
+    def credentials?
+      credentials.values.all?
+    end
+
+    # @return [Fixnum]
+    def cache_key
+      options.hash
+    end
+
+    def reset!
+      StartupStats::Configurable.keys.each do |key|
+        instance_variable_set(:"@#{key}", StartupStats::Default.options[key])
+      end
+      self
+    end
+    alias setup reset!
+
+  private
+
+    # @return [Hash]
+    def credentials
+      {
+        :access_token_key => @access_token_key,
+        :access_token => @access_token,
+      }
+    end
+
+    # @return [Hash]
+    def options
+      Hash[StartupStats::Configurable.keys.map{|key| [key, instance_variable_get(:"@#{key}")]}]
+    end
+
+  end
+end

data/lib/startupstats/core_ext/hash.rb

@@ -0,0 +1,18 @@
+class Hash
+
+  # Merges self with another hash, recursively
+  #
+  # @param hash [Hash] The hash to merge
+  # @return [Hash]
+  def deep_merge(hash)
+    target = self.dup
+    hash.keys.each do |key|
+      if hash[key].is_a?(Hash) && self[key].is_a?(Hash)
+        target[key] = target[key].deep_merge(hash[key])
+        next
+      end
+      target[key] = hash[key]
+    end
+    target
+  end
+end

data/lib/startupstats/default.rb

@@ -0,0 +1,78 @@
+require 'faraday'
+require 'startupstats/configurable'
+require 'startupstats/error/client_error'
+require 'startupstats/error/server_error'
+require 'startupstats/response/parse_json'
+require 'startupstats/response/raise_error'
+require 'startupstats/version'
+
+module StartupStats
+  module Default
+    ENDPOINT = 'https://api.startupstats.com' unless defined? StartupStats::Default::ENDPOINT
+
+    CONNECTION_OPTIONS = {
+      :headers => {
+        :accept => 'application/json',
+        :user_agent => "StartupStats Ruby Gem #{StartupStats::VERSION}"
+      },
+      :open_timeout => 5,
+      :raw => true,
+      :ssl => {:verify => false},
+      :timeout => 10,
+    } unless defined? StartupStats::Default::CONNECTION_OPTIONS
+
+    MIDDLEWARE = Faraday::Builder.new do |builder|
+      # Convert request params to "www-form-urlencoded"
+      builder.use Faraday::Request::UrlEncoded
+      # Handle 4xx server responses
+      builder.use StartupStats::Response::RaiseError, StartupStats::Error::ClientError
+      # Parse JSON response bodies using MultiJson
+      builder.use StartupStats::Response::ParseJson
+      # Handle 5xx server responses
+      builder.use StartupStats::Response::RaiseError, StartupStats::Error::ServerError
+      # Set Faraday's HTTP adapter
+      builder.adapter Faraday.default_adapter #:typhoeus
+    end unless defined? StartupStats::Default::MIDDLEWARE
+
+    class << self
+
+      # @return [Hash]
+      def options
+        Hash[StartupStats::Configurable.keys.map{|key| [key, send(key)]}]
+      end
+
+      # @return [String]
+      def access_token
+        ENV['FORMD_ACCESS_TOKEN'] || "access_token"
+      end
+
+      # @return [String]
+      def access_token_key
+        ENV['FORMD_ACCESS_TOKEN_KEY']
+      end
+
+      # @note This is configurable in case you want to use a Twitter-compatible endpoint.
+      # @see http://status.net/wiki/Twitter-compatible_API
+      # @see http://en.blog.wordpress.com/2009/12/12/twitter-api/
+      # @see http://staff.tumblr.com/post/287703110/api
+      # @see http://developer.typepad.com/typepad-twitter-api/twitter-api.html
+      # @return [String]
+      def endpoint
+        ENDPOINT
+      end
+
+      def connection_options
+        CONNECTION_OPTIONS
+      end
+
+      # @note Faraday's middleware stack implementation is comparable to that of Rack middleware.  The order of middleware is important: the first middleware on the list wraps all others, while the last middleware is the innermost one.
+      # @see https://github.com/technoweenie/faraday#advanced-middleware-usage
+      # @see http://mislav.uniqpath.com/2011/07/faraday-advanced-http/
+      # @return [Faraday::Builder]
+      def middleware
+        MIDDLEWARE
+      end
+
+    end
+  end
+end

data/lib/startupstats/error.rb

@@ -0,0 +1,31 @@
+module StartupStats
+  # Custom error class for rescuing from all StartupStats errors
+  class Error < StandardError
+    attr_reader :wrapped_exception
+
+    # @return [Hash]
+    def self.errors
+      @errors ||= Hash[descendants.map{|klass| [klass.const_get(:HTTP_STATUS_CODE), klass]}]
+    end
+
+    # @return [Array]
+    def self.descendants
+      ObjectSpace.each_object(::Class).select{|klass| klass < self}
+    end
+
+    # Initializes a new Error object
+    #
+    # @param exception [Exception, String]
+    # @param response_headers [Hash]
+    # @return [StartupStats::Error]
+    def initialize(exception=$!, response_headers={})
+      @wrapped_exception = exception
+      exception.respond_to?(:backtrace) ? super(exception.message) : super(exception.to_s)
+    end
+
+    def backtrace
+      @wrapped_exception.respond_to?(:backtrace) ? @wrapped_exception.backtrace : super
+    end
+
+  end
+end

data/lib/startupstats/error/bad_gateway.rb

@@ -0,0 +1,11 @@
+require 'startupstats/error/server_error'
+
+module StartupStats
+  class Error
+    # Raised when a StartupStats API returns the HTTP status code 502
+    class BadGateway < StartupStats::Error::ServerError
+      HTTP_STATUS_CODE = 502
+      MESSAGE = "The StartupStats API you are requesting is down or being upgraded."
+    end
+  end
+end

data/lib/startupstats/error/bad_request.rb

@@ -0,0 +1,10 @@
+require 'startupstats/error/client_error'
+
+module StartupStats
+  class Error
+    # Raised when a StartupStats API returns the HTTP status code 400
+    class BadRequest < StartupStats::Error::ClientError
+      HTTP_STATUS_CODE = 400
+    end
+  end
+end

data/lib/startupstats/error/client_error.rb

@@ -0,0 +1,35 @@
+require 'startupstats/error'
+
+module StartupStats
+  class Error
+    # Raised when a StartupStats API returns a 4xx HTTP status code or there's an error in Faraday
+    class ClientError < StartupStats::Error
+
+      # Create a new error from an HTTP environment
+      #
+      # @param response [Hash]
+      # @return [StartupStats::Error]
+      def self.from_response(response={})
+        new(parse_error(response[:body]), response[:response_headers])
+      end
+
+    private
+
+      def self.parse_error(body)
+        if body.nil?
+          ''
+        elsif body[:error]
+          body[:error]
+        elsif body[:errors]
+          first = Array(body[:errors]).first
+          if first.kind_of?(Hash)
+            first[:message].chomp
+          else
+            first.chomp
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/startupstats/error/decode_error.rb

@@ -0,0 +1,9 @@
+require 'startupstats/error'
+
+module StartupStats
+  class Error
+    # Raised when JSON parsing fails
+    class DecodeError < StartupStats::Error
+    end
+  end
+end

data/lib/startupstats/error/forbidden.rb

@@ -0,0 +1,10 @@
+require 'startupstats/error/client_error'
+
+module StartupStats
+  class Error
+    # Raised when a StartupStats API returns the HTTP status code 403
+    class Forbidden < StartupStats::Error::ClientError
+      HTTP_STATUS_CODE = 403
+    end
+  end
+end

data/lib/startupstats/error/gateway_timeout.rb

@@ -0,0 +1,11 @@
+require 'startupstats/error/server_error'
+
+module StartupStats
+  class Error
+    # Raised when a StartupStats API returns the HTTP status code 504
+    class GatewayTimeout < StartupStats::Error::ServerError
+      HTTP_STATUS_CODE = 504
+      MESSAGE = "The StartupStats servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later."
+    end
+  end
+end

data/lib/startupstats/error/internal_server_error.rb

@@ -0,0 +1,11 @@
+require 'startupstats/error/server_error'
+
+module StartupStats
+  class Error
+    # Raised when a StartupStats API returns the HTTP status code 500
+    class InternalServerError < StartupStats::Error::ServerError
+      HTTP_STATUS_CODE = 500
+      MESSAGE = "Something is technically wrong."
+    end
+  end
+end

data/lib/startupstats/error/not_acceptable.rb

@@ -0,0 +1,10 @@
+require 'startupstats/error/client_error'
+
+module StartupStats
+  class Error
+    # Raised when a StartupStats API returns the HTTP status code 406
+    class NotAcceptable < StartupStats::Error::ClientError
+      HTTP_STATUS_CODE = 406
+    end
+  end
+end

data/lib/startupstats/error/not_found.rb

@@ -0,0 +1,10 @@
+require 'startupstats/error/client_error'
+
+module StartupStats
+  class Error
+    # Raised when a StartupStats API returns the HTTP status code 404
+    class NotFound < StartupStats::Error::ClientError
+      HTTP_STATUS_CODE = 404
+    end
+  end
+end

data/lib/startupstats/error/server_error.rb

@@ -0,0 +1,28 @@
+require 'startupstats/error'
+
+module StartupStats
+  class Error
+    # Raised when a StartupStats API returns a 5xx HTTP status code
+    class ServerError < StartupStats::Error
+      MESSAGE = "Server Error"
+
+      # Create a new error from an HTTP environment
+      #
+      # @param response [Hash]
+      # @return [StartupStats::Error]
+      def self.from_response(response={})
+        new(nil, response[:response_headers])
+      end
+
+      # Initializes a new ServerError object
+      #
+      # @param message [String]
+      # @param response_headers [Hash]
+      # @return [StartupStats::Error::ServerError]
+      def initialize(message=nil, response_headers={})
+        super((message || self.class.const_get(:MESSAGE)), response_headers)
+      end
+
+    end
+  end
+end

data/lib/startupstats/error/unauthorized.rb

@@ -0,0 +1,10 @@
+require 'startupstats/error/client_error'
+
+module StartupStats
+  class Error
+    # Raised when a StartupStats API returns the HTTP status code 401
+    class Unauthorized < StartupStats::Error::ClientError
+      HTTP_STATUS_CODE = 401
+    end
+  end
+end

data/lib/startupstats/formd/client.rb

@@ -0,0 +1,25 @@
+require 'startupstats/configurable'
+require 'startupstats/requestable'
+require 'startupstats/formd/filings'
+require 'startupstats/error/client_error'
+require 'startupstats/error/decode_error'
+
+module StartupStats
+	module Formd
+		class Client #< StartupStats::Client
+			# StartupStats client modules
+			include StartupStats::Configurable
+			include StartupStats::Requestable
+
+			# Formd modules
+			include StartupStats::Formd::Filings
+
+			def initialize( options = {} )
+				setup
+				StartupStats::Configurable.keys.each do |key|
+					instance_variable_set(:"@#{key}", options[key] || instance_variable_get(:"@#{key}"))
+				end
+			end
+		end
+	end
+end

data/lib/startupstats/formd/filings.rb

@@ -0,0 +1,55 @@
+require 'startupstats/formd/models/filing'
+module StartupStats
+	module Formd
+		module Filings
+
+			# Returns filings
+			# 
+			# @authentication_required This is a protected API call
+			# @raise [StartupStats::Error::Unauthorized] Error raised when supplied 
+			# @return [Array<StartupStats::Filing>] The requested Filings.
+			# @param start [Integer] default is 0 
+			# @param limit [Integer] default is 100
+			# @param industry [String] not required
+			def filings( start , limit , industry )
+				begin
+					parse_filings_from_response(:get , "filings", {start: start , limit: limit , industry: industry} )
+				rescue StartupStats::Error::Unauthorized => error
+					raise
+				end
+			end 
+
+=begin	(Comes later)	
+			def create_filing
+			end
+
+			def update_filing 
+			end
+					
+			def edit_filing
+			end
+					
+			def destroy_filing
+			end 
+
+			def show_filing
+			end
+=end
+		private
+			# Parses an array of filings
+			# 
+			# @param method [Symbol]
+      		# @param path [String]
+      		# @param params [Array]
+      		# @return [Array<StartupStats::Filing>]
+			def parse_filings_from_response(method , path , params  )
+				response = send(method.to_sym, path, params)
+				filings = []
+				response[:body].each{|filing|  
+					filings.push( StartupStats::Formd::Filing.new filing )
+				}
+				filings
+			end
+		end
+	end
+end

data/lib/startupstats/formd/models/filing.rb

@@ -0,0 +1,19 @@
+module StartupStats
+	module Formd
+		class Filing
+			attr_accessor :filing_url_html , :filing_url_xml , :filing_id, :filing_type
+			attr_accessor  :company_id, :filing_num, :filing_date, :industry_group, :long_offering, :business_combo, :processed,
+					:min_investment, :offering_amount, :offering_sold, :num_investors, :sales_commission, :finders_fee, :use_of_proceeds, :security_type
+			attr_accessor :company #this will store all details
+			def initialize response = {}
+				response.each do |k, v|  
+					instance_variable_set("@#{k}",v) unless v.nil?
+				end
+			end
+
+			def id
+				@filing_id
+			end
+		end
+	end
+end

data/lib/startupstats/requestable.rb

@@ -0,0 +1,56 @@
+require 'faraday'
+require 'faraday_middleware'
+require 'multi_json'
+#require 'startupstats/error/error'
+#require 'startupstats/core_ext/hash'
+
+module StartupStats
+  # Defines HTTP request methods
+  module Requestable
+    # Perform an HTTP DELETE request
+    def delete(path, params={})
+      request(:delete, path, params)
+    end
+
+    # Perform an HTTP GET request
+    def get(path, params={})
+      request(:get, path, params)
+    end
+
+    # Perform an HTTP POST request
+    def post(path, params={})
+      request(:post, path, params)
+    end
+
+    # Perform an HTTP PUT request
+    def put(path, params={})
+      request(:put, path, params)
+    end
+
+  private
+
+    def request(method, path, params={})
+      params[@access_token_key] = @access_token
+      connection.send(method.to_sym, path, params) do |request|
+        case method.to_sym
+        when :delete, :get
+          request.url(path, params)
+        when :post
+          request.path = path
+          request.body = params unless params.empty?
+        end
+      end.env
+    rescue Faraday::Error::ClientError
+      raise StartupStats::Error::ClientError
+    rescue MultiJson::DecodeError
+      raise StartupStats::Error::DecodeError
+    end
+
+    # Returns a Faraday::Connection object
+    #
+    # @return [Faraday::Connection]
+    def connection
+      @connection ||= Faraday.new(@endpoint, @connection_options.merge(:builder => @middleware))
+    end
+  end
+end

data/lib/startupstats/response/parse_json.rb

@@ -0,0 +1,25 @@
+require 'faraday'
+require 'multi_json'
+
+module StartupStats
+  module Response
+    class ParseJson < Faraday::Response::Middleware
+
+      def parse(body)
+        case body
+        when /\A^\s*$\z/, nil
+          nil
+        else
+          MultiJson.load(body, :symbolize_keys => true)
+        end
+      end
+
+      def on_complete(env)
+        if respond_to?(:parse)
+          env[:body] = parse(env[:body]) unless [204, 301, 302, 304].include?(env[:status])
+        end
+      end
+
+    end
+  end
+end

data/lib/startupstats/response/raise_error.rb

@@ -0,0 +1,31 @@
+require 'faraday'
+require 'startupstats/error/bad_gateway'
+require 'startupstats/error/bad_request'
+require 'startupstats/error/forbidden'
+require 'startupstats/error/gateway_timeout'
+require 'startupstats/error/internal_server_error'
+require 'startupstats/error/not_acceptable'
+require 'startupstats/error/not_found'
+#require 'startupstats/error/service_unavailable'
+#require 'startupstats/error/too_many_requests'
+require 'startupstats/error/unauthorized'
+#require 'startupstats/error/unprocessable_entity'
+
+module StartupStats
+  module Response
+    class RaiseError < Faraday::Response::Middleware
+
+      def on_complete(env)
+        status_code = env[:status].to_i
+        error_class = @klass.errors[status_code]
+        raise error_class.from_response(env) if error_class
+      end
+
+      def initialize(app, klass)
+        @klass = klass
+        super(app)
+      end
+
+    end
+  end
+end

data/lib/startupstats/version.rb

@@ -0,0 +1,3 @@
+module StartupStats
+  VERSION = '0.0.1'
+end

data/spec/factories.rb

@@ -0,0 +1,105 @@
+module StartupStats
+	module Formd
+FactoryGirl.define do
+	
+	factory :filing do
+		filing_url_html			"http://www.sec.gov/Archives/edgar/data/1525533/000152553312000003/xslFormDX01/primary_doc.xml"
+		filing_url_xml			"http://www.sec.gov/Archives/edgar/data/1525533/000152553312000003/primary_doc.xml"
+		filing_id				"000152553312000003"
+		#filing_date				Date.current
+		filing_type				"D/A"
+		processed				false
+
+		factory :filing_complete do
+		 	company
+		 	filing_num				"3"
+		 	processed				true
+	   		industry_group			"Other Technology"
+	   		long_offering			false
+	   		business_combo			false
+	   		min_investment			0
+	   		offering_amount			1000000
+	   		offering_sold			400000
+	   		num_investors			4
+	   		sales_commission		0
+	   		finders_fee				0
+	   		use_of_proceeds			0
+
+		 	after(:create) do |filing|
+		 		filing.securities << FactoryGirl.build(:security)
+		 	end
+
+		 	factory :filing_with_people do
+		 		ignore do
+		 			people_count 1
+		 		end
+
+		 		after(:create) do |filing , evaluator|
+		 			FactoryGirl.create_list( :person , evaluator.people_count , filing: filing )
+		 		end
+		 	end
+		end
+	end
+
+
+	factory :company do
+		# based on this: http://www.sec.gov/Archives/edgar/data/1562176/000156217612000001/xslFormDX01/primary_doc.xml
+		sec_id 					"0001562176"
+		name 					"Interesante, Inc."
+		entity_type				"Corporation"
+		inc_state				"DELEWARE"
+		address_street1			"2499 ALPINE ROAD"
+		address_street2			""
+		address_city			"MENLO PARK"
+		address_spc				"CALIFORNIA"
+		address_zip				"94025"
+		phone					"650-799-1592"
+
+		factory :company_with_filings do
+			ignore do
+				filings_count 1
+			end
+
+			after(:create) do |company , evaluator|
+				FactoryGirl.create_list( :filing , evaluator.filings_count , company: company )
+			end
+		end
+
+		factory :company_with_prior_names do
+			ignore do
+				priornames_count 1
+			end
+
+			after(:create) do | company , evaluator |
+				FactoryGirl.create_list( :prior_name , evaluator.priornames_count , company: company )
+			end
+		end
+	end
+
+	factory :prior_name do
+		company
+		name 					"Purple Company"
+	end
+
+	factory :person do
+		filing
+		first_name				"Christopher"
+		middle_name				""
+		last_name				"Smart"
+		address_street1			"24 Fendon Road"
+		address_street2			""
+		address_city			"Cambridge"
+		address_spc				"UNITED KINGDOM"
+		address_zip				"CB1 7RT"
+		executive				false
+		director				true
+		promoter				false
+	end
+
+	factory :security do
+		name 					"Equity"
+	end
+end
+
+end 
+end

data/spec/formd/client_spec.rb

@@ -0,0 +1,8 @@
+require 'spec_helper'
+module StartupStats
+	module Formd
+		describe Client do
+
+		end
+	end
+end

data/spec/formd/filings_spec.rb

@@ -0,0 +1,19 @@
+require 'spec_helper'
+require 'vcr'
+describe StartupStats::Formd::Filings do
+	use_vcr_cassette 'filings' , :record => :new_episodes
+	let(:client){ StartupStats::Formd::Client.new( {
+						:access_token 		=> ENV['FORMD_TOKEN'] ,
+						:access_token_key 	=> "access_token" ,
+						:endpoint			=> ENV['FORMD_ENDPOINT'] ,
+						} ) }
+
+	it "gets filings in batch" do
+		#VCR.use_cassette('filings' , :record => :new_episodes ) do
+			filings = client.filings( start = 0 , limit = 5 , industry = nil )
+			expect(filings).to be_an Array
+			expect(filings.first).to be_a StartupStats::Formd::Filing
+			filings.first.company_id.should eq 3
+		#end
+	end
+end

data/spec/formd/formd_spec.rb

@@ -0,0 +1,37 @@
+require 'spec_helper'
+describe StartupStats::Formd do
+	describe ".configure" do
+		StartupStats::Configurable.keys.each do |key|
+			it "sets the #{key.to_s.gsub('_', ' ')}" do
+				StartupStats::Formd.configure do |config|
+					config.send("#{key}=", key)
+				end
+				expect(StartupStats::Formd.instance_variable_get(:"@#{key}")).to eq key
+			end
+		end
+	end
+	
+	describe ".client" do
+		it "returns a StartupStats::Formd::Client" do
+			expect(StartupStats::Formd.client).to be_a StartupStats::Formd::Client
+		end
+
+		context "when the options don't change" do
+			it "caches the client" do
+				expect(StartupStats::Formd.client).to eq StartupStats::Formd.client
+			end
+		end
+		
+		context "when the options change" do
+			it "busts the cache" do
+				client1 = StartupStats::Formd.client
+				StartupStats::Formd.configure do |config|
+					config.access_token = 'abc'
+					config.access_token_key = '123'
+				end
+				client2 = StartupStats::Formd.client
+				expect(client1).not_to eq client2
+			end
+	    end
+	end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,19 @@
+require 'simplecov'
+SimpleCov.start
+
+require 'rspec'
+require 'startupstats-client'
+require 'factory_girl'
+require 'factories'
+require 'vcr'
+
+Dir['./spec/support/**/*.rb'].each { |f| require f }
+
+RSpec.configure do |config|
+  config.include FactoryGirl::Syntax::Methods
+
+  config.mock_with :rspec
+
+  config.run_all_when_everything_filtered = true
+  config.color_enabled = true
+end

data/spec/support/vcr_support.rb

@@ -0,0 +1,11 @@
+require 'vcr'
+
+VCR.configure do |c|
+  c.cassette_library_dir = 'spec/vcr'
+  c.hook_into :faraday
+  #c.default_cassette_options = { :record => :once }
+end
+
+RSpec.configure do |c|
+  c.extend VCR::RSpec::Macros
+end

data/spec/unit/error_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+describe StartupStats::Error do
+
+  describe "#initialize" do
+    it "wraps another error class" do
+      begin
+        raise Faraday::Error::ClientError.new("Oops")
+      rescue Faraday::Error::ClientError
+        begin
+          raise StartupStats::Error
+        rescue StartupStats::Error => error
+          expect(error.message).to eq "Oops"
+          expect(error.wrapped_exception.class).to eq Faraday::Error::ClientError
+        end
+      end
+    end
+  end
+
+end

data/spec/unit/requestable_spec.rb

@@ -0,0 +1,37 @@
+require 'spec_helper'
+
+describe StartupStats::Requestable do
+	class DummyRequest; include StartupStats::Requestable; end
+
+	let(:dummy) { DummyRequest.new }
+	let(:sample_path) { "/index" }
+	let(:sample_params) { { :sample => "param" } }
+
+	describe "#get" do
+		it "calls request with the passed params" do
+			dummy.should_receive(:request).with(:get, sample_path, sample_params).and_return("result")
+      		dummy.get(sample_path, sample_params).should == "result"
+		end
+	end
+
+	describe "#post" do
+		it "calls request with the passed params" do
+			dummy.should_receive(:request).with(:post, sample_path, sample_params).and_return("result")
+      		dummy.post(sample_path, sample_params).should == "result"
+		end
+	end
+
+	describe "#delete" do
+		it "calls request with the passed params" do
+			dummy.should_receive(:request).with(:delete, sample_path, sample_params).and_return("result")
+      		dummy.delete(sample_path, sample_params).should == "result"
+		end
+	end
+
+	describe "#put" do
+		it "calls request with the passed params" do
+			dummy.should_receive(:request).with(:put, sample_path, sample_params).and_return("result")
+      		dummy.put(sample_path, sample_params).should == "result"
+		end
+	end
+end 

data/startupstats-client.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "startupstats/version"
+
+Gem::Specification.new do |s|
+  s.name        = "startupstats"
+  s.version     = StartupStats::VERSION
+  s.authors     = ["Nick O'Neill"]
+  s.email       = ["mr.nick.oneill@gmail.com"]
+  s.homepage    = "https://github.com/Holler/startupstats-client"
+  s.description = %q{A Ruby interface to the network of StartupStats APIs.}
+  s.summary     = s.description
+  
+  #s.rubyforge_project = "startupstats-client"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "factory_girl"
+  s.add_development_dependency "vcr"
+  s.add_development_dependency "yard", "~> 0.7.3"
+  s.add_development_dependency "simplecov"
+
+  s.add_dependency "faraday"
+  s.add_dependency "faraday_middleware"
+end

metadata

@@ -0,0 +1,203 @@
+--- !ruby/object:Gem::Specification
+name: startupstats
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Nick O'Neill
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-11-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: factory_girl
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.3
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A Ruby interface to the network of StartupStats APIs.
+email:
+- mr.nick.oneill@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rvmrc
+- Gemfile
+- README.md
+- Rakefile
+- lib/startupstats-client.rb
+- lib/startupstats/configurable.rb
+- lib/startupstats/core_ext/hash.rb
+- lib/startupstats/default.rb
+- lib/startupstats/error.rb
+- lib/startupstats/error/bad_gateway.rb
+- lib/startupstats/error/bad_request.rb
+- lib/startupstats/error/client_error.rb
+- lib/startupstats/error/decode_error.rb
+- lib/startupstats/error/forbidden.rb
+- lib/startupstats/error/gateway_timeout.rb
+- lib/startupstats/error/internal_server_error.rb
+- lib/startupstats/error/not_acceptable.rb
+- lib/startupstats/error/not_found.rb
+- lib/startupstats/error/server_error.rb
+- lib/startupstats/error/unauthorized.rb
+- lib/startupstats/formd/client.rb
+- lib/startupstats/formd/filings.rb
+- lib/startupstats/formd/models/filing.rb
+- lib/startupstats/requestable.rb
+- lib/startupstats/response/parse_json.rb
+- lib/startupstats/response/raise_error.rb
+- lib/startupstats/version.rb
+- spec/factories.rb
+- spec/formd/client_spec.rb
+- spec/formd/filings_spec.rb
+- spec/formd/formd_spec.rb
+- spec/spec_helper.rb
+- spec/support/vcr_support.rb
+- spec/unit/error_spec.rb
+- spec/unit/requestable_spec.rb
+- startupstats-client.gemspec
+homepage: https://github.com/Holler/startupstats-client
+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.24
+signing_key: 
+specification_version: 3
+summary: A Ruby interface to the network of StartupStats APIs.
+test_files:
+- spec/factories.rb
+- spec/formd/client_spec.rb
+- spec/formd/filings_spec.rb
+- spec/formd/formd_spec.rb
+- spec/spec_helper.rb
+- spec/support/vcr_support.rb
+- spec/unit/error_spec.rb
+- spec/unit/requestable_spec.rb
+has_rdoc: