atlassian_app_versions 0.1.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: adf2ac0abf92f4d86b0639d92003fece5c53d041
+  data.tar.gz: c78319e42020b8e8ebb00cbf3a2000b7d950a352
+SHA512:
+  metadata.gz: 514cb6322b96b3e64850bb4e96a9370396e99badc115831272a54c2ececca96701d4b795b328c5218a785e1bd8a1b3c4ca03f4c3bf3934a52b359d0a35f5564d
+  data.tar.gz: 075ec3e2a2e3f1dc8bb1deda238caa5620c003f654d8c347e4b8a275532e53a40b1025b2396c5f8bbab8efcd7833d4f72aaa6642f7abddbfa28f0051a458648d

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.3.0
+before_install: gem install bundler -v 1.11.2

data/Gemfile

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

data/Guardfile

@@ -0,0 +1,42 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+## Uncomment and set this to only include directories you want to watch
+# directories %w(app lib config test spec features) \
+#  .select{|d| Dir.exists?(d) ? d : UI.warning("Directory #{d} does not exist")}
+
+## Note: if you are using the `directories` clause above and you are not
+## watching the project directory ('.'), then you will want to move
+## the Guardfile to a watched dir and symlink it back, e.g.
+#
+#  $ mkdir config
+#  $ mv Guardfile config/
+#  $ ln -s config/Guardfile .
+#
+# and, you'll have to watch "config/Guardfile" instead of "Guardfile"
+
+guard :minitest do
+  # with Minitest::Unit
+  watch(%r{^test/(.*)\/?test_(.*)\.rb$})
+  watch(%r{^lib/(.*/)?([^/]+)\.rb$})     { |m| "test/#{m[1]}test_#{m[2]}.rb" }
+  watch(%r{^test/test_helper\.rb$})      { 'test' }
+
+  # with Minitest::Spec
+  # watch(%r{^spec/(.*)_spec\.rb$})
+  # watch(%r{^lib/(.+)\.rb$})         { |m| "spec/#{m[1]}_spec.rb" }
+  # watch(%r{^spec/spec_helper\.rb$}) { 'spec' }
+
+  # Rails 4
+  # watch(%r{^app/(.+)\.rb$})                               { |m| "test/#{m[1]}_test.rb" }
+  # watch(%r{^app/controllers/application_controller\.rb$}) { 'test/controllers' }
+  # watch(%r{^app/controllers/(.+)_controller\.rb$})        { |m| "test/integration/#{m[1]}_test.rb" }
+  # watch(%r{^app/views/(.+)_mailer/.+})                   { |m| "test/mailers/#{m[1]}_mailer_test.rb" }
+  # watch(%r{^lib/(.+)\.rb$})                               { |m| "test/lib/#{m[1]}_test.rb" }
+  # watch(%r{^test/.+_test\.rb$})
+  # watch(%r{^test/test_helper\.rb$}) { 'test' }
+
+  # Rails < 4
+  # watch(%r{^app/controllers/(.*)\.rb$}) { |m| "test/functional/#{m[1]}_test.rb" }
+  # watch(%r{^app/helpers/(.*)\.rb$})     { |m| "test/helpers/#{m[1]}_test.rb" }
+  # watch(%r{^app/models/(.*)\.rb$})      { |m| "test/unit/#{m[1]}_test.rb" }
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Jeff Turner
+
+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/README.md

