link_oracle 0.0.6 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b6e2b4ab5504ee1e7c46cdae0c8e09e6da8fe011
-  data.tar.gz: ca23aebe0f05bbfcda265765b221e293435a1407
+  metadata.gz: 110e466f12d3efec41aec60490aca1c9377c04a0
+  data.tar.gz: f004c197875373848602feb923a0e663e081257f
 SHA512:
-  metadata.gz: 031ed89722243b59d04c5cd789d45f53350dd99245a2eb73b9015a81da788f0751327ce8046250f3b4e81252cae29dad3adef0a1539d649f086681ae32257132
-  data.tar.gz: 53d17b8638ee5b37b33b33a89d40f9191d8bf9b507793be4f58be2d06f522e13195ce3a96bfee78a4f8bd1b107c0193398c8c122d216b74b530e76f6703fe890
+  metadata.gz: 0fdc3d962d3d294a41ff82623a964eaf8d1e9ce0990c9ec88c0bd5178a1c17e7f1a11449f266de2d57635bad5094a914e973c87f719be006de77fe28cad6d45e
+  data.tar.gz: 8a3f2936855992f32ad6d2140164361e0763d7dc3d3182b1a8e8c801080acd1bd8d44c2dc1ef3df5d0feb9cbe94cd64b3a0db291cce020c8518dcdf14282cebb

data/README.md

@@ -18,7 +18,41 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+To parse a link and extract information:
+
+```ruby
+link_data = LinkOracle.extract_from('http://example.com')
+```
+
+This will return a LinkData object. This object makes a a semi-intelligent guess about which image, title, and description to use. To access these defaults:
+
+```ruby
+title = link_data.title
+image_url = link_data.image_url
+description = link_data.description
+```
+
+The LinkData object also contains the parsed data:
+
+```ruby
+parsed_data = link_data.parsed_data
+```
+
+Finally, the LinkData object contains the results from individual sections broken into OpenGraph, Meta, and Body. If you are only interested in OpenGraph results:
+
+```ruby
+found_og_data = link_data.og
+title = found_og_data.title
+image_url = found_og_data.image
+description = found_og_data.description
+```
+
+For Meta or body:
+
+```ruby
+found_meta_data = link_data.meta
+found_body_data = link_data.body
+```
 
 ## Contributing
 

data/lib/link_oracle/request.rb

@@ -26,7 +26,7 @@ class LinkOracle
     def validate_url
       !!URI.parse(url)
     rescue URI::InvalidURIError
-      raise InvalidUrl
+      raise InvalidUrl, url
     end
 
     def response
@@ -34,19 +34,27 @@ class LinkOracle
     end
 
     def request
-      ::RestClient.get url
+      c = ::Curl::Easy.new(url)
+      c.follow_location = true
+      begin
+        c.perform
+      rescue ::Curl::Err::SSLConnectError
+        c.ssl_version = 3
+        c.perform
+      end
+      c
     end
 
     def error_class
-      return if response.code == 200
+      return if response.response_code == 200
       {
         404 => PageNotFound,
         403 => PermissionDenied
-      }[response.code] || BadThingsHappened
+      }[response.response_code] || BadThingsHappened
     end
 
     def parsed_data
-      ::Nokogiri::HTML.parse(response.body)
+      ::Nokogiri::HTML.parse(response.body_str)
     rescue
       raise ParsingError
     end
@@ -57,4 +65,4 @@ class LinkOracle
   class BadThingsHappened < StandardError; end
   class InvalidUrl < StandardError; end
   class ParsingError < StandardError; end
-end
+end

data/lib/link_oracle/version.rb

@@ -1,4 +1,4 @@
 class LinkOracle
-  VERSION = "0.0.6"
+  VERSION = "0.0.7"
 end
 

data/lib/link_oracle.rb

@@ -1,4 +1,4 @@
-require "rest-client"
+require 'curb'
 require 'nokogiri'
 require 'uri'
 
@@ -13,4 +13,4 @@ class LinkOracle
     parsed_url = LinkOracle::Request.new(url).parsed_url
     LinkData.new(parsed_url)
   end
-end
+end

data/link_preview.gemspec

@@ -20,9 +20,10 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency 'nokogiri'
-  spec.add_dependency 'rest-client'
+  spec.add_dependency 'curb'
 
   spec.add_development_dependency "bundler", "~> 1.3"
   spec.add_development_dependency "rake"
   spec.add_development_dependency "rspec"
+  spec.add_development_dependency "webmock"
 end

data/spec/link_oracle/request_spec.rb

@@ -6,7 +6,7 @@ describe LinkOracle::Request do
   let(:code) { 200 }
   let(:response_hash) {
     {
-      code: code,
+      status: code,
       body: body,
       headers: {}
     }
@@ -26,47 +26,59 @@ describe LinkOracle::Request do
     </html>"
   }
 
+
   describe 'perform' do
-    before do
-      RestClient.stub(:get).and_return(
-        double(
-          'response',
-          response_hash
-        )
-      )
-    end
+    context 'request failures' do
+      before do
+        stub_request(:any, url).to_return(response_hash)
+      end
 
-    context 'invalid url' do
-      context 'response code is 404' do
-        let(:code) { 404 }
+      context 'invalid url' do
+        context 'response code is 404' do
+          let(:code) { 404 }
 
-        it 'should raise PageNotFound' do
-          expect {
-            requester.parsed_url
-          }.to raise_error(LinkOracle::PageNotFound)
+          it 'should raise PageNotFound' do
+            expect {
+              requester.parsed_url
+            }.to raise_error(LinkOracle::PageNotFound)
+          end
         end
-      end
 
-      context 'response code is 403' do
-        let(:code) { 403 }
+        context 'response code is 403' do
+          let(:code) { 403 }
 
-        it 'should raise PermissionDenied' do
-          expect {
-            requester.parsed_url
-          }.to raise_error(LinkOracle::PermissionDenied)
+          it 'should raise PermissionDenied' do
+            expect {
+              requester.parsed_url
+            }.to raise_error(LinkOracle::PermissionDenied)
+          end
         end
-      end
 
-      context 'response code is weird' do
-        let(:code) { 42 }
+        context 'response code is weird' do
+          let(:code) { 42 }
 
-        it 'should raise BadThingsHappened' do
-          expect {
-            requester.parsed_url
-          }.to raise_error(LinkOracle::BadThingsHappened)
+          it 'should raise BadThingsHappened' do
+            expect {
+              requester.parsed_url
+            }.to raise_error(LinkOracle::BadThingsHappened)
+          end
+        end
+
+        context 'parsing goes awry' do
+          before do
+            ::Nokogiri::HTML.should_receive(:parse).and_raise(ArgumentError)
+          end
+
+          it 'should raise ParsingError' do
+            expect {
+              requester.parsed_url
+            }.to raise_error(LinkOracle::ParsingError)
+          end
         end
       end
+    end
 
+    context 'malformed url' do
       context 'url is invalid' do
         let(:url) { nil }
 
@@ -76,18 +88,6 @@ describe LinkOracle::Request do
           }.to raise_error(LinkOracle::InvalidUrl)
         end
       end
-
-      context 'parsing goes awry' do
-        before do
-          ::Nokogiri::HTML.should_receive(:parse).and_raise(ArgumentError)
-        end
-
-        it 'should raise ParsingError' do
-          expect {
-            requester.parsed_url
-          }.to raise_error(LinkOracle::ParsingError)
-        end
-      end
     end
   end
-end
+end

data/spec/link_preview_spec.rb

@@ -1,13 +1,14 @@
 require 'spec_helper'
 
 describe LinkOracle do
-  let(:link_data) { LinkOracle.extract_from('http://someurl.com') }
+  let(:link_data) { LinkOracle.extract_from(url) }
+  let(:url) { 'http://someurl.com' }
   let(:response) {
-    double(
-      code: 200,
+    {
+      status: 200,
       body: body,
       headers: {}
-    )
+    }
   }
 
   let(:body) {
@@ -39,7 +40,7 @@ describe LinkOracle do
     HTML
   }
   before do
-    RestClient.stub(:get).and_return(response)
+    stub_request(:any, url).to_return(response)
   end
 
   describe '.extract_from' do
@@ -59,4 +60,4 @@ describe LinkOracle do
       link_data.description.should == 'A description for your face'
     end
   end
-end
+end

data/spec/spec_helper.rb

@@ -2,6 +2,7 @@ $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
 $LOAD_PATH.unshift(File.dirname(__FILE__))
 
 require 'rspec'
+require 'webmock/rspec'
 # Requires supporting files with custom matchers and macros, etc,
 # in ./support/ and its subdirectories.
 Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: link_oracle
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
 platform: ruby
 authors:
 - Ian Cooper
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-10-29 00:00:00.000000000 Z
+date: 2014-04-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -28,7 +28,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rest-client
+  name: curb
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '>='
@@ -83,6 +83,20 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  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'
 description: Scrapes pages for open graph, meta, and lastly, body preview data
 email:
 - developers@socialchorus.com