bluster 0.5.3-java

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 31d744ce0e17ed492c2e1b2365555c95a9d3962b
+  data.tar.gz: ec3ba97d19f1b327c99166e7f8dcd424a4e7395c
+SHA512:
+  metadata.gz: ebb878c5e06ca0598e6c9e2b2e834ca3ecbc6bb1604f7451e766e71723835bae3c3c5caaccd71746903effd1c89537c46e746d3ed1f7dfa3ed848e127a9ba42e
+  data.tar.gz: 12b7c42903c9ef19e8a7ce2ee7be3fd7a39baa568e9994978a500ce4d313e8375a17a624363299fd2dbadcc3305de4bbb038172092786be08de14252cb7b24e6

data/README.md

@@ -0,0 +1,86 @@
+# bluster
+
+Bluster is a thin JRuby wrapper around Boundary's [Ordasity](https://github.com/boundary/ordasity), and it's purpose is
+merely to make the API a bit friendlier for (J)Ruby developers.
+
+## Usage
+
+The [docs](https://github.com/boundary/ordasity) provided by Boundary are themselves well enough to get up and running,
+even without the following example.
+
+```ruby
+require 'bluster'
+
+class SimpleListener < Bluster::ClusterListener
+  def joined(client)
+    puts "Joined cluster!"
+    puts "Got one of them ZooKeeper clients: #{client}"
+  end
+
+  def start_work(unit)
+    puts "Woohoo! Claimed this one: #{unit}"
+  end
+
+  def shutdown_work(unit)
+    puts "Booh! Shutting down this one: #{unit}"
+  end
+
+  def left
+    puts 'Aww, bummer, leaving'
+  end
+end
+
+cluster_options = {
+  hosts: 'localhost:2181',
+  zk_timeout: 5,
+  drain_time: 1,
+  rebalance_interval: 1,
+}
+
+cluster = Bluster.create_cluster('simple', SimpleListener.new, cluster_options)
+cluster.join
+
+sleep 3
+
+cluster.shutdown
+```
+
+There is also a very similar example in ```examples/simple.rb```, though it
+should be mentioned that it requires the ```zk``` gem as well (which is included
+as a development dependency in the gemspec).
+
+The aim of the examples was actually to have a cluster with two listeners, but
+JMX didn't seem to like it when I started two listeners with the same name on
+the same host, and I don't really have the time to debug that right now, so a
+single listener will have to do.
+
+## Installation
+
+```
+gem install bluster
+```
+
+## Known issues and limitations
+
+* It is not possible to override ```#initialize``` when subclassing one of the
+  listener classes (```Bluster::ClusterListener```, ```Bluster::SmartListener```).
+  I'm not really sure _WHY_, but there's probably a good reason.
+  Thinking about adding some kind of convenience method / option to circumvent this.
+
+## bluster?
+
+Talk in a loud, aggressive, or indignant way with little effect.
+
+## Copyright
+Copyright 2013 Mathias Söderberg
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License. You may obtain a copy of the
+License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

data/lib/bluster.rb

@@ -0,0 +1,13 @@
+# encoding: utf-8
+
+require 'ordasity'
+
+require 'bluster/cluster_config'
+require 'bluster/listener'
+
+module Bluster
+  def self.create_cluster(name, listener, options = {})
+    config = Bluster::ClusterConfig.create(options)
+    Ordasity::Cluster.new(name, listener, config)
+  end
+end

data/lib/bluster/cluster_config.rb

@@ -0,0 +1,32 @@
+# encoding: utf-8
+
+module Bluster
+  class ClusterConfig
+    def self.create(options = {})
+      config = Ordasity::ClusterConfig.new
+
+      options.each do |option, value|
+        config.send(wrap_with_prefix(option), value)
+      end
+
+      config
+    end
+
+    def self.wrap_with_prefix(option)
+      [prefix_for(option), option].join(UNDERSCORE).to_sym
+    end
+
+    def self.prefix_for(option)
+      PREFIXES[option] || SET_PREFIX
+    end
+
+    SET_PREFIX = 'set'.freeze
+    UNDERSCORE = '_'.freeze
+
+    PREFIXES = {
+      soft_handoff: 'set_use',
+      smart_balancing: 'use'
+    }.freeze
+
+  end
+end

data/lib/bluster/listener.rb

@@ -0,0 +1,21 @@
+module Bluster
+  module RubyesqueListenerCallbacks
+    def joined(client); end
+    def start_work(*args); end
+    def shutdown_work(unit); end
+    def left; end
+
+    def onJoin(client); joined(client); end
+    def startWork(*args); start_work(*args); end
+    def shutdownWork(unit); shutdown_work(unit); end
+    def onLeave; left; end
+  end
+
+  class ClusterListener < Ordasity::ClusterListener
+    include RubyesqueListenerCallbacks
+  end
+
+  class SmartListener < Ordasity::SmartListener
+    include RubyesqueListenerCallbacks
+  end
+end

data/lib/bluster/version.rb

@@ -0,0 +1,5 @@
+# encoding: utf-8
+
+module Bluster
+  VERSION = '0.5.3'.freeze
+end

data/lib/ordasity.rb

@@ -0,0 +1,9 @@
+require 'ordasity-jars'
+
+module Ordasity
+  java_import 'com.boundary.ordasity.Cluster'
+  java_import 'com.boundary.ordasity.ClusterConfig'
+  java_import 'com.boundary.ordasity.Listener'
+  java_import 'com.boundary.ordasity.ClusterListener'
+  java_import 'com.boundary.ordasity.SmartListener'
+end

data/spec/bluster/cluster_config_spec.rb

@@ -0,0 +1,37 @@
+require 'spec_helper'
+
+module Bluster
+  describe ClusterConfig do
+    describe '.create' do
+      let :config do
+        Bluster::ClusterConfig.create({
+          hosts: 'localhost:2181,localhost:2182',
+          auto_rebalance: true,
+          rebalance_interval: 10,
+          drain_time: 10,
+          smart_balancing: true,
+          zk_timeout: 2000,
+          work_unit_name: 'work-units',
+          work_unit_short_name: 'work',
+          node_id: '1234',
+          soft_handoff: true,
+          handoff_shutdown_delay: 10
+        })
+      end
+
+      it 'creates a Ordasity::ClusterConfig object with given options' do
+        config.hosts.should == 'localhost:2181,localhost:2182'
+        config.enableAutoRebalance.should be_true
+        config.autoRebalanceInterval.should == 10
+        config.drainTime.should == 10
+        config.useSmartBalancing.should be_true
+        config.zkTimeout.should == 2000
+        config.workUnitName.should == 'work-units'
+        config.workUnitShortName.should == 'work'
+        config.nodeId.should_not be_nil
+        config.useSoftHandoff.should be_true
+        config.handoffShutdownDelay.should == 10
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+require 'bluster'
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.order = 'random'
+end

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification
+name: bluster
+version: !ruby/object:Gem::Version
+  version: 0.5.3
+platform: java
+authors:
+- Mathias Söderberg
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2013-08-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ordasity-jars
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.5.3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.5.3
+  prerelease: false
+  type: :runtime
+- !ruby/object:Gem::Dependency
+  name: zk
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  prerelease: false
+  type: :development
+description: |
+  Bluster is a thin JRuby wrapper for Ordasity
+email:
+- mths@sdrbrg.se
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/bluster.rb
+- lib/ordasity.rb
+- lib/bluster/cluster_config.rb
+- lib/bluster/listener.rb
+- lib/bluster/version.rb
+- README.md
+- spec/spec_helper.rb
+- spec/bluster/cluster_config_spec.rb
+homepage: http://github.com/mthssdrbrg/bluster
+licenses:
+- Apache License 2.0
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project:
+rubygems_version: 2.0.5
+signing_key:
+specification_version: 4
+summary: Bluster is a thin JRuby wrapper for Ordasity
+test_files:
+- spec/spec_helper.rb
+- spec/bluster/cluster_config_spec.rb