@@ -0,0 +1,75 @@
+# AtlassianAppVersions
+
+This Gem obtains info about Atlassian product and plugin releases from the https://marketplace.atlassian.com and https://my.atlassian.com REST APIs.
+
+See also the `atlassian_app_upgradereport` gem which uses this info to produce Confluence reports.
+
+## Usage
+
+There are two top-level classes, `App` instantiated with a product name, and `Plugin` instantiated with a plugin key (key names are from https://marketplace.atlassian.com). `App` and `Plugin` behave similarly, in that they expose a bunch of properties (call the `.keys` method to see what's available), have `version` and `versions` methods to list their versions, and a set of methods (
+
+Sample API use:
+
+```ruby
+require 'atlassian_app_versions'
+include AtlassianAppVersions
+
+# Info about an Atlassian product
+
+conf = App.new("confluence")
+conf.latest		# #<AtlassianAppVersions::LatestAppVersion:70118429916620 5.9.10>
+conf.version("5.9.10")		# => #<AtlassianAppVersions::LatestAppVersion:70271671608160 5.9.10>
+conf.version("5.9.10").version		# => => "5.9.10"
+conf.version("5.9.10").releaseDate	# => #<DateTime: 2016-05-05T00:00:00+00:00 ((2457514j,0s,0n),+0s,2299161j)>
+conf.version("5.9.10").relNotes		# => "http://confluence.atlassian.com/display/DOC/Confluence+5.9.10+Release+Notes"
+
+
+conf.versions("5.9.1", "5.9.5")		#  => [#<AtlassianAppVersions::ArchivedAppVersion:70118438447880 5.9.5>,
+ 					#<AtlassianAppVersions::ArchivedAppVersion:70118438447860 5.9.4>,
+  					#<AtlassianAppVersions::ArchivedAppVersion:70118438447840 5.9.3>,
+   					#<AtlassianAppVersions::ArchivedAppVersion:70118438447820 5.9.2>]
+conf.latest.relNotes	# => "http://confluence.atlassian.com/display/DOC/Confluence+5.9.10+Release+Notes"
+conf.latest.keys	# => ["description", "zipUrl", "tarUrl", "md5", "size", "released", ...]
+conf.latest.zipUrl	# => "https://www.atlassian.com/software/confluence/downloads/binary/atlassian-confluence-5.9.10.tar.gz"
+
+
+# JQL for bugs fixed in the latest release
+conf.bugsJQL(conf.versions[1], conf.versions[0])	# => "issuetype=Bug AND project=CONF AND fixVersion in (5.9.10) AND status in (Resolved, Closed, Soaking) ORDER BY votes DESC, priority DESC, key DESC"
+
+
+# Info about an Atlassian plugin
+
+plugin = Plugin.new("de.scandio.confluence.plugins.pocketquery")
+plugin.name	# => "PocketQuery"
+# Available info on the plugin
+plugin.keys	# => ["downloadCount", "name", "deployment", "deployable", "lastModified", "description",..]
+
+# Available info a specific release
+plugin.latest.keys	# => ["supportType", "releaseDate", "deployment", "deployable", "marketplaceType", "compatibilities", "screenshots", "releasedBy", "license", "version", "links", "status", "marketplaceAgreementAccepted", "pluginSystemVersion", "instructions", "autoUpdateAllowed", "compatibleApplications", "stable", "buildNumber", "summary", "addOnType"]
+
+plugin.latest.version # => "2.0.7"
+
+```
+
+
+## Installation
+
+- Install Ruby 2.3.1 or above (I use [ruby-install](https://github.com/postmodern/ruby-install) + [chruby](https://github.com/postmodern/chruby)). Then:
+```bash
+gem install bundler
+git clone https://redradish@bitbucket.org/redradish/atlassian_app_versions.git
+cd atlassian_app_versions
+bundle install	# Install this gem's deps
+bundle exec rake install	# Install this gem
+bundle exec rake test	# Ensure it's all happy
+```
+Then try the sample code above in `irb` or `pry`.
+
+## Development
+
+In the finest tradition of Ruby gems, this gem is a hasty hack thrown together. The code would make experienced Rubyists cry. There is no guarantee of API stability. 
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task :default => :test

data/atlassian_app_versions.gemspec

@@ -0,0 +1,36 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'atlassian_app_versions'
+
+Gem::Specification.new do |spec|
+  spec.name          = "atlassian_app_versions"
+  spec.version       = AtlassianAppVersions::VERSION
+  spec.authors       = ["Jeff Turner"]
+  spec.email         = ["jeff@redradishtech.com"]
+
+  spec.summary       = %q{Obtain info about Atlassian JIRA and other product releases.}
+  spec.description   = %q{Wraps the marketplace.atlassian.com and my.atlassian.com REST APIs to obtain info about JIRA releases. See commented-out code near end for examples.}
+#
+  spec.license       = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org by setting 'allowed_push_host', or
+  # delete this section to allow pushing this gem to any host.
+  #if spec.respond_to?(:metadata)
+  #  spec.metadata['allowed_push_host'] = "TODO: Set to 'http://mygemserver.com'"
+  #else
+  #  raise "RubyGems 2.0 or newer is required to protect against public gem pushes."
+  #end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.11"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency "minitest-reporters", "~> 1.1"
+  spec.add_development_dependency "guard"
+  spec.add_development_dependency "guard-minitest"
+end

data/bin/console

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "atlassian_app_versions"
+include AtlassianAppVersions
+
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/atlassian_app_versions.rb

@@ -0,0 +1,386 @@
+#######
+# Wraps the marketplace.atlassian.com and my.atlassian.com REST APIs to obtain info about JIRA releases. See commented-out code near end for examples.
+#
+# marketplace.atlassian.com data returns simple version data for plugins and apps.
+# my.atlassian.com data returns release notes and download locations, but only for apps.
+#
+# We maintain the facade of having Version objects. Versions get their data by requesting either MPAC or MAC JSON from their @parent, which caches the JSON.
+#
+require 'open-uri'
+require 'json'
+require 'cgi'
+
+module AtlassianAppVersions
+
+    VERSION = "0.1.4"
+
+    # A Plugin or App. This class assumes the MPAC API will have info about the product.
+    class AbstractProduct
+
+	JAC_URL="https://jira.atlassian.com"
+
+	attr_accessor :key
+	# Initialize with a MPAC key (e.g. "jira" or "com.pyxis.greenhopper.jira")
+	def initialize(key)
+	    @key=key
+	end
+
+        # JQL for all issues resolved after +fromVer+ up to and including +toVer+.
+	def allissuesJQL(fromVer=nil, toVer=nil)
+	    templateJQL(fromVer, toVer)
+	end
+
+        # JQL for all Bugs resolved after +fromVer+ up to and including +toVer+.
+	def bugsJQL(fromVer=nil, toVer=nil)
+	    "issuetype=Bug AND " + templateJQL(fromVer, toVer)
+	end
+
+        # JQL for all features resolved after +fromVer+ up to and including +toVer+.
+	def featuresJQL(fromVer=nil, toVer=nil)
+	    "issuetype!=Bug AND " + templateJQL(fromVer, toVer)
+	end
+
+        # JQL for all new, unresolved Bugs _introduced_ in the (up to) 3 versions before +toVer+, but after +fromVer+. This means bugs reported against a version in the range, but not reported against an earlier version (up to +pastVersionsToIgnore+ old versions are considered, since some really old versions are missing from JAC and break the query).
+	def recentbugsJQL(fromVer, toVer=nil, includedVersionCount=3, pastVersionsToIgnore=50)
+	    new = versions(fromVer, toVer).first(includedVersionCount)
+	    old = versions.select { |v| v < new.last }.first(pastVersionsToIgnore)
+
+	    projectJQL(fromVer) + " AND issuetype=Bug AND affectedVersion in (#{versionsListJQL(new)}) AND affectedVersion not in (#{versionsListJQL(old)}) AND resolution is empty ORDER BY votes DESC, priority DESC, key DESC"
+	end
+
+        # URL for all issues resolved after +fromVer+ up to and including +toVer+.
+	def allissuesURL(fromVer=nil, toVer=nil)
+	    JAC_URL + "/issues/?jql=#{CGI::escape(allissuesJQL(fromVer, toVer))}"
+	end
+
+        # URL for all Bugs resolved after +fromVer+ up to and including +toVer+.
+	def bugsURL(fromVer=nil, toVer=nil)
+	    JAC_URL + "/issues/?jql=#{CGI::escape(bugsJQL(fromVer, toVer))}"
+	end
+
+        # URL for all features resolved after +fromVer+ up to and including +toVer+.
+	def featuresURL(fromVer=nil, toVer=nil)
+	    JAC_URL + "/issues/?jql=#{CGI::escape(featuresJQL(fromVer, toVer))}"
+	end
+
+        # URL for all new, unresolved Bugs _introduced_ after +fromVer+ up to and including +toVer+. This means bugs reported against a version in the range, but not reported against an earlier version.
+	def recentbugsURL(fromVer=nil, toVer=nil)
+	    JAC_URL + "/issues/?jql=#{CGI::escape(recentbugsJQL(fromVer, toVer))}"
+	end
+
+	def marketplaceJSON
+	    if !@marketplaceJSON then
+		mpacKey = case key
+			  when "jira-core", "jira-software" then
+			      # mpac still only knows about 'jira'
+			      "jira"
+			  when "stash" then "bitbucket" # MPAC actually redirects stash to bitbucket, but be nice and do it here.
+			  else
+			      key
+			  end
+		url = "https://marketplace.atlassian.com/rest/1.0/#{product_type}/#{mpacKey}"
+		begin
+		    jsonStr = open(url).read
+		rescue OpenURI::HTTPError => error
+		    if error.io.status[0] == "404" then
+			raise "No plugin with key '#{key}' found"
+		    else
+			raise error
+		    end
+		end
+		@marketplaceJSON = JSON.parse( jsonStr )
+	    end
+	    @marketplaceJSON
+	end
+
+	## Find versions in a range, from +fromVer+ (exclusive) to +toVer+ (inclusive). If +toVer+ is omitted, all versions up to the latest are found. If +fromVer+ and +toVer+ are omitted, all versions are returned.
+	def versions(fromVer=nil, toVer=nil) # fromVer and toVer may be a string or a *Version
+	    if (!fromVer && !toVer) then
+		allVersions
+	    else
+		# allVersions is ordered most to least recent
+		# If 'fromVer' was unspecified, count from the end (allVersions.size = last = oldest)
+		fromIdx = fromVer ? allVersions.find_index { |v| v.version == fromVer.to_s } || ( raise "Couldn't find #{@key} fromVer #{fromVer}" ) : allVersions.size
+		# If toVer was unspecified, count from the beginning (0 = newest)
+		toIdx = toVer ? allVersions.find_index{ |v| v.version == toVer.to_s } || ( raise "Couldn't find #{@key} toVer #{toVer}" ) : 0
+		# fromIdx may be greater than toIdx, which the slice doesn't like, so get the max/min here
+		from = [fromIdx, toIdx].min
+		to = [fromIdx, toIdx].max
+		allVersions.slice(from, (to - from))
+	    end
+	end
+
+	## Find a specific version
+	def version(ver)
+	    allVersions.find { |v| v.version == ver }
+	end
+
+
+	def allVersions
+	    raise "Override me!"
+	end
+	def latest
+	    allVersions.first
+	end
+
+	# Display all 'properties' of the app/plugin. These can be used as methods, e.g. 'jira.name' or 'plugin.summary'
+	def keys
+	    marketplaceJSON.keys
+	end
+
+	def method_missing(name, *args, &block)
+	    if keys and keys.member? name.to_s then
+		marketplaceJSON[name.to_s]
+	    else
+		super
+	    end
+	end
+
+	def respond_to_missing?(name, include_private = false)
+	    keys.member? name.to_s || super
+	end
+
+	private 
+
+	def jacKey
+	    case @key
+	    when "jira-core" then "JRA"
+	    when "jira-software" then ["JRA", "JSW"]
+	    when "confluence" then ["CONF", "CRA"]
+	    when "gh" then"GHS"
+	    when "stash" then "BSERV"
+	    when "bitbucket" then "BSERV"
+	    when "fisheye" then "FE"
+	    when "com.pyxis.greenhopper.jira" then "JSW"
+	    end
+	end
+
+	# "plugins" or "applications"
+	def product_type
+	    raise "Override me!"
+	end
+
+
+	# Return a 'project in (...)' JQL clause.
+	def projectJQL(fromVer=nil, toVer=nil)
+	    (jacKey.respond_to?(:each) ? "project in (#{jacKey.join(',')})" : "project=#{jacKey}")
+	end
+
+	# Return a comma-separated list of JAC version strings, given an Array of versions
+	def versionsListJQL(versions)
+	    # Atlassian started appending ' Server' to JIRA version names after 7.1.6
+	    if @key=~/jira/ then 
+		old, new = versions.partition { |v| v < "7.1.6"}
+		(new.map { |v| "'#{v} Server'" } + old).join(", ")
+	    else
+		versions.join(", ")
+	    end
+	end
+
+	# JQL common between bugs and features
+	def templateJQL(fromVer=nil, toVer=nil)
+	    vers = versionsListJQL(versions(fromVer, toVer))
+	    projectJQL(fromVer, toVer) + 
+		" AND fixVersion in (#{vers}) AND status in (Resolved, Closed, Soaking, \"Released to Server\") ORDER BY votes DESC, priority DESC, key DESC"
+	end
+    end
+
+    ## Represents a plugin, with information taken from https://marketplace.atlassian.com
+    class Plugin < AbstractProduct
+
+	def versionsJSON
+	    marketplaceJSON["versions"]["versions"]
+	end
+	def product_type
+	    "plugins"
+	end
+
+	def allVersions
+	    versionsJSON.collect { |v| PluginVersion.new(v["version"], self) }
+	end
+
+	# A few plugins are tracked on JAC, so if asked for JQL, return their issue-tracker link.
+	def allissueJQL(fromVer=nil, toVer=nil)
+	    links = versionsJSON.first["links"] 
+	    if links then
+		tracker = links.find { |l| l["rel"] == "issue-tracker" }
+		if tracker then
+		    if tracker["href"] =~ /jira\.atlassian\.com/ then
+			templateJQL(fromVer, toVer)
+		    else
+			nil
+		    end
+		end
+	    end
+	end
+    end
+
+    ## Represents an application on jira.atlassian.com / my.atlassian.com
+    class App < AbstractProduct
+	VALID_PRODUCTS=["jira-core", "jira-software", "confluence", "bitbucket", "stash", "fisheye", "crowd"]
+	def initialize(key)
+	    if !VALID_PRODUCTS.member? key then
+		raise "Unknown product: #{key}. Use one of #{VALID_PRODUCTS.join(", ")}"
+	    end
+	    if key=="stash" then key="bitbucket"; end
+	    super
+	end
+
+	def getjson(url)
+	    open(url).read.gsub(/^downloads\(/, '').gsub(/\)$/, '')
+	end
+
+	def latestReleaseJSON
+	    if !@latestReleaseJSON then
+
+		macKey = @key == "bitbucket" ? "stash" : @key # MAC still thinks it's 'stash'
+		url="https://my.atlassian.com/download/feeds/current/#{macKey}.json"
+		jsonStr = getjson(url)
+		@latestReleaseJSON = JSON.parse(jsonStr)
+	    end
+	    @latestReleaseJSON
+	end
+
+	def archivedReleaseJSON
+	    if !@archivedReleaseJSON then
+		macKey = @key == "bitbucket" ? "stash" : @key # MAC still thinks it's 'stash'
+		url="https://my.atlassian.com/download/feeds/archived/#{macKey}.json"
+		jsonStr = getjson(url)
+		@archivedReleaseJSON = JSON.parse( jsonStr )
+	    end
+	    @archivedReleaseJSON
+	end
+
+	def versionsJSON
+	    marketplaceJSON["versions"]
+	end
+
+	def allVersions
+	    first=true
+	    versionsJSON.collect { |v|
+		if first then
+		    first=false
+		    LatestAppVersion.new(v["version"], self)
+		else
+		    ArchivedAppVersion.new(v["version"], self)
+		end
+	    }
+	end
+
+	def product_type
+	    "applications"
+	end
+    end
+
+    ## A plugin or app version
+    class AbstractVersion
+	include Comparable
+
+	attr_accessor :version
+	def initialize(versionName, parent) 
+	    @version = versionName
+	    @parent = parent
+	end
+
+	def versionJSON
+	    @parent.versionsJSON.find { |v| v["version"] == @version }
+	end
+
+	def releaseDate
+	    DateTime.strptime(versionJSON["releaseDate"], '%Y-%m-%dT%H:%M:%S.%L%z') if versionJSON
+	end
+
+	def inspect
+	    "#<#{self.class.name}:#{self.object_id} #{to_s}>"
+	end
+
+	def to_s
+	    @version
+	end
+
+	def <=>(other_version)
+	    # Confluence has a version with underscores (3.0.0_01) which Gem::Version doesn't like, so strip it
+	    v1 = @version.gsub('_', '.')
+	    v2 = other_version.to_s.gsub('_', '.')
+	    begin
+		Gem::Version.new(v1) <=> Gem::Version.new(v2)
+	    rescue ArgumentError => e
+		$stderr.puts e.message
+	    end
+
+	end
+
+	def keys
+	    versionJSON.keys
+	end
+
+	def method_missing(name, *args, &block)
+	    if versionJSON and versionJSON.keys.member? name.to_s then
+		versionJSON[name.to_s]
+	    else
+		super
+	    end
+	end
+
+	def respond_to_missing?(name, include_private = false)
+	    keys.member? name.to_s || super
+	end
+    end
+
+    class PluginVersion < AbstractVersion
+	# Some plugin release don't have release notes, in which case return nil
+	def relNotes
+	    if versionJSON["releaseNotes"] then
+		versionJSON["releaseNotes"].scan(/(?<=href=")[^"]+elease\+[nN]otes/)&.first&.strip
+	    end
+	end
+    end
+
+    class AppVersion < AbstractVersion
+	def releaseJSON
+	    raise "Override me"
+	end
+
+	def relNotes
+	    # RC releases don't have release notes, in which case return nil
+	    if releaseJSON
+		    releaseJSON["releaseNotes"]&.strip
+	    end
+	end
+
+	def keys
+	    # Combine versionJSON keys with releaseJSON keys. Note that Confluence 5.6 and earlier doesn't have releaseJSON.
+	    releaseJSON ? releaseJSON.keys + super : super
+	end
+
+	def method_missing(name, *args, &block)
+	    if releaseJSON and releaseJSON.keys.member? name.to_s then
+		releaseJSON[name.to_s]
+	    else
+		super
+	    end
+	end
+
+	def respond_to_missing?(name, include_private = false)
+	    keys.member? name.to_s || super
+	end
+    end
+
+    class LatestAppVersion < AppVersion
+	def releaseJSON
+	    @parent.latestReleaseJSON.select {|e|
+		url=e["zipUrl"]
+		@parent.key=="fisheye" ||
+		    url =~ /.tar.gz$/ && url !~ /(war|cluster).tar.gz$/
+	    }[0]
+	end
+    end
+    class ArchivedAppVersion < AppVersion
+	# Note: returns nil if that version wasn't available in the archive
+	def releaseJSON
+	    @parent.archivedReleaseJSON.find { |v| v["version"] == @version }
+	end
+    end
+
+end
+# vim: set smartindent sw=4:

metadata

@@ -0,0 +1,140 @@
+--- !ruby/object:Gem::Specification
+name: atlassian_app_versions
+version: !ruby/object:Gem::Version
+  version: 0.1.4
+platform: ruby
+authors:
+- Jeff Turner
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-11-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: minitest-reporters
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Wraps the marketplace.atlassian.com and my.atlassian.com REST APIs to
+  obtain info about JIRA releases. See commented-out code near end for examples.
+email:
+- jeff@redradishtech.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- atlassian_app_versions.gemspec
+- bin/console
+- bin/setup
+- lib/atlassian_app_versions.rb
+homepage: 
+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.5.1
+signing_key: 
+specification_version: 4
+summary: Obtain info about Atlassian JIRA and other product releases.
+test_files: []