request_via 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 96966b105f6993992128f43dc645693bbeb67c38
-  data.tar.gz: 52d09d862ab40f0c45e1cdb9977cad25befdc7cf
+  metadata.gz: 2d09f830e111ee1a4cc0a3a20d9f4a4c9336b41f
+  data.tar.gz: e5e3ccad0cb0879d0e0477982fd7256a6fc7903b
 SHA512:
-  metadata.gz: 85d778b4792ac8e2a2cf74ba798ed888d76e34261f18040763635b868f7963a73e5f67a0499f91d3157a6aa7b51aa586bd4d05c6b4ed1548967c1e52a751a47a
-  data.tar.gz: 5febbd08d8711a931e4b07f4510e4e9339e33313b154bacf205a37952b3d6d13fd4edcb86bade9af71ba152dc1a12d5fc27e3e74d1323b66b93cb525c6cf474f
+  metadata.gz: 9cb4e2a6bdb5bcd1a3e15ec93076e7cf93bf42b52dc85a3aff6c6465f5928fdaeefc3acc55ddd86c01f6ac89c0b23faa80f9b8021b80d577d7d0d889144d5ae2
+  data.tar.gz: cf8d9947ea0982db0cb01560b21610ed01101cbf63872d90834393e0fb95f4a130488fd03b26a48c30513324b0c0f24730d11d81e9d95a6282aea6098a966d2b

data/README.md

@@ -1,6 +1,32 @@
 # RequestVia
 
-A fast and functional (API and paradigm) HTTP client, using only standard library's dependencies. e.g: Net::HTTP, and URI.
+A fast and functional (API and paradigm) HTTP client, using only Ruby's standard library as dependency. e.g: Net::HTTP and URI.
+
+![gif](http://g.recordit.co/S6EPTX5hHH.gif)
+
+List of all commands shown in the GIF:
+```ruby
+require 'request_via'
+
+# Thanks to @ElliottLandsborough Dog CEO API (https://github.com/ElliottLandsborough/dog-ceo-api)
+
+# --- Single request
+
+response = RequestVia::Get.('https://dog.ceo/api/breed/boxer/images/random');
+response.body
+
+# --- Make requests over a map iteration
+
+dogs = [ 'akita', 'chihuahua', 'beagle' ]
+dogs_images = dogs.map { |breed_name| "https://dog.ceo/api/breed/#{breed_name}/images/random" }
+dogs_images.map(&RequestVia::Get).map(&:body)
+
+# --- Make requests over an ASYNC map iteration
+
+require 'parallel' # https://rubygems.org/gems/parallel
+
+Parallel.map(dogs_images, &RequestVia::Get).map(&:body)
+```
 
 ## Installation
 
@@ -22,36 +48,44 @@ Or install it yourself as:
 
 Making a GET request with http
 ```ruby
-  # Use http:// as the protocol when there is no one defined.
-  RequestVia::Get.call('example.com')
+# Use http:// as the protocol when there is no one defined.
+RequestVia::Get.call('example.com')
 
-  RequestVia::Get.call('http://example.com')
+RequestVia::Get.call('http://example.com')
 
-  # We recommend use `.()` syntax to invoke/make the HTTP requests
-  # Read more about this syntax sugar: https://ruby-doc.org/core-2.2.2/Proc.html#method-i-call
-  RequestVia::Get.('example.com')
+# We recommend to use the `.()` syntax to invoke/make the HTTP requests.
+# Read more about this: https://ruby-doc.org/core-2.2.2/Proc.html#method-i-call
+RequestVia::Get.('example.com')
 
-  # Request with params
-  RequestVia::Get.('example.com', params: { foo: 'bar' })
+# Request with params
+RequestVia::Get.('example.com', params: { foo: 'bar' })
 
-  # Request with headers
-  RequestVia::Get.('example.com/foo', headers: {'X-Requested-With': 'RequestVia gem' })
+# Request with headers
+RequestVia::Get.('example.com/foo', headers: { 'X-Requested-With': 'RequestVia gem' })
 
-  # Return the response and request objects as result
-  response, request = RequestVia::Get.('example.com/foo', response_and_request: true)
+# Return the response and request objects as result
+response, request = RequestVia::Get.('example.com/foo', response_and_request: true)
 ```
 
-Making other HTTP method requests.
+Supported HTTP methods.
 (**NOTE:** you can use all arguments of previous examples)
 ```ruby
-  RequestVia::Post.('example.com')
-  RequestVia::Put.('example.com')
-  RequestVia::Delete.('example.com')
+RequestVia::Post.()
+
+RequestVia::Put.()
+
+RequestVia::Delete.()
+
+RequestVia::Options.()
+
+RequestVia::Trace.()
+
+RequestVia::Patch.()
 ```
 
 Making a HTTPS request.
 ```ruby
-  RequestVia::Get.('https://example.com')
+RequestVia::Get.('https://example.com')
 ```
 
 ## Development

data/lib/request_via/func.rb

@@ -50,11 +50,18 @@ module RequestVia
     }.freeze
 
     FetchWithBodyVia = -> http_method {
-      FetchWith.(URIWithoutParams, RequestWithBody.(http_method)).freeze
+      FetchWith.(URIWithoutParams, RequestWithBody.(http_method))
     }.freeze
 
     FetchWithQueryStringVia = -> http_method {
-      FetchWith.(URIWithParams, RequestWithoutBody.(http_method)).freeze
+      FetchWith.(URIWithParams, RequestWithoutBody.(http_method))
     }.freeze
