pager_judy 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2a39f6c4ca0c4e98eab6314bbe7dd97573fad1ad3334618e25f3c55365818b23
+  data.tar.gz: fa1176795618c99b7956142e7df8d9f6103a124cbd2269c0c0743e9dbe1c7f73
+SHA512:
+  metadata.gz: 28d39a55ab1bb2a825be3de9bea427d9abdfaaf80c9de892d37c8edc7c98d819afb78614d9c0d8a68174e28b2c0b565202d72132d4c8373522f1efe86370c2d7
+  data.tar.gz: 3ed6b757e43ad7e85f0cae3d6d860b15aea45a4f167797b48bf183c50bb40bce5887dfac2584e3ab6da06770888623da5ac6fe2bf6b1c7876cf2e69e53c91203

data/.buildkite/pipeline.yml

@@ -0,0 +1,17 @@
+steps:
+
+  - name: Test
+    command: ./auto/test
+
+  - name: Build
+    command: ./auto/build
+
+  - block: OK release
+    branches: master
+
+  - name: Release
+    command: ./auto/release
+    branches: master
+    artifact_paths: target/docker-image.txt
+    agents:
+      queue: cpdev:build

data/.buildkite/upload-pipeline

@@ -0,0 +1,3 @@
+#!/bin/bash -eu
+
+buildkite-agent pipeline upload < $(dirname $0)/pipeline.yml

data/.dockerignore

@@ -0,0 +1,3 @@
+.git
+target
+tmp

data/.gitignore

@@ -0,0 +1,53 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+smoke-tests/tmp/
+.DS_STORE   
+
+# Used by dotenv library to load environment variables.
+# .env
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+*.bridgesupport
+build-iPhoneOS/
+build-iPhoneSimulator/
+
+## Specific to RubyMotion (use of CocoaPods):
+#
+# We recommend against adding the Pods directory to your .gitignore. However
+# you should judge for yourself, the pros and cons are mentioned at:
+# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+#
+# vendor/Pods/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/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-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+test*

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.rubocop.yml

@@ -0,0 +1,49 @@
+Eval:
+  Exclude:
+    - "Rakefile"
+
+Layout/EmptyLinesAroundBlockBody:
+  Enabled: false
+
+Layout/EmptyLinesAroundClassBody:
+  EnforcedStyle: empty_lines
+
+Layout/EmptyLinesAroundModuleBody:
+  Enabled: false
+
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/LineLength:
+  Max: 120
+
+Metrics/MethodLength:
+  Max: 30
+
+Style/ClassAndModuleChildren:
+  EnforcedStyle: nested
+  Exclude:
+    - "spec/**/*"
+
+Style/ConditionalAssignment:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Style/Encoding:
+  EnforcedStyle: when_needed
+  Enabled: true
+
+Style/FileName:
+  Exclude:
+    - "bin/*"
+
+Style/HashSyntax:
+  EnforcedStyle: ruby19
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/WordArray:
+  Enabled: false

data/CHANGES.md

@@ -0,0 +1,29 @@
+## PENDING
+
+* Add "--include" option for services.
+* Add "vendors".
+
+## 0.1.5 (2017-08-19)
+
+* Add service timeouts functionality.
+
+## 0.1.4 (2017-08-18)
+
+* Add "--dry-run" option to "configure".
+
+## 0.1.3 (2017-08-17)
+
+* Add "users" subcommand.
+* Add "--check" option to "configure".
+
+## 0.1.2 (2017-08-17)
+
+* Fix "configure" subcommand.
+
+## 0.1.1 (2017-08-17)
+
+* Add "configure" subcommand.
+
+## 0.1.0 (2017-08-17)
+
+* Initial release.

data/Dockerfile

@@ -0,0 +1,22 @@
+FROM ruby:2.5-alpine
+
+RUN { echo 'install: --no-document'; echo 'update: --no-document'; } >> /etc/gemrc
+
+MAINTAINER Mike Williams <mdub@dogbiscuit.org>
+
+RUN apk --no-cache add \
+    ca-certificates
+
+WORKDIR /app
+
+COPY Gemfile /app/Gemfile
+COPY Gemfile.lock /app/Gemfile.lock
+RUN bundle install --without development test
+
+COPY bin /app/bin
+COPY lib /app/lib
+COPY README.md /app/
+
+WORKDIR /cwd
+
+ENTRYPOINT ["/app/bin/pagerjudy"]

data/Gemfile

