double_agent 1.0.0 → 1.1.0

data/CHANGELOG

@@ -1,4 +1,8 @@
-== Release 1.0.0 (November 11, 2012) ==
+== Release 1.1.0 (November 11, 2012) ==
+
+* Add DoubleAgent.resource for easy mix-ins into other third-party libraries
+
+== Release 1.0.0 (November 10, 2012) ==
 
 * Changes to parser API
 * Add "mobile?" method to detect mobile OS's

data/README.rdoc

@@ -67,6 +67,18 @@ It gives that class's objects all of the above methods and more.
 
 See the DoubleAgent::Resource module for more info.
 
+== Mixing into third-party code
+
+If you want to mix DoubleAgent::Resource into some third-party code, you may find this helpful:
+
+    DoubleAgent.resource SomeHttpLogParser::LogEntry
+
+If SomeHttpLogParser::LogEntry doesn't already have a user_agent method, do this:
+
+    DoubleAgent.resource SomeHttpLogParser::LogEntry do
+      # some code to return the user agent string
+    end
+
 == Where did stats and logs go?
 
 As of version 1.0.0, double_agent underwent a downsizing. Stats were dropped and moved to their own more generic gem called Graphene. More info at https://github.com/jhollinger/graphene. Logs were also dropped; there are several HTTP log parsers for Ruby, including http-log-parser and Beaver.

data/lib/double_agent/double_agent.rb

@@ -15,6 +15,15 @@ module DoubleAgent
     UserAgent.new(user_agent_string)
   end
 
+  # Mix DoubleAgent::Resource into klass. If klass doesn't already have a user_agent method,
+  # you may pass a block which will be used to define one.
+  def self.resource(klass, &user_agent_block)
+    klass.class_eval do
+      define_method :user_agent, &user_agent_block
+    end if user_agent_block
+    klass.send :include, DoubleAgent::Resource
+  end
+
   # Forwards calls to a UserAgent object
   def self.method_missing(method, *args, &block)
     parse(args.first).send(method)

data/lib/double_agent/version.rb

@@ -1,4 +1,4 @@
 module DoubleAgent
   # Version number
-  VERSION = '1.0.0'
+  VERSION = '1.1.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: double_agent
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-11-10 00:00:00.000000000 Z
+date: 2012-11-11 00:00:00.000000000 Z
 dependencies: []
 description: Browser User Agent string parser
 email: jordan@jordanhollinger.com