deploku 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1b90f4f46ecfa0ec3e8e33e50d54e27d96c221e4
+  data.tar.gz: e261d9d031ef208958ba83ea8d00c946ce442779
+SHA512:
+  metadata.gz: b2d16b62ebf298926353dfd2adbabd7158202fd61b201897d25cfc7a6d222a6d3713f130096822a08feaeec4353fc715f19497c2e0f679a9b3417d4f489d8b84
+  data.tar.gz: e5c71b23e37dd4130303ca9c061cea9c82fde8e49db5dd4bf18d91dfb2fcf12c35f75829dd4a8d4e6142649b2b83c0f4e68885c12df73af27a334883934f46d1

data/.gitignore

@@ -0,0 +1,16 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+
+.ruby-version

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Bill Horsman
+
+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,83 @@
+# Deploku
+
+A quick and easy way to deploy the current branch to a Heroku. It copes with multiple remotes and runs migrations as necessary. It assumes you are running a Unix like system that will execute commands like `git rev-list abcdef7.. | wc -l`, for example.
+
+You should also look at [jbrunton/heroploy](https://github.com/jbrunton/heroploy) which is very similar to this gem. Heroploy needs some configuration (Deploku needs none) but it does do a lot more (e.g. Travis). It's also stricter about which branch can be deployed where. I encourage you to check out Heroploy as well to see if it better suits your needs.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'deploku'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install deploku
+
+## Usage
+
+Just run the command and it will look for any git remotes referencing Heroku:
+
+```
+[master]$ deploku
+2 Heroku remotes found:
+production
+staging
+```
+
+Then choose a remote and run it again:
+
+```
+[master]$ deploku production
+Heroku app my-app-production is running commit abcdef7
+It is 3 commits behind your local master branch
+There are no pending migrations
+```
+
+If you want to deploy then add the `deploy` command:
+
+```
+[master]$ deploku production deploy
+Heroku app my-app-production is running commit abcdef7
+It is 3 commits behind your local master branch
+There are no pending migrations
+The following command will be run:
+
+  1. git push production master:master
+
+Proceed? (y/N):
+```
+
+Enter `y` to proceed or anything else to abort. Nothing will happen unless you enter `y`.
+
+If there are migrations pending then you will be forced to either pass in either the `maintenance` or `maintenance:skip` options.
+
+```
+[master]$ deploku production deploy maintenance
+Heroku app my-app-production is running commit abcdef7
+It is 3 commits behind your local master branch
+There is 1 pending migration
+The following commands will be run:
+
+  1. heroku maintenance:on --app my-app-production
+  2. git push production master:master
+  3. heroku run rake db:migrate --app my-app-production
+  4. heroku restart --app my-app-production
+  5. heroku maintenance:off --app my-app-production
+
+Proceed? (y/N):
+```
+
+## Contributing
+
+1. Fork it ( https://github.com/billhorsman/deploku/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/bin/deploku

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../lib') unless $LOAD_PATH.include?(File.dirname(__FILE__) + '/../lib')
+require 'bundler'
+require 'deploku'
+
+Deploku::Control.run ARGV.dup

data/deploku.gemspec

@@ -0,0 +1,22 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'deploku/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "deploku"
+  spec.version       = Deploku::VERSION
+  spec.authors       = ["Bill Horsman"]
+  spec.email         = ["bill@logicalcobwebs.com"]
+  spec.summary       = %q{Convenient way of deploying to Heroku}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  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.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

data/lib/deploku/control.rb

@@ -0,0 +1,39 @@
+module Deploku
+
+  module Control
+    extend Deploku::Runnable
+
+    def self.run(args)
+      matching_remotes = remotes & args
+      case matching_remotes.size
+      when 0
+        puts "#{remotes.size} Heroku remote#{'s' if remotes.size > 1} found:"
+        puts *remotes
+        exit 0
+      when 1
+        remote = matching_remotes[0]
+        args.delete remote
+        commands = %w[status deploy] & args
+        commands << "status" if commands.size == 0
+        if commands.size > 1
+          puts "Choose just one command"
+          exit 1
+        else
+          args.delete commands[0]
+          Deploku::Remote.new(remote).send(commands[0], args)
+        end
+      else
+        puts "Please choose just one remote out of #{remotes.join(" or ")}"
+        exit 1
+      end
+    end
+
+    def self.remotes
+      @remotes ||= run_command("git remote -v | grep heroku | grep push").split("\n").map {|line|
+        line.match(/^(.*)\t/)[1]
+      }
+    end
+
+  end
+
+end

data/lib/deploku/migration.rb

@@ -0,0 +1,44 @@
+module Deploku
+  class Migration < OpenStruct
+
+    attr_accessor :local_status, :remote_status
+
+    def pending?
+      local_status != "up" || remote_status != "up"
+    end
+
+    def to_s
+      message = case local_status
+      when "down"
+        case remote_status
+        when "down"
+          "Pending locally and remotely. Why?"
+        when "up"
+          "Pending locally BUT up remotely. Why?"
+        else
+          "Pending locally AND needs to be deployed. Migrate locally first?"
+        end
+      when "up"
+        case remote_status
+        when "down"
+          "Pending remotely"
+        when "up"
+          "Up both locally and remotely"
+        else
+          "Needs to be deployed"
+        end
+      else
+        case remote_status
+        when "down"
+          "Pending remotely but missing locally!"
+        when "up"
+          "Up remotely but pending locally!"
+        else
+          "Missing locally and remotely!!"
+        end
+      end
+      "  #{version} - #{message}"
+    end
+
+  end
+end

data/lib/deploku/remote.rb

@@ -0,0 +1,180 @@
+module Deploku
+
+  class Remote
+    include Runnable
+
+    attr_reader :remote, :maintenance, :force
+
+    def initialize(remote)
+      @remote = remote
+    end
+
+    def app_name
+      @app_name ||= run_command("git remote -v | grep #{remote} | grep push").match(/heroku\.com:(.*)\.git/)[1]
+    end
+
+    def remote_commit_exists_locally?
+      test_command("git show #{remote_commit}")
+    end
+
+    def database_configured?
+      test_command("rake db:migrate:status")
+    end
+
+    def behind
+      @behind ||= count_rev_list("#{remote_commit}..")
+    end
+
+    def ahead
+      @ahead ||= count_rev_list("..#{remote_commit}")
+    end
+
+    def count_rev_list(range)
+      run_command("git rev-list #{range}").slice("\n").size
+    end
+
+    def remote_commit
+      @remote_commit ||= run_command("git ls-remote #{remote} 2> /dev/null").chomp.split(' ').first
+    end
+
+    def status(args)
+      puts "Heroku app #{app_name} is running commit #{remote_commit.slice(0, 7)}"
+      if remote_commit_exists_locally?
+        if behind == 0 && ahead == 0
+          puts "It is up to date"
+        else
+          if ahead == 0
+            puts "It is #{behind} commit#{"s" if behind > 1} behind your local #{local_branch} branch"
+          elsif behind == 0
+            puts "It is #{ahead} commit#{"s" if ahead > 1} ahead of your local #{local_branch} branch"
+          else
+            puts "It is #{behind} commit#{"s" if behind > 1} behind and #{ahead} commit#{"s" if ahead > 1} ahead of your local #{local_branch} branch"
+          end
+        end
+      else
+        puts "Warning! The commit #{remote_commit.slice(0, 7)} is not present in the local repo. Why?"
+      end
+      if database_configured?
+        case pending_migration_count
+        when 0
+          puts "There are no pending migrations"
+        when 1
+          puts "There is 1 pending migration"
+        else
+          puts "There are #{pending_migration_count} pending migrations"
+        end
+        if pending_migration_count > 0
+          pending_migrations.each do |migration|
+            puts migration
+          end
+        end
+      end
+    end
+
+    def deploy(args)
+      status(args)
+      @force = !!args.delete("force")
+      if args.delete("maintenance")
+        @maintenance = :use
+      elsif args.delete("maintenance:skip")
+        @maintenance = :skip
+      end
+      if args.any?
+        puts "Unknown argument(s): #{args.join(", ")}"
+        exit 1
+      end
+      puts "The following command#{'s' if deploy_commands.size > 1} will be run:"
+      puts
+      deploy_commands.each_with_index do |command, index|
+        puts "  #{index + 1}. #{command}"
+      end
+      print "\nProceed? (y/N): "
+      proceed = STDIN.gets.strip
+      if proceed == "y"
+        puts ""
+        deploy_commands.each_with_index do |command, index|
+          puts "  #{index + 1}. #{command} ..."
+          run_command command
+        end
+        puts
+      else
+        puts "Abort"
+      end
+    end
+
+    def deploy_commands
+      return @deploy_commands if @deploy_commands
+      maintenance_mode = pending_migration_count > 0 && maintenance == :use
+      list = []
+      if pending_migration_count > 0
+        case maintenance
+        when :use
+          maintenance_mode = true
+        when :skip
+          maintenance_mode = false
+        else
+          puts "There are migrations to run. Please either choose maintenance or maintenance:skip"
+          exit 1
+        end
+      end
+      list << "heroku maintenance:on --app #{app_name}" if maintenance_mode
+      list << "git push#{force ? " --force" : ""} #{remote} #{local_branch}:master"
+      list << "heroku run rake db:migrate --app #{app_name}" if pending_migration_count > 0
+      list << "heroku restart --app #{app_name}" if pending_migration_count > 0
+      list << "heroku maintenance:off --app #{app_name}" if maintenance_mode
+      @deploy_commands = list
+    end
+
+    def local_branch
+      @local_branch ||= run_command("git symbolic-ref HEAD").chomp.sub(/^\/?refs\/heads\//, '')
+    end
+
+    def pending_migration_count
+      pending_migrations.size
+    end
+
+    def migrations
+      local_migrations && remote_migrations # Triggers building of @migrations
+      @migrations.sort_by(&:version)
+    end
+
+    def pending_migrations
+      migrations.select(&:pending?)
+    end
+
+    def add_migration(hash)
+      @migrations ||= []
+      migration = @migrations.detect {|m| m.version == hash[:version] } || Deploku::Migration.new(version: hash[:version])
+      if hash[:location] == :local
+        migration.local_status = hash[:status]
+      else
+        migration.remote_status = hash[:status]
+      end
+      @migrations << migration
+    end
+
+    def local_migrations
+      @local_migrations ||= extract_migrations(run_command("rake db:migrate:status"), :local)
+    end
+
+    def remote_migrations
+      @remote_migrations ||= extract_migrations(run_command("heroku run rake db:migrate:status --app #{app_name}"), :remote)
+    end
+
+    def extract_migrations(output, location)
+      output.split("\n").
+        select {|line|
+          line =~ /^\s*(up|down)/
+        }.map {|line|
+          values = line.split(" ")
+          add_migration(
+            location: location,
+            version: values[1],
+            status: values[0],
+          )
+        }
+    end
+
+  end
+
+end

data/lib/deploku/runnable.rb

@@ -0,0 +1,26 @@
+module Deploku
+  module Runnable
+
+    def run_command(command)
+      Bundler.with_clean_env {
+        out = `#{command}`
+        if $?.success?
+          out
+        else
+          puts "Error running command:"
+          puts command
+          puts out
+          exit $?.exitstatus
+        end
+      }
+    end
+
+    def test_command(command)
+      Bundler.with_clean_env {
+        `#{command} 2> /dev/null`
+        $?.success?
+      }
+    end
+
+  end
+end

data/lib/deploku/version.rb

@@ -0,0 +1,3 @@
+module Deploku
+  VERSION = "0.0.1"
+end

data/lib/deploku.rb

@@ -0,0 +1,6 @@
+require 'ostruct'
+require "deploku/runnable"
+require "deploku/migration"
+require "deploku/remote"
+require "deploku/control"
+require "deploku/version"

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification
+name: deploku
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Bill Horsman
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-11-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !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'
+description: 
+email:
+- bill@logicalcobwebs.com
+executables:
+- deploku
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/deploku
+- deploku.gemspec
+- lib/deploku.rb
+- lib/deploku/control.rb
+- lib/deploku/migration.rb
+- lib/deploku/remote.rb
+- lib/deploku/runnable.rb
+- lib/deploku/version.rb
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Convenient way of deploying to Heroku
+test_files: []