pgversion 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7ea9663bfdf214432df8e2a1e5bbdb7930c7ef57
+  data.tar.gz: 856c53a3876a1057654e3d55edd0cf544e09e022
+SHA512:
+  metadata.gz: 7284ef96b1fa6b6e0ab2466d286a7df5cfa039353305a1fdefd2c696b138d82fe5160aeea0c6c5e54fa4bdf7460180e4f52237082e616444878322115f78f3ef
+  data.tar.gz: 15bcc4a97179d019effe325b81a2e13b81dd8a9d0efb1c76ef610c0674929ba8d789458eeb0e537627264dcf9378715309672cc75e9f26217c04c5896c3d5cfa

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in fernet.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Maciek Sakrejda
+
+MIT License
+
+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,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/lib/pgversion.rb

@@ -0,0 +1,147 @@
+# Represents a Postgres release version. Note that breaking changes
+# generally only happen during major or minor version changes. Point
+# releases are strictly focused on fixing data integrity or security
+# issues.
+class PGVersion
+  include Comparable
+
+  VERSION = "0.0.1"
+
+  # The major and minor version taken together determine the stable
+  # interface to Postgres. New features may be introduced or breaking
+  # changes made when either of these change.
+  attr_reader :major
+
+  # The major and minor version taken together determine the stable
+  # interface to Postgres. New features may be introduced or breaking
+  # changes made when either of these change.
+  attr_reader :minor
+
+  # The point release, for release states. Note that this may be nil,
+  # which is considered later than all other releases. Always nil
+  # when state is not :release.
+  attr_reader :point
+
+  # The state of a release: :alpha, :beta, :rc, or :release
+  attr_reader :state
+
+  # The revision, for non-release states. A release in a given state
+  # may go through several revisions in that state before moving to
+  # the next state. Nil when state is :release.
+  attr_reader :revision
+  
+  # The host architecture of the given binary
+  attr_reader :host
+  # The compiler used to build the given binary
+  attr_reader :compiler
+  # Bit depth of the given binary
+  attr_reader :bit_depth
+
+  # Parse a Postgres version string, as produced by the function
+  # version(), into a PGVersion.
+  def self.parse(version_str)
+    result = version_str.match VERSION_REGEXP
+    raise ArgumentError, "Could not parse version string: #{version_str}" unless result
+    point = result[3]
+    if point =~ /\A\d+\Z/
+      point = point.to_i
+    end
+    PGVersion.new(result[1].to_i,
+                  result[2].to_i,
+                  point,
+                  host: result[4],
+                  compiler: result[5],
+                  bit_depth: result[6].to_i)
+  end
+
+  # Initialize a new PGVersion
+  def initialize(major, minor, point=nil, host: nil, compiler: nil, bit_depth: nil)
+    @major = major
+    @minor = minor
+    if point.nil? || point.is_a?(Fixnum)
+      @point = point
+      @state = :release
+    else
+      verstr_states = ALLOWED_STATES.reject { |s| s == :release }.map(&:to_s)
+      @state, @revision = point.to_s.match(
+                          /(#{verstr_states.join('|')})(\d+)/
+                        ) && $1.to_sym, $2.to_i
+      unless @state && @revision
+        raise ArgumentError, "Unknown point release: #{point}"
+      end
+    end
+    @host = host
+    @compiler = compiler
+    @bit_depth = bit_depth
+  end
+ 
+  # Compare to another PGVersion. Note that an unspecified point
+  # release version is considered higher than every point version of
+  # the same state.
+  def <=>(other)
+    if self.major < other.major
+      -1
+    elsif self.major > other.major
+      1
+    else
+      if self.minor < other.minor
+        -1
+      elsif self.minor > other.minor
+        1
+      else
+        self_state_idx = ALLOWED_STATES.index(self.state)
+        other_state_idx = ALLOWED_STATES.index(other.state)
+        if self_state_idx < other_state_idx
+          -1
+        elsif self_state_idx > other_state_idx
+          1
+        elsif self.state == :release
+          if self.point.nil? && other.point.nil?
+            0
+          elsif other.point.nil?
+            -1
+          elsif self.point.nil?
+            1
+          else
+            self.point <=> other.point
+          end
+        else
+          self.revision <=> other.revision
+        end
+      end
+    end
+  end
+
+  def release?; @state == :release; end
+  def rc?; @state == :rc; end
+  def beta?; @state == :beta; end
+  def alpha?; @state == :alpha; end
+
+  def to_s
+    patch = if release?
+              ".#{point}" unless point.nil?
+            else
+              "#{state}#{revision}"
+            end
+    v = "PostgreSQL #{major}.#{minor}#{patch}"
+    if host
+      v << " on #{host}"
+    end
+    if compiler
+      v << ", compiled by #{compiler}"
+    end
+    if bit_depth
+      v << ", #{bit_depth}-bit"
+    end
+    v
+  end
+
+  protected
+
+  attr_reader :state
+
+  private
+  
+  VERSION_REGEXP = /PostgreSQL (\d+)\.(\d+).?((?:alpha|beta|rc)?\d+) on ([^,]+), compiled by ([^,]+), (\d+)-bit/
+  ALLOWED_STATES = %i(alpha beta rc release)
+end

data/pgversion.gemspec

@@ -0,0 +1,19 @@
+require_relative 'lib/pgversion'
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Maciek Sakrejda"]
+  gem.email         = ["m.sakrejda@gmail.com"]
+  gem.description   = %q{Easy Postgres version utilities}
+  gem.summary       = %q{Parse Postgres version strings and compare versions}
+  gem.homepage      = "https://github.com/deafbybeheading/pgversion"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "pgversion"
+  gem.require_paths = ["lib"]
+  gem.version       = PGVersion::VERSION
+  gem.license       = "MIT"
+
+  gem.add_development_dependency "rspec", '~> 4.0'
+end

data/spec/pgversion_spec.rb

@@ -0,0 +1,77 @@
+require 'spec_helper'
+require_relative '../lib/pgversion'
+
+describe PGVersion do
+  {
+    "PostgreSQL 9.2.8 on x86_64-unknown-linux-gnu, compiled by gcc (Ubuntu 4.8.2-16ubuntu6) 4.8.2, 64-bit" =>
+      PGVersion.new(9,2,8, host: 'x86_64-unknown-linux-gnu', compiler: 'gcc (Ubuntu 4.8.2-16ubuntu6) 4.8.2', bit_depth: 64),
+    "PostgreSQL 9.1rc1 on x86_64-unknown-linux-gnu, compiled by gcc (Ubuntu 4.8.2-16ubuntu6) 4.8.2, 32-bit" =>
+      PGVersion.new(9,1,:rc1, host: 'x86_64-unknown-linux-gnu', compiler: 'gcc (Ubuntu 4.8.2-16ubuntu6) 4.8.2', bit_depth: 32),
+    "PostgreSQL 9.0beta2 on x86_64-unknown-linux-gnu, compiled by gcc (Ubuntu 4.8.2-16ubuntu6) 4.8.2, 64-bit" =>
+      PGVersion.new(9,0,:beta2, host: 'x86_64-unknown-linux-gnu', compiler: 'gcc (Ubuntu 4.8.2-16ubuntu6) 4.8.2', bit_depth: 64),
+    "PostgreSQL 8.4alpha3 on x86_64-unknown-linux-gnu, compiled by gcc (Ubuntu 4.8.2-16ubuntu6) 4.8.2, 64-bit" =>
+      PGVersion.new(8,4,:alpha3, host: 'x86_64-unknown-linux-gnu', compiler: 'gcc (Ubuntu 4.8.2-16ubuntu6) 4.8.2', bit_depth: 64),
+    "PostgreSQL 10.0.0 on x86_64-unknown-linux-gnu, compiled by gcc (Ubuntu 4.8.2-16ubuntu6) 4.8.2, 64-bit" =>
+      PGVersion.new(10,0,0, host: 'x86_64-unknown-linux-gnu', compiler: 'gcc (Ubuntu 4.8.2-16ubuntu6) 4.8.2', bit_depth: 64)
+  }.each do |version_str, version|
+    describe '.parse' do
+      it "parses #{version_str} into corresponding version #{version}" do
+        expect(PGVersion.parse(version_str)).to eq(version)
+      end
+    end
+
+    describe '#to_s' do
+      it "formats #{version} into corresponding #{version_str}" do
+        expect(version.to_s).to eq(version_str)
+      end
+    end
+  end
+
+  describe "#<=>" do
+    it "ignores bit_depth" do
+      expect(PGVersion.new(9,0,0, bit_depth: 32) <=> PGVersion.new(9,0,0, bit_depth: 32)).to eq(0)
+    end
+    it "ignores host" do
+      expect(PGVersion.new(9,0,0, host: "Linux") <=> PGVersion.new(9,0,0, host: "OS X")).to eq(0)
+    end
+    it "ignores compiler" do
+      expect(PGVersion.new(9,0,0, compiler: "gcc") <=> PGVersion.new(9,0,0, compiler: "ICC")).to eq(0)
+    end
+
+    test_versions = [
+      PGVersion.new(8,3,:alpha1),
+      PGVersion.new(8,3,:alpha3),
+      PGVersion.new(8,3,:beta1),
+      PGVersion.new(8,3,:beta2),
+      PGVersion.new(8,3,:rc1),
+      PGVersion.new(8,3,:rc3),
+      PGVersion.new(8,3,0),
+      PGVersion.new(8,3,1),
+      PGVersion.new(8,3),
+      PGVersion.new(8,14,0),
+      PGVersion.new(9,4,0),
+      PGVersion.new(10,0,:alpha1),
+      PGVersion.new(10,0,:alpha3),
+      PGVersion.new(10,0,:beta1),
+      PGVersion.new(10,0,:beta2),
+      PGVersion.new(10,0,:rc1),
+      PGVersion.new(10,0,:rc3),
+      PGVersion.new(10,0,0),
+      PGVersion.new(10,0,2),
+      PGVersion.new(10,0,10),
+      PGVersion.new(10,0)
+    ].each_with_index.to_a.repeated_permutation(2).each do |(l,lidx), (r,ridx)|
+      expected = lidx <=> ridx
+      it "compares #{l} to #{r} and gets #{expected}" do
+        expect(l <=> r).to eq(expected)
+      end
+      unless expected == 0
+        opposite = expected * -1
+        it "compares #{r} to #{l} and gets #{opposite}" do
+          expect(r <=> l).to eq(opposite)
+        end
+      end
+    end
+  end
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,21 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+end

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: pgversion
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Maciek Sakrejda
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-06-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+description: Easy Postgres version utilities
+email:
+- m.sakrejda@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- LICENSE
+- Rakefile
+- lib/pgversion.rb
+- pgversion.gemspec
+- spec/pgversion_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/deafbybeheading/pgversion
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Parse Postgres version strings and compare versions
+test_files:
+- spec/pgversion_spec.rb
+- spec/spec_helper.rb