chandler 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1b4381b69c5976f8de750c7756837e6da82031b1
+  data.tar.gz: ff127a8a9970f75de6922b618a913f2bd2fc815f
+SHA512:
+  metadata.gz: ff2f30b2a72f70e11f27105e27c12c144e2540d173af10975b11bb554db2a2d5d4b341c578412e3a90923987be5ac7caf3834480d3802d7be52dbe68ec100fa0
+  data.tar.gz: 11e84ada787c62a276c9f9f9345c2b052d51eda75a38c3bc52b10f36189baa10153acf6fffa020f32797aa8a763ba4692ad9628c4a9265fbe65c1553379b8b0b

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rubocop.yml

@@ -0,0 +1,33 @@
+AllCops:
+  Exclude:
+    - "*.gemspec"
+
+Metrics/AbcSize:
+  Exclude:
+    - "test/**/*"
+
+Metrics/MethodLength:
+  Exclude:
+    - "test/**/*"
+
+Metrics/ClassLength:
+  Exclude:
+    - "test/**/*"
+
+Style/ClassAndModuleChildren:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Style/DoubleNegation:
+  Enabled: false
+
+Style/HashSyntax:
+  EnforcedStyle: hash_rockets
+
+Style/SpaceAroundEqualsInParameterDefault:
+  EnforcedStyle: no_space
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 2.1
+  - 2.2
+before_install: gem install bundler -v 1.10.4

data/CHANGELOG.md

@@ -0,0 +1,16 @@
+# chandler Change Log
+
+All notable changes to this project will be documented in this file.
+
+chandler is in a pre-1.0 state. This means that its APIs and behavior are subject to breaking changes without deprecation notices. Until 1.0, version numbers will follow a [Semver][]-ish `0.y.z` format, where `y` is incremented when new features or breaking changes are introduced, and `z` is incremented for lesser changes or bug fixes.
+
+## [Unreleased]
+
+* Your contribution here!
+
+## 0.1.0 (2015-06-19)
+
+* Initial release
+
+[Semver]: http://semver.org
+[Unreleased]: https://github.com/mattbrictson/airbrussh/compare/v0.1.0...HEAD

data/CONTRIBUTING.md

@@ -0,0 +1,26 @@
+# Contributing to chandler
+
+Have a feature idea, bug fix, or refactoring suggestion? Contributions are welcome!
+
+## Pull requests
+
+1. Check [Issues][] to see if your contribution has already been discussed and/or implemented.
+2. If not, open an issue to discuss your contribution. I won't accept all changes and do not want to waste your time.
+3. Once you have the :thumbsup:, fork the repo, make your changes, and open a PR.
+4. Don't forget to add your contribution and credit yourself in `CHANGELOG.md`!
+
+## Coding guidelines
+
+* This project has a coding style enforced by [rubocop][]. Use hash rockets and double-quoted strings, and otherwise try to follow the [Ruby style guide][style].
+* Writing tests is strongly encouraged! This project uses Minitest.
+
+## Getting started
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/console` for an interactive prompt that will allow you to experiment. To run your checked-out version of chandler, use `bundle exec chandler`.
+
+To execute chandler's tests and rubocop checks, run `rake`.
+
+
+[Issues]: https://github.com/mattbrictson/chandler/issues
+[rubocop]: https://github.com/bbatsov/rubocop
+[style]: https://github.com/bbatsov/ruby-style-guide

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in chandler.gemspec
+gemspec

data/Guardfile

@@ -0,0 +1,6 @@
+guard :minitest do
+  # with Minitest::Unit
+  watch(%r{^test/(.*)\/?(.*)_test\.rb$})
+  watch(%r{^lib/(.*/)?([^/]+)\.rb$})     { |m| "test/#{m[1]}#{m[2]}_test.rb" }
+  watch(%r{^test/minitest_helper\.rb$})  { "test" }
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Matt Brictson
+
+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,107 @@
+# chandler
+
+[![Gem Version](https://badge.fury.io/rb/chandler.svg)](http://badge.fury.io/rb/chandler)
+[![Build Status](https://travis-ci.org/mattbrictson/chandler.svg?branch=master)](https://travis-ci.org/mattbrictson/chandler)
+
+**chandler syncs your CHANGELOG entries to GitHub's release notes so you don't have to enter release notes manually.** For Ruby projects, you can even add chandler to your gem's Rakefile to make this an automatic part of your release process!
+
+### How does it work?
+
+chandler scans your git repository for version tags (e.g. `v1.0.2`), parses out the corresponding release notes for those tags from your CHANGELOG, and uploads those notes to the GitHub releases area via the GitHub API.
+
+### Why go through the trouble?
+
+GitHub's releases feature is a nice UI for browsing the history of your project and downloading snapshots of each version. It is also structured data that can be queried via GitHub's API, making it a available for third-party integrations. For example, [Sibbell][] can automatically send the release notes out to interested parties whenever you publish a new version.
+
+Of course, as a considerate developer you also want to have a plain text CHANGELOG that travels with the code, can be collaboratively edited in pull requests, and so on. But that means you need two copies of the same release notes!
+
+chandler takes the hassle out of maintaining these two separate formats: your CHANGELOG is the authoritative source, and GitHub releases are updated with a simple `chandler` command.
+
+## Requirements
+
+* Ruby 2.1 or higher
+* Your project's CHANGELOG must be in Markdown with version numbers in the headings (similar to the format advocated by [keepachangelog.com](http://keepachangelog.com))
+* You must be an owner or collaborator of the GitHub repository to update its releases
+
+## Installation
+
+### 1. Install the gem
+
+```
+gem install chandler
+```
+
+### 2. Configure .netrc
+
+In order to access the GitHub API on your behalf, you must provide chandler with your GitHub credentials. Do this by creating a `~/.netrc` file with your GitHub username and password, like this:
+
+```
+machine api.github.com
+  login defunkt
+  password c0d3b4ssssss!
+```
+
+For more security, you can use an OAuth access token in place of your password. [Here's how to generate one][access-token].
+
+
+## Usage
+
+To push all CHANGELOG entries for all tags to GitHub, just run:
+
+```
+chandler push
+```
+
+chandler will make educated guesses as to what GitHub repository to use, the location of the CHANGELOG, and the tags that represent releases. To see what will happen without actually making changes, run:
+
+```
+chandler push --dry-run
+```
+
+To upload only a specific tag, `v1.0.2` for example:
+
+```
+chandler push v1.0.2
+```
+
+Other command-line options:
+
+* `--git=/path/to/project/.git` – location of the local git repository (defaults to `.git`)
+* `--github=username/repo` – GitHub repository to upload to (if unspecified, chandler will guess based on your git remotes)
+* `--changelog=History.md` – location of the CHANGELOG (defaults to `CHANGELOG.md`)
+
+
+## Rakefile integration
+
+If you maintain a Ruby gem and use Bundler's gem tasks (i.e. `rake release`) to publish your gem, then you can use chandler to automate update your GitHub release notes.
+
+### 1. Update the gemspec
+
+```ruby
+spec.add_development_dependency "chandler"
+```
+
+### 2. Modify the Rakefile
+
+```ruby
+require "bundler/gem_tasks"
+require "chandler/tasks"
+
+# Optional: override default chandler configuration
+Chandler::Tasks.configure do |config|
+  config.changelog_path = "History.md"
+  config.github_repository = "mattbrictson/mygem"
+end
+
+# Add chandler as a prerequisite for `rake release`
+task "release:rubygem_push" => "chandler:push"
+```
+
+That's it! Now when you run `rake release`, your GitHub release notes will be updated automatically based on your CHANGELOG entries.
+
+[Sibbell]: http://sibbell.com
+[access-token]: https://help.github.com/articles/creating-an-access-token-for-command-line-use/
+
+## Contributing
+
+Contributions are welcome! Read [CONTRIBUTING.md](CONTRIBUTING.md) to get started.

data/Rakefile

@@ -0,0 +1,17 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+require "rubocop/rake_task"
+
+$LOAD_PATH.unshift File.expand_path("../lib", __FILE__)
+require "chandler/tasks"
+task "release:rubygem_push" => "chandler:push"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+RuboCop::RakeTask.new
+
+task :default => [:test, :rubocop]

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "chandler"
+
+# 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

data/bin/setup

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

data/chandler.gemspec

@@ -0,0 +1,36 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'chandler/version'
+
+Gem::Specification.new do |spec|
+  spec.required_ruby_version = ">= 2.1.0"
+
+  spec.name          = "chandler"
+  spec.version       = Chandler::VERSION
+  spec.authors       = ["Matt Brictson"]
+  spec.email         = ["chandler@mattbrictson.com"]
+
+  spec.summary       = "Syncs CHANGELOG entries to GitHub's release notes"
+  spec.homepage      = "https://github.com/mattbrictson/chandler"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "netrc"
+  spec.add_dependency "octokit", ">= 2.2.0"
+
+  spec.add_development_dependency "bundler", "~> 1.10"
+  spec.add_development_dependency "guard", ">= 2.2.2"
+  spec.add_development_dependency "guard-minitest"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rb-fsevent"
+  spec.add_development_dependency "minitest"
+  spec.add_development_dependency "minitest-reporters"
+  spec.add_development_dependency "mocha"
+  spec.add_development_dependency "rubocop"
+  spec.add_development_dependency "terminal-notifier-guard"
+end

data/exe/chandler

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+
+require "chandler/cli"
+Chandler::CLI.new.run

data/lib/chandler.rb

@@ -0,0 +1,4 @@
+require "chandler/version"
+
+module Chandler
+end

data/lib/chandler/changelog.rb

@@ -0,0 +1,97 @@
+require "chandler/refinements/version_format"
+
+module Chandler
+  # Responsible for parsing a CHANGELOG into a hash of release notes keyed
+  # by version number. Release notes for a particular version or tag can be
+  # accessed using the `fetch` method.
+  class Changelog
+    using Chandler::Refinements::VersionFormat
+
+    NoMatchingVersion = Class.new(StandardError)
+
+    HEADING_PATTERNS = [
+      /^##\s+.*\n/,  # Markdown "atx" style
+      /^###\s+.*\n/,
+      /^==\s+.*\n/,  # Rdoc style
+      /^===\s+.*\n/,
+      /^\S.*\n-+\n/  # Markdown "Setext" style
+    ].freeze
+
+    attr_reader :path
+
+    def initialize(path:)
+      @path = path
+    end
+
+    # Fetch release notes for the given tag or version number.
+    #
+    # E.g.
+    # fetch("v1.0.1") # => "\nRelease notes for 1.0.1.\n"
+    # fetch("1.0.1")  # => "\nRelease notes for 1.0.1.\n"
+    # fetch("blergh") # => Chandler::NoMatchingVersion
+    #
+    def fetch(tag)
+      versions.fetch(tag.version_number) do
+        fail NoMatchingVersion, "Couldn’t find #{tag} in #{path}"
+      end
+    end
+
+    private
+
+    # Transforms the changelog into a hash where the keys are version numbers
+    # and the values are the release notes for those versions. The values are
+    # *not* stripped of whitespace.
+    #
+    # The version numbers are assumed to be contained at Markdown or Rdoc
+    # headings. The release notes for those version numbers are the text
+    # delimited by those headings. The algorithm tries various styles of these
+    # Markdown and Rdoc headings (see `HEADING_PATTERNS`) until it finds one
+    # that matches.
+    #
+    # The resulting hash entries look like:
+    # { "1.0.1" => "\nRelease notes for 1.0.1.\n" }
+    #
+    def versions
+      @versions ||= begin
+        versions = HEADING_PATTERNS.find do |heading_re|
+          found = versions_at_headings(heading_re)
+          break(found) unless found.empty?
+        end
+        versions || {}
+      end
+    end
+
+    # rubocop:disable Style/SymbolProc
+    def versions_at_headings(heading_re)
+      sections(heading_re).each_with_object({}) do |(heading, text), versions|
+        tokens = heading.gsub(/[\[\]\(\)`]/, " ").split.map(&:strip)
+        version = tokens.find { |t| t.version? }
+        versions[version.version_number] = text if version
+      end
+    end
+    # rubocop:enable Style/SymbolProc
+
+    # Parses the changelog into a hash, where the keys of the hash are the
+    # Markdown/rdoc headings matching the specified heading regexp, and values
+    # are the content delimited by those headings.
+    #
+    # E.g.
+    # { "## v1.0.1\n" => "\nRelease notes for 1.0.1.\n" }
+    #
+    def sections(heading_re)
+      hash = {}
+      heading = ""
+      remainder = text
+
+      until remainder.empty?
+        hash[heading], heading, remainder = remainder.partition(heading_re)
+      end
+
+      hash
+    end
+
+    def text
+      @text ||= IO.read(path)
+    end
+  end
+end

data/lib/chandler/cli.rb

@@ -0,0 +1,49 @@
+require "chandler/cli/parser"
+require "chandler/commands/push"
+require "chandler/logging"
+require "forwardable"
+
+module Chandler
+  # Handles constructing and invoking the appropriate chandler command
+  # based on command line arguments and options provided by the CLI::Parser.
+  # Essentially this is the "router" for the command-line app.
+  #
+  class CLI
+    include Logging
+    extend Forwardable
+    def_delegator :@parser, :args
+    def_delegator :@parser, :config
+
+    def initialize(parser: Chandler::CLI::Parser.new(ARGV))
+      @parser = parser
+    end
+
+    def run
+      command.call
+    end
+
+    def command # rubocop:disable Metrics/MethodLength
+      case (command = args.shift)
+      when "push"
+        push
+      when nil
+        error("Please specify a command")
+        info(@parser.usage)
+        exit(1)
+      else
+        error("Unrecognized command: #{command}")
+        info(@parser.usage)
+        exit(1)
+      end
+    end
+
+    private
+
+    def push
+      Chandler::Commands::Push.new(
+        :tags => args.empty? ? config.git.version_tags : args,
+        :config => config
+      )
+    end
+  end
+end

data/lib/chandler/cli/parser.rb

@@ -0,0 +1,86 @@
+require "chandler/configuration"
+require "chandler/version"
+require "optparse"
+
+module Chandler
+  class CLI
+    class Parser
+      attr_reader :args, :config
+
+      def initialize(args, config=Chandler::Configuration.new)
+        @args = args
+        @config = config
+        parse_options
+      end
+
+      def usage
+        option_parser.to_s
+      end
+
+      private
+
+      def parse_options
+        unprocessed = []
+        until args.empty?
+          option_parser.order!(args)
+          unprocessed << args.shift
+        end
+        @args = unprocessed.compact
+      end
+
+      def option_parser # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+        OptionParser.new do |opts|
+          opts.banner = "Usage: chandler push [tag] [options]"
+          opts.separator("")
+          opts.separator(summary)
+          opts.separator("")
+
+          opts.on("--git=[PATH]", "Path to .git directory") do |p|
+            config.git_path = p
+          end
+
+          opts.on("--github=[URL]",
+                  "GitHub repository URL or owner/repo") do |u|
+            config.github_repository = u
+          end
+
+          opts.on("--changelog=[PATH]",
+                  "Path to CHANGELOG Markdown file") do |p|
+            config.changelog_path = p
+          end
+
+          opts.on("--dry-run",
+                  "Simulate, but don’t actually push to GitHub") do |d|
+            config.dry_run = d
+          end
+
+          opts.on("--debug", "Enable debug output") do |d|
+            config.logger.verbose = d
+          end
+
+          opts.on("-h", "--help", "Show this help message") do
+            puts(opts)
+            exit
+          end
+
+          opts.on("-v", "--version", "Print the chandler version number") do
+            puts("chandler version #{Chandler::VERSION}")
+            exit
+          end
+        end
+      end
+
+      def summary
+        <<-SUMMARY
+chandler scans your git repository for version tags (e.g. `v1.0.2`), parses out
+the corresponding release notes for those tags from your CHANGELOG, and uploads
+those notes to the GitHub releases area via the GitHub API.
+
+chandler will use reasonable defaults and inferences to configure itself.
+If chandler doesn’t work for you out of the box, override the configuration
+using these options.
+SUMMARY
+      end
+    end
+  end
+end

data/lib/chandler/commands/push.rb

@@ -0,0 +1,47 @@
+require "chandler/logging"
+require "chandler/refinements/color"
+require "chandler/refinements/version_format"
+
+module Chandler
+  module Commands
+    # Iterates over a given array of tags, fetches the corresponding notes
+    # from the CHANGELOG, and creates (or updates) the release notes for that
+    # tag on GitHub.
+    class Push
+      include Logging
+      using Chandler::Refinements::Color
+      using Chandler::Refinements::VersionFormat
+
+      attr_reader :github, :changelog, :tags, :config
+
+      def initialize(tags:, config:)
+        @tags = tags
+        @github = config.github
+        @changelog = config.changelog
+        @config = config
+      end
+
+      def call
+        benchmarking_each_tag do |tag|
+          github.create_or_update_release(
+            :tag => tag,
+            :title => tag.version_number,
+            :description => changelog.fetch(tag).strip
+          )
+        end
+      end
+
+      private
+
+      def benchmarking_each_tag
+        width = tags.map(&:length).max
+        tags.each do |tag|
+          ellipsis = "…".ljust(1 + width - tag.length)
+          benchmark("Push #{tag.blue}#{ellipsis}") do
+            yield(tag)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/chandler/configuration.rb

@@ -0,0 +1,39 @@
+require "chandler/changelog"
+require "chandler/git"
+require "chandler/github"
+require "chandler/logger"
+
+module Chandler
+  class Configuration
+    attr_accessor :changelog_path, :git_path, :github_repository, :dry_run
+    attr_accessor :logger
+
+    def initialize
+      @changelog_path = "CHANGELOG.md"
+      @git_path = ".git"
+      @logger = Chandler::Logger.new
+      @dry_run = false
+    end
+
+    def dry_run?
+      dry_run
+    end
+
+    def git
+      @git ||= Chandler::Git.new(:path => git_path)
+    end
+
+    def github
+      @github ||=
+        Chandler::GitHub.new(:repository => github_repository, :config => self)
+    end
+
+    def changelog
+      @changelog ||= Chandler::Changelog.new(:path => changelog_path)
+    end
+
+    def github_repository
+      @github_repository || git.origin_remote
+    end
+  end
+end

data/lib/chandler/git.rb

@@ -0,0 +1,58 @@
+require "chandler/refinements/version_format"
+require "open3"
+
+module Chandler
+  # Uses the shell to execute git commands against a given .git directory.
+  class Git
+    using Chandler::Refinements::VersionFormat
+
+    Error = Class.new(StandardError)
+    attr_reader :path
+
+    # Initializes the Git object with the path to the `.git` directory of the
+    # desired git repository.
+    #
+    # Chandler::Git.new(:path => "/path/to/my/project/.git")
+    #
+    def initialize(path:)
+      @path = path
+    end
+
+    # Uses `git tag -l` to obtain the list of tags, then returns the subset of
+    # those tags that appear to be version numbers.
+    #
+    # version_tags # => ["v0.0.1", "v0.2.0", "v0.2.1", "v0.3.0"]
+    #
+    # rubocop:disable Style/SymbolProc
+    def version_tags
+      tags = git("tag", "-l").lines.map(&:strip).select { |v| v.version? }
+      tags.sort_by { |t| Gem::Version.new(t.version_number) }
+    end
+    # rubocop:enable Style/SymbolProc
+
+    # Uses `git remote -v` to list the remotes and returns the URL of the
+    # first one labeled "origin".
+    #
+    # origin_remote # => "git@github.com:mattbrictson/chandler.git"
+    #
+    def origin_remote
+      origin = git("remote", "-v").lines.grep(/^origin\s/).first
+      origin && origin.split[1]
+    end
+
+    private
+
+    def git(*args)
+      capture("git", "--git-dir", path, *args)
+    end
+
+    def capture(*args)
+      out, err, status = Open3.capture3(*args)
+      return out if status.success?
+
+      message = "Failed to execute: #{args.join(' ')}"
+      message << "\n#{err}" unless err.nil?
+      fail Error, message
+    end
+  end
+end

data/lib/chandler/github.rb

@@ -0,0 +1,67 @@
+require "octokit"
+
+module Chandler
+  # A facade for performing GitHub API operations on a given GitHub repository
+  # (specified as a git URL or as `owner/repo` format). Requires that
+  # "~/.netrc" is properly configured with GitHub credentials.
+  #
+  class GitHub
+    MissingCredentials = Class.new(StandardError)
+
+    attr_reader :repository, :config
+
+    def initialize(repository:, config:)
+      @repository = parse_repository(repository)
+      @config = config
+    end
+
+    def create_or_update_release(tag:, title:, description:)
+      return if config.dry_run?
+
+      release = existing_release(tag)
+      return update_release(release, title, description) if release
+
+      create_release(tag, title, description)
+    end
+
+    private
+
+    def parse_repository(repo)
+      repo[%r{(git@github.com:|://github.com/)(.*)\.git}, 2] || repo
+    end
+
+    def existing_release(tag)
+      release = client.release_for_tag(repository, tag)
+      release.id.nil? ? nil : release
+    rescue Octokit::NotFound
+      nil
+    end
+
+    def update_release(release, title, desc)
+      return if release_unchanged?(release, title, desc)
+      client.update_release(release.url, :name => title, :body => desc)
+    end
+
+    def release_unchanged?(release, title, desc)
+      release.name == title && release.body.to_s.strip == desc.strip
+    end
+
+    def create_release(tag, title, desc)
+      client.create_release(repository, tag, :name => title, :body => desc)
+    end
+
+    def client
+      @client ||= begin
+        octokit = Octokit::Client.new(:netrc => true)
+        octokit.login ? octokit : fail_missing_credentials
+      end
+    end
+
+    def fail_missing_credentials
+      message = "Couldn’t load GitHub credentials from ~/.netrc.\n"
+      message << "For .netrc instructions, see: "
+      message << "https://github.com/octokit/octokit.rb#using-a-netrc-file"
+      fail MissingCredentials, message
+    end
+  end
+end

data/lib/chandler/logger.rb

@@ -0,0 +1,86 @@
+require "chandler/refinements/color"
+
+module Chandler
+  # Similar to Ruby's standard Logger, but automatically removes ANSI color
+  # from the logged messages if stdout and stderr do not support it.
+  #
+  class Logger
+    using Chandler::Refinements::Color
+    attr_accessor :stderr, :stdout, :verbose
+
+    def initialize(stderr: $stderr, stdout: $stdout)
+      @stderr = stderr
+      @stdout = stdout
+      @verbose = false
+    end
+
+    def verbose?
+      verbose
+    end
+
+    # Logs a message to stderr. Unless otherwise specified, the message will
+    # be printed in red.
+    def error(message)
+      message = message.red unless message.color?
+      puts(stderr, message)
+    end
+
+    # Logs a message to stdout.
+    def info(message)
+      puts(stdout, message)
+    end
+
+    # Logs a message to stdout, but only if `verbose?` is true.
+    def debug(message=nil)
+      return unless verbose?
+      return puts(stdout, yield) if block_given?
+      puts(stdout, message)
+    end
+
+    # Logs a message to stdout, runs the given block, and then prints the time
+    # it took to run the block.
+    def benchmark(message)
+      start = Time.now
+      print(stdout, "#{message} ")
+      debug("\n")
+      result = yield
+      duration = Time.now - start
+      info("✔".green + format(" %0.3fs", duration).gray)
+      result
+    rescue
+      info("✘".red)
+      raise
+    end
+
+    private
+
+    def print(io, message)
+      message = message.strip_color unless color_enabled?
+      io.print(message)
+    end
+
+    def puts(io, message)
+      message = message.strip_color unless color_enabled?
+      io.puts(message)
+    end
+
+    def color_enabled?
+      @color_enabled = determine_color_support if @color_enabled.nil?
+      @color_enabled
+    end
+
+    def determine_color_support
+      if ENV["CLICOLOR_FORCE"] == "1"
+        true
+      elsif ENV["TERM"] == "dumb"
+        false
+      else
+        tty?(stdout) && tty?(stderr)
+      end
+    end
+
+    def tty?(io)
+      io.respond_to?(:tty?) && io.tty?
+    end
+  end
+end

data/lib/chandler/logging.rb

@@ -0,0 +1,17 @@
+module Chandler
+  # Assuming self responds to `config`, this mixin provides easy access to
+  # logging methods by delegating to the configured Logger.
+  #
+  module Logging
+    def self.included(target)
+      target.instance_exec do
+        extend Forwardable
+        private def_delegator :config, :logger
+        private def_delegator :logger, :benchmark
+        private def_delegator :logger, :debug
+        private def_delegator :logger, :error
+        private def_delegator :logger, :info
+      end
+    end
+  end
+end

data/lib/chandler/refinements/color.rb

@@ -0,0 +1,41 @@
+module Chandler
+  module Refinements
+    # Monkey patch String to provide basic ANSI color support.
+    #
+    # "hello".color? # => false
+    # "hello".blue # => "\e[0;34;49mhello\e[0m"
+    # "hello".blue.color? # => true
+    # "hello".blue.strip_color # "hello"
+    #
+    module Color
+      ANSI_CODES = {
+        :red   => 31,
+        :green => 32,
+        :blue  => 34,
+        :gray  => 90,
+        :grey  => 90
+      }.freeze
+
+      refine String do
+        # Returns `true` if this String contains ANSI color sequences.
+        def color?
+          self != strip_color
+        end
+
+        # Returns a new String with ANSI color sequences removed.
+        def strip_color
+          gsub(/\e\[[0-9;]*m/, "")
+        end
+
+        # Define red, green, blue, etc. methods that return a copy of the
+        # String that is wrapped in the corresponding ANSI color escape
+        # sequence.
+        ANSI_CODES.each do |name, code|
+          define_method(name) do
+            "\e[0;#{code};49m#{self}\e[0m"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/chandler/refinements/version_format.rb

@@ -0,0 +1,46 @@
+module Chandler
+  module Refinements
+    # Monkey patch String to provide conveniences for identifying strings that
+    # represent a version, and converting between between tags (e.g "v1.0.2")
+    # and version numbers ("1.0.2").
+    #
+    module VersionFormat
+      refine String do
+        # Does this string represent a version?
+        #
+        # "1.0.2".version?  # => true
+        # "v1.0.2".version? # => true
+        # "nope".version?   # => false
+        # "".version?       # => false
+        #
+        def version?
+          !!version_number
+        end
+
+        # The version number portion of the string, with the optional "v"
+        # prefix removed.
+        #
+        # "1.0.2".version_number  # => "1.0.2"
+        # "v1.0.2".version_number # => "1.0.2"
+        # "nope".version_number   # => nil
+        # "".version_number       # => nil
+        #
+        def version_number
+          self[/^v?(#{Gem::Version::VERSION_PATTERN})$/, 1]
+        end
+
+        # The version number reformatted as a tag, by prefixing "v".
+        #
+        # "1.0.2".version_tag  # => "v1.0.2"
+        # "v1.0.2".version_tag # => "v1.0.2"
+        # "nope".version_tag   # => nil
+        # "".version_tag       # => nil
+        #
+        def version_tag
+          number = version_number
+          number && "v#{version_number}"
+        end
+      end
+    end
+  end
+end

data/lib/chandler/tasks.rb

@@ -0,0 +1,30 @@
+require "bundler/gem_helper"
+require "chandler/configuration"
+require "chandler/refinements/version_format"
+require "chandler/commands/push"
+
+using Chandler::Refinements::VersionFormat
+
+namespace :chandler do
+  desc "Push release notes for the current version to GitHub"
+  task "push" do
+    gemspec = Bundler::GemHelper.gemspec
+    push = Chandler::Commands::Push.new(
+      :tags => [gemspec.version.to_s.version_tag],
+      :config => Chandler::Tasks.config
+    )
+    push.call
+  end
+end
+
+module Chandler
+  module Tasks
+    def self.config
+      @configuration ||= Chandler::Configuration.new
+    end
+
+    def self.configure
+      yield(config)
+    end
+  end
+end

data/lib/chandler/version.rb

@@ -0,0 +1,3 @@
+module Chandler
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,241 @@
+--- !ruby/object:Gem::Specification
+name: chandler
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Matt Brictson
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-06-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: netrc
+  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: octokit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.2.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.2.2
+- !ruby/object:Gem::Dependency
+  name: guard-minitest
+  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: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rb-fsevent
+  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: minitest
+  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: minitest-reporters
+  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: mocha
+  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: rubocop
+  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: terminal-notifier-guard
+  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'
+description: 
+email:
+- chandler@mattbrictson.com
+executables:
+- chandler
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- ".travis.yml"
+- CHANGELOG.md
+- CONTRIBUTING.md
+- Gemfile
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- chandler.gemspec
+- exe/chandler
+- lib/chandler.rb
+- lib/chandler/changelog.rb
+- lib/chandler/cli.rb
+- lib/chandler/cli/parser.rb
+- lib/chandler/commands/push.rb
+- lib/chandler/configuration.rb
+- lib/chandler/git.rb
+- lib/chandler/github.rb
+- lib/chandler/logger.rb
+- lib/chandler/logging.rb
+- lib/chandler/refinements/color.rb
+- lib/chandler/refinements/version_format.rb
+- lib/chandler/tasks.rb
+- lib/chandler/version.rb
+homepage: https://github.com/mattbrictson/chandler
+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.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: Syncs CHANGELOG entries to GitHub's release notes
+test_files: []