http.rb 0.16.1 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 29514ef093a2f03e4936ba26f13673c8a6696058aaf555c5e0a5a0167f7c19cd
-  data.tar.gz: 21a5f38db7c4e93fb3cd57deba7bf17154737c341b7c25f32e206fc24e9fc37f
+  metadata.gz: c8f29700e5af2badc9a6207ce6c3cf5ce189c6e282da3955535139b2014c1092
+  data.tar.gz: 121be70186382dab28df52b69f7a2e5c9501bb5891946865621250e63e85f952
 SHA512:
-  metadata.gz: 23ceeaa56c2963b88119409fa4b29cd85048cba6523f77eb7bdf47762837a83b494a5c3d7f44e011ea66649028e37e19be5e10a9fa64a468f7d9f432087d6b4e
-  data.tar.gz: 320c109717cf4ffdbafdce41cdd83ea96ec3c0fb79bd4a300fa58c324679c4e4f83503ffa912e376f6c3655d1bdb0facaa58989984b1d6f0fd997c558ed1f342
+  metadata.gz: b2a0ed184928d0f3656d8d9d28bcb37098759f94cf37f708c931b020c920d2d2c8f50a5a7856dcb1827759c3d8a917e5824b7266217861f21daca202533003c3
+  data.tar.gz: 22525a1fa099e471895bfe8cc660c728c3fcc52067b24849079b1f0c3c0e9ed50e64359c92d46de2aed7557b72d4855b39b93ab652a3fd2da122c9e5c3704df7

data/{CHANGELOG.txt → CHANGELOG}

@@ -1,3 +1,48 @@
+# 20260507
+# 0.18.0: Add all missing HTTP verbs; use meta-programming to define verb methods.
+1. + HTTP/verbs.rb; including:
+     + HTTP::VERBS::WITHOUT_BODY: get, delete, head, options, trace
+     + HTTP::VERBS::WITH_BODY: post, put, patch, propfind, proppatch, mkcol, copy, move, lock, unlock, report
+2. + lib/Net/HTTP/Report.rb: Add Net::HTTP::Report, which is missing from Ruby's standard library. See RFC 3253.
+3. - lib/HTTP/delete.rb
+4. - lib/HTTP/get.rb
+5. - lib/HTTP/post.rb
+6. - lib/HTTP/put.rb
+7. + String/to_const.rb
+8. + Thoran/Array/AllButFirst/all_but_first.rb
+9. + Thoran/Array/FirstX/firstX.rb
+10. + Thoran/String/ToConst/to_const.rb
+11. + LICENSE
+12. + Rakefile
+13. + spec/HTTP/head_spec.rb
+14. + spec/HTTP/propfind_spec.rb
+15. + spec/Net/HTTP/Report_spec.rb
+16. ~ HTTP::VERSION: /0.17.0/0.18.0/
+17. /CHANGELOG.txt/CHANGELOG/
+18. /TODO.txt/TODO/
+19. ~ CHANGELOG: + 0.18.0 entry
+20. ~ http.rb.gemspec: /s/spec/; - date; + Rakefile; + development_dependencies
+21. ~ Gemfile: /group :test/gemspec/
+22. ~ .gitignore: Using a common one with lots of entries.
+23. ~ README.md: /http.rb/http/; Trimmed the Description; Usage has more code blocks, making the comments Markdown sub-sections.
+
+# 20260325
+# 0.17.0: Extract HTTP.request method; consolidate set_headers.
+1. + HTTP.request: Extract common plumbing (connection, SSL, auth, redirect, response) from verb methods.
+2. ~ HTTP.get: Delegate to HTTP.request.
+3. ~ HTTP.delete: Delegate to HTTP.request.
+4. ~ HTTP.post: Delegate to HTTP.request.
+5. ~ HTTP.put: Delegate to HTTP.request.
+6. + Net::HTTPRequest#set_headers: Consolidate per-verb set_headers into single method on superclass.
+7. - Net::HTTP::Get#set_headers
+8. - Net::HTTP::Post#set_headers
+9. - Net::HTTP::Put#set_headers
+10. - Net::HTTP::Delete#set_headers
+11. + TODO.txt
+12. ~ HTTP::VERSION: /0.16.1/0.17.0/
+13. ~ CHANGELOG.txt: + 0.17.0 entry
+14. ~ http.rb.gemspec: Change date.
+
 # 20250908
 # 0.16.1: Allow any case for the content-type key.
 1. ~ HTTP.post: Check for any case for content-type key.

