mv-slacker 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: cc0db0d227f0687d12768e746210e61346d6f7d4
+  data.tar.gz: 7a87e22b24e76d102bae1b78d5c08c9e9199a703
+SHA512:
+  metadata.gz: f4174aaa74fc7c4eff812a1798eb48984f0dc0b30191e7ab8efe1f099b3cdecf5a063474779fe373ac32a6176033c6bcf0a3e27a6ff2f417f23890a1f1fb48d0
+  data.tar.gz: 6c56fd937df97ad74fd512aad132339f1435b797ffa54bbaec57ca06d7d33591e95fd1664c744cd04384c10df239759dd3e795fd6c966f14019805d5304dd350

data/.gitignore

@@ -0,0 +1,35 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.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

data/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'byebug', platforms: [:mri_20, :mri_21, :mri_22]

data/README.md

@@ -0,0 +1,36 @@
+# mv-slacker
+A thing that lets you send Motivosity dollars via Slack
+
+## Description
+This program listens for you to say certain magic words in Slack. When it hears them, it performs a Motivosity transaction on your behalf and posts the result to the channel.
+
+## Example use
+```
+<user> $1 :motivosity: to Jane Doe, for Customer Experience. Thanks for helping the customer!
+<mv-slacker> Success! Jane Doe has received your appreciation.
+```
+
+### Message format
+```
+$<amount> :motivosity: to <user>[, for <company value>][.[ <note>]]
+```
+
+### Identifying the user
+mv-slacker will complete your request only if `<user>` matches exactly one Motivosity user. If the `<user>` term matches more than one name, mv-slacker will DM you the list of matching names.
+
+## Why isn't this an outgoing webhook?
+That would be a lot simpler, wouldn't it? But then you'd have to trust some random service with your Motivosity credentials. If and when Motivosity supports OAuth, I'd be happy to take that approach. That way, a single service would allow any Slack user to register with the bot by providing a token, and it'd be beautiful. But for now, this inelegant solution at least keeps your password on your local machine.
+
+## Installation
+```
+gem install mv-slacker
+```
+
+## Usage
+```
+mv-slacker
+```
+The first time you run it, it will prompt you to enter your Motivosity credentials and your Slack token. These will be stored in `~/.mv-slacker-auth` for later use. If that file is deleted, or if a login fails, mv-slacker will prompt you again. If the permissions on this file are too loose, mv-slacker will refuse to use them, so be sure it's readable only by you.
+
+## Technical information
+mv-slacker uses the Slack Real-Time Messaging API to watch for your commands. It doesn't depend on any Slack integrations. It uses the mvclient gem to communicate with Motivosity.

data/bin/mv-slacker

@@ -0,0 +1,190 @@
+#!/usr/bin/env ruby
+
+require 'highline/import'
+require 'mvclient'
+require 'slack-rtmapi'
+require 'json'
+require 'date'
+require 'colorize'
+
+CONFIG_FILE = File.expand_path("~/.mv-slacker-auth")
+MESSAGE_REGEX = /\A\s*(?:\$|\+\$?)(\d+\.?\d*)\s*\:(?:mv|motivosity)\:\s*to\s+([^,.]+)(?:,\s*for\s+([^.]+))?(?:\.\s*(.*))?/
+
+$slack_login_time = nil
+
+class SlackAPI
+  class Error < RuntimeError; end
+
+  class Http
+    include HTTParty
+    base_uri 'https://slack.com'
+    debug_output $stderr if ENV['SLACK_DEBUG'].to_i == 1
+  end
+
+  def self.get(path, url_params = {})
+    response = Http.get(path, query: url_params.merge(token: $config[:slack_token]))
+    $slack_login_time ||= DateTime.httpdate(response.headers['Date']).to_time.to_i
+    raise Error.new("#{response.code} #{response.message}") unless response.code == 200
+    json = JSON.parse(response.body)
+    raise Error.new(response["error"]) unless response["ok"]
+    json
+  end
+end
+
+
+def check_config
+  $config = {}
+  config_changed = false
+  config_file = File.new(CONFIG_FILE, File::CREAT|File::RDWR, 0600)
+  raise "Permissions for #{CONFIG_FILE} are too liberal" if config_file.stat.world_readable?
+  data = config_file.read
+  unless data.empty?
+    $config = JSON.parse(data).tap do |h|
+      h.keys.each { |k| h[k.to_sym] = h.delete(k) }
+    end
+  end
+
+  # log in to slack
+  loop do
+    if $config[:slack_token]
+      begin
+        result = SlackAPI.get("/api/auth.test")
+        $slack_user_id = result["user_id"]
+        puts "Logged into Slack"
+        break
+      rescue SlackAPI::Error => e
+        puts "Slack login failed: #{e.message}"
+        $config.delete(:slack_token)
+      end
+    end
+    if !$config[:slack_token]
+      config_changed = true
+      $config[:slack_token] = ask("Paste your Slack token: ")
+    end
+  end
+
+  # log in to motivosity
+  loop do
+    if $config[:mv_username] && $config[:mv_password]
+      begin
+        $mvclient.login! $config[:mv_username], $config[:mv_password]
+        $company_values = $mvclient.get_values
+        puts "Logged in to Motivosity"
+        break
+      rescue Motivosity::UnauthorizedError
+        puts "Motivosity login failed"
+        $config.delete(:mv_username)
+        $config.delete(:mv_password)
+      end
+    end
+    if !$config[:mv_username] || !$config[:mv_password]
+      config_changed = true
+      $config[:mv_username] = ask("Enter your Motivosity username: ")
+      $config[:mv_password] = ask("Enter your Motivosity password: ") { |q| q.echo = false }
+    end
+  end
+
+  # save config
+  if config_changed
+    config_file.rewind
+    config_file.truncate(0)
+    config_file.write $config.to_json
+  end
+end
+
+def open_im_channel(user_id)
+  json = SlackAPI.get "/api/im.open", user: user_id
+  json["channel"]["id"]
+end
+
+def send_in_channel(channel, text)
+  SlackAPI.get "/api/chat.postMessage", channel: channel, username: 'Motivosity Slacker', as_user: false, text: text,
+               unfurl_links: false, unfurl_media: false, icon_emoji: ":motivosity:"
+end
+
+# send a direct message to the caller
+def pm(message, text)
+  send_in_channel(open_im_channel($slack_user_id), text)
+end
+
+# reply to the message in channel
+def reply(message, text)
+  send_in_channel(message["channel"], text)
+end
+
+def find_user(message, name)
+  users = []
+  begin
+    users = $mvclient.search_for_user(name)
+  rescue Motivosity::UnauthorizedError
+    # in case session has expired
+    $mvclient.login! $config[:mv_username], $config[:mv_password]
+    users = $mvclient.search_for_user(name)
+  end
+  if users.size > 1
+    # check for an exact match among the search results
+    matching_users = users.select { |user| user['fullName'] == name }
+    if matching_users.size != 1
+      puts "Ambiguous name: " + name.bold
+      pm(message, "Multiple users match `#{name}`! Try one of #{users.map{|user| "`#{user['fullName']}`"}.join(', ')}")
+      return [nil, nil]
+    else
+      users = matching_users
+    end
+  end
+  if users.empty?
+    puts "User not found: " + name.bold
+    pm(message, "User `#{name}` not found")
+    return [nil, nil]
+  end
+  [users[0]['id'], users[0]['fullName']]
+end
+
+def process_message(message, amount, name, company_value, note)
+  # slack likes to replay old messages when you first log in
+  # let's avoid sending redundant thanks by ignoring messages older than our slack login
+  if message['ts'].to_f < $slack_login_time
+    puts "ignoring old message: #{message['text']}".light_black
+    return
+  end
+
+  # find the company value, if one was given
+  value = $company_values.detect { |v| v['name'].downcase == company_value.downcase } if company_value
+  value_id = value['id'] if value
+
+  # look up the user
+  user_id, user_name = find_user(message, name)
+  return unless user_id
+
+  # let's do this
+  print "Sending $" + "#{amount}".on_green + " to " + "#{user_name}".on_red
+  print " for " + "#{value['name']}".on_blue if value
+  puts ": " + note.bold
+  begin
+    response = $mvclient.send_appreciation! user_id, amount: amount, company_value_id: value_id, note: note
+  rescue => e
+    puts "Failed to send appreciation: ".red + e.inspect
+    pm(message, "Failed to send appreciation: `#{e.message}`")
+    return
+  end
+  reply(message, "*#{response['growl']['title']}* #{response['growl']['content']}")
+end
+
+# ...
+
+$slack_user_id = nil
+
+$mvclient = Motivosity::Client.new
+check_config
+
+$slack_client = SlackRTM::Client.new(websocket_url: SlackRTM.get_url(token: $config[:slack_token]))
+$slack_client.on(:message) do |data|
+  if data["type"] == "message" && data["user"] == $slack_user_id && data["text"] =~ MESSAGE_REGEX
+    process_message(data, $1, $2, $3, $4)
+  end
+end
+
+puts "Connected to Slack Real Time Messaging API"
+
+$slack_client.main_loop
+

data/mv-slacker.gemspec

@@ -0,0 +1,22 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |s|
+  s.name        = 'mv-slacker'
+  s.version     = '0.0.1'
+  s.date        = '2015-04-09'
+  s.summary     = "A thing that lets you send Motivosity dollars via Slack"
+  s.description = "A thing that lets you send Motivosity dollars via Slack"
+  s.authors     = ["Jeremy Stanley"]
+  s.email       = 'jstanley0@gmail.com'
+  s.files       = `git ls-files`.split("\n")
+  s.homepage    = 'http://github.com/jstanley0/mv-slacker'
+  s.license     = 'Apache'
+  s.bindir      = 'bin'
+  s.executables << 'mv-slacker'
+  s.required_ruby_version = '>= 1.9.3'
+  s.add_dependency 'mvclient', '0.0.4'
+  s.add_dependency 'httparty', '~> 0'
+  s.add_dependency 'slack-rtmapi', '1.0.0.rc4'
+  s.add_dependency 'colorize', '~> 0.7'
+end

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification
+name: mv-slacker
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Jeremy Stanley
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-04-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mvclient
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.4
+- !ruby/object:Gem::Dependency
+  name: httparty
+  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: slack-rtmapi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.0.0.rc4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.0.0.rc4
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+description: A thing that lets you send Motivosity dollars via Slack
+email: jstanley0@gmail.com
+executables:
+- mv-slacker
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- README.md
+- bin/mv-slacker
+- mv-slacker.gemspec
+homepage: http://github.com/jstanley0/mv-slacker
+licenses:
+- Apache
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: A thing that lets you send Motivosity dollars via Slack
+test_files: []
+has_rdoc: