gun_broker 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5f1909c07880bf70fd3f4c385c456168ae2409e5
+  data.tar.gz: c11c711ae5950ba9d3c7a3cb18618d3dde0977ea
+SHA512:
+  metadata.gz: 49b71a28c539403d802d1be79ae5960bb41cfec1a6e8c8e980e75785686221b3722a4bca874d90fea7fdb74ba7e9657b4504bfd938ccfadf21cb5604d579f9b2
+  data.tar.gz: 4cc1b3c0eedf8b3cc18d0e00aa7951a5e6401f1d0b176d80f54174b575d69b57efcbd5060c2f20be6e0018e35de9649b4de6dd97604e1316fbf61d68afab3106

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/.ruby-gemset

@@ -0,0 +1 @@
+gun_broker

data/.ruby-version

@@ -0,0 +1 @@
+2.0.0-p481

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Dale Campbell
+
+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,132 @@
+# GunBroker
+
+GunBroker.com API Ruby library.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'gun_broker'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install gun_broker
+
+## Usage
+
+### Developer Token
+
+You **must** set a developer key obtained from GunBroker.com in order to use this library.
+
+```ruby
+GunBroker.dev_key = 'your-sekret-dev-key'
+```
+
+### GunBroker::User
+
+Authentication requires a `username` and an 'auth options' hash that requires **at least** a `password`
+*or* `token`. If a password is given, you must call `User#authenticate!` to obtain an access token.
+
+```ruby
+# By username/password:
+user = GunBroker::User.new('username', password: 'sekret-password')
+user.authenticate!
+user.token  # => 'user-access-token'
+
+# Or with an existing Access Token:
+user = GunBroker::User.new('username', token: 'user-access-token')
+# No need to call #authenticate! since we already have an access token.
+user.token  # => 'user-access-token'
+```
+
+Once the User has an access token, you can then grab all of their items (listings).  All items methods
+return an array of `GunBroker::Item` instances.
+
+```ruby
+user.items  # => [GunBroker::Item, ...]
+user.unsold_items  # => [GunBroker::Item, ...]
+user.sold_items  # => [GunBroker::Item, ...]
+```
+
+### GunBroker::Item
+
+Represents an item (listing) on GunBroker.  The `Item#id` method returns the value of the `itemID` attribute
+from the response.  All other attributes can be accessed through the `Item#[]` method.
+
+```ruby
+item.id  # => '1234567'
+item['title']  # => 'Super Awesome Scope'
+```
+
+### GunBroker::Category
+
+Returns GunBroker category responses.  To get an array of all categories, call `Category#all()`.
+
+```ruby
+GunBroker::Category.all
+# => [GunBroker::Category, ...]
+```
+
+You can also pass an optional parent category ID, to only return subcategories of the given parent.
+For example, if the 'Firearms' category has an ID of '123', get all Firearm subcategories like this:
+
+```ruby
+firearms = '123'  # ID of the Firearms Category
+GunBroker::Category.all(firearms)
+# => [GunBroker::Category, ...]
+```
+
+Much like GunBroker::Item, the `Category#id` method returns the `categoryID` attribute from the response.
+All other attributes can be accessed with `Category#[]`.
+
+```ruby
+category.id  # => '123'
+category['categoryName']  # => 'Firearms'
+```
+
+### GunBroker::API
+
+If you need to access an API endpoint not yet supported, you can use `GunBroker::API` directly.  Currently
+supported HTTP methods are `GET`, `DELETE`, and `POST`, with each having a corresponding method on the
+`GunBroker::API` class.
+
+Each method requires a `path` and accepts optional `params` and `headers` hashes.  If making a `GET` request,
+the `params` will be URL params; if making a `POST` request, the `params` will be turned into JSON and set
+as the request body.
+
+You can also set HTTP headers by passing a hash as the third argument.  Headers will **always** contain:
+
+* `Content-Type: application/json`
+* `X-DevKey: your-sekret-dev-key`
+
+The response will be parsed JSON (hash).
+
+```ruby
+GunBroker::API.get('/some/resource')
+# => { 'name' => 'resource', 'foo' => 'bar' }
+
+GunBroker::API.post('/some/resource', { name: 'some data' })
+
+# No params, but some headers:
+GunBroker::API.delete('/some/resource', {}, { 'X-TestHeader' => 'FooBar' })
+```
+
+### Error Handling
+
+Methods that require authorization (with an access token) will raise a `GunBroker::Error::NotAuthorized`
+exception if the token isn't valid.  Otherwise, if there is some other issue with the request (namely,
+the response status code is not in the `2xx` range), a `GunBroker::Error::RequestError` will be raised.
+
+## Contributing
+
+1. Fork it ( https://github.com/ammoready/gun_broker/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

data/Rakefile

@@ -0,0 +1,7 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+task :default => :spec
+
+desc 'Run the specs'
+RSpec::Core::RakeTask.new(:spec)

data/gun_broker.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'gun_broker/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "gun_broker"
+  spec.version       = GunBroker::VERSION
+  spec.authors       = ["Dale Campbell"]
+  spec.email         = ["oshuma@gmail.com"]
+  spec.summary       = %q{GunBroker.com API Ruby library.}
+  spec.description   = %q{}
+  spec.homepage      = ""
+  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.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.1"
+  spec.add_development_dependency "webmock", "~> 1.20"
+end

data/lib/gun_broker.rb

@@ -0,0 +1,26 @@
+require 'gun_broker/version'
+
+require 'gun_broker/api'
+require 'gun_broker/category'
+require 'gun_broker/error'
+require 'gun_broker/item'
+require 'gun_broker/user'
+
+module GunBroker
+
+  def self.dev_key=(dev_key)
+    @@dev_key = dev_key
+  end
+
+  def self.dev_key
+    raise 'GunBroker developer key not set.' unless dev_key_present?
+    @@dev_key
+  end
+
+  private
+
+  def self.dev_key_present?
+    defined?(@@dev_key) && !@@dev_key.nil? && !@@dev_key.empty?
+  end
+
+end

data/lib/gun_broker/api.rb

@@ -0,0 +1,82 @@
+require 'json'
+require 'net/https'
+
+module GunBroker
+  class API
+
+    GUNBROKER_API = 'https://api.gunbroker.com/v1'
+
+    def initialize(path, params = {}, headers = {})
+      raise "Path must start with '/': #{path}" unless path.start_with?('/')
+
+      @path = path
+      @params = params
+      @headers = headers
+    end
+
+    def self.delete(*args)
+      new(*args).delete!
+    end
+
+    def self.get(*args)
+      new(*args).get!
+    end
+
+    def self.post(*args)
+      new(*args).post!
+    end
+
+    def delete!
+      request = Net::HTTP::Delete.new(uri)
+      response = get_response(request)
+      handle_response(response)
+    end
+
+    def get!
+      uri.query = URI.encode_www_form(@params)
+
+      request = Net::HTTP::Get.new(uri)
+      response = get_response(request)
+      handle_response(response)
+    end
+
+    def post!
+      request = Net::HTTP::Post.new(uri)
+      request.body = @params.to_json
+
+      response = get_response(request)
+      handle_response(response)
+    end
+
+    private
+
+    def get_response(request)
+      request['Content-Type'] = 'application/json'
+      request['X-DevKey'] = GunBroker.dev_key
+
+      @headers.each { |header, value| request[header] = value }
+
+      Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == 'https') do |http|
+        http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+        http.ssl_version = :SSLv3
+        http.request(request)
+      end
+    end
+
+    def handle_response(response)
+      case response
+      when Net::HTTPOK, Net::HTTPSuccess
+        JSON.parse(response.body)
+      when Net::HTTPUnauthorized
+        raise GunBroker::Error::NotAuthorized.new(response)
+      else
+        raise GunBroker::Error::RequestError.new(response)
+      end
+    end
+
+    def uri
+      @uri ||= URI([GUNBROKER_API, @path].join)
+    end
+
+  end
+end

