web_api 0.3.191208 → 1.0.210927

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d807c131626709ce9df0f7e5fa92c96fd7a0df6868fc96a823be2ec823ef26aa
-  data.tar.gz: a9c6ecf0c3a73b2a4d4018eb7882054c6029c85cc3decf7bca28a452f38313ee
+  metadata.gz: 82115f267d8164697506e891e5dace6f796a69ab8923c1dd193dd5d38faeff3e
+  data.tar.gz: c60078933f51883cadefb158d221607e9e11bad9cd66fc47185f87d2df45adc4
 SHA512:
-  metadata.gz: ef7a923eee894aa4f3346ccbc5a1b89601e58a17aac35e11821ed604ebc0c1354286466a3b4dbee9e5de78642bf646dc2e5fbb7319f5a06bd04d8c8df2609454
-  data.tar.gz: cd959864b8da19658c3a54afb46b0bdd39bffb5a24658be664a51cfa2eb85cbe1a6da0d16085be7c6eaf354461f654de69b460a3dfa39ffce4383d6ab06f6bf4
+  metadata.gz: 32e2b5f9b5f467aee348c968a409bd7df263eeb73395929e8e3f43945bdf9ed2cf6f9d3b0c715dc6685239f56601d1ed99928a858d9d622aca285542a5539d16
+  data.tar.gz: ed2d94e383e02ae8c327157054b91d069131470e6b21ed107797879eaef05d6072d134eff70ea7999e7b6e989d430b082b28e936b1d0c1e9a020c03aee781e36

data/README.md

@@ -1,5 +1,6 @@
-# web_api
+# WebApi
 
