webclient 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7eb2ccdb7293580bdd84f47296a6aeeea732c059
-  data.tar.gz: 3f1a98beed96051f2b5c2e9425be0606e4d5db27
+  metadata.gz: 341993a1bad956dda14de5a33dfa94355e7df6a3
+  data.tar.gz: 3063bac3858324ac7cbcd650e88cf332ce46f5e9
 SHA512:
-  metadata.gz: 5719ef6944bc547b68ad245bbe54e42b456d873f03bf036b25d03b1cb63d00153e063274229938d32be2bdbc549ebd8b26a5c29ef601fcecde2efaf767cd6358
-  data.tar.gz: a3c8bb313bb5d2fc56e99e6e8c7a039872ac6e8fdc53464e9b155680773ad0a603095037242d82f6ca2bf302659f33b437a293d763e078ff2e86b17ff62b46e0
+  metadata.gz: 4819baa4904dba19cbdc898fb6244806db8fccaffcdc396027f7fe6e0be08b366b40e171f71b972e5c5ccd739e46461074acfc6b7d4edc9d6787d95dcb5244f3
+  data.tar.gz: 042b1cd3a09e94ca0c791dfe19d9ccecd48a440435a131fdbad4e779c1d68d1d450d82b2eaa7e744fb61b832ce7cf1ba65815901ffa25c6067b1f225b339a171

data/Manifest.txt

@@ -4,3 +4,4 @@ README.md
 Rakefile
 lib/webclient.rb
 lib/webclient/version.rb
+lib/webclient/webclient.rb

data/README.md

@@ -1,11 +1,13 @@
 # webclient
 