data/Gemfile

@@ -1,7 +1,5 @@
+# Gemfile
+
 source 'https://rubygems.org'
 
-group :test do
-  gem 'pry', require: true
-  gem 'rspec', require: false
-  gem 'webmock', require: false
-end
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 thoran
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -1,89 +1,94 @@
-# http.rb
+# http
 
 ## Description
 
-This has been a personal library which was begun many years ago, around the middle of 2009 from what I can ascertain, though in various guises it may have been as early as late 2007.  Assuming it was the former, it was long enough ago that it actually, sadly (given the diminutive size of this perhaps), predates Faraday by about 6 months (late 2009), http.rb by well over 2 years (late 2011), although it also happens to postdate HTTParty by about a year (mid 2008).  
+For many years this was a personal library, from around the middle of 2009 from what I can ascertain, though in various guises it may have been as early as late 2007.
 
-Like many others before and after me with their respective libraries, I created it to simplify the heinous interface that is Net::HTTP.  At the time of it's original creation I was doing a lot of a webscraping and didn't want a half-dozen line setup to make simple requests.  It has stood the test of time, for me personally insofar as the interface remaining simpler than most other similar libraries, though it is also less full featured, but nevertheless for it's tiny size it packs in quite a bit.  
+Like many others before and after me with their respective libraries, I created it to simplify the heinous interface that is Net::HTTP. At the time of it's original creation I was doing a lot of a webscraping and didn't want a half-dozen line setup to make simple requests. It has stood the test of time, for me personally insofar as the interface remaining simpler than most other similar libraries, though it is also less full featured, but nevertheless for it's tiny size it packs in quite a bit.
 
-From inception to early 2013 this was used as a front-end for Mechanize for the purpose of being able to jump out of being a pure web client and to just 'go at' a resource I was after, but still return a Mechanize object so that I could then resume a web client session.  Eventually I decided to wrap Net::HTTP and then manually use Nokogiri instead, since I would either use Mechanize largely as is, or I simply wanted to make straight requests without caring about caching or cookies.  I may allow HTTP to again return Mechanize objects optionally at some point in future as that had it's benefits, but they weren't great enough for the complications it brought if I remember correctly.  
-
-Even so, through its various incarnations the goal has basically remained the same: to have a simple way of making HTTP requests in Ruby.  
-
-I'd never intended to publish this and had intended for it to remain a personal library, but decided to use it for a small project and so as it could be included with ease in a Gemfile it needed to be gemified and well here we are, rightly or wrongly.  
-
-Perhaps someone will appreciate its relative simplicity, since it is much smaller and the usage simpler than any of the other 'wrapper' libraries mentioned above at least, such that it can be read and comprehended in full in as little as a couple of minutes.  It does just enough to do most simple HTTP GET and POST requests as simply as should be.  
+Perhaps some will appreciate its relative simplicity, since it is much smaller and the usage simpler than any of the other 'wrapper' libraries, such that it can be read and comprehended in full in as little as a couple of minutes.  It does just enough to do most simple HTTP GET and POST requests as simply as should be.
 
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
-    gem 'http.rb'
-
+```ruby
+gem 'http.rb'
+```
 
 And then execute:
 
-    $ bundle
-
-
-Or install it yourself as:
+```shell
+$ bundle
+```
 
-    $ gem install http.rb
+Or install it directly:
 
+```shell
+$ gem install http.rb
+```
 
 ## Usage
 
-```Ruby
-# With just a URI
+### With just a URI
 
+```ruby
 HTTP.get('http://example.com')
-HTTP.post('http://example.com') # Admittedly doing a POST without providing form data probably doesn't make much sense.
+```
 
-# With arguments only
+### With arguments only
 
+```ruby
 HTTP.get('http://example.com', {a: 1, b: 2})
 HTTP.post('http://example.com', {a: 1, b: 2})
+```
+### With JSON data
 
-# With JSON data
-
+```ruby
 HTTP.post('http://example.com', {a: 1, b: 2}, {'Content-type' => 'application/json'})
+```
 
-# With custom headers only
+### With custom headers only
 
+```ruby
 HTTP.get('http://example.com', {}, {'User-Agent'=>'Custom'})
 HTTP.post('http://example.com', {}, {'User-Agent'=>'Custom'})
+```
 
-# With options only
+### With options only
 
+```ruby
 HTTP.get('http://example.com', {}, {}, {use_ssl: true})
 HTTP.post('http://example.com', {}, {}, {use_ssl: true})
+```
 
-# With a block
+### With a block
 
+```ruby
 HTTP.get('http://example.com') do |response|
   # Do stuff with a subclass of Net::HTTPResponse here...
 end
-HTTP.post('http://example.com') do |response|
-  # Do stuff with a subclass of Net::HTTPResponse here...
-end
+```
 
-# With the lot
+### With the lot
 
-HTTP.get('http://example.com', {a: 1, b: 2}, {'User-Agent'=>'Custom'}, {use_ssl: true}) do |response|
-  # Do stuff with a subclass of Net::HTTPResponse here...
-end
+```ruby
 HTTP.post('http://example.com', {a: 1, b: 2}, {'User-Agent'=>'Custom'}, {use_ssl: true}) do |response|
   # Do stuff with a subclass of Net::HTTPResponse here...
 end
+```
 
-# Preventing redirections
+### Preventing redirections
 
+```ruby
 HTTP.get('http://example.com', {}, {}, {no_redirect: true})
 # => #<Net::HTTPResponse @code=3xx>
+```
 
-# Response status predicate methods
+### Response status predicate methods
 
+```ruby
 # 1xx
 response = HTTP.get('http://example.com')
 response.informational?
@@ -126,23 +131,26 @@ response.server_error?
 # => true
 response.error?
 # => true
+```
 
-# Including it in a class
+### Including it in a class
 
+```ruby
 class A
   include HTTP
   def a
     get('http://example.com')
   end
 end
+```
 
-# Extending a class
+### Extending a class
 
+```ruby
 class A
   extend HTTP
   get('http://example.com')
 end
-
 ```
 
 ## Allowed values for the options hash
@@ -239,8 +247,12 @@ verify_mode
 
 ## Contributing
 
-1. Fork it ( https://github.com/thoran/HTTP/fork )
+1. Fork it ( https://github.com/thoran/http/fork )
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create a new pull request
+
+## Licence
+
+MIT

data/Rakefile

@@ -0,0 +1,9 @@
+# Rakefile
+
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.verbose = false
+end
+
+task default: :spec

data/http.rb.gemspec

@@ -1,26 +1,43 @@
 require_relative './lib/HTTP/VERSION'
 
-Gem::Specification.new do |s|
-  s.name = 'http.rb'
-  s.version = HTTP::VERSION
-  s.date = '2025-09-08'
+class Gem::Specification
+  def development_dependencies=(gems)
+    gems.each{|gem| add_development_dependency(*gem)}
+  end
+end
+
+Gem::Specification.new do |spec|
+  spec.name = 'http.rb'
+  spec.version = HTTP::VERSION
 
-  s.summary = "HTTP made easy."
-  s.description = "HTTP is the simplest HTTP mezzanine library for Ruby.  Supply a URI, \
+  spec.summary = "HTTP made easy."
+  spec.description = "HTTP is the simplest HTTP mezzanine library for Ruby.  Supply a URI, \
     some optional query arguments, some optional headers, and some \
     Net::HTTP options, and that's it!"
-  s.author = 'thoran'
-  s.email = 'code@thoran.com'
-  s.homepage = "http://github.com/thoran/HTTP"
 
-  s.files = [
-    'CHANGELOG.txt',
+  spec.author = 'thoran'
+  spec.email = 'code@thoran.com'
+  spec.homepage = "http://github.com/thoran/HTTP"
+  spec.license = 'MIT'
+
+  spec.required_ruby_version = '>= 2.7'
+  spec.require_paths = ['lib']
+
+  spec.files = [
+    'http.rb.gemspec',
+    'CHANGELOG',
     'Gemfile',
+    'LICENSE',
+    'Rakefile',
     'README.md',
-    'http.rb.gemspec',
     Dir['lib/**/*.rb'],
-    Dir['spec/**/*.rb']
+    Dir['spec/**/*.rb'],
   ].flatten
 
-  s.require_paths = ['lib']
+  spec.development_dependencies = %w{
+    pry
+    rake
+    rspec
+    webmock
+  }
 end

data/lib/HTTP/VERSION.rb

@@ -2,5 +2,5 @@
 # HTTP::VERSION
 
 module HTTP
-  VERSION = '0.16.1'
+  VERSION = '0.18.0'
 end

data/lib/HTTP/{get.rb → request.rb}

@@ -1,30 +1,23 @@
-# HTTP/get.rb
-# HTTP.get
+# HTTP/request.rb
+# HTTP.request
 
 require 'net/http'
 require 'openssl'
 require 'uri'
 
-require_relative '../Hash/x_www_form_urlencode'
 require_relative '../Net/HTTP/set_options'
-require_relative '../Net/HTTP/Get/set_headers'
+require_relative '../Net/HTTPRequest/set_headers'
 require_relative '../Net/HTTPResponse/StatusPredicates'
 require_relative '../URI/Generic/use_sslQ'
 
 module HTTP
-
-  def get(uri, args = {}, headers = {}, options = {}, &block)
+  def request(uri, request_object, headers = {}, options = {}, &block)
     uri = uri.is_a?(URI) ? uri : URI.parse(uri)
     http = Net::HTTP.new(uri.host, uri.port)
     no_redirect = options.delete(:no_redirect)
     options[:use_ssl] ||= uri.use_ssl?
     options[:verify_mode] ||= OpenSSL::SSL::VERIFY_NONE
     http.options = options
-    if args.empty?
-      request_object = Net::HTTP::Get.new(uri.request_uri)
-    else
-      request_object = Net::HTTP::Get.new(uri.request_uri + '?' + args.x_www_form_urlencode)
-    end
     request_object.headers = headers
     request_object.basic_auth(uri.user, uri.password) if uri.user
     response = http.request(request_object)
@@ -49,6 +42,5 @@ module HTTP
     end
   end
 
-  module_function :get
-
+  module_function :request
 end

data/lib/HTTP/verbs.rb

@@ -0,0 +1,49 @@
+# HTTP/verbs.rb
+# HTTP.verb
+
+require 'json'
+require 'net/http'
+
+require_relative '../Hash/x_www_form_urlencode'
+require_relative '../Net/HTTP/Report'
+require_relative './request'
+require_relative '../String/to_const'
+
+module HTTP
+  module VERBS
+    WITHOUT_BODY = %i{get delete head options trace}
+    WITH_BODY = %i{post put patch propfind proppatch mkcol copy move lock unlock report}
+  end
+
+  VERBS::WITHOUT_BODY.each do |verb|
+    define_method(verb) do |uri, args = {}, headers = {}, options = {}, &block|
+      uri = uri.is_a?(URI) ? uri : URI.parse(uri)
+      request_uri = uri.request_uri
+      unless args.empty?
+        request_uri += '?' + args.x_www_form_urlencode
+      end
+      request_object = "Net::HTTP::#{verb.to_s.capitalize}".to_const.new(request_uri)
+      request(uri, request_object, headers, options, &block)
+    end
+
+    module_function verb
+  end
+
+  VERBS::WITH_BODY.each do |verb|
+    define_method(verb) do |uri, data = {}, headers = {}, options = {}, &block|
+      uri = uri.is_a?(URI) ? uri : URI.parse(uri)
+      request_object = "Net::HTTP::#{verb.to_s.capitalize}".to_const.new(uri.request_uri)
+      content_type = headers.find{|k, v| k.downcase == 'content-type'}&.last.to_s
+      if data.is_a?(String)
+        request_object.body = data
+      elsif content_type.start_with?('application/json')
+        request_object.body = JSON.dump(data)
+      else
+        request_object.form_data = data
+      end
+      request(uri, request_object, headers, options, &block)
+    end
+
+    module_function verb
+  end
+end

data/lib/Hash/x_www_form_urlencode.rb

@@ -1,20 +1,10 @@
 # Hash/x_www_form_urlencode.rb
 # Hash#x_www_form_urlencode
 
-# 20130310
-# 0.0.0
-
-# Notes: Extracted from MtGox library.  
-
-# Todo: 
-# 1. I should separate out the functionality for adding '+' characters so as it can do both styles of encoding.  That way I could reuse the existing Hash/to_parameter_string method as well...  
-
-require 'String/url_encode'
+require_relative '../String/url_encode'
 
 class Hash
-
   def x_www_form_urlencode(joiner = '&')
     inject([]){|a,e| a << "#{e.first.to_s.url_encode.gsub(/ /, '+')}=#{e.last.to_s.url_encode.gsub(/ /, '+')}" unless e.last.nil?; a}.join(joiner)
   end
-
 end

data/lib/Net/HTTP/Report.rb

@@ -0,0 +1,14 @@
+# Net/HTTP/Report.rb
+# Net::HTTP::Report
+
+require 'net/http'
+
+module Net
+  class HTTP
+    class Report < Net::HTTPRequest
+      METHOD = 'REPORT'
+      REQUEST_HAS_BODY = true
+      RESPONSE_HAS_BODY = true
+    end
+  end
+end

data/lib/Net/HTTP/set_options.rb

@@ -1,16 +1,13 @@
 # Net/HTTP/set_options.rb
 # Net::HTTP#set_options
 
-# 20171007
-# 0.0.0
+require 'net/http'
 
 module Net
   class HTTP
-
     def set_options(options = {})
       options.each{|k,v| self.send("#{k}=", v)}
     end
     alias_method :options=, :set_options
-
   end
 end

data/lib/Net/HTTPRequest/set_headers.rb

@@ -0,0 +1,13 @@
+# Net/HTTPRequest/set_headers.rb
+# Net::HTTPRequest#set_headers
+
+require 'net/http'
+
+module Net
+  class HTTPRequest
+    def set_headers(headers = {})
+      headers.each{|k,v| self[k] = v}
+    end
+    alias_method :headers=, :set_headers
+  end
+end

data/lib/Net/HTTPResponse/StatusPredicates.rb

@@ -1,3 +1,6 @@
+# Net/HTTPResponse/StatusPredicates.rb
+# Net::HTTPResponse::StatusPredicates
+
 module Net
   class HTTPResponse
     module StatusPredicates

data/lib/String/to_const.rb

@@ -0,0 +1,7 @@
+# String/to_const.rb
+# String#to_const
+
+# 20250819
+# 0.2.0
+
+require 'Thoran/String/ToConst/to_const'

data/lib/Thoran/Array/AllButFirst/all_but_first.rb

@@ -0,0 +1,28 @@
+# Thoran/Array/AllButFirst/all_but_first.rb
+# Thoran::Array::AllButFirst#all_but_first
+
+# 20141223
+# 0.1.0
+
+# Description: This returns a copy of the receiving array with the first element removed.  
+
+# Changes:
+# 1. + Thoran namespace.
+
+require 'Thoran/Array/FirstX/firstX'
+
+module Thoran
+  module Array
+    module AllButFirst
+
+      def all_but_first
+        d = self.dup
+        d.first!
+        d
+      end
+
+    end
+  end
+end
+
+Array.send(:include, Thoran::Array::AllButFirst)

data/lib/Thoran/Array/FirstX/firstX.rb

@@ -0,0 +1,32 @@
+# Thoran/Array/FirstX/firstX.rb
+# Thoran::Array::FirstX#first!
+
+# 20180804
+# 0.3.3
+
+# Description: Sometimes it makes more sense to treat arrays this way.
+
+# Changes since 0.2:
+# 1. Added the original version 0.1.0 of the implementation to the later 0.1.0!
+# 0/1
+# 2. Switched the tests to spec-style.
+# 1/2
+# 3. Added a test for the state of the array afterward, since this is meant to be an in place change.
+# 2/3
+# 4. Added tests for the extended functionality introduced in the first version 0.1.0.
+
+module Thoran
+  module Array
+    module FirstX
+
+      def first!(n = 1)
+        return_value = []
+        n.times{return_value << self.shift}
+        return_value.size == 1 ? return_value[0] : return_value
+      end
+
+    end
+  end
+end
+
+Array.send(:include, Thoran::Array::FirstX)

data/lib/Thoran/String/ToConst/to_const.rb

@@ -0,0 +1,47 @@
+# Thoran/String/ToConst/to_const.rb
+# Thoran::String::ToConst#to_const
+
+# 20141223
+# 0.2.0
+
+# Description: This takes a string and returns a constant, with unlimited namespacing.
+
+# History: Derived from Object#to_const 0.3.0, and superceding Object#to_const.
+
+# Changes:
+# 1. + Thoran namespace.
+
+# Todo:
+# 1. This only works for two levels of constants.  Three and you're stuffed.  So, this needs to be recursive...
+#   Done iteratively as of 0.1.0.
+# 2. Make this work for symbols.  However, this will only work if there's no namespacing.  ie. :A is OK, but :A::B is not.
+
+# Discussion:
+# 1. Should this go separately into classes for which ::const_get will work and be removed from Object?  Done as of 0.1.0.
+
+require 'Thoran/Array/AllButFirst/all_but_first'
+
+module Thoran
+  module String
+    module ToConst
+
+      def to_const
+        if self =~ /::/
+          constants = self.split('::')
+          constant = Object.const_get(constants.first)
+          constants = constants.all_but_first
+          until constants.empty? do
+            constant = constant.const_get(constants.shift)
+          end
+        else
+          constant = Object.const_get(self)
+        end
+        constant
+      end
+      alias_method :to_constant, :to_const
+
+    end
+  end
+end
+
+String.send(:include, Thoran::String::ToConst)

data/lib/URI/Generic/use_sslQ.rb

@@ -1,18 +1,12 @@
 # URI/Generic/use_sslQ.rb
 # URI::Generic#use_ssl?
 
-# 20141113
-# 0.0.0
-
-# Notes:
-# 1. Using the date from when first created in HTTP.get/post as the creation date.
+require 'uri'
 
 module URI
   class Generic
-
     def use_ssl?
       scheme == 'https' ? true : false
     end
-
   end
 end

data/lib/{HTTP.rb → http.rb}

@@ -4,7 +4,4 @@
 lib_dir = File.expand_path(File.join(__FILE__, '..'))
 $LOAD_PATH.unshift(lib_dir) unless $LOAD_PATH.include?(lib_dir)
 
-require 'HTTP/get'
-require 'HTTP/post'
-require 'HTTP/put'
-require 'HTTP/delete'
+require 'HTTP/verbs'