everyx 1.0.2 → 1.0.3

data/History.txt

@@ -1,3 +1,7 @@
+== 1.0.3 / 2007-11-14
+
+* New HTMLMonitor task
+
 == 1.0.2 / 2007-11-13
 
 * Remove some debugging output

data/README.txt

@@ -29,6 +29,7 @@ The requirements listed below are not for Everyx, but for the periodic tasks.  E
 * rss
 * open-uri
 * nserver
+* hpricot
 
 == INSTALL:
 

data/lib/everyx.rb

@@ -1,5 +1,5 @@
 module Everyx
-  VERSION = '1.0.2'
+  VERSION = '1.0.3'
 
   # The class that responsible for running the periodic task
   class Everyx
@@ -38,6 +38,12 @@ module Everyx
     # every the file modification time changes.
     #
     # You'll have to set the +fname+ for the file.
+    #
+    # Example:
+    #
+    #   fm = Everyx::PeriodicTasks::FileMonitor.new
+    #   fm.fname = '/tmp/file.txt'
+    #
     class FileMonitor
       require 'rubygems'
       require 'nserver'
@@ -74,6 +80,11 @@ module Everyx
     # owner.  15 minutes is fairly "standard."
     #
     # You'll have to set the +uri+ before you schedule this.
+    #
+    # Example:
+    #
+    #   rss = Everyx::PeriodicTasks::RSSNotifier.new
+    #   rss.uri = "http://www.slashdot.org/slash.rss"
     class RSSNotifier
       require 'rss/1.0'
       require 'rss/2.0'
@@ -109,6 +120,50 @@ module Everyx
 
     end
 
+    # This class will monitor a normal URI and notify on changes
+    # that match a pattern.
+    #
+    # Example:
+    #
+    #   htmlmon = Everyx::PeriodicTasks::HTMLMonitor.new
+    #   htmlmon.uri = "http://www.slashdot.org/"
+    #   htmlmon.pattern = "//div[@class='title']//a"
+    #
+    # The class uses Hpricot to parse HTML, which accepts either XPath
+    # or CSS-like selectors to match.
+    class HTMLMonitor
+      require 'hpricot'
+      require 'open-uri'
+
+      attr :uri, :writable => true
+      attr :pattern, :writable => true
+
+      def initialize
+        @uri = nil
+        @last = nil
+        @pattern = nil
+      end
+
+      def call
+        doc = Hpricot( open(uri) {|f| f.read } )
+        new = []
+        new_last = nil
+        doc.search( @pattern ).each do |ele|
+          if ele.inner_html != @last
+            new << ele.inner_html
+            new_last = new.last unless new_last
+          end
+        end        
+        @last = new_last if new_last
+        if new.size > 0
+          msg = NServer::Message.new
+          msg.title = "Website updated."
+          msg.text = new.collect {|n| "* #{n}"}.join("\n")
+          NServer::Client.try_notify( msg )
+        end
+      end
+    end
+
   end
 end
 

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.9.4.5
 specification_version: 2
 name: everyx
 version: !ruby/object:Gem::Version 
-  version: 1.0.2
-date: 2007-11-13 00:00:00 -05:00
+  version: 1.0.3
+date: 2007-11-14 00:00:00 -05:00
 summary: Code to run some classes every x seconds
 require_paths: 
 - lib