meathook 0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: df74157c4d8c0038c54fdf7faef66aef8ab3bb15
+  data.tar.gz: d20dec733dcd1fdc9bc3dbba6a7438c0f8503499
+SHA512:
+  metadata.gz: 607bdabedd4d9f27dadca0228907be4e2d94833d601f9a4fde692e8b345fe88dc69eccf3a4e18e824d1866f2f0e668ae4f2eb7a66ffc858ff84b60cab42f346f
+  data.tar.gz: 914a6635284d2c20349af4ba533f52d2361faefcea3259c09a772b7bed1eac795e527df362beee0dc1a96ab3579c976ef410a7918a77d4adcd9408939d8509da

data/LICENSE

@@ -0,0 +1,24 @@
+copyright (c) 2015, Emcien Corporation
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * Neither the name of the <organization> nor the
+      names of its contributors may be used to endorse or promote products
+      derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,49 @@
+# Meathook
+
+Meathook is a gem to help manage a living set of githooks.
+Inspired by Babar (http://github.com/jdabbs/babar), but intended to be
+more general in purpose.
+
+## .hooks
+
+The `.hooks.yaml` file should be committed in the root of your repository -
+it's a yaml file like so:
+
+```yaml
+---
+path: "bin/meathook"
+pre-commit:
+  no_focus:
+    command:   "git diff --cached spec/ | grep '^+' | grep ':focus'"
+    condition: "nonempty"
+    halt:      true
+    message:   "You are trying to commit a focused spec!"
+post-merge:
+  remember_to_bundle:
+    command: "git diff --name-only HEAD^..HEAD | grep Gemfile
+    condition: "nonempty"
+    halt:      false
+    message:   "Gemfile was just updated - remember to run 'bundle install'"
+```
+
+Each hook type can be a toplevel key in that file, and the keys in each are arbitrary
+names of tasks. Each task then has the keys:
+
+- command:    command to run - output and exit code can both be relevant
+- condition:  one of [nonempty, empty, failed, successful]
+- halt:       under those conditions, should we halt the procedure? (commit, merge, etc)
+- message:    message to show the user if the condition is true
+
+The 'path' key is special, and is used to supply a literal path to the meathook script,
+so that your githooks don't have to use bundler (which can add a half-second onto each
+operation). if `which meathook` doesn't give you a path, then you need to specify a path
+with this key.
+
+## `meathook install`
+
+In order to run the githooks, meathook needs to install a self-call into each of the
+.git/hooks scripts of the form `meathook execute <hookname>`.
+
+## `meathook uninstall`
+
+Removes the meathook call from all of the githooks.

data/bin/meathook

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+
+require_relative '../lib/meathook'
+
+command = ARGV.shift
+
+xname = "meathook"
+if File.exist?(".hook")
+  text = File.read(".hook")
+  data = YAML.load(text)
+  if data["path"]
+    xname = data["path"]
+  end
+end
+
+if command == "install"
+  Meathook.install(xname)
+elsif command == "uninstall"
+  Meathook.uninstall(xname)
+elsif command == "execute"
+  capn = Meathook::Captain.new
+  hookname = ARGV.shift || raise("usage: meathook execute HOOKNAME")
+  capn.each_hook(hookname) do |h|
+    h.each_command do |cmd|
+      cmd.execute
+    end
+  end
+else
+  warn "The command '#{command}' is not recognized."
+  exit(1)
+end

data/lib/meathook.rb

@@ -0,0 +1,47 @@
+module Meathook
+  RECOGNIZED_HOOKS = [
+    "applypatch-msg",
+    "pre-applypatch",
+    "post-applypatch",
+    "pre-commit",
+    "prepare-commit-msg",
+    "commit-msg",
+    "post-commit",
+    "pre-rebase",
+    "post-checkout",
+    "post-merge",
+    "pre-receive",
+    "update",
+    "post-receive",
+    "post-update",
+    "pre-auto-gc",
+    "post-rewrite",
+  ]
+
+
+  def self.install(xname)
+    RECOGNIZED_HOOKS.each do |name|
+      path = ".git/hooks/#{name}"
+      hook_contents = File.exist?(path) ? File.read(path) : ""
+      unless hook_contents =~ /#{xname} execute/
+        system("echo '#{xname} execute #{name} #MEATHOOK' >> '#{path}'")
+        system("chmod +x '#{path}'")
+      end
+    end
+  end
+
+  def self.uninstall(xname)
+    RECOGNIZED_HOOKS.each do |name|
+      path = ".git/hooks/#{name}"
+      hook_contents = File.exist?(path) ? File.read(path) : ""
+      if hook_contents =~ /#{xname} execute/
+        system("sed -i '.bak' '/MEATHOOK/d' '#{path}'")
+      end
+    end
+  end
+end
+
+dirpath = File.expand_path("../meathook", __FILE__)
+Dir.glob("#{dirpath}/*.rb").each do |p|
+  require p
+end

data/lib/meathook/captain.rb

@@ -0,0 +1,31 @@
+require 'yaml'
+
+module Meathook
+  class Captain
+    attr_accessor :path, :text, :data, :hooks
+
+    def initialize
+      self.path = '.hook'
+      self.text = ""
+      self.data = {}
+      self.hooks = []
+
+      if File.exist?(path)
+        self.text = File.read(self.path)
+        self.data = YAML.load(self.text)
+        self.data.each_pair do |hname, hdata|
+          next if hname == "path"
+          self.hooks << Meathook::Hook.new(hname, hdata)
+        end
+      end
+    end
+
+    def each_hook(name=nil, &block)
+      self.hooks.each do |h|
+        if h.name == name
+          yield h
+        end
+      end
+    end
+  end
+end

data/lib/meathook/command.rb

@@ -0,0 +1,49 @@
+module Meathook
+  class Command
+    attr_accessor :name, :hookname
+    attr_accessor :command, :condition, :halt, :message
+    attr_accessor :match
+
+    def initialize(n, hn, opts)
+      self.name = n
+      self.hookname = hn
+
+      self.command   = opts.fetch('command')
+      self.condition = opts.fetch('condition')
+      self.halt      = opts['halt'] || false
+      self.message   = opts["message"]
+
+      self.match     = false
+    end
+
+    def execute
+      output = `#{command}`
+      exit_code = ($?)
+
+      case condition
+      when "empty"        then self.match = (output =~ /\S/ ? false : true)
+      when "nonempty"     then self.match = (output =~ /\S/ ? true : false)
+      when "failed"       then self.match = (exit_code != 0)
+      when "successful"   then self.match = (exit_code == 0)
+      else                raise("The condition '#{condition}' was not recognized")
+      end
+
+      if self.match
+        if self.message and self.message =~ /\S/
+          warn ""
+          warn "============================================================"
+          warn "    Git Hook '#{hookname}' :: '#{name}' triggered"
+          warn ""
+          warn "  #{message}"
+          warn ""
+        end
+
+        if self.halt
+          exit(1)
+        else
+          exit(0)
+        end
+      end
+    end
+  end
+end

data/lib/meathook/hook.rb

@@ -0,0 +1,19 @@
+module Meathook
+  class Hook
+    attr_accessor :name, :commands, :data
+
+    def initialize(hn, d)
+      self.name = hn
+      self.data = d
+      self.commands = []
+
+      self.data.each_pair do |cname, cdata|
+        self.commands << Meathook::Command.new(self.name, cname, cdata)
+      end
+    end
+
+    def each_command(&block)
+      self.commands.each{|c| yield c}
+    end
+  end
+end

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: meathook
+version: !ruby/object:Gem::Version
+  version: '0.1'
+platform: ruby
+authors:
+- Emcien
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-02-19 00:00:00.000000000 Z
+dependencies: []
+description: Allows a project to specify git hooks for its devs to install
+email:
+- engineering@emcien.com
+executables:
+- meathook
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- bin/meathook
+- lib/meathook.rb
+- lib/meathook/captain.rb
+- lib/meathook/command.rb
+- lib/meathook/hook.rb
+homepage: https://github.com/emcien/meathook
+licenses:
+- ''
+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.4.3
+signing_key: 
+specification_version: 4
+summary: Git hook manager
+test_files: []