kafka-clients-jruby 1.0.0.pre0-java → 1.0.0.pre1-java

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5b8d7494c51897b53efc988207face0fa90ccb5b
-  data.tar.gz: 3ba676560f6c2ae2d0266cd8d3ec62ecd2f72c40
+  metadata.gz: fbc8d425d6981d0e63e316120b14213858e4654d
+  data.tar.gz: 738e1f0667c02a508afb613530c365c71b2fcd62
 SHA512:
-  metadata.gz: ed3289705b9a695fd9167dab7a55d50b760e1928f63c061a360a93f14873e7f347ba6907ebd04f777e5fe9c593249f1796b1d1bf21fb6016f50a16014ebd57a1
-  data.tar.gz: 7dd8fe2e2ef8735a871e353afed9a98955817ebab7948fee5e67193469ba71f5451768aeb7cc62ed679eef913c9fe4fcdd83a60c7de03e3ced4f8b9922e596fd
+  metadata.gz: c41bc40d8bfb2ab934eac8785c07a1c7c8566776a3c9cc32345d2a76d3635a544b8e9ec4a6cb7daf9f7013fa0fd845532fda1c0d355a3c55361a5f0675edb869
+  data.tar.gz: 6b81ed7cf1f7aa227159367937a45c4863624b7ea0a67332ef2f4ecd5fe70a05413cecbe4cde82701db6a0f4df5a60a64484feb0e2b256b80d0339d2b207ff03

data/lib/kafka/clients/cluster.rb

@@ -0,0 +1,51 @@
+module Kafka
+  module Clients
+    class Cluster
+      # @!method nodes
+      #   @return [Enumerable<Kafka::Clients::Node>]
+
+      # @!method node_by_id(node_id)
+      #   @param node_id [Integer]
+      #   @return [Kafka::Clients::Node]
+
+      # @!method leader_for(topic_partition)
+      #   @return [Kafka::Clients::Node]
+      #   @overload leader_for(topic_partition)
+      #     @param topic_partition [Kafka::Clients::TopicPartition]
+      #     @return [Kafka::Clients::Node]
+      #   @overload leader_for(topic, partition)
+      #     @param topic [String]
+      #     @param partition [Integer]
+      #     @return [Kafka::Clients::Node]
+
+      # @!method partition(topic_partition)
+      #   @return [Kafka::Clients::PartitionInfo]
+      #   @overload partition(topic_partition)
+      #     @param topic_partition [Kafka::Clients::TopicPartition]
+      #     @return [Kafka::Clients::PartitionInfo]
+      #   @overload partition(topic, partition)
+      #     @param topic [String]
+      #     @param partition [Integer]
+      #     @return [Kafka::Clients::PartitionInfo]
+
+      # @!method partitions_for_topic(topic_name)
+      #   @param topic_name [String]
+      #   @return [Enumerable<Kafka::Clients::PartitionInfo>]
+
+      # @!method available_partitions_for_topic(topic_name)
+      #   @param topic_name [String]
+      #   @return [Enumerable<Kafka::Clients::PartitionInfo>]
+
+      # @!method partitions_for_node(node_id)
+      #   @param node_id [Integer]
+      #   @return [Enumerable<Kafka::Clients::PartitionInfo>]
+
+      # @!method partition_count_for_topic(topic_name)
+      #   @param topic_name [String]
+      #   @return [Integer, nil]
+
+      # @!method topics
+      #   @return [Enumerable<String>]
+    end
+  end
+end

data/lib/kafka/clients/consumer.rb

