brpm_module_jira 0.1.3

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NTc1ZTkyMDJmODAzMjQ3MjQxMzg5MmM0OTRkYjUzNzE1Y2I4OTBkZQ==
+  data.tar.gz: !binary |-
+    YTdjYzQyM2VmMTQ1ZTMwMGViMmViMDM3ZjlmMjQ1ZTVmZjY0NjIzOA==
+SHA512:
+  metadata.gz: !binary |-
+    ZWM1MDY4YmM0MmRlYzY3MjM0YzhjY2MzOTRkYWFmMmVkMDM3NDcyOGQzNDkz
+    N2MzYmNmMWIzMWIzMDRhNDIyMjJjYTNlNWNkZmY2MzY1N2U3Mjc3OTY4ZDVk
+    ZDA0MTg1ZTM4Mjg3MTkyMzRlM2VlNDUwMjVkYTg0MmEzMDBlNmU=
+  data.tar.gz: !binary |-
+    NzQxY2Y4M2FkYWMwYTQ5YzhjMjUyNTIzOGQ5ZTE2YmRlM2YzYzY0Mzk1ZDY3
+    NDA3Njc1MzJkMzQ2Y2ZhYjYyOTdjMjMzMzQ2NzM2NTUxNzEzZWIyZTk1NzU1
+    ZWUwYzMzZTEzOTk3N2Q0MmFmNjE4YjYwYmU4YWEwN2I0M2UwNmM=

data/.gitignore

@@ -0,0 +1,37 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+.ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+.DS_Store
+
+.idea

data/.ruby-version

@@ -0,0 +1 @@
+1.9.3-p392

data/.travis.yml

@@ -0,0 +1,17 @@
+language: ruby
+
+before_install:
+  - gem update --system 2.1.9
+
+bundler_args: '' #remove the --deployment flag that causes the gems to be installed in .../1.9.1/...
+
+script:
+  - rspec tests --format documentation --color
+
+notifications:
+  email:
+    - niek.bartholomeus@gmail.com
+
+branches:
+  except:
+    - /^v[0-9.]*/

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+gemspec
+
+# gem "brpm_content", path: "#{ENV["BRPM_CONTENT_PATH"]}/gems/brpm_content-latest" #TODO: doesn't work: "Could not find gem 'brpm_content (>= 0) ruby'..."
+# gem "brpm_content", path: "/Users/niek/src/bmc/brpm_content" # works fine but is specific to my local configuration
+
+# TODO: not sure how the framework can get hold of this configuration to find out where this modules is located (for now we're using a symlink from the gem path to the source path)
+# gem "brpm_module_selenium", path: "."

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 BMC
+
+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,7 @@
+# JIRA module for BRPM
+
+[![Build Status](https://travis-ci.org/BMC-RLM/brpm_module_jira.svg?branch=master)](https://travis-ci.org/BMC-RLM/brpm_module_jira)
+
+[![Gem Version](https://badge.fury.io/rb/brpm_module_jira.png)](http://badge.fury.io/rb/brpm_module_jira)
+
+This repository represents an external module for JIRA, to be used on top of the [BRPM content repository](https://github.com/BMC-RLM/brpm_content)

data/Rakefile

@@ -0,0 +1,24 @@
+# Copied from https://github.com/mitchellh/vagrant-aws/blob/master/Rakefile
+require 'rubygems'
+require 'bundler/setup'
+require 'rspec/core/rake_task'
+
+# Immediately sync all stdout so that tools like buildbot can
+# immediately load in the output.
+$stdout.sync = true
+$stderr.sync = true
+
+# Change to the directory of this file.
+Dir.chdir(File.expand_path("../", __FILE__))
+
+# This installs the tasks that help with gem creation and
+# publishing.
+Bundler::GemHelper.install_tasks
+
+# Install the `spec` task so that we can run tests.
+RSpec::Core::RakeTask.new do |task|
+  task.pattern = "tests/**/*_spec.rb"
+end
+
+# Default task is to run the unit tests
+task :default => "spec"

data/automations/add_comment.rb

@@ -0,0 +1,4 @@
+params = BrpmAuto.params
+
+BrpmAuto.log "Adding a comment for issue '#{params["issue_id"]}'..."
+JiraRestClient.new.add_comment(params["issue_id"], params["comment"])

data/automations/add_comment.txt

@@ -0,0 +1,23 @@
+###
+# issue_id:
+#   name: Issue Id
+#   required: yes
+# comment:
+#   name: Comment
+#   required: yes
+###
+
+#=== BMC Application Automation Integration Server: JIRA ===#
+# [integration_id=4]
+#=== End ===#
+
+require "#{ENV["BRPM_CONTENT_HOME"] || "#{ENV["BRPM_HOME"]}/modules"}/gems/brpm_content-#{ENV["BRPM_CONTENT_VERSION"] || "latest"}/modules/framework/brpm_script_executor.rb"
+
+params["direct_execute"] = "true"
+
+params["SS_integration_dns"] = SS_integration_dns
+params["SS_integration_username"] = SS_integration_username
+params["SS_integration_password_enc"] = SS_integration_password_enc
+params["SS_integration_details"] = YAML.load(SS_integration_details)
+
+BrpmScriptExecutor.execute_automation_script_from_gem("brpm_module_jira", "add_comment", params)

data/automations/create_release.rb

@@ -0,0 +1,4 @@
+params = BrpmAuto.params
+
+BrpmAuto.log "Creating a new option for plan '#{params["release_name"]}' in the JIRA dropdown custom field with id #{params["jira_release_field_id"]}..."
+JiraRestClient.new.create_option_for_dropdown_custom_field(params["jira_release_field_id"], params["release_name"])

data/automations/create_release.txt

@@ -0,0 +1,23 @@
+###
+# jira_release_field_id:
+#   name: JIRA release field id
+#   required: yes
+# release_name:
+#   name: Release name
+#   required: yes
+###
+
+#=== BMC Application Automation Integration Server: JIRA ===#
+# [integration_id=4]
+#=== End ===#
+
+require "#{ENV["BRPM_CONTENT_HOME"] || "#{ENV["BRPM_HOME"]}/modules"}/gems/brpm_content-#{ENV["BRPM_CONTENT_VERSION"] || "latest"}/modules/framework/brpm_script_executor.rb"
+
+params["direct_execute"] = "true"
+
+params["SS_integration_dns"] = SS_integration_dns
+params["SS_integration_username"] = SS_integration_username
+params["SS_integration_password_enc"] = SS_integration_password_enc
+params["SS_integration_details"] = YAML.load(SS_integration_details)
+
+BrpmScriptExecutor.execute_automation_script_from_gem("brpm_module_jira", "create_release", params)

data/automations/delete_release.rb

@@ -0,0 +1,4 @@
+params = BrpmAuto.params
+
+BrpmAuto.log "Deleting option for plan '#{params["release_name"]}' in the JIRA dropdown custom field with id #{params["jira_release_field_id"]}..."
+JiraRestClient.new.delete_option_for_dropdown_custom_field(params["jira_release_field_id"], params["release_name"])

data/automations/delete_release.txt

@@ -0,0 +1,23 @@
+###
+# jira_release_field_id:
+#   name: JIRA release field id
+#   required: yes
+# release_name:
+#   name: Release name
+#   required: yes
+###
+
+#=== BMC Application Automation Integration Server: JIRA ===#
+# [integration_id=4]
+#=== End ===#
+
+require "#{ENV["BRPM_CONTENT_HOME"] || "#{ENV["BRPM_HOME"]}/modules"}/gems/brpm_content-#{ENV["BRPM_CONTENT_VERSION"] || "latest"}/modules/framework/brpm_script_executor.rb"
+
+params["direct_execute"] = "true"
+
+params["SS_integration_dns"] = SS_integration_dns
+params["SS_integration_username"] = SS_integration_username
+params["SS_integration_password_enc"] = SS_integration_password_enc
+params["SS_integration_details"] = YAML.load(SS_integration_details)
+
+BrpmScriptExecutor.execute_automation_script_from_gem("brpm_module_jira", "delete_release", params)

data/automations/transition_issue.rb

@@ -0,0 +1,4 @@
+params = BrpmAuto.params
+
+BrpmAuto.log "Setting the status of issue #{params["issue_id"]} to #{params["target_issue_status"]}"
+JiraRestClient.new.set_issue_to_status(params["issue_id"], params["target_issue_status"])

data/automations/transition_issue.txt

@@ -0,0 +1,23 @@
+###
+# issue_id:
+#   name: Issue Id
+#   required: yes
+# target_issue_status:
+#   name: Target issue status
+#   required: yes
+###
+
+#=== BMC Application Automation Integration Server: JIRA ===#
+# [integration_id=4]
+#=== End ===#
+
+require "#{ENV["BRPM_CONTENT_HOME"] || "#{ENV["BRPM_HOME"]}/modules"}/gems/brpm_content-#{ENV["BRPM_CONTENT_VERSION"] || "latest"}/modules/framework/brpm_script_executor.rb"
+
+params["direct_execute"] = "true"
+
+params["SS_integration_dns"] = SS_integration_dns
+params["SS_integration_username"] = SS_integration_username
+params["SS_integration_password_enc"] = SS_integration_password_enc
+params["SS_integration_details"] = YAML.load(SS_integration_details)
+
+BrpmScriptExecutor.execute_automation_script_from_gem("brpm_module_jira", "transition_issues_for_request", params)

data/automations/transition_issues_for_request.rb

@@ -0,0 +1,29 @@
+brpm_rest_client = BrpmRestClient.new
+params = BrpmAuto.params
+
+BrpmAuto.log  "Getting the tickets that are linked to the request..."
+tickets = brpm_rest_client.get_tickets_by_request_id(params.rest_request_id)
+
+if tickets.count == 0
+  BrpmAuto.log "This request has no tickets, nothing further to do."
+  return
+end
+
+unless params["target_issue_status"]
+  BrpmAuto.log  "Getting the stage of this request..."
+  request_with_details = brpm_rest_client.get_request_by_id(params.rest_request_id)
+
+  if request_with_details.has_key?("plan_member")
+    stage_name = request_with_details["plan_member"]["stage"]["name"]
+
+    params["target_issue_status"] = "Deployed to #{stage_name}"
+  else
+    BrpmAuto.log "The request is not part of a plan so not processing the tickets."
+    return
+  end
+end
+
+tickets.each do |ticket|
+  BrpmAuto.log "Setting the status of issue #{ticket["foreign_id"]} to #{params["target_issue_status"]}"
+  JiraRestClient.new.set_issue_to_status(ticket["foreign_id"], params["target_issue_status"])
+end

data/automations/transition_issues_for_request.txt

@@ -0,0 +1,20 @@
+###
+# target_issue_status:
+#   name: Target issue status
+#   required: no
+###
+
+#=== BMC Application Automation Integration Server: JIRA ===#
+# [integration_id=4]
+#=== End ===#
+
+require "#{ENV["BRPM_CONTENT_HOME"] || "#{ENV["BRPM_HOME"]}/modules"}/gems/brpm_content-#{ENV["BRPM_CONTENT_VERSION"] || "latest"}/modules/framework/brpm_script_executor.rb"
+
+params["direct_execute"] = "true"
+
+params["SS_integration_dns"] = SS_integration_dns
+params["SS_integration_username"] = SS_integration_username
+params["SS_integration_password_enc"] = SS_integration_password_enc
+params["SS_integration_details"] = YAML.load(SS_integration_details)
+
+BrpmScriptExecutor.execute_automation_script_from_gem("brpm_module_jira", "transition_issues_for_request", params)

data/automations/transition_issues_for_run.rb

@@ -0,0 +1,26 @@
+brpm_rest_client = BrpmRestClient.new
+params = BrpmAuto.params
+
+run_id = params["request_run_id"] || params["run_id"]
+
+BrpmAuto.log  "Getting the tickets that are linked to the requests of this run..."
+tickets = brpm_rest_client.get_tickets_by_run_id_and_request_state(run_id, "completed")
+
+if tickets.count == 0
+  BrpmAuto.log "This run has no tickets, nothing further to do."
+  return
+end
+
+unless params["target_issue_status"]
+  if params["request_plan_stage"]
+    params["target_issue_status"] = "Deployed to #{params["request_plan_stage"]}"
+  else
+    BrpmAuto.log "The request is not part of a plan so not processing the tickets."
+    return
+  end
+end
+
+tickets.each do |ticket|
+  BrpmAuto.log "Setting the status of issue #{ticket["foreign_id"]} to #{params["target_issue_status"]}"
+  JiraRestClient.new.set_issue_to_status(ticket["foreign_id"], params["target_issue_status"])
+end

data/automations/transition_issues_for_run.txt

@@ -0,0 +1,20 @@
+###
+# target_issue_status:
+#   name: Target issue status
+#   required: no
+###
+
+#=== BMC Application Automation Integration Server: JIRA ===#
+# [integration_id=4]
+#=== End ===#
+
+require "#{ENV["BRPM_CONTENT_HOME"] || "#{ENV["BRPM_HOME"]}/modules"}/gems/brpm_content-#{ENV["BRPM_CONTENT_VERSION"] || "latest"}/modules/framework/brpm_script_executor.rb"
+
+params["direct_execute"] = "true"
+
+params["SS_integration_dns"] = SS_integration_dns
+params["SS_integration_username"] = SS_integration_username
+params["SS_integration_password_enc"] = SS_integration_password_enc
+params["SS_integration_details"] = YAML.load(SS_integration_details)
+
+BrpmScriptExecutor.execute_automation_script_from_gem("brpm_module_jira", "transition_issues_for_run", params)

data/automations/update_release.rb

@@ -0,0 +1,4 @@
+params = BrpmAuto.params
+
+BrpmAuto.log "Updating option for plan from '#{params["old_release_name"]}' to '#{params["new_release_name"]}' in the JIRA dropdown custom field with id #{params["jira_release_field_id"]}..."
+JiraRestClient.new.update_option_for_dropdown_custom_field(params["jira_release_field_id"], params["old_release_name"], params["new_release_name"])

data/automations/update_release.txt

@@ -0,0 +1,26 @@
+###
+# jira_release_field_id:
+#   name: JIRA release field id
+#   required: yes
+# old_release_name:
+#   name: Old release name
+#   required: yes
+# new_release_name:
+#   name: New release name
+#   required: yes
+###
+
+#=== BMC Application Automation Integration Server: JIRA ===#
+# [integration_id=4]
+#=== End ===#
+
+params["direct_execute"] = "true"
+
+require "#{ENV["BRPM_CONTENT_HOME"] || "#{ENV["BRPM_HOME"]}/modules"}/gems/brpm_content-#{ENV["BRPM_CONTENT_VERSION"] || "latest"}/modules/framework/brpm_script_executor.rb"
+
+params["SS_integration_dns"] = SS_integration_dns
+params["SS_integration_username"] = SS_integration_username
+params["SS_integration_password_enc"] = SS_integration_password_enc
+params["SS_integration_details"] = YAML.load(SS_integration_details)
+
+BrpmScriptExecutor.execute_automation_script_from_gem("brpm_module_jira", "update_release", params)

data/brpm_module_jira.gemspec

@@ -0,0 +1,39 @@
+require "yaml"
+
+config = YAML.load_file(File.join(File.dirname(__FILE__), "config.yml"))
+
+Gem::Specification.new do |spec|
+  spec.name          = File.basename(File.expand_path(File.dirname(__FILE__)))
+  spec.version       = config["version"]
+  spec.platform      = Gem::Platform::RUBY
+  spec.license       = "GNU General Public License v2.0"
+  spec.authors       = [config["author"]]
+  spec.email         = config["email"]
+  spec.homepage      = config["homepage"]
+  spec.summary       = config["summary"]
+  spec.description   = config["description"]
+
+  spec.add_runtime_dependency "brpm_content", ">=0.1.10"
+
+  if config["dependencies"]
+    config["dependencies"].each do |dependency|
+      if dependency.is_a?(Hash)
+        modul = dependency.keys[0]
+        options = dependency.values[0]
+      else
+        modul = dependency
+        options = {}
+      end
+      spec.add_runtime_dependency modul, options["version"] unless ["brpm", "bladelogic", "jira"].include?(modul)
+    end
+  end
+
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+
+  spec.files         = `git ls-files`.split("\n")
+  spec.require_path  = 'lib'
+
+  spec.executables   = spec.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  spec.bindir        = "bin"
+end

data/config.yml

@@ -0,0 +1,13 @@
+dependencies:
+  - brpm_module_brpm
+
+integration_servers:
+  - JIRA
+
+version: 0.1.3
+
+author: Niek Bartholomeus
+email: niek.bartholomeus@gmail.com
+homepage: https://github.com/BMC-RLM/brpm_module_jira
+summary: JIRA automation scripts and libraries to run on top of the BRPM Content framework
+description: JIRA automation scripts and libraries to run on top of the BRPM Content framework. See https://github.com/BMC-RLM/brpm_content for more information about the BRPM Content framework

data/lib/jira_rest_client.rb

@@ -0,0 +1,185 @@
+require 'json'
+require 'uri'
+
+#=============================================================================#
+# Jira Rest Module                                                            #
+#-----------------------------------------------------------------------------#
+# The REST module currently supports the 6.0.8 version of the Jira API as     #
+# well as a rest client which supports both HTTP and HTTPS                    #
+#=============================================================================#
+
+class JiraRestClient
+  def initialize(integration_settings = BrpmAuto.integration_settings)
+    @url = integration_settings.dns
+    @username = integration_settings.username
+    @password = integration_settings.password
+
+    @api_url = "#{@url}/rest/api/2"
+  end
+
+  # POST /rest/api/2/issue/{issueIdOrKey}/comment
+  def add_comment(issue_id, comment_body = 'Dummy Comment')
+    cmmnt = {:body => comment_body}
+    Rest.post("#{@api_url}/issue/#{issue_id}/comment", cmmnt, { :username => @username, :password => @password })["response"]
+  end
+
+  # GET /rest/api/2/issue/{issueIdOrKey}/transitions[?expand=transitions.fields]
+  def get_issue_transitions(issue_id, expand_transition = false)
+    url = "#{@api_url}/issue/#{issue_id}/transitions"
+    if expand_transition
+      url = "#{url}?expand=transitions.fields"
+    end
+    Rest.get(url, { :username => @username, :password => @password })["response"]
+  end
+
+  # GET /rest/api/2/issue/{issueIdOrKey}/transitions?transitionId={transistion_id}[&expand=transitions.fields]
+  def get_issue_transition(issue_id, transition_id, expand_transition = false)
+    url = "#{@api_url}/issue/#{issue_id}/transitions?transitionId=#{transition_id}"
+    if expand_transition
+        url = "#{url}&expand=transitions.fields"
+    end
+    Rest.get(url, { :username => @username, :password => @password })["response"]
+  end
+
+  # POST /rest/api/2/issue/{issueIdOrKey}/transitions[?expand=transitions.fields]
+  def post_issue_transition(issue_id, transition_id, comment = 'simple comment', expand_transition = false)
+    url = "#{@api_url}/issue/#{issue_id}/transitions"
+    if expand_transition
+      url = "#{url}?expand=transitions.fields"
+    end
+    transition = {:update=>{:comment =>[{:add => {:body => "#{comment}"}}]}, :transition => {:id => "#{transition_id}"}}
+    #Simple post as only return code is returned
+    Rest.post(url, transition, { :username => @username, :password => @password })["response"]
+  end
+
+  # GET /rest/api/2/project
+  def get_projects()
+    Rest.get("#{@api_url}/project", { :username => @username, :password => @password })["response"]
+  end
+
+  def set_issue_to_status(issue_id, status)
+    BrpmAuto.log "Getting the possible transitions for issue #{issue_id}..."
+    result = get_issue_transitions(issue_id)
+    transitions = result["transitions"]
+
+    transition = transitions.find { |transition| transition["to"]["name"] == status }
+
+    if transition
+      BrpmAuto.log "Issuing transition #{transition["name"]} to update the status of the issue to #{status}..."
+      issues = post_issue_transition(issue_id, transition["id"])
+    else
+      BrpmAuto.log "This ticket does not have a transition to status #{status} currently. Leaving it in its current state."
+    end
+  end
+
+  # GET /rest/api/2/search?jql=[Some Jira Query Language Search][&startAt=<num>&maxResults=<num>&fields=<field,field,...>&expand=<param,param,...>]
+  def search(jql, start_at = 0, max_results = 50, fields = '', expand = '')
+    url = "#{@api_url}/search?jql=#{jql}"
+    url = "#{url}&startAt=#{start_at}" unless start_at == 0
+    url = "#{url}&maxResults=#{max_results}" unless max_results == 50
+    url = "#{url}&fields=#{fields}" unless fields == ''
+    url = "#{url}&expand=#{expand}" unless expand == ''
+
+    Rest.get(url, { :username => @username, :password => @password })["response"]
+  end
+
+  # GET /rest/api/2/issue/{issueIdOrKey}[?fields=<field,field,...>&expand=<param,param,...>]
+  def get_issue(issue_id, fields = '', expand = '')
+    added = false
+    url = "#{@api_url}/issue/#{issue_id}"
+    if not fields.eql? ''
+      url = "#{url}?fields=#{fields}"
+      added = true
+    end
+    if not expand.eql? ''
+      if added
+        url = "#{url}&expand=#{expand}"
+      else
+        url = "#{url}?expand=#{expand}"
+      end
+    end
+    Rest.get(url, { :username => @username, :password => @password })["response"]
+  end
+
+  def get_option_for_dropdown_custom_field(custom_field_id, option_value)
+    # NOTE: this method assumes that the "Customfield Editor Plugin" is installed on the JIRA instance and that permission was granted for the custom field
+
+    url = "#{@url}/rest/jiracustomfieldeditorplugin/1.1/user/customfieldoptions/customfield_#{custom_field_id}"
+    result = Rest.get(url, { :username => @username, :password => @password })
+
+    if result["status"] == "success"
+      custom_field_options = result["response"]
+      return custom_field_options.find { |custom_field_option| custom_field_option["optionvalue"] == option_value }
+    else
+      if result["code"] == 404
+        return nil
+      else
+        raise "Error getting option: #{result["error_message"]}"
+      end
+    end
+  end
+
+  def create_option_for_dropdown_custom_field(custom_field_id, option_value)
+    # NOTE: this method assumes that the "Customfield Editor Plugin" is installed on the JIRA instance and that permission was granted for the custom field
+
+    custom_field_option = get_option_for_dropdown_custom_field(custom_field_id, option_value)
+
+    if custom_field_option
+      BrpmAuto.log "The option already exists, nothing to do."
+      return custom_field_option
+    end
+
+    url = "#{@url}/rest/jiracustomfieldeditorplugin/1.1/user/customfieldoption/customfield_#{custom_field_id}"
+    data = {:optionvalue => option_value }
+
+    result = Rest.post(url, data, { :username => @username, :password => @password })
+
+    if result["status"] == "success"
+      return result["response"]
+    else
+      raise "Could not create option: #{result["error_message"]}"
+    end
+  end
+
+  def update_option_for_dropdown_custom_field(custom_field_id, old_option_value, new_option_value)
+    # NOTE: this method assumes that the "Customfield Editor Plugin" is installed on the JIRA instance and that permission was granted for the custom field
+
+    custom_field_option_to_update = get_option_for_dropdown_custom_field(custom_field_id, old_option_value)
+
+    if custom_field_option_to_update
+      url = "#{@url}/rest/jiracustomfieldeditorplugin/1.1/user/customfieldoption/customfield_#{custom_field_id}/#{custom_field_option_to_update["id"]}"
+      data = {:optionvalue => new_option_value }
+
+      result = Rest.put(url, data, { :username => @username, :password => @password })
+
+      if result["status"] == "success"
+        return result["response"]
+      else
+        raise "Could not update option: #{result["error_message"]}"
+      end
+    else
+      BrpmAuto.log "The option doesn't exist yet, creating it instead of updating..."
+      create_option_for_dropdown_custom_field(custom_field_id, new_option_value)
+    end
+  end
+
+  def delete_option_for_dropdown_custom_field(custom_field_id, option_value)
+    # NOTE: this method assumes that the "Customfield Editor Plugin" is installed on the JIRA instance and that permission was granted for the custom field
+
+    custom_field_option_to_delete = get_option_for_dropdown_custom_field(custom_field_id, option_value)
+
+    if custom_field_option_to_delete
+      url = "#{@url}/rest/jiracustomfieldeditorplugin/1.1/user/customfieldoption/customfield_#{custom_field_id}/#{custom_field_option_to_delete["id"]}"
+
+      result = Rest.delete(url, { :username => @username, :password => @password })
+
+      if result["status"] == "success"
+        return result["response"]
+      else
+        raise "Could not delete option: #{result["error_message"]}"
+      end
+    else
+      BrpmAuto.log "The option doesn't exist, nothing to do."
+    end
+  end
+end

data/tests/create_read_update_delete_release_spec.rb

@@ -0,0 +1,39 @@
+require_relative "spec_helper"
+
+describe 'create/update/delete release' do
+  before(:all) do
+    setup_brpm_auto
+  end
+
+  before(:each) do
+    cleanup_release('JIRA tests - release 1')
+    cleanup_release('JIRA tests - release 1 - updated')
+  end
+
+  describe '' do
+    it 'should create/update/delete release in jira' do
+      params = get_default_params
+      params = params.merge(get_integration_params_for_jira)
+
+      params["release_name"] = 'JIRA tests - release 1'
+      BrpmScriptExecutor.execute_automation_script_from_gem("brpm_module_jira", "create_release", params)
+
+      option = @jira_rest_client.get_option_for_dropdown_custom_field(params["jira_release_field_id"], 'JIRA tests - release 1')
+      expect(option).not_to be_nil
+
+      params["old_release_name"] = 'JIRA tests - release 1'
+      params["new_release_name"] = 'JIRA tests - release 1 - updated'
+      BrpmScriptExecutor.execute_automation_script_from_gem("brpm_module_jira", "update_release", params)
+
+      option = @jira_rest_client.get_option_for_dropdown_custom_field(params["jira_release_field_id"], 'JIRA tests - release 1 - updated')
+      expect(option).not_to be_nil
+
+      params["release_name"] = 'JIRA tests - release 1 - updated'
+      BrpmScriptExecutor.execute_automation_script_from_gem("brpm_module_jira", "delete_release", params)
+
+      option = @jira_rest_client.get_option_for_dropdown_custom_field(params["jira_release_field_id"], 'JIRA tests - release 1 - updated')
+      expect(option).to be_nil
+    end
+  end
+end
+

data/tests/spec_helper.rb

@@ -0,0 +1,47 @@
+require 'fileutils'
+require "brpm_script_executor"
+
+def setup_brpm_auto
+  FileUtils.mkdir_p "/tmp/brpm_content"
+  create_symlink_to_gemset
+
+  BrpmAuto.setup( get_default_params.merge!(get_integration_params_for_jira) )
+
+  BrpmAuto.require_module_from_gem "brpm_module_jira"
+
+  @jira_rest_client = JiraRestClient.new
+end
+
+def get_default_params
+  params = {}
+  params['also_log_to_console'] = 'true'
+
+  params['brpm_url'] = 'http://brpm-content.pulsar-it.be:8088/brpm'
+  params['brpm_api_token'] = ENV["BRPM_API_TOKEN"]
+
+  params['output_dir'] = "/tmp/brpm_content"
+
+  params
+end
+
+def get_integration_params_for_jira
+  params = {}
+  params["SS_integration_dns"] = 'http://brpm.pulsar-it.be:9090'
+  params["SS_integration_username"] = 'brpm'
+  params["SS_integration_password"] = ENV["JIRA_PASSWORD"]
+
+  params["jira_release_field_id"] = '10000'
+
+  params
+end
+
+def cleanup_release(release_name)
+  @jira_rest_client.delete_option_for_dropdown_custom_field('10000', release_name)
+end
+
+def create_symlink_to_gemset
+  module_name = File.basename(File.expand_path("#{File.dirname(__FILE__)}/.."))
+  symlink = "#{ENV["GEM_HOME"]}/gems/#{module_name}-999.0.0"
+  FileUtils.rm(symlink) if File.exists?(symlink)
+  FileUtils.ln_s(File.expand_path("#{File.dirname(__FILE__)}/.."), symlink)
+end

data/tests/transition_issue_spec.rb

@@ -0,0 +1,32 @@
+require_relative "spec_helper"
+
+describe 'transition issue' do
+  before(:all) do
+    setup_brpm_auto
+  end
+
+  before(:each) do
+  end
+
+  describe '' do
+    it 'transition an issue in JIRA' do
+      params = get_default_params
+      params = params.merge(get_integration_params_for_jira)
+
+      params["issue_id"] = "EF-25"
+
+      params["target_issue_status"] = "Done"
+      BrpmScriptExecutor.execute_automation_script_from_gem("brpm_module_jira", "transition_issue", params)
+
+      params["target_issue_status"] = "To Do"
+      BrpmScriptExecutor.execute_automation_script_from_gem("brpm_module_jira", "transition_issue", params)
+
+      params["target_issue_status"] = "In development"
+      BrpmScriptExecutor.execute_automation_script_from_gem("brpm_module_jira", "transition_issue", params)
+
+      params["target_issue_status"] = "Deployed to development"
+      BrpmScriptExecutor.execute_automation_script_from_gem("brpm_module_jira", "transition_issue", params)
+    end
+  end
+end
+

metadata

@@ -0,0 +1,128 @@
+--- !ruby/object:Gem::Specification
+name: brpm_module_jira
+version: !ruby/object:Gem::Version
+  version: 0.1.3
+platform: ruby
+authors:
+- Niek Bartholomeus
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-07-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: brpm_content
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.1.10
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.1.10
+- !ruby/object:Gem::Dependency
+  name: brpm_module_brpm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  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: rspec
+  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: JIRA automation scripts and libraries to run on top of the BRPM Content
+  framework. See https://github.com/BMC-RLM/brpm_content for more information about
+  the BRPM Content framework
+email: niek.bartholomeus@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .ruby-version
+- .travis.yml
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- automations/add_comment.rb
+- automations/add_comment.txt
+- automations/create_release.rb
+- automations/create_release.txt
+- automations/delete_release.rb
+- automations/delete_release.txt
+- automations/transition_issue.rb
+- automations/transition_issue.txt
+- automations/transition_issues_for_request.rb
+- automations/transition_issues_for_request.txt
+- automations/transition_issues_for_run.rb
+- automations/transition_issues_for_run.txt
+- automations/update_release.rb
+- automations/update_release.txt
+- brpm_module_jira.gemspec
+- config.yml
+- lib/jira_rest_client.rb
+- tests/create_read_update_delete_release_spec.rb
+- tests/spec_helper.rb
+- tests/transition_issue_spec.rb
+homepage: https://github.com/BMC-RLM/brpm_module_jira
+licenses:
+- GNU General Public License v2.0
+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.1.9
+signing_key: 
+specification_version: 4
+summary: JIRA automation scripts and libraries to run on top of the BRPM Content framework
+test_files: []