rpaste 0.0.9

data/History.txt

@@ -0,0 +1,6 @@
+== 0.0.9 / 2008-01-09
+
+ * Initial release.
+ * Supports NoPaste paste board.
+ * Semi-support for PasteBin.
+

data/LICENSE.txt

@@ -0,0 +1,23 @@
+
+
+The MIT License
+
+Copyright (c) 2007-2008 Hal Brodigan
+
+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/Manifest.txt

@@ -0,0 +1,24 @@
+History.txt
+LICENSE.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/rpaste.rb
+lib/rpaste/version.rb
+lib/rpaste/rpaste.rb
+lib/rpaste/metadata.rb
+lib/rpaste/paste.rb
+lib/rpaste/result_set.rb
+lib/rpaste/nopaste/metadata.rb
+lib/rpaste/nopaste/paste.rb
+lib/rpaste/nopaste/result_set.rb
+lib/rpaste/nopaste/recent.rb
+lib/rpaste/nopaste/nopaste.rb
+lib/rpaste/nopaste.rb
+lib/rpaste/pastebin/metadata.rb
+lib/rpaste/pastebin/paste.rb
+lib/rpaste/pastebin/result_set.rb
+lib/rpaste/pastebin/recent.rb
+lib/rpaste/pastebin/pastebin.rb
+lib/rpaste/pastebin.rb
+test/test_rpaste.rb

data/README.txt

@@ -0,0 +1,48 @@
+RPaste
+    by Postmodern Modulus III
+    http://rubyforge.net/projects/rpaste/
+
+== DESCRIPTION:
+  
+RPaste provides access to many of the online paste services. Currently
+RPaste supports NoPaste and PasteBin.
+
+== FEATURES/PROBLEMS:
+  
+* Supports posting and retrieving from NoPaste.
+* Supports retrieving from PasteBin.
+* Provides HTTP access with custom User-Agent strings.
+
+== REQUIREMENTS:
+
+* Hpricot
+* Mechanize
+
+== INSTALL:
+
+  $ sudo gem install rpaste
+
+== LICENSE:
+
+The MIT License
+
+Copyright (c) 2007-2008 Hal Brodigan
+
+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/Rakefile

@@ -0,0 +1,18 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/rpaste/version.rb'
+
+Hoe.new('rpaste', RPaste::VERSION) do |p|
+  p.rubyforge_name = 'rpaste'
+  p.author = 'Postmodern Modulus III'
+  p.email = 'postmodern.mod3@gmail.com'
+  p.summary = 'RPaste provides access to many of the online paste services'
+  p.description = p.paragraphs_of('README.txt', 2..5).join("\n\n")
+  p.url = p.paragraphs_of('README.txt', 0).first.split(/\n/)[1..-1]
+  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+  p.extra_deps = ['hpricot', 'mechanize']
+end
+
+# vim: syntax=Ruby

data/lib/rpaste/metadata.rb

@@ -0,0 +1,23 @@
+module RPaste
+  class Metadata
+
+    # Name of the paste
+    attr_accessor :name
+
+    # Author of the paste
+    attr_accessor :author
+
+    #
+    # Creates a new Metadata object with the given _name_ and _author_.
+    # If a block is given, it will be passed the newly created Metadata
+    # object.
+    #
+    def initialize(name,author,&block)
+      @name = name
+      @author = author
+
+      block.call(self) if block
+    end
+
+  end
+end

data/lib/rpaste/nopaste/metadata.rb

@@ -0,0 +1,50 @@
+require 'rpaste/nopaste/paste'
+require 'rpaste/metadata'
+
+module RPaste
+  module NoPaste
+    class Metadata < RPaste::Metadata
+
+      include Comparable
+
+      # Date of the paste
+      attr_accessor :date
+
+      # Syntax of the paste text
+      attr_accessor :syntax
+
+      # Description of the paste
+      attr_accessor :description
+
+      #
+      # Creates a new NoPaste Metadata object with the specified _name_,
+      # _author_, _date_, _syntax_ and _description_.
+      #
+      def initialize(name,author,date,syntax,description,&block)
+        @date = Time.parse(date)
+        @syntax = syntax
+        @description = description
+
+        super(name,author,&block)
+      end
+
+      #
+      # Returns the NoPaste Paste object associated with the Metadata
+      # object. If _opts_ are given they will be used in accessing
+      # the NoPaste website.
+      #
+      def paste(opts={})
+        Paste.paste(name,opts)
+      end
+
+      #
+      # Compare self to another NoPaste Metadata object based on their
+      # respective dates.
+      #
+      def <=>(other)
+        @date <=> other.date
+      end
+
+    end
+  end
+end

