samanage 1.4

data/README.md

@@ -0,0 +1 @@
+# samanage-ruby

data/lib/samanage.rb

@@ -0,0 +1,15 @@
+require 'http'
+
+require_relative 'samanage/api'
+require_relative 'samanage/api/users'
+require_relative 'samanage/api/requester'
+require_relative 'samanage/api/hardwares'
+require_relative 'samanage/api/other_assets'
+require_relative 'samanage/api/incidents'
+require_relative 'samanage/api/custom_fields'
+require_relative 'samanage/api/custom_forms'
+require_relative 'samanage/error'
+require_relative 'samanage/url_builder'
+module Samanage
+
+end

data/lib/samanage/api.rb

@@ -0,0 +1,83 @@
+module Samanage
+	class Api
+		PATHS = {
+			hardware: 'hardwares.json',
+			user: 'users.json',
+			incident: 'incidents.json',
+			other_asset: 'other_assets.json',
+			custom_fields: 'custom_fields.json',
+			custom_forms: 'custom_forms.json',
+		}
+		attr_accessor :datacenter, :content_type, :base_url, :token, :custom_forms
+		def initialize(token: , dacenter: '', development_mode: false)
+			self.token = token
+			self.datacenter = nil || datacenter
+			self.base_url = "https://api#{datacenter}.samanage.com/"
+			# self.content_type = content_type || 'json'
+			self.content_type = 'json'
+			self.authorize
+			if development_mode
+				self.custom_forms = self.organize_forms
+			end
+		end
+
+		def authorize
+			 self.execute(path: 'api.json')
+		end
+
+		# Defaults to GET
+		def execute(http_method: 'get', path: , payload: nil, verbose: nil)
+			unless verbose.nil?
+				verbose = '?layout=long'
+			end
+
+			api_call = HTTP.headers(
+				'Accept' => "application/vnd.samanage.v2.0+#{self.content_type}#{verbose}",
+				'Content-type'  => "application/#{self.content_type}",
+				'X-Samanage-Authorization' => 'Bearer ' + self.token
+			)
+			api_call = api_call.public_send(http_method.to_sym, self.base_url + Addressable::URI.encode_component(path, Addressable::URI::CharacterClasses::QUERY).gsub('+',"%2B"), :body => payload)
+			response = Hash.new
+			response[:code] = api_call.code.to_i
+			response[:json] = api_call.body
+			response[:response] = api_call
+			response[:headers] = api_call.headers
+			response[:total_pages] = api_call.headers['X-Total-Pages'].to_i
+			response[:total_pages] = 1 if response[:total_pages] == 0
+			response[:total_count] = api_call.headers['X-Total-Count'].to_i
+			response[:total_count] = 1 if response[:total_count] == 0
+
+			# puts "Body Class: #{api_call.body.class}"
+			# puts "#{api_call.body}"
+			# Raise error if not Authentication or 200,201  == Success,Okay
+			# Error cases
+			case response[:code]
+			when 200..201
+				response[:data] = JSON.parse(api_call.body)
+				response
+			when 401
+				response[:data] = api_call.body
+				error = response[:response]
+				puts "Returned 401: #{error}"
+				raise Samanage::AuthorizationError.new(error: error,response: response)
+			when 404
+				response[:data] = api_call.body
+				error = response[:response]
+				puts "Returned 404: #{error}"
+				raise Samanage::NotFound.new(error: error, response: response)
+			when 422
+				response[:data] = api_call.body
+				error = response[:response]
+				puts "Returned 422: #{error}"
+				raise Samanage::InvalidRequest.new(error: error, response: response)
+			else
+				response[:data] = api_call.body
+				error = response[:response]
+				puts "Returned #{response[:code]}: #{error}"
+				raise Samanage::InvalidRequest.new(error: error, response: response)
+			end
+		# Always return response hash
+		response
+		end
+	end
+end

data/lib/samanage/api/custom_fields.rb

@@ -0,0 +1,20 @@
+module Samanage
+	class Api
+		def get_custom_fields(path: PATHS[:custom_fields], options:{})
+			url = Samanage::UrlBuilder.new(path: path, options: options).url
+			api_call = self.execute(path: url)
+			api_call
+		end
+		def collect_custom_fields
+			page = 1
+			custom_fields = Array.new
+			total_pages = self.get_custom_fields[:total_pages] ||= 2
+			while page <= total_pages
+				api_call = self.execute(path: "custom_fields.json")
+				custom_fields += api_call[:data]
+				page += 1
+			end
+			custom_fields
+		end
+	end
+end

data/lib/samanage/api/custom_forms.rb

