reckless 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 86f695a892834cf350aa6981ef710d7f9ad8cb14
+  data.tar.gz: b82ca334df61c7de41cc3db026f460beabe1e853
+SHA512:
+  metadata.gz: 2ceeeb085d34c513e223aa5361eaea13809b113d97983ad7e6ea94737c876abe3e55c70deed8ca1b34c0c69541229d615feec0e874e5de3f3794601da0006c7c
+  data.tar.gz: ebb4f7980ad86c54b00f3bad118a498a164eeb3f91ae23ece37356307af360d6b3e1cd798e36ad0278cc8d434445dbc1efc9087f912795a54c6e082d251a7315

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format=documentation

data/Gemfile

@@ -0,0 +1,2 @@
+source "https://rubygems.org"
+gemspec

data/Gemfile.lock

@@ -0,0 +1,44 @@
+PATH
+  remote: .
+  specs:
+    reckless (0.1.0)
+      faraday (~> 0.7)
+      json (~> 1.8)
+      nokogiri (~> 1.5)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.2.5)
+    docile (1.1.0)
+    faraday (0.8.9)
+      multipart-post (~> 1.2.0)
+    json (1.8.1)
+    mini_portile (0.5.1)
+    multi_json (1.8.2)
+    multipart-post (1.2.0)
+    nokogiri (1.6.0)
+      mini_portile (~> 0.5.0)
+    rake (10.1.1)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.7)
+    rspec-expectations (2.14.4)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.4)
+    simplecov (0.8.2)
+      docile (~> 1.1.0)
+      multi_json
+      simplecov-html (~> 0.8.0)
+    simplecov-html (0.8.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  rake
+  reckless!
+  rspec (~> 2.13)
+  simplecov (~> 0.7)

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Dan Sosedoff, <dan.sosedoff@gmail.com>
+
+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,70 @@
+# Reckless
+
+Ruby client to Chicago's records store Reckless.com
+
+## Installation
+
+Add it to your Gemfile:
+
+```
+gem "reckless"
+```
+
+Or install it manually:
+
+```
+gem install reckless
+```
+
+## Usage
+
+See examples:
+
+```ruby
+require "reckless"
+
+# Search for records
+search = Reckless.search("Nirvana")
+search = Reckless.recent_arrivals
+
+# Get search details
+search.url           # http://www.reckless.com/index.phpkeywords=&format=&cond=&store=&is_search=true&srch=Search
+search.total_pages   # 15
+search.total_results # 450
+search.page          # 1
+search.results       # returns an array of results
+```
+
+Each search result is a simple hash:
+
+```ruby
+{
+  :artist    => "13th Floor Elevators",
+  :title     => "Easter Everywhere (180g, Reissue)",
+  :label     => "International Artist",
+  :price     => 11.99,
+  :type      => "New LP",
+  :condition => "Good Condition",
+  :store     => "Milwaukee Ave"
+}
+```
+
+### Search options
+
+- `page` - Specify a page to fetch. Defaults to `1`
+- `format` -  Choose record format: `LP`, `CD`, `DVD`. Defaults to `LP`
+- `store` - Choose store: `Broadway`, `Milwaukee` or `Loop`. Does not have a default.
+
+## Testing
+
+Execute test suite:
+
+```
+bundle exec rake test
+```
+
+### License
+
+The MIT License (MIT)
+
+Copyright (c) 2014 Dan Sosedoff, <dan.sosedoff@gmail.com>

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler"
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:test) do |t|
+  t.pattern = "spec/**/*_spec.rb"
+  t.verbose = false
+end
+
+task :default => :test

data/lib/reckless/client.rb

@@ -0,0 +1,38 @@
+module Reckless
+  class Client
+    BASE_URL = "http://www.reckless.com"
+
+    def search(keywords = "", options = {})
+      url = "#{BASE_URL}/index.php"
+
+      params = search_options(options).merge(
+        keywords: keywords,
+        is_search: true
+      )
+
+      Reckless::Search.new(url, params)
+    end
+
+    def recent_arrivals(options = {})
+      url = "#{BASE_URL}/new_arrivals.php"
+
+      params = search_options(options).merge(
+        period: options[:period] || 1,
+        style:  options[:style]  || 0
+      )
+
+      Reckless::Search.new(url, params)
+    end
+
+    private
+
+    def search_options(options)
+      {
+        page:   options[:page]   || 1,
+        format: options[:format] || "LP",
+        cond:   options[:cond]   || "",
+        store:  options[:store]  || ""
+      }
+    end
+  end
+end

data/lib/reckless/normalizer.rb

@@ -0,0 +1,25 @@
+module Reckless
+  module Normalizer
+    #
+    # Transform text from all caps to normal capitalized words
+    # Example: SOME GREAT BAND => Some Great Band
+    #
+    def normalize_text(text)
+      text.downcase.split.map(&:capitalize).join(" ")
+    end
+
+    #
+    # Transform artist name to normal representation
+    # Example: Beck, Jeff => Jeff Beck
+    #
+    def normalize_artist(text)
+      if text =~ /[\d]+,[\d]+/
+        text
+      else
+        text.gsub(/(([\w]+),\s?([\w]+))/) do |m|
+          m = "#{$3} #{$2}"
+        end
+      end
+    end
+  end
+end