data/lib/rpaste/nopaste/nopaste.rb

@@ -0,0 +1,60 @@
+require 'rpaste/nopaste/recent'
+require 'rpaste/nopaste/paste'
+require 'rpaste/rpaste'
+
+require 'hpricot'
+
+module RPaste
+  module NoPaste
+    #
+    # Returns the list of all recent pastes on NoPaste. See Recent.get.
+    #
+    def NoPaste.recent(opts={},&block)
+      Recent.get(opts,&block)
+    end
+
+    #
+    # Retrieves the NoPaste Paste object associated with the specified
+    # _name_. See Paste.paste.
+    #
+    def NoPaste.paste(name,opts={})
+      Paste.paste(name,opts)
+    end
+
+    #
+    # Submits a new paste to NoPaste. If a _block_ is given, then it will be
+    # passed the Paste object before it is submitted to NoPaste.
+    #
+    #   NoPaste.post(:author => 'briefcase man') do |paste|
+    #     paste.description = 'todays key'
+    #     paste.text = 'is brought to you by the letter S, for symmetric'
+    #   end
+    #
+    def NoPaste.post(opts={},&block)
+      author = opts[:author]
+      syntax = opts[:syntax]
+      description = opts[:description]
+      text = opts[:text]
+
+      paste = Paste.new(nil,author,nil,syntax,description,text,&block)
+
+      agent = RPaste.http_agent(opts)
+      page = agent.get('http://rafb.net/paste/index.html')
+      form = page.forms.first
+
+      form.lang = paste.syntax if paste.syntax
+      form.nick = paste.author if paste.author
+      form.desc = paste.description if paste.description
+
+      if opts[:convert_tabs]
+        form.cvt_tabs = opts[:convert_tabs]
+      end
+
+      form.text = paste.text
+      page = agent.submit(form)
+
+      paste.name = page.search('//tr[3]/td/small').inner_text.gsub(/^URL: .*\//,'').gsub(/\.html$/,'')
+      return paste
+    end
+  end
+end

data/lib/rpaste/nopaste/paste.rb

@@ -0,0 +1,50 @@
+require 'rpaste/paste'
+require 'rpaste/rpaste'
+
+require 'hpricot'
+
+module RPaste
+  module NoPaste
+    class Paste < RPaste::Paste
+
+      PREFIX_URL = 'http://rafb.net/p/'
+
+      # Description of the entry
+      attr_accessor :description
+
+      #
+      # Creates a new NoPaste Paste object with the given _name_, _author_,
+      # _date_, _syntax_, _description_ and _text_.
+      #
+      def initialize(name=nil,author=nil,date=nil,syntax=nil,description=nil,text=nil,&block)
+        @description = description
+
+        super(name,author,date,syntax,text,&block)
+      end
+
+      #
+      # Returns the URL of the NoPaste Paste object.
+      #
+      def url
+        "#{PREFIX_URL}#{@name}.html"
+      end
+
+      #
+      # Retrieves the NoPaste Paste object associated with the specified
+      # _name_. If _opts_ are given they will be used in accessing the
+      # NoPaste website.
+      #
+      def self.paste(name,opts={})
+        page = Hpricot(RPaste.open("#{PREFIX_URL}#{name}.html",opts))
+
+        return Paste.new(name) do |paste|
+          paste.syntax = page.search('//table[1]/tr[1]/td/small/b[1]').inner_text
+          paste.author = page.search('//table[1]/tr[1]/td/small/b[2]').inner_text
+          paste.description = page.search('//table[1]/tr[2]/td/small').inner_text.gsub(/^Description: /,'')
+          paste.text = page.search('#codemain').inner_text
+        end
+      end
+
+    end
+  end
+end

data/lib/rpaste/nopaste/recent.rb

@@ -0,0 +1,47 @@
+require 'rpaste/nopaste/result_set'
+require 'rpaste/rpaste'
+
+require 'hpricot'
+
+module RPaste
+  module NoPaste
+    class Recent < ResultSet
+
+      URL = 'http://www.rafb.net/paste/results.html'
+
+      #
+      # Returns the list of recent pastes on NoPaste. If _opts_ are
+      # given they will be used in accessing the NoPaste website. If a
+      # _block_ is given, it will be passed the list of recent pastes.
+      #
+      def self.get(opts={},&block)
+        len = opts[:length]
+
+        if len.nil? || len==0
+          len = -1
+        else
+          len = len.to_i+1
+        end
+
+        page = Hpricot(RPaste.open(URL,opts))
+        rows = page.search('//div.filelist/table/tr')[1..len]
+
+        metadata = rows.map do |row|
+          name = row.search('td[4]/a').first.get_attribute('href').gsub(/^.*\//,'').gsub(/\..*$/,'')
+          date = row.search('td[1]').inner_text
+          syntax = row.search('td[2]').inner_text
+          author = row.search('td[3]').inner_text
+          description = row.search('td[4]/a').inner_text
+
+          Metadata.new(name,author,date,syntax,description)
+        end
+
+        new_recent = self.new(metadata)
+
+        block.call(new_recent) if block
+        return new_recent
+      end
+
+    end
+  end
+end

data/lib/rpaste/nopaste/result_set.rb

@@ -0,0 +1,180 @@
+require 'rpaste/nopaste/metadata'
+require 'rpaste/resultset'
+
+module RPaste
+  module NoPaste
+    class ResultSet < RPaste::ResultSet
+
+      #
+      # Selects the metadata with dates in between _start_ and _stop_.
+      #
+      def between_dates(start,stop)
+        self.select { |data| data.date.between?(start,stop) }
+      end
+
+      #
+      # Selects the metadata with the specified _syntax_.
+      #
+      #   results.with_syntax('PHP')
+      #
+      def with_syntax(syntax)
+        self.select { |data| data.syntax == syntax }
+      end
+
+      #
+      # Selects the metadata containing _description_.
+      #
+      #   results.with_description('hello world')
+      #   results.with_description(/(form|reg)/)
+      #
+      def with_description(description)
+        if description.kind_of?(Regexp)
+          return self.select { |data| data.description =~ description }
+        else
+          return self.select { |data| data.description.include?(description) }
+        end
+      end
+
+      #
+      # A symonym for with_description.
+      #
+      def search(desc)
+        with_description(desc)
+      end
+
+      #
+      # Iterates over the metadata with dates falling in between
+      # _start_ and _stop_, passing each to the given _block_.
+      #
+      def each_between_dates(start,stop,&block)
+        between_dates(start,stop).each(&block)
+      end
+
+      #
+      # Iterates over the metadata with the matching _syntax_, passing each
+      # to the given _block_.
+      #
+      #   results.each_with_syntax('ASM') do |metadata|
+      #     puts metadata.description
+      #   end
+      #
+      def each_with_syntax(syntax,&block)
+        with_syntax(syntax).each(&block)
+      end
+
+      #
+      # Iterates over the metadata with the matching _description_, passing
+      # each to the given _block_.
+      #
+      #   results.each_with_description('fizz') do |metadata|
+      #     puts metadata.author
+      #   end
+      #
+      #   results.each_with_description(/(fi|bu)zz/) do |metadata|
+      #     puts metadata.syntax
+      #   end
+      #
+      def each_with_description(description,&block)
+        with_description(description).each(&block)
+      end
+
+      #
+      # Returns the pastes with dates falling in between _start_ and
+      # _stop_.
+      #
+      def pastes_between_dates(start,stop)
+        pastes_with { |data| data.date.between?(start,stop) }
+      end
+
+      #
+      # Returns the pastes with the matching _syntax_.
+      #
+      #   results.pastes_with_syntax('Javascript')
+      #
+      def pastes_with_syntax(syntax)
+        pastes_with { |data| data.syntax == syntax }
+      end
+
+      #
+      # Returns the pastes with the matching _description_.
+      #
+      #   results.pastes_with_description('error')
+      #   results.pastes_with_description(/\d+(\.\d+)+/)
+      #
+      def pastes_with_description(description)
+        if description.kind_of?(Regexp)
+          return pastes_with { |data| data.description =~ description }
+        else
+          return pastes_with { |data| data.description.include?(description) }
+        end
+      end
+
+      #
+      # Returns the pastes with the matching _text_.
+      #
+      #   results.pastes_with_text('strcpy')
+      #   results.pastes_with_text(/printf\([^\",]+,/)
+      #
+      def pastes_with_text(text)
+        if text.kind_of?(Regexp)
+          return pastes_with { |data| data.text =~ text }
+        else
+          return pastes_with { |data| data.text.include?(text) }
+        end
+      end
+
+      #
+      # Iterates over the pastes with dates falling in between _start_ and
+      # _stop_, passing each to the given _block_.
+      #
+      def each_paste_between_dates(start,stop,&block)
+        pastes_between_dates(start,stop).each(&block)
+      end
+
+      #
+      # Iterates over the pastes with the matching _syntax_, passing each
+      # to the given _block_.
+      #
+      #   results.each_paste_with_syntax('Java') do |paste|
+      #     puts paste.author
+      #   end
+      #
+      def each_paste_with_syntax(syntax,&block)
+        pastes_with_syntax(syntax).each(&block)
+      end
+
+      #
+      # Itereates over the pastes with the matching _description_, passing
+      # each to the given _block_.
+      #
+      #   results.each_paste_with_description('stack') do |paste|
+      #     puts paste.text
+      #   end
+      #
+      #   results.each_paste_with_description(/(weird|odd)/) do |paste|
+      #     puts paste.text
+      #   end
+      #
+      def each_paste_with_description(description,&block)
+        pastes_with_syntax(description).each(&block)
+      end
+
+      #
+      # Iterates over the pastes with the matching _text_, passing each to
+      # the given _block_.
+      #
+      #   results.each_paste_with_text('$_GET') do |paste|
+      #     puts paste.text
+      #   end
+      #
+      #   results.each_paste_with_text(/goto/) do |paste|
+      #     puts paste.author
+      #   end
+      #
+      def each_paste_with_text(text,&block)
+        pastes_with_text(text).each(&block)
+      end
+
+    end
+  end
+end

data/lib/rpaste/nopaste.rb

@@ -0,0 +1,4 @@
+require 'rpaste/nopaste/metadata'
+require 'rpaste/nopaste/paste'
+require 'rpaste/nopaste/recent'
+require 'rpaste/nopaste/nopaste'

data/lib/rpaste/paste.rb

@@ -0,0 +1,49 @@
+module RPaste
+  class Paste
+
+    # Name of the entry
+    attr_accessor :name
+
+    # Author of the entry
+    attr_accessor :author
+
+    # Date of the entry
+    attr_accessor :date
+
+    # Syntax of the entry text
+    attr_accessor :syntax
+
+    # Text of the entry
+    attr_accessor :text
+
+    #
+    # Creates a new Paste object with the optional _name_, _author_, _date_,
+    # _syntax_ and _text_. If a block is given, then it will be passed the
+    # newly created Paste object.
+    #
+    def initialize(name=nil,author=nil,date=nil,syntax=nil,text=nil,&block)
+      @name = name
+      @author = author
+      @date = Time.parse(date) if date
+      @syntax = syntax
+      @text = text
+
+      block.call(self) if block
+    end
+
+    #
+    # Returns a string containing the text of the paste.
+    #
+    def to_s
+      @text.to_s
+    end
+
+    #
+    # Returns an array containing the text lines of the paste.
+    #
+    def to_a
+      self.to_s.split
+    end
+
+  end
+end

data/lib/rpaste/pastebin/metadata.rb

@@ -0,0 +1,23 @@
+require 'rpaste/metadata'
+
+module RPaste
+  module PasteBin
+    class Metadata < RPaste::Metadata
+
+      # Time since being posted
+      attr_reader :age
+
+      #
+      # Creates a new PasteBin Metadata object with the specified _name_,
+      # _author_ and _age_. If a block is given, then it will be passed
+      # the newly created PasteBin Metadata object.
+      #
+      def initialize(name,author,age,&block)
+        @age = age
+
+        super(name,author,&block)
+      end
+
+    end
+  end
+end

data/lib/rpaste/pastebin/paste.rb

@@ -0,0 +1,47 @@
+require 'rpaste/paste'
+require 'rpaste/rpaste'
+
+module RPaste
+  module PasteBin
+    class Paste < RPaste::Paste
+
+      PREFIX_URL = 'http://pastebin.com/'
+
+      # Time to retain
+      attr_reader :retained
+
+      #
+      # Creates a new PasteBin Paste object with the given _name_, _author_,
+      # _date_, _syntax_, _retained_ and _text_. If a block is given, then
+      # it will be passed the newly created PasteBin Paste object.
+      #
+      def initialize(name=nil,author=nil,date=nil,syntax=nil,retained=nil,text=nil,&block)
+        @retained = retained
+
+        super(name,author,date,syntax,text,&block)
+      end
+
+      #
+      # Returns the URL of the PasteBin Paste object.
+      #
+      def url
+        "#{PREFIX_URL}#{@name}"
+      end
+
+      #
+      # Retrieves the PasteBin Paste object associated with the specified
+      # _name_. If _opts_ is given they will be used in accessing the
+      # PasteBin website.
+      #
+      def self.paste(name,opts={})
+        page = Hpricot(RPaste.open("#{PREFIX_URL}#{name}",opts))
+
+        return Paste.new(name) do |paste|
+          paste.text = page.search('//div.text/ol/li').inner_text
+          paste.author = page.search('#content/h1[1]'.inner_text.gsub(/Posted by /,'').split(' on ')
+        end
+      end
+
+    end
+  end
+end

data/lib/rpaste/pastebin/pastebin.rb

@@ -0,0 +1,55 @@
+require 'rpaste/pastebin/recent'
+require 'rpaste/pastebin/paste'
+require 'rpaste/rpaste'
+
+require 'hpricot'
+
+module RPaste
+  module PasteBin
+    #
+    # Returns the list of all recent pastes on PasteBin. See Recent.get.
+    #
+    def PasteBin.recent(opts={},&block)
+      Recent.get(opts,&block)
+    end
+
+    #
+    # Submits a new paste to PasteBin. If a _block_ is given, then it will be
+    # passed the Paste object before it is submitted to PasteBin.
+    #
+    #   PasteBin.post(:author => 'xyz') do |paste|
+    #     paste.description = 'test'
+    #     paste.text = %{
+    #       <?xml version="1.0" ?>
+    #       <test>
+    #         <x>1</x>
+    #         <y>0</y>
+    #       </test>
+    #     }
+    #   end
+    #
+    def PasteBin.post(opts={},&block)
+      paste = Paste.new(opts,&block)
+
+      agent = RPaste.http_agent(opts)
+      page = agent.get('http://pastebin.com/pastebin.php')
+      form = page.forms.first
+
+      form.format = paste.syntax if paste.syntax
+      form.code2 = paste.text
+      form.poster = paste.author if paste.author
+
+      case paste.retained
+      when :day then
+        form.expire = 'd'
+      when :month
+        form.expire = 'm'
+      when :forever
+        form.expire = 'f'
+      end
+
+      agent.submit(form)
+      return true
+    end
+  end
+end

data/lib/rpaste/pastebin/recent.rb

@@ -0,0 +1,47 @@
+require 'rpaste/pastebin/result_set'
+require 'rpaste/rpaste'
+
+require 'hpricot'
+
+module RPaste
+  module PasteBin
+    class Recent < ResultSet
+
+      URL = 'http://pastebin.com/'
+
+      MAX_LENGTH = 10
+
+      #
+      # Returns the list of recent pastes on PasteBin. If _opts_ are
+      # given they will be used in accessing the PasteBin website. If a
+      # _block_ is given, it will be passed the list of recent pastes.
+      #
+      def self.get(opts={},&block)
+        len = opts[:length]
+
+        if (len.nil? || len>MAX_LENGTH)
+          len = MAX_LENGTH
+        else
+          len = len.to_i
+        end
+
+        page = Hpricot(RPaste.open(URL,opts))
+        rows = page.search('#menu/ul/li')[0...len]
+
+        metadata = rows.map do |row|
+          name = row.search('a').first.get_attribute('href').gsub(/^.*\//,'')
+          author = row.search('a').inner_text
+          ago = row.inner_text
+
+          Metadata.new(name,author,ago)
+        end
+
+        new_recent = self.new(metadata)
+
+        block.call(new_recent) if block
+        return new_recent
+      end
+
+    end
+  end
+end

data/lib/rpaste/pastebin/result_set.rb

@@ -0,0 +1,40 @@
+require 'rpaste/pastebin/metadata'
+require 'rpaste/result_set'
+
+module RPaste
+  module NoPaste
+    class ResultSet < RPaste::ResultSet
+
+      #
+      # Selects the metadata with ages between _start_ and _stop_.
+      #
+      def between_ages(start,stop)
+        self.select { |data| data.ago.between?(start,stop) }
+      end
+
+      #
+      # Iterates over the metadata with ages between _start_ and _stop_,
+      # passing each to the given _block_.
+      #
+      def each_between_ages(start,stop,&block)
+        between_ages(start,stop).each(&block)
+      end
+
+      #
+      # Returns the pastes with ages between _start_ and _stop_.
+      #
+      def pastes_between_ages(start,stop)
+        pastes_with { |data| data.age.between?(start,stop) }
+      end
+
+      #
+      # Iterates over the pastes with ages between _start_ and _stop_,
+      # passing each to the given _block_.
+      #
+      def each_paste_between_ages(start,stop,&block)
+        pastes_between_ages(start,stop).each(&block)
+      end
+
+    end
+  end
+end

data/lib/rpaste/pastebin.rb

@@ -0,0 +1,3 @@
+require 'rpaste/pastebin/metadata'
+require 'rpaste/pastebin/paste'
+require 'rpaste/pastebin/pastebin'

data/lib/rpaste/result_set.rb

@@ -0,0 +1,253 @@
+module RPaste
+  class ResultSet < Array
+
+    #
+    # Creates a new ResultSet object with the given _results_.
+    #
+    def initialize(results=[],&block)
+      @pastes = {}
+
+      super(results,&block)
+    end
+
+    #
+    # Selects metadata with the matching _name_.
+    #
+    #   results.with_name('secret')
+    #   results.with_name(/login/)
+    #
+    def with_name(name)
+      if name.kind_of?(Regexp)
+        return self.select { |data| data.name =~ name }
+      else
+        return self.select { |data| data.name == name }
+      end
+    end
+
+    #
+    # Selects metadata with the matching _author_.
+    #
+    #   results.by_author('dj food')
+    #   results.by_author(/^ro/)
+    #
+    def by_author(author)
+      if author.kind_of?(Regexp)
+        return self.select { |data| data.author =~ author }
+      else
+        return self.select { |data| data.author == author }
+      end
+    end
+
+    #
+    # Iterates over the metadata with the matching name, passing each
+    # to the given _block_.
+    #
+    #   results.each_with_name('secret')
+    #   results.each_with_name(/reg/)
+    #
+    def each_with_name(name,&block)
+      with_name(name).each(&block)
+    end
+
+    #
+    # Iterates over the metadata with the matching author name, passing
+    # each to the given _block_.
+    #
+    #   results.each_by_author('aphex twin')
+    #   results.each_by_author(/square/)
+    #
+    def each_by_author(author,&block)
+      by_author(author).each(&block)
+    end
+
+    #
+    # Returns the paste at the given _index_. If _index_ is a Range, then
+    # all Pastes within the range are returned.
+    #
+    #   results.paste(10)
+    #   results.paste(1..4)
+    #
+    def paste(index)
+      if index.kind_of?(Range)
+        return self[index].map { |data| cache_paste(data) }
+      else
+        return cache_paste(self[index])
+      end
+    end
+
+    #
+    # Returns all pastes.
+    #
+    def pastes
+      self.map { |data| cache_paste(data) }
+    end
+
+    #
+    # Iterates over all pastes, passing each to the given _block_.
+    #
+    #   results.each_paste do |paste|
+    #     if paste.syntax == 'ASM'
+    #       puts paste
+    #     end
+    #   end
+    #
+    def each_paste(&block)
+      pastes.each(&block)
+    end
+
+    #
+    # Returns the pastes which match the given _block_.
+    #
+    def pastes_with(&block)
+      self.select(&block).map { |data| cache_paste(data) }
+    end
+
+    #
+    # Returns the pastes which have the matching _name_.
+    #
+    #   results.pastes_with_name('config')
+    #   results.pastes_with_name(/rock/)
+    #
+    def pastes_with_name(name)
+      if name.kind_of?(Regexp)
+        return pastes_with { |data| data.name =~ name }
+      else
+        return pastes_with { |data| data.name == name }
+      end
+    end
+
+    #
+    # Returns the pastes which have the matching _author_.
+    #
+    #   results.pastes_by_author('adam freeland')
+    #   results.pastes_by_author(/hendrix/)
+    #
+    def pastes_by_author(author)
+      if author.kind_of?(Regexp)
+        return pastes_with { |data| data.author =~ author }
+      else
+        return pastes_with { |data| data.author == author }
+      end
+    end
+
+    #
+    # Returns the pastes which have the matching _date_.
+    #
+    #   results.pastes_on_date(Time.now)
+    #
+    def pastes_on_date(date)
+      pastes_with { |data| data.date == date }
+    end
+
+    #
+    # Returns the pastes which have the matching _syntax_.
+    #
+    #   results.pastes_with_syntax('C')
+    #
+    def pastes_with_syntax(syntax)
+      pastes_with { |data| data.syntax == syntax }
+    end
+
+    #
+    # Returns the pastes which contain the specified _text_.
+    #
+    #   results.pastes_with_text('ls')
+    #
+    def pastes_with_text(text)
+      if text.kind_of?(Regexp)
+        return pastes_with { |data| data.text =~ text }
+      else
+        return pastes_with { |data| data.text == text }
+      end
+    end
+
+    #
+    # Iterates over the pastes with the matching _name_, passing each
+    # to the given _block_.
+    #
+    #   results.each_paste_with_name('code') do |paste|
+    #     puts paste
+    #   end
+    #
+    def each_paste_with_name(name,&block)
+      pastes_with_name(name).each(&block)
+    end
+
+    #
+    # Iterates over the pastes with the matching _author_, passing each
+    # to the given _block_.
+    #
+    #   results.each_paste_with_name('King Tubby') do |paste|
+    #     puts paste
+    #   end
+    #
+    def each_paste_by_author(author,&block)
+      pastes_by_author(author).each(&block)
+    end
+
+    #
+    # Iterates over the pastes with the matching _date_, passing each
+    # to the given _block_.
+    #
+    #   results.each_paste_on_date(Time.now) do |paste|
+    #     puts paste
+    #   end
+    #
+    def each_paste_on_date(date,&block)
+      pastes_on_date(date).each(&block)
+    end
+
+    #
+    # Iterates over the pastes with the matching _syntax_, passing each
+    # to the given _block_.
+    #
+    #   results.each_paste_with_syntax('Ruby') do |paste|
+    #     puts paste
+    #   end
+    #
+    def each_paste_with_syntax(syntax,&block)
+      pastes_with_syntax(syntax).each(&block)
+    end
+
+    #
+    # Iterates over the pastes containing the specified _text_, passing
+    # each to the given _block_.
+    #
+    #   results.each_paste_with_text('strcpy') do |paste|
+    #     puts paste
+    #   end
+    #
+    #   results.each_paste_with_text(/strcpy\(\w+,\w+\)/) do |paste|
+    #     puts paste
+    #   end
+    #
+    def each_paste_with_text(text,&block)
+      pastes_with_text(text).each(&block)
+    end
+
+    #
+    # Clears the results.
+    #
+    def clear
+      clear_pastes
+      return super
+    end
+
+    protected
+
+    #
+    # Retrieves the Paste from the _metadata_ and caches it.
+    #
+    def cache_paste(metadata)
+      @pastes[metadata.name] ||= metadata.paste
+    end
+
+    #
+    # Clears all cached pastes.
+    #
+    def clear_pastes
+      @pastes.clear
+    end
+
+  end
+end

data/lib/rpaste/rpaste.rb

@@ -0,0 +1,62 @@
+require 'mechanize'
+require 'open-uri'
+
+module RPaste
+  #
+  # Returns the RPaste user-agent
+  #
+  def RPaste.user_agent
+    @user_agent
+  end
+
+  #
+  # Sets the RPaste user-agent to the specified _agent_.
+  #
+  def RPaste.user_agent=(agent)
+    @user_agent = agent
+  end
+
+  #
+  # Opens the _uri_ with the given _opts_. The contents of the _uri_ will
+  # be returned.
+  #
+  #   RPaste.open('http://www.hackety.org/')
+  #   RPaste.open('http://tenderlovemaking.com/',
+  #     :user_agent_alias => 'Linux Mozilla')
+  #   RPaste.open('http://www.wired.com/', :user_agent => 'the future')
+  #
+  def RPaste.open(uri,opts={})
+    headers = {}
+
+    if opts[:user_agent_alias]
+      headers['User-Agent'] = WWW::Mechanize::AGENT_ALIASES[opts[:user_agent_alias]]
+    elsif opts[:user_agent]
+      headers['User-Agent'] = opts[:user_agent]
+    elsif RPaste.user_agent
+      headers['User-Agent'] = RPaste.user_agent
+    end
+
+    return Kernel.open(uri,headers)
+  end
+
+  #
+  # Creates a new Mechanize agent with the given _opts_.
+  #
+  #   RPaste.http_agent
+  #   RPaste.http_agent(:user_agent_alias => 'Linux Mozilla')
+  #   RPaste.http_agent(:user_agent => 'wooden pants')
+  #
+  def RPaste.http_agent(opts={})
+    agent = WWW::Mechanize.new
+
+    if opts[:user_agent_alias]
+      agent.user_agent_alias = opts[:user_agent_alias]
+    elsif opts[:user_agent]
+      agent.user_agent = opts[:user_agent]
+    elsif RPaste.user_agent
+      agent.user_agent = RPaste.user_agent
+    end
+
+    return agent
+  end
+end

data/lib/rpaste/version.rb

@@ -0,0 +1,3 @@
+module RPaste
+  VERSION = '0.0.9'
+end

data/lib/rpaste.rb

@@ -0,0 +1,2 @@
+require 'rpaste/nopaste'
+require 'rpaste/pastebin'

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.4
+specification_version: 1
+name: rpaste
+version: !ruby/object:Gem::Version 
+  version: 0.0.9
+date: 2008-01-09 00:00:00 -08:00
+summary: RPaste provides access to many of the online paste services
+require_paths: 
+- lib
+email: postmodern.mod3@gmail.com
+homepage: "    by Postmodern Modulus III"
+rubyforge_project: rpaste
+description: "== FEATURES/PROBLEMS:  * Supports posting and retrieving from NoPaste. * Supports retrieving from PasteBin. * Provides HTTP access with custom User-Agent strings.  == REQUIREMENTS:  * Hpricot * Mechanize  == INSTALL:"
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Postmodern Modulus III
+files: 
+- History.txt
+- LICENSE.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- lib/rpaste.rb
+- lib/rpaste/version.rb
+- lib/rpaste/rpaste.rb
+- lib/rpaste/metadata.rb
+- lib/rpaste/paste.rb
+- lib/rpaste/result_set.rb
+- lib/rpaste/nopaste/metadata.rb
+- lib/rpaste/nopaste/paste.rb
+- lib/rpaste/nopaste/result_set.rb
+- lib/rpaste/nopaste/recent.rb
+- lib/rpaste/nopaste/nopaste.rb
+- lib/rpaste/nopaste.rb
+- lib/rpaste/pastebin/metadata.rb
+- lib/rpaste/pastebin/paste.rb
+- lib/rpaste/pastebin/result_set.rb
+- lib/rpaste/pastebin/recent.rb
+- lib/rpaste/pastebin/pastebin.rb
+- lib/rpaste/pastebin.rb
+- test/test_rpaste.rb
+test_files: 
+- test/test_rpaste.rb
+rdoc_options: 
+- --main
+- README.txt
+extra_rdoc_files: 
+- History.txt
+- LICENSE.txt
+- Manifest.txt
+- README.txt
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hpricot
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">"
+      - !ruby/object:Gem::Version 
+        version: 0.0.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: mechanize
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">"
+      - !ruby/object:Gem::Version 
+        version: 0.0.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.4.0
+    version: