faraday-em_synchrony 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: adf5bdc8c8903b85d533c3e0e124b5cf55dbce21a695f8cfb0cd859df2f8955e
-  data.tar.gz: 8e5375bea399c465a5f12f6e0d8b9c00c0dc7d3ca1a2641b1e889fe6e5c07e80
+  metadata.gz: ca71eb46cb78c20eb91bc712247221db397daacecdb6d850d2672a2d52ec7bca
+  data.tar.gz: 356896b2bb6f6b50e4d5fe14ec63df5cae67b76a2bb250735a077964a088f596
 SHA512:
-  metadata.gz: 2e4a52e45b43cffca1e0cea2f99546f5e58097be392028fc0c578a7dfa6c2c43ba1b23a87cda94ca87952a7722f1df005cc0080b2caa277e9b0ce2c67c186d02
-  data.tar.gz: f0b72ccf6a1b1e744c54f75e3ccee84d93488dc66023b71e89881b457b68dcb015d543ececba8c22356001000469aae5129c1f41f019aea6f3beee4bb1b043f3
+  metadata.gz: e0ce5f1f39f2222dd69b433ffb96fe565096790c046ba05a9e71c9997fc6f93bce7f419ee989c7ea3cb595bec717c7af8ed060ac7530de5e558091ed95e38783
+  data.tar.gz: baa08aaffda195b6bf3385a63ad4cfaa677f84a8ea17bb7abd0ed9867f77fd17efedf89ed742ab6663773b929b9d3a371d2e90c72fa475af7b3fea48f871fa8c

data/README.md

@@ -9,9 +9,6 @@ Every adapter is defined into its own gem. This gem defines the adapter for Em::
 Add these lines to your application's Gemfile:
 
 ```ruby
-gem 'em-http-request', '>= 1.1'
-gem 'em-synchrony', '>= 1.0.3'
-gem 'faraday-em_http', '~> 1.0'
 gem 'faraday-em_synchrony'
 ```
 
@@ -21,22 +18,55 @@ And then execute:
 
 Or install them yourself as:
 
-    $ gem install em-http-request -v '>= 1.1'
-    $ gem install em-synchrony -v '>= 1.0.3'
-    $ gem install faraday-em_http -v '~> 1.0'
     $ gem install faraday-em_synchrony
 
 ## Usage
 
-Configure your Faraday connection to use this adapter like this:
+This adapter can be used to make parallel requests using EventMachine.
 
+The key difference between this and [EM-Http](https://github.com/lostisland/faraday-em_http) is that it uses fibers.
+For more information see igrigorik's blog posts on the matter:
+
+- [fibers-cooperative-scheduling-in-ruby](https://www.igvita.com/2009/05/13/fibers-cooperative-scheduling-in-ruby/)
+- [untangling-evented-code-with-ruby-fibers](https://www.igvita.com/2010/03/22/untangling-evented-code-with-ruby-fibers)
+
+**Error handling and responses have a slightly different behaviour and structure in some cases. Please run thorough testing scenarios, including connection failures and SSL failures**
+
+### Base request
 ```ruby
-connection = Faraday.new(url, conn_options) do |conn|
-  conn.adapter(:em_synchrony)
+require 'faraday/em_synchrony'
+
+conn = Faraday.new(...) do |f|
+  # no custom options available
+  f.adapter :em_synchrony
 end
 ```
 
-For more information on how to setup your Faraday connection and adapters usage, please refer to the [Faraday Website][faraday-website].
+### Parallel Requests
+
+```ruby
+require 'faraday/em_synchrony'
+
+urls = Array.new(5) { 'http://127.0.0.1:3000' }
+
+conn = Faraday::Connection.new do |builder|
+  builder.adapter :em_synchrony
+end
+
+begin
+  conn.in_parallel do
+    puts "Parallel manager: #{conn.parallel_manager}"
+
+    @responses = urls.map do |url|
+      conn.get(url)
+    end
+  end
+end
+
+# Gather responses outside of block
+puts @responses.map(&:status).join(', ')
+puts @responses.map(&:status).compact.count
+```
 
 ## Development
 

data/lib/faraday/em_synchrony/version.rb

@@ -2,6 +2,6 @@
 
 module Faraday
   module EmSynchrony
-    VERSION = '1.0.0'
+    VERSION = '1.0.1'
   end
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: faraday-em_synchrony
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - "@iMacTia"
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-04-26 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: em-http-request
@@ -212,7 +211,6 @@ metadata:
   homepage_uri: https://github.com/lostisland/faraday-em_synchrony
   source_code_uri: https://github.com/lostisland/faraday-em_synchrony
   changelog_uri: https://github.com/lostisland/faraday-em_synchrony
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -227,8 +225,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
-signing_key: 
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Faraday adapter for EM::Synchrony
 test_files: []