request_via 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f958dbee6653251da7b8fb72818eea82aa23f72f
-  data.tar.gz: 5389f3b568ff5252afdafc8c23cde8ddf8005190
+  metadata.gz: 789cb78c79d76ab40e032e9c944a68d38c2f4043
+  data.tar.gz: fe00331075753cdec333d121fd5cc61a6d98609c
 SHA512:
-  metadata.gz: dd93888e3fbcfa00674033042de2ae7a9c2a6dff4531d4b7c92df651d08d9b3857de47a100e317bc9cebb2b164d938c7269037a29a8f5002c3dabd11b83dd61b
-  data.tar.gz: '039a3b536b0d5ef5ef4d905aa347ceee583e73ef4338b89fc35541ea6c63cab9bfe6bb808ce630ee78355cd572d4c220bf9795a7d798f60f771a2d96a610b096'
+  metadata.gz: 0bc000d11dfd22a76cbd847a5dfac461d8a7a8a5c8e1b9a40dde72648b14899528bd47f09033b0668ca89e450a0d15e0118a2e286bc9535e281d7928725965f9
+  data.tar.gz: 491167b516738b15260eb85814692b842dd3c388289243d838b52f0bf57668bc1649e42e7117b64d7c6585f02189d534080cabb0808a0627fd131bfb22e2f78b

data/README.md

