kickstarter 0.0.2

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

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

data/README

@@ -0,0 +1,41 @@
+Kickstart
+a simple API for Kickstarter.com
+
+Usage:
+
+  kickstarter = Kickstarter::Base.new(settings)
+  
+  projects = kickstarter.by_category(:games, :page => 1)  
+    # => returns back an array of projects from page 1
+    
+  projects = kickstarter.by_list(:ending_soon, :page => 2, :pages => 3)  
+    # => returns back an array of 3 pages worth of projects, starting from page 2
+
+
+A Kickstart::Project has the following attributes:
+  .name
+  .handle
+  .description
+  .url
+  .owner
+  .email
+  .thumbnail_url
+  .pledge_amount
+  .pledge_precent
+  .pledge_deadline
+  
+and methods:
+  (future)
+  .details => get more details from about the project, from the Project details page
+  
+Options:
+
+  :page => X    # which page number of results to return. May be empty
+  :pages => Y   # number of pages worth of results. Don't be stupid and request too many pages...
+
+
+future: 
+ * support filter by pledge_amount
+
+
+

data/Rakefile

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

data/kickstarter.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "kickstarter/version"
+
+Gem::Specification.new do |s|
+  s.name        = "kickstarter"
+  s.version     = Kickstarter::VERSION
+  s.authors     = ["John Tajima"]
+  s.email       = ["manjiro@gmail.com"]
+  s.homepage    = ""
+  s.summary     = %q{A simple wrapper for Kickstarter.com}
+  s.description = %q{A simple wrapper for kickstarter.com}
+
+  s.rubyforge_project = "kickstarter"
+
+  s.add_dependency "nokogiri"
+  s.add_development_dependency "fakeweb"
+  
+  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"]
+end

data/lib/kickstarter.rb

@@ -0,0 +1,72 @@
+require 'rubygems'
+require "nokogiri"
+require 'open-uri'
+require 'date'
+require "kickstarter/version"
+require "kickstarter/project"
+
+module Kickstarter
+  BASE_URL = "http://kickstarter.com"  
+  
+  Categories = {
+    :comics      => "Comics",
+    :dance       => "Dance",
+    :design      => "Design",
+    :fashion     => "Fashion",
+    :film_video  => "Film & Video",
+    :fine_art    => "Fine Art",
+    :food        => "Food",
+    :games       => "Games",
+    :music       => "Music",
+    :photography => "Photography",
+    :technology  => "Technology",
+    :theatre     => "Theater",
+    :writing     => "Writing & Publishing"
+  }
+  
+  Type = {
+    :recommended => 'recommended', 
+    :popular     => 'popular', 
+    :successful  => 'successful'
+  }
+  
+  Lists = {
+    :recommended       => "recommended",
+    :popular           => "popular",
+    :recently_launched => "recently-launched",
+    :ending_soon       => "ending-soon",
+    :small_projects    => "small-projects",
+    :most_funded       => "most-funded",
+    :curated           => "curated-pages",
+  }
+   
+  # by category
+  # /discover/categories/:category/:subcategories 
+  #  :type # => [recommended, popular, successful]
+  def self.by_category(category, options = {})
+    path = File.join(BASE_URL, 'discover/categories', Categories[category.to_sym], Type[options[:type] || :popular])
+    list_projects(path, options)
+  end
+  
+  # by lists
+  # /discover/:list
+  def self.by_list(list, options = {})
+    path = File.join(BASE_URL, 'discover', Lists[list.to_sym])
+    list_projects(path, options)
+  end
+  
+  private
+  
+  def self.list_projects(url, options = {})
+    start_page = options.fetch(:page, 1)
+    end_page   = start_page + options.fetch(:pages, 0)
+    
+    results = (start_page..end_page).map do |page| 
+      doc = Nokogiri::HTML(open(url))
+      doc.css('.project').map do |node|
+        project = Kickstarter::Project.new(node)
+      end
+    end
+    results.flatten
+  end
+end

data/lib/kickstarter/project.rb

@@ -0,0 +1,93 @@
+module Kickstarter
+  
+  class Project
+    
+    attr_reader :node
+    
+    def initialize(node)
+      @node = node
+    end
+
+    def handle
+      @handle ||= url.split('/projects/').last
+    end
+    
+    def name
+      @name ||= link.inner_html
+    end
+    
+    def description
+      @description ||= node.css('h2 + p').inner_html
+    end
+    
+    def url
+      @url ||= File.join(Kickstarter::BASE_URL, link.attribute('href').to_s.split('?').first)
+    end
+    
+    
+    def owner
+      @owner ||= node.css('h2 span').first.inner_html.gsub(/by/, "").strip
+    end
+    
+    def email
+    end
+    
+    def thumbnail_url
+      @thumbnail_url ||= node.css('.project-thumbnail img').first.attribute('src').to_s
+    end
+    
+    def pledge_amount
+      @pledge_amount ||= node.css('.project-stats li')[1].css('strong').inner_html.gsub(/[^\d]/,'').to_i
+    end
+    
+    def pledge_percent
+      @pledge_percent ||= node.css('.project-stats li strong').inner_html.to_i
+    end
+    
+
+
+#     # can be X days|hours left
+    # or <strong>FUNDED</strong> Aug 12, 2011
+    def pledge_deadline
+      @pledge_deadline ||= begin
+        date = node.css('.project-stats li').last.inner_html.to_s
+        puts "parsing date #{date}"
+        if date =~ /Funded/
+          Date.parse date.split('<strong>Funded</strong>').last.strip
+        elsif date =~ /hours left/
+          future = Time.now + date.match(/\d+/)[0].to_i * 60*60
+          Date.parse(future.to_s)
+        elsif date =~ /days left/
+          Date.parse(Time.now.to_s) + date.match(/\d+/)[0].to_i
+        end
+      end
+    end
+    
+
+    def to_hash
+      {
+        :name            => name,
+        :handle          => handle,
+        :url             => url,
+        :description     => description,
+        :owner           => owner,
+        :pledge_amount   => pledge_amount,
+        :pledge_percent  => pledge_percent,
+        :pledge_deadline => pledge_deadline,
+        :thumbnail_url   => thumbnail_url
+      }
+    end
+
+    def inspect
+      to_hash.inspect
+    end
+    
+    private
+    
+    def link
+      node.css('h2 a').first
+    end
+    
+  end
+  
+end

data/lib/kickstarter/version.rb

@@ -0,0 +1,3 @@
+module Kickstarter
+  VERSION = "0.0.2"
+end

metadata

@@ -0,0 +1,77 @@
+--- !ruby/object:Gem::Specification
+name: kickstarter
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+  prerelease: 
+platform: ruby
+authors:
+- John Tajima
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-08-15 00:00:00.000000000 -04:00
+default_executable: 
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: &70288051444740 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70288051444740
+- !ruby/object:Gem::Dependency
+  name: fakeweb
+  requirement: &70288051444320 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70288051444320
+description: A simple wrapper for kickstarter.com
+email:
+- manjiro@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README
+- Rakefile
+- kickstarter.gemspec
+- lib/kickstarter.rb
+- lib/kickstarter/project.rb
+- lib/kickstarter/version.rb
+has_rdoc: true
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: kickstarter
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: A simple wrapper for Kickstarter.com
+test_files: []