gitolite-rugged 1.2.pre.devel → 1.2.1.pre.devel

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: de63cb865336e69a0371a06372f7f55fe1846812
-  data.tar.gz: 2b3334e0163d1665b56cfb9825880804e1accf0e
+  metadata.gz: af594539d972d1b2f8d7a30e493e83fabec75f01
+  data.tar.gz: 1eb4ec207defe5014819bcaf4c0e66cebb367a10
 SHA512:
-  metadata.gz: a562980bc44bbf4708c231f7e54b0c29507a9898d0f516fcdf25c3d68a76e2bec304f6bf026951acf640b3cd7d99b5ec9a602183f9a4c9aa1bb5a54a8e9bdd9a
-  data.tar.gz: a6cc767c3ce52c671793188f4b6eacb200adbd92c069debdcb3d9c16d16b3af9aa80173eb2002e306fa995060312c814fcd9bb30ce91c0061f80608ed9a8dbc1
+  metadata.gz: 129b807992315d1d3dbcfaa2fddc18ac674d5d0f25f77d8a1d1ae3527a70635bdc048471e57559be1980c02db6f78a41540e58d0145c61e83b144fd4f15561f0
+  data.tar.gz: 60817e257935d2854fcab2466af48494360888f008dcac676078a65e4ae431133e5f897289a5ab0c4289bf48a1545b121fb6df4c37bec170ce4f48181e067b47

data/.gitignore

@@ -7,3 +7,6 @@
 /coverage
 /junit
 /tmp
+
+# Gemnasium gem configuration file
+config/gemnasium.yml

data/README.md

@@ -1,6 +1,10 @@
 ## gitolite-rugged
+[![Gem Version](https://badge.fury.io/rb/gitolite-rugged.svg)](http://badge.fury.io/rb/gitolite-rugged)
+[![Build Status](https://travis-ci.org/oliverguenther/gitolite-rugged.svg?branch=devel)](https://travis-ci.org/oliverguenther/gitolite-rugged)
+[![Code Climate](https://codeclimate.com/github/oliverguenther/gitolite-rugged.png)](https://codeclimate.com/github/oliverguenther/gitolite-rugged)
+
+### This gem is a fork from the [jbox-gitolite](https://github.com/jbox-web/gitolite) gem employing [libgit2/rugged](https://github.com/libgit2/rugged).
 
-**This gem is a fork from the [jbox-gitolite](https://raw.github.com/jbox-web/gitolite) gem employing [libgit2/rugged](https://github.com/libgit2/rugged).**
 
 This gem is designed to provide a Ruby interface to the [Gitolite](https://github.com/sitaramc/gitolite) Git backend system.
 
@@ -10,14 +14,6 @@ It provides these functionalities :
 * Repositories Management
 * Gitolite Admin Repository Bootstrapping
 
-## Code status
-
-* [![Gem Version](https://badge.fury.io/rb/gitolite-rugged.svg)](http://badge.fury.io/rb/gitolite-rugged)
-* [![Build Status](https://travis-ci.org/oliverguenther/gitolite-rugged.svg?branch=devel)](https://travis-ci.org/oliverguenther/gitolite-rugged)
-* [![Code Climate](https://codeclimate.com/github/oliverguenther/gitolite-rugged.png)](https://codeclimate.com/github/oliverguenther/gitolite-rugged)
-* [![Dependency Status](https://gemnasium.com/oliverguenther/gitolite-rugged.svg)](https://gemnasium.com/oliverguenther/gitolite-rugged)
-
-
 ## Requirements ##
 * Ruby 1.9.x or 2.0.x
 * a working [gitolite](https://github.com/sitaramc/gitolite) installation
@@ -103,6 +99,6 @@ Copyright (c) 2014 Oliver Günther (mail@oliverguenther.de)
 
 Based on the jbox-gitolite fork by Nicolas Rodriguez, which itself is based on the original gitolite gem by Stafford Brunk.
 
-Copyright (c) 2013-2014 Nicolas Rodriguez (nrodriguez@jbox-web.com), JBox Web (http://www.jbox-web.com) [![endorse](https://api.coderwall.com/n-rodriguez/endorsecount.png)](https://coderwall.com/n-rodriguez)
+Copyright (c) 2013-2014 Nicolas Rodriguez (nrodriguez@jbox-web.com), JBox Web (http://www.jbox-web.com)
 
 Copyright (c) 2011-2013 Stafford Brunk (stafford.brunk@gmail.com)

data/gitolite.gemspec

@@ -13,21 +13,21 @@ Gem::Specification.new do |s|
   s.description = %q{This gem is designed to provide a Ruby interface to the Gitolite Git backend system using libgit2/rugged. This gem aims to provide all management functionality that is available via the gitolite-admin repository (like SSH keys, repository permissions, etc)}
   s.license     = 'MIT'
 
-  s.add_development_dependency "rake",        "~> 10.3.1"
-  s.add_development_dependency "rdoc",        "~> 4.1.1"
-  s.add_development_dependency "rspec",       "~> 2.14.1"
-  s.add_development_dependency "guard-rspec", "~> 4.2.8"
-  s.add_development_dependency "guard-spork", "~> 1.5.1"
-  s.add_development_dependency "forgery",     "~> 0.6.0"
-  s.add_development_dependency "travis-lint", "~> 1.8.0"
+  s.add_development_dependency "rake",        "~> 10.3",  ">= 10.3.1"
+  s.add_development_dependency "rdoc",        "~> 4.1",   ">= 4.1.1"
+  s.add_development_dependency "rspec",       "~> 2.14",  ">= 2.14.1"
+  s.add_development_dependency "guard-rspec", "~> 4.2",   ">= 4.2.8"
+  s.add_development_dependency "guard-spork", "~> 1.5",   ">= 1.5.1"
+  s.add_development_dependency "forgery",     "~> 0.6",   ">= 0.6.0"
+  s.add_development_dependency "travis-lint", "~> 1.8",   ">= 1.8.0"
 
-  s.add_development_dependency "simplecov",      "~> 0.8.2"
-  s.add_development_dependency "simplecov-rcov", "~> 0.2.3"
+  s.add_development_dependency "simplecov",      "~> 0.8", ">= 0.8.2"
+  s.add_development_dependency "simplecov-rcov", "~> 0.2", ">= 0.2.3"
 
-  s.add_development_dependency "rspec_junit_formatter", "~> 0.1.6"
+  s.add_development_dependency "rspec_junit_formatter", "~> 0.1", ">= 0.1.6"
 
-  s.add_dependency "rugged", ">= 0.19.0"
-  s.add_dependency "gratr19", "~> 0.4.4.1"
+  s.add_dependency "rugged", "~> 0.19",   ">= 0.19.0"
+  s.add_dependency "gratr19", "~> 0.4.4", ">= 0.4.4.1"
 
   s.files         = `git ls-files`.split("\n")
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")

data/lib/gitolite/config/repo.rb

@@ -74,11 +74,11 @@ module Gitolite
         end
 
         @config.each do |k, v|
-          repo += "  config " + k + " = " + v + "\n"
+          repo += "  config " + k + " = " + v.to_s + "\n"
         end
 
         @options.each do |k, v|
-          repo += "  option " + k + " = " + v + "\n"
+          repo += "  option " + k + " = " + v.to_s + "\n"
         end
 
         repo

data/lib/gitolite/config.rb

@@ -1,4 +1,5 @@
 require 'tempfile'
+require 'fileutils'
 
 module Gitolite
 
@@ -73,7 +74,7 @@ module Gitolite
 
 
     def to_file(path=".", filename=@filename)
-      raise ArgumentError, "Path contains a filename or does not exist" unless File.directory?(path)
+      FileUtils.mkdir_p(path) unless File.directory?(path)
 
       new_conf = File.join(path, filename)
       File.open(new_conf, "w") do |f|
@@ -119,6 +120,9 @@ module Gitolite
     def process_config(config)
       context = [] #will store our context for permissions or config declarations
 
+      # On first call with a custom *.conf, the config might not yet exist
+      return unless File.exists?(config)
+
       #Read each line of our config
       File.open(config, 'r').each do |l|
 

data/lib/gitolite/gitolite_admin.rb

@@ -1,25 +1,26 @@
+require 'pathname'
 module Gitolite
   class GitoliteAdmin
 
     attr_accessor :repo
 
-    CONF_DIR    = "conf"
-    KEY_DIR     = "keydir"
-
-    CONFIG_FILE = "gitolite.conf"
-    CONFIG_PATH = File.join(CONF_DIR, "gitolite.conf")
-
-
     # Default settings
-    DEFAULT_SETTINGS = {
+    DEFAULTS = {
       # clone/push url settings
-      git_user: 'git', 
+      git_user: 'git',
       hostname: 'localhost',
 
       # Commit settings
       author_name: 'gitolite-rugged gem',
       author_email: 'gitolite-rugged@localhost',
-      commit_msg: 'Commited by the gitolite-rugged gem'
+      commit_msg: 'Commited by the gitolite-rugged gem',
+
+      # Gitolite-Admin settings
+      config_dir: "conf",
+      key_dir: "keydir",
+      key_subdir: "",
+      config_file: "gitolite.conf",
+      lock_file_path: '.lock'
     }
 
     class << self
@@ -37,8 +38,8 @@ module Gitolite
         end
 
         # Check if config file, key directory exist
-        [ File.join(dir, CONF_DIR), File.join(dir, KEY_DIR),
-          File.join(dir, CONFIG_PATH)
+        [ File.join(dir, DEFAULTS[:config_dir]), File.join(dir, DEFAULTS[:key_dir]),
+          File.join(dir, DEFAULTS[:config_dir], DEFAULTS[:config_file])
         ].each { |f| return false unless File.exists?(f) }
 
         true
@@ -53,14 +54,24 @@ module Gitolite
     # the gitolite-admin repository
     #
     # Settings:
+    # [Connection]
     # :git_user: The git user to SSH to (:git_user@localhost:gitolite-admin.git), defaults to 'git'
     # :private_key: The key file containing the private SSH key for :git_user
     # :public_key: The key file containing the public SSH key for :git_user
     # :host: Hostname for clone url. Defaults to 'localhost'
+    #
+    # [Gitolite-Admin]
+    # :config_dir: Config directory within gitolite repository (defaults to 'conf')
+    # :key_dir: Public key directory within gitolite repository (defaults to 'keydir')
+    # :config_file: Config file to parse (default: 'gitolite.conf')
+    # **use only when you use the 'include' directive of gitolite)**
+    # :key_subdir: Where to store gitolite-rugged known keys, defaults to '' (i.e., directly in keydir)
+    # :lock_file_path: location of the transaction lockfile, defaults to <gitolite-admin.git>/.lock
+    #
     # The settings hash is forwarded to +GitoliteAdmin.new+ as options.
     def initialize(path, settings = {})
       @path = path
-      @settings = DEFAULT_SETTINGS.merge(settings)
+      @settings = DEFAULTS.merge(settings)
 
       # Ensure SSH key settings exist
       @settings.fetch(:public_key)
@@ -71,22 +82,39 @@ module Gitolite
         username: settings[:git_user], publickey: settings[:public_key], 
         privatekey: settings[:private_key] )
       
-      @repo = 
+      @repo =
       if self.class.is_gitolite_admin_repo?(path)
-        Rugged::Repository.new(path)
+        Rugged::Repository.new(path, credentials: @credentials)
       else
         clone
       end
 
-      @config_file_path = File.join(@path, CONF_DIR, CONFIG_FILE)
-      @conf_dir_path    = File.join(@path, CONF_DIR)
-      @key_dir_path     = File.join(@path, KEY_DIR)
+      @config_dir_path    = File.join(@path, @settings[:config_dir])
+      @config_file_path = File.join(@config_dir_path, @settings[:config_file])
+      @key_dir_path     = File.join(@path, relative_key_dir)
 
       @commit_author = { email: settings[:author_email], name: settings[:author_name] }
 
       reload!
     end
 
+
+    #
+    # Returns the relative directory to the gitolite config file location.
+    # I.e., settings[config_dir]/settings[config_file]
+    # Defaults to 'conf/gitolite.conf'
+    def relative_config_file
+      File.join(@settings[:config_dir], @settings[:config_file])
+    end
+
+    #
+    # Returns the relative directory to the public key location.
+    # I.e., settings[key_dir]/settings[key_subdir]
+    # Defaults to 'keydir/'
+    def relative_key_dir
+      File.join(@settings[:key_dir], @settings[:key_subdir])
+    end
+
     def config
       @config ||= load_config
     end
@@ -138,28 +166,25 @@ module Gitolite
 
     # Writes all changed aspects out to the file system
     # will also stage all changes then commit
-    def save()
+    def save(commit_msg = nil)
 
       # Add all changes to index (staging area)
       index = @repo.index
 
       #Process config file (if loaded, i.e. may be modified)
       if @config
-        new_conf = @config.to_file(@conf_dir_path)
-
-        # Rugged wants relative paths
-        index.add(CONFIG_PATH)
+        new_conf = @config.to_file(path=@config_dir_path)
+        index.add(relative_config_file)
       end
 
       #Process ssh keys (if loaded, i.e. may be modified)
       if @ssh_keys
-        files = list_keys.map{|f| File.basename f}
-        keys  = @ssh_keys.values.map{|f| f.map {|t| t.filename}}.flatten
+        files = list_keys.map{|f| relative_key_path(f) }
+        keys  = @ssh_keys.values.map{|f| f.map {|t| t.relative_path}}.flatten
 
-        to_remove = (files - keys).map { |f| File.join(@key_dir, f) }
-        to_remove.each do |key|
-          File.unlink key
-          index.remove key
+        to_remove = (files - keys).each do |key|
+          SSHKey.remove(key, @key_dir_path)
+          index.remove File.join(relative_key_dir, key)
         end
 
         @ssh_keys.each_value do |key|
@@ -167,7 +192,7 @@ module Gitolite
           next if key.respond_to?(:dirty?) && !key.dirty?
           key.each do |k|
             new_key = k.to_file(@key_dir_path)
-            index.add new_key
+            index.add File.join(relative_key_dir, k.relative_path)
           end
         end
       end
@@ -181,7 +206,7 @@ module Gitolite
       Rugged::Commit.create(@repo,
         author: commit_author,
         committer: commit_author,
-        message: @settings[:commit_msg],
+        message: commit_msg || @settings[:commit_msg],
         parents: [repo.head.target],
         tree: commit_tree,
         update_ref: 'HEAD'
@@ -191,7 +216,7 @@ module Gitolite
 
     # Push back to origin
     def apply
-      @repo.push 'origin', ['refs/heads/master']
+      @repo.push('origin', ['refs/heads/master'], credentials: @credentials)
     end
 
 
@@ -202,6 +227,19 @@ module Gitolite
     end
 
 
+    # Lock the gitolite-admin directory and yield.
+    # After the block is completed, calls +apply+ only.
+    # You have to commit your changes within the transaction block
+    def transaction
+      get_lock do
+        yield
+
+        # Push all changes
+        apply
+      end
+    end
+
+
     # Updates the repo with changes from remote master
     # Warning: This resets the repo before pulling in the changes.
     def update(settings = {})
@@ -215,7 +253,7 @@ module Gitolite
       merge_index = repo.merge_commits(master, origin_master)
 
       # Complete the merge by comitting it
-      merge_commit = Rugged::Commit.create(@repo, 
+      merge_commit = Rugged::Commit.create(@repo,
         parents: [ master, origin_master ],
         tree: merge_index.write_tree(@repo),
         message: '[gitolite-rugged] Merged `origin/master` into `master`',
@@ -232,8 +270,8 @@ module Gitolite
 
 
     # Clone the gitolite-admin repo
-    # to the given path.  
-    # 
+    # to the given path.
+    #
     # The repo is cloned from the url
     # +(:git_user)@(:hostname)/gitolite-admin.git+
     #
@@ -241,8 +279,8 @@ module Gitolite
     # E.g., +git@localhost:2222/gitolite-admin.git+
     #
     def clone()
-      Rugged::Repository.clone_at(admin_url(@settings), File.expand_path(@path), credentials: @creds)
-    end    
+      Rugged::Repository.clone_at(admin_url(@settings), File.expand_path(@path), credentials: @credentials)
+    end
 
 
     def load_config
@@ -254,6 +292,13 @@ module Gitolite
       Dir.glob(@key_dir_path + '/**/*.pub')
     end
 
+    # Returns the relative key path
+    # <owner>/<location>/<owner> given an absolute path
+    # below the keydir.
+    def relative_key_path(key_path)
+      Pathname.new(key_path).relative_path_from(Pathname.new(@key_dir_path)).to_s
+    end
+
 
     # Loads all .pub files in the gitolite-admin
     # keydir directory
@@ -272,5 +317,23 @@ module Gitolite
 
       keys
     end
+
+    def lock_file_path
+      File.expand_path(@settings[:lock_file_path], @path)
+    end
+
+
+    # Aquire LOCK_EX on the gitolite-admin.git directory .
+    # Use +GitoliteAdmin.transaction+ to modify with flock.
+    def get_lock
+      File.open(lock_file_path, File::RDWR|File::CREAT, 0644) do |file|
+        file.sync = true
+        file.flock(File::LOCK_EX)
+
+        yield
+
+        file.flock(File::LOCK_UN)
+      end
+    end
   end
 end

data/lib/gitolite/ssh_key.rb

@@ -1,13 +1,12 @@
+require 'fileutils'
 module Gitolite
 
   # Models an SSH key within gitolite
   # provides support for multikeys
   #
   # Types of multi keys:
-  #   bob.pub => username: bob
-  #   bob@desktop.pub => username: bob, location: desktop
-  #   bob@email.com.pub => username: bob@email.com
-  #   bob@email.com@desktop.pub => username: bob@email.com, location: desktop
+  #   username: bob => <keydir>/bob/bob.pub
+  #   username: bob, location: desktop => <keydir>/bob/desktop/bob.pub
 
   class SSHKey
 
@@ -18,17 +17,17 @@ module Gitolite
       def from_file(key)
         raise "#{key} does not exist!" unless File.exists?(key)
 
-        # TODO this is old-style locations, use folders instead.
-        # Get our owner and location
-        File.basename(key) =~ /^([\+\w\.-]+(?:@(?:[\w-]+\.)+\D{2,4})?)(?:@([\w-]+))?.pub$/i
-        owner    = $1
-        location = $2 || ""
+        # Owner is the basename of the key
+        # i.e., <owner>/<location>/<owner>.pub
+        owner = File.basename(key, ".pub")
+
+        # Location is the middle section of the path, if any
+        location = self.location_from_path(File.dirname(key), owner)
 
         # Use string key constructor
         self.from_string(File.read(key), owner, location)
       end
 
-
       # Construct a SSHKey from a string
       def from_string(key_string, owner, location = "")
         if owner.nil?
@@ -51,10 +50,58 @@ module Gitolite
         self.new(type, blob, email, owner, location)
       end
 
+            # Parse the key path above the key to be read.
+      # As we can omit the location, there are two possible options:
+      #
+      # 1. Location is empty. Path is <keydir>/<owner>/
+      # 2. Location is non-empty. Path is <keydir>/<owner>/<location>
+      #
+      # We test this by checking the parent of the given path.
+      # If it equals owner, a location was set.
+      # This allows the daft case of e.g., using <keydir>/bob/bob/bob.pub.
+      def location_from_path(path, owner)
+        keyroot = File.dirname(path)
+        if File.basename(keyroot) == owner
+          File.basename(path)
+        else
+          ''
+        end
+      end
+
+      def delete_dir_if_empty(dir)
+        if File.directory?(dir) && Dir["#{dir}/*"].empty?
+          Dir.rmdir(dir)
+        end
+      rescue => e
+        STDERR.puts("Warning: Couldn't delete empty directory: #{e.message}")
+      end
+
+      # Remove a key given a relative path
+      #
+      # Unlinks the key file and removes any empty parent directory
+      # below key_dir
+      def remove(key_file, key_dir_path)
+
+        abs_key_path = File.join(key_dir_path, key_file)
+        key = self.from_file(abs_key_path)
+
+        # Remove the file itself
+        File.unlink(abs_key_path)
+
+        key_owner_dir = File.join(key_dir_path, key.owner)
+
+        # Remove the location, if it exists and is empty
+        if key.location
+          self.delete_dir_if_empty(File.join(key_owner_dir, key.location))
+        end
+
+        # Remove the owner dir, if empty
+        self.delete_dir_if_empty(key_owner_dir)
+      end
     end
 
 
-    def initialize(type, blob, email, owner = nil, location = "")
+    def initialize(type, blob, email, owner=nil, location = "")
       @type = type
       @blob = blob
       @email = email
@@ -70,7 +117,14 @@ module Gitolite
 
 
     def to_file(path)
-      key_file = File.join(path, self.filename)
+      # Ensure multi-key directory structure
+      # <keydir>/<owner>/<location?>/<owner>.pub
+      key_dir  = File.join(path, @owner, @location)
+      key_file = File.join(key_dir, self.filename)
+
+      # Ensure subdirs exist
+      FileUtils.mkdir_p(key_dir) unless File.directory?(key_dir)
+
       File.open(key_file, "w") do |f|
         f.sync = true
         f.write(self.to_s)
@@ -78,11 +132,12 @@ module Gitolite
       key_file
     end
 
+    def relative_path
+      File.join(@owner, @location, self.filename)
+    end
 
     def filename
-      file = @owner
-      file += "@#{@location}" unless @location.empty?
-      file += ".pub"
+      [@owner, '.pub'].join
     end
 
 
@@ -98,6 +153,5 @@ module Gitolite
     def hash
       [@owner, @location, @type, @blob, @email].hash
     end
-
   end
 end

data/lib/gitolite/version.rb

@@ -1,3 +1,3 @@
 module Gitolite
-  VERSION = "1.2-devel"
+  VERSION = "1.2.1-devel"
 end

data/spec/config_spec.rb

@@ -4,7 +4,6 @@ describe Gitolite::Config do
 
   conf_dir   = File.join(File.dirname(__FILE__), 'fixtures', 'configs')
   output_dir = '/tmp'
-  # output_dir = File.join(File.dirname(File.dirname(__FILE__)), 'tmp')
 
   describe "#new" do
     it 'should read a simple configuration' do
@@ -348,14 +347,14 @@ describe Gitolite::Config do
       File.unlink(file)
     end
 
-    it 'should raise an ArgumentError when an invalid path is specified' do
+    it 'should create the given directory if it does not exist' do
       c = Gitolite::Config.init
-      lambda { c.to_file('/does/not/exist') }.should raise_error(ArgumentError)
-    end
-
-    it 'should raise an ArgumentError when a filename is specified in the path' do
-      c = Gitolite::Config.init
-      lambda{ c.to_file('/home/test.rb') }.should raise_error(ArgumentError)
+      Dir.mktmpdir("foo") do |dir|
+        target = File.join(dir, "someconfigfile")
+        File.exists?(target).should eql(false)
+        c.to_file(target)
+        File.exists?(target).should eql(true)
+      end
     end
 
     it 'should resolve group dependencies such that all groups are defined before they are used' do

data/spec/fixtures/gitolite-admin/.gitted/COMMIT_EDITMSG

@@ -0,0 +1 @@
+Initial repos w/ admin+bob

data/spec/fixtures/gitolite-admin/.gitted/HEAD

@@ -0,0 +1 @@
+ref: refs/heads/master

data/spec/fixtures/gitolite-admin/.gitted/config

@@ -0,0 +1,8 @@
+[core]
+	repositoryformatversion = 0
+	filemode = true
+	bare = false
+	logallrefupdates = true
+	ignorecase = true
+	precomposeunicode = true
+	autocrlf = false

data/spec/fixtures/gitolite-admin/.gitted/description

@@ -0,0 +1 @@
+Unnamed repository; edit this file 'description' to name the repository.

data/spec/fixtures/gitolite-admin/.gitted/hooks/applypatch-msg.sample

@@ -0,0 +1,15 @@
+#!/bin/sh
+#
+# An example hook script to check the commit log message taken by
+# applypatch from an e-mail message.
+#
+# The hook should exit with non-zero status after issuing an
+# appropriate message if it wants to stop the commit.  The hook is
+# allowed to edit the commit message file.
+#
+# To enable this hook, rename this file to "applypatch-msg".
+
+. git-sh-setup
+test -x "$GIT_DIR/hooks/commit-msg" &&
+	exec "$GIT_DIR/hooks/commit-msg" ${1+"$@"}
+:

data/spec/fixtures/gitolite-admin/.gitted/hooks/commit-msg.sample

@@ -0,0 +1,24 @@
+#!/bin/sh
+#
+# An example hook script to check the commit log message.
+# Called by "git commit" with one argument, the name of the file
+# that has the commit message.  The hook should exit with non-zero
+# status after issuing an appropriate message if it wants to stop the
+# commit.  The hook is allowed to edit the commit message file.
+#
+# To enable this hook, rename this file to "commit-msg".
+
+# Uncomment the below to add a Signed-off-by line to the message.
+# Doing this in a hook is a bad idea in general, but the prepare-commit-msg
+# hook is more suited to it.
+#
+# SOB=$(git var GIT_AUTHOR_IDENT | sed -n 's/^\(.*>\).*$/Signed-off-by: \1/p')
+# grep -qs "^$SOB" "$1" || echo "$SOB" >> "$1"
+
+# This example catches duplicate Signed-off-by lines.
+
+test "" = "$(grep '^Signed-off-by: ' "$1" |
+	 sort | uniq -c | sed -e '/^[ 	]*1[ 	]/d')" || {
+	echo >&2 Duplicate Signed-off-by lines.
+	exit 1
+}

data/spec/fixtures/gitolite-admin/.gitted/hooks/post-update.sample

@@ -0,0 +1,8 @@
+#!/bin/sh
+#
+# An example hook script to prepare a packed repository for use over
+# dumb transports.
+#
+# To enable this hook, rename this file to "post-update".
+
+exec git update-server-info

data/spec/fixtures/gitolite-admin/.gitted/hooks/pre-applypatch.sample

@@ -0,0 +1,14 @@
+#!/bin/sh
+#
+# An example hook script to verify what is about to be committed
+# by applypatch from an e-mail message.
+#
+# The hook should exit with non-zero status after issuing an
+# appropriate message if it wants to stop the commit.
+#
+# To enable this hook, rename this file to "pre-applypatch".
+
+. git-sh-setup
+test -x "$GIT_DIR/hooks/pre-commit" &&
+	exec "$GIT_DIR/hooks/pre-commit" ${1+"$@"}
+: