zookeeper-ng 1.5

data/Gemfile

@@ -0,0 +1,30 @@
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'rake', '~> 0.9.0'
+
+group :test do
+  gem "rspec" , "~> 2.11"
+  gem 'eventmachine', '1.0.4'
+  gem 'evented-spec', '~> 0.9.0'
+  gem 'zk-server', '~> 1.0', :git => 'https://github.com/zk-ruby/zk-server.git'
+end
+
+# ffs, :platform appears to be COMLETELY BROKEN so we just DO THAT HERE
+# ...BY HAND
+
+if RUBY_VERSION != '1.8.7' && !defined?(JRUBY_VERSION)
+  gem 'simplecov', :group => :coverage, :require => false
+  gem 'yard', '~> 0.8.0', :group => :docs
+  gem 'redcarpet',        :group => :docs
+
+  group :development do
+    gem 'pry'
+    gem 'guard',        :require => false
+    gem 'guard-rspec',  :require => false
+    gem 'guard-shell',  :require => false
+  end
+end
+
+# vim:ft=ruby

data/Guardfile

@@ -0,0 +1,8 @@
+
+guard 'rspec', :version => 2, :cli => '-c -f progress --fail-fast' do
+  watch(%r{^spec/.+_spec.rb$})
+  watch(%r{^lib/(.+)\.rb$}) { |m| %w[spec/zookeeper_spec.rb spec/chrooted_connection_spec.rb] }
+  watch(%r{^ext/zookeeper_c.bundle}) { %w[spec/c_zookeeper_spec.rb] }
+  watch(%r{^ext/zookeeper_base.rb}) { "spec" }
+end
+

data/LICENSE

@@ -0,0 +1,23 @@
+(The MIT License)
+
+Copyright (C) 2008 Phillip Pearson
+Copyright (C) 2010 Twitter, Inc.
+
+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/Manifest

@@ -0,0 +1,29 @@
+CHANGELOG
+LICENSE
+Manifest
+README
+Rakefile
+examples/cloud_config.rb
+ext/extconf.rb
+ext/zkc-3.3.4.tar.gz
+ext/zookeeper_base.rb
+ext/zookeeper_c.c
+ext/zookeeper_lib.c
+ext/zookeeper_lib.h
+java/zookeeper_base.rb
+lib/zookeeper.rb
+lib/zookeeper/acls.rb
+lib/zookeeper/callbacks.rb
+lib/zookeeper/common.rb
+lib/zookeeper/constants.rb
+lib/zookeeper/exceptions.rb
+lib/zookeeper/stat.rb
+spec/log4j.properties
+spec/spec_helper.rb
+spec/zookeeper_spec.rb
+test/test_basic.rb
+test/test_callback1.rb
+test/test_close.rb
+test/test_esoteric.rb
+test/test_watcher1.rb
+test/test_watcher2.rb

data/README.markdown

@@ -0,0 +1,85 @@
+# zookeeper #
+
+[![Build Status](https://secure.travis-ci.org/zk-ruby/zookeeper.png?branch=master)](http://travis-ci.org/zk-ruby/zookeeper)
+
+An interface to the Zookeeper cluster coordination server.
+
+For a higher-level interface with a more convenient API and features such as locks, have a look at [ZK](https://github.com/zk-ruby/zk).
+
+## Fork Safety! ##
+
+As of 1.1.0, this library is fork-safe (which was not easy to accomplish). This means you can use it without worry in unicorn, resque, and whatever other fork-philic frameworks you sick little monkeys are using this week. The only rule is that after a fork(), you need to call `#reopen` on the client ASAP, because if you try to peform any other action, an exception will be raised. Other than that, there is no special action that is needed in the parent.
+
+## Big Plans for 1.0 ##
+
+The 1.0 release will feature a reorganization of the heirarchy. There will be a single top-level `Zookeeper` namespace (as opposed to the current layout, with 5-6 different top-level constants), and for the next several releases, there will be a backwards compatible require for users that still need to use the old names.
+
+## License
+
+Copyright 2008 Phillip Pearson, and 2010 Twitter, Inc. 
+Licensed under the MIT License.  See the included LICENSE file.  
+
+Portions copyright 2008-2010 the Apache Software Foundation, licensed under the
+Apache 2 license, and used with permission.
+
+Portions contributed to the open source community by HPDC, L.P.
+
+## Install
+
+sudo gem install zookeeper
+
+### rbenv is awesome
+
+UPDATE: this appears to have been fixed by @eric in [this patch](http://git.io/PEPgnA). If you use rbenv, please report any issues, but I believe it should work now.
+
+Let me start out by saying I prefer rvm, and that I really don't know a whole lot about linking on OS X. Or Linux. Any suggestions or constructive insults would be greatly appreciated if you have insight into what i'm doing wrong here.
+
+So, it seems that [ruby-build][] doesn't use `--enable-shared` by default. I'm told this is for speed. 
+
+If you run into problems with installing this gem (specifically with linking ex. `Undefined symbols for architecture x86_64`) and you're using rbenv, for now you need to ensure that your ruby was built with `--enable-shared`. I'm sorry for the inconvenience. (no, really)
+
+```shell
+~ $ CONFIGURE_OPTS='--enable-shared --disable-install-doc' rbenv install 1.9.3-p194
+```
+
+[ruby-build]: https://github.com/sstephenson/ruby-build
+
+### A note for REE users
+
+The zookeeper client is required to send a heartbeat packet every N seconds to the server. If it misses its deadline 3 times in a row, the session will be lost. The way the client is implemented in versions `>= 1.2`, a *ruby* thread acts as the event thread (this was necessary to provide a fork-safe client with a parent process that is able to preserve state). Some users have reported issues where under load in "massive codebases," they have problems where calls will time out. Given the nature of the thread scheduler in 1.8, one should be careful if upgrading from `0.4.4` to `>= 1.2`.
+
+## Usage
+
+Connect to a server:
+
+	require 'rubygems'
+	require 'zookeeper'
+	z = Zookeeper.new("localhost:2181")
+	z.get_children(:path => "/")
+
+## Idioms
+
+The following methods are initially supported:
+* `get`
+* `set`
+* `get_children`
+* `stat`
+* `create`
+* `delete`
+* `get_acl`
+* `set_acl`
+
+All support async callbacks. `get`, `get_children` and `stat` support both watchers and callbacks.
+
+Calls take a dictionary of parameters. With the exception of set\_acl, the only required parameter is `:path`. Each call returns a dictionary with at minimum two keys :req\_id and :rc.
+
+### A Bit about this repository ###
+
+Twitter's open source office was kind enough to transfer this repository to facilitate development and administration of this repository. The `zookeeper` gem's last three releases were recorded in branches `v0.4.2`, `v0.4.3` and `v0.4.4`. Releases of the `slyphon-zookeeper` gem were cut off of the fork, and unfortunately (due to an oversight on my part) were tagged with unrelated versions. Those were tagged with names `release/0.9.2`. 
+
+The plan is to keep the `slyphon-zookeeper` tags, and to tag the `zookeeper` releases `twitter/release/0.4.x`.
+
+Further work will be carried out on this repository. The `0.9.3` release of the zookeeper gem will be released under the 'zookeeper' name, and will bring the two divergent (conceptual) branches of development together.
+
+
+

data/Rakefile

@@ -0,0 +1,121 @@
+release_ops_path = File.expand_path('../releaseops/lib', __FILE__)
+
+# if the special submodule is availabe, use it
+# we use a submodule because it doesn't depend on anything else (*cough* bundler)
+# and can be shared across projects
+#
+if File.exists?(release_ops_path)
+  require File.join(release_ops_path, 'releaseops')
+
+  # sets up the multi-ruby zk:test_all rake tasks
+  ReleaseOps::TestTasks.define_for(*%w[1.8.7 1.9.2 jruby rbx ree 1.9.3])
+
+  # sets up the task :default => 'spec:run' and defines a simple
+  # "run the specs with the current rvm profile" task
+  ReleaseOps::TestTasks.define_simple_default_for_travis
+
+  # Define a task to run code coverage tests
+  ReleaseOps::TestTasks.define_simplecov_tasks
+
+  # set up yard:server, yard:gems, and yard:clean tasks 
+  # for doing documentation stuff
+  ReleaseOps::YardTasks.define
+
+  task :clean => 'yard:clean'
+
+  namespace :zk do
+    namespace :gems do
+      desc "Build gems to prepare for a release. Requires TAG="
+      task :build do
+        require 'tmpdir'
+
+        raise "You must specify a TAG" unless ENV['TAG']
+
+        ReleaseOps.with_tmpdir(:prefix => 'zookeeper') do |tmpdir|
+          tag = ENV['TAG']
+
+          sh "git clone . #{tmpdir}"
+
+          orig_dir = Dir.getwd
+
+          cd tmpdir do
+            sh "git co #{tag} && git reset --hard && git clean -fdx"
+
+            ENV['JAVA_GEM'] = nil
+            sh "gem build zookeeper.gemspec"
+            sh "env JAVA_GEM=1 gem build zookeeper.gemspec"
+
+            mv FileList['*.gem'], orig_dir
+          end
+        end
+      end
+
+      desc "Release gems that have been built"
+      task :push do
+        gems = FileList['*.gem']
+        raise "No gemfiles to push!" if gems.empty?
+
+        gems.each do |gem|
+          sh "gem push #{gem}"
+        end
+      end
+
+      task :clean do
+        rm_rf FileList['*.gem']
+      end
+
+      task :all => [:build, :push, :clean]
+    end
+  end
+end
+
+task :clobber do
+  rm_rf 'tmp'
+end
+
+# cargo culted from http://blog.flavorjon.es/2009/06/easily-valgrind-gdb-your-ruby-c.html
+VALGRIND_BASIC_OPTS = '--num-callers=50 --error-limit=no --partial-loads-ok=yes --undef-value-errors=no --trace-children=yes'
+
+task 'valgrind' do
+  cd 'ext' do
+    sh "rake clean build"
+  end
+
+  sh "valgrind #{VALGRIND_BASIC_OPTS} bundle exec rspec spec"
+end
+
+namespace :build do
+  task :clean do
+    cd 'ext' do
+      sh 'rake clean'
+    end
+
+    Rake::Task['build'].invoke
+  end
+
+  task :clobber do
+    cd 'ext' do
+      sh 'rake clobber'
+    end
+
+    Rake::Task['build'].invoke
+  end
+end
+
+desc "Build C component"
+task :build do
+  cd 'ext' do
+    sh "rake"
+  end
+end
+
+task 'spec:run' => 'build:clean' unless defined?(::JRUBY_VERSION)
+
+task 'ctags' do
+  sh 'bundle-ctags'
+end
+
+# because i'm a creature of habit
+task 'mb:test_all' => 'zk:test_all'
+
+

data/cause-abort.rb

@@ -0,0 +1,117 @@
+#!/usr/bin/env ruby
+
+require 'zookeeper'
+require File.expand_path('../spec/support/zookeeper_spec_helpers', __FILE__)
+
+class CauseAbort
+  include Zookeeper::Logger
+  include Zookeeper::SpecHelpers
+
+  attr_reader :path, :pids_root, :data
+
+  def initialize
+    @path = "/_zktest_"
+    @pids_root = "#{@path}/pids"
+    @data = 'underpants'
+  end
+
+  def before
+    @zk = Zookeeper.new('localhost:2181')
+    rm_rf(@zk, path)
+    logger.debug { "----------------< BEFORE: END >-------------------" }
+  end
+
+  def process_alive?(pid)
+    Process.kill(0, @pid)
+    true
+  rescue Errno::ESRCH
+    false
+  end
+
+  def wait_for_child_safely(pid, timeout=5)
+    time_to_stop = Time.now + timeout
+
+    until Time.now > time_to_stop
+      if a = Process.wait2(@pid, Process::WNOHANG)
+        return a.last
+      else
+        sleep(0.01)
+      end
+    end
+
+    nil
+  end
+
+  def try_pause_and_resume
+    @zk.pause
+    logger.debug { "paused" }
+    @zk.resume
+    logger.debug { "resumed" }
+    @zk.close
+    logger.debug { "closed" }
+  end
+
+  def run_test
+    logger.debug { "----------------< TEST: BEGIN >-------------------" }
+    @zk.wait_until_connected
+
+    mkdir_p(@zk, pids_root)
+
+    # the parent's pid path
+    @zk.create(:path => "#{pids_root}/#{$$}", :data => $$.to_s)
+
+    @latch = Zookeeper::Latch.new
+    @event = nil
+
+    cb = proc do |h|
+      logger.debug { "watcher called back: #{h.inspect}" }
+      @event = h
+      @latch.release
+    end
+
+    @zk.stat(:path => "#{pids_root}/child", :watcher => cb)
+
+    logger.debug { "------------------->   FORK   <---------------------------" }
+
+    @pid = fork do
+      rand_sleep = rand()
+
+      $stderr.puts "sleeping for rand_sleep: #{rand_sleep}"
+      sleep(rand_sleep)
+
+      logger.debug { "reopening connection in child: #{$$}" }
+      @zk.reopen
+      logger.debug { "creating path" }
+      rv = @zk.create(:path => "#{pids_root}/child", :data => $$.to_s)
+      logger.debug { "created path #{rv[:path]}" }
+      @zk.close
+
+      logger.debug { "close finished" }
+      exit!(0)
+    end
+
+    event_waiter_th = Thread.new do
+      @latch.await(5) unless @event 
+      @event
+    end
+
+    logger.debug { "waiting on child #{@pid}" }
+
+    status = wait_for_child_safely(@pid)
+    raise "Child process did not exit, likely hung"  unless status
+
+    if event_waiter_th.join(5) == event_waiter_th
+      logger.warn { "event waiter has not received events" }
+    end
+
+    exit(@event.nil? ? 1 : 0)
+  end
+
+  def run
+    before
+    run_test
+#     try_pause_and_resume
+  end
+end
+
+CauseAbort.new.run

data/ext/.gitignore

@@ -0,0 +1,6 @@
+bin
+include
+lib
+*.bundle
+
+c

data/ext/Rakefile

@@ -0,0 +1,41 @@
+require 'rbconfig'
+
+ZKRB_WRAPPER = %w[zkrb_wrapper.c zkrb_wrapper.h]
+
+namespace :zkrb do
+  task :clean do
+    if File.exists?('Makefile')
+      sh 'make clean'
+      rm 'Makefile' # yep, regenerate this
+    else
+      $stderr.puts "nothing to clean, no Makefile"
+    end
+  end
+
+  task :clobber => :clean do
+    rm_rf %w[Makefile c lib bin include ._c] + ZKRB_WRAPPER
+  end
+end
+
+task :clean    => 'zkrb:clean'
+task :clobber  => 'zkrb:clobber'
+task :wrappers => ZKRB_WRAPPER
+task :default  => :build
+
+file 'zkrb_wrapper.c' => 'generate_gvl_code.rb' do
+  sh "ruby generate_gvl_code.rb code"
+end
+
+file 'zkrb_wrapper.h' => 'generate_gvl_code.rb' do
+  sh "ruby generate_gvl_code.rb headers"
+end
+
+file 'Makefile' do
+  sh "ruby extconf.rb"
+end
+
+task :build => [ 'Makefile', :wrappers ] do
+  sh 'make'
+end
+
+