groundskeeper-bitcore 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 22443d1b2eb3e74cb732993ae2162a17d28899f8
+  data.tar.gz: f64b1e9362ba9a7025afc5ed6b522f247bd2470b
+SHA512:
+  metadata.gz: 8833b8710aad1de7efe9b704a042ea49ae90d541933c302b72e5e1ecab89ed6a8bb2efc6171ab53a2e81502d4bcc87de988076bcb9f0bb4ff4c222ebd0a479b3
+  data.tar.gz: 194d6b7558ad5158d94adeaf816c405ba4142ce2fbe8c8bf8ddc27dc65b5a6a21419cda8bc44ce7edd111bf1bf927459e3b33997107bd21b35148cb36c93b831

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+groundskeeper-*.gem

data/.rubocop.yml

@@ -0,0 +1,35 @@
+AllCops:
+  Exclude:
+    - bin/**/*
+  TargetRubyVersion: 2.4
+
+AbcSize:
+  Exclude:
+    - test/**/*
+
+BlockLength:
+  Exclude:
+    - groundskeeper.gemspec
+
+ClassLength:
+  Exclude:
+    - test/**/*
+
+EmptyLineBetweenDefs:
+  Exclude:
+    - test/**/*
+
+MethodLength:
+  Exclude:
+    - test/**/*
+
+NestedMethodDefinition:
+  Exclude:
+    - test/**/*
+
+SingleLineMethods:
+  Exclude:
+    - test/**/*
+
+StringLiterals:
+  EnforcedStyle: double_quotes

data/.ruby-version

@@ -0,0 +1 @@
+2.4.0

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.4
+before_install: gem install bundler -v 1.15.1

data/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+## 0.1.1 - 2017-09-14
+
+* sign gem and update installation instructions (#37)
+* Update command highlighting (#36)
+* open pull request page in GitHub upon release (#34)
+* add tests to Commands#info method (#32)
+* fix bug preventing loading of project file (#31)
+* refactor and add smoke tests to Application (#30)
+* add tests to Project (#26)
+* refactor/rename some methods; add tests to Git (#25)
+* add code coverage to tests (#23)
+* add version to remote Jira issues; refactor (#21)
+* ask and push the tagged branch to remote (#20)
+* ignore release commits (#19)
+* begin to configure Jira integration (#18)
+* stage, commit, and tag release (#17)
+* detect missing Rails files (#16)
+* create a branch and update the changelog (#10)
+* capture current Rails application version (#8)
+* add release command; calculate next version (#7)
+* print branches which contain latest tag (#6)
+
+## 0.1.0 - 2017-07-18
+
+* refactor; capture commits since last tag (#4)
+* add "info" command (#3)
+* add executable `ground` (#2)
+* start scaffolding git and release code (#1)

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at ericcf@northwestern.edu. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in groundskeeper.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Eric Carty-Fickes
+
+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,93 @@
+# Groundskeeper
+
+The goal of this gem is to manage the workflow related to releasing and
+deploying Rails applications.
+
+## Installation
+
+Groundskeeper is cryptographically signed. To be sure this gem hasn't been
+tampered with, add the following public key if you have not already:
+
+```bash
+gem cert --add <(curl -Ls https://raw.github.com/NU-CBITS/groundskeeper/master/certs/ericcf.pem)
+```
+
+Install this gem globally via:
+
+```bash
+gem install groundskeeper -P HighSecurity
+```
+
+The HighSecurity trust profile will verify signed gems and require that all
+dependencies are signed.
+
+Note: if you have multiple versions of Ruby installed (via RVM e.g.), you will
+need to install this gem for each of them. In this example, your Rails
+application directory and the groundskeeper source are in the same parent
+directory:
+
+```bash
+gem install ../groundskeeper/groundskeeper-<version>.gem
+```
+
+Additionally, to integrate with Jira you will need to set some environment
+variables. One standard place to do this is in the `~/.bash_profile`:
+
+```bash
+export JIRA_USERNAME="my-username"
+export JIRA_PASSWORD="my-password"
+export JIRA_SITE="https://cbit123.atlassian.net"
+```
+
+Jira integration also depends on a repository that contains metadata for
+projects. Clone it as follows:
+
+```bash
+git clone git@github.com:NU-CBITS/project_details.git ~/.project_details
+```
+
+## Usage
+
+To display tag/release information about a Rails project, use the `info`
+command within a Rails application directory:
+
+```bash
+ground info
+```
+
+To create a new release tag, use the `release` command within a Rails
+application directory:
+
+```bash
+ground release
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run
+`rake test` to run the tests. You can also run `bin/console` for an interactive
+prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To
+release a new version, update the version number in `version.rb`, and then run
+`bundle exec rake release`, which will create a git tag for the version, push
+git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at
+https://github.com/NU-CBITS/groundskeeper. This project is intended to be a
+safe, welcoming space for collaboration, and contributors are expected to
+adhere to the [Contributor Covenant](http://contributor-covenant.org) code of
+conduct.
+
+## License
+
+The gem is available as open source under the terms of the
+[MIT License](http://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Groundskeeper project’s codebases, issue trackers,
+chat rooms and mailing lists is expected to follow the
+[code of conduct](https://github.com/NU-CBITS/groundskeeper/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+require "rubocop/rake_task"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task :default do
+  Rake::Task["test"].invoke
+  RuboCop::RakeTask.new
+  Rake::Task["rubocop"].invoke
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "groundskeeper"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/ground

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require "groundskeeper"
+
+Groundskeeper::Application.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/certs/ericcf.pem

@@ -0,0 +1,21 @@
+-----BEGIN CERTIFICATE-----
+MIIDhTCCAm2gAwIBAgIBATANBgkqhkiG9w0BAQUFADBEMQ8wDQYDVQQDDAZlcmlj
+Y2YxHDAaBgoJkiaJk/IsZAEZFgxub3J0aHdlc3Rlcm4xEzARBgoJkiaJk/IsZAEZ
+FgNlZHUwHhcNMTcwOTEyMjAwODQzWhcNMTgwOTEyMjAwODQzWjBEMQ8wDQYDVQQD
+DAZlcmljY2YxHDAaBgoJkiaJk/IsZAEZFgxub3J0aHdlc3Rlcm4xEzARBgoJkiaJ
+k/IsZAEZFgNlZHUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDk8FgP
+SIrleTjIXJT/yu+W9nujkvcIMRPbLqKq60KQy/2LANMZ7DiLZRBkg2oSK0D9p8GR
+be30F2DGAOSBZiBTLPDNAQZBpRVGeFpAAOEpREZ8ahaZVTfc8+IYSfxpnW2gaUte
+SfbG5xNcpHkRpwkbZGoq9yFOoaucxfwoz+9QunEFDiCAumn7uRMKHJdqSEpQnFkQ
+56GKuUvUuq7J+J4M+kwOK6a/4/Y8Bs/qUYH3GHa/0WJwfFLfp3gqhagLcZu40JFe
+mQpX3bAkmojuxyAi7JjXKqFv1LZgxAGca5SC6sECXiTkw9eXInBKzvBN33gOv+Vj
+9bot70L0EihaqJrnAgMBAAGjgYEwfzAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAd
+BgNVHQ4EFgQUsMK40utpv6yRQ3i0R7avJn3LQ/YwIgYDVR0RBBswGYEXZXJpY2Nm
+QG5vcnRod2VzdGVybi5lZHUwIgYDVR0SBBswGYEXZXJpY2NmQG5vcnRod2VzdGVy
+bi5lZHUwDQYJKoZIhvcNAQEFBQADggEBACvUVV3V8EYqV9DanJS3ywMVnQB5ByP1
+7TV70+Amnnu196Jp2JGJ27sjeE79VJeBbGyE0rCRUQXlaD2Zh8X6Yy04oWR0YFa8
+DQ3rqVmKTodTJ0K/rmpIMCbwrsyg7QRxfB6cUE+sgPX5ygDmj2gYY+fcw3MoVOif
+QY1i1gFSjcXvx0qnvQLnbD+gbr7D3wpfgFHRbBEDOuNdpFthggUO6eFraVYcsz9u
+1v/mC2s7Cj+Jv053bCKPjSk2wLLZpHRs40jXgy/NudtouDy2yYlJHxBFfdeRNEk2
+fo8I5WeWdUoEzUI6WlkTjMw3nWezlF0LCGz781P4qvtz0BICgaS41qw=
+-----END CERTIFICATE-----

data/groundskeeper.gemspec

@@ -0,0 +1,46 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "groundskeeper/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "groundskeeper-bitcore"
+  spec.version       = Groundskeeper::VERSION
+  spec.authors       = ["BIT Core"]
+  spec.email         = ["ericcf@northwestern.edu"]
+
+  spec.summary       = "A gem for managing releases and deployments."
+  spec.homepage      = "https://github.com/NU-CBITS/groundskeeper.git"
+  spec.license       = "MIT"
+  spec.cert_chain    = ["certs/ericcf.pem"]
+  if $PROGRAM_NAME.end_with?("gem")
+    spec.signing_key = File.expand_path("~/.ssh/gem-private_key.pem")
+  end
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the
+  # 'allowed_push_host' to allow pushing to a single host or delete this
+  # section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata["allowed_push_host"] = "https://rubygems.org"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against " \
+      "public gem pushes."
+  end
+
+  spec.files = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "bin"
+  spec.executables   = "ground"
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "jira-ruby", "~> 1.3"
+  spec.add_dependency "thor", "~> 0.19"
+
+  spec.add_development_dependency "bundler", "~> 1.15"
+  spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency "rubocop", "~> 0.49.1"
+  spec.add_development_dependency "simplecov", "~> 0.14"
+end

data/lib/groundskeeper/application.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "thor"
+
+module Groundskeeper
+  # Bootstrap this as a Thor application.
+  class Application < Thor
+    attr_reader :commands
+
+    def initialize(args = [], local_options = {}, config = {})
+      @commands = Commands.build(self)
+      super
+    end
+
+    desc "info", "Display revision info"
+    def info
+      commands.info
+    end
+
+    desc "release", "create a new release"
+    def release
+      commands.info
+      commands.release
+    end
+  end
+end

data/lib/groundskeeper/changelog.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require "date"
+
+module Groundskeeper
+  # The `CHANGELOG.md` file in an application.
+  class Changelog
+    attr_reader :document, :date
+
+    FILENAME = "CHANGELOG.md"
+    TITLE_EXPRESSION = "# Changelog"
+
+    def self.build(filename: FILENAME)
+      new(
+        document: Groundskeeper::Document.new(filename),
+        date: Date.today.iso8601
+      )
+    end
+
+    def initialize(document:, date:)
+      @document = document
+      @date = date
+    end
+
+    # rubocop:disable Performance/RedundantMatch,Performance/RegexpMatch
+    def update_file(version, changes)
+      unless document.match(/(#{TITLE_EXPRESSION})/)
+        document.prepend_file("#{TITLE_EXPRESSION}\n\n")
+      end
+
+      document
+        .append_to_file(TITLE_EXPRESSION, version_template(version, changes))
+    end
+    # rubocop:enable Performance/RedundantMatch,Performance/RegexpMatch
+
+    private
+
+    def version_template(version, changes)
+      ["\n", "## #{version} - #{date}", ""]
+        .concat(changes.map { |change| "* #{change}" })
+        .join("\n")
+    end
+  end
+end

data/lib/groundskeeper/commands.rb

@@ -0,0 +1,199 @@
+# frozen_string_literal: true
+
+module Groundskeeper
+  # Formulas for managing releases.
+  # rubocop:disable Metrics/ClassLength
+  class Commands
+    # rubocop:disable Metrics/MethodLength
+    def self.build(console)
+      repository = Repository.new
+      project = Project.build(repository.name)
+      git_hub = GitHub.build(
+        username: project.source_control_username,
+        repository_name: repository.name
+      )
+
+      new(
+        changelog: Changelog.build,
+        console: console,
+        git: Git.build,
+        git_hub: git_hub,
+        jira: Jira.build(project.jira_prefix),
+        repository: repository,
+        project: project,
+        version_file: RailsVersion.new
+      )
+    end
+    # rubocop:enable Metrics/MethodLength
+
+    # rubocop:disable Metrics/ParameterLists
+    def initialize(
+      changelog: nil,
+      console:,
+      git: nil,
+      git_hub: nil,
+      jira: nil,
+      project: nil,
+      repository: nil,
+      version_file:
+    )
+      @changelog = changelog
+      @console = console
+      @git = git
+      @git_hub = git_hub
+      @jira = jira
+      @project = project
+      @repository = repository
+      @version_file = version_file
+      @did_checkout_branch = false
+      @did_push_to_remote = false
+    end
+    # rubocop:enable Metrics/ParameterLists
+
+    # rubocop:disable Metrics/MethodLength
+    def info
+      return unrecognized_version unless version_file.exists?
+
+      announce_version
+      announce_latest_tag
+      console.say(
+        "version in current branch: " +
+        version_file.current_version,
+        :yellow
+      )
+      console.say(
+        "tag contained in: #{git.branches_containing_latest_tag}\n\n",
+        :yellow
+      )
+    end
+
+    def release
+      return unrecognized_version unless version_file.exists?
+
+      summarize_recent_commits
+      ask_next_version
+      ask_new_branch
+      update_version_file
+      update_changelog
+      commit_changes_and_tag
+      ask_create_jira_version
+      ask_push_with_tags
+      ask_add_version_to_jira_issues
+      open_pull_request_page
+    end
+    # rubocop:enable Metrics/MethodLength
+
+    private
+
+    # collaborators
+    attr_reader :changelog, :console, :git, :git_hub, :jira, :project,
+                :repository, :version_file
+    # state
+    attr_reader :next_version, :recent_commits, :did_checkout_branch,
+                :did_push_to_remote
+
+    def announce_version
+      console.say("Groundskeeper version #{Groundskeeper::VERSION}\n\n", :bold)
+    end
+
+    def announce_latest_tag
+      console.say(
+        "latest tag on this repository: " +
+        git.latest_tag_name_across_branches,
+        :yellow
+      )
+    end
+
+    def summarize_recent_commits
+      console.say("commits since last tag", :bold)
+      @recent_commits = repository.changes_since_latest_tag
+      console.say(recent_commits.join("\n"), :green)
+      console.say("")
+    end
+
+    def ask_next_version
+      type = console.ask(
+        "Major, minor, or patch release?",
+        :cyan,
+        limited_to: %w[M m p]
+      )
+      @next_version = repository.bumped_semantic_version(type)
+      console.say("next tag will be: #{next_version}", :green)
+    end
+
+    def ask_new_branch
+      @did_checkout_branch = console.yes?(
+        "Checkout new branch #{new_branch_name}? [y, n]",
+        :cyan
+      )
+      git.create_and_checkout_branch(new_branch_name) if did_checkout_branch
+    end
+
+    def update_version_file
+      version_file.update_version! next_version
+      console.say("# updated version file", :green)
+    end
+
+    def update_changelog
+      changelog.update_file(next_version, recent_commits)
+      console.say("# updated changelog", :green)
+    end
+
+    def commit_changes_and_tag
+      git.add_update
+      git.commit(format(Repository::RELEASE_MESSAGE, next_version))
+      console.say("# committed changes", :green)
+      git.add_tag(next_version)
+      console.say("# tagged", :green)
+    end
+
+    def ask_create_jira_version
+      create_jira_version =
+        console.yes?("Create version #{next_version} in Jira? [y, n]", :cyan)
+      jira.create_remote_version(next_jira_version_name) if create_jira_version
+    end
+
+    def ask_push_with_tags
+      @did_push_to_remote = console.yes?(
+        "Push to remote with tags? [y, n]",
+        :cyan
+      )
+      git.push_with_tags && console.say("# pushed tag") if @did_push_to_remote
+    end
+
+    def ask_add_version_to_jira_issues
+      issue_ids = jira.included_issues(recent_commits)
+      add_version_to_jira_issues = console.yes?(
+        "Add #{next_jira_version_name} to #{issue_ids}? [y, n]",
+        :cyan
+      )
+
+      return unless add_version_to_jira_issues
+
+      jira.add_version_to_remote_issues(next_jira_version_name, issue_ids)
+      console.say("# added version to Jira issues", :green)
+    end
+
+    def next_jira_version_name
+      "#{repository.name} #{next_version}"
+    end
+
+    def unrecognized_version
+      console.say(
+        "Unable to find version file, is this a Rails application?",
+        :red
+      )
+    end
+
+    def open_pull_request_page
+      return unless did_checkout_branch && did_push_to_remote
+
+      git_hub.open_pull_request_page(new_branch_name)
+    end
+
+    def new_branch_name
+      "v#{next_version}"
+    end
+  end
+  # rubocop:enable Metrics/ClassLength
+end

data/lib/groundskeeper/document.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Groundskeeper
+  # Wraps files.
+  class Document
+    attr_reader :path
+
+    def initialize(path)
+      @path = File.expand_path(path)
+    end
+
+    def exists?
+      File.exist? path
+    end
+
+    # Returns the first captured expression or nil if it is not found.
+    def match(expression_with_capture)
+      content = read
+      match = content.match(expression_with_capture)
+
+      match[1] if match
+    end
+
+    # Replaces the expression with the provided value in place in the file.
+    def gsub_file(expression, value)
+      content = read
+      content.gsub! expression, value
+      write_file content
+    end
+
+    # Inserts the provided value after the expression in place in the file.
+    def append_to_file(expression, value)
+      content = read
+      match = content.match(expression)[0]
+      content.gsub! expression, match + value
+      write_file content
+    end
+
+    # Inserts the provided value at the beginning of the file.
+    def prepend_file(value)
+      content = read
+      write_file(value + content)
+    end
+
+    def write_file(content)
+      File.open(path, "wb") { |file| file.write(content) }
+    end
+
+    def read
+      return "" unless exists?
+
+      File.binread(path)
+    end
+  end
+end

data/lib/groundskeeper/git.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module Groundskeeper
+  # Wraps git executable and adds a few convenience methods on top.
+  class Git
+    COMMAND = "git"
+    # git arguments
+    STATUS = "status"
+    FETCH_WITH_TAGS = "fetch --tags"
+    VERSION = "--version"
+    TAGS_ASC = "tag -l --sort=v:refname"
+    LATEST_TAG_COMMIT = "#{COMMAND} rev-list --tags --max-count=1"
+    LATEST_TAG_NAME = format("describe --tags $(%s)", LATEST_TAG_COMMIT)
+    LATEST_TAG_BRANCHES = format("branch --contains $(%s)", LATEST_TAG_COMMIT)
+    LATEST_CHANGES = "log %s..HEAD --oneline"
+    CREATE_AND_CHECKOUT_BRANCH = "checkout -b %s"
+    ADD_UPDATE = "add -u"
+    COMMIT = "commit -m \"%s\""
+    ADD_TAG = "tag %s"
+    PUSH_HEAD_WITH_TAGS = "push origin head --tags"
+
+    attr_reader :git
+
+    # Wraps the "git" shell command.
+    class Executable
+      def execute(arguments)
+        `#{COMMAND} #{arguments}`
+      end
+    end
+
+    def self.build
+      new Executable.new
+    end
+
+    def initialize(git)
+      @git = git
+    end
+
+    def status
+      git.execute(STATUS)
+    end
+
+    def fetch
+      git.execute(FETCH_WITH_TAGS)
+    end
+
+    def version
+      semantic_version = /\d+.\d+.\d+/
+
+      git.execute(VERSION).match(semantic_version)[0]
+    end
+
+    def list_tags
+      git.execute(TAGS_ASC)
+    end
+
+    def latest_tag_name_across_branches
+      git.execute(LATEST_TAG_NAME).chop
+    end
+
+    def branches_containing_latest_tag
+      git.execute(LATEST_TAG_BRANCHES).split("\n").map(&:strip)
+    end
+
+    def raw_changes_since_latest_tag
+      latest_changes = format(LATEST_CHANGES, latest_tag_name_across_branches)
+
+      git.execute(latest_changes).split("\n")
+    end
+
+    def create_and_checkout_branch(name)
+      git.execute(format(CREATE_AND_CHECKOUT_BRANCH, name))
+    end
+
+    def add_update
+      git.execute(ADD_UPDATE)
+    end
+
+    def commit(message)
+      git.execute(format(COMMIT, message))
+    end
+
+    def add_tag(name)
+      git.execute(format(ADD_TAG, name))
+    end
+
+    def push_with_tags
+      git.execute(PUSH_HEAD_WITH_TAGS)
+    end
+  end
+end

data/lib/groundskeeper/git_hub.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Groundskeeper
+  # Wraps an interface to GitHub.
+  class GitHub
+    attr_reader :opener, :username, :repository_name
+
+    COMMAND = "open"
+    URL_BASE = "https://github.com/"
+
+    # Wraps the "open" shell command.
+    class Executable
+      def execute(arguments)
+        `#{COMMAND} #{arguments}`
+      end
+    end
+
+    def self.build(username:, repository_name:)
+      new(
+        opener: Executable.new,
+        username: username,
+        repository_name: repository_name
+      )
+    end
+
+    def initialize(opener:, username:, repository_name:)
+      @opener = opener
+      @username = username
+      @repository_name = repository_name
+    end
+
+    def open_pull_request_page(branch_name)
+      url = "#{URL_BASE}#{username}/#{repository_name}/compare/" \
+            "#{branch_name}?expand=1"
+
+      opener.execute(url)
+    end
+  end
+end

data/lib/groundskeeper/jira.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require "date"
+require "jira-ruby"
+
+module Groundskeeper
+  # Wraps an interface to Jira.
+  class Jira
+    attr_reader :client, :prefix
+
+    ISSUE_PATTERN = "%s-\\d+"
+
+    # Wraps the jira-ruby Client class.
+    class JiraClient
+      attr_reader :client
+
+      def initialize
+        @client = JIRA::Client.new(
+          username: ENV["JIRA_USERNAME"],
+          password: ENV["JIRA_PASSWORD"],
+          site: ENV["JIRA_SITE"],
+          context_path: "",
+          auth_type: :basic,
+          read_timeout: 120
+        )
+      end
+
+      def create_version(name:, prefix:)
+        client.Version
+              .build
+              .save(name: name, project: prefix)
+      end
+
+      def add_version_to_issue(issue_id:, version_name:)
+        client.Issue
+              .find(issue_id)
+              .save(update: { fixVersions: [{ add: { name: version_name } }] })
+      end
+    end
+
+    def self.build(prefix)
+      new(
+        prefix: prefix,
+        client: JiraClient.new
+      )
+    end
+
+    def initialize(client: nil, prefix: nil)
+      @prefix = prefix
+      @client = client
+    end
+
+    # Returns the list of Jira issues found in a set of commit messages.
+    def included_issues(changes)
+      issue_expression = /#{format(ISSUE_PATTERN, prefix)}/
+
+      changes.map { |change| change.scan(issue_expression) }.flatten.compact
+    end
+
+    def create_remote_version(name)
+      client.create_version(name: name, prefix: prefix)
+    end
+
+    def add_version_to_remote_issues(name, issue_ids)
+      issue_ids.each do |issue_id|
+        client.add_version_to_issue(issue_id: issue_id, version_name: name)
+      end
+    end
+  end
+end

data/lib/groundskeeper/project.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require "yaml"
+
+module Groundskeeper
+  # Accesses project details stored in the home directory.
+  class Project
+    attr_reader :details
+
+    DETAILS_PATH = "~/.project_details/projects.yml"
+    JIRA_PREFIX_KEY = "jira_prefix"
+    PROJECT_NAME_KEY = "name"
+    SOURCE_CONTROL_USERNAME_KEY = "scm_username"
+
+    def self.build(repository_name)
+      new(
+        yaml: Document.new(DETAILS_PATH).read,
+        repository_name: repository_name
+      )
+    end
+
+    def initialize(yaml:, repository_name:)
+      projects = YAML.safe_load(yaml) || {}
+      @details = projects[repository_name] || {}
+    end
+
+    def project_name
+      details[PROJECT_NAME_KEY] || ""
+    end
+
+    def jira_prefix
+      details[JIRA_PREFIX_KEY] || ""
+    end
+
+    def source_control_username
+      details[SOURCE_CONTROL_USERNAME_KEY] || ""
+    end
+  end
+end

data/lib/groundskeeper/rails_version.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Groundskeeper
+  # The `version.rb` file in an application.
+  class RailsVersion
+    APPLICATION_CONFIG_FILE = "%sconfig/application.rb"
+    MODULE_NAME_EXPRESSION = /module (\w+)/
+    VERSION_FILE = "%slib/%s/version.rb"
+    VERSION_EXPRESSION = /(?<=VERSION = ")([^"]+)(?=")/
+
+    attr_reader :relative_path, :module_file, :version_file
+
+    def initialize(relative_path = "")
+      @relative_path = relative_path
+      find_version_file
+    end
+
+    def current_version
+      version_file.match(VERSION_EXPRESSION) || ""
+    end
+
+    def update_version!(value)
+      version_file.gsub_file VERSION_EXPRESSION, value
+    end
+
+    def exists?
+      version_file.exists?
+    end
+
+    private
+
+    def find_module_file
+      @module_file = Groundskeeper::Document.new(module_file_path)
+    end
+
+    def find_version_file
+      find_module_file
+      @version_file = Groundskeeper::Document.new(version_file_path)
+    end
+
+    def module_file_path
+      format APPLICATION_CONFIG_FILE, relative_path
+    end
+
+    def version_file_path
+      format VERSION_FILE, relative_path, project_namespace
+    end
+
+    def project_namespace
+      underscore(module_file.match(MODULE_NAME_EXPRESSION))
+    end
+
+    def underscore(word)
+      return "" unless word.respond_to?(:gsub)
+
+      word
+        .gsub(/([A-Z\d]+)([A-Z][a-z])/, '\1_\2')
+        .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+        .downcase
+    end
+  end
+end

data/lib/groundskeeper/repository.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module Groundskeeper
+  # A Git repository.
+  class Repository
+    MAJOR = "major"
+    MINOR = "minor"
+    PATCH = "patch"
+    SEMANTIC_RELEASE_TYPE = { M: MAJOR, m: MINOR, p: PATCH }.freeze
+    # git output matching
+    ON_BRANCH_MASTER = "On branch master"
+    UP_TO_DATE = "Your branch is up-to-date with 'origin/master'"
+    UNSTAGED_CHANGES = "Changes not staged for commit"
+    # git comment matching
+    COMMIT_HASH = /^[^ ]+ /
+    RELEASE_MESSAGE = "release version %s"
+
+    attr_reader :git
+
+    def initialize(git: nil)
+      @git = git || Git.build
+    end
+
+    def clean_directory?
+      on_branch_master? && up_to_date? && !unstaged_changes?
+    end
+
+    def on_branch_master?
+      git.status.include? ON_BRANCH_MASTER
+    end
+
+    def up_to_date?
+      git.status.include? UP_TO_DATE
+    end
+
+    def unstaged_changes?
+      git.status.include? UNSTAGED_CHANGES
+    end
+
+    def status
+      @status ||= begin
+        git.fetch
+
+        git.status
+      end
+    end
+
+    def changes_since_latest_tag
+      git
+        .raw_changes_since_latest_tag
+        .map { |c| c.gsub(COMMIT_HASH, "") }
+        .reject { |c| c.match(/#{format(RELEASE_MESSAGE, "")}/) }
+    end
+
+    # rubocop:disable Metrics/MethodLength
+    def bumped_semantic_version(type)
+      major, minor, patch = git
+                            .latest_tag_name_across_branches
+                            .split(".")
+                            .map(&:to_i)
+
+      case SEMANTIC_RELEASE_TYPE[type.to_sym]
+      when MAJOR
+        "#{major + 1}.0.0"
+      when MINOR
+        "#{major}.#{minor + 1}.0"
+      when PATCH
+        "#{major}.#{minor}.#{patch + 1}"
+      end
+    end
+    # rubocop:enable Metrics/MethodLength
+
+    def name
+      `pwd`.split("/").last.chop
+    end
+  end
+end

data/lib/groundskeeper/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Groundskeeper
+  VERSION = "0.1.1"
+end

data/lib/groundskeeper.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require "groundskeeper/application"
+require "groundskeeper/changelog"
+require "groundskeeper/commands"
+require "groundskeeper/document"
+require "groundskeeper/git"
+require "groundskeeper/git_hub"
+require "groundskeeper/jira"
+require "groundskeeper/project"
+require "groundskeeper/rails_version"
+require "groundskeeper/repository"
+require "groundskeeper/version"
+
+# :reek:IrresponsibleModule
+module Groundskeeper
+end

data.tar.gz.sig

@@ -0,0 +1,2 @@
+YN����� �@D����8��vr�F�Ϸ�ܓ�O�7��>���P}j��
+iZDh4>�3��%ɻ�mr����v3��b��0_Fk��B�u&�y��;�G��3C-ɣ��g�ݕîw捀IR~�w��gm���Q��_=~V5���2SU^���%�O��|~ր;�]�f(���

metadata

@@ -0,0 +1,179 @@
+--- !ruby/object:Gem::Specification
+name: groundskeeper-bitcore
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- BIT Core
+autorequire: 
+bindir: bin
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDhTCCAm2gAwIBAgIBATANBgkqhkiG9w0BAQUFADBEMQ8wDQYDVQQDDAZlcmlj
+  Y2YxHDAaBgoJkiaJk/IsZAEZFgxub3J0aHdlc3Rlcm4xEzARBgoJkiaJk/IsZAEZ
+  FgNlZHUwHhcNMTcwOTEyMjAwODQzWhcNMTgwOTEyMjAwODQzWjBEMQ8wDQYDVQQD
+  DAZlcmljY2YxHDAaBgoJkiaJk/IsZAEZFgxub3J0aHdlc3Rlcm4xEzARBgoJkiaJ
+  k/IsZAEZFgNlZHUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDk8FgP
+  SIrleTjIXJT/yu+W9nujkvcIMRPbLqKq60KQy/2LANMZ7DiLZRBkg2oSK0D9p8GR
+  be30F2DGAOSBZiBTLPDNAQZBpRVGeFpAAOEpREZ8ahaZVTfc8+IYSfxpnW2gaUte
+  SfbG5xNcpHkRpwkbZGoq9yFOoaucxfwoz+9QunEFDiCAumn7uRMKHJdqSEpQnFkQ
+  56GKuUvUuq7J+J4M+kwOK6a/4/Y8Bs/qUYH3GHa/0WJwfFLfp3gqhagLcZu40JFe
+  mQpX3bAkmojuxyAi7JjXKqFv1LZgxAGca5SC6sECXiTkw9eXInBKzvBN33gOv+Vj
+  9bot70L0EihaqJrnAgMBAAGjgYEwfzAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAd
+  BgNVHQ4EFgQUsMK40utpv6yRQ3i0R7avJn3LQ/YwIgYDVR0RBBswGYEXZXJpY2Nm
+  QG5vcnRod2VzdGVybi5lZHUwIgYDVR0SBBswGYEXZXJpY2NmQG5vcnRod2VzdGVy
+  bi5lZHUwDQYJKoZIhvcNAQEFBQADggEBACvUVV3V8EYqV9DanJS3ywMVnQB5ByP1
+  7TV70+Amnnu196Jp2JGJ27sjeE79VJeBbGyE0rCRUQXlaD2Zh8X6Yy04oWR0YFa8
+  DQ3rqVmKTodTJ0K/rmpIMCbwrsyg7QRxfB6cUE+sgPX5ygDmj2gYY+fcw3MoVOif
+  QY1i1gFSjcXvx0qnvQLnbD+gbr7D3wpfgFHRbBEDOuNdpFthggUO6eFraVYcsz9u
+  1v/mC2s7Cj+Jv053bCKPjSk2wLLZpHRs40jXgy/NudtouDy2yYlJHxBFfdeRNEk2
+  fo8I5WeWdUoEzUI6WlkTjMw3nWezlF0LCGz781P4qvtz0BICgaS41qw=
+  -----END CERTIFICATE-----
+date: 2017-09-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: jira-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.49.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.49.1
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+description: 
+email:
+- ericcf@northwestern.edu
+executables:
+- ground
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- ".ruby-version"
+- ".travis.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/ground
+- bin/setup
+- certs/ericcf.pem
+- groundskeeper.gemspec
+- lib/groundskeeper.rb
+- lib/groundskeeper/application.rb
+- lib/groundskeeper/changelog.rb
+- lib/groundskeeper/commands.rb
+- lib/groundskeeper/document.rb
+- lib/groundskeeper/git.rb
+- lib/groundskeeper/git_hub.rb
+- lib/groundskeeper/jira.rb
+- lib/groundskeeper/project.rb
+- lib/groundskeeper/rails_version.rb
+- lib/groundskeeper/repository.rb
+- lib/groundskeeper/version.rb
+homepage: https://github.com/NU-CBITS/groundskeeper.git
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+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.8
+signing_key: 
+specification_version: 4
+summary: A gem for managing releases and deployments.
+test_files: []

metadata.gz.sig

@@ -0,0 +1,3 @@
+z#Vg!Kj�*�-�@�/.�u���M]�3�Coe�*�n�WZq^�RY!,���Ӫ.���3�,��)�k�0:��%(B��
���H?�@$�'�K�Mra�*�`DO��)
+�M/��Y,�����~kh�������Q��GD"�����Qၔn�l�������tlq���D,�P�TSH�'_�	�MrO�r� 9�I$Ra)_]���MC-��F1�6j����36G�̶ѥU�r—��� �F�
+%