@@ -0,0 +1,95 @@
+module Kafka
+  module Clients
+    class Consumer
+      # @!method initialize(configuration)
+      #   @param configuration [Hash]
+      #   @return [self]
+
+      # @!method close
+      #   @return [nil]
+
+      # @!method partitions_for(topic_name)
+      #   @param topic_name [String]
+      #   @return [Enumerable<Kafka::Clients::PartitionInfo>]
+
+      # @!method subscribe(topic_names_or_pattern)
+      #   @param topic_names_or_pattern [Enumerable<String>, String]
+      #   @return [nil]
+
+      # @!method subscription
+      #   @return [Enumerable<String>]
+
+      # @!method usubscribe
+      #   @return [nil]
+
+      # @!method poll(timeout)
+      #   @param timeout [Float] the number of seconds (not milliseconds) to
+      #     wait for records
+      #   @return [Kafka::Clients::ConsumerRecords]
+
+      # @!method commit_sync(offsets=nil)
+      #   @param offsets [Hash<Kafka::Clients::TopicPartition, (Kafka::Clients::OffsetAndMetadata, Integer)>]
+      #   @return [nil]
+
+      # @!method commit_async(offsets=nil)
+      #   @param offsets [Hash<Kafka::Clients::TopicPartition, (Kafka::Clients::OffsetAndMetadata, Integer)>]
+      #   @yieldparam offsets [Hash<Kafka::Clients::TopicPartition, Kafka::Clients::OffsetAndMetadata>]
+      #   @yieldparam error [Kafka::Clients::KafkaError]
+      #   @return [nil]
+
+      # @!method position(topic_partition)
+      #   @return [Integer]
+      #   @overload position(topic_partition)
+      #     @param topic_partition [TopicPartition]
+      #     @return [Integer]
+      #   @overload position(topic, partition)
+      #     @param topic [String]
+      #     @param partition [Integer]
+      #     @return [Integer]
+
+      # @!method seek_to_beginning(topic_partitions=nil)
+      #   @param topic_partitions [Enumerable<Kafka::Clients::TopicPartition>]
+      #   @return [nil]
+
+      # @!method seek_to_end(topic_partitions=nil)
+      #   @param topic_partitions [Enumerable<Kafka::Clients::TopicPartition>]
+      #   @return [nil]
+
+      # @!method seek(topic_partition, offset)
+      #   @return [nil]
+      #   @overload seek(topic_partition, offset)
+      #     @param topic_partition [Kafka::Clients::TopicPartition]
+      #     @param offset [Integer]
+      #     @return [nil]
+      #   @overload seek(topic, partition, offset)
+      #     @param topic [String]
+      #     @param partition [Integer]
+      #     @param offset [Integer]
+      #     @return [nil]
+
+      # @!method assign(topic_partitions)
+      #   @param topic_partitions [Enumerable<Kafka::Clients::TopicPartition>]
+      #   @return [nil]
+
+      # @!method assignment
+      #   @return [Enumerable<TopicPartition>]
+
+      # @!method wakeup
+      #   @return [nil]
+
+      # @!method list_topics
+      #   @return [Hash<String, Enumerable<Kafka::Clients::PartitionInfo>>]
+
+      # @!method pause(topic_partitions)
+      #   @param topic_partitions [Enumerable<Kafka::Clients::TopicPartition>]
+      #   @return [nil]
+
+      # @!method resume(topic_partitions)
+      #   @param topic_partitions [Enumerable<Kafka::Clients::TopicPartition>]
+      #   @return [nil]
+
+      # @!method paused
+      #   @return [Enumerable<Kafka::Clients::TopicPartition>]
+    end
+  end
+end

data/lib/kafka/clients/consumer_record.rb

@@ -0,0 +1,29 @@
+module Kafka
+  module Clients
+    class ConsumerRecord
+      # @!method topic
+      #   @return [String]
+
+      # @!method partition
+      #   @return [Integer]
+
+      # @!method offset
+      #   @return [Integer]
+
+      # @!method checksum
+      #   @return [Integer]
+
+      # @!method key
+      #   @return [String]
+
+      # @!method value
+      #   @return [String]
+
+      # @!method timestamp
+      #   @return [Timestamp]
+
+      # @!method timestamp_type
+      #   @return [Symbol]
+    end
+  end
+end

data/lib/kafka/clients/consumer_records.rb

@@ -0,0 +1,19 @@
+module Kafka
+  module Clients
+    class ConsumerRecords
+      include Enumerable
+
+      # @!method count
+      #   @return [Integer]
+
+      alias_method :size, :count
+
+      # @!method each
+      #   @yieldparam record [Kafka::Clients::ConsumerRecord]
+      #   @return [Enumerable<Kafka::Clients::ConsumerRecord>]
+
+      # @!method empty?
+      #   @return [true, false]
+    end
+  end
+end

data/lib/kafka/clients/future.rb

@@ -0,0 +1,13 @@
+module Kafka
+  module Clients
+    class Future
+      # @!method done?
+      #   @return [true, false]
+
+      # @!method get(options=nil)
+      #   @param options [Hash]
+      #   @option options [Float] :timeout
+      #   @return [Object]
+    end
+  end
+end

data/lib/kafka/clients/node.rb

@@ -0,0 +1,23 @@
+module Kafka
+  module Clients
+    class Node
+      # @!method has_rack?
+      #   @return [true, false]
+
+      # @!method rack
+      #   @return [String, nil]
+
+      # @!method host
+      #   @return [String]
+
+      # @!method id
+      #   @return [Integer]
+
+      # @!method empty?
+      #   @return [true, false]
+
+      # @!method port
+      #   @return [Integer]
+    end
+  end
+end

data/lib/kafka/clients/offset_and_metadata.rb

@@ -0,0 +1,16 @@
+module Kafka
+  module Clients
+    class OffsetAndMetadata
+      # @!method initialize(offset, metadata=nil)
+      #   @param offset [Integer]
+      #   @param metadata [String]
+      #   @return [self]
+
+      # @!method offset
+      #   @return [Integer]
+
+      # @!method metadata
+      #   @return [String, nil]
+    end
+  end
+end

data/lib/kafka/clients/partition_info.rb

@@ -0,0 +1,20 @@
+module Kafka
+  module Clients
+    class PartitionInfo
+      # @!method topic
+      #   @return [String]
+
+      # @!method partition
+      #   @return [Integer]
+
+      # @!method leader
+      #   @return [Kafka::Clients::Node]
+
+      # @!method replicas
+      #   @return [Enumerable<Kafka::Clients::Node>]
+
+      # @!method in_sync_replicas
+      #   @return [Enumerable<Kafka::Clients::Node>]
+    end
+  end
+end

data/lib/kafka/clients/producer.rb

@@ -0,0 +1,61 @@
+module Kafka
+  module Clients
+    class Producer
+      # @!method initialize(configuration)
+      #   @param configuration [Hash]
+      #   @return [self]
+
+      # @!method close(options=nil)
+      #   @param options [Hash]
+      #   @option options [Float] :timeout
+      #   @return [self]
+
+      # @!method send(record)
+      #   @yieldparam metadata [Kafka::Clients::RecordMetadata]
+      #   @yieldparam error [Kafka::Clients::KafkaError]
+      #   @return [Kafka::Clients::Future<Kafka::Clients::RecordMetadata>]
+      #   @overload send(record)
+      #     @yieldparam metadata [Kafka::Clients::RecordMetadata]
+      #     @yieldparam error [Kafka::Clients::KafkaError]
+      #     @param record [Kafka::Clients::ProducerRecord]
+      #     @return [Kafka::Clients::Future<Kafka::Clients::RecordMetadata>]
+      #   @overload send(topic, value)
+      #     @yieldparam metadata [Kafka::Clients::RecordMetadata]
+      #     @yieldparam error [Kafka::Clients::KafkaError]
+      #     @param topic [String]
+      #     @param value [String]
+      #     @return [Kafka::Clients::Future<Kafka::Clients::RecordMetadata>]
+      #   @overload send(topic, key, value)
+      #     @yieldparam metadata [Kafka::Clients::RecordMetadata]
+      #     @yieldparam error [Kafka::Clients::KafkaError]
+      #     @param topic [String]
+      #     @param key [String]
+      #     @param value [String]
+      #     @return [Kafka::Clients::Future<Kafka::Clients::RecordMetadata>]
+      #   @overload send(topic, partition, key, value)
+      #     @yieldparam metadata [Kafka::Clients::RecordMetadata]
+      #     @yieldparam error [Kafka::Clients::KafkaError]
+      #     @param topic [String]
+      #     @param partition [Integer]
+      #     @param key [String]
+      #     @param value [String]
+      #     @return [Kafka::Clients::Future<Kafka::Clients::RecordMetadata>]
+      #   @overload send(topic, partition, timestamp, key, value)
+      #     @yieldparam metadata [Kafka::Clients::RecordMetadata]
+      #     @yieldparam error [Kafka::Clients::KafkaError]
+      #     @param topic [String]
+      #     @param partition [Integer]
+      #     @param timestamp [Time, Float]
+      #     @param key [String]
+      #     @param value [String]
+      #     @return [Kafka::Clients::Future<Kafka::Clients::RecordMetadata>]
+
+      # @!method flush
+      #   @return [nil]
+
+      # @!method partitions_for(topic_name)
+      #   @param topic_name [String]
+      #   @return [Enumerable<Kafka::Clients::PartitionInfo>]
+    end
+  end
+end

data/lib/kafka/clients/producer_record.rb

@@ -0,0 +1,45 @@
+module Kafka
+  module Clients
+    class ProducerRecord
+      # @!method initialize(topic, partition, timestamp, key, value)
+      #   @return [self]
+      #   @overload send(topic, value)
+      #     @param topic [String]
+      #     @param value [String]
+      #     @return [self]
+      #   @overload send(topic, key, value)
+      #     @param topic [String]
+      #     @param key [String]
+      #     @param value [String]
+      #     @return [self]
+      #   @overload send(topic, partition, key, value)
+      #     @param topic [String]
+      #     @param partition [Integer]
+      #     @param key [String]
+      #     @param value [String]
+      #     @return [self]
+      #   @overload send(topic, partition, timestamp, key, value)
+      #     @param topic [String]
+      #     @param partition [Integer]
+      #     @param timestamp [Time, Float]
+      #     @param key [String]
+      #     @param value [String]
+      #     @return [self]
+
+      # @!method topic
+      #   @return [String]
+
+      # @!method partition
+      #   @return [Integer]
+
+      # @!method timestamp
+      #   @return [Time]
+
+      # @!method key
+      #   @return [String]
+
+      # @!method value
+      #   @return [String]
+    end
+  end
+end

data/lib/kafka/clients/record_metadata.rb

@@ -0,0 +1,26 @@
+module Kafka
+  module Clients
+    class RecordMetadata
+      # @!method topic
+      #   @return [String]
+
+      # @!method partition
+      #   @return [Integer]
+
+      # @!method timestamp
+      #   @return [Time]
+
+      # @!method offset
+      #   @return [Integer]
+
+      # @!method checksum
+      #   @return [Integer]
+
+      # @!method serialized_key_size
+      #   @return [Integer]
+
+      # @!method serialized_value_size
+      #   @return [Integer]
+    end
+  end
+end

data/lib/kafka/clients/topic_partition.rb

@@ -0,0 +1,14 @@
+module Kafka
+  module Clients
+    class TopicPartition
+      # @!method initialize(topic, partition)
+      #   @return [self]
+
+      # @!method topic
+      #   @return [String]
+
+      # @!method partition
+      #   @return [Integer]
+    end
+  end
+end

data/lib/kafka/clients/version.rb

@@ -2,6 +2,6 @@
 
 module Kafka
   module Clients
-    VERSION = '1.0.0.pre0'
+    VERSION = '1.0.0.pre1'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kafka-clients-jruby
 version: !ruby/object:Gem::Version
-  version: 1.0.0.pre0
+  version: 1.0.0.pre1
 platform: java
 authors:
 - Theo Hultberg
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2016-10-07 00:00:00.000000000 Z
+date: 2016-10-09 00:00:00.000000000 Z
 dependencies: []
 description: Native JRuby wrappers of the Kafka producer and consumer clients
 email: theo@burtcorp.com
@@ -19,9 +19,21 @@ files:
 - ".yardopts"
 - README.md
 - lib/kafka/clients.rb
+- lib/kafka/clients/cluster.rb
+- lib/kafka/clients/consumer.rb
+- lib/kafka/clients/consumer_record.rb
+- lib/kafka/clients/consumer_records.rb
 - lib/kafka/clients/ext/kafka_clients.jar
+- lib/kafka/clients/future.rb
+- lib/kafka/clients/node.rb
+- lib/kafka/clients/offset_and_metadata.rb
+- lib/kafka/clients/partition_info.rb
+- lib/kafka/clients/producer.rb
+- lib/kafka/clients/producer_record.rb
+- lib/kafka/clients/record_metadata.rb
+- lib/kafka/clients/topic_partition.rb
 - lib/kafka/clients/version.rb
-homepage:
+homepage: http://github.com/burtcorp/kafka-clients-jruby
 licenses: []
 metadata: {}
 post_install_message: