api_roulette 0.0.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: fd2bbe16f87137663f14c4784f16c0aad7d71f3a
+  data.tar.gz: c3ebd65f958682b419a5835d07e94e95a41ea615
+SHA512:
+  metadata.gz: 83dd66029e7562a3f56854e2f3fcce9b9e13c1a2caeeda4d4073b3ba7a1143ad7fb9bd3a6ee553750effc496669abf8fb6857d879839eaecbe5ebbc2c410ee45
+  data.tar.gz: 8b841dd06e9634eae18730e6d36579537516f030732aeaccfe7ca02a7793656c7ed2529c2a24f7b41fcf93058849c3dfe7eccc1c88f50d979b6f4606f744979c

data/.gitignore

@@ -0,0 +1,34 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Clark Feusier
+
+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,9 @@
+api-roulette
+============
+
+Get random APIs from ProgrammableWeb.com
+
+Scrapes API titles, links, categories and descriptions from a pecpage of ProgrammableWeb.com, or provides a given quantity of random APIs
+
+APIRoulette.get_random_api(quantity)
+APIRoulette.get_all_apis_on_page(page_number)

data/Rakefile

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

data/api_roulette.gemspec

@@ -0,0 +1,24 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |spec|
+  spec.name        = 'api_roulette'
+  spec.version     = '0.0.5'
+  spec.date        = '2014-08-16'
+  spec.summary     = "Get random APIs from ProgrammableWeb.com"
+  spec.description = "Scrapes API titles, links, categories and descriptions from a pecpage of ProgrammableWeb.com, or provides a given quantity of random APIs"
+  spec.authors     = ["James Robinson"]
+  spec.email       = 'james.michael.robinson@gmail.com'
+  spec.files       = ["lib/api_roulette.rb"]
+  spec.homepage    = 'http://rubygems.org/gems/api_roulette'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split($/)
+  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.3"
+  spec.add_development_dependency "rake"
+  spec.add_runtime_dependency "nokogiri", '~> 1.6'
+end

data/lib/api_roulette.rb

@@ -0,0 +1,4 @@
+require_relative 'api_roulette/api_roulette_controller'
+require_relative 'api_roulette/api'
+require_relative 'api_roulette/api_store'
+require_relative 'api_roulette/api_loader'

data/lib/api_roulette/api.rb

@@ -0,0 +1,13 @@
+class API
+  attr_reader :title, :description, :category, :url
+  def initialize(params)
+    @url = params.fetch(:url)
+    @title = params.fetch(:title)
+    @description = params.fetch(:description)
+    @category = params.fetch(:category)
+  end
+
+  def to_s
+    "(#{@category}) #{@title} - #{@url}"
+  end
+end

data/lib/api_roulette/api_loader.rb

@@ -0,0 +1,61 @@
+class APILoader
+  def self.load_api_list(page_number=nil)
+    page = (page_number.nil? ? get_random_api_page : get_api_page(page_number))
+    get_apis_from_page(page)
+  end
+
+  private
+
+  def self.get_apis_from_page(page)
+    api_links = extract_api_links_from_page(page)
+    api_descriptions = extract_api_descriptions_from_page(page)
+    api_categories = extract_api_categories_from_page(page)
+
+    convert_api_data_to_api_objects(api_links, api_descriptions, api_categories)
+  end
+
+  def self.get_api_page(page_number)
+    url = "http://www.programmableweb.com/apis/directory?page=#{page_number}"
+    get_webpage(url)
+  end
+
+  def self.get_random_api_page
+    page_number = rand(1..104)
+    get_api_page(page_number)
+  end
+
+  def self.get_webpage(url)
+    Nokogiri::HTML(open(url))
+  end
+
+  def self.extract_api_links_from_page(page)
+    page.css('table tr td.views-field-title a')
+  end
+
+  def self.extract_api_descriptions_from_page(page)
+    page.css('table tr td.views-field-field-api-description')
+  end
+
+  def self.extract_api_categories_from_page(page)
+    page.css('table tr td.views-field-field-article-primary-category')
+  end
+
+  def self.convert_api_data_to_api_objects(links, descriptions, categories)
+    links.map.with_index do |link, index|
+      API.new(convert_link_to_hash(link).merge(convert_description_to_hash(descriptions[index])).merge(convert_category_to_hash(categories[index])))
+    end
+  end
+
+  def self.convert_link_to_hash(link)
+    {url: "#{PW_URL}#{link['href']}", title: link.text}
+  end
+
+  def self.convert_description_to_hash(description)
+    {description: description.text.strip }
+  end
+
+  def self.convert_category_to_hash(category)
+    {category: (category.nil? ? "" : category.text.strip) }
+  end
+
+end

data/lib/api_roulette/api_roulette_controller.rb

@@ -0,0 +1,16 @@
+require 'nokogiri'
+require 'open-uri'
+
+PW_URL = "http://www.programmableweb.com"
+
+class APIRoulette
+  def self.get_random_api(quantity=1)
+    @api_store = APIStore.new(APILoader.load_api_list)
+    @api_store.get_random_api(quantity)
+  end
+
+  def self.get_all_apis_on_page(page_number=0)
+    @api_store = APIStore.new(APILoader.load_api_list(page_number))
+    @api_store.apis
+  end
+end

data/lib/api_roulette/api_store.rb

@@ -0,0 +1,11 @@
+class APIStore
+  attr_reader :apis
+
+  def initialize(apis)
+    @apis = apis
+  end
+
+  def get_random_api(quantity)
+    @apis.sample(quantity)
+  end
+end

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification
+name: api_roulette
+version: !ruby/object:Gem::Version
+  version: 0.0.5
+platform: ruby
+authors:
+- James Robinson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-08-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+description: Scrapes API titles, links, categories and descriptions from a pecpage
+  of ProgrammableWeb.com, or provides a given quantity of random APIs
+email: james.michael.robinson@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- api_roulette.gemspec
+- lib/api_roulette.rb
+- lib/api_roulette/api.rb
+- lib/api_roulette/api_loader.rb
+- lib/api_roulette/api_roulette_controller.rb
+- lib/api_roulette/api_store.rb
+homepage: http://rubygems.org/gems/api_roulette
+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: Get random APIs from ProgrammableWeb.com
+test_files: []