pagerduty-sdk 1.0.0

data/lib/pagerduty/pagerduty.rb

@@ -0,0 +1,366 @@
+
+class Pagerduty
+
+  attr_reader :token
+  attr_reader :subdomain
+
+  def initialize(options)
+    @@token = options[:token]
+    @@subdomain = options[:subdomain]
+  end
+
+  ###################################################################################
+  # def curl
+  #
+  # Purpose: Performs a CURL request
+  #
+  # Params: options<~Hash> - The options Hash to send
+  #           uri<~String> - The URI to curl
+  #           ssl<~Boolean><Optional> - Whether or not to use SSL
+  #           port<~Integer><Optional> - The port number to connect to
+  #           params<~Hash><Optional> - The params to send in the curl request
+  #           headers<~Hash><Optional> - The headers to send in the curl request
+  #           method<~String> - The HTTP method to perform
+  #           basic_auth<~Hash><Optional>
+  #             user<~String> - Basic auth user
+  #             password<~String> - Basic auth password
+  #
+  # Returns: <String>
+  ###################################################################################
+  def curl(options)
+
+    curl_request = {
+      ssl: true,
+      port: 443,
+      headers: {
+        "Content-Type" => "application/json",
+        "Authorization" => "Token token=#@@token",
+      },
+    }
+
+    options.merge! curl_request
+
+    url = URI.parse(options[:uri])
+
+    if options[:params]
+      parameters = options[:params].map { |k,v| "#{k}=#{v}" }.join("&")
+      url += "?#{parameters}"
+    end
+
+    http = Net::HTTP.new(url.host, 443)
+    http.use_ssl = true
+
+    request = case options[:method]
+              when 'DELETE'
+                Net::HTTP::Delete.new(url)
+              when 'GET'
+                Net::HTTP::Get.new(url)
+              when 'POST'
+                Net::HTTP::Post.new(url)
+              when 'PUT'
+                Net::HTTP::Put.new(url)
+              end
+
+    if options.has_key?(:data)
+      request.set_form_data(options[:data])
+    end
+
+    if options.has_key?(:basic_auth)
+      request.basic_auth options[:basic_auth][:user], options[:basic_auth][:password]
+    end
+
+    request.body = options[:body]
+
+    options[:headers].each { |key,val| request.add_field(key,val) }
+
+    if options[:method] == 'POST'
+      http.post(url.path,options[:data].to_json,options[:headers])
+    elsif options[:method] == 'PUT'
+      http.put(url.path,options[:data].to_json,options[:headers])
+    else
+      http.request(request)
+    end
+  end
+
+  def has_requirements?(keys,options)
+    (keys - options.keys).empty?
+  end
+
+  def alerts(options={})
+
+    unless has_requirements? [:since, :until], options
+      puts "#> This function requires arguments :since, :until"
+      puts "Please see: http://developer.pagerduty.com/documentation/rest/alerts/list"
+      return
+    end
+
+    JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/alerts",
+      params: options,
+      method: 'GET'
+    }).body)['alerts'].inject([]) { |alerts, alert|
+      alerts << Alert.new(alert)
+    }
+
+  end
+
+  def escalation_policies(options={})
+    JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/escalation_policies",
+      params: { 'query' => options[:query] },
+      method: 'GET'
+    }).body)['escalation_policies'].inject([]) { |policies, policy|
+      policies << EscalationPolicy.new(policy)
+    }
+  end
+
+  def create_escalation_policy(options={})
+
+    if options[:escalation_rules]
+      options[:escalation_rules] = options[:escalation_rules].map { |rule| 
+        rule.class == EscalationRule ? rule.hashify : rule
+      }
+    end
+
+    EscalationPolicy.new(JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/escalation_policies",
+      data: options,
+      method: 'POST'
+    }).body)['escalation_policy'])
+
+  end
+
+  def get_escalation_policy(options={})
+    EscalationPolicy.new(JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/escalation_policies/#{options[:id]}",
+      method: 'GET'
+    }).body)['escalation_policy'])
+  end
+
+  def escalation_rules(options)
+    JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/escalation_policies/#{options[:escalation_policy_id]}/escalation_rules",
+      params: { 'query' => options[:query] },
+      method: 'GET'
+    }).body)['escalation_rules'].inject([]) { |rules, rule|
+      rules << EscalationRule.new(rule)
+    }
+  end
+
+  def get_escalation_rule(options={})
+    JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/escalation_policies/#{options[:escalation_policy_id]}/escalation_rules/#{options[:rule_id]}",
+      method: 'GET'
+    }).body)
+  end
+
+  # Retrieve all incidents
+  #
+  # ==== Parameters
+  #
+  # * params<~Hash>
+  #   * 'since'<~String>: The start of the date range over which to search
+  #   * 'until'<~String>: The end of the date range over which to search
+  #   * 'date_range'<~String>: When set to 'all' the 'since' and 'until' params are ignored. Use this to get all incidents since the account was created
+  #   * 'fields'<~String>: Used to restrict the properties of each incident returned to a set of pre-defined fields. If omitted, returned incidents have all fields present. See below for a list of possible fields.
+  #   * 'status'<~String>: Returns only the incidents currently in the passed status(es). Valid status options are triggered, acknowledged, and resolved. More status codes may be introduced in the future.
+  #   * 'incident_key'<~String>: Returns only the incidents with the passed de-duplication key. See the PagerDuty Integration API docs for further details.
+  #   * 'service'<~String>: Returns only the incidents associated with the passed service(s). This expects one or more service IDs. Separate multiple IDs by commas.
+  #   * 'assigned_to_user'<~String>: Returns only the incidents currently assigned to the passed user(s). This expects one or more user IDs. Please see below for more info on how to find your users' IDs. When using the assigned_to_user filter, you will only receive incidents with statuses of triggered or acknowledged. This is because resolved incidents are not assigned to any user.
+  #   * 'time_zone'<~String>: Time zone in which dates in the result will be rendered. Defaults to UTC.
+  #   * 'sort_by'<~String>: Used to specify both the field you wish to sort the results on, as well as the direction  See API doc for examples.
+  #
+  # ==== Returns
+  # * response<~Array>:
+  #   * <~Pagerduty::Incident>:
+  #     * 'id'<~String> - Id of request
+  #     * 'incident_number'<~String>:
+  #     * 'created_on'<~String>:
+  #     * 'status'<~String>:
+  #     * 'html_url'<~String>:
+  #     * 'incident_key'<~String>:
+  #     * 'service'<~Pagerduty::Service>
+  #       * 'id'<~String>:
+  #       * 'name'<~String>:
+  #       * 'html_url'<~String>:
+  #       * 'deleted_at'<~String>:
+  #     * 'escalation_policy'<~String>:
+  #     * 'assigned_to_user'<~String>:
+  #     * 'trigger_summary_data'<~String>:
+  #     * 'trigger_details_html_url'<~String>:
+  #     * 'trigger_type'<~String>:
+  #     * 'last_status_change_on'<~String>:
+  #     * 'last_status_change_by'<~Pagerduty::User>:
+  #       * 'id'<~String>:
+  #       * 'name'<~String>:
+  #       * 'email'<~String>:
+  #       * 'html_url'<~String>:
+  #     * 'number_of_escalations'<~Integer>:
+  #     * 'resolved_by_user'<~Pagerduty::ResolvedByUser>:
+  #       * 'id'<~String>:
+  #       * 'name'<~String>:
+  #       * 'email'<~String>:
+  #       * 'html_url'<~String>:
+  #
+  # {Pagerduty API Reference}[http://developer.pagerduty.com/documentation/rest/incidents/list]
+  def incidents(options={})
+    JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/incidents",
+      params: {
+        since: options[:since] || (Time.now - 1.day).strftime("%Y-%m-%d"),
+        :until => options[:until] || (Time.now + 1.day).strftime("%Y-%m-%d"),
+      },
+      method: 'GET'
+    }).body)['incidents'].inject([]) { |incidents, incident|
+      incidents << Incident.new(incident)
+    }
+  end
+
+  def get_incident(options={})
+    incidents.detect { |incident| incident.id == options[:id] } || 'No results'
+  end
+
+  def get_incident_counts(options={})
+    JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/incidents/count",
+      params: options,
+      method: 'GET',
+    }).body)
+  end
+
+  def get_users(options={})
+    Users.new(JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/users",
+      params: { query: options[:query] },
+      method: 'GET'
+    }).body))
+  end
+
+  def get_user(options={})
+    get_users.users.detect { |user| user.id == options[:id] }
+  end
+
+  def create_user(options={})
+    User.new(JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/users",
+      data: options,
+      method: 'POST'
+    }).body)['user'])
+  end
+
+  def notes(id)
+    JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/incidents/#{id}/notes",
+      method: 'GET'
+    }).body)['notes'].inject([]) { |notes, note|
+      notes << Note.new(note)
+    }
+  end
+
+  def get_log_entries(options={})
+    LogEntries.new(JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/log_entries",
+      params: options,
+      method: 'GET'
+    }).body))
+  end
+
+  def get_log_entry(options={})
+    LogEntry.new(JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/log_entries/#{options[:id]}",
+      params: options,
+      method: 'GET'
+    }).body)['log_entry'])
+  end
+
+  def alerts_per_time(options={})
+    Pagerduty::Reports::Alerts.new(JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/reports/alerts_per_time",
+      params: options,
+      method: 'GET'
+    }).body))
+  end
+
+  def incidents_per_time(options={})
+    Pagerduty::Reports::Incidents.new(JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/reports/incidents_per_time/",
+      params: options,
+      method: 'GET'
+    }).body))
+  end
+
+  def get_maintenance_windows(options={})
+    Pagerduty::MaintenanceWindows.new(JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/maintenance_windows",
+      params: options,
+      method: 'GET'
+    }).body))
+  end
+
+  def get_maintenance_window(options={})
+    Pagerduty::MaintenanceWindow.new(JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/maintenance_windows/#{options[:id]}",
+      params: options,
+      method: 'GET'
+    }).body)['maintenance_window'])
+  end
+
+  def create_maintenance_window(options={})
+    Pagerduty::MaintenanceWindow.new(JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/maintenance_windows",
+      data: options,
+      method: 'POST'
+    }).body)['maintenance_window'])
+  end
+
+  def get_schedules(options={})
+    Pagerduty::Schedules.new(JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/schedules",
+      params: options,
+      method: 'GET'
+    }).body))
+  end
+
+  def get_schedule(options={})
+    Pagerduty::ScheduleInfo.new(JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/schedules/#{options[:id]}",
+      params: options,
+      method: 'GET'
+     }).body)['schedule'])
+  end
+
+  def get_schedule_users(options={})
+    JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/schedules/#{options[:id]}/users",
+      params: options,
+      method: 'GET'
+    }).body)['users'].inject([]) { |users, user|
+      users << Pagerduty::User.new(user)
+    }
+  end
+
+  def get_services(options={})
+    Pagerduty::Services.new(JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/services",
+      params: options,
+      method: 'GET'
+    }).body))
+  end
+
+  def get_service(options={})
+    Pagerduty::Services::Objects::Service.new(JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/services/#{options[:id]}",
+      params: options,
+      method: 'GET'
+    }).body)['service'])
+  end
+
+  def create_service(options={})
+    Pagerduty::Services::Objects::Service.new(JSON.parse(curl({
+      uri: "https://#@@subdomain.pagerduty.com/api/v1/services",
+      data: { service: options },
+      method: 'POST'
+    }).body)['service'])
+  end
+
+end

data/lib/pagerduty.rb

@@ -0,0 +1,31 @@
+__LIB_DIR__ = File.expand_path(File.dirname(__FILE__))
+$LOAD_PATH.unshift __LIB_DIR__ unless $LOAD_PATH.include?(__LIB_DIR__)
+
+require 'active_support/all'
+require 'json'
+require 'net/http'
+require 'net/https'
+require 'uri'
+require 'virtus'
+
+require 'pagerduty/core'
+require 'pagerduty/pagerduty'
+require 'pagerduty/models/report'
+require 'pagerduty/models/agent'
+require 'pagerduty/models/assigneduser'
+require 'pagerduty/models/laststatuschangeby'
+require 'pagerduty/models/resolvedbyuser'
+require 'pagerduty/models/service'
+require 'pagerduty/models/escalationpolicies'
+require 'pagerduty/models/triggersummarydata'
+require 'pagerduty/models/user'
+require 'pagerduty/models/schedule'
+require 'pagerduty/models/maintenance_window'
+require 'pagerduty/models/notification'
+require 'pagerduty/models/log_entry'
+require 'pagerduty/models/channels'
+require 'pagerduty/models/alert'
+require 'pagerduty/models/note'
+require 'pagerduty/models/incident'
+require 'pagerduty/models/services'
+

data/pagerduty-sdk.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'pagerduty/pagerduty'
+
+Gem::Specification.new do |gem|
+  gem.name          = "pagerduty-sdk"
+  gem.version       = '1.0.0'
+  gem.authors       = ["Alfred Moreno"]
+  gem.email         = ["kryptek@gmail.com"]
+  gem.description   = %q{An SDK for Pagerduty's API}
+  gem.summary       = %q{An SDK for communication with the entire Pagerduty API}
+  gem.homepage      = "https://github.com/kryptek/pagerduty-sdk"
+
+  #gem.files         = `git ls-files`.split($/)
+  gem.files         = `find .`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency 'active_support'
+  gem.add_dependency 'json'
+  gem.add_dependency 'virtus'
+
+  gem.license       = 'MIT'
+end

metadata

@@ -0,0 +1,141 @@
+--- !ruby/object:Gem::Specification
+name: pagerduty-sdk
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Alfred Moreno
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: active_support
+  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: json
+  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: virtus
+  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'
+description: An SDK for Pagerduty's API
+email:
+- kryptek@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- "./.DS_Store"
+- "./.git/config"
+- "./.git/description"
+- "./.git/HEAD"
+- "./.git/hooks/applypatch-msg.sample"
+- "./.git/hooks/commit-msg.sample"
+- "./.git/hooks/post-update.sample"
+- "./.git/hooks/pre-applypatch.sample"
+- "./.git/hooks/pre-commit.sample"
+- "./.git/hooks/pre-push.sample"
+- "./.git/hooks/pre-rebase.sample"
+- "./.git/hooks/prepare-commit-msg.sample"
+- "./.git/hooks/update.sample"
+- "./.git/index"
+- "./.git/info/exclude"
+- "./.git/logs/HEAD"
+- "./.git/logs/refs/heads/master"
+- "./.git/logs/refs/remotes/origin/HEAD"
+- "./.git/objects/pack/pack-ef303a32b278847aabbf3023e493ea7a4ca5888f.idx"
+- "./.git/objects/pack/pack-ef303a32b278847aabbf3023e493ea7a4ca5888f.pack"
+- "./.git/packed-refs"
+- "./.git/refs/heads/master"
+- "./.git/refs/remotes/origin/HEAD"
+- "./.gitignore"
+- "./lib/.DS_Store"
+- "./lib/.yardoc/checksums"
+- "./lib/.yardoc/object_types"
+- "./lib/.yardoc/objects/root.dat"
+- "./lib/.yardoc/proxy_types"
+- "./lib/pagerduty/.DS_Store"
+- "./lib/pagerduty/core.rb"
+- "./lib/pagerduty/models/agent.rb"
+- "./lib/pagerduty/models/alert.rb"
+- "./lib/pagerduty/models/assigneduser.rb"
+- "./lib/pagerduty/models/channels.rb"
+- "./lib/pagerduty/models/escalationpolicies.rb"
+- "./lib/pagerduty/models/incident.rb"
+- "./lib/pagerduty/models/laststatuschangeby.rb"
+- "./lib/pagerduty/models/log_entry.rb"
+- "./lib/pagerduty/models/maintenance_window.rb"
+- "./lib/pagerduty/models/note.rb"
+- "./lib/pagerduty/models/notification.rb"
+- "./lib/pagerduty/models/report.rb"
+- "./lib/pagerduty/models/resolvedbyuser.rb"
+- "./lib/pagerduty/models/schedule.rb"
+- "./lib/pagerduty/models/service.rb"
+- "./lib/pagerduty/models/services.rb"
+- "./lib/pagerduty/models/triggersummarydata.rb"
+- "./lib/pagerduty/models/user.rb"
+- "./lib/pagerduty/pagerduty.rb"
+- "./lib/pagerduty.rb"
+- "./LICENSE"
+- "./pagerduty-sdk.gemspec"
+- "./README.md"
+homepage: https://github.com/kryptek/pagerduty-sdk
+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.0.2
+signing_key: 
+specification_version: 4
+summary: An SDK for communication with the entire Pagerduty API
+test_files: []
+has_rdoc: