telekinesis 3.0.0-java → 3.1.0-java

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b4fa22c623dd098fff1cefccc7b48d9c543858b3
-  data.tar.gz: b3063eaed5976b9744ecc6eb13fa0fa05c42a184
+  metadata.gz: 64568f19bf5cb841186d4d33b5d1a3bbc3e83ee2
+  data.tar.gz: 95b27916188a9387a46094674ffcd3e3d9dcc4c5
 SHA512:
-  metadata.gz: 58272a8819dae59636c4c0827da20d244675d2a0404795d2cb33a724643cd31c195c0a692623545483563d7a920257ea8536e0496e8f8b0d938c4fba824c0752
-  data.tar.gz: 07ee614c9d050cd3b37e6d0a4d038dc3efea8e86704d4a2516b9c91ceb0c7efcbfc62d700f84b8f9234385fbd9152411253f0b286dd4c7f0c7470b4bd6627542
+  metadata.gz: 87b0c34a4b7183fd30d8954e95f40a0b65976c572fbfd8b550a6561f6874f2845720d062291dea7ad8855443ba6d33c50c1bf6d508ac9608338fc9b753ef8b1a
+  data.tar.gz: 36be781fe1fbc64944fff46e92417d7fc50a1c687b689beae7a69b1be1183cb562237f0a19f17da5f408c0e0fe3298c78eff6f3c78b9a55ba6f36cd5c5ec7ebc

data/README.md

@@ -230,9 +230,11 @@ class MyProcessor
   end
 end
 
-Telekinesis::Consumer::KCL.new(stream: 'some-events', app: 'example') do
+worker = Telekinesis::Consumer::KCL.new(stream: 'some-events', app: 'example') do
   MyProcessor.new
 end
+
+worker.run
 ```
 
 To make defining record processors easier, Telekinesis comes with a `Block`
@@ -243,11 +245,13 @@ processor.
 ```ruby
 require 'telekinesis'
 
-Telekinesis::Consumer::KCL.new(stream: 'some-events', app: 'example') do
+worker = Telekinesis::Consumer::KCL.new(stream: 'some-events', app: 'example') do
   Telekinesis::Consumer::Block.new do |records, checkpointer, millis_behind|
     records.each {|r| puts "key=#{r.partition_key} value=#{String.from_java_bytes(r.data.array)}" }
   end
 end
+
+worker.run
 ```
 
 Once you get into building a client application, you'll probably want

data/ext/pom.xml

@@ -4,7 +4,7 @@
 
     <groupId>com.kickstarter</groupId>
     <artifactId>telekinesis</artifactId>
-    <version>3.0.0</version>
+    <version>3.1.0</version>
 
     <!-- ================================================================== -->
     <build>

data/ext/src/main/java/com/kickstarter/jruby/Telekinesis.java

@@ -16,6 +16,8 @@ import com.amazonaws.services.kinesis.clientlibrary.types.ProcessRecordsInput;
 import com.amazonaws.services.kinesis.clientlibrary.types.ShutdownInput;
 import com.amazonaws.services.kinesis.model.Record;
 
+import java.util.concurrent.ExecutorService;
+
 /**
  * A shim that makes it possible to use the Kinesis Client Library from JRuby.
  * Without the shim, {@code initialize} method in
@@ -24,16 +26,16 @@ import com.amazonaws.services.kinesis.model.Record;
  * interface renames {@code initialize} to {@code init}.
  * <p />
  *
- * For convenience a {@link #newWorker(KinesisClientLibConfiguration, IRecordProcessorFactory)}
+ * For convenience a {@link #newWorker(KinesisClientLibConfiguration, ExecutorService, IRecordProcessorFactory)}
  * method is provided, so you can use closure conversion in JRuby to specify an
  * {@link IRecordProcessorFactory}. For example
  *
  * <p />
  *
  * <pre>
- *     some_thing = ...
+ *     executor = config[:executor] || nil
  *
- *     com.kickstarter.jruby.Telekinesis.new_worker(my_config) do
+ *     com.kickstarter.jruby.Telekinesis.new_worker(my_config, executor) do
  *       MyRecordProcessor.new(some_thing, some_other_thing)
  *     end
  * </pre>
@@ -41,19 +43,23 @@ import com.amazonaws.services.kinesis.model.Record;
 public class Telekinesis {
     /**
      * Create a new KCL {@link Worker} that processes records using the given
-     * {@link IRecordProcessorFactory}.
+     * {@link ExecutorService} and {@link IRecordProcessorFactory}.
      */
-    public static Worker newWorker(final KinesisClientLibConfiguration config, final IRecordProcessorFactory factory) {
+    public static Worker newWorker(final KinesisClientLibConfiguration config,
+                                   final ExecutorService executor,
+                                   final IRecordProcessorFactory factory) {
         com.amazonaws.services.kinesis.clientlibrary.interfaces.v2.IRecordProcessorFactory v2Factory = new com.amazonaws.services.kinesis.clientlibrary.interfaces.v2.IRecordProcessorFactory() {
             @Override
             public com.amazonaws.services.kinesis.clientlibrary.interfaces.v2.IRecordProcessor createProcessor() {
                 return new RecordProcessorShim(factory.createProcessor());
             }
         };
+
         return new Worker.Builder()
-            .recordProcessorFactory(v2Factory)
-            .config(config)
-            .build();
+                .recordProcessorFactory(v2Factory)
+                .config(config)
+                .execService(executor) // NOTE: .execService(null) is a no-op
+                .build();
     }
 
     // ========================================================================

data/lib/telekinesis/consumer/kcl.rb

@@ -67,7 +67,7 @@ module Telekinesis
       def initialize(config, &block)
         raise ArgumentError, "No block given!" unless block_given?
         kcl_config = self.class.build_config(config)
-        @under = com.kickstarter.jruby.Telekinesis.new_worker(kcl_config, &block)
+        @under = com.kickstarter.jruby.Telekinesis.new_worker(kcl_config, config[:executor], &block)
       end
 
       # Return the underlying KCL worker. It's a java.lang.Runnable.
@@ -97,6 +97,7 @@ module Telekinesis
           raise ArgumentError, "#{k} is required" unless config.include?(k)
           config[k]
         end
+
         # Use this host as the worker_id by default.
         worker_id = config.fetch(:worker_id, `hostname`.chomp)
 

data/lib/telekinesis/version.rb

@@ -1,3 +1,3 @@
 module Telekinesis
-  VERSION = '3.0.0'
+  VERSION = '3.1.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: telekinesis
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 3.1.0
 platform: java
 authors:
 - Ben Linsay
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2015-10-28 00:00:00.000000000 Z
+date: 2015-12-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
@@ -106,7 +106,7 @@ files:
 - test/producer/test_helper.rb
 - test/producer/test_sync_producer.rb
 - test/test_helper.rb
-- lib/telekinesis/telekinesis-3.0.0.jar
+- lib/telekinesis/telekinesis-3.1.0.jar
 homepage: https://github.com/kickstarter/telekinesis
 licenses: []
 metadata: {}