+* [VERSION 1.0.210927](https://www.github.com/carlosjhr64/web_api)
 * [github](https://www.github.com/carlosjhr64/web_api)
 * [rubygems](https://rubygems.org/gems/web_api)
 
@@ -8,22 +9,23 @@
 Ruby library for web api's.
 
 ## SYNOPSIS:
-
-    require 'web_api'
-    webapi = WEB_API::WebApi.new "https://api.site.org/path-to-base/", header: {Authorization: "Bearer ABC123XYZ"}
-    # for a post to https://api.site.org/path-to-base/resource...
-    webapi.add(:resource, type: :post)
-    # You can pass the post's (or query's) key value pairs in a hash.
-    body = webapi.resource(data: {key: "value"})
-
+```ruby
+require 'web_api'
+webapi = WebApi.new "https://api.site.org/path-to-base/",
+                             header: {Authorization: "Bearer ABC123XYZ"}
+# for a post to https://api.site.org/path-to-base/resource...
+webapi.add(:resource, type: :post)
+# You can pass the post's (or query's) key value pairs in a hash.
+body = webapi.resource(data: {key: "value"})
+```
 ## INSTALL:
-
-    $ gem install web_api
-
+```console
+$ gem install web_api
+```
 ## MORE:
 
 There's not that much code here...
-under 200 lines in `lib/**.rb` at the time of this writting.
+under 200 lines in `lib/**.rb` at the time of this writing.
 Take a look at the examples given at [github](https://github.com/carlosjhr64/web_api/tree/master/examples)
 for use cases.
 
@@ -34,11 +36,17 @@ The model is that at each step...
 3. call to a WebApi method
 
 ...one builds up the url, type, data, and header of the http request.
-The WebApi methods `#new`, `#add`, and `#<method>` all have the same argument signature:
+The WebApi methods `#new`, `#add`, and `#<method>`
+all have the same argument signature:
 
-    extension String, type: Symbol, data: Hash, header: Hash, dumper: Proc, Parser: Proc|Hash(String, Proc)
+    extension String,
+    type:     Symbol,
+    data:     Hash,
+    header:   Hash,
+    dumper:   Proc,
+    Parser:   Proc|Hash(String, Proc)
 
-The extension builds up the url by concatanation.
+The extension builds up the url by concatenation.
 The data and headers hashes are built up with merge.
 The type, dumper, and parser can be changed at each step.
 
@@ -46,28 +54,32 @@ One can read the code to check the minor nuances of each method's signature,
 such as default values.
 
 Note that `#add` will assume extension is the same as the name of the method if
-no extenstion is given.
+no extension is given.
 
-Note that `#<method>` will assume the user meant to pass data if it only gets a hash, but
-the hash must then not have any `Symbol` for its keys:
+Note that `#<method>` will assume the user meant to pass data if
+it only gets a hash:
 
-    #<method>({"a"=>"ABC","x"=>"XYZ"}) #=> #<method>('', data: {"a"=>"ABC","x"=>"XYZ"})
+    #<method>({"a"=>"ABC","x"=>"XYZ"})
+    #=> #<method>('', data: {"a"=>"ABC","x"=>"XYZ"})
 
-The dumper to dump the data in a post request is JSON.dump by default if JSON is available.
+The dumper to dump the data in a post request is JSON.dump by default
+if JSON is available.
 
-The parser to parse the body of an "application/json" type content is JSON.parse by default if available.
-You can read the code and inspect `WEB_API::WebApi::PARSER` to see the other parsers available by default.
+The parser to parse the body of an "application/json" type content is
+JSON.parse by default if available.
+You can read the code and inspect `WebApi::PARSER`
+to see the other parsers available by default.
 
-If one does not want to parse the reponse's body,
+If one does not want to parse the response's body,
 one can set `parser: :none`. For example:
-
-    body = webapi.resourse(data: {key: "value"}, parser: :none)
-
+```ruby
+body = webapi.resourse(data: {key: "value"}, parser: :none)
+```
 ## LICENSE:
 
 (The MIT License)
 
-Copyright (c) 2019 CarlosJHR64
+Copyright (c) 2021 CarlosJHR64
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/lib/web_api/web_api.rb

@@ -1,58 +1,58 @@
-module WEB_API
-  class WebApi
-    DUMPER = (defined? JSON)? JSON.method(:dump)  : :none
+class WebApi
+  DUMPER = (defined? JSON)? JSON.method(:dump) : :none
 
-    PARSER = Hash.new :none
-    PARSER['application/json'] = JSON.method(:parse)           if defined? JSON
-    PARSER['text/csv']         = CSV.method(:parse)            if defined? CSV
-    PARSER['text/html']        = Nokogiri::HTML.method(:parse) if defined? Nokogiri
+  PARSER = Hash.new :none
+  PARSER['application/json'] = JSON.method(:parse)    if defined? JSON
+  PARSER['text/csv']  = CSV.method(:parse)            if defined? CSV
+  PARSER['text/html'] = Nokogiri::HTML.method(:parse) if defined? Nokogiri
 
-    def initialize(base =  '',
-                   type:   :get,
-                   data:   {},
-                   header: {},
-                   dumper: DUMPER,
-                   parser: PARSER,
-                   &block)
-      @base, @type, @data, @header, @dumper, @parser, @block =
-       base,  type,  data,  header,  dumper,  parser,  block
-      @strict = false
-      @webmethods = {}
-    end
+  def initialize(base =  '',
+                 type:   :get,
+                 data:   {},
+                 header: {},
+                 dumper: DUMPER,
+                 parser: PARSER,
+                 &block)
+    @base, @type, @data, @header, @dumper, @parser, @block =
+     base,  type,  data,  header,  dumper,  parser,  block
+    @strict = false
+    @webmethods = {}
+  end
 
-    def strict!(t = true)
-      @strict = t
-    end
+  def strict!(t = true)
+    @strict = t
+  end
 
-    def add(method, target =  method.to_s,
-                    type:   @type,
-                    data:   {},
-                    header: {},
-                    dumper: @dumper,
-                    parser: @parser,
-                    &block)
-      @webmethods[method] = WebApiMethod.new(@base+target,
-                                             type,
-                                             @data.merge(data),
-                                             @header.merge(header),
-                                             dumper,
-                                             parser,
-                                             &(block || @block))
-    end
+  def add(method, target =  method.to_s,
+                  type:   @type,
+                  data:   {},
+                  header: {},
+                  dumper: @dumper,
+                  parser: @parser,
+                  &block)
+    @webmethods[method] = WebApiMethod.new(@base+target,
+                                           type,
+                                           @data.merge(data),
+                                           @header.merge(header),
+                                           dumper,
+                                           parser,
+                                           &(block || @block))
+  end
 
-    def method_missing(symbol , extension =  '',
-                                type:   nil,
-                                data:   {},
-                                header: {},
-                                dumper: nil,
-                                parser: nil,
-                                &block)
-      unless @webmethods.has_key? symbol
-        super if @strict
-        add symbol
-      end
-      extension, data = '', extension unless extension.is_a? String # user passed data as first argument
-      @webmethods[symbol].run(extension, type, data, header, dumper, parser, &block)
+  def method_missing(symbol , extension =  '',
+                              type:   nil,
+                              data:   {},
+                              header: {},
+                              dumper: nil,
+                              parser: nil,
+                              &block)
+    unless @webmethods.has_key? symbol
+      super if @strict
+      add symbol
     end
+    # user passed data as first argument?
+    extension, data = '', extension unless extension.is_a? String
+    @webmethods[symbol].run(extension, type, data, header, dumper, parser,
+                            &block)
   end
 end

data/lib/web_api/web_api_method.rb

@@ -1,99 +1,96 @@
-module WEB_API
-  class WebApiMethod
-    class ResponseError < ::RuntimeError
-    end
-    class UnsupportedMethodError < ::RuntimeError
-    end
+class WebApiMethod
+  class ResponseError < ::RuntimeError
+  end
+  class UnsupportedMethodError < ::RuntimeError
+  end
 
-    OK = 200..299
+  OK = 200..299
 
-    # Escapes value's string representation for query string use.
-    def escape(value)
-      #http://rosettacode.org/wiki/URL_encoding#Ruby
-      CGI.escape(value.to_s).gsub("+", "%20")
-    end
+  # Escapes value's string representation for query string use.
+  def escape(value)
+    #http://rosettacode.org/wiki/URL_encoding#Ruby
+    CGI.escape(value.to_s).gsub("+", "%20")
+  end
 
-    def query_string(ah)
-      case ah
-      when Array
-        ah.select{|h| !h.empty?}.map{|h| query_string(h)}.join('&')
-      when Hash
-        ah.map do |k,v|
-          "#{k}=#{escape v}"
-        end
-        .join('&')
-      else
-        ah.to_s
-      end
+  def query_string(ah)
+    case ah
+    when Array
+      ah.select{!_1.empty?}.map{query_string _1}.join('&')
+    when Hash
+      ah.map{"#{_1}=#{escape _2}"}.join('&')
+    else
+      ah.to_s
     end
+  end
 
-    def initialize(target, type, data, header, dumper, parser, &block)
-      @target, @type, @data, @header, @dumper, @parser, @block =
-       target,  type,  data,  header,  dumper,  parser,  block
-    end
+  def initialize(target, type, data, header, dumper, parser, &block)
+    @target, @type, @data, @header, @dumper, @parser, @block =
+     target,  type,  data,  header,  dumper,  parser,  block
+  end
 
-    def uri_parse(request)
-      uri = URI.parse(request.url)
-      request_uri = uri.request_uri
-      payload = ''
-      unless request.data.empty?
-        if request.type == :post
-          if dumper=request.dumper and (dumper!=:none)
-            payload = dumper.call(request.data)
-          else
-            payload = query_string(request.data)
-          end
+  def uri_parse(request)
+    uri = URI.parse(request.url)
+    request_uri = uri.request_uri
+    payload = ''
+    unless request.data.empty?
+      if request.type == :post
+        if dumper=request.dumper and (dumper!=:none)
+          payload = dumper.call(request.data)
         else
           payload = query_string(request.data)
-          request_uri += (uri.query ? '&' : '?') + payload
         end
+      else
+        payload = query_string(request.data)
+        request_uri += (uri.query ? '&' : '?') + payload
       end
-      request.scheme, request.host, request.port, request.uri, request.payload =
-          uri.scheme,     uri.host,     uri.port, request_uri,         payload
     end
+    request.scheme, request.host, request.port, request.uri, request.payload =
+        uri.scheme,     uri.host,     uri.port, request_uri,         payload
+  end
 
-    def run(extension, type, data, header, dumper, parser, &block)
-      request        = CRStruct::Open.new
-      request.url    = @target+extension
-      request.type   = type || @type
-      request.data   = @data.merge(data)
-      request.header = @header.merge(header)
-      request.dumper = dumper || @dumper
+  def run(extension, type, data, header, dumper, parser, &block)
+    request        = CRStruct::Open.new
+    request.url    = @target+extension
+    request.type   = type || @type
+    request.data   = @data.merge(data)
+    request.header = @header.merge(header)
+    request.dumper = dumper || @dumper
 
-      parser = parser || @parser
-      block  = block  || @block
+    parser = parser || @parser
+    block  = block  || @block
 
-      uri_parse(request)
-      block.call(request) if block
+    uri_parse(request)
+    block.call(request) if block
 
-      body, content = http_response_body(request)
-      parser = parser[content]  if parser.is_a? Hash
-      body = parser.call body if parser and parser!=:none
-      return body
-    end
+    body, content = http_response_body(request)
+    parser = parser[content]  if parser.is_a? Hash
+    body = parser.call body if parser and parser!=:none
+    return body
+  end
 
-    def http_response_body(request)
-      response = http_response(request)
-      raise ResponseError, response.message unless OK === response.code.to_i
-      return response.body, response['content-type'].sub(/;.*$/,'')
-    end
+  def http_response_body(request)
+    response = http_response(request)
+    raise ResponseError, response.message unless OK === response.code.to_i
+    return response.body, response['content-type'].sub(/;.*$/,'')
+  end
 
-    def http_response(request)
-      http = net_http(request)
-      case request.type
-      when :get, :delete, :head, :copy, :move, :options, :trace
-        http.method(request.type).call request.uri, request.header
-      when :post, :patch, :lock, :unlock, :mkcol, :propfind, :proppatch
-        http.method(request.type).call request.uri, request.payload, request.header
-      else
-        raise UnsupportedMethodError, "Method type #{type}(#{type.class}) not supported by WEB_API::WebApi."
-      end
+  def http_response(request)
+    http = net_http(request)
+    case request.type
+    when :get, :delete, :head, :copy, :move, :options, :trace
+      http.method(request.type).call request.uri, request.header
+    when :post, :patch, :lock, :unlock, :mkcol, :propfind, :proppatch
+      http.method(request.type)
+        .call request.uri, request.payload, request.header
+    else
+      raise UnsupportedMethodError,
+        "Method type #{type}(#{type.class}) not supported by WebApi."
     end
+  end
 
-    def net_http(request)
-      http = Net::HTTP.new(request.host, request.port)
-      http.use_ssl = request.scheme=='https'
-      return http
-    end
+  def net_http(request)
+    http = Net::HTTP.new(request.host, request.port)
+    http.use_ssl = request.scheme=='https'
+    return http
   end
 end

data/lib/web_api.rb

@@ -6,11 +6,10 @@ require 'cgi'
 require 'crstruct'
 
 # This Gem
-module WEB_API
-  VERSION = '0.3.191208'
-  require 'web_api/web_api_method.rb'
-  require 'web_api/web_api.rb'
+class WebApi
+  VERSION = '1.0.210927'
+  require_relative 'web_api/web_api_method.rb'
+  require_relative 'web_api/web_api.rb'
 end
-
 # Requires:
 #`ruby`

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: web_api
 version: !ruby/object:Gem::Version
-  version: 0.3.191208
+  version: 1.0.210927
 platform: ruby
 authors:
-- carlosjhr64
-autorequire: 
+- CarlosJHR64
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-12-08 00:00:00.000000000 Z
+date: 2021-09-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: crstruct
@@ -16,14 +16,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.191207
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.210920
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.191207
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.210920
 description: 'Ruby library for web api''s.
 
   '
@@ -40,7 +46,7 @@ homepage: https://github.com/carlosjhr64/web_api
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -55,9 +61,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements:
-- 'ruby: ruby 2.6.5p114 (2019-10-01 revision 67812) [x86_64-linux]'
-rubygems_version: 3.0.3
-signing_key: 
+- 'ruby: ruby 3.0.2p107 (2021-07-07 revision 0db68f0233) [x86_64-linux]'
+rubygems_version: 3.2.22
+signing_key:
 specification_version: 4
 summary: Ruby library for web api's.
 test_files: []