data/lib/gun_broker/category.rb

@@ -0,0 +1,25 @@
+module GunBroker
+  class Category
+
+    # The top-level category ID.
+    ROOT_CATEGORY_ID = 0
+
+    def self.all(parent = ROOT_CATEGORY_ID)
+      response = GunBroker::API.get('/Categories', { 'ParentCategoryID' => parent })
+      response['results'].map { |attrs| new(attrs) }
+    end
+
+    def self.find(category_id)
+      new(GunBroker::API.get("/Categories/#{category_id}"))
+    end
+
+    def initialize(attrs = {})
+      @attrs = attrs
+    end
+
+    def id
+      @attrs['categoryID']
+    end
+
+  end
+end

data/lib/gun_broker/error.rb

@@ -0,0 +1,8 @@
+module GunBroker
+  class Error < StandardError
+
+    class NotAuthorized < GunBroker::Error; end
+    class RequestError < GunBroker::Error; end
+
+  end
+end

data/lib/gun_broker/item.rb

@@ -0,0 +1,17 @@
+module GunBroker
+  class Item
+
+    def initialize(attrs = {})
+      @attrs = attrs
+    end
+
+    def id
+      @attrs['itemID']
+    end
+
+    def [](key)
+      @attrs[key]
+    end
+
+  end
+end

data/lib/gun_broker/user.rb

@@ -0,0 +1,41 @@
+module GunBroker
+  class User
+
+    attr_reader :username
+    attr_reader :token
+
+    def initialize(username, auth_options = {})
+      @username = username
+      @password = auth_options[:password] || auth_options['password']
+      @token    = auth_options[:token]    || auth_options['token']
+    end
+
+    def authenticate!
+      response = GunBroker::API.post('/Users/AccessToken', { username: @username, password: @password })
+      @token = response['accessToken']
+    end
+
+    # Sends a DELETE request to deactivate the current access token.
+    def deauthenticate!
+      GunBroker::API.delete('/Users/AccessToken', {}, { 'X-AccessToken' => @token })
+      @token = nil
+      true  # Explicit `true` so this method won't return the `nil` set above.
+    end
+
+    def items
+      response = GunBroker::API.get('/Items', { 'SellerName' => @username }, { 'X-AccessToken' => @token })
+      response['results'].map { |result| GunBroker::Item.new(result) }
+    end
+
+    def unsold_items
+      response = GunBroker::API.get('/ItemsUnsold', {}, { 'X-AccessToken' => @token })
+      response['results'].map { |result| GunBroker::Item.new(result) }
+    end
+
+    def sold_items
+      response = GunBroker::API.get('/ItemsSold', {}, { 'X-AccessToken' => @token })
+      response['results'].map { |result| GunBroker::Item.new(result) }
+    end
+
+  end
+end

data/lib/gun_broker/version.rb

@@ -0,0 +1,3 @@
+module GunBroker
+  VERSION = "0.1.0"
+end

data/spec/fixtures/authenticate.json

@@ -0,0 +1 @@
+{"accessToken":"test-user-access-token"}

data/spec/fixtures/categories.json

