tdlib-ruby 0.9.4 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 81084785487847d98d74b1a27857235c9094031a
-  data.tar.gz: 665dc58fe58969ddc4f1cd1ccb23f4d03c543192
+SHA256:
+  metadata.gz: 4843f71309fcaf5799ce384c56d1df0a7d7d36131a5e162e3f3fd6d14dda68f7
+  data.tar.gz: eca6f03dd7e531f6a80595c562954427b71528c84d321a77e8babac791af9692
 SHA512:
-  metadata.gz: dcf903551729e52eba8c6772b8bde87e9ffb350026ca9200c3fb67196f1a41a462ea6d15bf95e2d6b525d57c76e6cb481ef61669c240a6782bc9d792dcaf5bf3
-  data.tar.gz: 8b704d60ef867628888dfaa87c3197cb81a4aad17155367df9545bac180ca724be821101ddd6b2534bc0dfc847cd0032e44a0f7b577c252fab500b642a2155b4
+  metadata.gz: 3618eb07efe5081c116efb1ee9cc0cf39ccff51bd1fd1933e3c0e1690b27e1be12087faf91096e1636fc00a55f3edb9797b8c616e38418187fd2a3b2b3bdb157
+  data.tar.gz: a87798327ce6f1995fbce7f2c5a216ed7c4baa01b65bb81cc109fbca7c757f8e20dce56b2e373a703e83e7ddaaf4af6e69cbc697e8fd845ef2d8b7c4c86c7ad3

data/ChangeLog.md

@@ -1,3 +1,8 @@
+### 1.0.0 / 2018-05-27
+
+* Return promises from TD::Client#broadcast
+* Add #fetch as alias to #broadcast_and_receive
+
 ### 0.9.4 / 2018-05-16
 
 * Fix recursive locking in nested handlers

data/README.md

@@ -100,6 +100,14 @@ end
 p @me
 ```
 
+## TD::Client#broadcast
+
+From version 1.0 TD::Client##broadcast returns [Concurrent::Promise](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Promise.html) object.
+
+```ruby
+  me = client.broadcast('@type' => 'getMe').then { |result| puts result }.rescue { |error| puts error }.value
+```
+
 ## Configuration
 
 ```ruby

data/lib/tdlib/client.rb

@@ -58,6 +58,8 @@
 #
 #   p @me
 class TD::Client
+  include Concurrent
+
   TIMEOUT = 20
 
   def initialize(td_client = TD::Api.client_create,
@@ -74,49 +76,47 @@ class TD::Client
     @update_manager.run
   end
 
-  # Sends asynchronous request to the TDLib client
+  # Sends asynchronous request to the TDLib client and returns Promise object
+  # @see https://www.rubydoc.info/github/ruby-concurrency/concurrent-ruby/Concurrent/Promise)
+  # @example
+  #   client.broadcast(some_query).then { |result| puts result }.rescue
   # @param [Hash] query
-  # @yield [update] yields update to the block as soon as it's received
-  def broadcast(query)
-    if block_given?
+  # @param [Numeric] timeout
+  # @return [Concurrent::Promise]
+  def broadcast(query, timeout: TIMEOUT)
+    Promise.execute do
+      condition = ConditionVariable.new
       extra = TD::Utils.generate_extra(query)
+      result = nil
+      mutex = Mutex.new
       handler = ->(update) do
         return unless update['@extra'] == extra
-        yield update
-        @update_manager.remove_handler(handler)
+        mutex.synchronize do
+          result = update
+          @update_manager.remove_handler(handler)
+          condition.signal
+        end
       end
       @update_manager.add_handler(handler)
       query['@extra'] = extra
+      mutex.synchronize do
+        TD::Api.client_send(@td_client, query)
+        condition.wait(mutex, timeout)
+        raise TD::TimeoutError if result.nil?
+        result
+      end
     end
-    TD::Api.client_send(@td_client, query)
   end
 
   # Sends asynchronous request to the TDLib client and returns received update synchronously
   # @param [Hash] query
   # @return [Hash]
-  def broadcast_and_receive(query, timeout: TIMEOUT)
-    condition = ConditionVariable.new
-    extra = TD::Utils.generate_extra(query)
-    result = nil
-    mutex = Mutex.new
-    handler = ->(update) do
-      return unless update['@extra'] == extra
-      mutex.synchronize do
-        result = update
-        @update_manager.remove_handler(handler)
-        condition.signal
-      end
-    end
-    @update_manager.add_handler(handler)
-    query['@extra'] = extra
-    mutex.synchronize do
-      TD::Api.client_send(@td_client, query)
-      condition.wait(mutex, timeout)
-      raise TD::TimeoutError if result.nil?
-      result
-    end
+  def fetch(query, timeout: TIMEOUT)
+    broadcast(query, timeout: timeout).value
   end
 
+  alias broadcast_and_receive fetch
+
   # Synchronously executes TDLib request
   # Only a few requests can be executed synchronously
   # @param [Hash] query

data/lib/tdlib/version.rb

@@ -1,4 +1,4 @@
 module TD
   # tdlib-ruby version
-  VERSION = "0.9.4"
+  VERSION = "1.0.0"
 end

data/spec/integration/tdlib_spec.rb

@@ -35,16 +35,9 @@ describe TD::Client do
       subject { client.on_ready { client.broadcast(payload) } }
 
       it { expect { subject }.not_to raise_error(Exception) }
-    end
-
-    context 'when block given' do
-      subject { client.on_ready { client.broadcast(payload) { |update| @result = update } } }
-
-      it 'runs block on update' do
-        subject
-        sleep 1
-        expect(@result).to include('@type', 'entities')
-      end
+      it { is_expected.to satisfy { |result| result.state == :pending } }
+      it { is_expected.to satisfy { |result| sleep 1; result.state == :fulfilled } }
+      it { is_expected.to satisfy { |result| sleep 1; result.value['@type'] == 'textEntities' } }
     end
   end
 

data/tdlib-ruby.gemspec

@@ -30,6 +30,7 @@ Gem::Specification.new do |gem|
   gem.require_paths = ['lib']
 
   gem.add_runtime_dependency 'dry-configurable', '~> 0.7'
+  gem.add_runtime_dependency 'concurrent-ruby', '~> 1.0'
 
   gem.add_development_dependency 'bundler', '~> 1.10'
   gem.add_development_dependency 'rake', '12.3.1'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tdlib-ruby
 version: !ruby/object:Gem::Version
-  version: 0.9.4
+  version: 1.0.0
 platform: ruby
 authors:
 - Southbridge
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-05-16 00:00:00.000000000 Z
+date: 2018-05-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-configurable
@@ -24,6 +24,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -157,7 +171,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.14
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: Ruby bindings and client for TDlib