dubdubdub 0.3.0 → 0.3.1

data/README.md

@@ -1,4 +1,81 @@
-dubdubdub
+DubDubDub
 =========
 
-Networking dubstep.
+World wide web dubstep... and this is our [theme song](http://www.youtube.com/watch?v=OR6AV9yJPoM).
+
+Description
+===========
+
+So what the hell this? This is a layer for two very useful http libraries: [rest-client](https://github.com/archiloque/rest-client) and [mechanize](https://github.com/sparklemotion/mechanize). If you do any sort of web crawling, browsing, URL following and want to consolidate all your tools in one library, then this one's for you. And if you're serious about that stuff, you're probably using proxies. `DubDubDub` makes it easy to configure proxies for everything you do.
+
+Install
+=======
+
+```
+gem install dubdubdub
+```
+    
+Basics
+======
+
+```ruby
+www = DubDubDub.new
+
+# Uses rest-client and returns a Nokogiri::Document
+www.crawl "http://google.com"
+
+# Uses mechanize and returns a Mechanize::Page
+www.browse "http://google.com"
+
+# Follows and returns the end URL
+www.follow "http://bit.ly/abcdefg"
+
+# Be RESTful
+www.get "http://google.com"
+www.post "http://google.com", {}
+www.delete "http://google.com", {}
+```
+
+Proxies
+=======
+
+```ruby
+www = DubDubDub.new(proxy: "1.2.3.4:80")
+
+# Now all requests will use the proxy
+www.crawl "http://google.com"
+```
+    
+Configuration
+=============
+
+Set a global proxy to use.
+
+```ruby
+DubDubDub.configure do |config|
+  config.proxy = "1.2.3.4:8080"
+end
+
+www = DubDubDub.new(proxy: true)
+```
+
+Be fancy and customize the proxies you want to use by passing in a block which will be called when using a proxy. 
+
+```ruby
+DubDubDub.configure do |config|
+  config.proxy do
+    ["1.2.3.4:8080", "1.2.3.4:80"].sample
+  end
+end
+
+www = DubDubDub.new(proxy: true)
+www.proxy   # => 1.2.3.4:8080 OR 1.2.3.4:80
+```
+    
+Ignore all proxies (useful for testing).
+
+```ruby
+DubDubDub.configure do |config|
+  config.ignore_proxy = true
+end
+```

data/dubdubdub.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "dubdubdub"
-  s.version = "0.3.0"
+  s.version = "0.3.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["James Hu"]
-  s.date = "2012-12-04"
+  s.date = "2012-12-23"
   s.description = "A library that provides web utility methods with proxification."
   s.email = "axsuul@gmail.com"
   s.extra_rdoc_files = [

data/lib/dubdubdub.rb

@@ -1,6 +1,6 @@
 class DubDubDub
   # Version
-  VERSION = "0.3.0"
+  VERSION = "0.3.1"
 
   attr_accessor :client
 

data/lib/dubdubdub/client.rb

@@ -1,6 +1,7 @@
 require 'net/http'
 require 'nokogiri'
 require 'mechanize'
+require 'rest-client'
 
 class DubDubDub::Client
   attr_accessor :proxy_host, :proxy_port, :proxy_user, :proxy_password

data/lib/dubdubdub/exceptions.rb

@@ -78,11 +78,13 @@ class DubDubDub::ResponseError < DubDubDub::Error
     @code = code.to_i
   end
 
-  def message
+  def status_message
     STATUSES[code.to_i]
   end
 
   def to_s
-    "#{code}: #{message} => #{error.class.name}: #{error.message}"
+    "#{code}: #{status_message} => #{error.class.name}: #{error.message}"
   end
+
+  alias :message :to_s
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dubdubdub
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-12-04 00:00:00.000000000 Z
+date: 2012-12-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -208,7 +208,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -785216853355672732
+      hash: 4360410541068935812
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: