rjgit_grack 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 84344229b7966b8960708f9ca83b982ec60de07c
-  data.tar.gz: ddb642960dc5175ac9de200260beec3a00f63bf2
+  metadata.gz: b3b6f0083eb09801ec9ab63c21d3cc61c0b4ee76
+  data.tar.gz: 35ba1805472c93b622aed689fbf90386b20b7369
 SHA512:
-  metadata.gz: 4f7f0d798f28ec5cfb730ec7b5f694d2c692a43e8e18a1c1f595b472122a2aa527fa374faaa96e813e0b26e93a7fb8d3390b7385865055844e5b38eca839ec09
-  data.tar.gz: 4565154688cea2e309af64fbbe89f30b5394ab84d908150ac38c1bc7c71b60224f29827d578afb9fd4ebbf3ca6bacc6583786489ad4549255f8b2b4b43f7c90c
+  metadata.gz: a9ba14877655ed68438964b979f292a27a0be4e28643c20b310cfa1a98b680d702572c313b331cb6e3285728aeae945658210fb643db442c5c4262d5a62dba57
+  data.tar.gz: debe40b287309f60ec97fdaf595b73d10b142cd9e5edac3f5a60aef89bbfb3086330dc498818c5bda0d20f5b48d57e2306163a96f1f16bd0a455dbb10afad314

data/Gemfile

@@ -4,10 +4,11 @@ gem 'rake'
 gem 'coveralls', require: false
 
 group :test do
-  gem "test"
+  gem "minitest"
+  gem "rack-test"
   gem "mocha"
   gem "grack", :git => 'https://github.com/grackorg/grack'
   gem "simplecov", :require => false
 end
 
-gemspec
+gemspec

data/README.md

@@ -1,7 +1,7 @@
 rjgit_grack
 ===========
 [![Gem Version](https://badge.fury.io/rb/rjgit_grack.svg)](http://badge.fury.io/rb/rjgit_grack)
-[![Build Status](https://travis-ci.org/dometto/rjgit_grack.svg?branch=master)](https://travis-ci.org/grackorg/rjgit_grack)
+[![Build Status](https://travis-ci.org/grackorg/rjgit_grack.svg?branch=master)](https://travis-ci.org/grackorg/rjgit_grack.svg?branch=master)
 [![Dependency Status](https://gemnasium.com/dometto/rjgit_grack.svg)](https://gemnasium.com/grackorg/rjgit_grack)
 
 Alternative Adapter for [grack](http://github.com/grackorg/grack); uses the [RJGit](http://github.com/repotag/rjgit) gem for a pure jruby interface to git repos. Together with Grack, this yields a pure jruby implementation of git's smart-http protocol.
@@ -14,7 +14,7 @@ Installation
 Usage
 ===========
 
-1. Get grack.
+1. Get [grack](https://github.com/grackorgs/grack).
 2. After requiring `rjgit_grack.rb`, you can tell Grack to use the `RJGitAdapter` by editing its configuration, for example:
 
 ```ruby
@@ -32,6 +32,32 @@ config = {
 run Grack::App.new(config)
 ```
 
+Hooks
+===========
+
+This adapter allows you to specify hooks to be called when receive operations (i.e. `git push` to the server) or upload operations (e.g. pulls, clones) are initiated. You can easily do this by passing an options hash to the `Grack::RJGitAdapter.new` call in the configuration, like so:
+
+```ruby
+  :git_adapter_factory => ->{ Grack::RJGitAdapter.new({
+    :preReceive => Proc.new do |received_refs|
+      # This code is executed in the hook
+      puts received_refs
+    end
+    }
+  )}
+```
+
+You can specify the following hooks:
+  * `:preReceive` executed immediately before a receive-operation is performed. Yields an `Array` with `Hash` objects containing info about each ref that is about to be pushed, of the following form:
+    ```ruby
+      {:ref_name => 'refs/heads/masters', :old_id => 'somesha1', :new_id => 'someothersha1', :type => "FAST_FORWARD", :result => "OK"}
+    ```
+  * `:postReceive` executed after a receive-operation is completed. Yields an `Array` with `Hash` objects for each ref that was pushed, of the same form as above, plus a `:result` field. The result will be a `String`, and can have one of the values [defined by JGit](http://download.eclipse.org/jgit/site/4.3.0.201604071810-r/apidocs/index.html).
+  * `:preReceive` executed immediately before an upload-operation is performed, i.e. before data is sent to the client. Yields an `Array` of `String` object-id's (SHA1-hashes) already in common between client and server.
+  * `:postReceive` executed after an upload-operation to a client is complete. Returns an `org.eclipse.jgit.storage.pack.PackStatistics` object (see [here](http://download.eclipse.org/jgit/site/4.3.0.201604071810-r/apidocs/org/eclipse/jgit/storage/pack/PackStatistics.html)).
+
+Note that JGit blocks all read and write operations on the repository until a hook is complete, so the hooks should only contain code that runs quickly (e.g. running workers or threads to perform the heavy work).
+
 Specs
 ======
 
@@ -42,7 +68,7 @@ Run the specs:
 Dependencies
 ===========
 
-- [Grack](http://github.com/grackorg/grack) >= 0.1.0.pre
+- [Grack](http://github.com/grackorg/grack) >= 0.1.0.pre2
 - The [RJGit](http://github.com/repotag/rjgit) gem, which requires JRuby
 
 License

data/lib/rjgit_grack.rb

@@ -1,11 +1,13 @@
-require "rjgit"
+require 'rjgit'
+require 'hooks'
 
 module Grack
 
   class RJGitAdapter < GitAdapter
 
-    def initialize
+    def initialize(hooks = nil)
       @repository_path = nil
+      @hooks = hooks
     end
   
     def handle_pack(pack_type, io_in, io_out, opts = {})
@@ -14,8 +16,9 @@ module Grack
           RJGit::RJGitUploadPack.new(repo)
         when 'git-receive-pack'
           RJGit::RJGitReceivePack.new(repo)
-        end
-      return nil unless pack
+      end
+      return nil if pack.nil?
+      set_hooks(pack) if @hooks
       if opts[:advertise_refs] then
         io_out.write advertisement_prefix(pack_type)
         result = pack.advertise_refs
@@ -50,6 +53,16 @@ module Grack
     def repo
       RJGit::Repo.new(repository_path)
     end
+
+    def set_hooks(pack)
+      if pack.is_a?(RJGit::RJGitUploadPack)
+        pack.jpack.setPostUploadHook(Grack::Hooks::PostUploadHook.new(@hooks[:postUpload])) if @hooks[:postUpload]
+        pack.jpack.setPreUploadHook(Grack::Hooks::PreUploadHook.new(@hooks[:preUpload])) if @hooks[:preUpload]
+      elsif pack.is_a?(RJGit::RJGitReceivePack)
+        pack.jpack.setPostReceiveHook(Grack::Hooks::PostReceiveHook.new(@hooks[:postReceive])) if @hooks[:postReceive]
+        pack.jpack.setPreReceiveHook(Grack::Hooks::PreReceiveHook.new(@hooks[:preReceive])) if @hooks[:preReceive]
+      end
+    end
   
   end
 

metadata

@@ -1,30 +1,32 @@
 --- !ruby/object:Gem::Specification
 name: rjgit_grack
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Dawa Ometto
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-09-22 00:00:00.000000000 Z
+date: 2016-04-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rjgit
-  version_requirements: !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '4.0'
-  requirement: !ruby/object:Gem::Requirement
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '4.0'
-  prerelease: false
-  type: :runtime
-description: Alternative Adapter for grack; uses the RJGit gem for a pure jruby interface to git repos. Together with Grack, this yields a pure JRuby implementation of git's smart-http protocol.
+description: Alternative Adapter for grack; uses the RJGit gem for a pure jruby interface
+  to git repos. Together with Grack, this yields a pure JRuby implementation of git's
+  smart-http protocol.
 email: d.ometto@gmail.com
 executables: []
 extensions: []
@@ -38,7 +40,7 @@ homepage: http://github.com/grackorg/rjgit_grack
 licenses:
 - MIT
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -53,9 +55,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project:
-rubygems_version: 2.4.5
-signing_key:
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
 specification_version: 4
 summary: Adapts grack (http://github.com/grackorg/grack) to use JGit.
 test_files: []
+has_rdoc: