Initial Redmine tooling and local plugin forks
This commit is contained in:
Jason Thistlethwaite
@@ -0,0 +1,166 @@
|
||||
#!/usr/bin/env ruby
|
||||
# Redmine - project management software
|
||||
# Copyright (C) 2006-2015 Jean-Philippe Lang
|
||||
#
|
||||
# This program is free software; you can redistribute it and/or
|
||||
# modify it under the terms of the GNU General Public License
|
||||
# as published by the Free Software Foundation; either version 2
|
||||
# of the License, or (at your option) any later version.
|
||||
#
|
||||
# This program is distributed in the hope that it will be useful,
|
||||
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
# GNU General Public License for more details.
|
||||
#
|
||||
# You should have received a copy of the GNU General Public License
|
||||
# along with this program; if not, write to the Free Software
|
||||
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
||||
|
||||
require 'net/http'
|
||||
require 'net/https'
|
||||
require 'uri'
|
||||
require 'optparse'
|
||||
|
||||
module Net
|
||||
class HTTPS < HTTP
|
||||
def self.post_form(url, params, headers, options={})
|
||||
request = Post.new(url.path)
|
||||
request.form_data = params
|
||||
request.initialize_http_header(headers)
|
||||
request.basic_auth url.user, url.password if url.user
|
||||
http = new(url.host, url.port)
|
||||
http.use_ssl = (url.scheme == 'https')
|
||||
if options[:certificate_bundle]
|
||||
http.ca_file = options[:certificate_bundle]
|
||||
end
|
||||
if options[:no_check_certificate]
|
||||
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
|
||||
end
|
||||
http.start {|h| h.request(request) }
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
class RedmineMailHandler
|
||||
VERSION = '0.2'
|
||||
|
||||
attr_accessor :verbose, :issue_attributes, :allow_override, :unknown_user, :default_group, :no_permission_check,
|
||||
:url, :key, :no_check_certificate, :certificate_bundle, :no_account_notice, :no_notification
|
||||
|
||||
def initialize
|
||||
self.issue_attributes = {}
|
||||
|
||||
optparse = OptionParser.new do |opts|
|
||||
opts.banner = "Usage: rdm-mailhandler.rb [options] --url=<Redmine URL> --key=<API key>"
|
||||
opts.separator("")
|
||||
opts.separator("Reads an email from standard input and forwards it to a Redmine server through a HTTP request.")
|
||||
opts.separator("")
|
||||
opts.separator("Required arguments:")
|
||||
opts.on("-u", "--url URL", "URL of the Redmine server") {|v| self.url = v}
|
||||
opts.on("-k", "--key KEY", "Redmine API key") {|v| self.key = v}
|
||||
opts.separator("")
|
||||
opts.separator("General options:")
|
||||
opts.on("--key-file FILE", "full path to a file that contains your Redmine",
|
||||
"API key (use this option instead of --key if",
|
||||
"you don't want the key to appear in the command",
|
||||
"line)") {|v| read_key_from_file(v)}
|
||||
opts.on("--no-check-certificate", "do not check server certificate") {self.no_check_certificate = true}
|
||||
opts.on("--certificate-bundle FILE", "certificate bundle to use") {|v| self.certificate_bundle = v}
|
||||
opts.on("-h", "--help", "show this help") {puts opts; exit 1}
|
||||
opts.on("-v", "--verbose", "show extra information") {self.verbose = true}
|
||||
opts.on("-V", "--version", "show version information and exit") {puts VERSION; exit}
|
||||
opts.separator("")
|
||||
opts.separator("Ticket attributes control options:")
|
||||
opts.on("-p", "--project PROJECT", "identifier of the target project") {|v| self.issue_attributes['project'] = v}
|
||||
opts.on("-s", "--status STATUS", "name of the target status") {|v| self.issue_attributes['status'] = v}
|
||||
opts.on("-t", "--tracker TRACKER", "name of the target tracker") {|v| self.issue_attributes['tracker'] = v}
|
||||
opts.on( "--category CATEGORY", "name of the target category") {|v| self.issue_attributes['category'] = v}
|
||||
opts.on( "--priority PRIORITY", "name of the target priority") {|v| self.issue_attributes['priority'] = v}
|
||||
opts.on( "--private", "create new ticket as private") {|v| self.issue_attributes['is_private'] = '1'}
|
||||
opts.on( "--due-date DUE_DATE", "due date for ticket") {|v| self.issue_attributes['due_date'] = v}
|
||||
opts.on( "--assigned_to ASSIGNED_LOGIN", "assigned user login") {|v| self.issue_attributes['assigned_to'] = v}
|
||||
opts.on("-o", "--allow-override ATTRS", "allow email content to override attributes",
|
||||
"specified by previous options",
|
||||
"ATTRS is a comma separated list of attributes") {|v| self.allow_override = v}
|
||||
|
||||
opts.separator("")
|
||||
opts.separator("Example:")
|
||||
opts.separator(" rdm-helpdesk-mailhandler.rb --url http://redmine.domain.foo --key secret --project test-project\\")
|
||||
opts.separator(" --category foo \\")
|
||||
opts.separator(" --tracker bug \\")
|
||||
opts.separator(" --allow-override tracker,project")
|
||||
|
||||
opts.summary_width = 27
|
||||
end
|
||||
optparse.parse!
|
||||
|
||||
unless url && key
|
||||
puts "Some arguments are missing. Use `rdm-mailhandler.rb --help` for getting help."
|
||||
exit 1
|
||||
end
|
||||
end
|
||||
|
||||
def submit(email)
|
||||
uri = url.gsub(%r{/*$}, '') + '/helpdesk_mailer'
|
||||
|
||||
headers = { 'User-Agent' => "Redmine helpdesk mail handler/#{VERSION}" }
|
||||
|
||||
data = { 'key' => key, 'email' => email,
|
||||
'allow_override' => allow_override,
|
||||
'unknown_user' => unknown_user,
|
||||
'default_group' => default_group,
|
||||
'no_account_notice' => no_account_notice,
|
||||
'no_notification' => no_notification,
|
||||
'no_permission_check' => no_permission_check}
|
||||
issue_attributes.each { |attr, value| data["issue[#{attr}]"] = value }
|
||||
|
||||
debug "Posting to #{uri}..."
|
||||
begin
|
||||
response = Net::HTTPS.post_form(URI.parse(uri), data, headers, :no_check_certificate => no_check_certificate, :certificate_bundle => certificate_bundle)
|
||||
rescue SystemCallError, IOError => e # connection refused, etc.
|
||||
warn "An error occured while contacting your Redmine server: #{e.message}"
|
||||
return 75 # temporary failure
|
||||
end
|
||||
debug "Response received: #{response.code}"
|
||||
|
||||
case response.code.to_i
|
||||
when 403
|
||||
warn "Request was denied by your Redmine server. " +
|
||||
"Make sure that 'WS for incoming emails' is enabled in application settings and that you provided the correct API key."
|
||||
return 77
|
||||
when 422
|
||||
warn "Request was denied by your Redmine server. " +
|
||||
"Possible reasons: email is sent from an invalid email address or is missing some information."
|
||||
return 77
|
||||
when 400..499
|
||||
warn "Request was denied by your Redmine server (#{response.code})."
|
||||
return 77
|
||||
when 500..599
|
||||
warn "Failed to contact your Redmine server (#{response.code})."
|
||||
return 75
|
||||
when 201
|
||||
debug "Proccessed successfully"
|
||||
return 0
|
||||
else
|
||||
return 1
|
||||
end
|
||||
end
|
||||
|
||||
private
|
||||
|
||||
def debug(msg)
|
||||
puts msg if verbose
|
||||
end
|
||||
|
||||
def read_key_from_file(filename)
|
||||
begin
|
||||
self.key = File.read(filename).strip
|
||||
rescue Exception => e
|
||||
$stderr.puts "Unable to read the key from #{filename}:\n#{e.message}"
|
||||
exit 1
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
handler = RedmineMailHandler.new
|
||||
exit(handler.submit(STDIN.read))
|
||||
Reference in New Issue
Block a user