@@ -0,0 +1 @@
+{"count":29,"pageIndex":1,"pageSize":25,"results":[{"categoryID":851,"categoryName":"Firearms","canContainItems":false,"description":"Modern Firearms are defined by the ATF as firearms built after 1898. All items listed in this category must be modern firearms. Firearm parts, ammunition, and accessories have their own categories and must be listed there. Items which meet the Collectible firearms, including antiques, commemoratives, and firearms which meet the ATF definition of a 'Curio and Relic' may be listed in the Collectible Firearms category.","categoryPath":{"id":0,"name":"All","child":{"id":851,"name":"Firearms","child":null}},"subCategories":[{"categoryId":978,"categoryName":"Pistols","hasSubCategories":true},{"categoryId":979,"categoryName":"Rifles","hasSubCategories":true},{"categoryId":980,"categoryName":"Shotguns","hasSubCategories":true},{"categoryId":2330,"categoryName":"Cowboy Action Shooting","hasSubCategories":false}],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=851","verb":"GET","title":"Search for items in Firearms"}]},{"categoryID":982,"categoryName":"Gun Parts","canContainItems":false,"description":"Any type of firearm parts or accessories should be listed here.","categoryPath":{"id":0,"name":"All","child":{"id":982,"name":"Gun Parts","child":null}},"subCategories":[{"categoryId":983,"categoryName":"Other Gun Accessories & Parts","hasSubCategories":false},{"categoryId":1017,"categoryName":"Scopes & Gun Optics","hasSubCategories":true},{"categoryId":3013,"categoryName":"Gun Holsters & Gun Leather","hasSubCategories":false},{"categoryId":3014,"categoryName":"Gun Cases & Gun Storage","hasSubCategories":false},{"categoryId":3031,"categoryName":"Gun Cleaning Kits & Gun Cleaning Supplies","hasSubCategories":false},{"categoryId":3035,"categoryName":"Gun Parts Kits","hasSubCategories":false},{"categoryId":3036,"categoryName":"Gun Sights","hasSubCategories":false},{"categoryId":3037,"categoryName":"Shotgun Parts","hasSubCategories":true},{"categoryId":3038,"categoryName":"Pistol Parts","hasSubCategories":true},{"categoryId":3039,"categoryName":"Rifle Parts","hasSubCategories":true},{"categoryId":3040,"categoryName":"1911 Parts","hasSubCategories":false},{"categoryId":3041,"categoryName":"TC Contender Barrels & Parts","hasSubCategories":false},{"categoryId":3042,"categoryName":"SKS Parts","hasSubCategories":false},{"categoryId":3043,"categoryName":"AK47 Parts","hasSubCategories":false},{"categoryId":3044,"categoryName":"AR15 Parts","hasSubCategories":false},{"categoryId":3045,"categoryName":"Glock Parts","hasSubCategories":false},{"categoryId":3046,"categoryName":"HK Parts","hasSubCategories":false},{"categoryId":3074,"categoryName":"Gun Safes & Trigger Locks","hasSubCategories":false},{"categoryId":3097,"categoryName":"Gunsmithing Tools & Gunsmith Supplies","hasSubCategories":false},{"categoryId":4011,"categoryName":"Shooting Glasses & Hearing Protection","hasSubCategories":false},{"categoryId":4013,"categoryName":"Shooting Targets","hasSubCategories":false}],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=982","verb":"GET","title":"Search for items in Gun Parts"}]},{"categoryID":1012,"categoryName":"Ammunition","canContainItems":false,"description":"This category is for ready-to-shoot ammunition for firearms. Reloading supplies such as bullets, brass, primers, etc belong in the Reloading : Supplies category, not here. Clips, magazines, ammo belts, and equipment to carry or load ammunition have their own categories and should not be listed here.","categoryPath":{"id":0,"name":"All","child":{"id":1012,"name":"Ammunition","child":null}},"subCategories":[{"categoryId":3017,"categoryName":"Rifle Ammunition","hasSubCategories":false},{"categoryId":3018,"categoryName":"Pistol Ammunition","hasSubCategories":false},{"categoryId":3019,"categoryName":"Shotgun Shells","hasSubCategories":false},{"categoryId":3020,"categoryName":"Other Ammunition","hasSubCategories":false},{"categoryId":3030,"categoryName":"Vintage Ammo","hasSubCategories":false},{"categoryId":3053,"categoryName":"Ammo Storage","hasSubCategories":false}],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=1012","verb":"GET","title":"Search for items in Ammunition"}]},{"categoryID":3094,"categoryName":"Black Powder & Muzzleloaders","canContainItems":false,"description":"","categoryPath":{"id":0,"name":"All","child":{"id":3094,"name":"Black Powder & Muzzleloaders","child":null}},"subCategories":[{"categoryId":3095,"categoryName":"Black Powder Pistols & Muzzleloader Pistols","hasSubCategories":false},{"categoryId":3096,"categoryName":"Black Powder Rifles & Muzzleloader Rifles","hasSubCategories":false},{"categoryId":4030,"categoryName":"Muzzleloader Supplies & Black Powder Parts","hasSubCategories":false}],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=3094","verb":"GET","title":"Search for items in Black Powder & Muzzleloaders"}]},{"categoryID":2338,"categoryName":"Class 3 Firearms, NFA & Destructive Devices","canContainItems":false,"description":"All types of federally restricted firearms, including machine guns, destructive devices, and silencers","categoryPath":{"id":0,"name":"All","child":{"id":2338,"name":"Class 3 Firearms, NFA & Destructive Devices","child":null}},"subCategories":[{"categoryId":2326,"categoryName":"Machine Guns","hasSubCategories":false},{"categoryId":3098,"categoryName":"Class 3 Parts & Accessories","hasSubCategories":false},{"categoryId":3099,"categoryName":"Silencers & Suppressed Firearms","hasSubCategories":false},{"categoryId":3100,"categoryName":"Destructive Devices","hasSubCategories":false},{"categoryId":4031,"categoryName":"Short Barrel Rifles (SBR)","hasSubCategories":false},{"categoryId":4032,"categoryName":"Any Other Weapon (AOW)","hasSubCategories":false}],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=2338","verb":"GET","title":"Search for items in Class 3 Firearms, NFA & Destructive Devices"}]},{"categoryID":1014,"categoryName":"Collectible Firearms","canContainItems":false,"description":"Items listed in the Collectible Firearms category must be a firearm. Parts and accessories for Collectible Firearms may be listed in Collectible Firearms : Collectible Parts / Accessories provided the item being listed is itself a collectible piece. Non-collectible parts and accessories should be listed in the most appropriate Firearm Parts or Firearm Accessories category.","categoryPath":{"id":0,"name":"All","child":{"id":1014,"name":"Collectible Firearms","child":null}},"subCategories":[{"categoryId":2322,"categoryName":"Antique Guns","hasSubCategories":false},{"categoryId":2323,"categoryName":"Curios & Relics","hasSubCategories":false},{"categoryId":2324,"categoryName":"Muzzleloading Collectibles","hasSubCategories":false},{"categoryId":3012,"categoryName":"Other Collectible Guns","hasSubCategories":false},{"categoryId":3047,"categoryName":"Commemorative Guns","hasSubCategories":false},{"categoryId":3061,"categoryName":"Collectible Gun Parts & Accessories","hasSubCategories":false}],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=1014","verb":"GET","title":"Search for items in Collectible Firearms"}]},{"categoryID":1013,"categoryName":"Air Guns","canContainItems":false,"description":"Only air guns should be listed in this category. Air guns include AirSoft, paintball, BB guns, pellet guns, adult air rifles and pistols, CO2-powered rifles and pistols, and any other type of air or compressed gas powered gun. Air gun parts, supplies, and accessories should be listed in the Air Guns : Supplies / Accessories / Other category.","categoryPath":{"id":0,"name":"All","child":{"id":1013,"name":"Air Guns","child":null}},"subCategories":[{"categoryId":3048,"categoryName":"Airsoft","hasSubCategories":false},{"categoryId":3049,"categoryName":"Air Pistols","hasSubCategories":false},{"categoryId":3050,"categoryName":"Air Rifles","hasSubCategories":false},{"categoryId":3051,"categoryName":"Paintball Guns","hasSubCategories":false},{"categoryId":3052,"categoryName":"Air Gun Accessories","hasSubCategories":false}],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=1013","verb":"GET","title":"Search for items in Air Guns"}]},{"categoryID":1016,"categoryName":"Ammunition Reloading","canContainItems":false,"description":"Equipment and supplies for reloading ammunition should be listed here.  ","categoryPath":{"id":0,"name":"All","child":{"id":1016,"name":"Ammunition Reloading","child":null}},"subCategories":[{"categoryId":3015,"categoryName":"Reloading Equipment","hasSubCategories":false},{"categoryId":3016,"categoryName":"Reloading Supplies","hasSubCategories":false}],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=1016","verb":"GET","title":"Search for items in Ammunition Reloading"}]},{"categoryID":984,"categoryName":"Archery & Bow Hunting","canContainItems":false,"description":"This category is for bows, crossbows, and bow hunting supplies and accessories.","categoryPath":{"id":0,"name":"All","child":{"id":984,"name":"Archery & Bow Hunting","child":null}},"subCategories":[{"categoryId":3054,"categoryName":"Bows","hasSubCategories":false},{"categoryId":3055,"categoryName":"Crossbows","hasSubCategories":false},{"categoryId":3056,"categoryName":"Archery Supplies","hasSubCategories":false}],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=984","verb":"GET","title":"Search for items in Archery & Bow Hunting"}]},{"categoryID":2329,"categoryName":"Books, Videos & Literature","canContainItems":false,"description":"This category is for books, magazines (the kind you read, not the kind you load!), CD-ROM based books or information, videos or DVDs, and any other kind of gun-related reading or viewing materials.","categoryPath":{"id":0,"name":"All","child":{"id":2329,"name":"Books, Videos & Literature","child":null}},"subCategories":[{"categoryId":3057,"categoryName":"Books","hasSubCategories":false},{"categoryId":3058,"categoryName":"Videos & DVDs","hasSubCategories":false},{"categoryId":3059,"categoryName":"Magazines","hasSubCategories":false},{"categoryId":3060,"categoryName":"CD-ROMS","hasSubCategories":false}],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=2329","verb":"GET","title":"Search for items in Books, Videos & Literature"}]},{"categoryID":2332,"categoryName":"Charity Gun Auctions","canContainItems":false,"description":"Charity auctions are reserved for charitable organizations or for auctioning off items in which the proceeds will be donated to a charitable cause. Items cannot be listed in this category without the assistance of the auction site. To list an item here please contact auction site tech support by clicking <a href=\"/Support/\">Contact Us</a> from the bottom of any auction site page.","categoryPath":{"id":0,"name":"All","child":{"id":2332,"name":"Charity Gun Auctions","child":null}},"subCategories":[],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=2332","verb":"GET","title":"Search for items in Charity Gun Auctions"}]},{"categoryID":3000,"categoryName":"Clothing, Bags & Wearables","canContainItems":false,"description":"Any type of clothing, jewelry, hats, bags, backpacks, and other wearable items must be listed here. The only exceptions are items that would be better listed in Collectibles, like collectible pins, badges, etc.","categoryPath":{"id":0,"name":"All","child":{"id":3000,"name":"Clothing, Bags & Wearables","child":null}},"subCategories":[{"categoryId":3062,"categoryName":"Coats & Jackets","hasSubCategories":false},{"categoryId":3064,"categoryName":"Pants & Coveralls","hasSubCategories":false},{"categoryId":3065,"categoryName":"Gloves","hasSubCategories":false},{"categoryId":3066,"categoryName":"Watches & Jewelry","hasSubCategories":false},{"categoryId":3069,"categoryName":"Eyewear","hasSubCategories":false},{"categoryId":3070,"categoryName":"Hats & Headwear","hasSubCategories":false},{"categoryId":3071,"categoryName":"Belts & Belt Buckles","hasSubCategories":false},{"categoryId":3072,"categoryName":"Other Clothing","hasSubCategories":false}],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=3000","verb":"GET","title":"Search for items in Clothing, Bags & Wearables"}]},{"categoryID":3001,"categoryName":"Collectibles & Militaria","canContainItems":false,"description":"Any type of non-firearm collectible items related to firearms or hunting may be listed here. This includes war collectibles, souvenirs, logo merchandise, and catalogs. If the item is a firearm, either modern or antique, it must be placed in either the Collectible Firearms or Modern Firearms categories.","categoryPath":{"id":0,"name":"All","child":{"id":3001,"name":"Collectibles & Militaria","child":null}},"subCategories":[{"categoryId":1015,"categoryName":"Other Military Collectibles","hasSubCategories":false},{"categoryId":3005,"categoryName":"Old West Collectibles","hasSubCategories":false},{"categoryId":3006,"categoryName":"Civil War Collectibles","hasSubCategories":false},{"categoryId":3007,"categoryName":"WW1 & WW2 Collectibles","hasSubCategories":false},{"categoryId":3009,"categoryName":"Souvenirs","hasSubCategories":false},{"categoryId":3010,"categoryName":"Other Collectibles","hasSubCategories":false},{"categoryId":3021,"categoryName":"Badges & Insignias","hasSubCategories":false},{"categoryId":3028,"categoryName":"Logo Merchandise","hasSubCategories":false},{"categoryId":3073,"categoryName":"Flags","hasSubCategories":false},{"categoryId":3109,"categoryName":"Collectible Coins","hasSubCategories":false}],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=3001","verb":"GET","title":"Search for items in Collectibles & Militaria"}]},{"categoryID":2334,"categoryName":"Domain Names","canContainItems":true,"description":"Internet domain names","categoryPath":{"id":0,"name":"All","child":{"id":2334,"name":"Domain Names","child":null}},"subCategories":[],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=2334","verb":"GET","title":"Search for items in Domain Names"}]},{"categoryID":3004,"categoryName":"Everything Else","canContainItems":true,"description":"Anything that does not fit cleanly into any other category should be listed here.","categoryPath":{"id":0,"name":"All","child":{"id":3004,"name":"Everything Else","child":null}},"subCategories":[],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=3004","verb":"GET","title":"Search for items in Everything Else"}]},{"categoryID":4040,"categoryName":"Fishing Tackle","canContainItems":false,"description":"This is the general area for everything related to fishing. GunBroker.com has places for freshwater, saltwater and fly fishing equipment and tackle of all kinds. You can even buy and sell collectible and vintage fishing tackle, rods and reels.","categoryPath":{"id":0,"name":"All","child":{"id":4040,"name":"Fishing Tackle","child":null}},"subCategories":[{"categoryId":4041,"categoryName":"Fishing Collectibles","hasSubCategories":false},{"categoryId":4042,"categoryName":"Fish Finders","hasSubCategories":false},{"categoryId":4043,"categoryName":"Fly Fishing Tackle","hasSubCategories":true},{"categoryId":4044,"categoryName":"Freshwater Fishing Tackle","hasSubCategories":true},{"categoryId":4045,"categoryName":"Saltwater Fishing","hasSubCategories":true},{"categoryId":4046,"categoryName":"Terminal Tackle","hasSubCategories":false},{"categoryId":4047,"categoryName":"Tackle Storage","hasSubCategories":false},{"categoryId":4048,"categoryName":"Other General Fishing","hasSubCategories":false}],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=4040","verb":"GET","title":"Search for items in Fishing Tackle"}]},{"categoryID":901,"categoryName":"Furniture & Cabinets","canContainItems":true,"description":"Furniture, including gun storage cabinets, display cases, and stand-up safes should be listed here.","categoryPath":{"id":0,"name":"All","child":{"id":901,"name":"Furniture & Cabinets","child":null}},"subCategories":[],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=901","verb":"GET","title":"Search for items in Furniture & Cabinets"}]},{"categoryID":3002,"categoryName":"Hunting Gear","canContainItems":false,"description":"This category is for all hunting gear that is not better suited for another category, such as tree stands, scents, traps, and other hunting equipment. Firearms may not be listed here; firearms must be listed in the Modern Firearms category. ","categoryPath":{"id":0,"name":"All","child":{"id":3002,"name":"Hunting Gear","child":null}},"subCategories":[{"categoryId":4000,"categoryName":"Animal Traps","hasSubCategories":false},{"categoryId":4001,"categoryName":"Bags & Packs","hasSubCategories":false},{"categoryId":4002,"categoryName":"Camo Clothing & Accessories","hasSubCategories":false},{"categoryId":4003,"categoryName":"Game Feed & Feeders","hasSubCategories":false},{"categoryId":4004,"categoryName":"Game Cameras","hasSubCategories":false},{"categoryId":4005,"categoryName":"Hunting Dog Supplies","hasSubCategories":false},{"categoryId":4006,"categoryName":"Hunting Scents & Deer Lure","hasSubCategories":false},{"categoryId":4007,"categoryName":"Tree Stands","hasSubCategories":false},{"categoryId":4008,"categoryName":"Hunting Accessories","hasSubCategories":false},{"categoryId":4009,"categoryName":"Hunting Decoys","hasSubCategories":false},{"categoryId":4010,"categoryName":"Game Calls","hasSubCategories":false},{"categoryId":4065,"categoryName":"Scent Elimination","hasSubCategories":false},{"categoryId":4066,"categoryName":"GPS","hasSubCategories":false}],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=3002","verb":"GET","title":"Search for items in Hunting Gear"}]},{"categoryID":3029,"categoryName":"Hunting Trips & Safaris","canContainItems":true,"description":"This category is for hunting or fishing trips, vacations, and excursions.","categoryPath":{"id":0,"name":"All","child":{"id":3029,"name":"Hunting Trips & Safaris","child":null}},"subCategories":[],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=3029","verb":"GET","title":"Search for items in Hunting Trips & Safaris"}]},{"categoryID":2328,"categoryName":"Knives & Swords","canContainItems":false,"description":"All knives, swords, axes, pocket knives, bayonets, machetes, and other bladed items must be listed here. Knives may not be listed in any other category, with the sole exceptions of bayonets which may be listed in the Collectible Firearms : Collectible Parts & Accessories category provided the bayonet is a collectible and attaches to a collectible firearm.","categoryPath":{"id":0,"name":"All","child":{"id":2328,"name":"Knives & Swords","child":null}},"subCategories":[{"categoryId":3075,"categoryName":"Collectible Knives","hasSubCategories":false},{"categoryId":3076,"categoryName":"Daggers","hasSubCategories":false},{"categoryId":3077,"categoryName":"Hunting Knives","hasSubCategories":false},{"categoryId":3078,"categoryName":"Automatic Knives","hasSubCategories":false},{"categoryId":3079,"categoryName":"Pocket Knives","hasSubCategories":false},{"categoryId":3080,"categoryName":"Swords & Axes","hasSubCategories":false},{"categoryId":3081,"categoryName":"Bayonets","hasSubCategories":false},{"categoryId":3082,"categoryName":"Fixed Blade Knives","hasSubCategories":false},{"categoryId":3111,"categoryName":"Knife Accessories","hasSubCategories":false}],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=2328","verb":"GET","title":"Search for items in Knives & Swords"}]},{"categoryID":3003,"categoryName":"Land & Leases","canContainItems":true,"description":"Property for sale, rent, or lease should be listed here.  ","categoryPath":{"id":0,"name":"All","child":{"id":3003,"name":"Land & Leases","child":null}},"subCategories":[],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=3003","verb":"GET","title":"Search for items in Land & Leases"}]},{"categoryID":900,"categoryName":"Non-Firing Replica Guns","canContainItems":true,"description":"The category includes non-firing replica guns (full size or miniature), guns that shoot blanks, or de-militarized firearms. The important distinction is that none of these items can shoot live ammunition nor can be converted to do so and are therefore not subject to FFL transfer.","categoryPath":{"id":0,"name":"All","child":{"id":900,"name":"Non-Firing Replica Guns","child":null}},"subCategories":[],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=900","verb":"GET","title":"Search for items in Non-Firing Replica Guns"}]},{"categoryID":902,"categoryName":"Non-Lethal Weapons","canContainItems":true,"description":"This category is for non-lethal self-defense items, such as pepper spray, stun guns, tasers, and other non-firearm items.","categoryPath":{"id":0,"name":"All","child":{"id":902,"name":"Non-Lethal Weapons","child":null}},"subCategories":[],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=902","verb":"GET","title":"Search for items in Non-Lethal Weapons"}]},{"categoryID":2335,"categoryName":"Services","canContainItems":false,"description":"Gunsmithing services, including repair and customizing","categoryPath":{"id":0,"name":"All","child":{"id":2335,"name":"Services","child":null}},"subCategories":[{"categoryId":3092,"categoryName":"Taxidermy Services","hasSubCategories":false},{"categoryId":3093,"categoryName":"Gunsmithing","hasSubCategories":false}],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=2335","verb":"GET","title":"Search for items in Services"}]},{"categoryID":9001,"categoryName":"Staff Picks","canContainItems":true,"description":"Picks that we think are the best items or the coolest items to have.","categoryPath":{"id":0,"name":"All","child":{"id":9001,"name":"Staff Picks","child":null}},"subCategories":[],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=9001","verb":"GET","title":"Search for items in Staff Picks"}]}],"links":[{"rel":"next","href":"https://api.gunbroker.com/v1/Categories?PageIndex=2","verb":"GET","title":"next"}]}

data/spec/fixtures/category.json

@@ -0,0 +1 @@
+{"categoryID":851,"categoryName":"Firearms","canContainItems":false,"description":"Modern Firearms are defined by the ATF as firearms built after 1898. All items listed in this category must be modern firearms. Firearm parts, ammunition, and accessories have their own categories and must be listed there. Items which meet the Collectible firearms, including antiques, commemoratives, and firearms which meet the ATF definition of a 'Curio and Relic' may be listed in the Collectible Firearms category.","categoryPath":{"id":0,"name":"All","child":{"id":851,"name":"Firearms","child":null}},"subCategories":[{"categoryId":978,"categoryName":"Pistols","hasSubCategories":true},{"categoryId":979,"categoryName":"Rifles","hasSubCategories":true},{"categoryId":980,"categoryName":"Shotguns","hasSubCategories":true},{"categoryId":2330,"categoryName":"Cowboy Action Shooting","hasSubCategories":false}],"links":[{"rel":"search","href":"https://api.gunbroker.com/v1/items?Categories=851","verb":"GET","title":"Search for items in Firearms"}]}

data/spec/fixtures/deauthenticate.json

@@ -0,0 +1 @@
+{"userMessage": "Access token deleted.", "developerMessage": "Access token deleted.", "links": []}

data/spec/fixtures/empty.json

@@ -0,0 +1 @@
+[]

data/spec/fixtures/item.json

@@ -0,0 +1 @@
+{"itemID":465370483,"bidIncrement":0.0,"bids":0,"buyer":null,"cashDiscount":0.0,"categoryID":3032,"categoryName":"Rifle Stocks","collectsSalesTax":false,"condition":{"1":"Factory New"},"currentBid":0.0,"description":"The Magpul STR (Storage/Type Restricted) is a drop-in replacement buttstock for AR15/M4 carbines using mil-spec sized receiver extension tubes. A storage-capable version of the CTR®, the STR has improved cheek weld and two water resistant battery tubes on a compact, reinforced polymer A-frame design. A shielded operation lever and supplemental friction locking system prevent accidental operation and minimize excessive stock movement for enhanced weapon stability and accuracy.","eligibleForImmediateCheckout":false,"endingDate":"2015-02-25T15:37:19Z","fixedPrice":49.99,"hasBuyNow":false,"buyNowPrice":0.0,"hasColor":false,"hasQuickLook":false,"hasPictures":true,"hasReserve":false,"hasReserveBeenMet":false,"hasStarted":true,"hasWinningBid":false,"isActive":true,"isCurrentUserHighBidder":false,"isFeaturedItem":false,"isfflRequired":false,"isFixedPrice":true,"isHighlighted":false,"isShowCaseItem":false,"isTitleBoldface":false,"isWatching":false,"inspectionPeriod":{"1":"AS IS - No refund or exchange"},"itemCharacteristics":[],"location":"Taylors, SC 29687","minimumBid":0.0,"paymentMethods":{"512":"PayPal"},"pictures":["http://pics.gunbroker.com/GB/465370000/465370483/pix789199977.jpg"],"quantity":3,"relistedAsItemID":0,"salesTaxes":[],"seller":{"userID":2266088,"username":"dangerangell","feedbackRating":"C(2)","isffl":false,"isVerified":true},"serialNumber":"","shippingClassCosts":{},"shippingClassesSupported":{"32":"Priority"},"sku":"","startingBid":0.00,"startingDate":"2015-01-26T15:37:19Z","subTitle":"","thumbnailURL":"http://pics.gunbroker.com/GB/465370000/465370483/thumb.jpg","timeLeft":"P26DT14H17M15S","title":"Magpul STR Carbine Stock Mil Spec Black","titleColor":"#000000","upc":"","viewCounter":15,"weight":null,"weightUnit":{"1":"Pounds"},"whoPaysForShipping":{"1":"See item description","4":"Buyer pays actual shipping cost"},"willShipInternational":false,"links":[{"rel":"fixedprice","href":"https://api.gunbroker.com/v1/fixedprice","verb":"POST","title":"Purchase"},{"rel":"watch","href":"https://api.gunbroker.com/v1/itemswatched","verb":"POST","title":"Add to Watch List"},{"rel":"feedback","href":"https://api.gunbroker.com/v1/feedback/summary/2266088","verb":"GET","title":"Feedback"},{"rel":"question","href":"https://api.gunbroker.com/v1/messages/askuser","verb":"POST","title":"Ask a question"},{"rel":"sellersitems","href":"https://api.gunbroker.com/v1/items?IncludeSellers=2266088","verb":"GET","title":"View Seller's Items"},{"rel":"share","href":"http://www.gunbroker.com/Auction/ViewItem.aspx?Item=465370483","verb":"GET","title":"Check out what I found on GunBroker.com!"}]}

data/spec/fixtures/items.json

@@ -0,0 +1 @@
+{"count":1,"pageIndex":1,"pageSize":25,"results":[{"itemID":465370483,"bids":0,"eligibleForImmediateCheckout":false,"endingDate":"2015-02-25T15:37:19Z","isFeaturedItem":false,"isFixedPrice":true,"isHighlighted":false,"isShowCaseItem":false,"isTitleBoldface":false,"hasBuyNow":false,"hasColor":false,"hasQuickLook":false,"hasPictures":true,"hasReserve":false,"hasReserveBeenMet":false,"highBidderID":0,"quantity":3,"price":49.9900,"serialNumber":"","sku":"","subTitle":"","thumbnailURL":"http://pics.gunbroker.com/GB/465370000/465370483/thumb.jpg","timeLeft":"P26DT18H52M28S","title":"Magpul STR Carbine Stock Mil Spec Black","titleColor":"#000000","links":[{"rel":"self","href":"https://api.gunbroker.com/v1/items/465370483","verb":"GET","title":"465370483"}]}],"categoryCounts":[{"id":3032,"name":"Rifle Stocks","count":1}],"links":[{"rel":"share","href":"http://www.gunbroker.com/All/BI.aspx?IncludeSellers=2266088&PageSize=25","verb":"GET","title":"Check out what I found on GunBroker.com!"}]}

data/spec/fixtures/not_authorized.json

@@ -0,0 +1 @@
+{"userMessage":"Unauthorized","developerMessage":"Unauthorized","links":[]}

data/spec/gun_broker/api_spec.rb

@@ -0,0 +1,91 @@
+require 'spec_helper'
+
+describe GunBroker::API do
+
+  let(:token) { 'test-user-access-token' }
+
+  let(:path)     { '/some/resource' }
+  let(:endpoint) { [GunBroker::API::GUNBROKER_API, path].join }
+
+  before(:all) do
+    GunBroker.dev_key = 'test-dev-key'
+  end
+
+  it 'has a GUNBROKER_API constant' do
+    expect(GunBroker::API::GUNBROKER_API).not_to be_nil
+  end
+
+  context '.delete' do
+    context 'on success' do
+      it 'returns JSON parsed response' do
+        stub_request(:delete, endpoint)
+          .with(headers: headers('X-AccessToken' => token))
+          .to_return(body: response_fixture('deauthenticate'))
+
+        response = GunBroker::API.delete(path, {}, headers('X-AccessToken' => token))
+        expect(response).to eq(JSON.parse(response_fixture('deauthenticate')))
+      end
+    end
+
+    context 'on failure' do
+      it 'raises an exception' do
+        stub_request(:delete, endpoint)
+          .with(headers: headers('X-AccessToken' => token))
+          .to_return(body: response_fixture('empty'), status: 500)
+
+        api = GunBroker::API.new(path, {}, headers('X-AccessToken' => token))
+        expect { api.delete! }.to raise_error(GunBroker::Error::RequestError)
+      end
+    end
+  end
+
+  context '.get' do
+    context 'on success' do
+      it 'returns JSON parsed response' do
+        stub_request(:get, endpoint)
+          .with(query: { 'SellerName' => 'test-user' })
+          .to_return(body: response_fixture('items'))
+
+        response = GunBroker::API.get(path, { 'SellerName' => 'test-user' })
+        expect(response).to eq(JSON.parse(response_fixture('items')))
+      end
+    end
+
+    context 'on failure' do
+      it 'raises an exception' do
+        stub_request(:get, endpoint)
+          .to_return(body: response_fixture('empty'), status: 500)
+
+        api = GunBroker::API.new(path)
+        expect { api.get! }.to raise_error(GunBroker::Error::RequestError)
+      end
+    end
+  end
+
+  context '.post' do
+    context 'on success' do
+      it 'returns JSON parsed response' do
+        stub_request(:post, endpoint)
+          .with(
+            headers: headers,
+            body: { username: 'test-user' }
+          )
+          .to_return(body: response_fixture('authenticate'))
+
+        response = GunBroker::API.post(path, { username: 'test-user' }, headers)
+        expect(response).to eq(JSON.parse(response_fixture('authenticate')))
+      end
+    end
+
+    context 'on failure' do
+      it 'raises an exception' do
+        stub_request(:post, endpoint)
+          .to_return(body: response_fixture('empty'), status: 500)
+
+        api = GunBroker::API.new(path)
+        expect { api.post! }.to raise_error(GunBroker::Error::RequestError)
+      end
+    end
+  end
+
+end

data/spec/gun_broker/category_spec.rb

@@ -0,0 +1,81 @@
+require 'spec_helper'
+
+describe GunBroker::Category do
+
+  let(:attrs) { JSON.parse(response_fixture('category')) }
+
+  before(:all) do
+    GunBroker.dev_key = 'test-dev-key'
+  end
+
+  it 'has a ROOT_CATEGORY_ID constant' do
+    expect(GunBroker::Category::ROOT_CATEGORY_ID).not_to be_nil
+  end
+
+  it 'should have an #id' do
+    category = GunBroker::Category.new(attrs)
+    expect(category.id).to eq(attrs['categoryID'])
+  end
+
+  context '.all' do
+    let(:endpoint) { [GunBroker::API::GUNBROKER_API, '/Categories'].join }
+
+    context 'on success' do
+      it 'returns all categories' do
+        stub_request(:get, endpoint)
+          .with(
+            headers: headers,
+            query: { 'ParentCategoryID' => GunBroker::Category::ROOT_CATEGORY_ID }
+          )
+          .to_return(body: response_fixture('categories'))
+
+        categories = GunBroker::Category.all
+        expect(categories).not_to be_empty
+        expect(categories.first).to be_a(GunBroker::Category)
+      end
+    end
+
+    context 'on failure' do
+      it 'should raise a GunBroker::Error::RequestError exception' do
+        stub_request(:get, endpoint)
+          .with(
+            headers: headers,
+            query: { 'ParentCategoryID' => GunBroker::Category::ROOT_CATEGORY_ID }
+          )
+          .to_return(body: response_fixture('not_authorized'), status: 401)
+
+        expect { GunBroker::Category.all }.to raise_error(GunBroker::Error::NotAuthorized)
+      end
+    end
+  end
+
+  context '.find' do
+    let(:attrs) { JSON.parse(response_fixture('category')) }
+    let(:endpoint) { [GunBroker::API::GUNBROKER_API, "/Categories/#{attrs['categoryID']}"].join }
+
+    context 'on success' do
+      it 'returns the Category' do
+        stub_request(:get, endpoint)
+          .with(headers: headers)
+          .to_return(body: response_fixture('category'))
+
+        id = attrs['categoryID']
+        category = GunBroker::Category.find(id)
+        expect(category).to be_a(GunBroker::Category)
+        expect(category.id).to eq(id)
+      end
+    end
+
+    context 'on failure' do
+      it 'should raise a GunBroker::Error::RequestError exception' do
+        stub_request(:get, endpoint)
+          .with(headers: headers)
+          .to_return(body: response_fixture('not_authorized'), status: 401)
+
+        id = attrs['categoryID']
+        expect { GunBroker::Category.find(id) }.to raise_error(GunBroker::Error::NotAuthorized)
+      end
+    end
+  end
+
+end

data/spec/gun_broker/item_spec.rb

@@ -0,0 +1,19 @@
+require 'spec_helper'
+
+describe GunBroker::Item do
+
+  let(:attrs) { JSON.parse(response_fixture('item')) }
+
+  it 'should have an #id' do
+    item = GunBroker::Item.new(attrs)
+    expect(item.id).to eq(attrs['itemID'])
+  end
+
+  context '#[]' do
+    it 'should return the value from @attrs' do
+      item = GunBroker::Item.new(attrs)
+      attrs.each { |k, v| expect(item[k]).to eq(v) }
+    end
+  end
+
+end

data/spec/gun_broker/user_spec.rb

@@ -0,0 +1,175 @@
+require 'spec_helper'
+
+describe GunBroker::User do
+  let(:username) { 'test-user' }
+  let(:password) { 'sekret-passw0rd' }
+  let(:token)    { 'test-user-access-token' }
+
+  before(:all) do
+    GunBroker.dev_key = 'test-dev-key'
+  end
+
+  context '#initialize' do
+    context 'auth_options' do
+      it 'should accept a password' do
+        user = GunBroker::User.new(username, password: password)
+        expect(user.instance_variable_get(:@username)).to eq(username)
+      end
+
+      it 'should accept an access token' do
+        user = GunBroker::User.new(username, token: token)
+        expect(user.token).to eq(token)
+      end
+    end
+  end
+
+  context '#authenticate!' do
+    let(:endpoint) { [GunBroker::API::GUNBROKER_API, '/Users/AccessToken'].join }
+
+    context 'on success' do
+      it 'should set the access token' do
+        stub_request(:post,  endpoint)
+          .with(
+            headers: headers,
+            body: { username: username, password: password },
+          )
+          .to_return(body: { 'accessToken' => token }.to_json)
+
+        user = GunBroker::User.new(username, password: password)
+        user.authenticate!
+
+        expect(user.token).to eq(token)
+      end
+    end
+
+    context 'on failure' do
+      it 'should raise a GunBroker::Error::NotAuthorized exception' do
+        stub_request(:post, endpoint)
+          .with(
+            headers: headers,
+            body: { username: username, password: password }
+          ).to_return(body: response_fixture('not_authorized'), status: 401)
+
+        user = GunBroker::User.new(username, password: password)
+        expect { user.authenticate! }.to raise_error(GunBroker::Error::NotAuthorized)
+      end
+    end
+  end
+
+  context '#deauthenticate!' do
+    let(:endpoint) { [GunBroker::API::GUNBROKER_API, '/Users/AccessToken'].join }
+
+    context 'on success' do
+      it 'should deactivate the current access token' do
+        user = GunBroker::User.new(username, token: token)
+
+        stub_request(:delete, endpoint)
+          .with(headers: headers)
+          .to_return(body: response_fixture('deauthenticate'))
+
+        expect(user.deauthenticate!).to eq(true)
+        expect(user.token).to be_nil
+      end
+    end
+
+    context 'on failure' do
+      it 'should raise an exception' do
+        user = GunBroker::User.new(username, token: token)
+
+        stub_request(:delete, endpoint)
+          .with(headers: headers)
+          .to_return(body: response_fixture('not_authorized'), status: 401)
+
+        expect { user.deauthenticate! }.to raise_error(GunBroker::Error::NotAuthorized)
+      end
+    end
+  end
+
+  context '#items' do
+    let(:endpoint) { [GunBroker::API::GUNBROKER_API, '/Items'].join }
+
+    context 'on success' do
+      it 'returns the User items' do
+        stub_request(:get, endpoint)
+          .with(
+            headers: headers('X-AccessToken' => token),
+            query: { 'SellerName' => username }
+          )
+          .to_return(body: response_fixture('items'))
+
+        user = GunBroker::User.new(username, token: token)
+        expect(user.items).not_to be_empty
+        expect(user.items.first).to be_a(GunBroker::Item)
+      end
+    end
+
+    context 'on failure' do
+      it 'should raise an exception' do
+        stub_request(:get, endpoint)
+          .with(
+            headers: headers('X-AccessToken' => token),
+            query: { 'SellerName' => username }
+          )
+          .to_return(body: response_fixture('not_authorized'), status: 401)
+
+        user = GunBroker::User.new(username, token: token)
+        expect { user.items }.to raise_error(GunBroker::Error::NotAuthorized)
+      end
+    end
+  end
+
+  context '#unsold_items' do
+    let(:endpoint) { [GunBroker::API::GUNBROKER_API, '/ItemsUnsold'].join }
+
+    context 'on success' do
+      it 'returns unsold Items' do
+        stub_request(:get, endpoint)
+          .with(headers: headers('X-AccessToken' => token))
+          .to_return(body: response_fixture('items'))
+
+        user = GunBroker::User.new(username, token: token)
+        expect(user.unsold_items).not_to be_empty
+        expect(user.unsold_items.first).to be_a(GunBroker::Item)
+      end
+    end
+
+    context 'on failure' do
+      it 'raises an exception' do
+        stub_request(:get, endpoint)
+          .with(headers: headers('X-AccessToken' => token))
+          .to_return(body: response_fixture('not_authorized'), status: 401)
+
+        user = GunBroker::User.new(username, token: token)
+        expect { user.unsold_items }.to raise_error(GunBroker::Error::NotAuthorized)
+      end
+    end
+  end
+
+  context '#sold_items' do
+    let(:endpoint) { [GunBroker::API::GUNBROKER_API, '/ItemsSold'].join }
+
+    context 'on success' do
+      it 'returns sold Items' do
+        stub_request(:get, endpoint)
+          .with(headers: headers('X-AccessToken' => token))
+          .to_return(body: response_fixture('items'))
+
+        user = GunBroker::User.new(username, token: token)
+        expect(user.sold_items).not_to be_empty
+        expect(user.sold_items.first).to be_a(GunBroker::Item)
+      end
+    end
+
+    context 'on failure' do
+      it 'raises an exception' do
+        stub_request(:get, endpoint)
+          .with(headers: headers('X-AccessToken' => token))
+          .to_return(body: response_fixture('not_authorized'), status: 401)
+
+        user = GunBroker::User.new(username, token: token)
+        expect { user.sold_items }.to raise_error(GunBroker::Error::NotAuthorized)
+      end
+    end
+  end
+
+end

data/spec/gun_broker_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+describe GunBroker do
+
+  it 'has a VERSION' do
+    expect(GunBroker::VERSION).to be_a(String)
+  end
+
+  context 'dev_key' do
+    let(:key) { 'foo' }
+
+    it 'sets @@dev_key' do
+      GunBroker.dev_key = key
+      expect(GunBroker.class_variable_get(:@@dev_key)).to eq(key)
+    end
+
+    it 'returns @@dev_key' do
+      GunBroker.dev_key = key
+      expect(GunBroker.dev_key).to eq(key)
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+require 'rspec'
+require 'webmock/rspec'
+
+Dir['./spec/support/**/*.rb'].each { |support| require support }
+
+require 'gun_broker'
+
+RSpec.configure do |config|
+  config.include GunBroker::Test::Fixtures
+  config.include GunBroker::Test::Headers
+end

data/spec/support/fixtures.rb

@@ -0,0 +1,11 @@
+module GunBroker
+  module Test
+    module Fixtures
+
+      def response_fixture(name)
+        File.read(File.expand_path("../../fixtures/#{name}.json", __FILE__))
+      end
+
+    end
+  end
+end

data/spec/support/headers.rb

@@ -0,0 +1,14 @@
+module GunBroker
+  module Test
+    module Headers
+
+      def headers(overrides = {})
+        {
+          'Content-Type' => 'application/json',
+          'X-DevKey' => GunBroker.dev_key
+        }.merge(overrides)
+      end
+
+    end
+  end
+end

metadata

@@ -0,0 +1,148 @@
+--- !ruby/object:Gem::Specification
+name: gun_broker
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Dale Campbell
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-01-31 00:00:00.000000000 Z
+dependencies:
+- !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: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.20'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.20'
+description: ''
+email:
+- oshuma@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .ruby-gemset
+- .ruby-version
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- gun_broker.gemspec
+- lib/gun_broker.rb
+- lib/gun_broker/api.rb
+- lib/gun_broker/category.rb
+- lib/gun_broker/error.rb
+- lib/gun_broker/item.rb
+- lib/gun_broker/user.rb
+- lib/gun_broker/version.rb
+- spec/fixtures/authenticate.json
+- spec/fixtures/categories.json
+- spec/fixtures/category.json
+- spec/fixtures/deauthenticate.json
+- spec/fixtures/empty.json
+- spec/fixtures/item.json
+- spec/fixtures/items.json
+- spec/fixtures/not_authorized.json
+- spec/gun_broker/api_spec.rb
+- spec/gun_broker/category_spec.rb
+- spec/gun_broker/item_spec.rb
+- spec/gun_broker/user_spec.rb
+- spec/gun_broker_spec.rb
+- spec/spec_helper.rb
+- spec/support/fixtures.rb
+- spec/support/headers.rb
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.1
+signing_key: 
+specification_version: 4
+summary: GunBroker.com API Ruby library.
+test_files:
+- spec/fixtures/authenticate.json
+- spec/fixtures/categories.json
+- spec/fixtures/category.json
+- spec/fixtures/deauthenticate.json
+- spec/fixtures/empty.json
+- spec/fixtures/item.json
+- spec/fixtures/items.json
+- spec/fixtures/not_authorized.json
+- spec/gun_broker/api_spec.rb
+- spec/gun_broker/category_spec.rb
+- spec/gun_broker/item_spec.rb
+- spec/gun_broker/user_spec.rb
+- spec/gun_broker_spec.rb
+- spec/spec_helper.rb
+- spec/support/fixtures.rb
+- spec/support/headers.rb