-webclient gem - yet (another) network client for world wide web (www) requests via HTTP
+webclient gem - yet (another) universal network client interface for world wide web (www) requests via HTTP
+
+
+* home  :: [github.com/rubycoco/webclient](https://github.com/rubycoco/webclient)
+* bugs  :: [github.com/rubycoco/webclient/issues](https://github.com/rubycoco/webclient/issues)
+* gem   :: [rubygems.org/gems/webclient](https://rubygems.org/gems/webclient)
+* rdoc  :: [rubydoc.info/gems/webclient](http://rubydoc.info/gems/webclient)
 
-* home  :: [github.com/rubylibs/fotos](https://github.com/rubylibs/fotos)
-* bugs  :: [github.com/rubylibs/fotos/issues](https://github.com/rubylibs/fotos/issues)
-* gem   :: [rubygems.org/gems/fotos](https://rubygems.org/gems/fotos)
-* rdoc  :: [rubydoc.info/gems/fotos](http://rubydoc.info/gems/fotos)
 
 
 ## Usage

data/Rakefile

@@ -5,10 +5,10 @@ Hoe.spec 'webclient' do
 
   self.version = Webclient::VERSION
 
-  self.summary = 'webclient gem - yet (another) network client for world wide web (www) requests '
+  self.summary = 'webclient gem - yet (another) universal network client interface for world wide web (www) requests via HTTP'
   self.description = summary
 
-  self.urls    = { home: 'https://github.com/rubylibs/fotos' }
+  self.urls    = { home: 'https://github.com/rubycoco/webclient' }
 
   self.author  = 'Gerald Bauer'
   self.email   = 'ruby-talk@ruby-lang.org'
@@ -22,7 +22,7 @@ Hoe.spec 'webclient' do
   self.licenses = ['Public Domain']
 
   self.spec_extras = {
-   required_ruby_version: '>= 1.9.2'
+   required_ruby_version: '>= 2.2.2'
   }
 
 end

data/lib/webclient.rb

@@ -1,6 +1,24 @@
+require 'pp'
+require 'time'
+require 'date'
+require 'fileutils'
+
+require 'uri'
+require 'net/http'
+require 'net/https'
+
+require 'json'
+require 'yaml'
+
 
 # our own code
 require 'webclient/version'   # note: let version always go first
+require 'webclient/webclient'
+
+
+############
+## add convenience alias for camel case / alternate different spelling
+WebClient = Webclient
 
 
 # say hello

data/lib/webclient/version.rb

@@ -1,8 +1,8 @@
 
 class Webclient
   MAJOR = 0    ## todo: namespace inside version or something - why? why not??
-  MINOR = 0
-  PATCH = 1
+  MINOR = 1
+  PATCH = 0
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 
   def self.version

data/lib/webclient/webclient.rb

@@ -0,0 +1,85 @@
+
+class Webclient
+
+  class Response   # nested class - wrap Net::HTTP::Response
+    def initialize( response )
+      @response = response
+    end
+    def raw() @response; end
+
+
+    def text
+      # note: Net::HTTP will NOT set encoding UTF-8 etc.
+      # will be set to ASCII-8BIT == BINARY == Encoding Unknown; Raw Bytes Here
+      # thus, set/force encoding to utf-8
+      text = @response.body.to_s
+      text = text.force_encoding( Encoding::UTF_8 )
+      text
+    end
+
+    ## convenience helper; returns parsed json data
+    def json() JSON.parse( text ); end
+
+
+
+    class Headers # nested (nested) class
+      def initialize( response )
+        @response = response
+      end
+      def each( &blk )
+        @response.each_header do |key, value|  # Iterate all response headers
+          blk.call( key, value )
+        end
+      end
+    end
+    def headers() @headers ||= Headers.new( @response ); end
+
+    class Status  # nested (nested) class
+      def initialize( response )
+        @response = response
+      end
+      def code() @response.code.to_i; end
+      def ok?()  code == 200; end
+      def nok?() code != 200; end
+      def message() @response.message; end
+    end
+    def status() @status ||= Status.new( @response ); end
+  end # (nested) class Response
+
+
+def self.get( url, headers: {} )
+
+  uri = URI.parse( url )
+  http = Net::HTTP.new( uri.host, uri.port )
+
+  if uri.instance_of? URI::HTTPS
+    http.use_ssl     = true
+    http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+  end
+
+  request = Net::HTTP::Get.new( uri.request_uri )
+
+  ### add (custom) headers if any
+  ##  check/todo: is there are more idiomatic way for Net::HTTP ???
+  ##   use
+  ##     request = Net::HTTP::Get.new( uri.request_uri, headers )
+  ##    why? why not?
+  ##  instead of e.g.
+  ##   request['X-Auth-Token'] = 'xxxxxxx'
+  ##   request['User-Agent']   = 'ruby'
+  ##   request['Accept']       = '*/*'
+  if headers && headers.size > 0
+    headers.each do |key,value|
+      request[ key ] = value
+    end
+  end
+
+
+  response = http.request( request )
+
+  ## note: return "unified" wrapped response
+  Response.new( response )
+end  # method self.get
+
+end  # class Webclient
+

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: webclient
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Gerald Bauer
@@ -44,8 +44,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.22'
-description: 'webclient gem - yet (another) network client for world wide web (www)
-  requests '
+description: webclient gem - yet (another) universal network client interface for
+  world wide web (www) requests via HTTP
 email: ruby-talk@ruby-lang.org
 executables: []
 extensions: []
@@ -60,7 +60,8 @@ files:
 - Rakefile
 - lib/webclient.rb
 - lib/webclient/version.rb
-homepage: https://github.com/rubylibs/fotos
+- lib/webclient/webclient.rb
+homepage: https://github.com/rubycoco/webclient
 licenses:
 - Public Domain
 metadata: {}
@@ -74,7 +75,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 1.9.2
+      version: 2.2.2
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -85,5 +86,6 @@ rubyforge_project:
 rubygems_version: 2.5.2
 signing_key: 
 specification_version: 4
-summary: webclient gem - yet (another) network client for world wide web (www) requests
+summary: webclient gem - yet (another) universal network client interface for world
+  wide web (www) requests via HTTP
 test_files: []