requesta 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f0c9d7570286a8a83ceead2c3e695df709ab07ba2a5a556e2b4f7db39dd33b70
-  data.tar.gz: 292a460bdd843b5fb7ca359522f42648e4ff45544edd263b4382ecd70e58ad1d
+  metadata.gz: 3f2550db52fc7f9f91a9366b97fcba644a414b3c7e9da49b1d184defd8272fb1
+  data.tar.gz: 1149cea39c0f91f48b67fa07f93c61f88476e293e8039b1d30c85a5fc169d1c9
 SHA512:
-  metadata.gz: ff4230435224a615890a5e5df6437f3f54add10cf1d18bc6a52a9f56b6334a16d62acb3f171ade45d2ab52e33142f6b0d185e884dc64da2f9cc87ddb14c7f3a6
-  data.tar.gz: 7f19047fe872aba2b53c748558892d62f094ffc41c540b9c4bd6786ca056ac1456c73af35b7011a609f8471a720215c6d091ad291726f736ffea9eef86c76062
+  metadata.gz: d62c2927061ce2346336990cf9e93edf88120e838b5b17344cbdf33e3c09c2db84fcdff534f95fdf20c480ec47831f0a2315c4470e3a808b81e051f29cf68ce1
+  data.tar.gz: ebebc97029f6f2b2633f2f114f9426f83a1abd73ada8ab5d8fdf55526ea3c76f1390b14c73237a8fdf15bae76c42bd98b72cbecdd201760b6eae4002b27c5bba

data/lib/requesta.rb

@@ -1,10 +1,14 @@
-require 'net/http'
-require 'net/https'
+# FILE: lib/requesta.rb
 
+# Reference:
 # https://guides.rubyonrails.org/active_support_core_extensions.html
-require 'active_support/all'
 
-require_relative 'requesta/custom_error'
+require 'net/http'
+require 'net/https'
+require 'active_support'
+require 'active_support/core_ext/object/blank'
+
+require_relative 'requesta/errors'
 
 class Requesta
 
@@ -20,7 +24,9 @@ class Requesta
   end
 
   def request(uri)
-    raise CustomError, "request(): URI was nil" if uri.nil?
+    unless uri.is_a?(URI)
+      raise RequestaError::RequestError, "request(): 'uri' parameter must be of type 'URI'"
+    end
 
     puts "Requesting '#{uri.to_s}'" if @verbose
 
@@ -46,56 +52,63 @@ class Requesta
     end
 
     http.request(request)
-  rescue CustomError => error
-    error.report
-    nil
-  end
-
-  # URI/HREF
-  #----------
-
-  def uri_scheme_https?(uri)
-    uri.scheme == 'https'
-  end
-
-  def href_scheme_https?(href)
-    uri = URI(href)
-    uri_scheme_https?(uri)
   end
 
   # Request Headers
   #-----------------
 
-  def set_headers(headers={})
-    raise CustomError, "set_headers(): headers was blank" if headers.blank?
+  def set_headers(headers)
+    unless headers.is_a?(Hash)
+      raise RequestaError::RequestHeaderError, "set_headers(): 'headers' parameter must be of type 'Hash'"
+    end
+
     headers.each{ |key,value| set_header(key, value) }
-  rescue CustomError => error
-    error.report
-    nil
   end
 
-  def set_header(key=nil, value=nil)
-    raise CustomError, "set_header(): key was nil" if key.nil?
-    raise CustomError, "set_header(): value was nil" if value.nil?
+  def set_header(key, value)
+    unless key.is_a?(String) || key.is_a?(Symbol)
+      raise RequestaError::RequestHeaderError, "set_header(): 'key' parameter must be of type Symbol or String"
+    end
+
+    unless value.is_a?(String) || value.is_a?(Symbol)
+      raise RequestaError::RequestHeaderError, "set_header(): 'value' parameter must be of type Symbol or String"
+    end
+
     @headers[key] = value
-  rescue CustomError => error
-    error.report
-    nil
   end
 
   def clear_headers
     @headers = {}
-  rescue CustomError => error
-    error.report
-    nil
   end
 
-  def clear_header(key=nil)
-    raise CustomError, "clear_header(): key was nil" if key.nil?
+  def clear_header(key)
+    unless key.is_a?(String) || key.is_a?(Symbol)
+      raise RequestaError::RequestHeaderError, "clear_header(): 'key' must be of type Symbol or String"
+    end
+
     @headers.delete(key)
-  rescue CustomError => error
-    error.report
-    nil
+  end
+
+private
+
+  # URI/HREF
+  #----------
+
+  def uri_scheme_https?(uri)
+    unless uri.is_a?(URI)
+      raise RequestaError::MethodError, "href_scheme_https?(): 'href' parameter must be of type 'URI'"
+    end
+
+    uri.scheme == 'https'
+  end
+
+  def href_scheme_https?(href)
+    unless href.is_a?(String)
+      raise RequestaError::MethodError, "href_scheme_https?(): 'href' parameter must be of type 'String'"
+    end
+
+    uri = URI(href)
+    uri_scheme_https?(uri)
   end
 
 end

data/lib/requesta/errors.rb

@@ -0,0 +1,33 @@
+# FILE: lib/requesta/errors.rb
+
+# Reference:
+# http://blog.honeybadger.io/ruby-custom-exceptions/
+
+module RequestaError
+
+  class CustomError < StandardError
+
+    attr_reader :foo
+
+    def initialize(message="Default error message", foo='bar')
+      @foo = foo
+      super(message)
+    end
+
+    def report
+      "\n\n" + 
+      self.class.to_s + 
+      ":\s" + 
+      self.message + 
+      "\n\n" + 
+      self.backtrace.join("\n") + 
+      "\n\n"
+    end
+
+  end
+
+  class MethodError < CustomError; end;
+  class RequestError < CustomError; end;
+  class RequestHeaderError < CustomError; end;
+
+end

data/requesta.gemspec

@@ -1,21 +1,29 @@
+# FILE: requesta.gemspec
+
+# Reference:
 # https://guides.rubygems.org/specification-reference/
+# https://rubygems.org/gems/rspec/versions/3.8.0
+# https://rubygems.org/gems/activesupport
+# https://rubygems.org/gems/awesome_print
 
 Gem::Specification.new do |s|
 
   s.name        = 'requesta'
-  s.version     = '0.1.3'
-  s.summary     = "Wrapper for simple http(s) requests."
-  s.description = "Wrapper for simple http(s) requests."
+  s.version     = '0.1.4'
+  s.summary     = "A wrapper for simple http requests, in Ruby."
+  s.description = "A wrapper for simple http requests, in Ruby."
   s.authors     = ["Edrick Clark"]
   s.email       = 'edrickclark@gmail.com'
   s.homepage    = 'https://github.com/edrickclark/requesta'
   
-  s.files       = Dir['lib/**/*', 'requesta.gemspec']
+  s.files       = Dir['requesta.gemspec', 'lib/**/*']
   
   s.metadata    = {
-                    "source_code_uri" => "https://github.com/edrickclark/requesta"
+                    'source_code_uri' => "https://github.com/edrickclark/requesta"
                   }
 
+  s.required_ruby_version = '>= 2.2.2'
+
   s.add_runtime_dependency 'activesupport', '~> 5.2'
   s.add_development_dependency 'awesome_print', '~> 1.8'
   s.add_development_dependency 'rspec', '~> 3.7'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: requesta
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Edrick Clark
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-09-18 00:00:00.000000000 Z
+date: 2018-09-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -52,14 +52,14 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.7'
-description: Wrapper for simple http(s) requests.
+description: A wrapper for simple http requests, in Ruby.
 email: edrickclark@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - lib/requesta.rb
-- lib/requesta/custom_error.rb
+- lib/requesta/errors.rb
 - requesta.gemspec
 homepage: https://github.com/edrickclark/requesta
 licenses: []
@@ -73,7 +73,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.2.2
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -84,5 +84,5 @@ rubyforge_project:
 rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
-summary: Wrapper for simple http(s) requests.
+summary: A wrapper for simple http requests, in Ruby.
 test_files: []

data/lib/requesta/custom_error.rb

@@ -1,22 +0,0 @@
-# http://blog.honeybadger.io/ruby-custom-exceptions/
-
-class CustomError < StandardError
-
-  attr_reader :foo
-
-  def initialize(message="Default error message", foo='bar')
-    @foo = foo
-    super(message)
-  end
-
-  def report
-    "\n\n" + 
-    self.class.to_s + 
-    ":\s" + 
-    self.message + 
-    "\n\n" + 
-    self.backtrace.join("\n") + 
-    "\n\n"
-  end
-
-end