@@ -92,6 +92,8 @@ RequestVia::Get.('example.io', port: 2000,
 Supported HTTP methods.
 (**NOTE:** you can use all arguments of previous examples)
 ```ruby
+RequestVia::Head.()    # RequestVia::HeadR.()
+
 RequestVia::Post.()    # RequestVia::PostR.()
 
 RequestVia::Put.()     # RequestVia::PutR.()
@@ -110,6 +112,33 @@ Making a HTTPS request.
 RequestVia::Get.('https://example.com')
 ```
 
+Create a HTTP(S) client for REST resources.
+```ruby
+client = RequestVia::Client.('https://example.com')
+
+client.get # same of client.get('/')
+
+# Supported arguments: params:, headers:
+client.get('foo', params: { a: 1 })
+
+client.post('/bar', headers: { 'User-Agent' => 'REST Example' })
+
+# Supported options
+RequestVia::Client.('example.com/foo/bar', port: 3000,
+                                           open_timeout: 10,
+                                           read_timeout: 100)
+
+# Supported HTTP methods:
+# client.get
+# client.head
+# client.post
+# client.put
+# client.delete
+# client.options
+# client.trace
+# client.patch
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/request_via.rb

@@ -5,7 +5,8 @@ require 'uri'
 
 require "request_via/func"
 require "request_via/version"
-require "request_via/http_client"
+require "request_via/net_http"
+require "request_via/client"
 
 module RequestVia
   Get     = Func::FetchStrategyTo.(Net::HTTP::Get)

data/lib/request_via/client.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+module RequestVia
+
+  class Client
+    attr_reader :address, :net_http
+
+    BuildURL = Freeze.(-> (address, path) {
+      "#{address}#{path.start_with?('/') ? path : "/#{path}"}"
+    }.curry)
+
+    BuildAddress = -> (uri, address) {
+      has_port = uri.port && address =~ /:\d+/
+      Freeze.(%{#{uri.scheme}://#{uri.host}#{":#{uri.port}" if has_port}}.chomp('/'))
+    }
+
+    OptionsBuilder = Freeze.(-> net_http {
+      -> (options) {
+        {
+          params: options[:params],
+          headers: options[:headers],
+          net_http: net_http
+        }
+      }
+    })
+
+    def self.call(address, port: nil, open_timeout: nil, read_timeout: nil)
+      self.new(address, port, open_timeout, read_timeout)
+    end
+
+    def initialize(address, port, open_timeout, read_timeout)
+      uri = Freeze.(Func::ParseURI.(address))
+
+      @address = BuildAddress.(uri, address)
+      @build_url = BuildURL.(@address)
+      @net_http = NetHTTP.(uri, port, open_timeout, read_timeout)
+      @options = OptionsBuilder.(@net_http)
+    end
+
+    def get(path = '/', **options)
+      fetch(RequestVia::Get, path, options)
+    end
+
+    def head(path = '/', **options)
+      fetch(RequestVia::Head, path, options)
+    end
+
+    def post(path = '/', **options)
+      fetch(RequestVia::Post, path, options)
+    end
+
+    def put(path = '/', **options)
+      fetch(RequestVia::Put, path, options)
+    end
+
+    def delete(path = '/', **options)
+      fetch(RequestVia::Delete, path, options)
+    end
+
+    def options(path = '/', **options)
+      fetch(RequestVia::Options, path, options)
+    end
+
+    def trace(path = '/', **options)
+      fetch(RequestVia::Trace, path, options)
+    end
+
+    def patch(path = '/', **options)
+      fetch(RequestVia::Patch, path, options)
+    end
+
+    private
+
+    def fetch(http_method, path, keyword_args)
+      http_method.(@build_url.(path), **@options.(keyword_args))
+    end
+  end
+
+end

data/lib/request_via/func.rb

@@ -1,6 +1,10 @@
 # frozen_string_literal: true
 
 module RequestVia
+  DEFAULT_HEADERS = {
+    'User-Agent' => "RequestVia v#{RequestVia::VERSION}"
+  }.freeze
+
   Freeze = -> object { object.freeze }.freeze
 
   module Func
@@ -25,8 +29,12 @@ module RequestVia
     })
 
     SetRequestHeaders = Freeze.(-> (request, headers) {
-      return request unless IsAHash.(headers)
-      headers.each { |key, value| request[key] = value }
+      request_headers = IsAHash.(headers) ? headers : {}
+
+      DEFAULT_HEADERS.merge(request_headers).each do |key, value|
+        request[key] = value
+      end
+
       return request
     })
 
@@ -62,7 +70,7 @@ module RequestVia
                response_and_request: false) do
         uri = uri_builder.(url, params)
         req = SetRequestHeaders.(request_builder.(uri, params), headers)
-        http = HTTPClient.(uri, port, open_timeout, read_timeout, net_http)
+        http = NetHTTP.(uri, port, open_timeout, read_timeout, net_http)
         response = http.request(req)
         response_and_request ? [response, req] : response
       end

data/lib/request_via/{http_client.rb → net_http.rb}

@@ -1,20 +1,26 @@
 # frozen_string_literal: true
 
 module RequestVia
-  module HTTPClient
+  module NetHTTP
     extend self
 
     Build = Freeze.(-> (host, port) {
       Net::HTTP.new(host, port)
     })
 
+    IsNetHTTP = Freeze.(-> object {
+      object.instance_of?(Net::HTTP)
+    })
+
     def call(uri, port = nil, open_timeout = nil, read_timeout = nil, net_http = nil)
+      return net_http if IsNetHTTP.(net_http)
+
       net_http = build!(uri, port, net_http)
 
       net_http.open_timeout = Integer(open_timeout) unless open_timeout.nil?
       net_http.read_timeout = Integer(read_timeout) unless read_timeout.nil?
 
-      return net_http unless uri.is_a?(URI::HTTPS)
+      return net_http unless uri.instance_of?(URI::HTTPS)
 
       set_https!(net_http)
     end
@@ -26,7 +32,7 @@ module RequestVia
 
       http = strategy.(uri.host, (port || uri.port))
 
-      return http if http.instance_of?(Net::HTTP)
+      return http if IsNetHTTP.(http)
 
       fail TypeError, 'net_http proc must return a Net:HTTP instance'
     end

data/lib/request_via/version.rb

@@ -3,7 +3,7 @@
 module RequestVia
   module SemVer
     MAJOR = 0
-    MINOR = 4
+    MINOR = 5
     PATCH = 0
   end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: request_via
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Rodrigo Serradura
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-10-31 00:00:00.000000000 Z
+date: 2017-11-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -84,8 +84,9 @@ files:
 - bin/console
 - bin/setup
 - lib/request_via.rb
+- lib/request_via/client.rb
 - lib/request_via/func.rb
-- lib/request_via/http_client.rb
+- lib/request_via/net_http.rb
 - lib/request_via/version.rb
 - request_via.gemspec
 homepage: https://github.com/serradura/request_via