solaris-patch 1.0.0

data/LICENSE

@@ -0,0 +1,26 @@
+Copyright 2011 Martin Carpenter. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are
+permitted provided that the following conditions are met:
+
+   1. Redistributions of source code must retain the above copyright notice, this list of
+      conditions and the following disclaimer.
+
+   2. Redistributions in binary form must reproduce the above copyright notice, this list
+      of conditions and the following disclaimer in the documentation and/or other materials
+      provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY Martin Carpenter ``AS IS'' AND ANY EXPRESS OR IMPLIED
+WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL Martin Carpenter OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+The views and conclusions contained in the software and documentation are those of the
+authors and should not be interpreted as representing official policies, either expressed
+or implied, of Martin Carpenter.
+

data/README.rdoc

@@ -0,0 +1,71 @@
+
+= solaris-patch
+
+Author:: Martin Carpenter
+Email:: mcarpenter@free.fr
+Copyright:: Copyright (c) Martin Carpenter 2011
+
+== About
+The solaris-patch gem helps with the manipulation of SunOS and Solaris
+patches. 
+
+ * Read (or write!) patchdiag.xref files.
+ * Find latest version of a patch.
+ * Find latest non-superseded version of a patch.
+ * Download patchdiag.xref, patches, readmes from Oracle.
+ * ...
+
+== Examples
+
+=== Download a patch
+
+    require 'solaris/patch'
+    Solaris::Patch.download_patch!('123456-78',
+                                   :to_file => '/tmp/123456-78.zip')
+
+Alternatively:
+
+    patch = Solaris::Patch.new( '123456-78' )
+    patch.download_patch!( :to_dir => '/tmp' )
+
+=== Get the latest version of a patch
+
+    require 'solaris/patch'
+    Solaris::Patchdiag.open( '/tmp/patchdiag.xref' ).latest( '123456-01' )
+    => "123456|12|..."
+
+=== Get the latest non-obsolete version of an possibly obsoleted patch
+
+    require 'solaris/patch'
+    Solaris::Patchdiag.open( '/tmp/patchdiag.xref' ).successor( '123456-01' )
+    => "234567|12|..."
+
+=== Interrogate patchdiag.xref
+
+    require 'solaris/patch'
+
+    # slurp in patchdiag.xref
+    patchdiag = Solaris::Patchdiag.new( '/tmp/patchdiag.xref' )
+
+    # all sparc patches
+    patchdiag.all.select { |p| p.archs.include? 'sparc' }.inspect
+    => [ "123456-78", ... ]
+
+    # latest line added to patchdiag.xref
+    most_recent = patchdiag.all( :sort_by => :date, :order => ascending ).max
+    most_recent
+    => "123456|78|..."
+
+    # most recent patch number
+    most_recent.patch
+    => "123456-78"
+
+    # most recent patch's README if it was recommended
+    most_recent.download_readme! if most_recent.recommended?
+    => "Patch-ID# 123456-78..."
+
+== Known issues
+
+Dates in patchdiag.xref are Mon/dd/yy format. This gem will break in
+2050 since it assumes year 50 and above is in the 20th Century.
+

data/Rakefile

@@ -0,0 +1,27 @@
+require 'rake'
+require 'rake/clean'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+require 'rake/testtask'
+
+desc 'Default task (package)'
+task :default => [:package]
+
+Rake::TestTask.new( 'test' )
+
+SPECFILE = 'solaris-patch.gemspec'
+if File.exist?( SPECFILE )
+  spec = eval( File.read( SPECFILE ) )
+  Rake::GemPackageTask.new( spec ).define
+end
+
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = 'solaris-patch'
+  rdoc.options << '--charset' << 'utf-8'
+  rdoc.options << '--all'
+  rdoc.rdoc_files.include( 'README.rdoc' )
+  rdoc.rdoc_files.include( FileList[ 'lib/**/*' ] )
+  rdoc.rdoc_files.include( FileList[ 'test/**/*' ] )
+end
+

data/lib/solaris/exception.rb

@@ -0,0 +1,31 @@
+
+module Solaris
+
+  class Patch
+
+    # Superclass for all throwable exceptions.
+    class Exception < ::Exception ; end
+
+    # Exception is raised by #find_successor when the patch whose
+    # successor is to be sought or the supposed successor to a patch
+    # does not exist in patchdiag.xref.
+    class NotFound < Exception ; end
+
+    # Exception is raised when the terminal (non-obsolete) succesor
+    # to a patch has been withdrawn (is bad).
+    class BadSuccessor < Exception ; end
+
+    # Raised if the "obsoleted by" value for this patchdiag entry is not
+    # comprehensible.
+    class InvalidSuccessor < Exception ; end
+
+    # Raised if a patchdiag entry appears to have multiple successors.
+    class MultipleSuccessors < Exception ; end
+
+    # Raised if one tries to determine the successor of a non-obsolete patch.
+    class NotObsolete < Exception ; end
+
+  end
+
+end # Solaris
+

data/lib/solaris/foo

@@ -0,0 +1,13 @@
+#!/usr/bin/ruby
+
+require 'pp'
+
+def find(what=:all, opts={})
+  pp what
+  pp opts
+  puts
+end
+
+find
+find(:something, :foo=>:bar)
+find(:foo=>:bar)

data/lib/solaris/patch.rb

@@ -0,0 +1,116 @@
+
+module Solaris
+
+  # Class to represent a patch number.
+  class Patch
+
+    include Comparable
+
+    require 'solaris/util'
+    require 'solaris/exception'
+    require 'solaris/patchdiag'
+    require 'solaris/patchdiag_entry'
+
+    # Hash of URL patterns for downloads of type :patch or :readme.
+    # The string format parameter (%s) is the full patch number.
+    URL = {
+      :patch => 'https://getupdates.oracle.com/all_unsigned/%s.zip',
+      :readme => 'https://getupdates.oracle.com/readme/README.%s'
+    }
+    
+    # The major number of the patch (integer), the part before the dash.
+    attr_accessor :major
+
+    # The minor number of the patch (integer), the part after the dash.
+    # Since this is an integer, values less than 10 will not be left
+    # padded with zero (see Patch::pad_minor). May be nil if not specified
+    # in the constructor.
+    attr_accessor :minor
+
+    # Create a patch. May take zero, one or two parameters.
+    #
+    # In the one parameter form, this is a string of the patch number
+    # eg '123456-78'.  (If you specify integer 123456-78 then the
+    # resulting object will have major number 123378 and no minor
+    # number; this is probably not what you want).
+    #
+    # In the two parameter form, the first parameter is the major
+    # patch number (123456) and the second is the minor number (78).
+    # Although it is possible to provide strings or integers here strings
+    # should be prefered since a leading zero on an integer in Ruby
+    # indicates an octal representation (in the tradition of C). This can
+    # cause problems with a revision number of 09, since this is not a
+    # valid octal representation.
+    #
+    # TLDR: Patch.new('123456-78')
+    def initialize(major=nil, minor=nil)
+      if major
+        patch_no = major.to_s + ( minor ? "-#{minor}" : '' )
+        if patch_no =~ /^(\d+)(-(\d+))?$/
+          @major = $1.to_i
+          @minor = $3.to_i if $3
+        else
+          raise ArgumentError, "Invalid patch number string #{patch_no.inspect}"
+        end
+      end
+    end
+
+    # Download this patch. For the options hash see private method Patch#download!
+    def download_patch!(opts={})
+      download!( :patch, opts )
+    end
+
+    # Download this README. For the options hash see private method Patch#download!
+    def download_readme!(opts={})
+      download!( :readme, opts )
+    end
+
+    # Return a string representation of this patch. If the minor
+    # number has not been set then just return the major number.
+    def to_s
+      minor ? "#{@major}-#{Patch.pad_minor( @minor )}" : "#{@major}"
+    end
+
+    # Compare patch versions. (Performs a string compare on the full patch numbers).
+    def <=>(other)
+      self.to_s <=> other.to_s
+    end
+
+    # Download the given patch (this may be a Patch object or a string
+    # like '123456-78'). For the options hash see Patch#download!.
+    def Patch.download_patch!(patch, opts={})
+      patch_to_dl = Patch.new( patch.to_s )
+      patch_to_dl.download_patch!( opts )
+    end
+
+    # Download the given readme (this may be a Patch object or a string
+    # like '123456-78'). For the options hash see Patch#download!.
+    def Patch.download_readme!(patch, opts={})
+      patch_to_dl = Patch.new( patch.to_s )
+      patch_to_dl.download_readme!( opts )
+    end
+
+    # Left pad a minor version number with zeros as required.
+    def Patch.pad_minor(minor)
+      "#{minor.to_s.rjust( 2, '0' )}"
+    end
+
+    private
+
+    # Download this patch or readme from Oracle.
+    # For the options hash argument see Solaris::Util.download!
+    def download!(type, opts={})
+      raise ArgumentError, "Patch #{self.inspect} requires a major number to download" unless @major
+      raise ArgumentError, "Patch #{self.inspect} requires a minor number to download" unless @minor
+      raise ArgumentError, "Unknown type #{type.inspect}" unless URL[ type ]
+      url = URL[ type ] % self.to_s
+      opts = {
+        :agent => 'Wget/1.10.2', # default user agent, required by Oracle
+      }.merge( opts )
+      Solaris::Util.download!( url, opts )
+    end
+      
+  end # Patch
+
+end # Solaris
+

data/lib/solaris/patchdiag.rb

@@ -0,0 +1,135 @@
+
+module Solaris
+
+  # Class to represent the Oracle patchdiag "database" (file).
+  # See the following Oracle support publication for format:
+  # https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&doctype=REFERENCE&id=1019527.1
+  class Patchdiag
+
+    require 'date'
+
+    require 'solaris/exception'
+    require 'solaris/patchdiag_entry'
+    require 'solaris/util'
+
+    # Default patchdiag.xref file, as for Patch Check Advanced cache
+    DEFAULT_XREF_FILE = '/var/tmp/patchdiag.xref'
+
+    # URL of latest patchdiag.xref from Oracle.
+    DEFAULT_XREF_URL = 'https://getupdates.oracle.com/reports/patchdiag.xref'
+
+    # An array containing all entries (of class PatchdiagEntry) read
+    # from the patchdiag.xref file.
+    attr_accessor :entries
+
+    # Create a new patchdiag database object by reading the given
+    # xref file (this may be a filename (string) or a fileish object
+    # (File, StringIO)). If no xref file is given then the default
+    # is read (/var/tmp/patchdiag.xref); this is the cache file used
+    # by Patch Check Advanced (pca).
+    def initialize(xref_file=DEFAULT_XREF_FILE)
+      xref_file = File.new( xref_file ) if xref_file.is_a?(String)
+      @entries = xref_file.
+        readlines.
+        reject { |line| line =~ /^#|^\s*$/ }. # discard comments, blanks
+        map { |line| PatchdiagEntry.new( line ) }
+    end
+
+    # Download the patchdiag database and return it as a string.
+    # Note the contents will be returned as a string but not saved
+    # to disk unless :to_file or :to_dir are given.
+    # For the options hash argument see Solaris::Util.download!
+    def Patchdiag.download!(opts={})
+      url = opts.delete( :url ) || DEFAULT_XREF_URL
+      Util.download!( url, opts )
+    end
+
+    # Open the given optional patchdiag xref file and yield to the optional
+    # block.
+    def Patchdiag.open(xref_file=DEFAULT_XREF_FILE, &blk)
+      patchdiag = Patchdiag.new( xref_file )
+      if block_given?
+        yield patchdiag
+      else
+        patchdiag
+      end
+    end
+
+    # Returns an array of Solaris::PatchdiagEntry from the patchdiag with the given
+    # patch number (a String like xxxxxx-yy or xxxxxx or a Solaris::Patch). Returns an
+    # empty array if no such patches can be found.
+    def find(patch)
+      patch = Patch.new( patch.to_s )
+      property = patch.minor ? :to_s : :major
+      comparator = patch.send( property )
+      all.select { |pde| pde.patch.send( property ) == comparator }
+    end
+
+    # Return the Solaris::PatchdiagEntry of the latest version of the given patch
+    # (a String like xxxxxx-yy or xxxxxx or a Solaris::Patch).
+    # Throws Solaris::Patch::NotFound if the patch cannot be found in patchdiag.xref.
+    def latest(patch)
+      major = Patch.new( patch.to_s ).major
+      find( major ).max ||
+        raise( Solaris::Patch::NotFound, "Cannot find patch #{patch} in patchdiag.xref" )
+    end
+
+    # Return the Solaris::PatchdiagEntry of the latest non-obsolete successor
+    # of this patch. Throws Solaris::Patch::NotFound if the patch or any of its
+    # named successors cannot be found in patchdiag.xref.
+    def successor(patch)
+      patch = Patch.new( patch.to_s )
+      if ! patch.minor || ! entry = find( patch ).first
+        entry = latest( patch )
+      end
+      raise Solaris::Patch::NotFound,
+        "Cannot find patch #{patch} in patchdiag.xref" unless entry
+      if entry.obsolete?
+        succ = entry.successor # may raise
+        successor( succ )
+      elsif entry.bad?
+        raise BadSuccessor, "Terminal successor #{patch} is bad/withdrawn"
+      else
+        entry
+      end
+    end
+
+    # Return all patchdiag entries (PatchdiagEntry) defined in the patchdiag.xref.
+    # This method scans the entire patchdiag database so may be a little slow:
+    # callers are encouraged to cache or memoize their results.
+    def all(opts={})
+
+      # Defaults
+      order = :ascending
+      sort_by = :patch
+
+      # Parse options
+      opts.each do |key, value|
+        case key
+        when :sort_by
+          raise ArgumentError, "Invalid sort_by #{value.inspect}" unless [ :patch, :date ].include?( value )
+          sort_by = value
+        when :order
+          raise ArgumentError, "Invalid order #{value.inspect}" unless [ :ascending, :descending ].include?( value )
+          order = value
+        else
+          raise ArgumentError, "Unknown option key #{key.inspect}"
+        end
+      end
+
+      # Compute the lambda for sorting.
+      if order == :ascending
+        boat_op = lambda { |x,y| x.send( sort_by ) <=> y.send( sort_by ) }
+      else
+        boat_op = lambda { |x,y| y.send( sort_by ) <=> x.send( sort_by ) }
+      end
+
+      # Sort and return.
+      @entries.sort { |x,y| boat_op.call( x, y ) }
+
+    end
+
+  end # Patchdiag
+
+end # Solaris
+

data/lib/solaris/patchdiag_entry.rb

@@ -0,0 +1,182 @@
+
+module Solaris
+
+  # Class to represent a line from Sun's patchdiag.xref patch "database".
+  # See the following Oracle support publication for format:
+  # https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&doctype=REFERENCE&id=1019527.1
+  class PatchdiagEntry
+
+    include Comparable
+
+    require 'date'
+
+    require 'solaris/exception'
+    require 'solaris/patch'
+
+    # An array of architectures for this patch. Values are strings like
+    # "sparc", "i386".
+    attr_accessor :archs
+
+    # The bad field from the patchdiag xref database. Should be either 'B'
+    # or the empty string. See also PatchdiagEntry#bad?
+    attr_accessor :bad
+
+    # The date of this patch (a Date object).
+    attr_accessor :date
+
+    # The operating system for this patch, a string like "2.4, "10",
+    # "10_x86" or "Unbundled".
+    attr_accessor :os
+
+    # The patch object (class Patch) that this entry represents. See
+    # also convenience methods PatchdiagEntry#major and PatchdiagEntry#minor.
+    attr_accessor :patch
+
+    # An array of packages that pertain to this patch. Values are strings
+    # like "SUNWcsr".
+    attr_accessor :pkgs
+
+    # The recommended field from the patchdiag xref database. Should be either 'R'
+    # or the empty string. See also PatchdiagEntry#recommended?
+    attr_accessor :recommended
+
+    # The security field from the patchdiag xref database. Should be either 'S'
+    # or the empty string. See also PatchdiagEntry#security?
+    attr_accessor :security
+
+    # This synopsis of this patch from the patchdiag xref database. This is a free
+    # text field (string).
+    attr_accessor :synopsis
+
+    def initialize(patchdiag_line)
+      fields = patchdiag_line.split('|')[0..10]
+      major, minor, date, @recommended, @security, @obsolete, @bad, @os, archs, pkgs, @synopsis = *fields
+      @archs = archs.split( ';' )
+      if date == ''
+        year, month, day = 1970, 1, 1
+      else
+        month_s, day_s, year_s = *date.split( '/' )
+        year = ( year_s.to_i > 50 ? "19#{year_s}" : "20#{year_s}" ).to_i
+        month = Date::ABBR_MONTHNAMES.index( month_s )
+        day = day_s.to_i
+      end
+      @date = Date.new( year, month, day )
+      @patch = Patch.new( major, minor )
+      @pkgs = pkgs.split( ';' )
+    end
+
+    # Boolean, returns true if this patch is marked as "bad" in the patchdiag
+    # xref database.
+    def bad? ; @bad == 'B' end
+
+    # Download this patch. For options hash see Patch#download!.
+    def download_patch!(opts={}) ;
+      @patch.download_patch!( opts )
+    end
+
+    # Download the README for this patch. For options hash see Patch#download!.
+    def download_readme!(opts={})
+      @patch.download_readme!( opts )
+    end
+
+    # Returns this entries major patch number as an integer.
+    def major ; @patch.major end
+
+    # Returns this entries minor patch number as an integer.
+    def minor ; @patch.minor end
+
+    # Boolean, returns true if this patch is marked as "obsolete" in the patchdiag
+    # xref database.
+    def obsolete? ; @obsolete == 'O' end
+
+    # Boolean, returns true if this patch is marked as "recommended" in the patchdiag
+    # xref database.
+    def recommended? ; @recommended == 'R' end
+
+    # Boolean, returns true if this patch is marked as "security" in the patchdiag
+    # xref database.
+    def security? ; @security == 'S' end
+
+    # Return the Solaris::Patch by which this entry is obsoleted.
+    # Throws Solaris::Patch::NotObsolete if this entry is not obsolete.
+    # Throws Solaris::Patch::MultipleSuccessors if this entry has more than
+    # one successor.
+    # Throws Solaris::Patch::InvalidSuccessor if the "obsoleted by" entry cannot
+    # be understood.
+    def successor
+      # I <3 consistency:
+      # Obsoleted by : XXXXXX-XX
+      # Obsoleted by: XXXXXX-XX
+      # OBSOLETED by: XXXXXX
+      # Obsoleted by: XXXXXX-XX OBSOLETED by WITHDRAWN
+      # OBSOLETED by WITHDRAWN
+      # OBSOLETED by XXXXXX
+      # OBSOLETED by XXXXXX and XXXXXX # we ignore this pattern, see below
+      # Obsoleted by XXXXXX-XX:
+      # OBSOLETED by XXXXXX-XX:
+      # WITHDRAWN Obsoleted by: XXXXXX-XX
+      # WITHDRAWN PATCH Obsolete by:
+      # WITHDRAWN PATCH Obsoleted by:
+      # WITHDRAWN PATCH Obsoleted by XXXXXX-XX:
+
+      # Fail if this entry is not actually obsolete
+      raise Solaris::Patch::NotObsolete,
+        "Entry #{patch.inspect} not obsolete" unless obsolete?
+
+      # Fail on these two entries from 1999 since they are the only ones ever
+      # that are succeeded by two patches each
+      raise Solaris::Patch::MultipleSuccessors,
+        "More than one successor for entry #{patch.inspect}" if [ 105716, 105717 ].include?( self.major )
+
+      # See if we can find a successor
+      if synopsis =~ /obsolete(d?) by\s*(:?)\s*(\d+(-\d+)?)/i
+        Patch.new( $3 )
+      else
+        raise Solaris::Patch::InvalidSuccessor,
+          "Failed to parse successor to obsolete patchdiag entry for patch #{patch.inspect}"
+      end
+    end
+
+    # Output this patchdiag xref entry as a string, in format of Oracle's
+    # database.
+    def to_s
+      [ patch.major,
+        Patch.pad_minor( patch.minor ),
+        date_s,
+        @recommended,
+        @security,
+        @obsolete,
+        @bad,
+        @os,
+        join_semis( @archs ),
+        join_semis( @pkgs ),
+        @synopsis
+      ].join('|')
+    end
+
+    # Compare (by delegated comparison of patch versions, see Solaris::Patch#<=>).
+    def <=>(other)
+      self.patch <=> other.patch
+    end
+
+    private
+
+    # Convert the Date object to a date string as found in patchdiag.xref.
+    def date_s
+      [ Date::ABBR_MONTHNAMES[ @date.mon ], # month eg Jan
+        @date.mday.to_s.rjust(2, '0'), # day of month
+        @date.year % 100 # 2 digit year
+      ].join('/')
+    end
+
+    # Join an array of items with semicolons and append a trailing
+    # semicolon if the array is non-empty, otherwise return the 
+    # empty string. Used to format @archs and @pkgs for #to_s.
+    def join_semis(a)
+      a.empty? ? '' : a.join(';') + ';'
+    end
+
+  end # PatchdiagEntry
+
+end # Solaris
+

data/lib/solaris/util.rb

@@ -0,0 +1,68 @@
+
+module Solaris
+
+  # Utility module.
+  module Util
+
+    require 'rubygems'
+    gem 'mechanize', '>= 1.0.0'
+    require 'mechanize'
+
+    # Download the given URL, return the document body. Options:
+    #   :agent -- set HTTP user agent
+    #   :password -- Oracle support password
+    #   :to_file -- a file path to which the patch/readme should be saved
+    #   :to_dir -- a directory path to which the patch/readme should be saved
+    #   :user -- Oracle support username
+    # (:to_dir and :to_file are mutually exclusive)
+    def Util.download!(url, opts={})
+      agent = Mechanize.new
+      dirname, filename = nil, nil
+      opts.each do |key, value|
+        case key
+        when :agent
+          agent.user_agent = value
+        when :to_dir
+          dirname = value
+        when :to_file
+          filename = value
+        when :password, :user
+          # noop
+        else
+          raise ArgumentError, "Unknown option key #{key.inspect}"
+        end
+      end
+      # If we got a filename then open now before attempting download
+      raise ArgumentError, 'Cannot specify both :to_dir and :to_file' if filename && dirname
+      filename = File.join( dirname, File.basename( url ) ) if dirname
+      begin
+        file = File.open( filename, 'w' ) if filename
+        # Set agent authentication parameters
+        if opts[:user] && opts[:password]
+          agent.basic_auth( opts[:user], opts[:password] )
+        elsif opts[:user]
+          raise ArgumentError, 'Cannot authenticate without a password'
+        elsif opts[:password]
+          raise ArgumentError, 'Cannot authenticate without a username'
+        end
+        # Download file and save as required
+        page = agent.get( url )
+        if file
+          file.write( page.body )
+          file.close
+        end
+      rescue => exception
+        # Try to remove incomplete file on error
+        if file
+          begin file.close ; rescue ; end
+          begin File.unlink( file ) ; rescue ; end
+        end
+        raise exception # rethrow original exception
+      end
+      page.body # return file as string (even if written)
+    end
+
+  end # Util
+
+end # Solaris
+

data/lib/solaris.rb

@@ -0,0 +1,10 @@
+
+# Namespace for child classes.
+module Solaris
+
+  require 'solaris/patch'
+  require 'solaris/patchdiag'
+  require 'solaris/patchdiag_entry'
+
+end # Solaris
+

data/test/test_patch.rb

@@ -0,0 +1,100 @@
+
+require 'test/unit'
+require 'solaris/patch'
+
+# Unit tests for class Patch.
+class TestPatch < Test::Unit::TestCase #:nodoc:
+
+  def test_new_string_major_only
+    patch = Solaris::Patch.new( '123456' )
+    assert_equal( 123456, patch.major )
+    assert_nil( patch.minor )
+  end
+
+  def test_new_int_major_only
+    patch = Solaris::Patch.new( 123456 )
+    assert_equal( 123456, patch.major )
+    assert_nil( patch.minor )
+  end
+
+  def test_new_string_minor_only
+    assert_raise( ArgumentError ) do
+      Solaris::Patch.new( '-78' )
+    end
+  end
+
+  def test_new_string_major_and_minor
+    patch = Solaris::Patch.new( '123456-78' )
+    assert_equal( 123456, patch.major )
+    assert_equal( 78, patch.minor )
+  end
+
+  def test_new_int_major_and_minor
+    patch = Solaris::Patch.new( 123456, 78 )
+    assert_equal( 123456, patch.major )
+    assert_equal( 78, patch.minor )
+  end
+
+  def test_new_no_args
+    patch = Solaris::Patch.new()
+    assert_nil( patch.major )
+    assert_nil( patch.minor )
+  end
+
+  def test_new_valid_opts
+    patch = Solaris::Patch.new( '123456-78' )
+    assert_equal( 123456, patch.major )
+    assert_equal( 78, patch.minor )
+  end
+
+  def test_to_s
+    patch = Solaris::Patch.new( '123456-78' )
+    assert_equal( '123456-78', patch.to_s )
+  end
+
+  def test_to_s_padding
+    patch = Solaris::Patch.new( '123456-7' )
+    assert_equal( '123456-07', patch.to_s )
+  end
+
+  def test_to_s_major_only
+    patch = Solaris::Patch.new( 123456 )
+    assert_equal( '123456', patch.to_s )
+  end
+
+  def test_comparison
+    assert( Solaris::Patch.new( '123456-78' ) == Solaris::Patch.new( '123456-78' ) )
+    assert( Solaris::Patch.new( '123456-1' ) == Solaris::Patch.new( '123456-01' ) )
+    assert( Solaris::Patch.new( '123456' ) == Solaris::Patch.new( '123456' ) )
+    assert( Solaris::Patch.new( '123456-78' ) < Solaris::Patch.new( '123456-79' ) )
+    assert( Solaris::Patch.new( '123456-78' ) < Solaris::Patch.new( '123457-78' ) )
+    assert( Solaris::Patch.new( '123456-1' ) < Solaris::Patch.new( '123456-10' ) )
+  end
+
+  def test_download_requires_major
+    patch = Solaris::Patch.new
+    patch.minor = 1
+    assert_raise( ArgumentError ) { patch.download_patch! }
+    assert_raise( ArgumentError ) { patch.download_readme! }
+  end
+
+  def test_download_requires_minor
+    patch = Solaris::Patch.new
+    patch.major = 123456
+    assert_raise( ArgumentError ) { patch.download_patch! }
+    assert_raise( ArgumentError ) { patch.download_readme! }
+  end
+
+  def test_download!
+    skip 'Mock required'
+  end
+
+  def test_pad_minor
+    assert_equal( '00', Solaris::Patch.pad_minor( 0 ) )
+    assert_equal( '01', Solaris::Patch.pad_minor( 1 ) )
+    assert_equal( '12', Solaris::Patch.pad_minor( 12 ) )
+    assert_equal( '123', Solaris::Patch.pad_minor( 123 ) )
+  end
+
+end
+

data/test/test_patchdiag.rb

@@ -0,0 +1,198 @@
+
+require 'test/unit'
+require 'stringio'
+require 'solaris/patchdiag'
+
+# Unit tests for class Patchdiag.
+class TestPatchdiag < Test::Unit::TestCase #:nodoc:
+
+  def setup
+    @empty_file = '/dev/null'
+    @patchdiag_fileish = StringIO.new(<<-EOF
+## PATCHDIAG TOOL CROSS-REFERENCE FILE AS OF Feb/10/11 ##
+##
+## The content of this file has changed as of Jun/04/10. Due to the merging of
+## the Sun Alert and Recommended patch clusters, some patches tagged with the
+## "R" flag may now be obsoleted patches (and as a result additionally have the
+## "O" flag set).
+## Details of this change are explained in the following blog posting:
+## http://blogs.sun.com/patch/entry/merging_the_solaris_recommended_and
+## The following Technical Info Document explains the various fields in the
+## patchdiag.xref file:
+## https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&doctype=REFERENCE&id=1019527.1
+100287|05|Oct/31/91| | | |  |Unbundled|||PC-NFS 3.5c: Jumbo patch (updated PRT.COM to v3.5c)
+100323|05|Feb/11/92| | | |  |Unbundled|||PC-NFS Advanced Telnet: bug fixes, National Character Set support
+100386|01|Sep/20/91| | | |  |Unbundled|||PC-NFS Programmer's Toolkit/2.0: Runtime modules
+100393|01|Sep/02/94| | |O|  |Unbundled|||OBSOLETED by 100394
+100438|01|Dec/02/91| | | |  |Unbundled|||PCNFS/v3.5c: PC-NFS loses mounted printer names when PCNFSLPD load
+100455|01|Dec/17/91| | | |  |Unbundled|||LifeLine/2.0: Does not parse the FROM: and/or Reply-TO: fields cor
+100648|01|Jun/11/92| | | |  |Unbundled|||PC-NFS/4.0a: Jumbo Patch
+100701|03|Feb/17/93| | | |  |Unbundled|sparc;|SUNWowbcp:1.8.1;SUNWowbcp:2.10;|OpenWindows 3.0.1;3.1: programs compiled under Solaris 1.x /usr/5b
+100791|04|Apr/12/93| | |O|  |Unbundled||SPROsw:2.1.0.1;|OBSOLETED by 100974
+100791|05|Apr/12/93| | |O|  |Unbundled||SPROsw:2.1.0.1;|OBSOLETED by 100974
+100807|03|May/02/94| | |O| B|Unbundled|||OBSOLETED by WITHDRAWN
+100807|04|Jul/07/94| | | |  |Unbundled|sparc;|SPROswmgr:2.1.2.1;|Sparcworks 2.0.1: statically linking X11 library doesn't run on As
+100811|01|Mar/17/93| | |O|  |Unbundled||SPROcpl:2.1.0.3;SPROlang:2.1.0.3;|OBSOLETED by 100967
+100812|02|Jan/27/93| | | |  |Unbundled|sparc;|SUNWowrqd:1.16.2;|OpenWindows 3.0.1: Binder as root with "-system" or "-network" doe
+100824|03|Jun/29/93| | | |  |Unbundled|sparc;|SUNWowrqd:2.10;|OpenWindows 3.1: fixes various bugs in xnews server
+100830|01|Mar/12/93| | |O|  |Unbundled||SPROlang:2.1.0.1;|OBSOLETED by 100861
+100837|01|Jan/20/93| | | |  |Unbundled|sparc;|SUNWowrqd:2.10.0.1;|OpenWindows 3.1: core dump in ras3,ras4,ras5 and install_check on
+100843|01|Feb/05/93| | | |  |Unbundled|||PC-NFS/4.0a: various, system or print server hangs under heavy loa
+100849|01|Jan/20/93| | |O|  |Unbundled||SPROpas:2.1.0.1;|OBSOLETED by 100964
+100852|02|Jul/01/93| | |O|  |2.1||SUNWcsu:11.4.2,PATCH=28;|OBSOLETED by WITHDRAWN
+146124|01|Dec/08/10| | | |  |10|sparc;|SUNWthunderbirdl10n-de-DE:3.0.3,REV=101.0.3;SUNWthunderbirdl10n-es-ES:3.0.3,REV=101.0.3;SUNWthunderbirdl10n-extra:3.0.3,REV=101.0.3;SUNWthunderbirdl10n-fr-FR:3.0.3,REV=101.0.3;SUNWthunderbirdl10n-it-IT:3.0.3,REV=101.0.3;SUNWthunderbirdl10n-ja-JP:3.0.3,REV=101.0.3;SUNWthunderbirdl10n-ko-KR:3.0.3,REV=101.0.3;SUNWthunderbirdl10n-pl-PL:3.0.3,REV=101.0.3;SUNWthunderbirdl10n-pt-BR:3.0.3,REV=101.0.3;SUNWthunderbirdl10n-ru-RU:3.0.3,REV=101.0.3;SUNWthunderbirdl10n-sv-SE:3.0.3,REV=101.0.3;SUNWthunderbirdl10n-zh-CN:3.0.3,REV=101.0.3;SUNWthunderbirdl10n-zh-TW:3.0.3,REV=101.0.3;|SunOS 5.10: Thunderbird l10n packages update Patch
+146132|01|Jan/05/11| | | |  |10|sparc;137137-09;141444-09;|SUNWcsu:11.10.0,REV=2005.01.21.15.53;|SunOS 5.10: newfs fails on newly-formatted floppy disk
+146133|01|Jan/05/11| | | |  |10_x86|i386;137138-09;141445-09;|SUNWcsu:11.10.0,REV=2005.01.21.16.34;|SunOS 5.10_x86: newfs fails on newly-formatted floppy disk
+146236|01|Dec/10/10| | | |  |10|sparc;137137-09;|SUNWckr:11.10.0,REV=2005.01.21.15.53;|SunOS 5.10: dcfs patch
+146237|01|Dec/10/10| | | |  |10_x86|i386;141445-09;|SUNWckr:11.10.0,REV=2005.01.21.16.34;|SunOS 5.10_x86: dcfs patch
+146241|02|Dec/16/10| | | |  |Unbundled|sparc;|SUNWscsaa:3.3.0,REV=2010.07.26.12.56;|Oracle Solaris Cluster 3.3: SWIFTAllianceAccess patch
+146277|01|Dec/10/10| | | |  |10|sparc;118833-36;120011-14;127127-11;139555-08;142909-17;|SUNWcslr:11.10.0,REV=2005.01.21.15.53;|SunOS 5.10: libnsl patch
+146278|01|Dec/10/10| | | |  |10_x86|i386;118855-36;120012-14;127128-11;139556-08;142910-17;|SUNWcslr:11.10.0,REV=2005.01.21.16.34;|SunOS 5.10_x86: libnsl patch
+146279|01|Dec/22/10|R|S| |  |10|sparc;|SUNWbnuu:11.10.0,REV=2005.01.21.15.53;|SunOS 5.10: uucp patch
+146280|01|Dec/22/10|R|S| |  |10_x86|i386;|SUNWbnuu:11.10.0,REV=2005.01.21.16.34;|SunOS 5.10_x86: uucp patch
+146281|01|Dec/15/10| | | |  |10|sparc;|SUNWckr:11.10.0,REV=2005.01.21.15.53;SUNWhea:11.10.0,REV=2005.01.21.15.53;|SunOS 5.10: ldterm patch
+146282|01|Dec/15/10| | | |  |10_x86|i386;|SUNWckr:11.10.0,REV=2005.01.21.16.34;SUNWhea:11.10.0,REV=2005.01.21.16.34;|SunOS 5.10_x86: ldterm patch
+146283|01|Dec/10/10| | | |  |10|sparc;118833-36;137137-09;142909-17;|SUNWckr:11.10.0,REV=2005.01.21.15.53;|SunOS 5.10: lofi patch
+146284|01|Dec/10/10| | | |  |10_x86|i386;118855-36;137138-09;142910-17;|SUNWckr:11.10.0,REV=2005.01.21.16.34;|SunOS 5.10_x86: lofi patch
+146287|01|Jan/24/11| | | |  |10|sparc.sun4u;sparc.sun4us;sparc.sun4v;118833-36;120011-14;|SUNWkvm:11.10.0,REV=2005.01.20.17.25;SUNWkvm:11.10.0,REV=2005.01.21.15.53;SUNWkvm:11.10.0,REV=2005.08.04.12.25;|SunOS 5.10: trapstat Patch
+146332|02|Feb/03/11| | | |  |10|sparc;142909-17;|SUNWaccu:11.10.0,REV=2005.01.21.15.53;|SunOS 5.10: sadc patch
+146333|02|Feb/03/11| | | |  |10_x86|i386;142910-17;|SUNWaccu:11.10.0,REV=2005.01.21.16.34;|SunOS 5.10_x86: sadc patch
+146334|01|Jan/19/11| | | |  |10|sparc;120011-14;121133-02;127127-11;139555-08;142909-17;|SUNWzoneu:11.10.0,REV=2005.01.21.15.53;|SunOS 5.10: zlogin patch
+146335|01|Jan/19/11| | | |  |10_x86|i386;120012-14;121334-04;127128-11;139556-08;142910-17;|SUNWzoneu:11.10.0,REV=2005.01.21.16.34;|SunOS 5.10_x86: zlogin patch
+146336|01|Jan/13/11| | | |  |10|sparc;118833-36;120011-14;127127-11;137137-09;142909-17;|SUNWarc:11.10.0,REV=2005.01.21.15.53;SUNWcsl:11.10.0,REV=2005.01.21.15.53;|SunOS 5.10: libsldap.so.1 patch
+146337|01|Jan/13/11| | | |  |10_x86|i386;120012-14;127128-11;137138-09;142910-17;|SUNWarc:11.10.0,REV=2005.01.21.16.34;SUNWcsl:11.10.0,REV=2005.01.21.16.34;|SunOS 5.10_x86: libsldap.so.1 patch
+146363|01|Jan/04/11|R|S| |  |10|sparc;119757-19;|SUNWsfman:11.10.0,REV=2005.01.08.05.16;SUNWsmbaS:11.10.0,REV=2005.01.08.05.16;SUNWsmbar:11.10.0,REV=2005.01.08.05.16;SUNWsmbau:11.10.0,REV=2005.01.08.05.16;|SunOS 5.10: Samba patch
+146364|01|Jan/04/11|R|S| |  |10_x86|i386;119758-19;|SUNWsfman:11.10.0,REV=2005.01.08.01.09;SUNWsmbaS:11.10.0,REV=2005.01.08.01.09;SUNWsmbar:11.10.0,REV=2005.01.08.01.09;SUNWsmbau:11.10.0,REV=2005.01.08.01.09;|SunOS 5.10_x86: Samba patch
+146435|01|Feb/01/11| | | |  |Unbundled|||Hardware FC  Disk Drive Patch : Download program and FC Disk Drive
+146440|01|Jan/13/11| | | |  |10|sparc;118833-36;120011-14;137137-09;139555-08;141444-09;142909-17;|SUNWckr:11.10.0,REV=2005.01.21.15.53;|SunOS 5.10: dld patch
+146441|01|Jan/13/11| | | |  |10_x86|i386;118855-36;120012-14;139556-08;141445-09;142910-17;|SUNWckr:11.10.0,REV=2005.01.21.16.34;|SunOS 5.10_x86: dld patch
+146442|01|Jan/24/11| | | |  |10|sparc;126897-02;127127-11;127755-01;137137-09;139555-08;141444-09;142909-17;|SUNWfmd:11.10.0,REV=2005.01.21.15.53;|SunOS 5.10: libldom.so.1 patch
+146443|01|Feb/09/11| | | |  |10|sparc;142909-17;|SUNWfmd:11.10.0,REV=2005.01.21.15.53;|SunOS 5.10: gmem.eft and generic-mem.so patch
+146444|01|Jan/27/11| | | |  |10_x86|i386;120012-14;142910-17;|SUNWnge:11.10.0,REV=2005.06.22.03.40;|SunOS 5.10_x86: nge patch
+800054|01|Mar/16/01| | |O|  |Unbundled|||Obsoleted by: 111346-01 Hardware/PROM: Sun Fire 3800/4800/4810/680
+100974|02|Mar/14/95| | | |  |Unbundled|sparc;|SPROsw:2.1.0;|SparcWorks 2.0.1: dbx jumbo patch
+EOF
+                           )
+    @patchdiag = Solaris::Patchdiag.open( @patchdiag_fileish )
+  end
+
+  def teardown
+    @empty_file = nil
+    @patchdiag = nil
+    @patchdiag_fileish = nil
+  end
+
+  def test_new_by_fileish
+    assert_equal( 51, @patchdiag.entries.size )
+  end
+
+  def test_new_by_filename
+    temp = Tempfile.new( 'test_patchdiag' )
+    path = temp.path
+    temp.write( @patchdiag_fileish )
+    temp.close
+    patchdiag = Solaris::Patchdiag.new( path )
+    File.unlink( path )
+    assert_equal( 51, @patchdiag.entries.size )
+  end
+
+  def test_new_empty_file
+    if File.exists?( @empty_file )
+      patchdiag = Solaris::Patchdiag.new( @empty_file )   
+      assert_equal( 0, patchdiag.entries.size )
+    end
+  end
+
+  def test_all
+    assert_equal( 51, @patchdiag.all.size )
+  end
+
+  def test_all_sort_by_date_order_ascending
+    all = @patchdiag.all( :sort_by => :date, :order => :ascending )
+    first = all.first.patch # oldest
+    last = all.last.patch # newest
+    assert_equal( Solaris::Patch.new( '100386-01' ), first )
+    assert_equal( Solaris::Patch.new( '146443-01' ), last )
+  end
+
+  def test_all_sort_by_patch_order_descending
+    all = @patchdiag.all( :sort_by => :patch, :order => :descending )
+    first = all.first.patch # largest
+    last = all.last.patch # smallest
+    assert_equal( Solaris::Patch.new( '800054-01' ), first )
+    assert_equal( Solaris::Patch.new( '100287-05' ), last )
+  end
+
+  def test_open_block
+    ret = Solaris::Patchdiag.open( @patchdiag_fileish ) do |patchdiag|
+      assert_equal( Solaris::Patchdiag, patchdiag.class )
+      :return_code
+    end
+    assert_equal( :return_code, ret )
+  end
+
+  def test_open_return
+    assert_equal( Solaris::Patchdiag, @patchdiag.class )
+  end
+
+  def test_find
+    assert_equal( [], @patchdiag.find( 123456 ) )
+    assert_equal( [], @patchdiag.find( '123456' ) )
+    assert_equal( [], @patchdiag.find( '123456-78' ) )
+    assert_equal( [], @patchdiag.find( Solaris::Patch.new( 123456 ) ) )
+    assert_equal( [], @patchdiag.find( Solaris::Patch.new( '123456' ) ) )
+    assert_equal( [], @patchdiag.find( Solaris::Patch.new( '123456-78' ) ) )
+    assert_equal( [], @patchdiag.find( '100791-01' ) )
+    assert_equal( [], @patchdiag.find( Solaris::Patch.new( '100791-01' ) ) )
+    assert_equal( '100791-04', @patchdiag.find( 100791 ).first.patch.to_s )
+    assert_equal( '100791-04', @patchdiag.find( '100791' ).first.patch.to_s )
+    assert_equal( '100791-04', @patchdiag.find( '100791-04' ).first.patch.to_s )
+    assert_equal( '100791-04', @patchdiag.find( Solaris::Patch.new( 100791) ).first.patch.to_s )
+    assert_equal( '100791-04', @patchdiag.find( Solaris::Patch.new( '100791') ).first.patch.to_s )
+    assert_equal( '100791-04', @patchdiag.find( Solaris::Patch.new( '100791-04') ).first.patch.to_s )
+  end
+
+  def test_latest
+    assert_raise( Solaris::Patch::NotFound ) do
+      @patchdiag.latest( 123456 )
+    end
+    assert_equal( '100791-05', @patchdiag.latest( 100791 ).patch.to_s )
+    assert_equal( '100791-05', @patchdiag.latest( '100791' ).patch.to_s )
+    assert_equal( '100791-05', @patchdiag.latest( '100791-01' ).patch.to_s )
+    assert_equal( '100791-05', @patchdiag.latest( '100791-05' ).patch.to_s )
+    assert_equal( '100791-05', @patchdiag.latest( Solaris::Patch.new( 100791 ) ).patch.to_s )
+    assert_equal( '100791-05', @patchdiag.latest( Solaris::Patch.new( '100791' ) ).patch.to_s )
+    assert_equal( '100791-05', @patchdiag.latest( Solaris::Patch.new( '100791-01' ) ).patch.to_s )
+    assert_equal( '100791-05', @patchdiag.latest( Solaris::Patch.new( '100791-05' ) ).patch.to_s )
+  end
+
+  def test_successor
+    assert_raise( Solaris::Patch::NotFound ) do
+      @patchdiag.latest( 123456 )
+    end
+    assert_equal( '100287-05', @patchdiag.successor( 100287 ).patch.to_s )
+    assert_equal( '100287-05', @patchdiag.successor( '100287' ).patch.to_s )
+    assert_equal( '100287-05', @patchdiag.successor( '100287-05' ).patch.to_s )
+    assert_equal( '100287-05', @patchdiag.successor( Solaris::Patch.new( '100287-05' ) ).patch.to_s )
+    assert_equal( '100974-02', @patchdiag.successor( 100791 ).patch.to_s )
+    assert_raise( Solaris::Patch::NotFound ) do
+      @patchdiag.successor( 100393 ) # successor 100394 not in patchdiag.xref
+    end
+    assert_equal( '100807-04', @patchdiag.successor( '100807-01' ).patch.to_s )
+    assert_raise( Solaris::Patch::InvalidSuccessor ) do
+      @patchdiag.successor( '100807-03' ) # successor 100807-03 WITHDRAWN
+    end
+  end
+
+  def test_download!
+    skip 'Mock required'
+  end
+
+  private
+
+  def successor(patch)
+    @patchdiag.successor( patch ).patch.to_s
+  end
+
+end
+

data/test/test_patchdiag_entry.rb

@@ -0,0 +1,115 @@
+
+require 'test/unit'
+require 'solaris/patchdiag_entry'
+
+# Unit tests for class PatchdiagEntry.
+class TestPatchdiagEntry < Test::Unit::TestCase #:nodoc:
+
+  def test_146636_01
+    line = '146336|01|Jan/13/11| | | |  |10|sparc;118833-36;120011-14;127127-11;137137-09;142909-17;|SUNWarc:11.10.0,REV=2005.01.21.15.53;SUNWcsl:11.10.0,REV=2005.01.21.15.53;|SunOS 5.10: libsldap.so.1 patch'
+    pde = Solaris::PatchdiagEntry.new( line )
+    assert_equal( 146336, pde.major )
+    assert_equal( 1, pde.minor )
+    assert_equal( false, pde.recommended? )
+    assert_equal( false, pde.obsolete? )
+    assert_equal( false, pde.security? )
+    assert_equal( Date.new(2011, 1, 13), pde.date )
+    assert_equal( '10', pde.os )
+    assert_equal( '146336-01', pde.patch.to_s )
+    assert_equal( ['SUNWarc:11.10.0,REV=2005.01.21.15.53',
+                  'SUNWcsl:11.10.0,REV=2005.01.21.15.53'], pde.pkgs )
+    assert_equal( [ 'sparc', '118833-36', '120011-14', '127127-11', '137137-09', '142909-17' ], pde.archs )
+    assert_equal( 'SunOS 5.10: libsldap.so.1 patch', pde.synopsis )
+    assert_equal( line, pde.to_s )
+  end
+
+  def test_100393_01
+    line = '100393|01|Sep/02/94| | |O|  |Unbundled|||OBSOLETED by 100394'
+    pde = Solaris::PatchdiagEntry.new( line )
+    assert_equal( 100393, pde.major )
+    assert_equal( 1, pde.minor )
+    assert_equal( false, pde.recommended? )
+    assert_equal( true, pde.obsolete? )
+    assert_equal( false, pde.security? )
+    assert_equal( Date.new(1994, 9, 2), pde.date )
+    assert_equal( 'Unbundled', pde.os )
+    assert_equal( '100393-01', pde.patch.to_s )
+    assert_equal( [], pde.pkgs )
+    assert_equal( [], pde.archs )
+    assert_equal( 'OBSOLETED by 100394', pde.synopsis )
+    assert_equal( line, pde.to_s )
+  end
+
+  def test_146364_01
+    line = '146364|01|Jan/04/11|R|S| |  |10_x86|i386;119758-19;|SUNWsfman:11.10.0,REV=2005.01.08.01.09;SUNWsmbaS:11.10.0,REV=2005.01.08.01.09;SUNWsmbar:11.10.0,REV=2005.01.08.01.09;SUNWsmbau:11.10.0,REV=2005.01.08.01.09;|SunOS 5.10_x86: Samba patch'
+    pde = Solaris::PatchdiagEntry.new( line )
+    assert_equal( 146364, pde.major )
+    assert_equal( 1, pde.minor )
+    assert_equal( true, pde.recommended? )
+    assert_equal( false, pde.obsolete? )
+    assert_equal( true, pde.security? )
+    assert_equal( Date.new(2011, 1, 4), pde.date )
+    assert_equal( '10_x86', pde.os )
+    assert_equal( '146364-01', pde.patch.to_s )
+    assert_equal( ['SUNWsfman:11.10.0,REV=2005.01.08.01.09',
+                 'SUNWsmbaS:11.10.0,REV=2005.01.08.01.09',
+                 'SUNWsmbar:11.10.0,REV=2005.01.08.01.09',
+                 'SUNWsmbau:11.10.0,REV=2005.01.08.01.09'],
+                 pde.pkgs )
+    assert_equal( ['i386', '119758-19'], pde.archs )
+    assert_equal( 'SunOS 5.10_x86: Samba patch', pde.synopsis )
+    assert_equal( line, pde.to_s )
+  end
+
+  def test_compare_equal
+    line = '100393|01|Sep/02/94| | |O|  |Unbundled|||OBSOLETED by 100394'
+    assert_equal(Solaris::PatchdiagEntry.new( line ),
+                 Solaris::PatchdiagEntry.new( line ))
+  end
+
+  def test_compare_less_than
+    line1 = '100393|01|Sep/02/94| | |O|  |Unbundled|||OBSOLETED by 100394'
+    line2 = '146364|01|Jan/04/11|R|S| |  |10_x86|i386;119758-19;|SUNWsfman:11.10.0,REV=2005.01.08.01.09;SUNWsmbaS:11.10.0,REV=2005.01.08.01.09;SUNWsmbar:11.10.0,REV=2005.01.08.01.09;SUNWsmbau:11.10.0,REV=2005.01.08.01.09;|SunOS 5.10_x86: Samba patch'
+    assert( Solaris::PatchdiagEntry.new( line1 ) < Solaris::PatchdiagEntry.new( line2 ) )
+  end
+
+  def test_successor
+    assert_raise( Solaris::Patch::NotObsolete ) do
+      successor( '100287|05|Oct/31/91| | | |  |Unbundled|||PC-NFS 3.5c: Jumbo patch (updated PRT.COM to v3.5c)' )
+    end
+    assert_equal( '110258-01', successor( '109687|01|Aug/11/00| | |O|  |Unbundled|sparc;|VRTSvxvm:3.0.4,REV=04.18.2000.10.00;|Obsoleted by : 110258-01 VxVM 3.0.4: vxio and vxdmp driver patch' ) )
+    assert_equal( '101318-94', successor( '101859|01|Feb/06/01| | |O|  |2.3|sparc;|SUNWcsr:11.5.0,REV=2.0.19,PATCH=118;|Obsoleted by: 101318-94 SunOS 5.3: socket lib in 2.3/2.2 have prob' ) )
+    assert_equal( '106542', successor( '107440|01|Mar/26/99| | |O|  |7_x86||SUNWcar:11.7.0,REV=1998.09.01.04.53;|OBSOLETED by: 106542  SunOS 5.7_x86: /platform/i86pc/kernel/mmu/mm' ) )
+    assert_equal( '109212-02', successor( '108191|01|Sep/07/99| | |O| B|Unbundled|||Obsoleted by: 109212-02 OBSOLETED by WITHDRAWN' ) )
+    assert_raise( Solaris::Patch::InvalidSuccessor ) do
+      successor( '100807|03|May/02/94| | |O| B|Unbundled|||OBSOLETED by WITHDRAWN' )
+    end
+    assert_equal( '100394', successor( '100393|01|Sep/02/94| | |O|  |Unbundled|||OBSOLETED by 100394' ) )
+    assert_raise( Solaris::Patch::MultipleSuccessors ) do
+      successor( '105716|07|Jun/30/99| |S|O|  |Unbundled||SUNWdtbas:1.0.2,REV=10.96.04.12;|OBSOLETED by 108363 and 108289' )
+    end
+    assert_raise( Solaris::Patch::MultipleSuccessors ) do
+      successor( '105717|06|Jun/30/99| |S|O|  |Unbundled||SUNWdtbas:1.0.2,REV=10.96.04.12;|OBSOLETED by 108290 and 108364' )
+    end
+    assert_equal( '110256-01', successor( '109685|02|Feb/09/01| | |O|  |Unbundled|sparc;|VRTSvxvm:3.0.4,REV=04.18.2000.10.00;|Obsoleted by 110256-01: VxVM 3.0.4: vxio and vxdmp driver patch' ) )
+    assert_equal( '110257-01', successor( '109686|02|Feb/09/01| | |O|  |Unbundled|sparc;|VRTSvxvm:3.0.4,REV=04.18.2000.10.00;|OBSOLETED by 110257-01: VxVM 3.0.4: vxio and vxdmp driver patch' ) )
+    assert_equal( '106513-07', successor( '106513|06|Oct/03/00| | |O| B|Unbundled|sparc;|SUNWosafw:6.01,REV=01.11;SUNWosau:6.01,REV=01.11;108555-02;|WITHDRAWN Obsoleted by: 106513-07 RM 6.1.1: generic Raid Manager 6' ) )
+    assert_raise( Solaris::Patch::InvalidSuccessor ) do
+      # NB fudged the obsolete flag here
+      successor( '111442|01|May/04/01| | |O| B|2.5.1|sparc;sparc.sun4c;sparc.sun4d;sparc.sun4m;sparc.sun4u;sparc.sun4u1;103640-35;|SUNWcar:11.5.1,REV=96.05.02.21.09;SUNWcar:11.5.1,REV=97.02.21.21.14;SUNWcsr:11.5.1,REV=96.05.02.21.09;103640-36;|WITHDRAWN PATCH Obsolete by: <INTEGRATION> SunOS 5.5.1: Supplement' )
+    end
+    assert_equal( '103901-08', successor( '103901|07|Aug/05/97| |S|O| B|2.5.1|||WITHDRAWN PATCH Obsoleted by: 103901-08 OpenWindows 3.5.1: Xview P' ) )
+    assert_raise( Solaris::Patch::InvalidSuccessor ) do
+      # NB fudged the obsolete flag here
+      successor( '111433|02|Jun/04/01| | |O| B|8|sparc;sparc.sun4d;sparc.sun4m;sparc.sun4u;sparc.sun4us;108528-08;|FJSVhea:1.0,REV=1999.12.23.19.10;SUNWcar:11.8.0,REV=2000.01.08.18.12;SUNWcar:11.8.0,REV=2000.01.13.13.40;SUNWcarx:11.8.0,REV=2000.01.08.18.12;SUNWcarx:11.8.0,REV=2000.01.13.13.40;SUNWcsr:11.8.0,REV=2000.01.08.18.12;SUNWhea:11.8.0,REV=2000.01.08.18.12;108528-09;|WITHDRAWN PATCH Obsoleted by: <Integration> SunOS 5.8: Supplementa' )
+    end
+  end
+
+  private
+
+  def successor(line)
+    Solaris::PatchdiagEntry.new( line ).successor.to_s
+  end
+
+end
+

data/test/test_solaris.rb

@@ -0,0 +1,29 @@
+
+require 'test/unit'
+require 'solaris'
+
+# Unit tests for top level require.
+class TestSolaris < Test::Unit::TestCase #:nodoc:
+
+  def test_solaris
+    assert_nothing_raised { Solaris }
+  end
+
+  def test_solaris_patch
+    assert_nothing_raised { Solaris::Patch }
+  end
+
+  def test_solaris_patchdiag
+    assert_nothing_raised { Solaris::Patchdiag }
+  end
+
+  def test_solaris_patchdiag_entry
+    assert_nothing_raised { Solaris::PatchdiagEntry }
+  end
+
+  def test_test
+    assert_raise( NameError ) { Solaris::DoesNotExist }
+  end
+
+end
+

data/test/test_util.rb

@@ -0,0 +1,31 @@
+
+require 'test/unit'
+require 'solaris/util'
+
+# Unit tests for utility module.
+class TestUtil < Test::Unit::TestCase #:nodoc:
+
+  def test_to_dir_to_file_mutually_exclusive
+    assert_raise( ArgumentError ) do
+      Solaris::Util.download!('http://example.com',
+                              :to_dir => 'dir',
+                              :to_file => 'file')
+    end
+  end
+
+  def test_user_without_password
+    assert_raise( ArgumentError ) do
+      Solaris::Util.download!('http://example.com',
+                              :user => 'user')
+    end
+  end
+
+  def test_password_without_user
+    assert_raise( ArgumentError ) do
+      Solaris::Util.download!('http://example.com',
+                              :password => 'password')
+    end
+  end
+
+end
+

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification 
+name: solaris-patch
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Martin Carpenter
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-03 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: mechanize
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  type: :runtime
+  version_requirements: *id001
+description: Provides methods to deal with Solaris patchdiag.xref and patches, including parsing patchdiag.xref, downloads from Oracle (patch and readme), patch version comparison, and eg seeking the latest non-obsolete version of a patch
+email: mcarpenter@free.fr
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- Rakefile
+- README.rdoc
+files: 
+- lib/solaris/exception.rb
+- lib/solaris/patch.rb
+- lib/solaris/foo
+- lib/solaris/patchdiag_entry.rb
+- lib/solaris/util.rb
+- lib/solaris/patchdiag.rb
+- lib/solaris.rb
+- test/test_patchdiag_entry.rb
+- test/test_patch.rb
+- test/test_util.rb
+- test/test_solaris.rb
+- test/test_patchdiag.rb
+- LICENSE
+- Rakefile
+- README.rdoc
+has_rdoc: true
+homepage: http://mcarpenter.org/projects/solaris-patch
+licenses: 
+- BSD
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Facilitate the manipulation of Solaris patches
+test_files: 
+- test/test_patchdiag_entry.rb
+- test/test_patch.rb
+- test/test_util.rb
+- test/test_solaris.rb
+- test/test_patchdiag.rb