data/lib/reckless/results_parser.rb

@@ -0,0 +1,61 @@
+module Reckless
+  class ResultsParser
+    include Reckless::Normalizer
+
+    def initialize(body)
+      @document = Nokogiri::HTML(body)
+    end
+
+    def parse
+      find_result_elements.map do |node|
+        {
+          artist:    normalize_artist(fetch_text(node, "artist")),
+          title:     fetch_text(node, "title"),
+          label:     fetch_text(node, "label"),
+          price:     fetch_price(node.css("td").last),
+          type:      fetch_type(node),
+          condition: fetch_condition(node),
+          store:     fetch_store(node)
+        }
+      end
+    end
+
+    private
+
+    def find_result_elements
+      @document.css("table.item")
+    end
+
+    def fetch_price(node)
+      node.to_s.scan(/\$([\d\.]+)/).flatten.first.to_f
+    end
+
+    def fetch_text(node, name)
+      element = node.css("span.#{name}").first
+      element ? normalize_text(element.children.first.text.strip) : ""
+    end
+
+    def fetch_type(node)
+      element = node.css("tr:last-child td b").first
+
+      if element
+        text = element.children.first.text.strip
+        text.scan(/^([\w]+ [\w]+)/).flatten.first
+      end
+    end
+
+    def fetch_condition(node)
+      element = node.css("tr:last-child td b").first
+
+      if element
+        text = element.children.first.text.gsub("Condition", "")
+        text.scan(/\(([\w\s]+)\)/).flatten.first.to_s.strip
+      end
+    end
+
+    def fetch_store(node)
+      match = node.to_s.scan(/<span style="color:#a33; font-weight: bold;">([\w\s]+).<\/span>/)
+      match.flatten.first
+    end
+  end
+end

data/lib/reckless/search.rb

@@ -0,0 +1,48 @@
+module Reckless
+  class Search
+    attr_reader :url, :params
+    attr_reader :page, :total_results, :total_pages
+    attr_reader :results
+
+    def initialize(url, params = {})
+      @url           = url
+      @params        = params
+      @page          = params[:page] || 1
+      @total_results = 0
+      @total_pages   = 0
+      @results       = []
+
+      fetch_page_contents
+      parse_results_count
+      parse_pagination
+      parse_results
+    end
+
+    private
+
+    def fetch_page_contents
+      @body = Faraday.get(@url, @params).body
+    end
+
+    def parse_results_count
+      matches = @body.scan(/<b>([\d]+) found.<\/b>/).flatten
+
+      unless matches.empty?
+        @total_results = matches.first.to_i
+      end
+    end
+
+    def parse_pagination
+      matches = @body.scan(/This is page ([\d]+) of ([\d]+)/).flatten
+
+      unless matches.empty?
+        @page        = matches[0].to_i
+        @total_pages = matches[1].to_i
+      end
+    end
+
+    def parse_results
+      @results = Reckless::ResultsParser.new(@body).parse
+    end
+  end
+end

data/lib/reckless/version.rb

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

data/lib/reckless.rb

@@ -0,0 +1,18 @@
+require "nokogiri"
+require "faraday"
+
+require "reckless/client"
+require "reckless/search"
+require "reckless/normalizer"
+require "reckless/results_parser"
+require "reckless/version"
+
+module Reckless
+  def self.search(keywords = "", options = {})
+    Reckless::Client.new.search(keywords, options)
+  end
+
+  def self.recent_arrivals(options = {})
+    Reckless::Client.new.recent_arrivals(options)
+  end
+end

data/reckless.gemspec

@@ -0,0 +1,24 @@
+require File.expand_path("../lib/reckless/version", __FILE__)
+
+Gem::Specification.new do |spec|
+  spec.name        = "reckless"
+  spec.version     = Reckless::VERSION
+  spec.summary     = "Client for Reckless.com site"
+  spec.description = "Client for Reckless.com site"
+  spec.homepage    = "http://github.com/sosedoff/reckless"
+  spec.authors     = ["Dan Sosedoff"]
+  spec.email       = ["dan.sosedoff@gmail.com"]
+
+  spec.add_dependency "json",     "~> 1.8"
+  spec.add_dependency "faraday",  "~> 0.7"
+  spec.add_dependency "nokogiri", "~> 1.5"
+  
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec",     "~> 2.13"
+  spec.add_development_dependency "simplecov", "~> 0.7"
+
+  spec.files         = `git ls-files`.split("\n")
+  spec.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  spec.executables   = `git ls-files -- bin/*`.split("\n").map{|f| File.basename(f)}
+  spec.require_paths = ["lib"]
+end