release_robot 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d6a538b348c00e6432db77a517a6b137abf87085
+  data.tar.gz: 851612ac8cb53d5803ed37cbb04395af2e640445
+SHA512:
+  metadata.gz: 29fd114c621cf47d88ffe255cdec15db430375516c721160d30002449ebf8031073381c3a680133e0755e233e922966fb78b1d86013bdb09a0e3413ea55a7fee
+  data.tar.gz: 96c91c028f7c655fdbfa369523f340854170f374060012e7061d90a3a6289c69cfbbc0dcb15b640ba523dcc6627fe57c4740f7dff51370e0e4765139800ce165

data/.gitignore

@@ -0,0 +1,50 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# 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

data/CONTRIBUTING.md

@@ -0,0 +1,58 @@
+Contributing
+============
+
+We love pull requests from everyone. By participating in this project, you agree
+to abide by the [contributor covenant].
+
+[contributor covenant v1.4]: http://contributor-covenant.org/version/1/4/
+
+Here's a quick guide for contributing:
+
+1. Fork the repo.
+
+2. Run the tests. We only take pull requests with passing tests, and it's great
+to know that you have a clean slate: `bundle && bundle exec rake`
+
+3. Add a test for your change. Only refactoring and documentation changes
+require no new tests. If you are adding functionality or fixing a bug, we need
+a test!
+
+4. Make the test pass.
+
+5. Push to your fork and submit a pull request.
+
+At this point you're waiting on us. We like to at least comment on, if not
+accept, pull requests within seven business days. We may suggest some changes or improvements or
+alternatives.
+
+Some things that will increase the chance that your pull request is accepted,
+taken straight from the Ruby on Rails guide:
+
+* Use Rails idioms and helpers
+* Include tests that fail without your code, and pass with it
+* Update the documentation, the surrounding one, examples elsewhere, guides,
+  whatever is affected by your contribution
+
+Running Tests
+-------------
+
+release_robot uses [cucumber]() for its unit tests. If you submit
+tests that are not written for cucumber without a very good reason, you
+will be asked to rewrite them before we'll accept.
+
+### To run a full test suite:
+
+    bundle exec rake
+
+This will run RSpec and Cucumber against all version of Rails
+
+### To run single test file
+
+    bundle exec rake test TEST=test/test_foobar.rb
+
+Syntax
+------
+
+Please follow the [Ruby style guide](https://github.com/bbatsov/ruby-style-guide).
+Rubocop will be used on Pull Requests. If you submit code that deviates from this style,
+you will be asked to justify it, and may be asked to change it.

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2017 Mammoth HR
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,40 @@
+# release_robot
+
+## Installation
+
+```bash
+$ rake install
+$ release_robot
+```
+
+## Usage
+
+This requires your Github username and password to authenticate and requires that you *do not* have 2-factor auth setup for Github. The gem will prompt you for those credentials on first run and store them in `~/.release_robot_settings.yml`.
+
+## What it does
+
+Currently, this gem will scan all repositories in the `MammothHR` Github account, collect any Pull Requests that are labeled with "Ready for Thursday Release" or "Ready for Immediate Release," change the base branch to `weekly-release`, determine the build status from Travis, parse any Podio URLs from the Pull Request body, and print out two summaries:
+  1. A verbose summary for posting to #releases channel, which shows the PR title, URL, Podio URL(s) if any, and the build status.
+  2. A terse summary with today's date and a bulleted list of PR titles and the repo to which they belong.
+
+## Next steps to automate
+
+- post reminder about updating versions in package.json if an addon is updated
+- tag repos with the correct tag
+  - For the most part, for Thursday releases, this will be the next minor version (i.e. if the last tag was v2.13.2, then next is v2.13.3).
+  - For hrsc and hrsc-ember, their tags should always be in sync
+- merge PRs with green builds (perhaps a separate script)
+  - delete branches after merge
+- check if there's a staging branch for merged branches and either
+  - include that in the notes, or
+  - auto teardown
+- mark Podio tasks as Complete after deploy (perhaps a separate script)
+- skip CI for all but the last merge to `weekly-release`
+  - Can be done by adding 'skip ci' to the merge commit (in the web interface, this can be done when “Confirm Merge” comes up; unsure about API)
+- figure out a standard way to define pre- or post-deploy steps so those can be included in the release prep somehow
+
+*"Nice to have" Slack integrations:*
+These would require setting up a slack bot server to receive Github webhooks
+- Post to #code-review-requests when the label "Needs Code Review" is added (https://developer.github.com/v3/activity/events/types/#labelevent)
+- Approved PR adds the :white_check_mark: reaction to the link posted in #code-review-requests (https://developer.github.com/v3/activity/events/types/#pullrequestreviewevent)
+- Merged PR automatically adds the :merge: reaction to the link posted in #code-review-requests (https://developer.github.com/v3/activity/events/types/#pullrequestevent)

data/Rakefile

@@ -0,0 +1,21 @@
+require 'rake/testtask'
+require 'bundler/gem_tasks'
+
+desc 'Run in IRB for debugging'
+task :console do
+  require 'irb'
+  require 'irb/completion'
+  require 'pp'
+  require 'yaml'
+  require 'octokit'
+  Dir[File.expand_path "lib/**/*.rb"].each{|file| require_relative file }
+  ARGV.clear
+  IRB.start
+end
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task default: :test

data/bin/release_robot

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require 'release_robot'
+require 'release_robot/version'
+require 'yaml'
+
+ReleaseRobot.run(ARGV)

data/lib/release_robot.rb

@@ -0,0 +1,134 @@
+require 'optparse'
+require 'optparse/date'
+require 'ostruct'
+require 'json'
+require 'octokit'
+require 'highline/import'
+require 'release_robot/main'
+require 'release_robot/printer'
+
+module ReleaseRobot
+  class << self
+    def run(args)
+      options = ReleaseRobot.parse(args)
+
+      create_settings_file_if_nonexistent
+
+      fetch_envars_from_config
+
+      missing_envars = get_missing_envars
+
+      write_missing_envars(missing_envars) if missing_envars.any?
+
+      robot = ReleaseRobot::Main.new
+      pull_requests = robot.start
+      client = robot.client
+
+      ReleaseRobot::Printer.new(pull_requests, client).print_all
+    end
+
+    def parse(args)
+      options = OpenStruct.new
+
+      opt_parser = OptionParser.new do |opts|
+        opts.separator ''
+        opts.banner = 'Usage: release_robot [options]'
+
+        opts.separator ''
+        opts.separator 'Common options:'
+
+        opts.on_tail('-h', '--help', 'Show this message') do
+          puts opts
+          exit
+        end
+
+        opts.on_tail('-v', '--version', 'Show version') do
+          puts ReleaseRobot::VERSION
+          exit
+        end
+      end
+
+      opt_parser.parse!(args)
+      options
+    end
+
+    def get_missing_envars
+      missing_envars = {}
+
+      ReleaseRobot.envars.each do |key|
+        next if ENV[key]
+        missing_envars[key] = get_envar(key)
+      end
+
+      return missing_envars
+    end
+
+    def get_envar(key)
+      if key =~ /GITHUB_PASSWORD/
+        env_value = ask("Enter your #{key}: ") { |q| q.echo = "*" }
+      else
+        print "Enter your #{key}: "
+        env_value = gets.chomp
+      end
+      env_value.strip! unless should_not_strip?(key)
+      if env_value.length == 0
+        puts 'Invalid input. This is a required field.'
+        exit
+      end
+      env_value
+    end
+
+    def should_not_strip?(key)
+      false
+    end
+
+    def fetch_envars_from_config
+      return unless envars = YAML.load_file(settings_file_path)
+      envars.each_pair do |key, value|
+        value.strip! unless should_not_strip?(key)
+        ENV[key.upcase] = value
+      end
+    end
+
+    def write_missing_envars(missing_envars={})
+      puts "\nTo avoid entering setup information each time, the following configuration has been stored in `#{settings_file_path}`:"
+      missing_envars.each_pair do |key, value|
+        if key =~ /password|token/i
+          puts "\t#{key}=[FILTERED]"
+        else
+          puts "\t#{key}=#{value}"
+        end
+
+        data = YAML.load_file(settings_file_path) || {}
+        ENV[key.upcase] = data[key.downcase] = value
+        File.open(settings_file_path, 'w') { |f| YAML.dump(data, f) }
+      end
+    end
+
+    def create_settings_file_if_nonexistent
+      File.new(settings_file_path, "w+") unless File.file?(settings_file_path)
+    end
+
+    def settings_file_path
+      File.join(ENV['HOME'], '.release_robot_settings.yml')
+    end
+
+    def root
+      File.dirname __dir__
+    end
+
+    def envars
+      envars_help.keys
+    end
+
+    def envars_help
+      {
+        'GITHUB_USERNAME' =>
+          "Your username for github.com\n\n",
+
+        'GITHUB_PASSWORD' =>
+          "Your password for github.com\n\n",
+      }
+    end
+  end
+end

data/lib/release_robot/main.rb

@@ -0,0 +1,88 @@
+module ReleaseRobot
+  class Main
+    RELEASE_BASE_BRANCH = 'weekly-release'.freeze
+    THURSDAY_LABEL = 'Ready for Thursday Release'.freeze
+    IMMEDIATE_LABEL = 'Ready for Immediate Release'.freeze
+
+    def start
+      repos.each do |repo|
+        next unless repo.owner.login == 'MammothHR'
+
+        repo_name = repo.full_name
+        puts "Fetching issues for #{repo_name}"
+
+        all_issues = labels.map do |label|
+          client.list_issues(repo_name, labels: label)
+        end.flatten
+
+        all_issues.each do |issue|
+          collect_pull_requests(repo_name, issue)
+        end
+      end
+
+      return pull_requests
+    end
+
+    def labels
+      [THURSDAY_LABEL, IMMEDIATE_LABEL]
+    end
+
+    def client
+      @client ||= Octokit::Client.new(
+        login: ENV['GITHUB_USERNAME'],
+        password: ENV['GITHUB_PASSWORD']
+      )
+    rescue => ex
+      puts "Failed: #{ex}"
+      puts '(Do you have the right Github username and password stored in'
+      puts 'GITHUB_USERNAME and GITHUB_PASSWORD?)'
+    end
+
+    def repos
+      @repos ||= client.repos(owner: 'MammothHR')
+    end
+
+    def pull_requests
+      @pull_requests ||= {
+        'success' => [],
+        'pending' => [],
+        'failure' => []
+      }
+    end
+
+    def collect_pull_requests(repo_name, issue)
+      print "- Determining build status for #{issue.number}"
+      pull_request = client.pull_request(repo_name, issue.number)
+
+      # Build status
+      status = client.combined_status(repo_name, pull_request.head.sha)
+
+      change_base(repo_name, pull_request)
+
+      sort_issue_by_status(issue, status.state, repo_name)
+    end
+
+    def change_base(repo_name, pull_request)
+      client.update_pull_request(
+        repo_name,
+        pull_request.number,
+        nil,
+        nil,
+        base: RELEASE_BASE_BRANCH
+      )
+    rescue Octokit::UnprocessableEntity => ex
+      puts "Error occurred when attempting to change base branch to #{RELEASE_BASE_BRANCH}:"
+      puts ex.message
+    end
+
+    def sort_issue_by_status(issue, status, repo_name)
+      case status
+      when 'success' then pull_requests['success'] << [repo_name, issue]
+      when 'pending' then pull_requests['pending'] << [repo_name, issue]
+      when 'failure' then pull_requests['failure'] << [repo_name, issue]
+      end
+
+      print " -- #{status}\n"
+    end
+  end
+end

data/lib/release_robot/printer.rb

@@ -0,0 +1,60 @@
+module ReleaseRobot
+  class Printer
+    PODIO_URL_REGEX = /https:\/\/podio.com\/hranswerlink-8ee92nawfl\/issue-tracker\/apps\/product-feedback\/items\/\d+/
+
+    attr_accessor :pull_requests, :client
+
+    def initialize(pull_requests, client)
+      @pull_requests = pull_requests
+      @client = client
+    end
+
+    def print_all
+      print_prep_list
+      print_deploy_list
+    end
+
+    def print_prep_list
+      print_title 'Prep list for #releases'
+
+      puts "For today's release:\n\n"
+
+      pull_requests.each_pair do |status, issues|
+        issues.each do |(repo_name, issue)|
+          puts issue.title
+          puts issue.html_url
+          podio_urls(repo_name, issue).each { |url| puts url }
+          puts "*Build #{status}*"
+          puts
+        end
+      end
+    end
+
+    def print_deploy_list
+      print_title 'List for #deploys'
+
+      puts Date.today.strftime('%D')
+
+      pull_requests.each_pair do |_, issues|
+        issues.each do |(repo_name, issue)|
+          slug = repo_name.gsub('MammothHR/', '')
+
+          puts "(#{slug}) #{issue.title}"
+        end
+      end
+    end
+
+    def print_title(title)
+      puts
+      puts '-' * 50
+      puts title
+      puts '-' * 50
+      puts
+    end
+
+    def podio_urls(repo_name, issue)
+      pr = client.pull_request(repo_name, issue.number)
+      pr.body.scan PODIO_URL_REGEX
+    end
+  end
+end

data/lib/release_robot/version.rb

@@ -0,0 +1,3 @@
+module ReleaseRobot
+  VERSION = '0.1.1'
+end

data/release_robot.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'release_robot/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'release_robot'
+  spec.version       = ReleaseRobot::VERSION
+  spec.authors       = ['Mark J. Lehman']
+  spec.email         = ['markopolo@gmail.com']
+  spec.description   = %q{Automate release tasks}
+  spec.summary       = %q{Automate tasks surrounding releasing and deploying new code, informing stakeholders, and getting feedback.}
+  spec.homepage      = 'https://github.com/MammothHR/release_robot'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.required_ruby_version = '>= 2.0'
+  spec.add_development_dependency 'pry', '~> 0'
+  spec.add_development_dependency 'bundler', '~> 1.3'
+  spec.add_development_dependency 'rake', '~> 10.5'
+
+  spec.add_runtime_dependency 'octokit', '~> 4.6.2', '>= 4.6.0'
+  spec.add_runtime_dependency 'highline', '~> 1.7.0', '>= 1.7.0'
+end

metadata

@@ -0,0 +1,140 @@
+--- !ruby/object:Gem::Specification
+name: release_robot
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Mark J. Lehman
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-08-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.5'
+- !ruby/object:Gem::Dependency
+  name: octokit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.6.2
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.6.2
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.6.0
+- !ruby/object:Gem::Dependency
+  name: highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.7.0
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.7.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.7.0
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.7.0
+description: Automate release tasks
+email:
+- markopolo@gmail.com
+executables:
+- release_robot
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- CONTRIBUTING.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/release_robot
+- lib/release_robot.rb
+- lib/release_robot/main.rb
+- lib/release_robot/printer.rb
+- lib/release_robot/version.rb
+- release_robot.gemspec
+homepage: https://github.com/MammothHR/release_robot
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.11
+signing_key: 
+specification_version: 4
+summary: Automate tasks surrounding releasing and deploying new code, informing stakeholders,
+  and getting feedback.
+test_files: []