@@ -0,0 +1,20 @@
+source "https://rubygems.org"
+
+gem "clamp", "~> 1.3.0"
+gem "config_hound", "~> 1.4", ">= 1.4.1"
+gem "config_mapper", "~> 1.6"
+gem "console_logger", "~> 1.0"
+gem "httpi"
+gem "jmespath"
+gem "multi_json"
+
+group "development" do
+  gem "pry"
+  gem "rack-test"
+  gem "rake", "~> 12.0"
+  gem "rspec", "~> 3.5"
+  gem "rspec-pact-matchers", "~> 0.1"
+  gem "rubocop", "~> 0.49"
+  gem "sham_rack"
+  gem "sinatra"
+end

data/Gemfile.lock

@@ -0,0 +1,109 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.0)
+    awesome_print (1.8.0)
+    clamp (1.3.0)
+    coderay (1.1.2)
+    config_hound (1.4.3)
+      dig_rb
+    config_mapper (1.7.0)
+    console_logger (1.0.0)
+    diff-lcs (1.3)
+    dig_rb (1.0.1)
+    find_a_port (1.0.1)
+    httpi (2.4.4)
+      rack
+      socksify
+    jaro_winkler (1.5.1)
+    jmespath (1.4.0)
+    json (2.1.0)
+    method_source (0.9.2)
+    multi_json (1.13.1)
+    mustermann (1.0.3)
+    pact-support (1.8.1)
+      awesome_print (~> 1.1)
+      find_a_port (~> 1.0.1)
+      json
+      randexp (~> 0.1.7)
+      rspec (>= 2.14)
+      term-ansicolor (~> 1.0)
+      thor
+    parallel (1.12.1)
+    parser (2.5.3.0)
+      ast (~> 2.4.0)
+    powerpack (0.1.2)
+    pry (0.12.2)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    rack (2.0.6)
+    rack-protection (2.0.5)
+      rack
+    rack-test (1.1.0)
+      rack (>= 1.0, < 3)
+    rainbow (3.0.0)
+    rake (12.3.2)
+    randexp (0.1.7)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.0)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-mocks (3.8.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-pact-matchers (0.1.0)
+      pact-support (>= 1.1.2, < 2.0)
+      rspec (~> 3.0)
+      term-ansicolor (~> 1.0)
+    rspec-support (3.8.0)
+    rubocop (0.61.1)
+      jaro_winkler (~> 1.5.1)
+      parallel (~> 1.10)
+      parser (>= 2.5, != 2.5.1.1)
+      powerpack (~> 0.1)
+      rainbow (>= 2.2.2, < 4.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (~> 1.4.0)
+    ruby-progressbar (1.10.0)
+    sham_rack (1.4.1)
+      rack
+    sinatra (2.0.5)
+      mustermann (~> 1.0)
+      rack (~> 2.0)
+      rack-protection (= 2.0.5)
+      tilt (~> 2.0)
+    socksify (1.7.1)
+    term-ansicolor (1.7.0)
+      tins (~> 1.0)
+    thor (0.20.3)
+    tilt (2.0.9)
+    tins (1.20.2)
+    unicode-display_width (1.4.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  clamp (~> 1.3.0)
+  config_hound (~> 1.4, >= 1.4.1)
+  config_mapper (~> 1.6)
+  console_logger (~> 1.0)
+  httpi
+  jmespath
+  multi_json
+  pry
+  rack-test
+  rake (~> 12.0)
+  rspec (~> 3.5)
+  rspec-pact-matchers (~> 0.1)
+  rubocop (~> 0.49)
+  sham_rack
+  sinatra
+
+BUNDLED WITH
+   1.16.2

data/README.md

@@ -0,0 +1,5 @@
+# PagerJudy
+
+PagerJudy is:
+- a Ruby client for the [PagerDuty API](https://v2.developer.pagerduty.com/v2/page/api-reference)
+- with a handy built-in CLI tool

data/Rakefile

@@ -0,0 +1,9 @@
+#!/usr/bin/env rake
+
+require "bundler"
+Bundler::GemHelper.install_tasks
+
+task "default" => "spec"
+
+require "rspec/core/rake_task"
+RSpec::Core::RakeTask.new(:spec)

data/auto/build

@@ -0,0 +1,7 @@
+#! /bin/bash -eu
+#
+# Build Docker image
+
+cd $(dirname $0)/..
+
+docker build .

data/auto/dev-environment

@@ -0,0 +1,11 @@
+#! /bin/bash -e
+#
+# Dev environment in a Docker container for local and CI use
+
+cd $(dirname $0)/..
+
+trap "docker-compose down --volumes" 0
+
+docker volume create --name ruby2.4-bundle-cache > /dev/null
+docker-compose run --rm dev sh -c 'bundle check > /dev/null || bundle install'
+docker-compose run --rm dev bundle exec "${@-bash}"

data/auto/test

@@ -0,0 +1,3 @@
+#! /bin/bash -e
+
+$(dirname $0)/dev-environment rake spec

data/docker-compose.yml

@@ -0,0 +1,16 @@
+version: "2"
+
+services:
+  dev:
+    image: ruby:2.4
+    volumes:
+      - .:/work
+      - ruby2.4-bundle-cache:/usr/local/bundle
+    working_dir: /work
+    command: ["bash"]
+    environment:
+      PAGER_DUTY_API_KEY:
+
+volumes:
+  ruby2.4-bundle-cache:
+    external: true

data/exe/pagerjudy

@@ -0,0 +1,10 @@
+#! /usr/bin/env ruby
+
+$LOAD_PATH << File.expand_path("../../lib", __FILE__)
+
+require "pager_judy/cli"
+
+$stdout.sync = true
+$stderr.sync = true
+
+PagerJudy::CLI::MainCommand.run

data/lib/pager_judy/api/client.rb

@@ -0,0 +1,61 @@
+require "pager_judy/api/collection"
+require "pager_judy/api/resource"
+require "uri"
+
+module PagerJudy
+  module API
+
+    # Communicate with the PagerDuty API.
+    #
+    class Client
+
+      def initialize(api_key, base_uri: "https://api.pagerduty.com/", logger: nil, dry_run: false)
+        @root = Resource.new(api_key: api_key, uri: URI(base_uri), logger: logger, dry_run: dry_run)
+      end
+
+      attr_reader :root
+
+      def collection(type)
+        Collection.new(root.subresource(type), type)
+      end
+
+      def escalation_policies
+        collection("escalation_policies")
+      end
+
+      def extensions
+        collection("extensions")
+      end
+
+      def incidents
+        collection("incidents")
+      end
+
+      def notifications
+        collection("notifications")
+      end
+
+      def schedules
+        collection("schedules")
+      end
+
+      def services
+        collection("services")
+      end
+
+      def teams
+        collection("teams")
+      end
+
+      def users
+        collection("users")
+      end
+
+      def vendors
+        collection("vendors")
+      end
+
+    end
+
+  end
+end

data/lib/pager_judy/api/collection.rb

@@ -0,0 +1,95 @@
+require "pager_judy/api/item"
+
+module PagerJudy
+  module API
+
+    # Represents a collection of things, e.g. services, users, ...
+    #
+    class Collection
+
+      def initialize(resource, type, criteria = {})
+        @resource = resource
+        @type = type
+        @criteria = criteria
+      end
+
+      attr_reader :resource
+      attr_reader :type
+      attr_reader :criteria
+
+      def item_type
+        type.sub(/ies$/, "y").chomp("s")
+      end
+
+      include Enumerable
+
+      def with(more_criteria)
+        more_criteria = Hash[more_criteria.select { |_, v| v }]
+        Collection.new(resource, type, criteria.merge(more_criteria))
+      end
+
+      def each
+        offset = 0
+        loop do
+          data = resource.get(criteria.merge(offset: offset, limit: 100))
+          data.fetch(type).each do |item|
+            yield item
+          end
+          break unless data["more"]
+          offset = data.fetch("offset") + data.fetch("limit")
+        end
+        self
+      end
+
+      def [](id)
+        Item.new(resource.subresource(id), item_type, id)
+      end
+
+      def create(data)
+        name = data.fetch("name")
+        if dry_run?
+          result = data.merge("id" => "{#{name}}")
+        else
+          result = resource.post(item_type => data).fetch(item_type)
+        end
+        id = result.fetch("id")
+        logger.info { "created #{item_type} #{name.inspect} [#{id}]" }
+        result
+      end
+
+      def create_or_update(id, data)
+        if id.nil?
+          create(data)
+        else
+          self[id].update(data)
+        end
+      end
+
+      def id_for_name(name)
+        ids_by_name[name]
+      end
+
+      def create_or_update_by_name(name, data)
+        create_or_update(id_for_name(name), data.merge("name" => name))
+      end
+
+      private
+
+      def ids_by_name
+        @ids_by_name ||= each_with_object({}) do |item, result|
+          result[item.fetch("name")] = item.fetch("id")
+        end
+      end
+
+      def logger
+        resource.logger
+      end
+
+      def dry_run?
+        resource.dry_run?
+      end
+
+    end
+
+  end
+end

data/lib/pager_judy/api/errors.rb

@@ -0,0 +1,20 @@
+module PagerJudy
+  module API
+
+    # An error from the PagerDuty REST API.
+    #
+    class HttpError < StandardError
+
+      def initialize(request, response)
+        @request = request
+        @response = response
+        super(response.headers["Status"])
+      end
+
+      attr_reader :request
+      attr_reader :response
+
+    end
+
+  end
+end