+
+    FetchStrategyTo = -> http_method {
+      strategy_to = \
+        http_method::REQUEST_HAS_BODY ? FetchWithBodyVia : FetchWithQueryStringVia
+
+      strategy_to.(http_method)
+    }
   end
 end

data/lib/request_via/version.rb

@@ -3,7 +3,7 @@
 module RequestVia
   module SemVer
     MAJOR = 0
-    MINOR = 1
+    MINOR = 2
     PATCH = 0
   end
 

data/lib/request_via.rb

@@ -8,11 +8,19 @@ require "request_via/http_client"
 require "request_via/func"
 
 module RequestVia
-  Get = Func::FetchWithQueryStringVia.(Net::HTTP::Get)
+  Get = Func::FetchStrategyTo.(Net::HTTP::Get).freeze
 
-  Put = Func::FetchWithBodyVia.(Net::HTTP::Put)
+  Head = Func::FetchStrategyTo.(Net::HTTP::Head).freeze
 
-  Post = Func::FetchWithBodyVia.(Net::HTTP::Post)
+  Post = Func::FetchStrategyTo.(Net::HTTP::Post).freeze
 
-  Delete = Func::FetchWithQueryStringVia.(Net::HTTP::Delete)
+  Put = Func::FetchStrategyTo.(Net::HTTP::Put).freeze
+
+  Delete = Func::FetchStrategyTo.(Net::HTTP::Delete).freeze
+
+  Options = Func::FetchStrategyTo.(Net::HTTP::Options).freeze
+
+  Trace = Func::FetchStrategyTo.(Net::HTTP::Trace).freeze
+
+  Patch = Func::FetchStrategyTo.(Net::HTTP::Patch).freeze
 end

data/request_via.gemspec

@@ -9,8 +9,8 @@ Gem::Specification.new do |spec|
   spec.authors       = ["Rodrigo Serradura"]
   spec.email         = ["rodrigo@ysimplicity.com"]
 
-  spec.summary       = %q{The functional HTTP client.}
-  spec.description   = %q{A fast and functional (API and paradigm) HTTP client, using only standard library's dependencies. e.g: Net::HTTP, and URI.}
+  spec.summary       = %q{The Ruby's functional HTTP client (Net::HTTP wrapper)}
+  spec.description   = %q{A fast and functional (API and paradigm) HTTP client, using only Ruby's standard library as dependency. e.g: Net::HTTP and URI.}
   spec.homepage      = "https://github.com/serradura/request_via"
   spec.license       = "MIT"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: request_via
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Rodrigo Serradura
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-10-30 00:00:00.000000000 Z
+date: 2017-10-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -66,8 +66,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.1'
-description: 'A fast and functional (API and paradigm) HTTP client, using only standard
-  library''s dependencies. e.g: Net::HTTP, and URI.'
+description: 'A fast and functional (API and paradigm) HTTP client, using only Ruby''s
+  standard library as dependency. e.g: Net::HTTP and URI.'
 email:
 - rodrigo@ysimplicity.com
 executables: []
@@ -111,5 +111,5 @@ rubyforge_project:
 rubygems_version: 2.6.14
 signing_key: 
 specification_version: 4
-summary: The functional HTTP client.
+summary: The Ruby's functional HTTP client (Net::HTTP wrapper)
 test_files: []