@@ -0,0 +1,41 @@
+module Samanage
+	class Api
+		def get_custom_forms(path: PATHS[:custom_forms], options: {})
+			url = Samanage::UrlBuilder.new(path: path, options: options).url
+			api_call = self.execute(path: url)
+			api_call
+		end
+
+		def collect_custom_forms
+			page = 1
+			custom_forms = Array.new
+			total_pages = self.get_custom_forms[:total_pages]
+			# puts api_call
+			while page <= total_pages
+				api_call = self.execute(http_method: 'get', path: "custom_forms.json?page=#{page}")
+				custom_forms += api_call[:data]
+				page += 1
+			end
+			custom_forms
+		end
+
+		def organize_forms
+			custom_forms = self.collect_custom_forms
+			custom_forms.map{|form| form.delete_if{|k, v| v.nil?}}
+			custom_forms.map{|form| form['custom_form_fields'].map{|fields| fields.delete_if{|k, v| v == false}}}
+			custom_forms.map{|form| form['custom_form_fields'].map{|fields| fields['custom_field'].delete_if{|k, v| !v}}}
+			custom_forms.group_by{|k|
+				k['module']}.each_pair{|forms_name, forms|
+					forms.each{|form|
+						form['custom_form_fields'].group_by{|f| f['name'] }
+					}
+				}
+		end
+		def form_for(object_type: )
+			if self.custom_forms == nil
+				self.custom_forms = self.organize_forms
+			end
+			self.custom_forms[object_type]
+		end
+	end
+end

data/lib/samanage/api/hardwares.rb

@@ -0,0 +1,47 @@
+module Samanage
+	class Api
+		def get_hardwares(path: PATHS[:hardware], options: {})
+			url = Samanage::UrlBuilder.new(path: path, options: options).url
+			api_call = self.execute(path: url)
+			api_call
+		end
+
+		def collect_hardwares
+			page = 1
+			hardwares = Array.new
+			total_pages = self.get_hardwares[:total_pages]
+			# puts api_call
+			while page <= total_pages
+				api_call = self.execute(http_method: 'get', path: "hardwares.json?page=#{page}")
+				hardwares += api_call[:data]
+				page += 1
+			end
+			hardwares
+		end
+
+		def create_hardware(payload: , options: {})
+			api_call = self.execute(path: PATHS[:hardware], http_method: 'post', payload: payload)
+			api_call
+		end
+
+		def find_hardware(id: )
+			path = "hardwares/#{id}.json"
+			api_call = self.execute(path: path)
+			api_call
+		end
+
+		def check_hardware(options: {})
+			url = Samanage::UrlBuilder.new(path: PATHS[:hardware], options: options).url
+			puts "Url: #{url}"
+			api_call = self.execute(path: url)
+			api_call
+		end
+
+
+		def update_hardware(payload:, id:, options: {})
+			path = "hardwares/#{id}.json"
+			api_call = self.execute(path: path, http_method: 'put', payload: payload)
+			api_call
+		end
+	end
+end

data/lib/samanage/api/incidents.rb

@@ -0,0 +1,39 @@
+module Samanage
+	class Api
+		def get_incidents(path: PATHS[:incident], options: {})
+			url = Samanage::UrlBuilder.new(path: path, options: options).url
+			api_call = self.execute(path: url)
+			api_call
+		end
+
+		def collect_incidents
+			page = 1
+			incidents = Array.new
+			total_pages = self.get_incidents[:total_pages]
+			# puts api_call
+			while page <= total_pages
+				api_call = self.execute(http_method: 'get', path: "incidents.json?page=#{page}")
+				incidents += api_call[:data]
+				page += 1
+			end
+			incidents
+		end
+
+		def create_incident(payload: , options: {})
+			api_call = self.execute(path: PATHS[:incident], http_method: 'post', payload: payload)
+			api_call
+		end
+
+		def find_incident(id: )
+			path = "incidents/#{id}.json"
+			api_call = self.execute(path: path)
+			api_call
+		end
+
+		def update_incident(payload:, id:, options: {})
+			path = "incidents/#{id}.json"
+			api_call = self.execute(path: path, http_method: 'put', payload: payload)
+			api_call
+		end
+	end
+end

data/lib/samanage/api/other_assets.rb

@@ -0,0 +1,40 @@
+module Samanage
+	class Api
+		def get_other_assets(path: PATHS[:other_asset], options: {})
+			url = Samanage::UrlBuilder.new(path: path, options: options).url
+			api_call = self.execute(path: url)
+			api_call
+		end
+
+		def collect_other_assets
+			page = 1
+			other_assets = Array.new
+			total_pages = self.get_other_assets[:total_pages]
+			# puts api_call
+			other_assets = []
+			while page <= total_pages
+				api_call = self.execute(http_method: 'get', path: "other_assets.json?page=#{page}")
+				other_assets += api_call[:data]
+				page += 1
+			end
+			other_assets.uniq
+		end
+
+		def create_other_asset(payload: , options: {})
+			api_call = self.execute(path: PATHS[:other_asset], http_method: 'post', payload: payload)
+			api_call
+		end
+
+		def find_other_asset(id: )
+			path = "other_assets/#{id}.json"
+			api_call = self.execute(path: path)
+			api_call
+		end
+
+		def update_other_asset(payload:, id:, options: {})
+			path = "other_assets/#{id}.json"
+			api_call = self.execute(path: path, http_method: 'put', payload: payload)
+			api_call
+		end
+	end
+end

data/lib/samanage/api/requester.rb

@@ -0,0 +1,9 @@
+module Samanage
+	class Api
+		def get_requester_id(value: )
+			api_call = self.execute(path: "requesters.json?name=#{value}")
+			requester = api_call[:data].size == 1 ? api_call[:data][0] : nil
+			requester
+		end
+	end
+end

data/lib/samanage/api/users.rb

@@ -0,0 +1,48 @@
+module Samanage
+	class Api
+		# Returns all users in the account
+
+		def get_users(path: PATHS[:user], options: {})
+			url = Samanage::UrlBuilder.new(path: path, options: options).url
+			api_call = self.execute(path: url)
+			api_call
+		end
+
+		def collect_users
+			page = 1
+			users = Array.new
+			total_pages = self.get_users[:total_pages]
+			# puts api_call
+			while page <= total_pages
+				api_call = self.execute(http_method: 'get', path: "users.json?page=#{page}")
+				users += api_call[:data]
+				page += 1
+			end
+			users
+		end
+
+		def create_user(payload: , options: {})
+			api_call = self.execute(path: PATHS[:user], http_method: 'post', payload: payload)
+			api_call
+		end
+
+		def find_user(id: )
+			path = "users/#{id}.json"
+			api_call = self.execute(path: path)
+			api_call
+		end
+
+		def check_user(field: 'email', value: )
+			url = "users.json?#{field}=#{value}"
+			api_call = self.execute(path: url)
+			api_call
+		end
+
+		def update_user(payload:, id:)
+			path = "users/#{id}.json"
+			puts "Path: #{path}"
+			api_call = self.execute(path: path, http_method: 'put', payload: payload)
+			api_call
+		end
+	end
+end

data/lib/samanage/error.rb

@@ -0,0 +1,21 @@
+module Samanage
+	class Error < StandardError
+		attr_accessor :status_code, :response, :error
+		def initialize(error: , response: {})
+			self.status_code = response[:code]
+			self.response = response[:data] ||= response[:response]
+			self.error = error
+			puts "Response: #{self.status_code}: #{self.response}"
+		end
+
+	end
+
+	class AuthorizationError < Error
+	end
+
+	class InvalidRequest < Error
+	end
+
+	class NotFound < Error
+	end
+end

data/lib/samanage/url_builder.rb

@@ -0,0 +1,49 @@
+module Samanage
+	class UrlBuilder
+		attr_accessor :url
+		@url = ''
+		def initialize(path: ,options: nil)
+			self.url =  map_path(path, options)
+			return url
+		end
+
+
+		def map_path(path, options)
+			url = String.new
+			parameters = String.new
+			case path.to_s
+			when /user/
+				url += 'users'
+			when /hardware/
+				url += 'hardwares'
+			when /other_asset/
+				url += 'other_assets'
+			when /incident/
+				url += 'incidents'
+			when /change/
+				url += 'changes'
+			when /custom_field/
+				url += 'custom_fields'
+			when /custom_form/
+				url += 'custom_forms'
+			end
+
+			if path.match(/(\d)+/)
+				url += "/" + path.match(/(\d)+/)[0] + ".json"
+				return url
+			end
+
+			options.each_pair do |field, value|
+				if field.to_s == 'id' && value.to_s.match(/(\d)+/)
+					url += "/#{value}.json"
+					# Return. Filters not valid on an id
+					return url
+				end
+				sub_param = "?#{field}=#{value}"
+				parameters += sub_param + '&'
+			end
+			url += ".json" + parameters
+			return url
+		end
+	end
+end

data/lib/test.rb

@@ -0,0 +1,4 @@
+require_relative 'samanage'
+# require 'awesome_print'
+
+api_controller = Samanage::Api.new(token: ENV['SAMANAGE_TEST_API_TOKEN'],  development_mode: true)

data/samanage.gemspec

@@ -0,0 +1,13 @@
+Gem::Specification.new do |s|
+  s.name        = 'samanage'
+  s.version     = '1.4'
+  s.date        = '2017-01-01'
+  s.summary     = "Samanage Ruby Gem"
+  s.description = "Connect to Samanage using Ruby!"
+  s.authors     = ["Chris Walls"]
+  s.email       = 'chris.walls@samanage.com'
+  s.files       = `git ls-files`.split("\n")
+  s.require_paths = ["lib"]
+  s.homepage    = 'http://rubygems.org/gems/samanage'
+  s.license     = 'MIT'
+end