smartnotify 0.0.16

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8f3ba8f116155963a266287afed9cf2286d11068
+  data.tar.gz: cbbc33d7a21acb9232af8c1c71fa017244948715
+SHA512:
+  metadata.gz: d46b5f331b5d9cffee1d31d31636ebca32da2fd30c76c2074d7238d2cdca7968733410fd589e317b9f2b2d98c9a9783bb07f921ce296f77cc24496ce7ae49ee3
+  data.tar.gz: 4512615ceec95c6fd80004fc44eaebf9e380e97b42aaf706db3ccc90d36a6e8d63961884fdebad97dc5b299d8a7cc203aff9a23ca1663d9906d8ac376b0409a5

data/README.md

@@ -0,0 +1,60 @@
+# SmartNotify
+
+Ruby Gem designed for sending various types of notifications via a common configurable interface.
+ 
+## Overview
+The gem makes use of two components, modules, and templates. 
+
+Modules are defined within this gem, and provide various forms of generic notification functionality. The modules are created to be reusable. A module could be responsible for sending emails, posting Slack notifications, making a REST call to an external API, whatever. 
+ 
+Templates on the other hand, consume a specific module, in conjunction with template specific configuration, creating very specific use cases. These use cases could be team specific, allowing different consumers to tweak who, and how notifications are distributed. 
+ 
+## Why
+There was a need to easily send SLA incident emails to the correct person on support, as well as to a MS Teams channel. A module was created `rotation_emailer` which could send emails, based on a given email template, and support rotation csv file. With that in place, a template was created `incident_start_email` which defines where the specific email template, and support rotation csv file is located for this particular instance. This is awesome, because a new team or solution could create a template, changing only the support rotation csv location, and get the same functionality for next to no setup cost.
+ 
+
+## Usage
+Add `gem 'smartnotify'` to your Gemfile. *Latest version can be found internally at [gems.hax](http://gems.hax)*
+```ruby
+ require 'smartnotify'
+ # ... your logic ...
+ smartnotify = SmartNotify.new
+ smartnotify.run(template, json, [debug], [dryrun])
+```
+
+* **template** - [String] The id of the template to use. The templates are configured externally in [PHPerfImp/smartnotify-config](https://github.cerner.com/PHPerfImp/smartnotify-config)
+* **json** - [String] The JSON key/value pairs to be used as input to the selected template. Each template defines what keys must be provided.
+* **debug** - [Boolean] *(optional, defaults false)* Enables debug logging within SmartNotify. 
+* **dryrun** - [Boolean] *(optional, defaults false)* Enables debug logging within SmartNotify, and disables sending any notifications for testing purposes. 
+
+### Example
+```ruby
+smartnotify = SmartNotify.new
+smartnotify.run('incident_start_email', "{\"mnemonic\": \"sbmcin\", \"cerner_mnemonic\": \"UNVR_NY\", \"link\": \"https://jira2.cerner.com/browse/PERFIMPDEV-1349\", \"title\": \"Readmission SLA Exceeded\", \"message\": \"Readmission SLA exceeded, please check the JIRA for more information.\"}")
+```
+
+## Modules
+The following are the currently available modules that can be consumed. Follow the link to get more information on 
+intended usage, and configuration.
+
+* [Rotation Emailer](modules/roatation_emailer/README.md)
+ 
+## Releasing New Version
+
+1. Clone the gem locally.
+```
+git clone https://github.cerner.com/PHPerfImp/smartnotify.git
+cd smartnotify
+bundle install
+```
+
+2. Make your change.
+
+3. Update [smartnotify.gemspec](smartnotify.gemspec]) gem version.
+
+4. Build the gem locally
+```
+gem build smartnotify
+```
+5. Upload created `smartnotify-x.x.x.gem` internally to [gems.hax](http://gems.hax)
+

data/lib/config/config.yml

@@ -0,0 +1 @@
+config-url: 'https://raw.github.cerner.com/PHPerfImp/smartnotify-config/master/config/config.yml'

data/lib/modules/rotation_emailer/README.md

@@ -0,0 +1,31 @@
+# Module - Rotation Emailer
+  
+**Module ID:** `rotation_emailer`
+
+## Required Configuration
+
+* *email_template* - A URL pointed to the template of the email message to send. This document should be a .erb file. 
+The data is fed into the template from the provided json, as a hash. *e.g accessing a title key would look like
+`<%= data['title'] %>`*
+
+* *support_rotation* - A URL pointed to a CSV file containing email addresses, combined with start/end times for 
+when the given address is valid to email. On each run, the file will be parsed looking for emails that are valid at that
+time and will send the message to all the addresses as one group email. At a minimum, the following three columns 
+with headers must be specified:
+
+    * `Start Time` - Formatted as 12/Aug/2017. This is the date, starting at the beginning of the day, that the email 
+    address can start being emailed.
+    * `End Time` - Formatted as 18/Aug/2017.  This is the date, ending at midnight, that the email address is no longer 
+    valid to notify after. 
+    * `Email Address` - Email address to notify.
+    
+ *Note:*
+ * *All times a calculated with the configured timezone of Central Time (US & Canada)*
+ * *Column headers are case sensitive.*
+
+## Required JSON keys
+While most of the JSON key/value pairs are defined based on what 
+the template needs, this module requires that a `title` JSON key
+be provided which is used as the subject of the email. If no title
+key is defined, a fallback *'Rotation Emailer Notification'* title 
+will be used as the email subject instead. 

data/lib/modules/rotation_emailer/rotation_emailer.rb

@@ -0,0 +1,111 @@
+#!/usr/bin/env ruby
+
+require 'mail'
+require 'yaml'
+require 'csv'
+require 'open-uri'
+
+class NotificationModule
+
+  def initialize(config)
+    @config = config
+  end
+
+  def run
+    c = @config
+
+    # Setup Mailer
+    Mail.defaults do
+      delivery_method :smtp, {
+          :address => c[:global]['smtp']['host'],
+          :port => c[:global]['smtp']['port']
+      }
+    end
+
+    # Load Email Addresses
+    if c[:global]['debug']
+      puts 'DEBUG:'
+      puts 'DEBUG: Loading support rotation from:'
+      puts "DEBUG:   #{c[:config]['support_rotation']}"
+    end
+
+    send_list = []
+    CSV.new(open(c[:config]['support_rotation']), :headers => :first_row).each do |email|
+      send_list.push("#{email['Email Address']}") if active_email(email, c[:global]['timezone'])
+    end
+
+    if send_list.empty?
+      puts 'ERROR: No email addresses are setup for the current time.'
+      return false
+    end
+
+    if c[:global]['debug']
+      puts 'DEBUG:'
+      puts 'DEBUG: Found the following email addresses to notify:'
+
+      send_list.each do |recipient|
+        puts "DEBUG:   #{recipient}"
+      end
+    end
+
+    # Load Template
+    if c[:global]['debug']
+      puts 'DEBUG:'
+      puts 'DEBUG: Loading email template from:'
+      puts "DEBUG:   #{c[:config]['email_template']}"
+    end
+
+    email_template = open(c[:config]['email_template']).read
+
+    if c[:global]['debug']
+      puts 'DEBUG:'
+      puts 'DEBUG: Loaded the following email template:'
+      email_template.each_line do |line|
+        puts "DEBUG:    #{line}"
+      end
+    end
+
+    # Populate Template
+    b = binding
+    b.local_variable_set(:data, c[:data])
+    message = ERB.new(email_template).result(b)
+
+    if c[:global]['debug']
+      puts 'DEBUG:'
+      puts 'DEBUG: Prepared the following email message:'
+      message.each_line do |line|
+        puts "DEBUG:    #{line}"
+      end
+    end
+
+    # Send The Emails
+    if c[:global]['dryrun']
+      puts 'DEBUG:'
+      puts 'DEBUG: Not sending email because dryrun is enabled.'
+    else
+      title = c[:data]['title'].nil? ? 'Rotation Emailer Notification' : c[:data]['title']
+      send_email(title, c[:global]['smtp']['from'], send_list, message)
+    end
+  end
+
+  private
+
+  def active_email(email, tz)
+    start_time = DateTime.parse(email['Start Time'] + ' ' + tz).beginning_of_day
+    end_time = DateTime.parse(email['End Time'] + ' ' + tz).end_of_day
+    current_time = DateTime.now
+    start_time <= current_time and end_time > current_time
+  end
+
+  def send_email(subject_text, from_email, to_email, body_text)
+    Mail.deliver do
+      to to_email
+      from from_email
+      subject subject_text
+      html_part do
+        content_type 'text/html; charset=UTF-8'
+        body body_text
+      end
+    end
+  end
+end

data/lib/smartnotify.rb

@@ -0,0 +1,76 @@
+#!/usr/bin/env ruby
+
+require 'yaml'
+require 'erb'
+require 'json'
+require 'open-uri'
+
+class SmartNotify
+  attr_accessor :config
+
+  def run(template, json, debug = false, dryrun = false)
+
+    # Ensure Options Provided
+    if json.nil? or template.nil?
+      puts 'ERROR: Must provide template, and JSON data.'
+      return false
+    end
+
+    # Load Configuration
+    c = YAML.load_file(File.join(__dir__, 'config/config.yml'))
+    if debug
+      puts 'DEBUG: Loading SmartNotify config from:'
+      puts "DEBUG:   #{c['config-url']}"
+    end
+    config = YAML.load(open(c['config-url']).read)
+
+    # Load Template Configuration
+    template_config = config['templates'][template]
+    if template_config.nil?
+      puts "ERROR: Template '#{template}' not found."
+      return false
+    end
+
+    # Configure Development Flags
+    config['global']['debug'] = debug || dryrun
+    config['global']['dryrun'] = dryrun
+
+
+    # Load JSON
+    begin
+      template_data = JSON.parse(json)
+    rescue JSON::ParserError => e
+      puts 'ERROR: JSON provided is unable to be parsed.'
+      return false
+    end
+
+    # Prepare Module Configuration
+    module_config = Hash.new
+    module_config[:config] = template_config
+    module_config[:data] = template_data
+    module_config[:global] = config['global']
+
+    # Ensure Fields Present
+    unless module_config[:config]['fields'].nil?
+      module_config[:config]['fields'].each do |field|
+        if module_config[:data][field].nil?
+          puts "ERROR: JSON provided is missing required key '#{field}'"
+          return false
+        end
+      end
+    end
+
+    # Load Module Resources
+    # begin
+      require_relative "modules/#{module_config[:config]['module']}/#{module_config[:config]['module']}"
+    # rescue LoadError
+    #   puts "#{module_config[:config]['module']} module was not found."
+    #   puts 'Ensure the correct module name is defined in the configuration.'
+    #   return false
+    # end
+
+    # Run Module
+    NotificationModule.new(module_config).run
+  end
+end
+

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: smartnotify
+version: !ruby/object:Gem::Version
+  version: 0.0.16
+platform: ruby
+authors:
+- Performance Improvement Dev
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-08-17 00:00:00.000000000 Z
+dependencies: []
+description: Utility for sending various types of notifications via a common configurable
+  interface.
+email:
+- kristopher.williams@cerner.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/config/config.yml
+- lib/modules/rotation_emailer/README.md
+- lib/modules/rotation_emailer/rotation_emailer.rb
+- lib/smartnotify.rb
+homepage: https://github.cerner.com/PHPerfImp/smartnotify
+licenses: []
+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.6.12
+signing_key: 
+specification_version: 4
+summary: Common interface notification utility
+test_files: []